记录 DNAKE 重启恢复流程并修正 SIP 消息长度
This commit is contained in:
1 parent
dd0780f17e
commit
2646ccf09b
3 files changed
+129
-6
No files matched your search
@@ -0,0 +1,71 @@
|
||||
# 项目目标
|
||||
|
||||
本仓库用于配置家中的 DNAKE(狄耐克)设备网络,通过 ADB 在设备上配置 `ip route`、IP 转发及必要的 NAT 规则,打通家庭局域网到电梯控制设备的通信。最终通过 Python 和微程序提供手动、快速的呼梯/开梯入口。
|
||||
|
||||
“打开电梯”的具体行为以现有设备协议和实测结果为准;不要将发送成功直接等同于电梯已经执行。微程序的具体平台尚未确定,不默认指定为微信小程序。
|
||||
|
||||
# 设备与网络
|
||||
|
||||
- 用户已确认可通过 `adb connect 192.168.3.3:5555` 和 `adb shell` 连接 DNAKE 设备。
|
||||
- 路由配置在 DNAKE 的 ADB shell 内执行,区分宿主机命令和设备端命令。
|
||||
- 以下拓扑来自仓库现有记录,操作前读取实际配置确认:
|
||||
|
||||
| 角色 | 地址/接口 | 用途 |
|
||||
| --- | --- | --- |
|
||||
| DNAKE 家庭网接口 | `192.168.3.3/24`,`eth1` | ADB 连接、现有 UDP 转发入口 |
|
||||
| DNAKE 设备网接口 | `192.168.9.57/24`,`eth0` | 通向电梯设备所在网络 |
|
||||
| 电梯控制目标 | `192.168.9.4:5060` | 现有 SIP MESSAGE 的目标 |
|
||||
| 开发 Mac | 历史地址 `192.168.3.33` | Python 客户端,地址需按实际网络确认 |
|
||||
|
||||
宿主机连接与只读检查示例:
|
||||
|
||||
```sh
|
||||
adb connect 192.168.3.3:5555
|
||||
adb devices
|
||||
adb -s 192.168.3.3:5555 shell
|
||||
```
|
||||
|
||||
进入设备 shell 后检查:
|
||||
|
||||
```sh
|
||||
id
|
||||
ip addr
|
||||
ip route
|
||||
ip rule
|
||||
cat /proc/sys/net/ipv4/ip_forward
|
||||
iptables -t nat -L -n -v
|
||||
iptables -L FORWARD -n -v
|
||||
```
|
||||
|
||||
同时连接多台 ADB 设备时,始终使用 `-s 192.168.3.3:5555` 指定设备。连接成功不代表具备修改路由、防火墙的权限;先检查实际权限。
|
||||
|
||||
# 仓库结构与现状
|
||||
|
||||
- `apps/socket/main.py`:Python UDP/SIP MESSAGE 发送脚本,直接运行会发送真实呼梯请求。
|
||||
- `apps/socket/app.py`:FastAPI 服务,端口 `3001`;现有 `/api/router?path=floor` 会调用发送脚本,`path=test` 是占位接口。
|
||||
- `server/`:Bun/TypeScript 服务,开发命令为 `bun run dev`;当前 `src/lib.ts` 的 `sendSipMessage` 只生成并打印消息,没有实际发送 UDP,不视为已完成呼梯功能。
|
||||
- `docs/`:Astro 文档站,使用 pnpm;开发命令 `pnpm dev`,构建命令 `pnpm build`,均在该目录执行。
|
||||
- `docs/src/pages/ip-step.md`、`ip-step-back.md`:已有网络配置记录。
|
||||
- `docs/src/pages/adb.mdx`、`python.mdx`:ADB 和 Python 示例。
|
||||
- 当前未发现微程序实现或 Python 项目依赖清单;`apps/socket/README.md` 中的 `uv sync` 需在补齐项目配置后再使用。
|
||||
|
||||
# 开发约定
|
||||
|
||||
- 默认使用中文沟通、注释和维护文档。围绕网络连通、Python 呼梯、微程序手动入口逐步完善,避免无关重构。
|
||||
- 设备 IP、端口、网卡、SIP 用户及楼层等参数应可配置,不把历史值当作所有环境的固定值。
|
||||
- 当前消息示例包含 `elev=1`、`direct=2`、`floor=13`、`family=2`、`event=appoint`;这些是已有值,业务含义和设备支持范围需要验证,不凭空推断。
|
||||
- 区分直接路由与向 `192.168.3.3:5060` 发送后 DNAT 的方案;`ip route`、IP 转发和 NAT 各有用途,不能互相替代。
|
||||
- 修改网络配置前记录现有路由、规则和转发状态;采用范围明确、可重复执行的增量配置,并提供对应回滚步骤。不要直接照搬旧文档中清空整张 iptables 表、修改全局默认策略或关闭 SELinux 的操作。
|
||||
- 记录配置是临时生效还是重启后保留,持久化方式需根据设备环境确认。
|
||||
- SIP 头使用 CRLF;`Content-Length` 按最终实际发送的消息体 UTF-8 字节数计算,避免换行转换后长度失配。
|
||||
- 手动入口应防止连续误触;超时或无响应不能直接认定执行失败,也不要自动重复发送可能已执行的呼梯指令。
|
||||
- 不将仅打印消息、UDP 发送成功或 HTTP 成功响应表述为实际呼梯成功;分别报告发送结果、协议响应与设备执行确认。
|
||||
|
||||
# 验证与交付
|
||||
|
||||
- 用户确认实际执行结果由人工观察电梯判断;程序仅报告发送及协议响应,不要求程序自动判断电梯是否动作。重启后的恢复步骤见 `docs/src/pages/ip-step.md`。
|
||||
|
||||
- 文档修改检查命令、路径及与代码的一致性;只有涉及文档站功能或构建时才运行对应构建。
|
||||
- Python/服务修改优先离线检查消息编码、配置处理、错误返回及接口行为;使用模拟 UDP 接收端验证发送,避免测试时误触真实设备。
|
||||
- 真实设备联调以用户当前指令范围为准:初始化文档不包含修改设备网络或发送呼梯请求;用户明确要求配置或呼梯联调后,继续完成相应操作。
|
||||
- 交付说明写明修改内容、验证方式和未验证部分。需要更新的操作说明同步到 `docs/`,不要把历史示例当作已经实测成功的结论。
|
||||
Reference in new issue
Block a user