ONK Settleometer — DEV Distribution
====================================
Version: x12a (v1.2a)
OS Base: Raspberry Pi OS Trixie Desktop (64-bit) 2025-12-04
Updated: 2026-03-19

PINNED OS IMAGE (use this — do NOT use Pi Imager's built-in download):
  2025-12-04-raspios-trixie-arm64.img.xz          (1.3 GB)
  2025-12-04-raspios-trixie-arm64.img.xz.sha256

PROVISIONING BUNDLE (extract to boot partition after flash):
  onk-dev-provision-20260319.zip                   (5 MB)

CODE + DATA (downloaded automatically by setup script):
  settleometer-x12a-code.tar.gz                    (26 MB)
  settleometer-sample-images.tar.gz                (22 MB)
  settleometer-data-seed.tar.gz                    (185 KB)

TECHNICIAN INSTRUCTIONS:
  1. Download the pinned OS image (.img.xz) and provisioning bundle (.zip)
  2. Open Raspberry Pi Imager
     - Choose OS → Use custom → select the downloaded .img.xz
     - Choose Storage → select SD card
     - Click Next → if asked about customization, click "No" (bundle handles it)
     - Flash and wait for completion
  3. Eject and re-insert SD card
  4. Open the boot partition (bootfs) on your computer
  5. Open the provisioning bundle .zip and copy ALL contents into bootfs
     You should see these on bootfs:
       user-data        (creates onk user, SSH, password)
       vendor-data      (triggers first-boot setup)
       onk-config/      (setup script, binaries, configs)
  6. Edit bootfs/onk-config/onk-wifi.txt with your WiFi credentials:
       WIFI_SSID=YourNetworkName
       WIFI_PASSWORD=YourPassword
     (skip this step if using Ethernet)
  7. Eject SD card safely
  8. Insert SD card into Pi (Pi4 or Pi5), power on
  9. First boot takes ~20 minutes (installs packages, downloads code)
     Pi reboots automatically when complete
  10. Device checks in on FRP SSH port 8088

  Default login: onk / settleOmeter

ENGINEERING PROVISIONING (after device checks in):
  ssh -p 8088 onk@64.181.254.46
  sudo bash /opt/onk/onk-provision.sh --device DEVICE_ID

  Available devices: JKIM-SM2, JKIM-SM3, SOH-SM2, TIWRP-A, TIWRP-B,
                     HWRP-A, SJRWF-A