找回密码
立即注册
搜索
发回帖 发新帖

5393

积分

0

好友

697

主题
发表于 5 小时前 | 查看: 16| 回复: 0
  • 功能都跑通了,内存却只剩 7.7KB
  • 堆只有 32KB 的时候,你才会认真对待每一个字节

前情提要

上一篇里,这块吃灰的 NodeMCU(ESP8266 / 4MB Flash)已经能自己开热点配网,连上路由器后还能用网页控制板载 LED。全程没打开 IDE,靠对话完成。

收尾时我留了一句:要不要接着加点东西?

这次加了三样:

  1. 4 路继电器控制,页面复用。
  2. OTA 升级:网页上传 .mpy 覆盖自身,不用每次插 USB。
  3. 开机 UDP 广播 IP,省得每次去串口日志里翻地址。

这三个功能本身都不复杂。难的是它们加在一起把内存撑爆了。这部分在第五节,也是本文最有价值的内容。


继电器:先保证它别乱动

引脚怎么选

四路继电器我选了 D1 / D2 / D5 / D6,对应 GPIO 5 / 4 / 14 / 12。

这不是随手挑的。ESP8266 有几个引脚在启动瞬间有特殊要求,接了负载可能直接起不来:

引脚 丝印 能不能用 原因
GPIO5 D1 ✅ 普通 IO,安全
GPIO4 D2 ✅ 普通 IO,安全
GPIO14 D5 ✅ 普通 IO,安全
GPIO12 D6 ✅ 普通 IO,安全
GPIO15 D8 ❌ 启动时必须为低,接继电器可能起不来
GPIO0 D3 ❌ 启动时必须为高,同上
GPIO2 D4 ❌ 板载 LED 占着
GPIO16 D0 ⚠️ 没有 PWM 和中断,特殊角色

引脚配置写在 config.py 里,想换随时改:

RELAY_PINS = (5, 4, 14, 12)
RELAY_ACTIVE_LOW = True  # 大多数带光耦的模块是低电平触发

接口设计

GET /api/relay?ch=1&state=on
GET /api/relay?ch=2&state=off
GET /api/relay?ch=3&state=toggle
GET /api/relay?ch=all&state=off     ← 一键全断

ch=all&state=off 不是为了方便,而是安全底线。一块板子控制多个负载时,必须有一个能立刻全停的入口。

返回内容保持极简,方便外部系统直接对接:

{"ok":true,"ch":2,"on":1}
{"ok":true,"relay":[0,1,0,0]}

容易被忽略的细节:上电别让继电器“啪”一下

大多数继电器模块是低电平触发,写 0 吸合。而 ESP8266 引脚在 Pin() 初始化之前的电平并不确定。

如果代码这样写:

pin = machine.Pin(p, machine.Pin.OUT)   # ← 这中间电平可能是低
pin.value(1)                            # 再设成"断开"

从构造到设值之间会有一个空窗期,继电器可能吸合几十毫秒再断开。听上去就是“啪”一声。如果接的是水泵或电机,这一下就可能出事。

正确的写法是在构造时就写入安全电平:

safe = 1 if config.RELAY_ACTIVE_LOW else 0
try:
    pin = machine.Pin(p, machine.Pin.OUT, value=safe)   # 构造即安全,没有空窗
except TypeError:
    pin = machine.Pin(p, machine.Pin.OUT)               # 老固件不支持 value
    pin.value(safe)

try/except 是给不支持 value 参数的固件留的后路,成本几乎为零。

必须放在最前面的一句话

ESP8266 的 IO 只能输出约 12mA,绝对不能直接驱动继电器线圈。

必须使用带光耦的继电器模块,或者外加三极管 / MOS 管驱动。继电器接的是 220V,弱电侧和强电侧要做隔离。

我把这句话写在了 config.py 注释的第一行,因为这是别人(包括三个月后的自己)最先打开的文件。

离线测试里最有价值的几条断言

[PASS] 上电全部断开
[PASS] 低电平触发: 断开时引脚=1
[PASS] 低电平触发: 吸合时引脚=0
[PASS] CH2 未受影响
[PASS] 越界返回 None

