Katana Footswitch
DIY bezdrátový footswitch pro Boss Katana-50 Gen 3: ESP32 firmware, reverse-engineered SysEx komunikace a modulární 3D tisknutelná konstrukce.
O projektu
Katana Footswitch je samostatný bezdrátový ovladač pro kytarové kombo Boss Katana-50 Gen 3. ESP32 se přes adaptér BT-DUAL připojí ke standardní službě BLE-MIDI a dovolí přepínat presety A1/A2/B1/B2, PANEL, pět efektů a Variation bez telefonu nebo notebooku.
Vývoj zahrnoval reverse engineering komunikace BOSS Tone Studio. Ukázalo se, že běžné MIDI Program Change a Control Change příkazy jsou přes BT-DUAL neúčinné; firmware proto vstupuje do editor mode a používá stejné Roland SysEx DT1/RQ1 rámce jako oficiální aplikace. Z aparátu zároveň zpracovává stavové odpovědi a spontánní změny pro aktualizaci ovladače a webového UI.
Hardware má šest momentových footswitchů a dvě podporované zobrazovací varianty: sedm adresovatelných RGB indikátorů, nebo kompaktní 128×32 OLED. Třídílná parametrická konstrukce v OpenSCAD se vejde na Prusa MK4 a obsahuje tisknutelné panely, držák ESP32, bezšroubový OLED carrier i testovací díly před plným tiskem.
Funkce
- Jedna action pipeline pro fyzická tlačítka i webové UI — presety, PANEL, pět efektů, Variation, režimy a opětovná synchronizace.
- BLE-MIDI transport pro KATANA 3 MIDI s párováním, discovery, notifications a bezpečným odpojením.
- Host-testované sestavování a parsování Roland SysEx rámců; mapování vychází z reálně zachycené komunikace BOSS Tone Studio.
- Zpětná vazba z aparátu pro patch, přepínače efektů, jejich barvy a Variation; stav se promítá do displeje, LED a webového klienta.
- Wi-Fi provisioning přes vlastní SoftAP, uložení přístupu v NVS, REST API, WebSocket broadcast a mobilní webové rozhraní ze SPIFFS.
- Volitelný SSD1306 OLED se autodetekuje při startu; jeden firmware tak obslouží OLED i LED variantu.
- Modulární OpenSCAD enclosure o rozměru přibližně 330 × 110 × 49 mm, exportované STL a montážní díly připravené pro 3D tisk.
Technologický stack
| Firmware | C + ESP-IDF 6.x (ESP32-WROOM-32) |
|---|---|
| Komunikace s aparátem | Bluetooth LE, BLE-MIDI, Roland SysEx DT1/RQ1 přes BT-DUAL |
| Fyzické ovládání | 6× momentary footswitch, GPIO debounce a long-press kombinace |
| Výstup | SSD1306 128×32 OLED / 7× WS2812B RGB LED |
| Webové rozhraní | REST + WebSocket, HTML/CSS/JavaScript ze SPIFFS |
| Síť a konfigurace | Wi-Fi SoftAP/STA provisioning + NVS |
| Mechanika | Parametrický OpenSCAD, modulární STL pro Prusa MK4 |
| Ověření | Host testy protokolu, stavového modelu a OLED rendereru |
Focus
Reverse engineering proprietárního protokolu, embedded C, spolehlivé fyzické ovládání a návrh tisknutelného hardware