Getting started

1. Where to get the board?

You can choose any PCB manufacturer you like. The PCB is designed to fit with JLCPCB.com’s capabilities and constraints. You can assemble the board yourself, but it’s best not to do so if you’re not familiar with soldering small components. Alternatively, you can order the board fully or partly assembled. Soldering the back of the PCB by hand is not too difficult. All parts are normally available at LCSC.com, who supply parts to JLCPCB.com.

2. Production files?

In order to export the production files (Gerber/BOM/Pick and Place), you need KiCad which is open source. In case you are ordering from JLCPCB it is recommended to use the Fabrication-Toolkit KiCad plugin by bennymeg

3. Building the software

If you got a RP2040-Decoder with USB the easiest way to get the RP2040-Decoder up and running is to just use the precompiled .uf2 file and ignore the rest of this section.

However sometimes you might want to build by yourself, be it for debugging or to make your own modifications to the source code. The easiest way to do this is to just use Visual Studio Code and the Raspberry Pi Pico extension. The official documentation of the Pi Pico does a great job of explaining this in detail.

Note: If you are building for Hardware Rev 0.3 or below change the board defintion in your CMakeLists.txt file to: “RP2040-Decoder-board-legacy.h”

4. Flashing the software

For RP2040-Decoders with USB there is two ways of flashing the software:

  1. Flashing via USB using the .uf2 file by copying it with your preferred file explorer.

  2. Using Serial Wire Debug (SWD)

    2.1. Using another RP2040/RP2350-based board with debugprobe software on it. (Could be the RP2040-Decoder itself)

    2.2. Using any other supported SWD debug interface

For RP2040-Decoders without USB the only way of flashing the software is via SWD

4.1. Flashing the software via .uf2 file

When first plugged in the RP2040 boots into Mass Storage Device mode. To flash the software, you need to drag the ‘.uf2’ file onto the disk using any file explorer. This will write the file to the Flash and restart the RP2040. In case you want to repeat the flasing process, temporarily connect the solder bridge called JP1 on the back side of the board and power cycle the device. This procedure is also described in the Raspberry Pi Pico Datasheet Chapter 4.1

4.2. Flashing the software via SWD

Flashing via SWD is a little more complicated but also comes with great advantages in terms of debugging. The book on Getting started with Raspberry Pi Pico-series does a great job of explaining how debugging works. As already suggested in 3. it is recommended to use the Visual Studio Code Extension. Most relevant in the book are Chapter 4.3. Debug and Appendix A: Debugprobe

5. Wiring

Please refer to the hardware section for your board:

6. Resolving issues

If the decoder is not working as expected:

  1. Follow the Troubleshooting instructions

  2. If you still have trouble, create a new discussion or issue and describe your question/issue.