#移远产品体验官# #QuecDuino# EG800Z#
体验产品:QuecDuino 开发套件(EG800Z 模组 + I/O 扩展板)
| 上篇:《新手踩坑实录:用 QuecDuino 折腾出一台 4G 火焰报警装置》
先把上次的尾巴接上
上一篇的结尾,火焰报警算是通了:KY-026 见火就上报,4G 走移远云,手机 APP 会弹"检测到火焰,请立即处理!“。当时还挺得意,结果用了两天发现不对劲——这弹窗只能告诉我"着火了”,告诉我不了"烧成什么样了"。人不在家的时候,收到一条纯文字报警,说白了跟只听到火警铃响差不多,你还是不知道往回跑还是提前拨打救援电话。
所以这篇就干一件事:板子自己发现火,自己拍张照,照片穿过 4G,直接出现在我手机 QQ 群里。【图 2:串口日志——IMG_START → DATA×N → 照片重组完成】
这个目标现在已经完整跑通了:点火,QQ 群里几秒内出现一条"检测到火焰!现场照片如下:",点开就是一张 640×480 的现场实拍。下面把整条链路怎么搭的、中间踩了多少坑,一五一十写出来。
动手之前先想清楚方案,这里把我的思路摊开写,给有类似需求的朋友省点纠结时间。
拍照这事,到底交给谁干?
我第一个念头当然是让 QuecDuino 自己拍。查了一圈,QuecPython 目前没有 UVC 驱动,USB 摄像头插在 EG800Z 上是点不亮的,这条路直接堵死。
那就只能外挂一块小板专门管拍照。这里我特意把它定位成一只"眼睛":它只干三件事——听命令、抓一帧、把 JPEG 数据吐出来。什么时候拍、拍完怎么收、怎么校验、怎么传云、怎么发群,这些逻辑全在 QuecDuino 这边。
有朋友可能会问,为啥不让眼睛那边自己联网发图?我考虑过,最后没这么干,原因有二:一是多一个要管网络的设备,就多一份要维护的连接逻辑,装置是打算长期扔在仓库里跑的,越简单越不容易出幺蛾子;二是我就是想看看,一颗 Cat.1 模组到底能扛多少活。后面你们会看到,它能扛的比我想象中多得多。
顺便点一下这只"眼睛"本身:一块 ESP32-S3 小板,跑 C 固件,USB Host 直挂 UVC 摄像头,收到 CAPTURE 命令就抓一帧 JPEG,按 1024 字节一片从串口吐回来。它那边也有不少故事(USB 驱动调优、C 语言的协议实现,还顺手带了个离线语音唤醒),但那是另一个话题了,这篇不展开,免得喧宾夺主。
整条数据流长这样:
火焰触发
↓ QuecDuino 发 CAPTURE 命令(UART,自定义帧协议)
[外挂摄像头抓一帧 JPEG]
↓ 照片按 1024B/片 分帧回传(640×480 约 13KB → 13 片,零丢帧)
QuecDuino:内存重组 → sha256 校验 → 落盘留档
├──→ base64 分块透传 → 移远云(给平台/后端用)
└──→ QQ 官方机器人接口 → 推送到 QQ 群(本文最磨人的一段,见第 5、6 步)
下面按我实际搭建的顺序一步步写。每一步先讲"我为什么这么设计",再讲"我踩了什么坑、怎么发现的",坑都尽量给到可复现的细节,希望后人少熬几个通宵。
第 1 步:跟眼睛说话之前,先把串口摸清楚
两块板子之间要通信,第一件事是选串口。上篇我整理过一张"丝印 ↔ GPIO 对照表",当时结论是丝印 0/1 和 2/3 都是串口。这次真要拿来跑业务了,我才发现那句话只对了一半——串口和串口是不一样的,哪个能拿来跑业务,必须一个一个实测。
我是这么测的:写个最小程序,把串口 open 出来直接收发,看跟对端通不通、看 REPL 还活不活。结果一测就翻车:
- 丝印 0/1 是 REPL 的活动通道。我的业务程序一 open,直接跟 REPL 抢同一条线。最惨的一次,我在 REPL 里敲了个命令,回显把协议帧淹了,对端收到的全是乱流,连帧头 AA 55 都找不着;还有一次更绝,REPL 彻底哑了,怎么都不理我,最后物理拔插了一次 USB 才救回来。
- 丝印 2/3(UART0) 才是干净的业务口,open 它完全不影响 REPL。
所以这里劝一句:拿到板子别急着写业务,先把每个丝印串口用最小程序探一遍,确认谁被 REPL 占着、谁是干净的,十分钟的事,能省你后面好几小时的玄学排查。
最终接线(必须交叉、必须共地,扩展板红排跳帽放 3.3V 档):
摄像头端 TX ──→ QuecDuino 扩展板 D2 (UART0 RX)
摄像头端 RX ←── QuecDuino 扩展板 D3 (UART0 TX)
GND ──── GND
顺便说,多路 UART 这事真的好用:业务跑在 UART0,调试走 REPL,两不耽误。联调那几天我都是一边实时看着业务日志,一边改代码重传,模组一次都没重启过。搁以前玩单片机,串口印点调试信息都得精打细算,现在调试口和业务口分开,舒服太多了。
第 2 步:分帧协议怎么设计,以及三个坑
串口是字节流,没有"消息边界"这个概念。几张 KB 的照片裸发过去,你根本不知道哪里是一帧的头哪里是尾,也没法知道丢没丢。所以必须自己设计分帧协议。我的帧结构是这样的:
AA 55 | TYPE(1B) | SEQ(2B) | LEN(2B) | PAYLOAD | CRC16(Modbus) | 0D 0A
设计考虑说一下:帧头 AA 55 用来在乱流里找边界;TYPE 区分消息类型——PING/ACK 心跳、CAPTURE 拍照命令、IMG_START/IMG_DATA/IMG_END 照片三段式;SEQ 是序号,丢了哪片一查便知;CRC16 选 Modbus 标准的,因为查表法现成、双端实现不容易有歧义;帧尾 0D 0A 纯属双保险,方便肉眼在串口助手里看帧。
对端是 C 写的,我这边是 QuecPython,整套协议解析就跑在模组上。就这么点东西,落地时踩了三个坑,一个比一个经典:
坑 1:CRC16 少循环了 7 次,两边互相丢帧。 联调的时候特别诡异:我这边说"我发了",对面说"我没收到",对面说"我回了",我这边说"我没收到"。把 QuecDuino 收到的 CRC 和我本地算的打印出来一对:recv=fdff calc=c435。查了半天,是我 Python 版的 CRC16 每个字节只移位了 1 次,而标准 Modbus CRC 要求内层循环 8 次。就这一个数字的差别,改完立刻全通。
这个坑我摔得一点都不冤。给所有要写双端自定义协议的朋友一个建议:先别上真板子,在 PC 上写个对拍脚本,两边跑同一组测试向量,把算出来的 CRC 打印出来对,对上了再上板。 五分钟的事,能救你一晚上。
坑 2:921600 波特率全线丢帧。 我一开始贪快,直接上高速率,结果模组端收到的数据每次都丢开头两个字节。降回 115200 之后零丢帧。10KB 的照片 5 秒左右传完,火焰报警这场景完全不差这几秒。教训就是:别迷信"能配多高就配多高",稳定性优先,尤其模组端 FIFO 和中断响应是有上限的,超了就是悄悄丢字节,还不报错。
坑 3:UART FIFO 溢出,固定"收到 815 字节就断"。 这个坑最隐蔽,因为每次都断在同一个位置,一开始我还以为是协议有 bug。后来算了笔时序账才明白:115200 波特率大概是每秒 11.5KB,1024 字节要 89ms 才能灌完;而我代码里无条件 sleep(50),CRC 又算得慢,一来二去 FIFO 就来不及读了,溢出,数据悄悄没了。
改法很简单也很反直觉:“有数据不睡”——uart.read(1024) 读到多少处理多少,没数据的时候才 sleep(10) 让出 CPU。改完之后照片一个字节都不差。QuecPython 是单 GIL 的协作式调度,没有中断抢你的 CPU,像串口这种硬实时的环节,代码节奏必须围着 FIFO 转,你多睡一觉数据就没了。
第 3 步:收照片千万别边收边写 flash
这是模组侧我个人认为最隐蔽的一个坑,单独拎出来讲。
照片是十几片连续灌过来的。我最开始的写法很"直觉":收到一片,往文件里追加一片,收完正好写完,看着还挺高效。结果连续大片必丢帧。原因就是第 2 步说过的那个时序账:写 flash 的耗时是不可控的,你在这边写盘,UART 那边的 FIFO 就没人读,一溢出又是悄悄丢数据。
改成两段式就好了:收包期间只往内存(bytearray)里追加,收到 IMG_END 再一次性落盘,落完盘算一遍 sha256。校验值跟摄像头端对上了,才算一张完整的照片。
这里多说一句为什么要加 sha256:每一片不是都有 CRC 了吗?有,但 CRC 只保证"传输过程中没坏",落盘前后文件系统会不会抽风、重组逻辑有没有把片序搞错,CRC 管不到。多一层哈希,等于给整张照片上了双保险,成本几乎为零。
端到端实测:点火触发 → 21 片回传 → 落盘 10456 字节 → sha256 两边一致,全程心跳每 3 秒一次,稳得很。
总结成一句话:小于 100KB 的文件,在模组上老老实实用内存缓冲,把"写盘"这个慢动作放到接收循环的外面去,别穿插在高频收数的地方。
第 4 步:照片上云,单包上限又教我一次
照片要穿 4G 送到远端,我的第一版是 base64 编完一把梭,单发 14KB。实测直接阻塞,接口不返回了,等了半天超时。
分析下来,base64 本身还要膨胀 1.33 倍,14KB 变 19KB,再算上 MQTT 的包头什么的,单包体积肯定顶到了某个上限。这个上限具体是多少文档没写死,我也没兴趣拿真机去试出来,直接改成分块:512 个 base64 字符一块,每块带块号和总数(格式类似 PH|2/21|sha前8位|数据),发完补一条 END 帧,对端按块号拼回来。块与块之间 sleep 120ms,给 MQTT 一点喘息。
这么改还有个额外好处:万一中途断了,日志里能看出来断在第几块,重传也只需要重传那一块,不用整张照片从头来。
到这里,"照片上云"就通了。QuecDuino 的 4G 从第一天起就是这套系统的底气:不用配网、不用路由器,插卡即上线,这点对要部署在仓库这种没 WiFi 的地方太重要了。但上云是给机器看的,我还想让人直接在手机上看到图。于是就有了第 5 步——整篇最磨人、也最能体现这颗模组能力的一段。
第 5 步:在一颗模组上,手写 TLS 直连 QQ 官方 API
先讲方案。QQ 有官方机器人开放接口,流程不复杂:取 access_token → 上传文件拿到 file_info → 发富媒体消息进群,三步。难点全在"怎么从一块模组上发出 HTTPS 请求"这件事上。注意整个过程中没有电脑、没有路由器,QuecDuino 靠一张 4G 卡直连公网 API。
坑一个一个来。
坑 1:官方 request 模块怎么都连不上。 request.post('https://...') 一律 ECONNRESET。我一开始以为是库的问题,换了各种姿势都没用。后来打了一行 time.time(),人傻了:板子系统时间冻在 1970 年,差了 56 年。带 SNI 的 TLS 握手要做证书链校验,证书是有有效期的,系统时间不对,校验必然失败,对端直接把你 reset 掉,表面看就是"连不上"。
更坑的是时间还写不进去,ntptime、RTC().datetime() 各种办法都试了,写完一读还是 1970。最后我的解法是绕开封装,在模组上用 usocket + ussl 手写 HTTPS 客户端,握手的时候不传 server_hostname——不做证书校验,时间不对也就无所谓了。
这里两个提醒:一是 QuecPython 的 ussl 对象没有 send() 方法,只有 write(),用错就是 AttributeError,别问我怎么知道的;二是跳过证书校验等于放弃了防中间人,自己玩玩可以,真要上生产请务必先把时间同步解决掉,这个后面给官方的建议里我会再提。——不过话说回来,能在模组层面把 TLS 握手拆开自己写,本身就说明 QuecPython 的网络栈开放程度是真的高,普通 MCU 的 WiFi 库可不会给你这个自由度。
坑 2:群标识抄错一位,我一度以为群被注销了。 测试的时候接口一直返回 11255(群不存在),我心想完了,测试群不会真被注销了吧,都开始琢磨重建群了。后来拿实时接口一核对群信息:群好好的,机器人在群里,权限全开。再看请求参数——group_openid 被我抄错了一位。上篇我刚写过密钥从截图手抄错一个字符通宵的事,结果同一个坑换个地方又摔一次,一点长进没有。
现在我的规矩改成了铁律:任何长串标识符,禁止手抄,只允许复制粘贴,而且发出请求前用另一个实时接口反向核对一遍。 建议大家也立这条规矩,这坑真的谁踩谁知道。
坑 3:token 缓存复用,偶发失效。 access_token 官方说 2 小时有效,我就缓存起来复用,结果偶发 11244(token 无效)。实测发现 QQ 每次调 getAppAccessToken 都会发新 token,旧的也不知道啥时候悄悄失效。干脆改成每次请求前现取。火焰告警一天也触发不了几次,多一次取 token 的往返对 Cat.1 来说毫无压力。结论:文档的有效期是上限不是保证,接口类的凭据,要么现取,要么做好失效重取。
坑 4:850019,“富媒体文件格式不支持”。 最刁钻的一个,单独说。同一个接口、同一套凭据,实拍照片上传被拒,换一张早前的旧照片就成功,HTTP 200。我按顺序排除:
- 是不是群权限问题?实时调接口核对:群在、机器人在群、发言权限全开——排除;
- 是不是文件结构问题?把两张图的 JPEG 段结构逐字节对比,DQT / DHT / SOF0 的数量和排布完全一致——排除;
- 把实拍照片用标准库重新编码一遍(像素不变,重建压缩数据流)再传——HTTP 200,过了。
到这里只能得出"压缩数据流里有脏东西"的结论,但脏在哪不知道。真正的根因是后来在 PC 上逐字节解析才挖出来的,过程挺有意思:
把实拍照片丢给 libjpeg 解码,报了一句 Corrupt JPEG data: 254 extraneous bytes before marker 0xd6。0xd6 是 RST6——JPEG 的重启标记。逐段解析之后真相大白:摄像头固件在 JPEG 头里声明了 DRI 段(每 40 个 MCU 一个重启标记),又在熵流里塞了 23 个 RSTn 标记;但这张 640×480 的图按 4:2:0 算总共只有 30 个 MCU,理论上一个 RST 都不该出现——这些全是摄像头固件多吐的垃圾字节。
更迷惑的是不同解码器对垃圾的态度完全不同:
| 解码器 | 对多余 RSTn 的态度 | 结果 |
|---|---|---|
| libjpeg / PIL | 宽容:跳过垃圾照样解 | 图能打开 → 我一直误以为"只是格式有点怪" |
| 重编码用的严格解码器 | 严格:直接报错中断 | 重编码失败 → 代码回退沿用原图 → QQ 收到的还是那份带垃圾的原图 → 850019 |
第二行就是"重编码逻辑明明在跑、传上去的却还是原图"的原因,也是这个 bug 藏了那么久的原因:宽松解码器能开图,会骗过你的眼睛。
修复也顺理成章:重编码之前先在字节层面"消毒"——把 DRI 段和熵流里的 RSTn 扫掉(注意 FF 00 这种合法的字节填充必须保留,不能误伤),再喂给解码器。用同一份解码器源码在 PC 上验证:原图解到 271/480 行报错,消毒后 480/480 行全过,重编码产物上传 QQ 返回 200。
这一段我的心得是:遇到"同一个接口有的图行有的图不行",老老实实做变量隔离,一张一张换图对比;遇到"宽松解码器能开、严格解码器报错",就去怀疑文件里有没有本不该存在的字节。 比到处换代码瞎试快得多。
第 6 步:以为修完了,连环坑才刚开始
850019 修完那天我以为收工了,结果才是开始。后面两天连着挖出三个问题,每一个都值得单独立传——因为它们有个共同点:全是"为修上一个问题而引入的补偿措施"或者"一直存在但被掩盖的设计缺陷",不报错、不崩溃,只会让效果一点点变差。
坑 5:画质被"优化"掉了两档。 排查"照片效果越来越差"的时候翻代码,发现分辨率被写死成了 320×240、JPEG 质量被压到 72——像素比 640×480 原图少了 75%。这两行是之前为"压传输量防 UART 丢帧"加的,但丢帧问题后来根治了,这个补偿却忘了撤。这就是"越优化效果越差"的真相:问题解决了,税还留着。 修法就是把画质恢复 640×480 + q85。恢复前我算过一笔账:全分辨率传输只要 1.15 秒,比缩放版多花 0.7 秒,换 4 倍像素,怎么算都划算。教训写进了我的注释规范:每一条补偿措施都要标清"防什么、何时可以撤",否则它就是一笔永久税。
坑 6:串图——两张照片互相覆盖的竞态。 这是最典型的"设计缺陷被低频使用掩盖"。我的原实现:收到完整照片 → 覆盖写到固定路径 fire_photo.jpg → 起后台线程从这个文件读出来传 QQ。问题在于 QQ 的 HTTPS 往返要 10~40 秒,而火焰持续燃烧时下一张照片 1~2 秒就来了——后台线程还没来得及读文件,worker 已经把下一张覆盖写进去了。结果就是:群里收到的图跟触发时刻对不上(张冠李戴),甚至收到写到一半的半张图——半张图 JPEG 头尾不全,又报 850019,跟上面的坑闭环了,你说气不气。修法很干脆:上传直接用内存里的 bytes,文件只用来留档取证。异步任务之间不共享固定路径文件,这条现在是我在模组上写多线程代码的铁律。
坑 7:板端 CRC 太慢,整片必丢。 这个坑的数字特别有说服力:我原来在 QuecPython 里用逐位法算 CRC16,实测 105.6ms 一片;而串口灌一片只要 89.8ms——处理速率跟不上占线速率,FIFO 必然堆积,丢片永远是 1024 的整数倍(丢的就是"正在算 CRC 时灌进来的那几片"),这个数量特征甚至能帮你反推原因。解法是查表法:预生成 256 项表,一片的 CRC 从 105.6ms 降到约 13ms,余量 7 倍,从此零丢片。在模组上用 Python 做校验 + 串口传大数据,务必先算"处理速率 vs 发送占线时间"这笔账,处理速度跑不赢数据到达速度,怎么调缓冲都白搭。
顺带还有个隐蔽的:接收线程有个看门狗负责自愈,重启读线程时如果旧线程没退干净就开新的,两个读者瓜分同一条 UART,帧会被撕成碎片。现在改成"旧线程没退出就放弃本次重启"——宁可链路停摆等人来修,也不造出双读者把数据撕碎。自愈逻辑本身也得有兜底,不然一次异常就是永久卡死。
现在的样子(截至发稿实测)
10 月 26 日晚,全链路验收通过。点火 → 火焰传感器触发 → QuecDuino 调度拍照 → 分帧回传 → 内存重组校验 → 4G 直连 QQ 官方接口 → 群里收到"检测到火焰!现场照片如下:"+ 640×480 清晰实拍,照片与触发时刻严格对应,连续多次触发无串图、无丢帧。
| 里程碑 | 状态 |
|---|---|
| 4G 拨号上网(Cat.1) | |
| 火焰触发 → APP 弹窗(60s 节流) | |
| AHT20 温湿度周期上报 | |
| 火焰 → 自动拍照 → 分帧回传 → 内存重组校验 | |
| 拍照节流 + 收图保护窗 + 线程自愈 | |
| 照片 base64 分块透传上云 | |
| 照片推送 QQ 群(4G 直连官方 API) |
写在最后
上篇我说,报警不该指望现场有没有网。这篇再补一句:报警也不该只有一声铃。
回过头看这整条链路:调度外设、解析协议、管理内存、算哈希、4G 拨号、MQTT 长连接、最后手写 TLS 直连公网 API——全部发生在一颗 Cat.1 模组上。这套东西按传统玩法,得"主控 MCU + 通信模块 + 后端中转服务"三方配合,现在 QuecDuino 用 QuecPython 一层全包了,改代码即生效,全程零编译。对我这种想快速把想法跑通的学生党来说,这个开发体验真的很顶。要说定位,它不太像一块"能联网的 MCU",更像一台装在芯片里的、随时在线的小型服务器。
接下来就是把装置封装成型,能摆进仓库长期跑。踩坑记录和代码我都留着,想看的同学评论区说一声。
两条小建议(接着上篇的反馈):
- EG800Z 固件系统时间冻在 1970,且 NTP/RTC 都写不进去。系统时间不对,所有要校验证书的 HTTPS 全都握不上手——网络栈都开放到能手写 TLS 了,时间同步这一环补上,体验会强非常多;
- QuecPython 在子线程里 import 深依赖会直接硬崩重启,表现像 USB 掉线,极其隐蔽。建议开发文档在显眼位置提示"主线程预 import + 设置子线程栈",能救不少人。
设备是官方体验计划提供的,文里的数据都是我一步步实测的。上篇没看过的朋友,从我主页进合集就能翻到。欢迎评论区交流。




