Skip to the content
2 layers61.6 × 30.5 mmCRSFJoystick, the printed circuit board in 3D

Arduino code that runs on a Pi Pico (2040) to emulate a USB HID Joystick

Size
61.6 × 30.5 mm
Copper layers
2
Thickness
1.6 mm
Parts
10
Nets
39
Pads
64
Tracks, vias
30, 1
Pours
2
Routed
Yes
KiCad
KiCad 5 (file 20171130)
Created
20 Jan 2022
Updated
1 Aug 2025

Overview

CRSFJoystick is an open-source printed circuit board by mikeneiderhauser, from the mikeneiderhauser/CRSFJoystick repository on GitHub, published under the GPL-3.0 licence. It is a 2-layer board of 61.6 × 30.5 mm with 10 parts on 39 nets, routed with 30 tracks and 1 via.

It belongs with the RP2040 boards of this library.

README

README.md

ELRSJoystick / CRSFJoystick

https://github.com/mikeneiderhauser/CRSFJoystick

Named CRSFJoystick as it indicates the wire protocol between the microcontroller (pi pico) and receiver).

Arduino code using the mbed core that runs on a Pi Pico (2040) to emulate a USB HID Joystick

Pirmarily developed to use and ExpressLRS receiver and a HID Joystick for Sim use! It will work with both Tracer and Crossfire as well.

Shout out to CapnBry for the Crsf Library

https://github.com/CapnBry/CRServoF

Shout out to RealRobots.net for the Gamepad Library

https://gitlab.com/realrobots/PicoGamepad/-/tree/master

Future Plans

  • GitHub Builds
  • Rework HID USB code
  • Add failsafe nopulses / hold

Demo Video

ELRS HID Joystick Demo

Purchase

Originally offered of FPVExchange, but that is no longer an option. Please send me an email for availability, purchase, or to get additional info!

housefpv@gmail.com

You can also contact me on discord HouseFPV

  • Blank carrier boards for Pi Pico, Tiny 2040, and Waveshare RP2040 (old stock)
  • Built and flashed units
  • DIY Section

A few boards that I believe are based off of this project:

Compatability

This project was designed primarily with ELRS usage in mind, however this code base has also been tested with TBS Crossfire Receivers (915MHZ) (last tested v6.16) and TBS Tracer Receivers (2.4GHz) (last tested v6.17) and both appear to work! Flight was teseted in the Liftoff simulator.

I no longer have TBS Crossfire nor TBS Tracer TX modules or Receivers so future tests will have to be conducted by others.

ExpressLRS (Waveshare RP2040)

Crossfire

Tracer

Building / Flashing

I recently converted the projet to PlatformIO to aid in building, board management, etc. PlatformIO has some known quirks with PiPico boards and I'm going to leave some breadcrumbs here for later.

VSCode with PlatformIO

Installing VSCode and PlatformIO

https://platformio.org/install/ide?install=vscode

Build for specific board / environment

At the Bottom of VSCode you will see a tool bar. Look for Default (CRSFJoystick). Building in this state will build for all boards / environments defined in the platformio.ini file. To target a sepecific board, Click on Default (CRSFJoystick) and select an appropriate option (Note, selection pops up at the top of vscode).

Click on the Checkmark on the bottom toolbar to build for the board / environment you selected.

Click on the -> on the bottom toolbar to upload to the board. If upload fails to find your board, please see bothe the alternative upload section as well as the driver section.

Alternative upload

This is one of the standard advertised methods for uploading firmware to a pipico based microcontroller board.

Press and hold the bootsel button on your board and either plugin/power on the board or if the board is already powered press and release the reset button.

This will put the board in RP2 Boot mode.

A removable device should pop up or become available on your computer. Drag and drop the firmware.u2f file from the .pio/build/wavesharerp2040zero/ directory into this device on your computer. Note replpace wavesharerp2040zero with the environment for your board.

Drivers

Drivers can be hit or miss for the pipico board and platformio.

You may need to use zadig to get vscode+platforio to be able to upload directly to the board. https://github.com/platformio/platform-raspberrypi/issues/2#issuecomment-828586398

