网页 U-Boot 指南

打开了「重建 UBI」却没选齐 BL2 和 U-Boot，页面不让发——重建会抹掉 fip 卷，还会盖住原厂引导器的后半截，少了哪个机器都起不来。闪存里根本没有 UBI 时，日常刷机与创建 UBI 卷也一并拦下；只是缺 U-Boot 时，页面顶部亮红条提醒你重启之前先补上。这几条设备自己同样会查：不管从哪里发的上传，写之前先被拒，不再只靠页面。

BL2 比 bl2 分区放得下的多、U-Boot 比 fip 卷放得下的多，页面直接不让发。两条写入都是先擦后写，装不下的话不是「没写」，是擦完了才失败，留下半截引导器。出厂数据那两个卷一直有这道门，这两个到 0.3.0 才补上。

重建留下的是一片空 UBI，ri 与 bosa 两个卷压根还不存在，而「把备份写回去」恰恰要在重启之前做完。以前这一步会失败，得先重启一次让设备自己把卷建出来。现在和别的卷一样：不在就按备份文件的长度建出来。

0.3.0 之前从旧版本升上来，菜单里那一项会更新，但引导失败的自动回退和复位键仍然去等 TFTP —— 而这两条恰好是没有串口的人唯一能用的入口。现在它们跟着版本号一起刷新，升级完就生效，不必手动「恢复默认环境」。

左栏单独的一页：传一个 …-initramfs-recovery.itb，设备把它载入内存直接引导，闪存一个字节都不写。起不来就断电，系统还是原来那个 —— 刷固件这件事第一次变成可撤销的。要的是恢复固件，不是 sysupgrade 固件：恢复固件的根文件系统随镜像一起进内存，闪存里 UBI 空着也照样跑得起来；sysupgrade 的根要由 fitblk 从闪存的 fit 卷读，不写闪存就等于没换，内核是新的、根还是旧的。左栏顺带理了一遍名字：「写入 UBI 卷」改叫「按卷写入」、「诊断」改叫「系统诊断」，两页的内容都没动。

试跑的固件起不来时，设备原地回到恢复页继续等着，页面自动刷新 —— 不再看你是怎么进来的。以前只有「引导失败就重开网页」那条路进来的机器会回来；按 reset 进来的会接着往下走去引导 NAND 里的旧系统，页面就没了，而那正是没有串口的人唯一的入口。闪存一个字节都没写，所以断电重来同样回到原系统，两条路都在。

「刷回原厂」里这个开关擦的是镜像之后一直到闪存末尾的全部擦除块，不是它所在那个分区的末尾。整片写回时这是对的，只写一段时就是灾难：按「备份下载 → 原始区段」导出一段、再按同一个偏移写回来，默认勾着就会把它后面的 UBI 连同 ri、bosa 一起擦空。现在它只在偏移为 0 时默认打开，偏移改成非 0 就自动松开；你自己动过这个开关之后，页面不再替你改。

原来的「健康检查」和「串口日志」合成一页，分三段（左栏那一格 0.3.0 从「诊断」改叫「系统诊断」）。「快速检查」打开就跑，BL2、坏块、UBI 各卷、出厂 MAC 一项一盏灯，几秒出结果。「全片扫描」逐页读一遍整片：BBT 里的坏块是出厂就标好的，而每次读都要 ECC 悄悄纠正的那些页，才是这片 NAND 快不行了的信号 —— 只有整片读一遍才看得出来。「串口日志」不接串口也能看 U-Boot 从上电到现在打了什么，还能实时跟随。「下载诊断包」把四样连同设备详情打成一个文件，求助时直接发这个。

以前的顺序是「回一句上传完成 → 关连接 → 设备自己写 → 自己重启」，页面只说得出「传完了」，写得对不对、写没写完，都只有串口看得见。现在写入在连接里完成：设备一边写一边报到哪一步，写完把内容读回来算一遍 crc32跟上传的比，再弹出「写入完毕」列出每个文件的长度与校验和，由你点「立即重启」或者「留在恢复页」。校验没过就不弹框，顶上挂红条说清闪存里的东西不可信。连带的三件事：「按卷写入」的「写入后不重启」开关撤了（每次都问，开关就多余了）；灯语只剩流水一种（齐闪的意思是「连接已关」，而连接不再关了）；「闪存里没有 U-Boot」不再是硬拦——写完不会自动重启，先补上另一半再走就是了。

「设备详情 → UBI 卷」上方多了一条占用条：一段一个卷，宽度是它预留的容量，末尾是空闲、以及 UBI 留给自己的那点（卷表加坏块替换预留）。fit 与 rootfs_data 打了斜纹 —— 写固件时这两个卷先删掉再重建，所以对「还刷不刷得下」来说它们的容量是可用的，不是占用的；「系统诊断」里「可写空间」那一行报的就是这个加法，不然一台好好跑着的机器永远显示空闲 0 MiB。卷在闪存里并不连续，条上按卷号排，不表示物理位置。

「设备详情」的网络那段直接读 PHY 寄存器，报出各口有没有插上、协商到多少速率 —— U-Boot 的网络层里没有 link 这个概念，这几行是绕过去拿到的。还会说明设备有没有发出过 DHCP 地址、最近发给了谁，据此分得清你现在用的地址是设备给的还是自己配的。这一段在前台时每 3 秒自己刷新一次，网线换个口不用重开页面，插上几秒之后那一行就跟着变。

