# cs-midi

A pico-sdk port of [tttapa/Control-Surface](https://github.com/tttapa/Control-Surface) (GPL-3.0).

cs-midi provides the full Control Surface MIDI element system — output elements, input elements, banks, selectors, MIDI routing, and the declarative `Control_Surface` singleton — for use with the Raspberry Pi Pico SDK.

## Getting Started

```cpp
#include "pico/stdlib.h"
#include <cs_midi.h>

using namespace cs;

BluetoothMIDI_Interface midi;

NoteButton button {5, {MIDI_Notes::C[4], Channel_1}};

int main() {
    stdio_init_all();
    Control_Surface.begin();
    while (true) {
        Control_Surface.loop();
        sleep_ms(1);
    }
}
```

## Build

cs-midi is a static library meant to be included in a pico-sdk project:

```cmake
add_subdirectory(lib/cs-midi)
target_link_libraries(your_target cs_midi)
```

CMake options (set before `add_subdirectory()`):

| Option | Default | Description |
|--------|---------|-------------|
| `CS_MIDI_BLE` | ON | BLE MIDI via BTstack |
| `CS_MIDI_USB` | OFF | USB MIDI via TinyUSB |
| `CS_MIDI_SERIAL` | OFF | Serial MIDI over UART |
| `CS_MIDI_APPLEMIDI` | OFF | AppleMIDI (RTP-MIDI over WiFi) |

USB MIDI requires `tusb_config.h` and `usb_descriptors.c` in your project — see `templates/` for reference files.

To compile-verify all examples standalone:

```sh
cd lib/cs-midi && make tests
```

## Differences from Control Surface

- `#include <cs_midi.h>` replaces `#include <Control_Surface.h>`
- Standard `main()` replaces Arduino `setup()`/`loop()`
- All types live in the `cs::` namespace
- No `MCU::` namespace yet — use raw CC numbers or `MIDI_CC::` constants

## Credits

Original library: [Control Surface](https://github.com/tttapa/Control-Surface) by **Pieter P (tttapa)** (GPL-3.0).
pico-sdk port: [pszsh](https://else-if.org).