
NRF9151 Feather
SteveUcho/Cat-GPS-nRF9151
nRF9151 pcb based on the circuitdojo feather, but smaller
A GPS tracker that rides at 1 Hz and fits in a 10 MB/month IoT plan: nRF9151 firmware (Zephyr/NCS), a small Python server, and a no-build web map — one repo, everything field-measured.
NRF9151 Feather is an open-source printed circuit board by chgpalmer, from the chgpalmer/nrf9151-tracker repository on GitHub. It is a 4-layer board of 50.8 × 22.9 mm with 151 parts on 175 nets, routed with 1,197 tracks and 241 vias.
It is built around the RP2040, SKY65723-81 and W25Q128JVPIQ, with the SIM-ST-MFF2, TC7PZ14FU,LJ and TPS22919DCK among its other parts. Its parts include 48 capacitors, 15 resistors, 11 ICs, 6 connectors and 3 switches. It belongs with the microcontroller boards boards and the RP2040 boards of this library.
A GPS tracker that rides at 1 Hz and fits in a 10 MB/month IoT plan: nRF9151 firmware (Zephyr/NCS), a small Python server, and a no-build web map — one repo, everything field-measured.
Measured on the reference deployment (NB-IoT B20, Vodafone UK roaming, flolive
SIM, one small VM); the stack is network- and host-agnostic. Full spec sheet:
git show v0.1.0-alpha.
flowchart LR
subgraph dk [nRF9151 tracker]
FSM[GNSS/LTE arbitration FSM<br/>1 Hz moving - periodic parked]
UP[pull-model uplink<br/>protobuf batches + device logs]
FSM --> UP
end
UP -- "CoAP NON / UDP 5683<br/>RAI + PSM" --> COAP[aiocoap ingest]
COAP -. "A-GNSS ~1 KB" .-> UP
BKG[BKG broadcast ephemeris<br/>free, 15-min fresh] --> COAP
COAP --> DB[(SQLite<br/>positions - logs - usage)]
DB --> API[FastAPI]
API --> WEB[web map<br/>vanilla ESM + Leaflet]
CADDY[Caddy<br/>auto-HTTPS + basicauth] --- APIcurl -fsSL https://raw.githubusercontent.com/chgpalmer/nrf9151-tracker/main/setup.sh | bash
cd nrf9151-tracker-ws/nrf9151-tracker
make setup-host # server deps
make demo # sim device -> local CoAP server -> web map on :8080
make setup-webtest && make webtest # drive the UI headlessly, fail on any JS error
./smoke.sh # build + demo end-to-end, incl. the A-GNSS exchangeThe native_sim build swaps one file (a modem mock) for the real modem — the
firmware under test is otherwise the shipping firmware.
Requires: an nRF9151-DK, any LTE-M/NB-IoT SIM, Ubuntu 24.04 (WSL2 fine — Python 3.13+ breaks NCS module pins), and a host with a public UDP port for the server.
cp env.template .env # server host/port, SIM APN — see Configuration
make setup-tools # nrfutil, usbip, tio
make build # APP=tracker BOARD=nrf9151dk/nrf9151/ns
make windows-usb-passthrough # WSL only: attach the J-Link (usbipd)
make flash
make uart.env)Host-specific values are never committed. cp env.template .env, then:
| Variable | Used by | Purpose |
|---|---|---|
TRACKER_SERVER_HOST/PORT | make build | CoAP server the device sends to (coap://HOST:PORT/obs, UDP) |
TRACKER_APN | make build | SIM-provider APN; empty = the SIM's default |
CADDY_DOMAIN | make serve | domain for auto-HTTPS; empty = plain HTTP by IP |
CADDY_USERNAME/PASSWORD | make serve | web-UI basicauth |
OPENCELLID_TOKEN | make update-cells | tower DB for locating cell-only fixes |
Precedence: CLI > .env > default (make build TRACKER_SERVER_HOST=x wins).
GNSS/LTE arbitration. One radio, two tenants. An explicit FSM decides who
owns it: 1 Hz continuous GNSS while moving, modem-native periodic fixes while
parked, LTE deactivated outright when idle-mode paging chops GNSS windows.
docs/loc-fsm-decision-table.md is the
NORMATIVE description — code, table, and make fsmtest change together, and
every threshold in it traces to a measured incident.
Assisted GNSS. The server pulls the free BKG broadcast-ephemeris file, does all ICD-200 scaling server-side, and answers the device's CoAP request with ~1 KB of ephemerides elevation-filtered at its last known position.
Wire protocol. Protobuf in non-confirmable CoAP POSTs over UDP. Schema in
one place (proto/tracker.proto + nanopb options); both codecs are generated
(make proto), so ends can't drift. GPS data travels as track segments — one
absolute anchor plus packed zigzag delta arrays, per-point time implicit —
so a moving point costs ~6 B instead of ~33 B. Speed is per-point GNSS
Doppler, never derived (position-delta speed carries ~8 km/h jitter at 1 Hz).
Segments cap at 50 points pre-encode to stay under the ~512 B cellular-safe
MTU; a batch is several datagrams, RAI_ONGOING on intermediates and
RAI_LAST on the final one so the modem drops the radio connection
immediately instead of waiting out the network's inactivity timer.
Uplink. Pull model: sources (cell fixes, GPS segments, device logs)
register with priorities; the drain loop fills datagrams through
transactional encode/commit/rollback cursors — a failed send loses nothing,
and the ring buffers ~34 min of 1 Hz offline. Device logs (INF and up) ship
over the same path; WRN+ triggers an urgent flush. Every datagram lands in a
usage ledger, and the same cost model runs in the browser as the settings
estimator.
Data budget. ~1 KB/min riding, a few hundred B/h parked. Carrier-billed bytes run ≈ 2× the app-layer arithmetic (per-session rounding — measured, so budget with the factor). The ingest is anonymous and unauthenticated; DTLS-PSK via the modem's offloaded sockets is the planned upgrade.
| Tier | Command | Contract |
|---|---|---|
| FSM unit | make fsmtest | 52 ztest cases pin the decision table |
| Server | make servertest | pytest against a committed real broadcast-ephemeris file |
| Web UI | make webtest | Playwright, desktop 1400×900 + phone 360×740, structural asserts |
| End-to-end | ./smoke.sh | build + sim → server → web, incl. A-GNSS exchange |
make setup-host # python deps only
make serve # public HTTP by IP
make serve CADDY_DOMAIN=tracker.example.com # auto-HTTPS via Let's EncryptThe API binds 127.0.0.1; Caddy (systemd, survives Ctrl-C) is the only public
face, with bcrypt basicauth from .env. First run opens the firewall
(80/443 TCP, 5683 UDP) — cloud security lists must allow the same.
v0.1.0-alpha — first coherent end-to-end state; the tag annotation is the
spec sheet. Open: DTLS-PSK for the ingest, registration-loss vs GNSS (F-5),
indoor churn (F-6), wake-fix corroboration, quiet-while-parked, LTE-M carrier
scan, NTN.
Make targets: setup-zephyr (venv + west + SDK), setup-tools,
windows-usb-passthrough, build, flash, recover, uart, gdb,
clean, sim, proto, fsmtest, demo, serve, webtest,
servertest, update-cells. Variables: APP
(tracker|gnss|hello|atprobe|imuprobe — the last two are bare
consoles: an AT passthrough for modem diagnostics like carrier scans, and
a LIS3DH bring-up probe that pulses LED1 on its motion interrupt),
BOARD (nrf9151dk/nrf9151/ns — non-secure, required for modem/GNSS),
PORT, BAUD, RUNNER.
LEDs:
| LED | Meaning | Off | Blink | Solid |
|---|---|---|---|---|
| 1 | LTE | radio off on purpose | attaching | registered |
| 2 | GPS | GNSS not running | acquiring — see below | fix current |
| 3 | TX | — | — | pulse per successful send |
| 4 | IMU | — | pulse per accelerometer motion interrupt | steady while moving |
LED2's acquiring blink is a progress meter (2 s cycle): one long slow pulse = searching with nothing usable; 1–4 crisp blips = that many tracked satellites with ephemeris — 4 blips means the fix is imminent. LED2 solid = safe to start moving. LED4 blips when the accelerometer feels movement (the parked wake source); GNSS_EXCLUSIVE reads as LED1 off with LED2 acquiring.
Layout:
nrf9151-tracker-ws/ workspace root (created by setup.sh)
zephyr/ nrf/ ... SDK trees (west update, trimmed allowlist)
nrf9151-tracker/ this repo == the west manifest
west.yml imports sdk-nrf v3.4.0 (name-allowlist)
proto/tracker.proto wire schema — single source for both codecs
mk/fw.mk mk/server.mk firmware / server make targets
apps/tracker/ the firmware (gnss/, hello/ = bring-up; atprobe/, imuprobe/ = probes)
server/ aiocoap ingest + FastAPI + static webapp
docs/loc-fsm-decision-table.md normative FSM spec
tests/fsm/ ztest suite for loc_fsm + motion
scripts/ setup, webtest, seeding, usbipd passthrough| Qty | Value | Footprint | References |
|---|---|---|---|
| 22 | 0.1u | Capacitor_SMD:C_0402_1005Metric | C12, C13, C14, C15, C16, C19, C20, C21, C22, C23, C25, C27, C33, C35, C37, C41 +6 |
| 6 | 100p | Capacitor_SMD:C_0402_1005Metric | C29, C30, C31, C39, C40, C46 |
| 6 | 10u | Capacitor_SMD:C_0603_1608Metric | C4, C10, C11, C24, C36, C42 |
| 6 | 1k | Resistor_SMD:R_0402_1005Metric | R1, R6, R9, R10, R13, R14 |
| 6 | TestPoint | TestPoint:TestPoint_Pad_D1.0mm | TP1, TP2, TP3, TP4, TP5, TP6 |
| 4 | 120 | Resistor_SMD:R_0402_1005Metric | FB1, FB2, FB3, FB4 |
| 4 | 15p | Capacitor_SMD:C_0402_1005Metric | C7, C9, C26, C38 |
| 4 | 2.2u | Capacitor_SMD:C_0603_1608Metric | C2, C5, C17, C18 |
| 4 | 255k | Resistor_SMD:R_0402_1005Metric | R2, R4, R11, R12 |
| 4 | FIDUCIAL-1MM | Fiducial:Fiducial_1mm_Mask2mm | U$1, U$2, U$3, U$4 |
| 3 | 100 | Resistor_SMD:R_Array_Convex_2x0402 | RN2, RN3, RN4 |
| 3 | 10k | Resistor_SMD:R_0402_1005Metric | R3, R8, TH1 |
| 3 | 4.7u | Capacitor_SMD:C_0603_1608Metric | C8, C32, C34 |
| 3 | SW-434153017835 | Button_Switch_SMD:SW_SPST_B3U-1000P | SW1, SW2, SW3 |
| 2 | 1M | Resistor_SMD:R_0402_1005Metric | R5, R7 |
| 2 | 1u | Capacitor_SMD:C_0402_1005Metric | C1, C3 |
| 2 | 2.2u | Circuit Dojo:IND-2P0X2P0X1P2 | L1, L2 |
| 2 | MountingHole | MountingHole:MountingHole_2.5mm | H1, H2 |
| 2 | MountingHole_Pad | MountingHole:MountingHole_2.5mm_Pad_TopOnly | H3, H4 |
| 1 | 1042240820 | footprints:1042240820 | U3 |
| 1 | 18-038BT/BDGAR6S1-CC01/10T | LED_SMD:LED_Wurth_150044M155260 | D1 |
| 1 | 20k | Resistor_SMD:R_Array_Convex_2x0402 | RN5 |
| 1 | 47u | Capacitor_SMD:C_0805_2012Metric | C28 |
| 1 | BAT54CW | Package_TO_SOT_SMD:SOT-323_SC-70 | D2 |
| 1 | CON-HEADER-1X12-MALE-PIN | Circuit Dojo:CON-HEADER-1X12-MALE-PIN | J1 |
| 1 | CON-HEADER-1X16-MALE-PIN | Circuit Dojo:CON-HEADER-1X16-MALE-PIN | J2 |
| 1 | CON-S2B-PH-SM4-TB(LF)(SN) | nrf91-feather:JST_S2B-PH-SM4-TB(LF)(SN) | J4 |
| 1 | CON-SM04B-SRSS-TB | Connector_JST:JST_SH_SM04B-SRSS-TB_1x04-1MP_P1.00mm_Horizontal | J5 |
| 1 | CON-USB-1003-030-01210-TR | Circuit Dojo:CNC_TECH_1003-030-01210-TR | J3 |
| 1 | Conn_Coaxial | Connector_Coaxial:U.FL_Hirose_U.FL-R-SMT-1_Vertical | J6 |
| 1 | Crystal_GND24 | Crystal:Crystal_SMD_2520-4Pin_2.5x2.0mm | Y1 |
| 1 | G*** | kibuzzard-6699D3D9 | kibuzzard-6699D3D9 |
| 1 | G*** | kibuzzard-6699D437 | kibuzzard-6699D437 |
| 1 | G*** | kibuzzard-6699D445 | kibuzzard-6699D445 |
| 1 | G*** | kibuzzard-68A8CF71 | kibuzzard-68A8CF71 |
| 1 | G*** | kibuzzard-6699D455 | kibuzzard-6699D455 |
| 1 | G*** | kibuzzard-6699D3A2 | kibuzzard-6699D3A2 |
| 1 | G*** | kibuzzard-69866146 | kibuzzard-69866146 |
| 1 | G*** | kibuzzard-6699D406 | kibuzzard-6699D406 |
| 1 | G*** | kibuzzard-6699D36C | kibuzzard-6699D36C |
| 1 | G*** | kibuzzard-66ABF405 | kibuzzard-66ABF405 |
| 1 | G*** | kibuzzard-6699D45C | kibuzzard-6699D45C |
| 1 | G*** | kibuzzard-69681563 | kibuzzard-69681563 |
| 1 | G*** | kibuzzard-66ABB181 | kibuzzard-66ABB181 |
| 1 | G*** | kibuzzard-6699D37C | kibuzzard-6699D37C |
| 1 | G*** | kibuzzard-6699D388 | kibuzzard-6699D388 |
| 1 | G*** | kibuzzard-6699D3B6 | kibuzzard-6699D3B6 |
| 1 | G*** | kibuzzard-6699D393 | kibuzzard-6699D393 |
| 1 | G*** | kibuzzard-6699D3FF | kibuzzard-6699D3FF |
| 1 | G*** | kibuzzard-66ABCF7A | kibuzzard-66ABCF7A |
| 1 | G*** | kibuzzard-6699D3CF | kibuzzard-6699D3CF |
| 1 | G*** | kibuzzard-6699D42E | kibuzzard-6699D42E |
| 1 | G*** | kibuzzard-6699D464 | kibuzzard-6699D464 |
| 1 | G*** | kibuzzard-66466926 | kibuzzard-66466926 |
| 1 | G*** | kibuzzard-6699D429 | kibuzzard-6699D429 |
| 1 | G*** | kibuzzard-6699D44E | kibuzzard-6699D44E |
| 1 | G*** | kibuzzard-6699D414 | kibuzzard-6699D414 |
| 1 | G*** | kibuzzard-665B4C23 | kibuzzard-665B4C23 |
| 1 | G*** | kibuzzard-6699D43F | kibuzzard-6699D43F |
| 1 | G*** | kibuzzard-6699D3BF | kibuzzard-6699D3BF |
| 1 | G*** | kibuzzard-6699D41B | kibuzzard-6699D41B |
| 1 | G*** | kibuzzard-6699D375 | kibuzzard-6699D375 |
| 1 | G*** | kibuzzard-66AC64B8 | kibuzzard-66AC64B8 |
| 1 | G*** | kibuzzard-6699D39A | kibuzzard-6699D39A |
| 1 | G*** | kibuzzard-6699D40E | kibuzzard-6699D40E |
| 1 | G*** | kibuzzard-66ABB18E | kibuzzard-66ABB18E |
| 1 | G*** | kibuzzard-6699D3C7 | kibuzzard-6699D3C7 |
| 1 | G*** | kibuzzard-6699D422 | kibuzzard-6699D422 |
| 1 | G*** | kibuzzard-6699D3A9 | kibuzzard-6699D3A9 |
| 1 | LIS2DH12TR | LIS2DH12TR 2:PQFN50P200X200100-12N | U7 |
| 1 | L_Ferrite_Coupled | Circuit Dojo:FIL_DLM0NSM900HY2D | L3 |
| 1 | RP2040 | Package_DFN_QFN:QFN-56-1EP_7x7mm_P0.4mm_EP3.2x3.2mm | U5 |
| 1 | SIM-ST-MFF2 | mff2:SIM-ST-MFF2_HOL | U6 |
| 1 | SKY65723-81 | KiCADv6:SKY65723-81_SKY-L | U10 |
| 1 | STS4X | Circuit Dojo:STS4X | U13 |
| 1 | TC7PZ14FU | Package_TO_SOT_SMD:SOT-363_SC-70-6 | U9 |
| 1 | TPS22919 | Package_TO_SOT_SMD:SOT-363_SC-70-6 | U11 |
| 1 | TS5A3166DCKR | Package_TO_SOT_SMD:SOT-353_SC-70-5 | U8 |
| 1 | W25Q128JVPIQ | Package_SON:WSON-8-1EP_6x5mm_P1.27mm_EP3.4x4.3mm | U4 |
| 1 | W25Q16JVUXIQ_TR | W25Q16JVUXIQ_TR:PSON50P300X200X60-9N | U1 |
The 149 most common of 151 parts.

SteveUcho/Cat-GPS-nRF9151
nRF9151 pcb based on the circuitdojo feather, but smaller



oresat/oresat-gps-hardware
Hardware for OreSat's SDR GPS receive and other SDR GPS projects


FallenBuillder/rfid-nfc-manager
This repository consists of schematics, PCB layouts, code and 3D models for a rfid,nfc manager.


It measures 50.8 × 22.9 mm and has 4 copper layers, 1.57 mm thick.
151 parts, built around the RP2040, SKY65723-81, W25Q128JVPIQ and SIM-ST-MFF2. 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 chgpalmer/nrf9151-tracker repository on GitHub, at the commit this page was made from: the board is hw/board/nRF9151_Feather.kicad_pcb and its schematic hw/board/debugger.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 chgpalmer before reusing the design.