No description
Find a file
2026-10-25 16:13:41 +02:00
arduino feat: hold the WiFi module in reset until enabled by the firmware (FPGA v8) 2026-10-25 16:13:41 +02:00
fpga feat: hold the WiFi module in reset until enabled by the firmware (FPGA v8) 2026-10-25 16:13:41 +02:00
nix chore: add Quartus Prime Lite toolchain via nix flake in devbox 2026-10-25 12:09:56 +02:00
tools feat: hold the WiFi module in reset until enabled by the firmware (FPGA v8) 2026-10-25 16:13:41 +02:00
.gitignore feat: add device firmware with USB API, StrixFPGA library and API check tools 2026-10-25 15:29:36 +02:00
devbox.json feat: add device firmware with USB API, StrixFPGA library and API check tools 2026-10-25 15:29:36 +02:00
devbox.lock feat: add per-generator NIST health tests and dead-ring monitor, onod3000 output test (FPGA v4) 2026-10-25 13:36:55 +02:00
LICENSE Create LICENSE 2024-07-21 18:24:50 +03:00
NOTES.md fpga project set up 2024-07-21 18:38:16 +03:00
README.md feat: add device firmware with USB API, StrixFPGA library and API check tools 2026-10-25 15:29:36 +02:00

STRIX

Satellite True Random Information eXtractor

A portable wireless True Random Number Generator built on an Arduino MKR Vidor 4000.

Design

Entropy comes from FPGA ring oscillators whose sampled timing jitter is XOR-combined into output bits, with no pseudo-random post-processing. A SAMD21 serves the results over USB (WiFi is planned).

  • 4 independent generators × 90 ring oscillators. Each generator XORs its rings every 120 MHz clock (spatial) and then several consecutive bits (temporal, default 5): about 24 Mbps per generator.
  • Separate stream per generator, plus a combined stream of all healthy generators
  • On-device health tests per generator: NIST SP 800-90B repetition count and adaptive proportion, plus a dead-ring monitor
  • Live statistics per trial: bias, z-score, random walk and lag-1 autocorrelation, with rolling and cumulative windows
  • Configurable random-walk / majority-vote bias amplifier on a bias path and an autocorrelation path, with sub-trial voting
  • Von Neumann extractor that can be toggled on the stream, statistics and amplifier paths
  • Raw ring captures and frequency measurement for characterization

The USB protocol is documented in arduino/strix/API.md.

Layout

  • fpga/rtl/: Verilog sources; fpga/sim/: testbenches; fpga/src/: Quartus project
  • arduino/strix/: device firmware
  • arduino/strix_capture/: characterization tool firmware, used by tools/jitter.py
  • arduino/libraries/: StrixFPGA (FPGA boot, SPI access, embedded FPGA image) and VidorBoot (vendored subset of Arduino's VidorPeripherals)
  • tools/: FPGA image converter, jitter and statistics experiments, API check

Development (Linux)

The toolchain is managed by devbox: arduino-cli, Intel Quartus Prime Lite (Cyclone 10 LP only, through a Nix flake in nix/), Icarus Verilog, Python and Rust.

  1. devbox run setup: install the Arduino SAMD core and libraries
  2. devbox run sim: run the FPGA testbenches
  3. devbox run fpga: build the FPGA bitstream (about 10 minutes)
  4. devbox run image: embed the bitstream in the StrixFPGA library
  5. devbox run build, then devbox run upload: build and flash the firmware (PORT defaults to /dev/ttyACM0)
  6. devbox run api-check: end-to-end check of the USB API

Serial access requires membership in the dialout group. For characterization, flash the capture tool with devbox run upload-capture and use devbox run jitter <freq|rings|sweep|output|health|stats|amp|pairs>. devbox run onod-build builds the onod3000 test suite used by jitter output and api-check.

TODO

  • Serve randomness over WiFi (NINA pass-through in the FPGA is wired, firmware not yet)
  • Make Vidor pairable via Bluetooth
  • Battery pack
  • 3D case

Development Notes