KB1

KB1 design patterns, protocols, and conventions. Use when implementing new features, modifying BLE protocol, planning breaking changes, reviewing firmware contracts, or understanding system assumptions. Contains LED color conventions, MIDI implementation (Serial MIDI, clock generation), BLE protocol assumptions, breaking changes log, critical checklists, and validation rules. Essential for maintaining consistency and avoiding regressions.

Complete implementation reference for KB1 fake/MIDI-note-based pitch bend (CC 208). Use when rebuilding, debugging, or extending the pitch bend feature. Contains full firmware + web app implementation across all affected files.

KB1 hardware specifications, schematics, and component details. Use when working on hardware integration, debugging electrical issues, understanding pin assignments, audio system, battery system, or planning hardware modifications. Contains full schematic (MCP23017 I2C expanders, PAM8406 audio amp, XIAO ESP32-S3 MCU, battery system), measured power consumption, and hardware roadmap decisions.

Performance optimization strategies for KB1 firmware. Use when optimizing code, improving responsiveness, reducing latency, debugging performance issues, or planning efficiency improvements. Contains I2C bulk read strategy (12× speedup), serial output optimization (80% reduction), touch sensor debouncing, and performance profiling data. Includes implementation plans and measured results.