UART · MQTT OVER WSS · OFFLINE BUFFER

串口日志,不再只躺在你的工位上

一块巴掌大的 ESP32-C3 抓取器。接上目标板的 UART,日志就实时到云端 —— 人在哪都能看,断网也不丢。需要人盯的时候你在浏览器里盯,不想盯的时候让 AI 把结论写出来。

设备通道 wss://iot.snapwhere.app/mqtt · 443 出站即可,不用开端口、不用内网穿透

SnapLog Dongle REV. C3 · 42 × 20 MM
ESP32-C3 PWR LINK TX RX GND SW-XXXXXX 115200 – 3 Mbps 3V3 · UART
3 线TX RX GND
5V / 3V3USB 供电
42 × 20MM
MCUESP32-C3RISC-V · WiFi 2.4G
CAPTURE3 MbpsUART 上限波特率
UPLINKWSS 443QoS 1 · 带 LWT
OFFLINElittlefs断网缓存后补传
QUOTA100 MB账户每日流量
OTAYES后台上传,自行升级
01

把「抓日志」这件苦差事做成默认可靠

从固件到云端是一条链,每一环都有明确的兜底,而不是「大概能收到」。

01 / 实时流

像串口终端一样看

浏览器里 2 秒刷新,按级别着色,可按设备与时间范围回看,不用再插线。

02 / 断网不丢

先缓存,联网补齐

WiFi 断了先落 littlefs,恢复后按批次序号补传;服务端靠 seq 去重,重发多少次都只入库一条。

03 / 缺口可查

补全还是漏了,有判据

批次跳号会被记成缺失区间。补齐是「无损」还是「有洞」,页面上有客观指标,不靠猜。

04 / AI 操作员

让 AI 先读一遍

下达目标后 AI 生成诊断计划,你能看到它将要执行的每一条命令;敏感命令必须你点头才下发。

05 / 监控任务

用正则替你守着

命中自动抓取上下文快照,冷却时间与每小时上限可调,不再靠人熬夜盯串口。

06 / 固件 OTA

批量维护不插线

新固件从后台上传,设备自行拉取升级,几十台也是一次操作。

确定性优先。AI 只出现在头尾两端(生成计划、生成文档),中间的执行是纯代码,命令只能来自模板白名单。写操作会弹确认卡,出厂复位与刷写类命令在协议层直接拒绝。

02

四步接上,中间没有黑盒

第一次配网大约十分钟。之后这块板子就自己待在机柜里干活。

  1. STEP 01

    接线

    TX / RX / GND 三根线接目标板 UART,支持 115200 到 3 Mbps。

  2. STEP 02

    上云

    设备经 WSS 443 连到 broker,批次 50 行或 200 ms 触发一次上报,QoS 1 且带 LWT 遗嘱。

  3. STEP 03

    落库

    服务端先入队再串行落库,MQTT 回调里不碰磁盘,避免 PUBACK 超时引发的重发雪崩。

  4. STEP 04

    看与问

    浏览器实时看流,或让 AI 基于证据包生成诊断文档 —— 每条结论都要标出依据是哪一行日志。

03

设备与链路参数

对外开放的接口都在这一页上,固件与服务端共用同一份契约。

主控ESP32-C3RISC-V 单核,WiFi 2.4 GHz
抓取接口UART115200 ~ 3,000,000 bps
上行通道MQTT over WSS443 出站,QoS 1;1883 端口不对公网开放
在线判定status/{device_id} + LWTretain=1,掉电由 broker 代发 offline
批次策略50 行 / 200 ms单批硬上限 512 行,超出截断并计数
单行上限512 B超长部分固件侧截断
级别E / W / D / IERROR、ERR、F→E,WARN→W,DEBUG→D,其余 I
离线缓存RAM → littlefs重连退避 1→2→5→10→30 s,期间不丢日志
设备标识SW-XXXXXX由 MAC 后 6 位生成,出厂写入 NVS,终身不变
固件升级OTA后台上传,设备从 HTTPS 拉取

完整字段语义与错误码见设备协议文档 →

04

供货与价格

首批小批量供货中。硬件与云端服务分开计价,批量与私有化单独报价 —— 把场景和数量发过来,我们回一个能落地的方案。

PLAN 01

单机验证

咨询报价

先拿一台跑通自己的场景,确认链路和数据都符合预期。

  • 1 台 dongle + 云端账号
  • 账户日流量 100 MB
  • 单设备保留 40 MB / 7 天
PLAN 02

团队部署

按台数

多台设备批量上线,固件统一维护,成员分权限协作。

  • 批量设备与配额调整
  • 固件 OTA 与版本管理
  • 监控任务与 AI 诊断
PLAN 03

私有化

单独报价

整套服务部署到你自己的服务器或内网,数据不出域。

  • compose 编排与部署脚本
  • 运维文档与交接培训
  • 可按需定制固件
05

常见问题

需要在防火墙上开端口吗?

不用。设备走 MQTT over WSS 的 443 出站,和普通 HTTPS 一样。1883 端口不对公网开放。

断网期间的日志会重复入库吗?

不会。设备侧按批次序号补传,服务端以 seq 去重,同一批重发多少次都只入库一条;跳号会被记成缺失区间,可在页面上查。

额度是怎么算的?

用 MB 计量而不是行数:一行的计费字节 = 内容字节 + 254 B 固定开销。账户日流量 100 MB(≈33.4 万行),设备保留 40 MB / 7 天,账户总存储 300 MB,设备数上限 20 台。

支持多高的波特率?

115200 到 3,000,000 bps。高波特率下建议缩短线长,并确认目标板 UART 引脚未被复用。

AI 能直接操作我的设备吗?

命令只能来自模板白名单,写操作(如重载驱动)会弹确认卡需你点头,出厂复位与刷写类命令在协议层直接拒绝。每条 AI 结论都要标出依据的日志行。

可以部署到我们自己的服务器吗?

可以。整套服务支持私有化部署到你自己的机器或内网,交付 compose 编排、部署脚本与运维文档。

GET STARTED

让日志离开你的工位

控制台入口是 https://iot.snapwhere.app(根路径,不是 /console)。已经在跑的设备直接登录就能看;还没上手的,十分钟接上第一块板。