Below are the drivers I have working on my Windows 11 machine. You may need to modify the driver selection via zadig and or device manager to get it working.

  • Standard Running Mode
    • RaspberryPi Pico (Interface 0)
      • Zadig -> HidUsb v10.0.22621.819
      • Device Manager -> Human Interface Devices -> HID-compliant game controller
    • RaspberryPi Pico (Interface 1)
      • Zadig -> usbser v10.0.22621.1778
      • Device Manager -> Ports (COM & LPT) -> USB Serial Device
  • RP2 Boot mode
    • RP2 Boot (Interface 0)
      • Zadig USBSTOR v10.0.022621.1778
      • Device Manager -> Disk Drives -> RPI RP2 USB Device
    • RP2 Boot (Interface 1)
      • Zadig WinUSB v6.1.7600.16385 Device Manager -> Universal Serial Bus Devices -> RP2 Boot

Device manager clicks to change driver

Right Click -> Properties -> Update Driver -> Browse my computer for drivers -> Let me pick from a list of available drivers on my computer

Flashing ELRS Receiver

Depending on the device you are using, your target may be different. For all of the DIY version's I've made, I used the HappyModel EP2 Rx. Other vendors may vary.

Flashing via Betaflight Passthrough

https://www.expresslrs.org/software/updating/betaflight-passthrough/

Flashing via Wifi

If your receiver is wifi enabled you can also flash it via wifi

https://www.expresslrs.org/software/updating/wifi-updating/

Testing

For a quick test of functionality, I typically go to GamepadTester.

Once the Radio is bound to the RX, it should show up in GamePadTester.

Mappings

This was a quick map and is not fully featured.

On link up/down the onboard Pi Pico LED will light indicating connection

NOTE Channel 5, 6, 7, and 8 are mapped both to analog axis as well as joystick buttons.

ChannelLogical MappingJoystick Mapping
1AX
2EY
3TRx
4RRy
5Channel 5 (Full) AND AUX1 (1510-2011)Z AND Button 0
6Channel 6 (Full) AND AUX2 (1510-2011)Rz AND Button 1
7Channel 7 (Full) AND AUX3 (1510-2011)S0 AND Button 2
8Channel 8 (Full) AND AUX4 (1510-2001)S1 AND Button 3
9AUX5 (1510-2011)Button 4
10AUX6 (1510-2011)Button 5
11AUX7 (1510-2011)Button 6
12AUX8 (1510-2011)Button 7
13Not UsedNot Used
14Not UsedNot Used
15LQ - Not UsedNot Used
16RSSI - Not UsedNot Used

Note additional button mappings can be created in caliration.h

Here below is for DIY Builds and may be slightly outdated

DIY Hardware

In a nutshell, wire the ELRS RX up to a uart on the pipico, 5v, and gnd.

Raspberry PicoELRS/CRSF Receiver
VBUS (PIN 40)5V
GND (PIN 38)GND
GP4 (PIN 6)RX
GP5 (PIN 7)TX

Other boards are supported, see the board_defs.h file.

Note, price breaks can be had when purchasing at quantity.

Approx part cost for pico hardware (large footprint, cheaper) - $20-$25

  • Pi Pico - $4.00
  • ELRS RX - $13.50
  • Carrier Board - $1.00 (approx)
  • Shipping / Tax from vendors - varies

Carrier Boards

ELRSJoystick

This board has an ELRS RX built in, so you don't need to wire any RX on, just plug in and connect to your ELRS TX, then you are ready to go!

Tiny Version

NOTE: References to level shifters below are no longer needed as the level shifter can be omitted. You will have to bridge the pads on the level shifter for the TX/RX pins or use a newer version of the carrier board.

I personally use the Waveshare RP2040-Zero version for my ELRS Joystick!

Hardware build files are located in hardware/kicad/CRSFJoystick/output/Rev1.0

I used JLCPCB with Black Soldermask and a board thickness of 1.6mm.

R1.0 Build Photo

Note the different orientation of the ELRS RX's. The orientation can be flipped. I installed each RX to ensure the boot pad is exposed should the RX need recovered.

Waveshare RP2040-Zero

WaveShare RP2040-Zero Board

WaveShare RP2040-Zero BoardDimensions

