QuartzWrt v0.2.0 — FNet3399 / H5000M / x86_64

QuartzWrt v0.2.0

构建标识：v0.2.0（设备侧 /etc/quartz-build-id，OTA 版本比较依据）
基座：ImmortalWrt 25.12 @ ce35a9e4
Feed 锁定：quartz @ 66f1cef；thirdparty @ 6f3604e
签名：apk key id 6947a869aad621cb2a8c0765c39ea104
镜像格式：只出 squashfs；std（标准版）与 docker（预装 docker 栈）双变体

发布目标

目标	设备	产物
x86_64 generic	通用软路由/虚拟机	*-squashfs-combined*.img.gz、*-rootfs.img.gz
rockchip/armv8	Erya FNet3399	*-erya_fnet-3399*squashfs-sysupgrade.img.gz
mediatek/filogic	Hiveton H5000M	*-hiveton_h5000m*sysupgrade.bin

每个目标均含 std 与 -docker 变体；-docker 版预装 dockerd/containerd/compose 与 dockerman 页面，并使用 nftables 后端配方。

本版重点

• 路由器 tab W6.9–W6.11 完成：系统、接口、无线、DHCP/DNS、防火墙、管理权、挂载、计划任务、LED、静态租约、静态路由。
• 蜂窝 / qmodem：蜂窝首页、信号/小区、拨号、SIM、短信、AT 调试、邻区、流量重置；qmodem 受控 Fork quartz2（lang 参数）。
• Dashboard：QModem/Tailscale/Docker/bandix 卡、IPv4/IPv6 打码与展开、Sparkline 平滑、系统卡增密。
• 网络能力：bandix 流量与限速、Tailscale 远程链路、IPv6 GUA、WPA3/OWE（wpad-openssl 完整版）。
• H5000M：基座原生支持、无厂商补丁；完整 Quartz + qmodem 5G 栈 + fancontrol 保守曲线；仅保留板载 WiFi 驱动。
• App：v0.7.1 单独发布（Dashboard 卡面、本机外观、路由器 tab、蜂窝 QModem）。

安装与升级

• x86_64：解压 *.img.gz 写盘；EFI 机器用 -efi 版；需要 docker 选带 -docker 的文件名。
• FNet3399：sysupgrade -T 预检后 sysupgrade -v 刷入；不要加 -n（保留配置）。
• H5000M：使用 *-sysupgrade.bin；同型号刷入前先确认设备匹配与备份。
• 软件源 / OTA：本 Release 附 quartz-feed-v0.2.0.tar.gz 快照，不直接更新线上源。设备如需 OTA，请先确认 sources.quartzwrt.org 可用。
• 所有产物校验见 sha256sums；签名一致性由构建期 verify-signing.sh 9/9 验证。

已知边界

• H5000M 尚未真机验收（5G 模组识别、风扇曲线、WiFi 7、LED、2.5G 口）。
• Docker 在 FNet3399 的 squashfs+overlay 上需 storage-driver: vfs；H5000M 的 docker 数据盘/驱动待真机验证。
• OTA 通道只发标准版；docker 版请手动刷写。

QuartzWrt v0.1.1 — FNet3399 无线/蓝牙（AP6236）

QuartzWrt v0.1.1 — FNet3399 无线/蓝牙（AP6236）

构建标识（build id）：v0.1.1　（设备侧 /etc/quartz-build-id；OTA 版本比较依据）
基座：ImmortalWrt 25.12 @ ce35a9e4ef1b
Feed 锁定：quartz @ 3dbeb3b30a2f；thirdparty @ 91c6536ce8d2
签名：apk key id 6947a869aad621cb2a8c0765c39ea104（本地与 CI 同一把稳定密钥，产物互认）
软件源：https://sources.quartzwrt.org/quartz-feed

版本范围（重要）

本版是设备固件更新：只重出 Erya FNet3399（rockchip/armv8）镜像，新增板载
AP6236（BCM43430B0）WiFi + 蓝牙支持。

• x86_64 产物与 v0.1.0 完全一致（无功能变化），仍可从
  v0.1.0 下载；
  其软件源与 OTA 条目保持 v0.1.0 不变（不会给 x86 设备推这次更新）。
• 本版 feed 快照（quartz-feed-v0.1.1.tar.gz）为全量发布树（x86_64 + aarch64_generic
  两架构包 + 两目标镜像目录 + 页面），即当前 sources.quartzwrt.org/quartz-feed 的镜像。

本版变更（FNet3399）

设备侧无线/蓝牙此前从未启用（厂商随附 DTS 只覆盖有线/存储/5G）。本版按四份公开的
SW799 / Fine3399 设备树（含 Lemon1151/iStoreOS-RK3399 的 fnet3399 专用移植）补齐：

• 无线：SDIO0（non-removable + mmc-pwrseq-simple，WL_REG_ON=gpio0 PB2、
  host-wake=gpio0 PA3）→ kmod-brcmfmac（SDIO 模式）
• 蓝牙：UART0（BT_REG_ON=gpio0 PB1、host-wake=PA4、device-wake=gpio2 PD2）→
  kmod-bluetooth + kmod-hci-uart + kmod-btbcm（内核侧；用户态 bluez 未预装，
  需要实际配对/使用时从上游 packages feed 自取）
• 固件：brcmfmac43430b0-sdio.{bin,txt} + 板级 NVRAM
  brcmfmac43430b0-sdio.erya,fnet-3399.txt + BCM43430B0.hcd（随设备侧包
  brcmfmac-firmware-fnet3399 投放，含 Broadcom 许可与 NOTICE）