网络那段的「模式」下拉框把设备怎么上网这件事一次说完，三种互斥：DHCP 服务器（默认，本机发地址，电脑直连插上就有 IP）、静态地址（本机用一个固定地址，不再发地址）、DHCP 客户端（向上级路由要一个）。原来是「静态还是自动获取」再加一个单独的 DHCP 服务开关，两个开关能拼出「一边向路由器要地址、一边自己也在发地址」这种自相矛盾的组合；合成一个之后它根本选不出来。

选静态地址，填一个你家网段里的空闲地址，勾上「保存到闪存」，再把网线插到路由器上，就能从网内任何一台机器打开这个页面。也可以选 DHCP 客户端让上级路由分配 —— 但那样地址是多少这个页面事先不知道，得去路由器的客户端列表里按 MAC 找，所以多数时候填静态地址更省事。这两种模式下设备都不再发地址，不会和你家路由器抢。

这一档里子网掩码固定 255.255.255.0，填的地址末位也会被改成 .1：设备发出去的地址一直是本网段的 .100、网关指向自己，别的掩码描述的是一个租约并不属于的网络。填的时候输入框旁边就把「设备 x.x.x.1 · 电脑 x.x.x.100」两个结果摆出来，不用等按下按钮。接到已有网络上之前请换成另外两档，否则它会和那个网络的路由器抢着发地址，抢到的机器直接断网。

三种模式都带一个「保存到闪存」。不勾的话，改动只在内存里生效，下次开机回到闪存里存着的那一套；从没保存过就是出厂默认的 DHCP 服务器 192.168.1.1/24。页面上「应用」按钮下面那行一直写着下次开机会是什么，不用自己推。地址填错时拔电源就是退路，所以这条是从结构上保证的：不保存的改动碰的是运行时的地址，碰不到闪存里那三个变量，别处的保存动作也捎带不上它。

把 ri（出厂 MAC、序列号）、bosa（光模块校准）或者整片闪存下载到电脑。这两个卷逐机唯一，重建 UBI 就永远拿不回来了，而在此之前它们只能在原厂系统里 dd 出来 —— 现在系统进不去也能抢救。整片多大都是一个文件，传完页面给出 crc32 让你核对。

镜像不再先整个读进设备内存，而是边收边写 —— 以前设备一次最多收约 249 MiB，而 256 MiB 的整片备份正好差这一点，只能让你自己把文件切开分几次写。现在整片直接传就行。代价是一旦开始写就必须传完：中途失败别重启，页面还在设备内存里，重传一次即可。

整片备份里坏块照样占着位子，文件偏移就是 flash 偏移 —— 和 dd if=/dev/mtd0 一个格式。所以别人给的 all_flash.bin 能直接写进来，这里备份的也能拿去烧录器；有坏块的机器上，写回去不会从坏块起整体错位。

写完那一页不再是「上传完成」——拿到回应的时候镜像早就整份落盘了。现在单独一页，把设备回的写入长度、crc32 与跳过的坏块数摆出来。那个 crc32 和「备份下载」记的是同一个数，对得上就说明从读出到写回一个字节都没错。

写到一半失败或者断线，页面顶上挂一条红条说明闪存已经不一致、重启会起不来，切页不消失，重写成功才清掉。设备回的原话也完整贴出来，不再被省略号截断。没开始写就被拒绝的（偏移没对齐这类）说的是另一句，不吓人。

页面每隔几秒问设备一声。断了就盖一层说明，而且分清是哪种断：设备正在写入（别断电）、刚点了重启、还是真的失联（给「重新连接」）。路由器重启过页面会自己刷新，不会拿着重启前的旧内容让你误判。

只读列出 U-Boot 的全部环境变量 —— 起不来的机器常常是 bootcmd 或引导菜单被改坏了，以前没串口就查不出来。「引导菜单预览」把开机时那个菜单按 bootmenu_* 摆出来，会写闪存的条目标红；序号列给的是串口上按的键（bootmenu_0 在屏幕上是 1.、第 10 项是 a.），照着念就能对上眼前的菜单。配套一个「恢复默认」，出厂 MAC、固件与用户配置都不受影响。

「启动与重启」页：立刻重启等同断电再上电；「直接启动系统」执行 bootcmd，省一次冷启动，起不来会自己回到本页面；「下次开机进恢复页」相当于开机时按住 reset，只生效一次，进来之后自动恢复原样 —— 而且是在原来的 bootcmd 前面插一段，万一没恢复成，设备照样会启动系统，不会被撂在半路。

上传时报速率和剩余时间，多个文件会说正在传哪一个。写入阶段没有进度：设备是单线程的，擦写期间它什么都答不了，所以给的是一个预计秒数而不是假装在走的条；回读校验那一段是设备自己的循环，报得出真百分比。备份下载没有字节进度——U-Boot 的网络栈同时只有一条连接，而下载那条从头开到尾，页面在这期间问不到设备。进度条只说「在读在传」，字节数请看浏览器自己的下载栏，传完页面给 crc32。这条以前写着「那条进度是真的」，是错的。

按桌面浏览器设计的侧边栏布局，一页一个任务，不再有「这两样不能同时传」的报错。深浅色照旧。

MD 与 MF 共用同一份页面，机型、闪存、分区、UBI 卷表都从设备上实时读，在「设备详情」页核对。

出厂卷长度不对、偏移没对齐或超出容量、卷名非法——设备直接拒收并说明原因，此时什么都还没写。

默认 0x0 整片；填某个原厂分区的起始就只写那一段。

出厂数据 ri / bosa 与任意卷合到一页；任意卷不存在时按文件长度新建；「写入后不重启」可以连着恢复多个卷。

显示正在传哪个文件、传了多少；传完明确告诉你页面已无作用可以关闭。