- client 模式抓取水星 MW305R DHCP 列表,记录上下线,本地看板 - server 模式收上报,按站点分组持久化,多站点看板,7天滚动 - ESP8266 低功耗固件抓原始 HTML 上报 /api/raw,服务器端解析 - 部署脚本+systemd 单元+文档,交叉编译 Linux 二进制
106 lines
4.4 KiB
Markdown
106 lines
4.4 KiB
Markdown
# ESP8266 低功耗 DHCP 采集固件
|
|
|
|
极简固件:**登录水星 MW305R 路由器 → 抓取 DHCP 客户端页面的原始 HTML → POST 给
|
|
`dhcp-mon server` 的 `/api/raw` → 深度睡眠 15 分钟**。解析与上下线判定全部在
|
|
服务器端,固件不移植任何 Go 逻辑。
|
|
|
|
## 原理
|
|
|
|
```
|
|
ESP8266 (每 SLEEP_SECONDS 秒深睡唤醒)
|
|
├─ WiFi 连接(仅 2.4GHz)
|
|
├─ HTTP 登录路由器: Cookie = Authorization=Basic base64("admin:"+密码) ← 无引号!
|
|
│ 带浏览器 User-Agent + Referer(缺一 403)
|
|
├─ GET /userRpm/AssignedIpAddrListRpm.htm → 拿到原始 HTML(GBK 也可)
|
|
└─ POST http://服务器:8080/api/raw (Header X-Token + X-Site, body=原始HTML)
|
|
服务器: 解析 DHCPDynList → 判定上线/下线 → 事件 → 持久化
|
|
```
|
|
|
|
## 文件
|
|
|
|
| 文件 | 说明 |
|
|
|---|---|
|
|
| `platformio.ini` | PlatformIO 工程配置(NodeMCU v2 / espressif8266) |
|
|
| `src/main.cpp` | 源码: WiFi → 登录抓页 → 上报 → 深睡 |
|
|
| `src/secrets.h` | **用户配置**: WiFi / 服务器 / 令牌 / 站点 / 路由器密码 / 间隔 |
|
|
| `src/secrets.h.example` | 提交到 git 的配置模板(不含真实凭据),复制为 secrets.h 填写 |
|
|
|
|
## 配置
|
|
|
|
首次使用: `cp src/secrets.h.example src/secrets.h`,然后把 `src/secrets.h` 里的占位符换成你的真实值:
|
|
|
|
```cpp
|
|
WIFI_SSID / WIFI_PASS // ESP8266 只能连 2.4GHz
|
|
SERVER_URL // 例 http://192.168.1.200:8080/api/raw
|
|
X_TOKEN // 与 server 的 -stoken 一致
|
|
X_SITE // 站点名,如 home
|
|
ROUTER_HOST // 默认 192.168.1.1
|
|
ROUTER_PASS // 路由器管理员密码(用户名固定 admin)
|
|
SLEEP_SECONDS // 采集间隔,默认 900(15分钟)
|
|
```
|
|
|
|
## 接线
|
|
|
|
NodeMCU/ESP8266 板基本免接线即可刷写与运行:
|
|
|
|
- **供电**:USB 供电即可;独立使用时接 3.3V-G 对 (VIN-GND)。
|
|
- **板载 LED**:每次唤醒点亮 150ms 提示工作正常。
|
|
- **深睡唤醒跳线(可选,才真正做到定时深睡)**:把 `GPIO16(D0)` 短接到 `RST`,
|
|
ESP8266 才能自动唤醒。**不接这条线时**模组会持续运行到底(loop 里兜底深睡立即
|
|
恢复),此时每次间隔靠 RST 复位触发,低功耗效果打折。
|
|
- 深睡期间电流约 20µA,一天耗电可 <0.1Wh。
|
|
|
|
## 刷写(PlatformIO)
|
|
|
|
本项目没把 `pio` 放进 PATH,用完整路径:
|
|
|
|
```bash
|
|
# 1. 编译
|
|
~/.platformio/penv/bin/pio run -d firmware/esp8266
|
|
|
|
# 2. 查看串口(macOS)
|
|
ls /dev/cu.usbserial-*
|
|
|
|
# 3. 上传到模组(自动找串口;指定端口可加 --upload-port)
|
|
~/.platformio/penv/bin/pio run -d firmware/esp8266 -t upload \
|
|
--upload-port /dev/cu.usbserial-1430
|
|
|
|
# 4. 串口监视(看日志,115200 波特率)
|
|
~/.platformio/penv/bin/pio device monitor -p /dev/cu.usbserial-1430 -b 115200
|
|
```
|
|
|
|
固件产物: `firmware/esp8266/.pio/build/nodemcuv2/firmware.bin`
|
|
(可手动用 esptool 刷: `esptool.py --port ... write_flash 0x0 firmware.bin`)
|
|
|
|
## 串口日志示例
|
|
|
|
```
|
|
=== ESP8266 DHCP 采集固件 ===
|
|
[wifi] 连接 你的WiFi名称 ...
|
|
[wifi] 已连接,IP=192.168.1.150
|
|
[router] 抓到页面 2145 字节
|
|
[report] POST /api/raw -> HTTP 200
|
|
{"ok":true,"site":"home","clients":3,"device_count":4,"time":"2026-10-12T13:15:18+08:00"}
|
|
[sleep] 深度睡眠 900 秒
|
|
```
|
|
|
|
### 常见日志 → 排查
|
|
|
|
| 日志 | 含义 / 处理 |
|
|
|---|---|
|
|
| `[wifi] 连接超时` | WiFi 名/密码错,或连了 5G 频段(必须 2.4G) |
|
|
| `[router] 根页面访问失败 / DHCP 页面抓取失败` | 路由器不可达,检查 `ROUTER_HOST`、供电、网线 |
|
|
| `[router] 认证被拒绝(403)` | 密码被改 / 路由器锁定 / 被管理页面限制 |
|
|
| `[router] 认证失败: 密码不正确或已锁定` | `ROUTER_PASS` 不对,或在路由器上换密码 |
|
|
| `[report] POST -> HTTP 401` | `X_TOKEN` 与 server `-stoken` 不一致 |
|
|
| `[report] POST -> HTTP 400` | body 为空 / 页面没解析出数据(服务器返回详情) |
|
|
| `[report] POST -> HTTP 502` | 服务器判定刚才的页面是认证失败页(见上) |
|
|
| `HTTP -1` | 服务器不可达(网络/地址错),本轮丢弃,下轮再试 |
|
|
|
|
## 功耗/间隔
|
|
|
|
`SLEEP_SECONDS` 即深睡时长: WiFi 连接 + 两次网页抓取 + 一次上报,一次完整流程约
|
|
2~5 秒,其余时间深睡。15 分钟间隔下一天约 96 次采集,总耗电极低。
|
|
|
|
> 注意: ESP8266 单次 `ESP.deepSleep` 上限约 **3.5 小时**。若间隔 >3.5h,
|
|
> 需要在深睡唤醒后判断时间再决定是否深睡多段(本固件未做,间隔默认 15 分钟远小于上限)。 |