How tweetydabird/lotus-58-classic works
Main Components
a. Hardware Components Layer:
• Split Keyboard Halves (Left and Right PCBs)
• MCU (Microcontroller Units) for each half
• RGB LED System (Per-key and underglow)
• Optional Components (OLED displays, rotary encoders)
• USB-C/TRRS Connectivity
b. Firmware Layer:
• Bootloader
• Keyboard Firmware
• LED Control System
• Input Processing
[Physical Layer]
• Left Half PCB |<--->| Right Half PCB |
• (Master/Host) | | (Slave) |
• ↑ ↑
[Component Layer]
• MCU | | - MCU |
• RGB LEDs | | - RGB LEDs |
• Hot-swap | | - Hot-swap |
• OLED (Optional)| | - OLED (Optional)|
• Encoder (Opt.) | | - Encoder (Opt.) |
• ↑ ↑
[Firmware Layer]
• Bootloader | | - Bootloader |
• Main Firmware | | - Main Firmware |
• LED Control | | - LED Control |
Important Elements to Highlight
a. Connectivity:
• USB-C connection (main input)
• TRRS connection between halves
• Data flow directions
b. Component Interactions:
• MCU to LED matrix
• MCU to input matrix
• MCU to optional components
Technical Details to Note
• Hot-swap socket compatibility
• RGB LED matrix configuration
• OLED and encoder positioning options
• Master/slave relationship between halves