跳转至

RK3562 量产与金镜像

把调好的样机固化成可量产烧录的金镜像，并保证每台机器开箱后是独立身份。

硬件与系统

  • 主板：广州佩特科技 RK3562（PET_RK3562），ARM Debian
  • 存储：eMMC / TF 卡
  • 系统内跑 Klipper 全家桶（Klipper + Moonraker + 前端 + 触摸屏 UI）

金镜像五个步骤

步骤 要点
① bake 样机上写入 firstboot、PLACEHOLDER_HOST、/etc/kalios/site.env 模板
② 清理 封镜像前清 firstboot.done 与主机身份 —— 否则所有量产机同名
③ 导出 从 eMMC/TF 导出镜像到 Mac，必要时 shrink
④ 备份 替换本机镜像前必须备份旧 .img，并记录新旧文件名与体积
⑤ 验收 烧到验证板 → 上电上报 → 云端可见；主机名必须是 firstboot 生成的 kali-*

关键约束

  1. 主机名：量产机一律由 firstboot 生成 kali-*；样机旧名不能带进镜像。 否则后台会出现"幽灵身份"（详见 机队状态监控）。
  2. 镜像内不带凭据：FLEET_TOKEN、密码不得进仓库、文档与镜像明文日志。
  3. OTA 默认值按产品决定：样机常用于调试会设 FLEET_SKIP_OTA=1， 量产镜像要不要沿用必须显式决定。
  4. 不要带错 printer.cfg：样机配置 ≠ 出厂配置。

烧录工具链

  • macOS 下烧录：Rockchip 升级工具 / upgrade_tool 流程（技能 rockchip-macos-flash）
  • 镜像整理与压缩：rk3562-production-imaging
  • 烧录与部署合并流程：rk3562-production-flash / rk3562-production-deploy

常见坑

坑 表现 原因
MCU 刷写被拒 远程重刷直接失败 out/klipper.bin 编的 MCU 型号与板子不一致（如 H723 vs F407）
量产机同名 后台设备互相覆盖 封镜像前没清主机身份
开箱不上报 设备不出现 firstboot / site.env / agent 未就绪，或网络与上报地址配置缺失

相关