cmdr-joystick/README.md

111 lines
4.7 KiB
Markdown

# CMDR Joystick 24
RC Joystick with 2 hall effect gimbals, 2 hat switches and 24 buttons for use both with simulators and ELRS Rx equipped quads.
## Layout
```cpp
USB Joystick Layer 0
--------------------------------------------------------------
| FnL | B1 | | B5 | FnR |
--------------------------------------------------------------
| | B2 | B3 | MoL | | MoR | B7 | B6 | |
| |
| | B4 | | B8 | |
| | B17 | | B18 | |
| Z/RZ X/Y |
| | H1U | | H2U | |
| | H1L | H1B | H1R || H2L | H2B | H2R | |
| | H1D | | H2D | |
--------------------------------------------------------------
USB Joystick Layer 1 (FnL)
--------------------------------------------------------------
| FnL | B9 | | B5 | FnR |
--------------------------------------------------------------
| | B10 | B11 | MoL | | MoR | B7 | B6 | |
| |
| | B12 | | B8 | |
| | B19 | | B18 | |
| Z/RZ X/Y |
| | H3U | | H2U | |
| | H3L | H3B | H3R || H2L | H2B | H2R | |
| | H3D | | H2D | |
--------------------------------------------------------------
USB Joystick Layer 2 (FnR)
--------------------------------------------------------------
| FnL | B1 | | B13 | FnR |
--------------------------------------------------------------
| | B2 | B3 | MoL | | MoR | B15 | B14 | |
| |
| | B4 | | B16 | |
| | B17 | | B20 | |
| Z/RZ X(RX)/Y(RY) |
| | H1U | | H4U | |
| | H1L | H1B | H1R || H4L | H4B | H4R | |
| | H1D | | H4D | |
--------------------------------------------------------------
USB Joystick Layer 3 (FnL + FnR)
--------------------------------------------------------------
| FnL | B9 | | B13 | FnR |
--------------------------------------------------------------
| | B10 | B11 | MoL | | MoR | B15 | B14 | |
| |
| | B12 | | B16 | |
| | B19 | | B20 | |
| Z/RZ X(RX)/Y(RY) |
| | H3U | | H4U | |
| | H3L | H3B | H3R || H4L | H4B | H4R | |
| | H3D | | H4D | |
--------------------------------------------------------------
ELRS Layer
--------------------------------------------------------------
| CH7 | CH8 | | CH9 | CH10|
--------------------------------------------------------------
| | CH11| - | CH5 | | CH6 | - | CH12| |
| |
| | - | | - | |
| | - | | - | |
| X(CH1)/Y(CH2) X(CH3)/Y(CH4) |
| | - | | - | |
| | - | - | - || - | - | - | |
| | - | | - | |
--------------------------------------------------------------
```
## Features
- Ergonomic design (low profile)
- Hall effect gimbals
- Supports both USB HID joystick and ELRS Tx module
- Total 6x axis, 4x hat switches and 24x buttons (using Fn mode) implemented in USB HID mode
- 12 Channels implemented in ELRS mode (4x axis, 8x buttons)
- Low latency (1.6ms ELRS, 10ms USB)
## Build environment
- Cargo (rust embedded)
- Flashing via Cargo
- Pressing boot button on teensy
- Press and hold "top lower right button" when powering the unit
## Hardware
- 1x rp2040zero MCU board
- 2x FrSky M7 or M10 gimbals
- 6x Kailh choc low profile switches
- 6x Cherry MX switches
- 2x Alpine hat switches
- 1x PCB
- 1x Bottom case
- 1x Top plate
- 2x Hat swith top
## Calibration
No calibration needed