
Device
jayis1/hacker-devices
Full-cycle hardware designs for security research devices — each device is a subfolder with its own README, schematics, PCB layout, and software stack

A low cost putting simulator
Putt sim is an open-source printed circuit board by owensievers21-eng, from the owensievers21-eng/Putt-sim repository on GitHub. It is a 2-layer board with 31 parts on 60 nets.
It is built around the ESP32-C3-MINI-1, ICM-20948 and MCP1700-3302E/TT, with the MCP73831 among its other parts. Its parts include 12 capacitors, 9 resistors, 4 ICs, 2 diodes and 2 connectors. It belongs with the ESP32 and RISC-V boards of this library.
A putting analyzer: a club-mounted ESP32 + ICM-20948 IMU streams a raw motion window over BLE at the end of each stroke, and a laptop turns it into putt metrics, simulates the ball rolling on a breaking green, and projects the line onto the floor at true 1:1 scale.
The design splits cleanly into a dumb sensor and a smart laptop: the firmware only decimates and ships raw IMU samples; all metric computation, ball physics, and visualization live in Python where they're easy to test and change.
club-mounted sensor laptop (Python)
┌──────────────────┐ ┌────────────────────────────────────┐
│ ESP32-C3 / C6 │ BLE │ listen-ble ─► metrics ─► SQLite │
│ + ICM-20948 IMU │ ───────► │ │ │
│ raw window │ framed │ ├─► ball-roll sim │
│ (100 Hz, JSON) │ PUTT+len │ │ (break + dist) │
└──────────────────┘ │ ├─► mat projection │
│ └─► Streamlit dash │
└────────────────────────────────────┘PUTT magic + length + JSON, MTU-chunked) and sent over BLE.| Path | What's there |
|---|---|
src/puttsim/ | Python package: ingest CLI, metrics, ball-roll sim, mat projection, dashboard |
firmware/putt_sensor_ble/ | Canonical BLE sensor firmware (ESP32-C3) |
firmware/putt_sensor_ble_c6_breadboard/ | Throwaway XIAO ESP32-C6 breadboard test sketch + wiring/capacitor notes |
tests/ | Pytest suite (pure logic: metrics, geometry, dashboard helpers, firmware contract) |
*.kicad_*, production/ | KiCad PCB design, DRC reports, and production gerbers/BOM |
docs/ | Design specs |
Install (editable, with the extras you need):
python -m pip install -e ".[dashboard,ble,mat]"Extras: dashboard (Streamlit + pandas + matplotlib), ble (bleak), mat
(pygame), dev (pytest). Requires Python 3.11+.
python -m puttsim)| Command | Purpose |
|---|---|
scan | List nearby BLE devices (find the sensor) |
monitor | Print incoming BLE window summaries (bring-up) |
listen-ble | Receive raw windows over BLE → metrics → SQLite store |
listen / listen-raw | Same over UDP (metrics, or raw windows) |
synth / synth-raw | Generate synthetic putts into a store (no hardware) |
mat | Fullscreen mat projection on the projector |
python -m streamlit run src/puttsim/dashboard.py -- --db putts.sqlite --name putt-01Live session metrics, a start/stop sensor button, a swing-axis check, and hole distance in feet.
python -m puttsim mat # projector = display 1, press C to calibrateThe mat renders at true scale — a similarity transform driven by
px_per_m / rotation_deg / center. In calibrate mode it draws a 1.00 m
reference bar; tape a tape-measure on the floor and adjust the scale (+/-)
until the bar reads 1.00 m, and every projected distance then equals the real
distance. Adjust again if the projector height changes.
The mat view owns the BLE connection and writes putts to the store, so the dashboard just reads that same file via its Live toggle. Don't also run
listen-bleat the same time — only one program can hold the sensor.
Breadboard bring-up (pins, and the decoupling capacitor that fixes BLE
brownouts) is documented in
firmware/putt_sensor_ble_c6_breadboard/CAPACITOR-AND-WIRING.md.
python -m pytestThe suite covers the pure logic — metrics, mat geometry, dashboard helpers, and a firmware-contract check that the sketch still emits the expected window fields.
Working end-to-end on real hardware over BLE. Active work is on the physical rig: decoupling capacitor, club-head mount, and live on-floor projection.
| Qty | Value | Footprint | References |
|---|---|---|---|
| 4 | 100nF | Capacitor_SMD:C_0402_1005Metric | C1, C6, C8, C11 |
| 3 | 10k | Resistor_SMD:R_0402_1005Metric | R3, R5, R6 |
| 2 | 10uF | Capacitor_SMD:C_0805_2012Metric | C4, C5 |
| 2 | 1uF | Capacitor_SMD:C_0402_1005Metric | C7, C10 |
| 2 | 4.7uF | Capacitor_SMD:C_0805_2012Metric | C2, C3 |
| 2 | 5.1k | Resistor_SMD:R_0402_1005Metric | R1, R2 |
| 1 | 10R | Resistor_SMD:R_0402_1005Metric | R7 |
| 1 | 1M | Resistor_SMD:R_0402_1005Metric | R9 |
| 1 | 1k | Resistor_SMD:R_0402_1005Metric | R4 |
| 1 | 22uF | Capacitor_SMD:C_1206_3216Metric | C9 |
| 1 | 4.7nF | Capacitor_SMD:C_0402_1005Metric | C12 |
| 1 | 680R | Resistor_SMD:R_0402_1005Metric | R8 |
| 1 | BOOT | Button_Switch_SMD:SW_SPST_B3U-1000P | SW2 |
| 1 | ESP32-C3-MINI-1 | PCM_Espressif:ESP32-C3-MINI-1 | U1 |
| 1 | ICM-20948 | Package_DFN_QFN:QFN-24-1EP_3x3mm_P0.4mm_EP1.75x1.6mm | U2 |
| 1 | LiPo | Connector_JST:JST_PH_B2B-PH-K_1x02_P2.00mm_Vertical | J2 |
| 1 | MCP1700-3302E | Package_TO_SOT_SMD:SOT-23 | U4 |
| 1 | MCP73831 | Package_TO_SOT_SMD:SOT-23-5 | U3 |
| 1 | Power | Button_Switch_SMD:SW_SPDT_PCM12 | SW1 |
| 1 | STAT | LED_SMD:LED_0402_1005Metric | D1 |
| 1 | STATUS | LED_SMD:LED_0402_1005Metric | D2 |
| 1 | USB-C | Connector_USB:USB_C_Receptacle_HCTL_HC-TYPE-C-16P-01A | J1 |

jayis1/hacker-devices
Full-cycle hardware designs for security research devices — each device is a subfolder with its own README, schematics, PCB layout, and software stack


sportiduino/sportiduino
Electronic timing system for orienteering and similar outdoor sports events on Arduino


meetjestad/mjs_pcb
This repository contains various versions of the sensor station PCB used by Meetjestad.


SpaceTeam/uHoubolt_PCB_ECU
µHoubolt Engine Control Unit KiCad project

31 parts, built around the ESP32-C3-MINI-1, ICM-20948, MCP1700-3302E/TT and MCP73831. 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.
From the owensievers21-eng/Putt-sim repository on GitHub, at the commit this page was made from: the board is putt-sim.kicad_pcb and its schematic put_sim/put_sim.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Its repository states no licence, so its author keeps all rights: ask owensievers21-eng before reusing the design.