Files

72 lines
4.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 项目目标
本仓库用于配置家中的 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/`,不要把历史示例当作已经实测成功的结论。