- 功能都跑通了,内存却只剩 7.7KB
- 堆只有 32KB 的时候,你才会认真对待每一个字节
前情提要
上一篇里,这块吃灰的 NodeMCU(ESP8266 / 4MB Flash)已经能自己开热点配网,连上路由器后还能用网页控制板载 LED。全程没打开 IDE,靠对话完成。
收尾时我留了一句:要不要接着加点东西?
这次加了三样:
- 4 路继电器控制,页面复用。
- OTA 升级:网页上传
.mpy 覆盖自身,不用每次插 USB。
- 开机 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:广播是条比想象中窄的路
设计
思路很朴素,有两条路:
- 板子开机时广播自己的 IP,你在它启动时就能收到。
- 板子常驻监听 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 页面:


附:这篇涉及的坑(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。想继续学习单片机与网络编程的同学,可以到 云栈社区 找相关资料。