文章标题

dctc_青龙

刷完 OpenFang 摄像头，结果通电没反应、无限进恢复模式、或者跑到一半卡死——这类问题遇到过吗？说真的，排查思路就那么几条，关键是要知道往哪个方向使劲。

先把这三种典型表现记心里：**完全无输出**（串口啥也不打印）、**进 recovery 循环**、**内核阶段卡住**。对应的问题来源分别是硬件不兼容、固件选错了、系统配置损坏。心里有数了，下面的内容才看得进去。

---

## 硬件问题，十有八九栽在这两样上

### SPI Flash 太小，塞不下固件

这是最常见的坑。OpenFang 整套固件（内核+文件系统+Web界面）轻则 8MB，重则快 20MB。你设备上的 SPI Flash 要是不够大，bootloader 能写进去，但内核压根加载不了。

拿几个常见设备举例：

| 设备 Flash 规格 | 能不能跑 OpenFang | 怎么办 |
|---|---|---|
| 8Mbit（1MB） | 别想了，容量差太远 | 换 16MB 及以上的 Flash 芯片 |
| 128Mbit（16MB） | 标准版没问题 | 够用 |
| 256Mbit（32MB） | 所有版本都能装 | 推荐这个 |

实测数据说话：基于 Hi3516EV200 的摄像头，标准版 OpenFang 约 9.2MB，要是装完整版（含更多驱动）要到 14.8MB 左右。所以 16MB SPI Flash 是起步线，低于这个别怪固件跑不起来。

### DDR 兼容性问题，批次不同也能翻车

openfang 用 Buildroot 打包，内核和 DDR 驱动编译时绑死了特定时序参数。要是主板上 DDR 型号和固件里写的不一样，上电后 DDR 初始化直接挂，系统卡在 bootloader 那儿不动弹，串口要么乱码要么啥也没有。

一个容易中招的场景：同一款摄像头，不同批次混用了 DDR 芯片（比如 EM8GD12G8 和 EM8GD16G8 混），时序参数本来就不一样，时钟相位差一档就够你折腾的。

怎么判断？看串口 log 里有没有 `ddr init failed` 或者乱码首行——有的话基本就是这个问题。

openfang 官方也说了，遇到问题提 issue 的时候把串口输出附上，开发者会根据 Buildroot 版本、内核版本、启用模块、设备型号来定位。报 bug 是个技术活，信息给到位才能快准狠。

---

## 固件选错平台？这一步错了后面全白搭

### 芯片型号必须对号入座

openfang 主要面向 Ingenic T10 和 T20 这两个 SOC 平台，固件按芯片型号严格分开。刷错固件的经典操作：把 T20L 的固件刷到 T20X 主板上。外观差不多，但 DDR 容量完全不一样，内核启动参数对不上，直接 panic 给你看。

同一条产品线的摄像头，有时候还有多个硬件版本。以 Xiaomi Dafang 为例，有好几个 Revision 版本，外壳一样但主板不同——某些批次甚至换了 WiFi 模块或者 DDR 芯片。openfang 官方有份设备对照表，把芯片平台和具体型号对应好了，刷机之前对照着检查一遍，别偷懒。

| Ingenic SOC | 对应设备 | DDR 规格 | Flash 推荐 |
|---|---|---|---|
| T10 | 早期小米小方（ARM版） | 64Mb | 8MB+ |
| T20L | 小米小方1S / 米家2018款 | 64Mb | 16MB+ |
| T20N | DIGOO DG-W30 等 | 64Mb+SIMD | 16MB+ |
| T20X | Wyze Cam V2 / 小米大方 / 米家云台 | 128Mb | 16MB+ |

另外 Ingenic T20 平台有三个 DDR 规格的变体，这个也容易搞混：

- **T20L（64Mb DDR）**：小米米家 2018 款、小米小方 1S 这类，内存偏小，建议刷轻量版
- **T20N（64Mb DDR + SIMD128）**：DIGOO DG-W30 等设备用，固件得包含对应 SIMD 指令集支持
- **T20X（128Mb DDR）**：Wyze Cam V2、小米大方、米家智能摄像机云台版等等，内存充足，可以刷完整版 openfang

刷机前确认一下主板上 DDR 芯片的具体型号，拆机看看或者从串口输出里读取 DDR ID 都行。

### 跨版本升级，这条路基本走不通

openfang 从 v0.1.x 升级到 v0.2.x 的时候，文件系统布局动了刀子：早期用 JFFS2，后来换成了 SquashFS + overlay 组合。这意味着从旧版本 OTA 升级到新版本，rootfs 校验会因为文件系统格式对不上而失败，内核 panic。

所以官方建议：**不要在已有系统上增量升级**。正确姿势是从 U-boot 层面完整刷入目标版本。如果你的设备已经跑着旧版 openfang，用 TTL 串口连上，在 U-boot 交互界面把 Flash 完整擦除，再刷新版本固件。

很多人偷懒直接用 Web UI 的在线升级功能，跨大版本失败基本都这么来的。

遇到问题可以加 Gitter 找社区，附上串口日志，开发者会帮你看是不是 buildroot 版本和当前硬件不匹配。

---

## 配置问题，这两个细节最容易被忽略

### MAC 地址丢了或者冲突了

有些摄像头主板把 MAC 地址存在 Flash 特定扇区，刷 openfang 的时候要是没正确读出原 MAC（通过 Web UI 强刷经常这样），刷完系统会用随机 MAC 启动，DHCP 获取 IP 直接失败。

从串口 log 能看出来：设备拿到 169.254.x.x 段的地址，这就是链路本地地址，说明压根没收到 DHCP 响应。

手动设一下就行：

```
fw_setenv ethaddr "aa:bb:cc:dd:ee:ff"
```

MAC 丢了还有个麻烦：部分路由器会把它当成新设备，触发 MAC 过滤规则。白名单模式也不保险，路由器对陌生 MAC 有缓存，可能短暂连不上。

### 串口波特率设错了

openfang 默认 115200-8-N-1，但有些摄像头原装固件用 9600 或者 57600。波特率不对，串口输出全是乱码，很容易误判成硬件问题。

还有个细节：进 U-boot 要快速按任意键，T20 平台窗口大概 3 秒，早了晚了都中断不了启动流程。

一个小技巧判断波特率对不对：乱码有规律地重复（每隔相同字符数出现一次），通常是波特率差一档；要是完全随机噪声，更可能是 DDR 初始化失败引起的内存访问异常。

---

## 快速排查决策树

```
摄像头通电 → 串口有输出？
├── 啥也没有 → 量一下 3.3V 供电正不正常 → 查 DDR 初始化 log
├── 输出乱码 → 调一下波特率再试（115200/9600/57600一个个来）
├── 卡在 U-boot → 检查 Flash 容量 / 固件校验 / MAC 设置
└── 内核起来后挂掉 → 检查 MAC / 网络配置 / overlay 分区 / wifi 模块
```

---

## 总结

说白了，OpenFang 启动失败的根本矛盾就是：**硬件规格达标了，但固件适配不够精细**。Flash 容量差一档、DDR 时序差一档、芯片版本差一代——结果都一样，系统加载不起来。

排查顺序记住：**先硬件，再固件，最后配置**。串口 log 是最重要的诊断依据，大部分启动问题都能在那里面找到直接答案。

你刷 OpenFang 遇到过什么奇葩问题？评论区说说，说不定能帮到其他人。