快速上手
1. 接线
目标板的 UART 引出三根线接抓取器：
目标板 TX ──▶ 抓取器 RX
目标板 RX ──◀ 抓取器 TX
目标板 GND ─── 抓取器 GND （必须共地）供电由抓取器自身 USB 提供即可，不要从目标板取电，避免目标板掉电时日志也一起断。
2. 烧录固件
两种方式，选一个：
- 浏览器直刷：打开 SnapLogFlashTool，用 Chrome/Edge 选串口、选固件，点一下刷完，不用装驱动以外的任何东西。
- 命令行：用 esptool 自行烧录，固件来自 snaplog_device 仓库。
3. 配网
抓取器上电后自身开一个热点，用手机或电脑连上去打开配网页，填 WiFi 与 MQTT 参数后保存。设备 ID 与密钥是出厂写进 NVS 的，配网不会改变它们 —— 换 WiFi 不等于换设备。
设备上行走 WSS 443，只要能正常上网就能连，不需要在路由器上开端口或做内网穿透。
4. 在控制台认领
打开 https://iot.snapwhere.app（入口是根路径），登录后按设备 ID 认领。认领成功后：
- 设备在线状态由
status/{device_id}的 retained 消息决定，掉电时 broker 会代发offline； - 日志默认「只实时看、不落库」，想留历史就打开录制开关。
5. 验证链路
# 在目标板上随便制造点输出
echo "hello snaplog" > /dev/ttyS1
# 控制台应看到该行，级别为 I；
# 设备列表里 RSSI、心跳时间应有值。看不到日志时先查三件事：共地有没有接、波特率对不对、TX/RX 是不是反了。90% 的「收不到」都在这三条里。