# CMDR Joystick 25

RC(ELRS)/USB Joystick with 2 hall effect gimbals, 2 hat switches and 25 buttons for use both with PC simulators and ELRS Rx equipped quads.

## Layout

```cpp
HW Button index map:
---------------------------------------------------------------
|  0 L|  1 U|               |  2  |               |  3 L|  4 U|
---------------------------------------------------------------
|     |  5  |  6  |  7  |             | 12  | 11  | 10  |     |
|                                                             |
|                 |  8  |             | 13  |                 |
|                 |  9  |             | 14  |                 |
|      X1/Y1                                       X2/Y2      |
|                 | 16  |             | 21  |                 |
|           | 19  | 15  | 17  | | 24  | 20  | 22  |           |
|                 | 18  |             | 23  |                 |
---------------------------------------------------------------

USB HID joystick map (Enabled by pressing HW button 2+4):
---------------------------------------------------------------
| B1 L| B2 U|               | B3  |               | B4 L| B5 U|
---------------------------------------------------------------
|     | B6  | B7  | B8/16|           |B13/17| B12 | B11 |     |
|                                                             |
|                 | B9  |             | B14 |                 |
|                 | B10 |             | B15 |                 |
|      X1/Y1                                       X2/Y2      |
|                 | H1U |             | H2U |                 |
|           | H1L | B18 | H1R | | H2L | B19 | H2R |           |
|                 | H1D |             | H2D |                 |
---------------------------------------------------------------
Press and hold HW button 0 (B1) changes following:
* B2 => B21
* B4 => B22
* B11 => B23
* B12 => B24
* hat1 => hat3 (button press B20).
* hat2 => hat4 (button bpress B25)

ELRS channel map (Enabled by pressing HW button 2+3):
(+ = ON, - = OFF, CHxP/M/Z = trim)
---------------------------------------------------------------
|CH7-L|CH7+U|               |  -  |               |CH8-L|CH8+U|
---------------------------------------------------------------
|     | THL | CH9 | CH5 |             | CH6 |CH11-|CH11+|     |
|                                                             |
|                 |CH10+|             |CH12+|                 |
|                 |CH10-|             |CH12-|                 |
|     CH1/CH2                                     CH3/CH4     |
|                 |  -  |             |CH4P |                 |
|           |CH1M |CH12Z|CH1P | |CH3M |CH34Z|CH3P |           |
|                 |  -  |             |CH4M |                 |
---------------------------------------------------------------

Config Layer (holding CONFIG button)
---------------------------------------------------------------
|BOOT L| CAL U|           | CONFIG |            | USB L|ELRS U|
---------------------------------------------------------------
|     | THL-| THL+|  -  |             |  -  |  -  |  -  |     |
|                                                             |
|                 |  -  |             |  -  |                 |
|                 |  -  |             |  -  |                 |
|        -/-                                        -/-       |
|                 |  -  |             |  -  |                 |
|           |  -  |  -  |  -  | |  -  |  -  |  -  |           |
|                 |  -  |             |  -  |                 |
---------------------------------------------------------------

```

## Features

- Ergonomic design (low profile)
- Hall effect gimbals
- Supports both USB HID joystick and ELRS Tx
- Total 6x axis, 4x hat switches and 25x buttons (using Fn mode) implemented in USB HID mode
- 12 Channels implemented in ELRS mode (4x axis, 8x buttons)

## Hardware

- 2x FrSky M7 or M10 gimbals [M7 datasheet](https://www.frsky-rc.com/product/m7/)
- 6x Kailh choc low profile switches [Brown](http://www.kailh.com/en/Products/Ks/CS/)
- 6x Cherry MX switches [Brown](https://www.cherrymx.de/en/cherry-mx/mx-original/mx-brown.html)
- 2x Miniature Toggle Switch (M6 shaft, 7-8mm wide body. Ex Apem 5636) [Apem 5000 series](https://www.farnell.com/datasheets/2626614.pdf?_ga=2.22934718.461231604.1570510103-1672862477.1542183430)
- 2x Alpine RKJXM1015004 hat switches [pdf](https://www.mouser.se/datasheet/2/15/RKJXM-1662398.pdf)
- 1x Bottom case (3D printed)
- 1x Top plate (3D printed)
- 2x Hat swith top (3D printed) [stl](/mCAD/Hat_Castle_Short_scale_99_99_130.stl)
- 1x Custom PCB (CMDR Joystick 25 rev A)

  - ![pcb_top](/eCAD/cmdr-joystick/cmdr-joystick_rev_a_board_top.png)
  - ![pcb_bottom](/eCAD/cmdr-joystick/cmdr-joystick_rev_a_board_bottom.png)
  - Gerber files: [zip](/eCAD/cmdr-joystick/cmdr-joystick_rev_a_gerber.zip)
  - Schematics: [pdf](/eCAD/cmdr-joystick/cmdr-joystick_rev_a_schematics.pdf)
    - rp2040zero pinout: [jpg](https://www.waveshare.com/w/upload/2/2b/RP2040-Zero-details-7.jpg)
    - rp2040zero schematic: [pdf](https://www.waveshare.com/w/upload/4/4c/RP2040_Zero.pdf)
    - eeprom 24C32LV: [pdf](https://www.mouser.se/datasheet/2/308/1/NV24C32LV_D-2319484.pdf)
    - P-Fet si2372eds: [pdf](https://www.vishay.com/docs/63924/si2371eds.pdf)
    - N-Fet 2N7002: [pdf](https://www.mouser.se/datasheet/2/408/T2N7002AK_datasheet_en_20150401-1916411.pdf)
    - Small signal diod 1N4148W: [pdf](https://www.diodes.com/assets/Datasheets/BAV16W_1N4148W.pdf)

- 1x ELRS TX (using a EP1 TCXO Dual receiver reprogrammed as a tramsmitter)

  - [Link to EP1](https://www.happymodel.cn/index.php/2022/11/07/2-4g-elrs-ep1-ep2-ep1dual-tcxo-receiver/)
  - Reprogramming instructions (using ExpressLRS Configurator):

    1. Select latest release
    2. Device category = Generic target used as base 2.4Ghz
    3. Device = Generic ESP32 2.4GHz Gemini TX
    4. Flash to device
    5. Use following custom settings in 10.0.0.1/hardware.html:

    ```
    {"customised":"true","serial_rx":3,"serial_tx":1,"radio_busy":36,"radio_dio1":37,"radio_miso":33,"radio_mosi":32,"radio_nss":27,"radio_rst":26,"radio_sck":25,"radio_busy_2":39,"radio_dio1_2":34,"radio_nss_2":13,"power_rxen":10,"power_txen":14,"power_rxen_2":9,"power_txen_2":15,"power_min":0,"power_high":2,"power_max":2,"power_default":0,"power_control":0,"power_values":[-10,-6,-3],"button":0,"led_rgb":22,"led_rgb_isgrb":true,"screen_type":0}
    ```

## Software Build environment

##### Rust

- Cargo (rust embedded)
- Flashing via Cargo
  - Press and hold boot button on rp2040zero board while perform a reset
  - Press and hold CONF and press BOOT button.

## References

- CRSF protocol description (for communicating with ELRS TX): [Link](https://github.com/ExpressLRS/ExpressLRS/wiki/CRSF-Protocol)
- rp2040 datasheet: [pdf](https://datasheets.raspberrypi.com/rp2040/rp2040-datasheet.pdf)

## Calibration

1. Center both gimbals.
2. Press and hold CONF button and press CAL botton. Status led will start blinking green.
3. Move both gimbals to all corners.
4. Press right hat switch to save calibration data to eeprom.