“上电全部断开”这一条尤其重要。它是安全属性,不是功能属性。功能坏了是麻烦,安全坏了是事故。


OTA:写文件不能用“先读进内存”的思路

为什么必须有 OTA

板子可能挂在墙上、锁在机柜里,或者藏在某个够不着的角落。每改一行代码都要爬上去插 USB,这时 OTA 就从“锦上添花”变成了“必须有”。

核心难点:文件不能进 RAM

先说结论:文件不能进 RAM。.mpy 有 9.7KB,而堆只剩十几 KB。如果这样写:

data = request.body          # 9.7KB 直接进内存
f = open(name, "wb")
f.write(data)

必然触发 MemoryError。所以只能边收边写盘:

def ota_receive(cl, rest, clen):
    """边收边写盘。全程只占 1KB buffer,不把文件读进内存"""
    got = len(rest)
    f = open(OTA_TMP, "wb")
    try:
        if rest:
            f.write(rest[:clen])
        cl.settimeout(10.0)
        while got < clen:
            chunk = cl.recv(1024)
            if not chunk:
                break
            f.write(chunk)
            got += len(chunk)
    finally:
        f.close()
    return got

不管文件是 400 字节还是 100KB,内存占用恒定为 1KB。这才是嵌入式该有的写法。

三道保险:OTA 写坏就是变砖

1. 白名单     只允许写 OTA_ALLOW 里列的文件        挡手滑传错
2. 魔数校验   首字节必须是 0x4D ('M')              挡传成图片/文本
3. 版本校验   文件头第 2 字节 == 固件 mpy 版本      挡别的版本编的字节码

还有一道兜底:先写 _ota.tmp,全部校验通过后才用 rename 覆盖。传输中途断了,也不会碰坏正在使用的文件。

还有一个坑:写完别急着重启

板子写完文件会立刻执行 machine.reset()。但这时响应可能还没发到客户端,从客户端看就是:

ConnectionResetError [WinError 10054] 远程主机强迫关闭了一个现有的连接

你会以为上传失败了,实际上已经成功。

解决办法是两边都改:

  • 板子侧:发完响应后延迟 1.5 秒再 reset()。
  • 客户端侧:把“连接中断”当作“可能成功”,然后主动探测 /api/status 确认。

改完之后,命令行工具能正常打出结果:

上传 -> http://192.168.1.142:80
  config.mpy   ok   397 bytes
  board.mpy    ok   200 bytes
  relay.mpy    ok   934 bytes
  pages.mpy    ok   524 bytes
  web.mpy      ok   9692 bytes
  main.py      ok   1221 bytes
完成。板子重启后访问 http://192.168.1.142/

六个文件全部通过 WiFi 更新成功,一个 USB 都没插。


一个 39 和一个 6

这是全文里栽得最冤的一次。

版本校验我是这么写的:

v = sys.implementation._mpy
if v > 0xFF:
    v >>= 8       # 我的想法:"版本号应该在'高位'吧"
return v

第一次 OTA,板子返回:

{"ok":false,"error":"mpy 版本 6, 固件要求 39"}

我的 .mpy 是 mpy-cross v1.29.0 编的,和固件版本严丝合缝,怎么会对不上?

那就去板子上读真实值:

_mpy = 9990
hex  = 0x2706

0x2706 拆开看:

  • 低字节 0x06 = 6,这才是 mpy 版本号。
  • 高字节 0x27 = 39,这是特性标志位(feature flags)。

版本号在低字节。我按 >> 8 取,自然取到了 39。

return sys.implementation._mpy & 0xFF   # 6,正确

这件事的教训

这类内部字段的编码方式,文档和记忆都不如在板子上 print 一次可靠。

我也没有停在“改对就行”。改完后加了两条断言,第二条是关键:

[PASS] 0x2706 解出 mpy 版本 6(不是 39)        ← 记住这次踩的坑
[PASS] mpy-cross 版本字节 == mpy_major()        ← 交叉验证

