Files

4.8 KiB
Raw Permalink Blame History

项目目标

本仓库用于配置家中的 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 客户端,地址需按实际网络确认

宿主机连接与只读检查示例:

adb connect 192.168.3.3:5555
adb devices
adb -s 192.168.3.3:5555 shell

进入设备 shell 后检查:

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/,不要把历史示例当作已经实测成功的结论。