WaveShare RP2040 Case lower

WaveShare RP2040 Case Upper

WaveShare RP2040 Case assembled

Raspberry Pi Pico (Full Version)

Pico Build Front

Pico Build Back

Pi Pico Dimensions

Tiny2040

Tiny2040 Build Front

Tiny2040 Build Back

Tiny2040 Dimensions

SEEED AXIO 2040

Board files now in the hardware folder. Not built or tested but should work.

SEEED XAIO RP2040 Dimensions

SEEED XAIO RP2040 Board

CRSFJoystick2.0

Build a smaller pico by yourself.

CRSFJoystick2.3 Board Front CRSFJoystick2.3 Board Back CRSFJoystick2.3 Render Front CRSFJoystick2.3 Render Back CRSFJoystick2.3 Render Back CRSFJoystick2.3 Render Back CRSFJoystick2.3 Render Back CRSFJoystick2.3 Render Back CRSFJoystick2.3 Render Back CRSFJoystick2.3 Render Back CRSFJoystick2.3 Render Back

General Assembly

  • Print the top and bottom enclosure
  • Print 2 of the spacers for the Pi2040, Print 4 of the spacers for the Pi Pico version
  • Follow the directions in this video https://youtu.be/Zuhfbobgm5A

Parts

10
QtyValueFootprintReferences
4MountingHoleMountingHole:MountingHole_2.2mm_M2H1, H2, H3, H4
2CRSF_RXpico:ELRS_EP2U3, U4
1level_converterpico:level_converterU2
1picopico:pico_no_swdU1

The 8 most common of 10 parts.

More from mikeneiderhauser/CRSFJoystick

1
  • 2 layers31.1 × 27.9 mmCRSFJoystick tiny, the printed circuit board in 3D

    CRSFJoystick tiny

    mikeneiderhauser/CRSFJoystick

    Arduino code that runs on a Pi Pico (2040) to emulate a USB HID Joystick

    9 parts231GPL-3.0

Similar boards

  • 2 layers57 × 55.2 mmLogicAnalyzer, the printed circuit board in 3D

    LogicAnalyzer

    gusmanb/logicanalyzer

    24 channel, 100Msps logic analyzer hardware and software

    10 parts5.1kGPL-3.0
  • 2 layers32.2 × 15.4 mmProtector, the printed circuit board in 3D

    Protector

    byrantech/laptop

    anyon_e, a highly integrated, high end, open source laptop. Attempt the impossible.

    10 parts4.3kMIT
  • 2 layers26 × 18 mmConn, the printed circuit board in 3D

    Conn

    yaqwsx/KiKit

    Automation tools for KiCAD

    10 parts2.1kMIT
  • 2 layers44.3 × 30.5 mmLime2-SATA RevA, the printed circuit board in 3D

    Lime2-SATA RevA

    OLIMEX/OLINUXINO

    OLINUXINO is Open Source / Open Hardware, low cost from EUR 24 Linux Industrial grade Single Board Computer capable to operate -25+85C

    10 parts1.5k
  • 2 layers17.8 × 43.2 mmNano Adapter, the printed circuit board in 3D

    Nano Adapter

    VoronDesign/Voron-Hardware

    Cool Hardware designed by the Voron Design group

    10 parts1.1kGPL-3.0
  • 2 layers53.9 × 23.2 mmBuffer, the printed circuit board in 3D

    Buffer

    hoglet67/RGBtoHDMI

    Bare-metal Raspberry Pi project that provides pixel-perfect sampling of Retro Computer RGB/YUV video and conversion to HDMI

    10 parts1kGPL-3.0

Questions

How big is the CRSFJoystick PCB?

It measures 61.6 × 30.5 mm and has 2 copper layers, 1.6 mm thick.

What parts does the CRSFJoystick use?

10 parts. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the CRSFJoystick KiCad files?

From the mikeneiderhauser/CRSFJoystick repository on GitHub, at the commit this page was made from: the board is hardware/kicad/CRSFJoystick/CRSFJoystick.kicad_pcb. PCBKit opens the board in the browser, with nothing to install.

Can I use the CRSFJoystick design in my own project?

Its repository publishes it under the GPL-3.0 licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).