第二条的做法是:真的调用一次 mpy-cross 编出一个文件,读它的头字节,再和固件报告的值对比。两边对上才算通过。

这个思路值得推广:不要信任任何单方面的常量。固件说的版本不算数,编译器说的版本也不算数,两者对上才算数。


找 IP:广播是条比想象中窄的路

设计

思路很朴素,有两条路:

  1. 板子开机时广播自己的 IP,你在它启动时就能收到。
  2. 板子常驻监听 UDP 8266,收到 NODEMCU? 就单播回复自己的信息,所以板子早就在运行也能问出来。

应答内容如下:

{"host":"nodemcu","ip":"192.168.1.142","port":80,
"mac":"ec:fa:bc:12:df:bd","ver":"MicroPython 1.29.0"}

配套的查找工具:

$ python tools/find_board.py
本机地址: 100.168.56.50 172.16.10.2 192.168.0.124 192.168.1.121 ...
广播询问 x7,监听 2 秒 ...
  发现 192.168.1.142   nodemcu   MAC ec:fa:bc:12:df:bd   版本 MicroPython 1.29.0

共 1 台。浏览器打开: http://192.168.1.142/

但第一版找不到板子

写完一测,没有任何反应。

那就逐项验证。先用单播问一下:

s.sendto(b"NODEMCU?", ("192.168.1.142", 8266))
# 收到: {"host":"nodemcu","ip":"192.168.1.142",...}

单播秒回,广播石沉大海。

原因:广播只从一张网卡发出

查下来有点意思:这台机器有 8 个 IPv4 地址。

100.168.56.50  172.16.10.2  192.168.0.124  192.168.1.121
192.168.1.124  192.168.2.125  192.168.10.123  192.168.1.169

其中三个是 192.168.1.x。而 sendto("255.255.255.255") 只会从其中一张网卡发出,恰好不是通向板子的那张(.169)。

我甚至能看到自己发的包从 .124 那个接口反射回来:

--- 全局广播 ---
  收到: NODEMCU? from ('192.168.1.169', 8266)     ← 自己发的,回环
--- 子网广播 192.168.1.255 ---
  收到: NODEMCU? from ('192.168.1.124', 8266)     ← 从另一张网卡出去的

解法:能快就快,快不了就用最笨的办法

最终逻辑分三段:

1. 向 全局广播 + 每个本地网段的定向广播(x.x.x.255) 各发一次     ← 快
2. 没结果?对每个本地 /24 网段逐个 IP 单播询问(254 个包)      ← 稳
3. 收到了就把 IP、端口、MAC、固件版本一起打印

254 个 UDP 包对网络几乎没有压力,几百毫秒就发完。能用广播就用广播,广播不通就用扫描兜底。

这类工具的正确姿势就是不要指望一条路一定通。

顺手加个参数,方便接入管道:

$ python tools/find_board.py --ip-only
192.168.1.142

$ python tools/ota_upload.py --all --ip $(python tools/find_board.py --ip-only)

这里还有个“坑外坑”:这台机器上设了 http_proxy,curl http://192.168.x.x 会先去问代理,代理回 502 upstream connect failed。看起来像板子挂了,其实请求根本没到板子。curl 要加 --noproxy '*',Python 要用 build_opener(ProxyHandler({}))。排查内网设备时,先确认你的请求真的发出去了。


内存地狱第二季:free 从 19K 掉到 7.7K

前面四项都算顺利,真正折磨我的是这一节。

症状:API 全通,页面全崩

三样功能写完部署上去,串口输出一切正常:

[RELAY] 4 ch on (5, 4, 14, 12)  active_low=True
[UDP] announce x2  192.168.1.142:80
[HTTP] ready ->  http://192.168.1.142/

然后开始测试:

=== 首页 ===       http=000  bytes=0  耗时=0.10s     ← 挂了
=== 继电器 on ===  {"ok":true,"ch":1,"on":1}        ← 好的
=== status ===     {"mem":8752, ...}                ← 好的

小的 JSON 响应全部正常,两个 HTML 页面却是 0 字节、0.1 秒就断开。

