Changelog

Copy Markdown View Source

v0.3.0 (2026-05-07)

/root (and /data via the existing symlink) is now persistent across reboots, matching standard Nerves convention.

  • rootfs_data (UBI volume 5) is now mounted at /root via a small --pre-run-exec script (/usr/sbin/mount-data.sh). The script lazily formats the volume with UBIFS on first boot and falls back to tmpfs if the persistent mount can't be brought up, so the device always boots even with unhealthy NAND. Without this, /root lived in the volatile rootfs (initramfs) and SSH host keys, NervesTime RTC drift fixes, etc. were regenerated on every reboot.
  • mkfs.ubifs (BR2_PACKAGE_MTD_MKFSUBIFS=y) is now built into the target image so the lazy-format step works.
  • nerves_fw_application_part0_devpath=/root (and fstype=ubifs, target=/root) is now baked into the U-Boot env, so nerves_motd resolves the data partition for its "Part usage" cell instead of falling back to "not available".

Backwards compatibility: existing v0.2.x installs upgrade cleanly. The first boot of v0.3.0 formats rootfs_data (which was an empty placeholder volume in v0.2.x). Rollback to v0.2.x is fine — the older slot's initramfs ignores the UBIFS, runs in volatile mode.

v0.2.3 (2026-05-06)

Routine upstream bump.

  • nerves_system_br 1.33.4 → 1.33.7
    • Erlang/OTP 28.4.1 → 28.5
    • fwup 1.14.0 → 1.16.0
    • Buildroot 2025.11.2 → 2025.11.3

No system-side changes required.

v0.2.2 (2026-04-09)

mix burn support via OpenWrt's NOR full-recovery mode.

  • mix burn now prepares a FAT32 USB recovery stick that OpenWrt's SPI NOR recovery U-Boot can use to flash the entire SPI NAND — no serial console, no TFTP server, no typing of U-Boot commands. The stick contains the snand-preloader.bin (BL2) and our openwrt-one-nand.ubi (renamed to factory.ubi). See README.md "Initial install" for the full procedure.
  • Ship prebuilt/openwrt-one-snand-preloader.bin from OpenWrt 24.10 (same source + license as the FIP).
  • fwup.conf: replace the erroring complete task with one that mbr_writes + fat_mkfses + fat_writes the recovery files. The .fw file grows by ~33 MiB (the .ubi) + 234 KiB (preloader) but mix burn now Just Works with no per-app config.
  • post-createfs.sh: stage the preloader into images/ so fwup can find it at firmware-build time.
  • README: document USB stick recovery as the primary initial-install path; serial + TFTP demoted to "alternative".

v0.2.1 (2026-04-08)

USB mass storage support.

  • Linux: enable CONFIG_SCSI, CONFIG_BLK_DEV_SD, CONFIG_USB_STORAGE, CONFIG_FAT_FS + CONFIG_VFAT_FS, CONFIG_EXFAT_FS, and the matching NLS tables (CP437, ISO8859-1, UTF-8). USB sticks now enumerate as /dev/sdN and FAT/exFAT partitions mount and read.

v0.2.0 (2026-04-08)

OTA + A/B slot support, kernel bump, several bug fixes that turned session-1 workarounds into proper fixes.

Added

  • A/B FIT slots: UBI layout now uses fit_a (vol 3) and fit_b (vol 4) instead of a single fit volume. Each slot is sized at 50 MiB. Active slot is selected at boot via fit_${nerves_fw_active} substitution in ubi_read_production.
  • Image-level boot fallback: if bootm fails on the active slot, U-Boot's boot_production flips nerves_fw_active, saveenvs, and retries the other slot.
  • Bootcount-based runtime rollback: OTA sets upgrade_available=1
    • bootcount=0; U-Boot's nerves_count_attempt script swaps slots once bootcount > bootlimit (default 3). Nerves.Runtime.StartupGuard clears the counters once the app is healthy.
  • scripts/upload-ota.sh + scripts/apply-ota.exs: volume-level OTA via SFTP + ubiupdatevol + fw_setenv. Designed to be aliased as mix upload from the user app.
  • NervesSystemOpenwrtOne.UBootEnvKVBackend: custom Nerves.Runtime.KVBackend that reads via the Erlang UBootEnv library and writes via the C fw_setenv (which issues UBI_IOCVOLUP). Without this the default backend returns :eperm on every KV.put and breaks validate_firmware/0.
  • Full OpenWrt 24.10 default U-Boot env baked into ubootenv volumes via prebuilt/uboot-env-template.txt, with the 0x1F000 env size matching CONFIG_ENV_SIZE in OpenWrt's mt7981 U-Boot. Eliminates the cosmetic boardid: U-boot environment CRC32 mismatch warning that was caused by sizing our env smaller than what U-Boot writes back.
  • CONFIG_IP_ADVANCED_ROUTER=y, CONFIG_IP_MULTIPLE_TABLES=y, CONFIG_IP_ROUTE_MULTIPATH=y so VintageNet's policy-routing setup doesn't crash with RTNETLINK answers: Operation not supported.

Changed

  • Linux 6.12 → 6.18.12.
  • SPI NAND driver path: dropped the spi-mtk-snfi attempt and the Etron 0x77-shifted-manufacturer-ID workaround. Now uses spi-mt65xx with the OpenWrt SPI calibration patch stack (patches 121, 330, 431-435, 930) plus mtk_bmt. The chip is actually a Winbond 256 MiB part, not the 128 MiB Etron we initially guessed.
  • U-Boot env path in fw_env.config: /dev/ubi0_0 and /dev/ubi0_1 instead of /dev/ubi0:ubootenv. The Erlang uboot_env library uses plain File.open and doesn't understand the :volname shorthand that fwup-tool's fw_printenv accepts.

Fixed

  • mkimage invocation in wrap-firmware.sh now prefers /usr/bin/mkimage over Buildroot's host build, because the latter ships with MKIMAGE_DTC="" and explodes with sh: 1: -I: not found whenever it tries to run dtc internally.

v0.1.0 (2026-04-07)

Initial Nerves system for the OpenWRT One.

  • Linux 6.12 mainline kernel with small patches
  • Custom DTS based on mainline mt7981b-openwrt-one.dts with full peripheral enablement
  • WiFi 2.4 / 5 GHz with proper calibration from factory partition
  • Both Ethernet ports (1 GbE LAN + 2.5 GbE WAN with EN8811H PHY)
  • RTC, GPIO watchdog, LEDs, buttons
  • NAND boot via UBI volumes (fip + fit + ubootenv + rootfs_data)
  • Pre-built FIP from official OpenWrt 24.10 release