← All works
Open-Source Hardware2 min read 6 sections

CompatrIoT: Learn Hardware Security by Attacking a Real Board

An open-source hardware security training platform: one board with an STM32 and an ESP32, and twenty gamified labs that walk from finding a UART port to cracking a Bluetooth key.

Product
Hardware security training board and labs
Hardware
STM32 and ESP32 microcontrollers
Audience
Security researchers, hobbyists, and students
Licence
Open hardware, firmware, and docs
  • 20

    Gamified labs

  • 5

    Protocols: UART, JTAG/SWD, I2C, SPI, BLE

  • 2

    Microcontrollers on one board

  • 1

    Board instead of a shelf of dev kits

CompatrIoT: Learn Hardware Security by Attacking a Real Board
0106

Overview

Most people learn hardware security from slides. CompatrIoT is a physical, open-source training board that you attack for real, built for security researchers, hobbyists, and students.

The CompatrIoT demo: the board, probing it, and capturing its signals

It compresses what usually takes a shelf of development boards and scattered CTF challenges into one board with a structured learning path.

0206

What's on the Board

Two microcontrollers give the board broad protocol coverage, and the targets around them turn every classic hardware attack into something you can practise.

Hands on the board: every target is reachable with a probe
Hands on the board: every target is reachable with a probe
ComponentWhat you do with it
STM32 microcontrollerDebug ports, firmware extraction, and patching
ESP32 microcontrollerBluetooth Low Energy attacks
SPI flashSniff the bus and extract firmware
I2C EEPROM and sensorsReconnaissance, sniffing, and memory dumps
JTAG/SWD debug portsPinout discovery and full control of the chip
USB serial consoleThe lab console and UART exercises
Programmable LEDsVisible proof that you changed the hardware's behaviour
Every target has a lesson attached
0306

Twenty Labs, One Path

The labs run from first contact to full compromise, one protocol at a time, with difficulty rising as you go.

Twenty labs across five protocols
Twenty labs across five protocols
0406

The Lab Console

Every lab is played through a terminal-native console: the list of labs on the left, the current challenge and its objective on the right. It feels like the tools security people already use, and it keeps the focus on the hardware.

The lab console: twenty labs, and a JTAG challenge to control the GPIOs
The lab console: twenty labs, and a JTAG challenge to control the GPIOs

A JTAG lab, for example, asks you to use the debug port to drive the microcontroller's GPIOs and change the LED patterns: you see on the board that you've taken control.

0506

Seeing the Signals

Hardware attacks are invisible until you capture them. The labs pair the board with a logic analyser, so sniffing a bus means watching real traffic, decoding it, and pulling secrets out of it.

A logic analyser capture of the board's bus traffic
A logic analyser capture of the board's bus traffic
SkillHow the labs teach it
Finding interfacesIdentify ports and pinouts on real hardware
SniffingCapture I2C, SPI, and BLE traffic and decode it
ExtractionDump memory and firmware from real chips
ExploitationPatch firmware, take over GPIOs, crack a BLE key
From reading signals to owning the device
0606

Why It's Open

The hardware designs, firmware, and documentation are all open, so anyone can build the board, extend the labs, or teach with it.

The CompatrIoT labs
The CompatrIoT labs
Without CompatrIoTWith CompatrIoT
A shelf of different dev boardsOne board
Scattered CTF challengesTwenty labs in order
Slides about attacksAttacks on real hardware
Closed training kitsOpen designs anyone can build
What one open board replaces