Loading 3D model… large boards can take a moment.
This is the official repository of the REcon Badge 2025. Here you will find the source code for the badge, as well as the documentation and instructions to build it.
Your badge comes with a pre-installed firmware, but in case you want to reprogram it, you can follow these steps:
Download the latest firmware.uf2 file from the releases page.
Connect the badge to your computer using a USB-C cable.
Press and hold the button on the badge while connecting it to the USB port. This will put the badge in bootloader mode.
Once the badge is connected, it will appear as a USB drive named RPI-RP2. Copy the firmware.uf2 file to the root of the drive.
After copying the file, the badge will automatically reboot and start running the new firmware.
Note: Sometimes you may need to press the reset button on the badge after copying the firmware file to ensure it starts correctly.
To build the firmware from source, you will need to have Docker installed on your machine. Once you have Docker set up, you can follow these steps:
Using HTTPS:
git clone https://github.com/ElectronicCats/badge-recon-2025.git
Using SSH:
git clone git@github.com:ElectronicCats/badge-recon-2025.git
cd badge-recon-2025/firmware
./build.sh
This script will create a firmware.ino.uf2 file in the firmware/build directory.
To flash the firmware to the badge, follow the same steps as mentioned in the "Getting Started" section, but use the newly built
firmware.ino.uf2file instead of the pre-built one.
If you find any issues, please open an issue on the GitHub repository.
Your badge comes with an SSD1306 OLED display and 4 buttons for navigation. When you power on the badge, it will display a welcome screen and then show the main menu after you press any button.
All the available applications are listed in the following diagram:
flowchart TD
Start([Power On]) --> Init[Initialize Hardware]
Init --> Welcome[Welcome Screen]
Welcome --> MainMenu[Main Menu]
MainMenu --> Apps[Apps]
MainMenu --> About[About Screen]
Apps --> NFCMenu[NFC Menu]
Apps --> MagspoofMenu[Magspoof Menu]
%% NFC Menu items
NFCMenu --> DetectTags[Detect Tags]
NFCMenu --> DetectReaders[Detect Readers]
NFCMenu --> ReadBlock[Read Block]
NFCMenu --> WriteBlock[Write Block]
%% Magspoof Menu items
MagspoofMenu --> Emulate[Emulate]
MagspoofMenu --> Setup[Setup]
MagspoofMenu --> Help[Help]
%% NFC operations
DetectTags --> SetReaderMode[Set Reader Mode]
SetReaderMode --> TagDetection{Tag Detected?}
TagDetection -->|Yes| DisplayTagInfo[Display Tag Info]
TagDetection -->|No| BackPressed{Back Pressed?}
BackPressed -->|Yes| NFCMenu
BackPressed -->|No| TagDetection
DisplayTagInfo --> WaitForRemoval[Wait For Tag Removal]
WaitForRemoval --> BackToMenu[Wait For Back Button]
BackToMenu --> NFCMenu
%% Magspoof operations
Setup --> SerialPrompt[Serial Prompt for Tracks]
SerialPrompt --> InputTracks[Input Track Data]
InputTracks --> TracksUpdated[Tracks Updated]
TracksUpdated --> MagspoofMenu
%% Input controller
subgraph InputControl [Input Controller]
UpButton[Up Button]
DownButton[Down Button]
SelectButton[Select Button]
BackButton[Back Button]
end
%% Easter egg
UpButton --> KonamiCheck{Konami Code?}
KonamiCheck -->|Yes| EasterEgg[Easter Egg hint]
KonamiCheck -->|No| MainMenu
The Magspoof application allows you to emulate a magnetic stripe card.
You can get a hint about the Easter egg by pressing the Konami code while the badge shows the REcon logo. The Konami code is:
Up, Up, Down, Down, Left, Right, Left, Right
Electronic Cats invests time and resources providing this open source design, please support Electronic Cats and open-source hardware by purchasing products from Electronic Cats!
Designed by Electronic Cats.
Firmware released under an GNU AGPL v3.0 license. See the LICENSE file for more information.
Hardware released under an CERN Open Hardware Licence v1.2. See the LICENSE_HARDWARE file for more information.
Electronic Cats is a registered trademark, please do not use if you sell these PCBs.
No comments yet. Be the first to ask about this board.