# 项目目标 本仓库用于配置家中的 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/`,不要把历史示例当作已经实测成功的结论。