Skip to the content
2 layersPutt sim, the printed circuit board in 3D

A low cost putting simulator

Copper layers
2
Thickness
1.6 mm
Parts
31
Nets
60
Pads
179
Tracks, vias
0, 0
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
26 Jul 2026
Updated
5 Aug 2026

Overview

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.

Main components

4

README

README.md

Putt-Sim

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.


How it works

text
  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  │
                                 └────────────────────────────────────┘
  1. Arm — the sensor holds still, captures gravity + gyro bias, then watches for a stroke.
  2. Stroke — it records a short window of raw accel/gyro samples.
  3. Stream — the window is framed (PUTT magic + length + JSON, MTU-chunked) and sent over BLE.
  4. Compute — the laptop reassembles the window and derives club-head speed, face angle, path, and tempo.
  5. Simulate + show — the putt is rolled out on a virtual green (stimp + slope), then drawn on the dashboard and projected on the floor.

Repository layout

PathWhat'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

Laptop software

Install (editable, with the extras you need):

bash
python -m pip install -e ".[dashboard,ble,mat]"

Extras: dashboard (Streamlit + pandas + matplotlib), ble (bleak), mat (pygame), dev (pytest). Requires Python 3.11+.

CLI (python -m puttsim)

CommandPurpose
scanList nearby BLE devices (find the sensor)
monitorPrint incoming BLE window summaries (bring-up)
listen-bleReceive raw windows over BLE → metrics → SQLite store
listen / listen-rawSame over UDP (metrics, or raw windows)
synth / synth-rawGenerate synthetic putts into a store (no hardware)
matFullscreen mat projection on the projector

Dashboard

bash
python -m streamlit run src/puttsim/dashboard.py -- --db putts.sqlite --name putt-01

Live session metrics, a start/stop sensor button, a swing-axis check, and hole distance in feet.

Projection

bash
python -m puttsim mat            # projector = display 1, press C to calibrate

The 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-ble at the same time — only one program can hold the sensor.


Hardware

  • MCU/radio: ESP32-C3 (canonical board) — native USB, BLE 5. A XIAO ESP32-C6 is supported for breadboard testing.
  • IMU: ICM-20948 over SPI (±16 g / ±2000 dps, 100 Hz+ streamed).
  • Board: 25 × 20 mm 2-layer, 3.3 V LDO rail, MCP73831 charger, 250 mAh LiPo.

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.


Tests

bash
python -m pytest

The suite covers the pure logic — metrics, mat geometry, dashboard helpers, and a firmware-contract check that the sketch still emits the expected window fields.


Status

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.

Parts

31
QtyValueFootprintReferences
4100nFCapacitor_SMD:C_0402_1005MetricC1, C6, C8, C11
310kResistor_SMD:R_0402_1005MetricR3, R5, R6
210uFCapacitor_SMD:C_0805_2012MetricC4, C5
21uFCapacitor_SMD:C_0402_1005MetricC7, C10
24.7uFCapacitor_SMD:C_0805_2012MetricC2, C3
25.1kResistor_SMD:R_0402_1005MetricR1, R2
110RResistor_SMD:R_0402_1005MetricR7
11MResistor_SMD:R_0402_1005MetricR9
11kResistor_SMD:R_0402_1005MetricR4
122uFCapacitor_SMD:C_1206_3216MetricC9
14.7nFCapacitor_SMD:C_0402_1005MetricC12
1680RResistor_SMD:R_0402_1005MetricR8
1BOOTButton_Switch_SMD:SW_SPST_B3U-1000PSW2
1ESP32-C3-MINI-1PCM_Espressif:ESP32-C3-MINI-1U1
1ICM-20948Package_DFN_QFN:QFN-24-1EP_3x3mm_P0.4mm_EP1.75x1.6mmU2
1LiPoConnector_JST:JST_PH_B2B-PH-K_1x02_P2.00mm_VerticalJ2
1MCP1700-3302EPackage_TO_SOT_SMD:SOT-23U4
1MCP73831Package_TO_SOT_SMD:SOT-23-5U3
1PowerButton_Switch_SMD:SW_SPDT_PCM12SW1
1STATLED_SMD:LED_0402_1005MetricD1
1STATUSLED_SMD:LED_0402_1005MetricD2
1USB-CConnector_USB:USB_C_Receptacle_HCTL_HC-TYPE-C-16P-01AJ1

Similar boards

  • 4 layers25 × 75 mmDevice, the printed circuit board in 3D

    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

    18 parts2
  • 2 layers15 × 31 mmPocketAdmin, the printed circuit board in 3D

    PocketAdmin

    krakrukra/PocketAdmin

    oshw keystroke injection device ( badusb )

    25 parts241MIT
  • 2 layers73 × 94 mmSportiduino base, the printed circuit board in 3D

    Sportiduino base

    sportiduino/sportiduino

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

    119 parts78GPL-3.0
  • 2 layers50 × 75 mmLocalTrack, the printed circuit board in 3D

    LocalTrack

    krakrukra/LocalTrack

    OSHW GPS Tracker (Logger)

    63 parts18MIT
  • 2 layers97.2 × 55.9 mmMjs pcb, the printed circuit board in 3D

    Mjs pcb

    meetjestad/mjs_pcb

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

    83 parts6
  • 2 layers100 × 100 mmKijaniCarrier, the printed circuit board in 3D

    KijaniCarrier

    Waziup/WaziDev

    WaziDev official repository

    75 parts5Apache-2.0
  • 4 layers70 × 40 mmUHoubolt PCB ECU, the printed circuit board in 3D

    UHoubolt PCB ECU

    SpaceTeam/uHoubolt_PCB_ECU

    µHoubolt Engine Control Unit KiCad project

    216 parts2CERN-OHL-W-2.0
  • 2 layers37.8 × 50 mmXilwatch2, the printed circuit board in 3D

    Xilwatch2

    xil-se/xilwatch_hw

    68 parts2

Questions

What parts does the Putt sim use?

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.

Where can I download the Putt sim KiCad files?

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.

Can I use the Putt sim design in my own project?

Its repository states no licence, so its author keeps all rights: ask owensievers21-eng before reusing the design.