reTerminal DM4 eMMC auto-provisioning
Automatically flash a golden image to the CM4 eMMC when the reTerminal is connected in boot mode (eMMC disable jumper). Optional backup mode saves the current eMMC to a timestamped image file instead. Uses cloud-init for first-boot configuration.
| File | Purpose |
|---|---|
| EMMC-PROVISIONING-GUIDE.md | Full setup and usage guide – read this first. |
| flash-emmc-on-connect.sh | Script that runs rpiboot then either flashes the golden image to eMMC or backs up eMMC to a file (mode set via dashboard or mode file). |
| cm4-flash-trigger.sh | Called by udev when CM4 in boot mode is connected; starts the flash job. |
| 90-cm4-boot-mode.rules | udev rule: when USB device 2b8e is added, run the trigger script. |
| cloud-init/ | Example NoCloud files (user-data, meta-data, network-config) for the golden image. |
| dashboard/ | Flask web UI: auto-detect device (USB or network), prompt Backup or Deploy, show status and connection steps. See dashboard/README.md. |
| network-client/ | Script for network-booted devices: register with the dashboard and perform Deploy (pull image, write eMMC) or Backup (upload eMMC). See network-client/README.md. |
Quick start: see EMMC-PROVISIONING-GUIDE.md.
Proxmox: LXC 201 + host setup is documented in PROXMOX-LXC-DEPLOYMENT.md. Use scripts/deploy-to-proxmox.sh to deploy to a Proxmox host; flash runs on the host, golden image is in a bind-mounted dir shared with the LXC.