trueControl
/
dc31-addon-addon-badge-firmware
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Firmware for the Addon Addon, an addon for the official DC31 badge that hosts GAT or v1.69bis-compliant addons.
11 Commits 1 Branch 0 Tags 1.6 MiB
C 99.5%
Assembly 0.5%
Go to file
true db63a8f977 Update README.md 2023-11-12 17:50:43 -08:00
badge_firmware main firmware: fix eeprom reliability, add more LED programs 2023-08-05 00:59:48 -07:00
bootloader_hk32f030m_uart_xmodem Bootloader fixes and updates 2023-11-12 16:59:53 -08:00
hax Add readme, more hax files 2023-11-12 17:22:35 -08:00
.gitattributes Initial commit 2023-06-25 01:21:36 -07:00
.gitignore Initial bootloader implementation 2023-06-25 01:41:36 -07:00
README.md Update README.md 2023-11-12 17:50:43 -08:00

README.md

true's RGB Addon Addon for DC31 Badge

This is the firmware for true's RGB Addon Addon, a shard addon for the official DEF CON 31 badge.

Specifications

  • HK32F030MF4P6 MCU (16K flash, 4K RAM)
  • Type-C USB Port
    • Supports charging with dumb 5V or PD chargers
    • XMODEM bootloader over Type-C for field firmware updates
  • 8x addressable RGBLED in 3 zones
  • Several RGB programs
  • Accelerometer
  • Hosts GAT / SAO Addons

User manual

A hastily put together user manual can be found at https://dc31.truecontrol.org/yearsite/manual/addon-addon

Building

This project was built with STM32CubeIDE, which normally only works with ST MCUs. In the hax/ directory you'll find replacement files to place over STM32CubeIDE v1.21.1 and v1.13.0. This has only been tested with v1.12.1.

Downloads for STM32CubeIDE:

Use a J-Link to debug and program.. If you want to get shady with it, you can flash F103 blue pill with an OB firmware containing a modified date code. Check the internet for pinouts.

Using the bootloader

Activate the bootloader by holding down the PROG button on the badge while turning on. Use your favorite terminal to connect to the badge using the VCP at 115200-8-N-1.

Send a firmware.bin file via XMODEM to update. Do NOT send .hex files, they won't work.

Ensure the firmware you send is built with the bootloader target in mind. The uploaded binary will start at 0x8000800 in Flash.