• 用户态 WiFi：wpad-openssl + wifi-scripts + wireless-regdb
  （LuCI 无线页由既有 luci 栈提供）
• 目标包更新：feed 的 targets/rockchip/armv8/packages 由 131 增至 145 个 apk
  （新增 brcmfmac/蓝牙等 kmod 链）

使用注意

1. CLM blob 沿用厂商旧命名（brcmfmac43430-sdio.clm_blob）——当前内核查找名是
   …43430b0-sdio.clm_blob，故不加载（CLM 为可选件，缺失仅日志提示）。请勿改名：
   CLM 下载失败在 brcmfmac 中是致命错误。
2. 板级 NVRAM 内 MAC 固定（06:2D:EE:BC:F2:C7，本地管理地址）；多台同网需在
   /etc/config/wireless 用 option macaddr 覆盖。
3. 若首启无线未自动拉起，参考移植（iStoreOS fnet3399）的做法是延迟 60s 再 wifi up；
   手动 wifi up 能起即属上电/枚举时序问题，非驱动缺失。
4. 真机判据：dmesg | grep -iE "brcmfmac|Bluetooth|hci" 应见
   using brcmfmac43430b0-sdio.bin … 与蓝牙 patchram 加载行；LuCI 无线页出现 2.4G 射频。

产物

文件	用途
immortalwrt-rockchip-armv8-erya_fnet-3399-squashfs-sysupgrade.img.gz	FNet3399 固件（squashfs，刷机/OTA 用）
immortalwrt-rockchip-armv8-erya_fnet-3399-ext4-sysupgrade.img.gz	FNet3399 固件（ext4 变体）
immortalwrt-rockchip-armv8-erya_fnet-3399.manifest	包清单
sha256sums / *.buildinfo	校验和 / 构建信息（sha256sum -c sha256sums）
ota-rockchip-armv8.json(.sig)	OTA 版本清单（usign 签名；设备 quartz-ota-update 用）
quartz-feed-v0.1.1.tar.gz	全量 feed 快照（不含镜像；解压后根即 URL 根，供自建源/离线）

安装与升级

• 刷写：把 …squashfs-sysupgrade.img.gz 传到设备后
  sysupgrade -v <镜像>（或解压后写 SD/eMMC；分区布局与 v0.1.0 一致，boot 32 MiB + rootfs 1000 MiB）。
• 固件 OTA（设备）：quartz-ota-update --check → quartz-ota-update --apply
  （信任链：OTA 清单 usign 验签 → 镜像 sha256 → sysupgrade 预检）。
• 包升级（设备）：apk update && apk upgrade（源 = 上述"软件源"）。
• 签名/密钥与本地构建说明：见 Builder docs/SIGNING-OTA.md。

验证记录（构建侧）

• scripts/build-local.sh --device erya_fnet-3399（QUARTZ_BUILD_ID=v0.1.1）全绿：
  manifest 公共断言 + 11 项设备断言、签名一致性 9/9；
• 镜像级核验：rootfs 内 build id = v0.1.1、五件固件与许可 md5 与仓库源逐字节一致、
  FIT 内 DTB 含 wifi@1/sdio-pwrseq/UART0 蓝牙节点、kmod-brcmfmac/btbcm/hci_uart
  模块在列、自家 feed 三行均指 sources.quartzwrt.org；
• 发布树：ota/rockchip/armv8.json build_id = v0.1.1、镜像 sha256 与实际文件一致、
  usign 验签通过；x86 侧 OTA 清单未改动（仍为 v0.1.0）。
• 真机验收（2026-10-15，用户实测）：WiFi 可用 ✅ —— 本镜像刷入 FNet3399 真机后无线工作正常（SDIO 枚举 + 固件加载 + 射频可用）。蓝牙（UART0 + BCM43430B0.hcd）与 LuCI/App 链路仍待复核。

QuartzWrt v0.1.0

QuartzWrt v0.1.0

构建标识（build id）：v0.1.0　（设备侧 /etc/quartz-build-id；OTA 版本比较依据）
基座：ImmortalWrt 25.12 @ ce35a9e4ef1b
Feed 锁定：quartz @ 3dbeb3b30a2f；thirdparty @ 91c6536ce8d2
签名：apk key id 6947a869aad621cb2a8c0765c39ea104（本地与 CI 同一把稳定密钥，产物互认）
软件源：https://sources.quartzwrt.org/quartz-feed

产物

文件	用途
*-ext4-combined.img.gz	x86_64 完整磁盘镜像（BIOS/GRUB 引导）
*-ext4-combined-efi.img.gz	x86_64 完整磁盘镜像（UEFI 引导）
*-squashfs-combined*.img.gz	x86_64 squashfs 版（/rom 只读，恢复出厂更省事）
*.manifest / sha256sums	包清单 / 校验和（sha256sum -c sha256sums）
ota/x86/64.json(.sig)	OTA 版本清单（usign 签名；设备 quartz-ota-update 用）
quartz-feed-v0.1.0.tar.gz	本版 feed 快照（不含镜像；解压后根即 URL 根，供自建源/离线）

安装与升级

• 刷写：把 *.img.gz 解压后写盘（x86 软路由/虚拟机；EFI 机器用 -efi 版）。
• 包升级（设备）：apk update && apk upgrade（源 = 上述"软件源"；索引签名由固件预置公钥校验）。
• 固件 OTA（设备）：quartz-ota-update --check → quartz-ota-update --apply
  （信任链：OTA 清单 usign 验签 → 镜像 sha256 → sysupgrade 预检）。
• 签名/密钥与本地构建说明：见 Builder docs/SIGNING-OTA.md。