Initial: DHCP 客户端监控双模式
- client 模式抓取水星 MW305R DHCP 列表,记录上下线,本地看板 - server 模式收上报,按站点分组持久化,多站点看板,7天滚动 - ESP8266 低功耗固件抓原始 HTML 上报 /api/raw,服务器端解析 - 部署脚本+systemd 单元+文档,交叉编译 Linux 二进制
This commit is contained in:
commit
88a35ea427
20 files changed
+3007
No files matched your search
@@ -0,0 +1,8 @@
|
||||
# PlatformIO build artifacts
|
||||
.pio/
|
||||
.vscode/
|
||||
.pioenvs/
|
||||
.piolibdeps/
|
||||
|
||||
# 用户配置(含 WiFi 密码/上报令牌),勿提交
|
||||
src/secrets.h
|
||||
@@ -0,0 +1,106 @@
|
||||
# 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 分钟远小于上限)。
|
||||
@@ -0,0 +1,18 @@
|
||||
; PlatformIO 工程: 低功耗 DHCP 抓取固件(ESP8266 NodeMCU)
|
||||
; 刷写: ~/.platformio/penv/bin/pio run -t upload
|
||||
; 串口监视: ~/.platformio/penv/bin/pio device monitor -b 115200
|
||||
|
||||
[env:nodemcuv2]
|
||||
platform = espressif8266
|
||||
board = nodemcuv2
|
||||
framework = arduino
|
||||
|
||||
; 二进制在编译时不变(用固定的区段),理论上可配合 OTA,本工程用串口刷写
|
||||
; 上传端口: 若 pio 未自动识别,用 --upload-port 指定
|
||||
; upload_port = /dev/cu.usbserial-1430
|
||||
|
||||
; 串口监视波特率
|
||||
monitor_speed = 115200
|
||||
|
||||
; 编译输出固件
|
||||
; .pio/build/nodemcuv2/firmware.bin
|
||||
@@ -0,0 +1,184 @@
|
||||
// ESP8266 低功耗 DHCP 抓取固件
|
||||
// 功能: 登录水星 MW305R 路由器 → GET /userRpm/AssignedIpAddrListRpm.htm
|
||||
// 拿到原始页面 HTML → POST 给 dhcp-mon server 的 /api/raw
|
||||
// → 深度睡眠 SLEEP_SECONDS 秒。
|
||||
//
|
||||
// 解析和上下线判定全部在服务器端(与 README 的 /api/raw 协议一致),
|
||||
// 本固件只做「登录 → 抓页面 → 原样转发」,逻辑极简。
|
||||
//
|
||||
// 关键注意点(来自实测):
|
||||
// 1. 认证 Cookie 必须是无引号的 "Authorization=Basic xxx"(标准 cookie
|
||||
// 编码会加引号 → 路由器 403),因此这里手动设置 Cookie 头。
|
||||
// 2. 必须带浏览器 User-Agent + Referer,否则路由器返回 403。
|
||||
// 3. ESP8266 只能连 2.4GHz WiFi。
|
||||
//
|
||||
// 刷写: 见 firmware/esp8266/README.md
|
||||
|
||||
#include <Arduino.h>
|
||||
#include <ESP8266WiFi.h>
|
||||
#include <ESP8266HTTPClient.h>
|
||||
|
||||
#include "secrets.h"
|
||||
|
||||
// 与 Go 端 main.go 的 defaultUA 保持一致
|
||||
static const char *UA =
|
||||
"Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 "
|
||||
"(KHTML, like Gecko) Chrome/80.0.3987.132 Safari/537.36";
|
||||
|
||||
// 简单 base64 编码(避免依赖核心版本的 base64.h,量很小且确定)
|
||||
static const char B64[] =
|
||||
"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
|
||||
|
||||
static String base64Encode(const String &in) {
|
||||
String out;
|
||||
out.reserve((in.length() + 2) / 3 * 4);
|
||||
const uint8_t *d = (const uint8_t *)in.c_str();
|
||||
size_t i = 0;
|
||||
size_t len = in.length();
|
||||
while (i + 3 <= len) {
|
||||
uint32_t n = (d[i] << 16) | (d[i + 1] << 8) | d[i + 2];
|
||||
out += B64[(n >> 18) & 63];
|
||||
out += B64[(n >> 12) & 63];
|
||||
out += B64[(n >> 6) & 63];
|
||||
out += B64[n & 63];
|
||||
i += 3;
|
||||
}
|
||||
size_t rem = len - i;
|
||||
if (rem == 1) {
|
||||
uint32_t n = d[i] << 16;
|
||||
out += B64[(n >> 18) & 63];
|
||||
out += B64[(n >> 12) & 63];
|
||||
out += "==";
|
||||
} else if (rem == 2) {
|
||||
uint32_t n = (d[i] << 16) | (d[i + 1] << 8);
|
||||
out += B64[(n >> 18) & 63];
|
||||
out += B64[(n >> 12) & 63];
|
||||
out += B64[(n >> 6) & 63];
|
||||
out += '=';
|
||||
}
|
||||
return out;
|
||||
}
|
||||
|
||||
// 向路由器发 GET,返回响应体(原始字节,可能 GBK);失败返回空字符串
|
||||
static String routerGet(HTTPClient &http, WiFiClient &wifi,
|
||||
const String &url, const String &referer,
|
||||
const String &authCookie) {
|
||||
http.begin(wifi, url);
|
||||
http.setTimeout(8000);
|
||||
http.addHeader("User-Agent", UA);
|
||||
http.addHeader("Referer", referer);
|
||||
// 关键: 手动设置 Cookie,避免库对 cookie 值加引号
|
||||
http.addHeader("Cookie", "Authorization=" + authCookie);
|
||||
int code = http.GET();
|
||||
if (code != HTTP_CODE_OK) {
|
||||
Serial.printf("[router] GET %s -> HTTP %d\n", url.c_str(), code);
|
||||
http.end();
|
||||
return String();
|
||||
}
|
||||
String body = http.getString();
|
||||
http.end();
|
||||
return body;
|
||||
}
|
||||
|
||||
// 登录路由器并抓取 DHCP 客户端页面的原始 HTML
|
||||
static String fetchRouterPage(WiFiClient &wifi) {
|
||||
String auth = "Basic " + base64Encode(String(ROUTER_ADMIN) + ":" + ROUTER_PASS);
|
||||
|
||||
HTTPClient http;
|
||||
// 先访问根页面建立会话(与 Go 端 fetch() 行为一致)
|
||||
String root = routerGet(http, wifi, "http://" + String(ROUTER_HOST) + "/",
|
||||
"http://" + String(ROUTER_HOST) + "/", auth);
|
||||
if (root.length() == 0) {
|
||||
Serial.println("[router] 根页面访问失败");
|
||||
return String();
|
||||
}
|
||||
|
||||
String page = routerGet(
|
||||
http, wifi,
|
||||
"http://" + String(ROUTER_HOST) + "/userRpm/AssignedIpAddrListRpm.htm",
|
||||
"http://" + String(ROUTER_HOST) + "/userRpm/MenuRpm.htm", auth);
|
||||
if (page.length() == 0) {
|
||||
Serial.println("[router] DHCP 页面抓取失败");
|
||||
return String();
|
||||
}
|
||||
if (page.indexOf("403 Forbidden") >= 0 ||
|
||||
page.indexOf("You have no authority") >= 0) {
|
||||
Serial.println("[router] 认证被拒绝(403): 检查密码或路由器锁定");
|
||||
return String();
|
||||
}
|
||||
if (page.indexOf("httpAutErrorArray") >= 0 ||
|
||||
page.indexOf("pcPassword") >= 0) {
|
||||
Serial.println("[router] 认证失败: 密码不正确或已锁定");
|
||||
return String();
|
||||
}
|
||||
Serial.printf("[router] 抓到页面 %d 字节\n", page.length());
|
||||
return page;
|
||||
}
|
||||
|
||||
// 把原始页面 POST 给服务器 /api/raw
|
||||
static int reportPage(WiFiClient &wifi, const String &page) {
|
||||
HTTPClient http;
|
||||
http.begin(wifi, SERVER_URL);
|
||||
http.setTimeout(10000);
|
||||
http.addHeader("Content-Type", "text/html; charset=GBK");
|
||||
http.addHeader("X-Token", X_TOKEN);
|
||||
http.addHeader("X-Site", X_SITE);
|
||||
int code = http.POST(page);
|
||||
String resp = http.getString();
|
||||
http.end();
|
||||
Serial.printf("[report] POST /api/raw -> HTTP %d\n", code);
|
||||
if (code > 0) {
|
||||
Serial.println(resp);
|
||||
}
|
||||
return code;
|
||||
}
|
||||
|
||||
void setup() {
|
||||
Serial.begin(115200);
|
||||
Serial.println();
|
||||
Serial.println("=== ESP8266 DHCP 采集固件 ===");
|
||||
|
||||
// 短暂点亮板载 LED 提示本次唤醒
|
||||
pinMode(LED_BUILTIN, OUTPUT);
|
||||
digitalWrite(LED_BUILTIN, LOW);
|
||||
delay(150);
|
||||
digitalWrite(LED_BUILTIN, HIGH);
|
||||
|
||||
// 连接 WiFi(ESP8266 仅支持 2.4GHz)
|
||||
WiFi.mode(WIFI_STA);
|
||||
WiFi.begin(WIFI_SSID, WIFI_PASS);
|
||||
Serial.printf("[wifi] 连接 %s ...\n", WIFI_SSID);
|
||||
uint32_t t0 = millis();
|
||||
while (WiFi.status() != WL_CONNECTED) {
|
||||
if (millis() - t0 > 20000) {
|
||||
Serial.println("[wifi] 连接超时,直接进入深度睡眠");
|
||||
ESP.deepSleep(SLEEP_SECONDS * 1000000ULL, WAKE_RF_DEFAULT);
|
||||
return; // 不会到达
|
||||
}
|
||||
delay(500);
|
||||
}
|
||||
Serial.printf("[wifi] 已连接,IP=%s\n", WiFi.localIP().toString().c_str());
|
||||
|
||||
WiFiClient wifi;
|
||||
// 登录路由器 + 抓页面
|
||||
String page = fetchRouterPage(wifi);
|
||||
if (page.length() > 0) {
|
||||
// 原样转发原始 HTML(服务器端解析 DHCPDynList + 上下线判定)
|
||||
reportPage(wifi, page);
|
||||
} else {
|
||||
Serial.println("[report] 无页面可上报,跳过本轮");
|
||||
}
|
||||
|
||||
// 深度睡眠到下一轮(固定间隔,低功耗)
|
||||
// 注: 自动唤醒需 GPIO16(D0) 短接到 RST;无跳线则按 RST 唤醒。
|
||||
// 单次深睡上限约 3.5 小时,间隔超过请拆成多段循环。
|
||||
Serial.printf("[sleep] 深度睡眠 %u 秒\n", SLEEP_SECONDS);
|
||||
Serial.flush();
|
||||
ESP.deepSleep(SLEEP_SECONDS * 1000000ULL, WAKE_RF_DEFAULT);
|
||||
}
|
||||
|
||||
void loop() {
|
||||
// setup() 里已深睡,不会到这里;安全兜底再睡一次
|
||||
ESP.deepSleep(SLEEP_SECONDS * 1000000ULL, WAKE_RF_DEFAULT);
|
||||
delay(1000);
|
||||
}
|
||||
@@ -0,0 +1,27 @@
|
||||
// 用户配置 —— 复制本文件为 secrets.h 并填入真实值。
|
||||
// 真正生效的是 secrets.h(已被 .gitignore 忽略),本文件只是提交的模板示例。
|
||||
// 本文件含敏感信息(令牌/密码),请勿在 secrets.h 中提交真实凭据。
|
||||
|
||||
#pragma once
|
||||
|
||||
// ---- WiFi(ESP8266 连接的网络)----
|
||||
// 注意: ESP8266 只能连 2.4GHz 网络,5G 不支持。
|
||||
static const char *WIFI_SSID = "你的WiFi名称";
|
||||
static const char *WIFI_PASS = "你的WiFi密码";
|
||||
|
||||
// ---- 上报服务器(dhcp-mon server 模式)----
|
||||
// 指向跑 dhcp-mon -mode server 的机器,例: http://your-vps-ip:8080
|
||||
// 必须是 ESP8266 能访问到的地址(同网段或公网域名)。
|
||||
static const char *SERVER_URL = "http://your-vps-ip:8080/api/raw";
|
||||
|
||||
// ---- 认证与站点(需与 server 的 -stoken 一致)----
|
||||
static const char *X_TOKEN = "与server的-stoken一致";
|
||||
static const char *X_SITE = "home"; // 站点名,如 home/office/shop
|
||||
|
||||
// ---- 路由器(Mercury 水星 MW305R)----
|
||||
static const char *ROUTER_HOST = "192.168.1.1";
|
||||
static const char *ROUTER_ADMIN = "admin";
|
||||
static const char *ROUTER_PASS = "123456";
|
||||
|
||||
// ---- 采集间隔(秒): 深度睡眠时长,默认 15 分钟 ----
|
||||
static const uint32_t SLEEP_SECONDS = 900;
|
||||
Reference in new issue
Block a user