Skip to the content
2 layers235 × 235 mmGradcap threatmap, the printed circuit board in 3D

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

2

README

README.md

Graduation Cap Live Threat Map PCB

About

This is a pet project to learn more about microcontroller development and PCB design.

My plan is to:

  1. Reverse engineer the Fortinet WebSocket API
  2. Program an ESP32 to connect to said API and log messages to serial
  3. 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
  4. 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
QtyValueFootprintReferences
43WS2812C-2020LED_SMD:LED_WS2812B-2020_PLCC4_2.0x2.0mmD2, D3, D4, D10, D11, D12, D13, D14, D15, D16, D17, D18, D19, D20, D21, D22 +27
21WS2812CLED_SMD:LED_WS2812B_PLCC4_5.0x5.0mm_P3.2mmD23, D24, D25, D26, D27, D28, D29, D30, D31, D32, D33, D34, D35, D36, D37, D38 +5
310kResistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_HorizontalR1, R2, R3
3SW_PushButton_Switch_THT:SW_PUSH-12mmSW2, SW3, SW4
2TestPointTestPoint:TestPoint_Keystone_5015_Micro_MiniBAT+, GND
1Battery ConnectorConnector_JST:JST_PH_S2B-PH-K_1x02_P2.00mm_HorizontalBT1
1LOGOLOGOG***
1MOUDLE-SEEEDUINO-XIAO-ESP32S3ESP32-S3:XIAO-ESP32S3-DIPU1
1OLED DisplayConnector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm_VerticalJ1
1SW_SPDTButton_Switch_THT:SW_Slide_SPDT_Angled_CK_OS102011MA1QSW1
1U1_Header_1Connector_PinSocket_2.54mm:PinSocket_1x07_P2.54mm_VerticalJ2
1U1_Header_2Connector_PinSocket_2.54mm:PinSocket_1x07_P2.54mm_VerticalJ3

Similar boards

  • 4 layers15 × 13.9 mmMONO CTRL, the printed circuit board in 3D

    MONO CTRL

    Aightech/CleverHand-hardware

    53 parts17GPL-3.0
  • 2 layers101.2 × 199.1 mmApollo, the printed circuit board in 3D

    Apollo

    Professor-plum/SAINTCON-BADGE-2026

    Electronic badge for SAINTCON2026

    80 parts5MIT
  • 2 layers85.4 × 53.7 mmDiva card, the printed circuit board in 3D

    Diva card

    diva-eng/diva-card

    Raspberry Pi 2040 based development board/card

    96 parts4MIT
  • 4 layers144 × 150 mmKepler x, the printed circuit board in 3D

    Kepler x

    kunichiko/X68k-KeplerX-PCB

    186 parts4MIT
  • 2 layers60 × 120 mmESP8266Tetris, the printed circuit board in 3D

    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 mmStm32dev, the printed circuit board in 3D

    Stm32dev

    lbthomsen/stm32dev

    44 parts2
  • 2 layers210 × 100 mmLogic tabor, the printed circuit board in 3D

    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 mmLighting for printopus, the printed circuit board in 3D

    Lighting for printopus

    scattercat-123/Printopus

    The ultimate 3d printer built by me.

    19 parts2

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.