0.1 秒说明不是超时,而是服务端直接抛出异常并关闭了连接。

接着我注意到 status 里的数字:mem: 8752。上一次测试时,这个数字是 19136。整整少了 10KB。

为什么模块体积就是内存上限

这里有一个 MicroPython 在 ESP8266 上的关键事实,值得记进笔记:

.mpy 不是内存映射执行的,而是从 flash 读进 RAM 再运行的。

也就是说,你 import 的所有模块,体积都会直接占用堆。这不是加载时临时用一下,而是常驻。

算一下账,完全对得上:

阶段 模块合计 free
最早 4 个模块 12.2 KB ~19 KB
加完三样功能 18.1 KB 8.7 KB
模板/CSS 外置后 11.7 KB 15.5 KB

32KB 的堆,模块吃掉 18KB,剩下 14KB 还要渲染 2.5KB 的页面(渲染时会有 2~3 份临时副本)。崩溃是必然的。

解法:只让“必须常驻”的东西留在模块里

思路很直接,一共三处改动。

① 三个页面模板 → 独立的 .tpl 文件,用到才读

原来 pages.py 里放着三个大字符串(控制台、配网、升级页),合计 5.4KB。import 时就占掉 5.4KB,一次没用过也照样占着。

改成按需读文件:

def render_file(name, mapping):
    """读模板 -> 替换占位符 -> 返回 bytes。返回后模板字符串可被回收"""
    f = open(TPL_DIR + name)
    try:
        tpl = f.read()
    finally:
        f.close()
    for k, v in mapping.items():
        tpl = tpl.replace("{{" + k + "}}", v)
    body = tpl.encode()
    del tpl          # ← 明确释放,别等 GC
    return body

改完后,pages.mpy 从 6502 字节降到 524 字节。

② CSS → 独立文件,流式发送

原来 CSS 也是模块里的字符串(1973 字节),每次渲染还要 replace 一份进页面,等于双倍占用。

现在页面里只有一行:

<link rel="stylesheet" href="/s.css">

服务端收到请求后分块读取文件并发送,全程只占 512 字节 buffer:

def send_file(cl, path, ctype):
    size = os.stat(path)[6]
    send_all(cl, ("HTTP/1.1 200 OK\r
Content-Type: %s\r
"
                  "Content-Length: %d\r
Cache-Control: max-age=86400\r
\r
"
                  % (ctype, size)).encode())
    f = open(path, "rb")
    try:
        while True:
            chunk = f.read(512)
            if not chunk:
                break
            send_all(cl, chunk)
    finally:
        f.close()

顺带的好处是 Cache-Control: max-age=86400:浏览器缓存一天,第二次访问连 CSS 都不用再发。

③ 继电器按钮用 JS 动态生成

4 个按钮如果写成静态 HTML,就是 4 段重复的 markup。改成循环生成:

for (var i = 1; i <= RC; i++) {
  var e = document.createElement('button');
  e.id = 'r' + i; e.textContent = 'CH' + i;
  e.onclick = (function (n) { return function () { relay(n) } })(i);
  b.appendChild(e);
}

HTML 里只留一个空容器:<div id="rb"></div>。

三项改完,模块从 18.1KB 降到 11.7KB,free 从 7776 回到 15536,直接翻倍。

一个反直觉的发现

改完之后第一次访问首页,要 7.1 秒,第二次只要 0.15 秒。

我一开始以为引入文件读取把性能搞坏了,差点想回退。其实不是。第一次是冷启动后首次读取 flash 里的模板文件,之后文件系统缓存生效就快了。

用 7 秒的冷启动延迟换回 8KB 内存,这笔交易非常划算。

在只有 32KB 堆的芯片上,用 flash 换 RAM 几乎永远是正确的交易。flash 有 4MB,堆只有 32KB。


一个调试技巧:单进程时序探针

排查 OTA 时,我遇到过一件很迷惑的事:串口里完全看不到 OTA 的日志。

