佚格麻瓜1. PuppyPi机器狗网络工具箱深度解析
作为一名长期从事机器人开发的工程师，我最近在调试幻尔科技PuppyPi机器狗时，对其内置的hiwonder-toolbox网络工具箱进行了深入研究。这个看似简单的工具箱实际上包含了机器狗网络连接的核心功能模块，今天我就来详细拆解其中的配置文件和工作原理。
1.1 工具箱整体架构
hiwonder-toolbox主要由四个核心服务组成：
- WiFi管理服务(wifi.py)：负责树莓派的网络连接模式控制
- 远程配置服务(remote.py)：提供TCP接口接收手机APP的WiFi配置指令
- 设备发现服务(find_device.py)：实现局域网内的机器狗自动发现
- 物理按键服务(button_scan.py)：处理硬件按键的长按操作
这些服务通过systemd管理，开机自启，共同构成了机器狗的网络连接基础架构。理解这套系统对于后续的二次开发和故障排查都至关重要。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. WiFi管理服务深度剖析
2.1 双模式工作机制
wifi.py是整套系统的核心，它实现了树莓派WiFi的两种工作模式：
AP模式(WIFI_MODE=1)
- 树莓派自身作为热点发射WiFi信号
- 默认SSID格式为"HW-XXXXXXXX"(基于MAC地址生成)
- 默认密码为"hiwonder"
- 网关IP固定为192.168.149.1
- 适用于设备初次配置或无法连接外部网络的场景
STA模式(WIFI_MODE=2)
- 树莓派作为客户端连接外部路由器
- 需要配置目标WiFi的SSID和密码
- 适用于日常使用场景，可接入家庭或实验室网络
提示：AP模式下SSID必须以"HW-"开头，否则官方APP将无法识别设备，这是幻尔科技设定的设备识别规则。
2.2 状态指示灯解析
GPIO 26被用作网络状态指示灯，不同闪烁模式代表不同状态：
- 快闪(约2Hz)：AP模式正在初始化
- 极快闪(约5Hz)：正在尝试连接外部WiFi
- 常亮：STA模式连接成功
- 熄灭：网络功能未启用或出现异常
这种视觉反馈机制在实际调试中非常实用，通过观察LED状态就能快速判断网络连接阶段。
2.3 配置文件加载机制
wifi.py采用三级配置加载策略：
1.