Преглед изворни кода

docs: 记录 RK3562 经 USB-adb 部署节拍/映射/前端修复版

wenhongquan пре 2 недеља
родитељ
комит
61c4f7f551
1 измењених фајлова са 12 додато и 0 уклоњено
  1. 12 0
      AGENTS.md

+ 12 - 0
AGENTS.md

@@ -34,6 +34,18 @@
   - 串口:`serial_config.json` 指向 `/dev/ttyS8 @9600`(本板 RS485,实测在发 0x80 地址查询轮询);串口屏端口见下方「串口屏(Nextion)接线与刷新」。
   - MQTT:`mqtt_config.json` 仍是占位(`localhost:1883`),需在网页里配 `xt.wenhq.top:8581` 之类并连接,连上后才会持久化自动重连。
 
+### 第二块板(RK3562)经 USB-adb 的部署记录(2026-10-31)
+
+- **接入**:Mac 上 `adb devices` 见 USB 设备(adb 自报名 `mako/Nexus_4`,实际是 RK3562 Ubuntu 板),`adb shell` 直接 root(uid=0);`hostname=ido`、内核 5.10.226 aarch64、Ubuntu 20.04。当次 **eth0 IP=`192.168.1.125`**(docker0=172.17.0.1,与 wlan `192.168.10.190` 不是同一会话/网段,按 `hostname -I` 为准)。
+- 判定是同一块 RK3562 板的依据:都有 `adbd`、Nextion 在 `ttyS9`、DHT11 正常、`serial_config.json` 曾指 `/dev/ttyUSB0`、目录/服务布局一致。
+- **2026-10-31 13:59 经 adb 部署节拍+映射+前端修复版**(提交 `bd7321e`+`1df50f7`+`09e72d8`):
+  - 后端三文件:`backend/app.py`、`config.py`、`modules/serial_port.py`;前端 dist 同时覆盖 `/root/dzxj_dtu/frontend/dist` 和 `/var/www/html`,entry `index-f0289edd.js`(含 `PortMapping-f2b7d011.js`)。
+  - 备份:`app.py/config.py/serial_port.py` 均存 `*.bak_20261031_135813`;前端两目录存 `*.bak_20261031_135904`。
+  - ⚠️ **app.py 必须用 git HEAD 干净版**:本地工作区 app.py 含 Windows 打包的 `from paths import`(设备无 `paths.py` 会起不来)。部署用 `git show HEAD:backend/app.py` 导出;设备 venv `python -m py_compile` 通过、`grep from paths import`=0 后才重启。
+  - 部署手法:`adb push` 到 `/tmp` → `adb shell cp` 覆盖(chown root:root、chmod 644)→ `systemctl restart dzxj_dtu`。
+  - 验证:服务 active;MQTT 自动连上 `xt.wenhq.top:8581`;DHT11 29°C/27%、Nextion ttyS9 正常;`/api/panel/mappings` 200;启动自动清理 **44 条历史 null 端口映射**;nginx 80 与 5001 均 200,新 chunk 可访问。
+  - 部署时 `/dev/ttyUSB0` 不存在(未插 USB-RS485),串口显示未连接,属硬件未接,非软件问题;需要时插 USB-RS485 或在网页把串口改回板载 `/dev/ttyS8`(注意 ttyS8 历史上「能发不能收」)。
+
 ## 第三块板:RK 板(当前 192.168.199.174,严格 80/81 现网验证板)
 
 - **登录**:`ssh root@192.168.199.174`,密码 `123456`,`hostname=ido`。