我以为板子卡死了,查了半天。真相是:serial_monitor.py 和发请求的脚本是两个进程,时序对不上。我启动监视器 3 秒后发请求,但监视器那时可能还没真正就绪。等它就绪时,请求已经发完,板子也已经重启了。

于是我写了个小工具,在一个进程里同时开串口读线程和发送逻辑:

th = threading.Thread(target=reader, daemon=True)   # 读串口
th.start()
time.sleep(2.0)

s = socket.create_connection((ip, 80), timeout=8)   # 发请求
s.sendall(req)

日志立刻完整了:

[HTTP] POST /ota?file=web.mpy  free=14880
>>> RESP: HTTP/1.1 200 OK ... {"ok":true,"file":"web.mpy","bytes":9703,...}
[OTA] web.mpy updated  9703 bytes

当串口日志和预期不符时,先怀疑“看日志的方式”,再怀疑板子。


现在它长这样

项目 数值
模块体积 源码 28.4KB → 字节码 11.7KB
空闲内存 13.5 ~ 17.4 KB
首页 / OTA 页 / CSS 2514 B / 1868 B / 1967 B
页面响应 0.15 秒(冷启动首次 7.1 秒)
连续 10 次 API 全部 200
离线测试 126 项断言全绿
完整 OTA 6 个文件走 WiFi 更新,全部成功

三样功能的最终形态:

GET  /api/relay?ch=1&state=on|off|toggle    继电器(ch=all 全控)
GET  /ota  +  POST /ota?file=web.mpy        WiFi 升级
python tools/find_board.py                  找 IP(广播 + 扫描兜底)

这一版和上一版最大的区别,不是多了三个功能,而是内存从 8.7KB 回到了 15KB。

如果照着“页面写在代码里”的惯性写下去,板子也能跑,直到某次 OTA 偶发失败、某次页面返回 500,然后你花一晚上怀疑网络。

下面是现在的 Web 页面:

NodeMCU 控制台主页:板载 LED、四路继电器与运行状态

ESP8266 OTA 固件升级页面:选择 .mpy 文件并上传重启


附:这篇涉及的坑(6 个)

# 现象 真正原因 解法
1 API 全正常,HTML 页面 0 字节 0.1 秒断开 模块体积吃光堆(.mpy 读进 RAM 常驻) 模板/CSS 外置成文件,按需读取
2 OTA 拒收正确的 .mpy,提示“固件要求 39” _mpy 版本号在低字节,高字节是特性位 & 0xFF,并用编译产物头交叉验证
3 OTA 成功但客户端看到“连接被重置” 板子写完立刻重启,响应还没发完 板子延迟 1.5s 再 reset,客户端容错探测
4 内网设备全部返回 502 upstream connect failed curl/urllib 走了 http_proxy --noproxy '*' / ProxyHandler({})
5 广播找不到板子,单播能通 多网卡,广播只从其中一张发出 广播 + 全网段单播扫描兜底
6 串口看不到任何日志 监视器和发请求是两个进程,时序错位 单进程内同时开读线程和发送

前一篇的五个坑(复位时序、双波特率、bytes 没有 partition、send() 部分发送、CSS 里的 %)这里不再重复,详见连载第一篇:《一句话,让 AI 把一块 ESP8266 从头调到能上网》。

本文所有数据、日志、报错均来自真实硬件调试:ESP8266EX / 4MB Flash / CP210x,固件 MicroPython v1.29.0。想继续学习单片机与网络编程的同学,可以到 云栈社区 找相关资料。




上一篇:Lombok 与 MyBatis、EasyExcel 的两个属性映射坑
下一篇:ESP8266 微信小程序局域网控制与发布避坑实战
您需要登录后才可以回帖 登录 | 立即注册

关闭

站长推荐上一条 /1 下一条

手机版|小黑屋|网站地图|云栈社区 ( 苏ICP备2022046150号-2 )

GMT+8, 2026-11-21 11:20 , Processed in 0.103380 second(s), 40 queries , Gzip On.

Powered by Discuz! X3.5

© 2025-2026 云栈社区.

快速回复 返回顶部 返回列表