补光灯控制修复记录（2026-03-26）

现象

• 进入补光灯页面后，第一次可以控制亮度。
• 后续再次拖动亮度或重新操作时，页面看起来像是设置成功，但补光灯可能已经没有实际响应。

本次确认的原因

1. 串口连接可能进入“假连接”状态

补光灯控制走 /dev/ttyS5 @ 9600，原实现里 isConnected() 只根据是否记录了 currentPath 判断是否连接：

• 文件：app/src/main/java/com/cpt/aidishrecognition/hardware/PlateSensorSerialManager.java
• 原逻辑：只要 currentPath != null，就认为串口仍然可用

这会导致一种情况：

• 串口底层句柄已经异常或失效
• 但上层仍然继续复用旧连接
• 页面继续发送亮度命令，结果表现成“第一次能用，后面不稳定”

2. 发送失败时没有及时清掉坏连接

原先 dev_sendUart() 调用失败时，只是抛出异常，没有立刻把当前连接状态清掉。

这样会导致：

• 一次发送失败后
• 后续逻辑仍可能继续复用同一个坏掉的串口连接

3. 页面上的“开关补光灯”按钮未接业务逻辑

布局里有 btn_fill_light_toggle，但原来的 FillLightActivity 没有给它绑定点击事件。

结果是：

• 页面上看得到按钮
• 实际点击无效

本次修改内容

1. PlateSensorSerialManager.java

文件：

• app/src/main/java/com/cpt/aidishrecognition/hardware/PlateSensorSerialManager.java

修改点：

• 在 sendCommand() 中，给 dev_sendUart() 增加了 try/catch
• 如果 dev_sendUart() 抛出 RuntimeException，立即执行 disconnectLocked()
• 如果 dev_sendUart() 返回值不为 0，也立即执行 disconnectLocked()

目的：

• 一旦串口发送失败，立刻把当前连接标记为失效
• 避免后面继续复用坏连接

2. FillLightController.java

文件：

• app/src/main/java/com/cpt/aidishrecognition/hardware/FillLightController.java

修改点：

• 新增 reconnect() 方法，内部先 disconnect() 再 connect()
• setBrightness() 改成每次发送亮度前都主动 reconnect()
• 如果第一次发送失败，再断开并重试一次

目的：

• 不再依赖旧串口连接是否真的可用
• 每次亮度调整都使用一次新的串口连接，绕开“假连接”状态

3. FillLightActivity.java

文件：

• app/src/main/java/com/cpt/aidishrecognition/activity/FillLightActivity.java

修改点：

• 绑定了 btn_fill_light_toggle 的点击事件
• 新增 lastNonZeroBrightness，用于记住最近一次非 0 亮度
• 点击“关闭补光灯”时，亮度切到 0
• 再次点击“打开补光灯”时，恢复到上一次非 0 亮度
• “重新连接串口”按钮改成：
  • 先执行 reconnect()
  • 再把当前 pendingBrightness 重新发送一次

目的：

• 修复页面上开关按钮无效的问题
• 让“重新连接”不仅是连上串口，还能恢复当前亮度

本次验证结果

已执行编译验证：

• 命令：./gradlew :app:compileDebugJavaWithJavac
• 结果：BUILD SUCCESSFUL

后续如果再出现类似问题，优先这样排查

1. 先看现象

• 页面是否提示“已设置亮度”
• 实际补光灯是否真的变亮或变暗

如果页面显示成功、但灯没有变化，优先怀疑串口连接失效或硬件端未响应。

2. 优先检查这三个文件

• app/src/main/java/com/cpt/aidishrecognition/hardware/FillLightController.java
• app/src/main/java/com/cpt/aidishrecognition/hardware/PlateSensorSerialManager.java
• app/src/main/java/com/cpt/aidishrecognition/activity/FillLightActivity.java

3. 如果问题再次出现，建议继续加日志

建议记录以下信息：

• 每次发送的亮度命令，例如 LED080#
• dev_sendUart() 的返回值
• 是否发生 RuntimeException
• 发送前后的连接摘要，例如 /dev/ttyS5 @ 9600

这样可以快速区分：

• 是串口 SDK 连接失效
• 还是硬件端没有响应命令

结论

本次修复的核心思路不是改协议，而是增强串口控制的稳定性：

• 发送失败后立即清理坏连接
• 每次设置亮度前主动重连
• 补齐页面开关按钮逻辑

如果后续补光灯再次出现“第一次能控，后来失效”，优先参考本记录继续排查。