SnapLog 串口日志云桥
它做三件事：抓串口、过 Wi‑Fi 送上去、在网页里像坐在机器旁边一样看。不需要在目标设备上装任何东西 —— 目标设备甚至不知道自己被记录了。
它替你解决什么
机器不在手边设备在现场、在客户那儿、在机房，出问题时要跑过去接串口线。现在只要它能连 Wi‑Fi，日志就在网页上。
偶发问题抓不住复现一次要几小时甚至几天，人不可能一直盯着。日志自动留存，事后按时间翻。
日志不知道丢没丢每一行都有逐行编号，云端能明确告诉你「中间缺了哪一段、缺多少行」，而不是让你猜。
多人协作难一条分享链接就能把这台设备的日志给别人看，免登录、只读，不用把账号密码交出去。
硬件侧特色
插上就用，不用装 App
- 免 App 配网：通电后自己开一个叫
SnapLog-XXXX的热点，手机连上就自动弹配置页（不弹就手动开192.168.4.1），选你家 Wi‑Fi、填密码、保存，完事。 - 热点永远开着：就算 Wi‑Fi 配错了、路由器换了、密码改了，热点和本地网页都还在 —— 随时能连进去改，不存在「配错就变砖」。
- 开机即出网页：设备启动的第一时间就把本地控制台拉起来，后面任何一步卡住都还能进得去看状态。
串口能力
- 超宽波特率：300 ~ 3,000,000 bps，默认 115200。1.5M 这种高速 boot log 也吃得下。
- 格式可调：数据位 5–8、校验 N/E/O、停止位 1/2，掉电记忆。
- 双通道并存：外引 UART（GPIO20 收 / GPIO21 发）抓日志的同时，USB 口还能当普通串口线用（桥接），也可以走 TCP 3333 远程连。
- 不动目标设备：纯旁路嗅探，不占用、不改变目标设备的串口行为。
连得上、看得见
- AP + STA 同时在线：一边连你家路由器上云，一边保留本地热点，近场和远程两不误。
- 掉线立刻知道：MQTT 带遗嘱消息（LWT），设备一断线云端马上标记离线；页面还会在状态翻转那一刻被推送唤醒、立即刷新 —— 上下电通常 1~2 秒内就看到，不用手动刷。
- 本地网页控制台：实时日志、发命令、改波特率、看 Wi‑Fi 信号、OTA 升级，全在浏览器里。
- 远程升级：支持 OTA，不用拆壳接线。
省流量、能扛断网
- 设备侧过滤：按级别（只上 ERROR）、按关键字（只上含 timeout 的）、按采样（每 N 条上 1 条）—— 三级可叠加，在设备端就把无关行扔掉，真省带宽。被过滤的行不占编号，不会造成假告警。
- 一键暂停上行：不想传就不传，本地桥接和网页照常工作。
- 两级缓冲：内存 ring 约 100 行（常态）；可选开 flash 落盘再攒约 790 行，且掉电不丢。Wi‑Fi 断了先把日志存着，连上自动补传。
- 断线自动重发：发布走 QoS1 并等回执，8 秒没等到就用同一批重发；服务端按编号去重，重复发安全。
插张卡就不怕长时间断网
- 三档 TF 落档：关 / 仅断网时 / 始终写，后台点一下或串口
#SD 0|1|2，选完掉电保持。 - 卡上留全档，不过滤：日志先落卡、再走过滤上云。云端只为过滤后的行付流量，卡上留的是完整原始记录 —— 省流量和留全档这两件相反的事同时做到。
- 能装几百 MB：
/snaplog/0001.log顺序编号，单文件满 4 MB 自动切，最多 48 个（约 190 MB），按 4 KB/s 算也够录十几个小时。 - 像打开文件夹一样取出来：后台「历史查询 → TF 文件导出」，列出卡上每个文件及大小，勾选后下载 —— 单文件给纯文本，多个打包成 zip。
- 关了写卡也能导出：关的是「写」，不是「读」。开关拨到「关」照样能浏览和取走卡上已有的档，导出结束后设备会把卡卸回原状 —— 你随时可以安心拔卡。
- 不替你擅自灌回云端：卡上的档不进日志库、不占额度。要不要把某几段提到云端，你自己挑文件决定 —— 灌回去既占上行流量又占配额，还会挤掉正在产生的实时日志。
- 不插卡、卡坏了都照常工作：抓取和上云完全不受影响，后台只是把
sd_ok标 false 并给出原因，支持热插拔后重试。
顺手把屏幕关掉，把资源让给写卡
- 默认无头运行：本版固件默认不初始化 LCD。TF 和屏共用同一条 SPI2 总线，屏一刷就把写卡打断 —— 关掉屏是写卡稳的前提，顺带省 60 KB 帧缓冲和那点背光功耗。
- 想要屏还能开回来：串口
#LCD 1后重启即可，不是永久砍掉。
云端后台特色
像坐在机器旁边
- 同一个串口，两种看法：日志流负责解析展示（时间戳、方向标记、按级别着色—— ERROR 红、WARN 黄带色条，扫一眼就知道哪行要紧）；嵌入式调试模式是完整串口终端（xterm），能敲命令、看回显、看进度条重绘。两者底色一致，切换不刺眼。
- 真终端：不是简单的日志墙，是一个完整的串口终端（xterm），能敲命令、看回显、看进度条重绘。
- 熟悉的快捷键：
Ctrl+L清屏、Ctrl+U/K/W删行删词、Ctrl+P/N翻历史、Shift+PageUp/Down翻页、Ctrl+/看全部键位。 - 暂停不丢行：想仔细看一段就暂停，屏幕冻住，后台继续收，恢复时原样补回。
- 实时跟随 + 历史查询：既能跟着最新输出滚，也能按时间往回翻。
知道「丢没丢」
- 日志缺口检测：逐行编号，跳号就是真丢了。后台能列出每一段的区间、缺多少行、什么时候发现的 —— 这是「日志到底全不全」唯一的客观判据。
- 过滤不计入丢失：主动过滤掉的行不产生缺口，和真丢数据分得清清楚楚。
管得住
- 认领码绑定：4 位认领码（去掉了 O/0、I/1 这类易混字符），刷入或输入即绑定到你的账号。
- 分享：生成免登录只读链接，随时可收回。
- 用量与配额：日流量、月流量、存储保留天数都有额度并显示，超额会明确提示而不是悄悄拒收。
- 远程下发：波特率、过滤规则、上行开关、落盘开关、TF 落档模式、读卡与取文件、重启，都能从云端下发到设备。
典型用法
| 场景 | 怎么用它 |
|---|---|
| 远程排障 | 机器留在客户现场，出问题让你把日志发过去 —— 你说「给我一条链接」，自己就能看实时输出。 |
| 抓偶发重启 | 挂着不动，让它一直记录。重启一次，事后来翻重启前的最后几百行。 |
| 现场没网 | 客户厂房没 Wi‑Fi、或者就是不让联网 —— 开「始终写」，插张卡录满一段时间，事后把卡拿回来读，接上电脑就是一个纯文本文件。 |
| 产线自检 | 治具上烧完固件，用环回测试命令验证串口通路，日志和结果一起留档。 |
| 长期值守 | 开级别过滤只上 ERROR，流量几乎为零，只在出事时才会有数据上来。 |
| 多人协作 | 一条只读分享链接丢群里，同事不用注册就能看。 |
一句实话：它首先是个日志搬运工。断网时靠内存缓冲能撑百行量级（开 flash 落盘约近千行），够 cover 一次重连；要扛长时间断网，得插 TF 卡（几百 MB 量级），卡里的内容在后台「TF 文件导出」里自己挑文件下载，或者直接把卡拔下来用读卡器读 —— 它不会自己灌回云端（那要占上行流量和配额）。没有卡的时候，它依然只覆盖一次断线重连 —— 这点不会因为加了个卡槽就变成无限。
SnapLog · 产品特色说明 · 对应固件 V3.26.0-CLOUD