

Gradcap threatmap
A project to learn more about microcontroller development and PCB design
- Size
- 235 × 235 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 79
- Nets
- 80
- Pads
- 329
- Tracks, vias
- 788, 44
- Pours
- 3
- Routed
- Yes
- KiCad
- KiCad 9.0 (file 20241229)
- Created
- 29 Jun 2024
- Updated
- 12 May 2025
Overview
Gradcap threatmap is an open-source printed circuit board by peter-lamantia, from the peter-lamantia/gradcap-threatmap repository on GitHub. It is a 2-layer board of 235 × 235 mm with 79 parts on 80 nets, routed with 788 tracks and 44 vias.
It is built around the WS2812C-2020-V1 and WS2812C. Its parts include 64 diodes, 4 switches, 3 resistors, 3 connectors and 1 IC. It belongs with the ESP32 boards of this library.
Main components
2WS2812C-2020-V1
SMD,2x2mm0.5mA 0.84mm 2.2mm 2kHz 2mm 3.7V~5.3V 800Kbit/s Built-in power-on reset circuit、Built-in power-on reset circuit G:520nm、R:624nm、B:467nm R:130mcd、G:320mcd、B:60mcd SMD,2x2mm RGB LEDs(Built-in IC) ROHSWorldsemiRGB LEDs(Built-In IC)WS2812C
SMD5050-4P-25℃~+65℃ 0.6mA 1.57mm 3.7V~5.3V 5.4mm 5mm 800Kbit/s B:465nm~475nm、R:620nm~630nm、G:515nm~525nm Built-in power-on reset circuit、Built-in power-on reset circuit、Built-in one-way transmission function G:400mcd~600mcd、R:150mcd~200mcd、B:100mcd~150mcd SMD5050-4P RGB LEDs(Built-in IC) ROHSWorldsemiRGB LEDs(Built-In IC)
README
README.mdGraduation Cap Live Threat Map PCB
About
This is a pet project to learn more about microcontroller development and PCB design.
My plan is to:
- Reverse engineer the Fortinet WebSocket API
- Program an ESP32 to connect to said API and log messages to serial
- Design a PCB with:
- an ESP32-S3
- a world map graphic and WS2812B LEDs placed at key cities
- a lithium battery and charging circuit
- dimensions that will place it neatly on a graduation cap
- a display to show the attack details
- Program the ESP32 to parse the incoming WebSocket such that:
- the longitudinal data will map to the closest physical LED on the board
- the LED will light up with a certain color depending on the threat type
- ideally, I can make the LEDs animated in a cool way
Roadmap
- WiFi connection reestablishment
- WebSocket connection reestablishment
- An actual PCB to mess around with. It may be useful to do this in revisions, e.g. make a PCB with the LEDs first, write the software for that, then make a more capable PCB with all components. After all, it is my first time doing this.
- Figure out how to actually debug (not just print program state to serial!)
Changelog
2024-07-07
- Full migration to Platform.io (it's great!)
- Started printing out threats to an OLED display
- Used the U8g2 library, specifically u8log for display output
- Parsed the JSON sent from the WebSocket using ArduinoJSON
- Added and did some testing with FastLED, but have not implemented it yet (it is likely best to wait until I've made the PCB)
2024-06-29 (initial commit)
- WiFi connection establishment
- WebSocket connection to Fortinet
- Prints WebSocket messages to serial
Known issues/fixes
- If serial is enabled, the XIAO ESP32-S3 will not allow reflashing. To fix this, hold the boot button while powering it on, and then flash at will!
Parts
79| Qty | Value | Footprint | References |
|---|---|---|---|
| 43 | WS2812C-2020 | LED_SMD:LED_WS2812B-2020_PLCC4_2.0x2.0mm | D2, D3, D4, D10, D11, D12, D13, D14, D15, D16, D17, D18, D19, D20, D21, D22 +27 |
| 21 | WS2812C | LED_SMD:LED_WS2812B_PLCC4_5.0x5.0mm_P3.2mm | D23, D24, D25, D26, D27, D28, D29, D30, D31, D32, D33, D34, D35, D36, D37, D38 +5 |
| 3 | 10k | Resistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_Horizontal | R1, R2, R3 |
| 3 | SW_Push | Button_Switch_THT:SW_PUSH-12mm | SW2, SW3, SW4 |
| 2 | TestPoint | TestPoint:TestPoint_Keystone_5015_Micro_Mini | BAT+, GND |
| 1 | Battery Connector | Connector_JST:JST_PH_S2B-PH-K_1x02_P2.00mm_Horizontal | BT1 |
| 1 | LOGO | LOGO | G*** |
| 1 | MOUDLE-SEEEDUINO-XIAO-ESP32S3 | ESP32-S3:XIAO-ESP32S3-DIP | U1 |
| 1 | OLED Display | Connector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm_Vertical | J1 |
| 1 | SW_SPDT | Button_Switch_THT:SW_Slide_SPDT_Angled_CK_OS102011MA1Q | SW1 |
| 1 | U1_Header_1 | Connector_PinSocket_2.54mm:PinSocket_1x07_P2.54mm_Vertical | J2 |
| 1 | U1_Header_2 | Connector_PinSocket_2.54mm:PinSocket_1x07_P2.54mm_Vertical | J3 |
Similar boards
- 4 layers15 × 13.9 mm

- 2 layers101.2 × 199.1 mm

- 2 layers85.4 × 53.7 mm

- 4 layers144 × 150 mm

- 2 layers60 × 120 mm

ESP8266Tetris
arraym/ESP8266Tetris
Tetris game with ESP8266 (ESP-12F) and WS2812B (128 RGB LEDs) - KiCAD schematic and PCB
235 parts2 - 2 layers62.2 × 30.5 mm

- 2 layers210 × 100 mm

Logic tabor
RoboticsBrno/RB3205-Logic
Logic is a universal programmable toy designed for teaching programming developed at Robotárna.
326 parts2 - 2 layers230 × 17.5 mm

Questions
How big is the Gradcap threatmap PCB?
It measures 235 × 235 mm and has 2 copper layers, 1.6 mm thick.
What parts does the Gradcap threatmap use?
79 parts, built around the WS2812C-2020-V1 and WS2812C. 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 Gradcap threatmap KiCad files?
From the peter-lamantia/gradcap-threatmap repository on GitHub, at the commit this page was made from: the board is pcb/pcb.kicad_pcb and its schematic pcb/pcb.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Can I use the Gradcap threatmap design in my own project?
Its repository states no licence, so its author keeps all rights: ask peter-lamantia before reusing the design.