原始 4.1 clean-dist 镜像中的一个错误有时会导致板载串口扩展板为空白。当后续固件尝试启动串口子系统时，它无法确定连接的板是 RS-232 还是 RS-485，因此会禁用所有串口。该缺陷已在 4.2 u2 (4.2.36.38) 中修复，但任何曾恢复到旧版 4.1 镜像的控制器仍可能将空白板带入新版本中。
适用于：
硬件 可能出现问题的 Niagara 版本
JACE-8000、JACE-8000-Wi-Fi，任何配备 Tridium RS-232 或 RS-485 串口扩展模块的设备 4.1 clean-dist 镜像
4.2.36.34（在 4.2.36.38 中修复）
4.3 – 4.13，如果控制器曾恢复出厂设置到 4.1 版本
使用 4.14 u2 及更高版本启动时，问题会自动修复。
症状：
升级或 clean-dist 后，在“平台服务”→“串口服务”下没有 COM 端口出现
系统 shell 日志显示：
错误：扩展模块信息文件 /etc/usb/<serial#> 为空，无法重新编程或启动串口
ls /etc/usb 返回空列表或扩展板序列号的零字节文件
解决方案：
如果工作站当前运行 采取的行动
4.14 u2 或更高版本 无需操作。操作系统会在首次启动时自动检测空白板并重新编程，然后再次重启。
4.2.36.38 – 4.13 对每个受影响的 JACE-8000 按照下面的手动修复步骤操作一次。
计划升级 跳过 4.1 clean-dist 镜像。直接升级到最新的 4.9 u1（或更高版本）镜像，以避免再次触发该缺陷。
手动修复（4.14 u2 之前的任何版本）：
先决条件
配备 PuTTY 或类似串口终端的电脑
USB-A 转 micro-USB 控制台线缆
波特率 115200, 8-N-1
打开串口 shell
在 PuTTY 中选择“连接类型”→“串口”，设置 COM 端口和速度 115200，然后点击“打开”。
登录并输入 sh$ 以进入提示符。
通过输入以下命令找到空白扩展板：
$ ls /etc/usb
这应该返回：$ ls /etc/usb 85091090FPGGS41 [这是一个示例序列号]
如果没有返回任何内容，输入 sloginfo 并滚动直到看到错误行；最后一个字段是缺失的序列号。示例输出：
$ sloginfo
10 月 10 日 13:42:06 1 6 0 serusb_is_device_supported: 总线 0 上的设备 2 未识别。使用 CDC-ACM 类
10 月 10 日 13:42:07 4 11111 0 打开 /etc/usb/85091090FPGGS41 错误 rc=-1
列出可用的固件二进制文件；输入：
$ ls -Rp /sys/images/usb
典型路径：
RS-232 → /sys/images/usb/vid03eb/pid2404/Tridium232-1_rxx.bin
RS-485 → /sys/images/usb/vid03eb/pid2425/Tridium485-2_rxx.bin
将正确的固件路径写入空文件
示例：对于 RS-485 – 将 <serial#> 替换为您的值
$ echo "/sys/images/usb/vid03eb/pid2425/Tridium485-2_rxx.bin" > /etc/usb/<serial#>
对步骤 2 中返回的每个序列号运行一次此命令。
重启
$ shutdown # 或直接断电重启
确认恢复
设备重启两次后，您应该会看到：
扩展板已重新编程 – 正在重启...
重启后，检查串口服务以确认端口已恢复。
验证清单：
检查 预期结果
/etc/usb/<serial#> 包含一行正确的路径。
启动日志 显示“正在重新编程 usb 设备…”后跟“完成”
串口服务 COM1 / COM2（或 232/485）条目存在
补充说明：
使用 4.2.36.38 重新调试无法修复扩展板已为空白的 JACE；您必须执行上述手动步骤。
/sys/images/usb 中的文件名在不同版本之间会有所变化。请务必复制 shell 错误消息中建议的准确路径，而不是从旧文档中粘贴。
修复后，此更改是永久性的；未来的升级将保留已编程的板卡。