djio 0.0.23

DJ Hardware Control(ler) Support
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116

// SPDX-FileCopyrightText: The djio authors
// SPDX-License-Identifier: MPL-2.0

use smol_str::SmolStr;
use strum::{EnumCount, EnumIter, FromRepr};

use crate::{
    AudioInterfaceDescriptor, ControllerDescriptor, DeviceDescriptor, MidiDeviceDescriptor,
};

mod input;
pub use self::input::{
    DeckSensor, InvalidInputControlIndex, MainSensor, MidiInputEventDecoder, Sensor,
    try_decode_midi_input, try_decode_midi_input_event,
};

mod output;
pub use self::output::{
    DeckLed, InvalidOutputControlIndex, Led, MainLed, OutputGateway, led_output_into_midi_message,
};

pub const AUDIO_INTERFACE_DESCRIPTOR: AudioInterfaceDescriptor = AudioInterfaceDescriptor {
    num_input_channels: 0,
    num_output_channels: 4,
};

pub const MIDI_DEVICE_DESCRIPTOR: &MidiDeviceDescriptor = &MidiDeviceDescriptor {
    device: DeviceDescriptor {
        vendor_name: SmolStr::new_static("KORG"),
        product_name: SmolStr::new_static("KAOSS DJ"),
        audio_interface: Some(AUDIO_INTERFACE_DESCRIPTOR),
    },
    port_name_prefix: "KAOSS DJ",
};

pub const DEVICE_DESCRIPTOR: &DeviceDescriptor = &MIDI_DEVICE_DESCRIPTOR.device;

#[expect(clippy::cast_possible_truncation)]
pub const CONTROLLER_DESCRIPTOR: &ControllerDescriptor = &ControllerDescriptor {
    num_decks: Deck::COUNT as u8,
    num_virtual_decks: 0,
    num_mixer_channels: Deck::COUNT as u8,
    num_pads_per_deck: 0,
    num_effect_units: 0,
};

#[derive(Debug, Clone, Copy, FromRepr, EnumIter, EnumCount)]
#[repr(u8)]
pub enum Deck {
    /// Left deck
    A,
    /// Right deck
    B,
}

impl Deck {
    const fn midi_channel(self) -> u8 {
        match self {
            Deck::A => MIDI_CHANNEL_DECK_A,
            Deck::B => MIDI_CHANNEL_DECK_B,
        }
    }

    const fn control_index_bit_mask(self) -> u32 {
        match self {
            Deck::A => CONTROL_INDEX_DECK_A,
            Deck::B => CONTROL_INDEX_DECK_B,
        }
    }
}

const MIDI_CHANNEL_MAIN: u8 = 0x06;
const MIDI_CHANNEL_DECK_A: u8 = 0x07;
const MIDI_CHANNEL_DECK_B: u8 = 0x08;

const MIDI_COMMAND_NOTE_ON: u8 = 0x90;
const MIDI_COMMAND_CC: u8 = 0xb0;

const MIDI_STATUS_BUTTON_MAIN: u8 = MIDI_COMMAND_NOTE_ON | MIDI_CHANNEL_MAIN;
const MIDI_STATUS_BUTTON_DECK_A: u8 = MIDI_COMMAND_NOTE_ON | MIDI_CHANNEL_DECK_A;
const MIDI_STATUS_BUTTON_DECK_B: u8 = MIDI_COMMAND_NOTE_ON | MIDI_CHANNEL_DECK_B;

const MIDI_STATUS_CC_MAIN: u8 = MIDI_COMMAND_CC | MIDI_CHANNEL_MAIN;
const MIDI_STATUS_CC_DECK_A: u8 = MIDI_COMMAND_CC | MIDI_CHANNEL_DECK_A;
const MIDI_STATUS_CC_DECK_B: u8 = MIDI_COMMAND_CC | MIDI_CHANNEL_DECK_B;

const MIDI_TAP_BUTTON: u8 = 0x0b;

const MIDI_MONITOR_LEVEL_KNOB: u8 = 0x14;
const MIDI_MONITOR_MIX_KNOB: u8 = 0x15;
const MIDI_MASTER_LEVEL_KNOB: u8 = 0x16;

const MIDI_DECK_TOUCHSTRIP_LOOP_LEFT_BUTTON: u8 = 0x0f;
const MIDI_DECK_TOUCHSTRIP_LOOP_CENTER_BUTTON: u8 = 0x10;
const MIDI_DECK_TOUCHSTRIP_LOOP_RIGHT_BUTTON: u8 = 0x11;
const MIDI_DECK_TOUCHSTRIP_HOTCUE_LEFT_BUTTON: u8 = 0x12;
const MIDI_DECK_TOUCHSTRIP_HOTCUE_CENTER_BUTTON: u8 = 0x13;
const MIDI_DECK_TOUCHSTRIP_HOTCUE_RIGHT_BUTTON: u8 = 0x14;
const MIDI_DECK_TOUCHSTRIP_LEFT_BUTTON: u8 = 0x15;
const MIDI_DECK_TOUCHSTRIP_CENTER_BUTTON: u8 = 0x16;
const MIDI_DECK_TOUCHSTRIP_RIGHT_BUTTON: u8 = 0x17;
const MIDI_DECK_MONITOR_BUTTON: u8 = 0x19;
const MIDI_DECK_SHIFT_BUTTON: u8 = 0x1a;
const MIDI_DECK_PLAYPAUSE_BUTTON: u8 = 0x1b;
const MIDI_DECK_SYNC_BUTTON: u8 = 0x1d;
const MIDI_DECK_CUE_BUTTON: u8 = 0x1e;

const MIDI_DECK_GAIN_KNOB: u8 = 0x1a;
const MIDI_DECK_EQ_HI_KNOB: u8 = 0x1b;
const MIDI_DECK_EQ_MID_KNOB: u8 = 0x1c;
const MIDI_DECK_EQ_LO_KNOB: u8 = 0x1d;

const CONTROL_INDEX_DECK_A: u32 = 0x0100;
const CONTROL_INDEX_DECK_B: u32 = 0x0200;
const CONTROL_INDEX_DECK_BIT_MASK: u32 = CONTROL_INDEX_DECK_A | CONTROL_INDEX_DECK_B;
const CONTROL_INDEX_ENUM_BIT_MASK: u32 = (1 << CONTROL_INDEX_DECK_BIT_MASK.trailing_zeros()) - 1;