基于PZEM-004T与Raspberry Pi的Modbus RTU全屋能源监测系统实战

1. 从一块小板子说起为什么我要做这个能源监测项目去年夏天家里电费单子突然涨了一截我盯着那张纸看了半天心里犯嘀咕到底是空调太费电还是那台老冰箱在偷偷吃电市面上带分项计量的智能电表要么贵得离谱要么数据锁在厂商云里想拿原始数据做点自己的分析根本不可能。于是我就琢磨能不能用一块几十块钱的模块自己搭一套能看实时功率、电压、电流、累计电量的监测系统。这个念头落地之后核心器件很快就定了PZEM-004T。这是一款基于计量芯片的交流电参数采集模块能测电压、电流、有功功率、电能累计还带一路UART串口输出走的是Modbus RTU协议。价格便宜、资料多、接口简单几乎是DIY能源监测的入门标配。但一块PZEM-004T只能测一路负载我要的是全屋多路监测还要有历史曲线、远程查看、异常告警。所以标题里那个Full Energy Monitor才是真正的目标——从单模块到完整系统。整套系统的骨架是这样的多块PZEM-004T分别挂在不同的回路上通过RS485总线并联由一台Raspberry Pi作为主控轮询采集数据落库之后再用一个轻量级的Web界面展示。软件层我选了一个叫Orbit OS的框架来搭数据采集与展示的底座它本身对传感器数据流和Modbus设备有不错的支持省去了我从零写调度和前端的时间。下面我就把这套东西从选型、接线、协议调试到软件集成的完整过程拆开讲踩过的坑也一并奉上。如果你也在考虑做家庭或小型工坊的用电监测或者手头正好有PZEM-004T不知道怎么把它变成一套能用的系统这篇内容应该能帮你少走不少弯路。哪怕你只是想搞懂Modbus RTU和UART到底怎么配合工作里面的调试细节也值得一看。2. 整体方案设计与选型思路拆解2.1 为什么是PZEM-004T而不是其他计量方案市面上做交流计量的方案大致分三类。第一类是专用电能计量芯片比如HLW8032、BL0937这类便宜但需要自己设计外围电路、自己做隔离、自己写驱动对非电子专业的人来说门槛不低。第二类是成品智能插座或电表数据封闭改造成本高。第三类就是PZEM-004T这种模块化产品它把计量芯片、采样电路、隔离、串口输出全部集成在一块小板上你只需要给它供5V电、把被测线路穿过它的电流互感器就能通过串口读到结构化数据。我选它的理由很实在开箱即用的Modbus RTU接口。这意味着我不需要碰模拟电路不需要校准拿到手接上线就能读寄存器。而且它的寄存器地址和报文格式在社区里被扒得很透调试起来有大量参考。PZEM-004T有几个版本早期V1.0和后来的V3.0在寄存器定义和接线方式上有差异V3.0把电压和电流的测量范围做了扩展还支持修改Modbus从站地址和波特率。我手上用的是V3.0默认地址0x01默认波特率96008位数据位1位停止位无校验。这里要提醒一句PZEM-004T的电流测量依赖外置的电流互感器CT不同量程的CT对应不同的电流上限。我买的是100A量程的版本CT孔径大概能穿过10平方毫米的线。如果你要测的是单路大功率设备选100A如果是分路小负载可以考虑10A或20A的版本精度会更好。量程选大了小电流下的相对误差会明显一些这是所有CT方案的共性。2.2 为什么用Raspberry Pi做主控而不是单片机主控的选择上我纠结过一阵。用STM32或者ESP32当然可以成本更低功耗更小。但我这套系统需要同时做几件事轮询多路Modbus设备、把数据写进时序数据库、跑一个Web服务、还要能远程访问。这些事情堆在一起单片机的资源就紧张了尤其是Web服务和数据库这两块在MCU上做起来非常别扭。Raspberry Pi的优势在于它是一台完整的Linux机器。我可以直接用Python写采集脚本用SQLite或InfluxDB存数据用Flask或Node.js起Web服务所有东西都在一个进程模型里协调。而且Pi的UART资源可以通过USB转串口扩展想接多少路RS485总线都行。功耗方面一台Pi 4常年运行大概3到5瓦一年电费也就几十块完全可以接受。我用的是Raspberry Pi 4B4GB内存版本。实际上采集这种低频数据Pi 3B甚至Pi Zero 2 W都够用但Pi 4在跑Web界面和数据库时更从容。系统装的是64位Lite版没有桌面环境省资源。2.3 RS485总线拓扑与Modbus RTU的角色分工多块PZEM-004T要接到同一个主控上最合理的物理层方案是RS485总线。RS485是差分信号抗干扰能力强支持多点挂载一条总线理论上可以挂32个甚至更多节点取决于收发器驱动能力。PZEM-004T的串口输出是TTL电平的UART要上RS485总线需要加一个TTL转RS485的模块比如常见的MAX485芯片方案。这里要理清一个概念UART是物理层和数据链路层的一部分Modbus RTU是应用层的协议。PZEM-004T输出的是UART信号上面跑的是Modbus RTU报文。UART负责把字节一位一位地发出去Modbus RTU负责定义这些字节怎么组织成有意义的请求和响应。RS485则是把UART的TTL电平转换成差分信号让多个设备能共享一条线。总线的接法是手拉手串联不是星型。所有设备的A接A、B接B主控端的RS485模块也并上去。总线两端各加一个120欧姆的终端电阻抑制信号反射。我一开始没加终端电阻短距离1米以内勉强能用但线一拉长到5米以上就开始出现丢包和CRC错误。加上终端电阻之后20米的双绞线跑9600波特率非常稳。2.4 Orbit OS在系统中的定位Orbit OS这个名字可能有些人不太熟它本质上是一个面向物联网数据采集和可视化的轻量级框架支持通过插件方式接入各种传感器和Modbus设备内置了数据流调度、存储适配和Web仪表盘。我选它是因为不想重复造轮子——采集调度、数据缓存、前端图表这些它都有现成组件我只需要把PZEM-004T的Modbus寄存器映射配置进去就行。它在整个系统里扮演的是数据中枢的角色向下通过串口或网络轮询Modbus设备向上提供API和可视化界面。相比自己从零写一套Flask加EChartsOrbit OS省了我至少一周的开发时间。当然如果你只是想快速验证PZEM-004T能不能读通完全可以先用Python的pymodbus库写个几十行的脚本不必一上来就上框架。3. 核心细节解析与实操要点3.1 PZEM-004T的寄存器地图与数据换算要把PZEM-004T的数据读出来必须搞清楚它的Modbus寄存器地址和每个寄存器里数据的含义。V3.0版本的寄存器定义大致如下基于社区广泛验证的版本寄存器地址含义数据类型换算系数单位0x0000电压16位无符号0.1V0x0001电流低16位16位无符号0.001A0x0002电流高16位16位无符号0.001A0x0003功率低16位16位无符号0.1W0x0004功率高16位16位无符号0.1W0x0005电能低16位16位无符号0.001kWh0x0006电能高16位16位无符号0.001kWh0x0007报警状态16位无符号--注意电流、功率、电能都是32位数据拆成两个16位寄存器存放低16位在前高16位在后。读取的时候要把两个寄存器拼起来。比如电流的原始值是0x0002和0x0001两个寄存器实际值等于 (高16位 16 | 低16位) * 0.001 安培。电压是16位直接读0x0000乘以0.1就是伏特。功率同理32位拼接后乘以0.1得到瓦特。电能是累计值拼接后乘以0.001得到千瓦时。这里有个容易踩的坑不同批次的PZEM-004T固件版本可能寄存器定义有细微差异。我手上这块读0x0000得到的是电压但有个朋友买的版本读出来是别的值。所以第一次调试时建议先用Modbus调试工具逐个寄存器读一遍对照实际电压电流验证确认映射关系再写代码。3.2 Modbus RTU报文结构与CRC校验Modbus RTU的报文格式很紧凑一次请求大概8个字节响应根据数据长度变化。以读取电压为例主站发给从站地址0x01的请求报文是01 03 00 00 00 01 84 0A拆开看01是从站地址03是功能码读保持寄存器00 00是起始寄存器地址00 01是读取寄存器数量84 0A是CRC校验。从站响应01 03 02 08 98 XX XX01地址03功能码02表示后面有2个字节数据08 98是电压原始值0x0898即2200乘以0.1就是220.0V最后两字节是CRC。CRC校验是Modbus RTU调试中最容易出问题的地方。它的计算方式是对报文前面所有字节做CRC-16/MODBUS运算得到16位结果低字节在前高字节在后。很多人手算或者用错多项式导致报文发出去从站不响应。我的建议是直接用现成库算Python里pymodbus或者crcmod都能算不要自己手写。调试阶段我强烈建议用Modbus Poll这类上位机工具先跑通。把USB转RS485模块插到电脑上打开Modbus Poll设置好串口参数9600, 8, N, 1新建一个读保持寄存器的任务地址0x0000数量7从站ID 1。如果接线正确、参数正确应该能立刻看到数据刷新。这一步能通说明硬件和协议层没问题再去写代码就事半功倍。3.3 UART参数匹配与RS485方向控制UART通信有几个参数必须两端一致波特率、数据位、停止位、校验位。PZEM-004T默认是9600波特率、8数据位、1停止位、无校验。如果你改了模块的波特率可以通过Modbus写寄存器修改主控端也要同步改。RS485是半双工总线同一时刻只能有一个设备发送。TTL转RS485模块需要一个方向控制信号通常叫DE/RE发送时拉高接收时拉低。有些USB转RS485模块自动处理方向不需要额外控制但如果你是用Pi的GPIO接MAX485芯片就需要在代码里手动控制这个引脚。我用的是USB转RS485模块芯片是FT231X。这里插一句FT231X和FT232R都是常见的USB转串口芯片在Linux下一般免驱但有些精简版系统可能需要手动装驱动。Raspberry Pi OS默认带了ftdi_sio驱动插上就能识别成/dev/ttyUSB0。如果你插上没反应用dmesg | tail看一下内核日志确认设备有没有被识别。UART通信还有一个隐蔽的坑阻塞和非阻塞模式。Python的pyserial默认是阻塞读设了timeout之后读不到数据会等超时再返回。在轮询多路Modbus设备时如果某一路设备掉线阻塞读会卡住整个轮询循环。我的做法是给每次读取设一个较短的超时比如0.3秒超时就跳过该设备记录一次通信失败继续轮询下一路。这样单点故障不会拖垮整个系统。3.4 多设备寻址与轮询策略一条RS485总线上挂多块PZEM-004T每块必须有不同的从站地址。出厂默认都是0x01所以第一件事就是改地址。改地址的方法是发一条写寄存器的Modbus报文把地址写到指定寄存器。PZEM-004T V3.0的地址寄存器是0x0002写操作具体操作是先只接一块模块发写命令改地址改完拔下来再接下一块改避免地址冲突。轮询策略上我一开始是顺序轮询每块设备读一次间隔100毫秒。后来发现如果设备多了一轮下来要好几秒实时性不够。优化之后改成电压电流功率这些快变量每轮都读电能累计值这种慢变量每隔几轮读一次。因为电能是累计值不会突变读太频繁没意义。这样一轮快变量轮询可以压缩到几百毫秒实时曲线看起来就流畅多了。注意Modbus RTU总线上两次通信之间要留足够的静默间隔至少3.5个字符时间。9600波特率下一个字符约1毫秒3.5个字符就是3.5毫秒。实际用的时候留10毫秒以上比较稳妥尤其是总线上设备多、线缆长的情况。4. 实操过程与核心环节实现4.1 硬件接线与供电先说接线。PZEM-004T的接线分两部分强电侧和弱电侧。强电侧是电压测量输入端和电流互感器。电压输入直接并联在被测回路的火线和零线上电流互感器套在火线上。注意CT是有方向的上面有个箭头箭头方向要和电流流向一致装反了读出来的功率会是负的或者不对。弱电侧是5V供电和UART输出。PZEM-004T需要5V供电可以从Pi的5V引脚取也可以单独供。UART的TX接RS485模块的DIRX接ROGND共地。如果你用的是TTL转RS485模块还要接DE/RE方向控制或者选自动方向的模块省事。我实际的做法是在配电箱里装了一块DIN导轨式的5V电源给所有PZEM-004T供电。RS485总线用双绞线网线拆出来的对绞线就行从配电箱拉到Pi的位置。Pi放在书架上通过USB转RS485模块接入总线。这样强电和弱电物理隔离安全也整洁。提示强电操作有风险如果你对配电箱不熟建议找电工帮忙接线或者先用一个插线板做实验把PZEM-004T接在插线板进线上测单个电器的功率验证通了再上配电箱。4.2 Raspberry Pi环境准备与串口配置Pi这边第一步是装系统、联网、更新。我用的是Raspberry Pi OS Lite 64位烧录到SD卡后启动通过SSH登录。然后装Python环境和必要的库sudo apt update sudo apt install python3-pip python3-serial pip3 install pymodbus pyserial如果你打算用Orbit OS它有自己的安装方式一般是拉取它的安装脚本或者Docker镜像。我这边是先用pymodbus把采集逻辑跑通确认数据没问题再把采集脚本接入Orbit OS的数据源配置。串口权限方面普通用户默认没有/dev/ttyUSB0的读写权限。把用户加到dialout组sudo usermod -a -G dialout $USER然后重新登录生效。这一步不做的话跑脚本会报Permission denied。4.3 用Python读取PZEM-004T的完整代码下面是我实际用的采集脚本核心部分基于pymodbus。先看单次读取的实现from pymodbus.client import ModbusSerialClient import struct client ModbusSerialClient( port/dev/ttyUSB0, baudrate9600, bytesize8, parityN, stopbits1, timeout0.3 ) def read_pzem(slave_id): result {} # 读电压 0x0000, 1个寄存器 r client.read_holding_registers(0x0000, 1, slaveslave_id) if r.isError(): return None result[voltage] r.registers[0] * 0.1 # 读电流 0x0001-0x0002, 2个寄存器 r client.read_holding_registers(0x0001, 2, slaveslave_id) if r.isError(): return None current_raw (r.registers[1] 16) | r.registers[0] result[current] current_raw * 0.001 # 读功率 0x0003-0x0004 r client.read_holding_registers(0x0003, 2, slaveslave_id) if r.isError(): return None power_raw (r.registers[1] 16) | r.registers[0] result[power] power_raw * 0.1 # 读电能 0x0005-0x0006 r client.read_holding_registers(0x0005, 2, slaveslave_id) if r.isError(): return None energy_raw (r.registers[1] 16) | r.registers[0] result[energy] energy_raw * 0.001 return result这段代码里每次读都判断了isError()出错就返回None上层轮询逻辑会跳过这个设备。slave参数指定从站地址。注意pymodbus不同版本的API有差异2.x和3.x的read_holding_registers参数名可能不同我用的3.x版本是slave老版本可能是unit。轮询多设备的逻辑import time devices [1, 2, 3, 4] # 四块PZEM的地址 while True: for addr in devices: data read_pzem(addr) if data: print(f设备{addr}: {data}) # 这里写入数据库或发给Orbit OS else: print(f设备{addr}: 通信失败) time.sleep(0.05) time.sleep(1)每块设备之间留50毫秒间隔一轮四块大概200多毫秒加上1秒的循环间隔数据刷新率足够看实时曲线了。4.4 数据落库与Orbit OS接入数据读出来之后要存起来才能看历史曲线。我用的是SQLite轻量、免配置、单文件适合Pi这种资源有限的设备。建一张表CREATE TABLE energy_data ( id INTEGER PRIMARY KEY AUTOINCREMENT, device_id INTEGER, timestamp DATETIME DEFAULT CURRENT_TIMESTAMP, voltage REAL, current REAL, power REAL, energy REAL );每次采集到数据就插一条。数据量大了之后比如每秒一条一天8万多条查询会变慢可以加索引或者定期归档。我实际是每5秒存一条一天1.7万条SQLite完全扛得住。Orbit OS的接入方式取决于它的数据源插件机制。一般是在它的配置文件里定义一个Modbus数据源指定串口、波特率、从站列表和寄存器映射然后它自己会去轮询。我因为已经有Python脚本在跑了就直接把数据通过它的HTTP API推过去或者写一个自定义插件读取我的SQLite。两种方式都行看你的Orbit OS版本支持哪种。4.5 前端展示与告警配置Orbit OS自带仪表盘功能可以配置实时数值卡片、历史曲线图、状态指示灯。我把四路设备的功率做成四条曲线叠在一张图上一眼就能看出哪个回路在耗电。电压做成单值卡片电流和功率做成柱状图对比。告警方面我设了两个规则一是单路功率超过设定阈值比如空调回路超过2000W持续5分钟发通知二是电压低于200V或高于240V立即告警。Orbit OS支持Webhook通知我接到了自己的消息机器人上出门在外也能知道家里用电异常。如果你不用Orbit OS用Grafana加InfluxDB也是经典组合效果类似只是配置工作量大一些。Orbit OS的优势在于它对Modbus设备的支持是内置的省去了写Telegraf配置的麻烦。5. 常见问题与排查技巧实录5.1 通信失败排查速查表调试过程中遇到最多的问题就是读不到数据。我把常见现象和排查方向整理成表现象可能原因排查方法完全无响应接线错误、供电不足检查A/B是否接反量5V供电偶尔响应偶尔超时终端电阻缺失、线太长加120欧姆终端电阻缩短线缆CRC错误频繁波特率不匹配、干扰确认两端波特率一致远离强电干扰源读到的值明显不对寄存器映射错误、CT方向反对照实际电压验证检查CT箭头方向多设备时只有一块能读从站地址冲突逐块单独接确认地址唯一Pi上Permission denied用户不在dialout组加组后重新登录5.2 那些文档里不会写的坑第一个坑是PZEM-004T的供电和测量不能共地。如果你用Pi的5V给PZEM供电同时RS485又和Pi共地而PZEM的电压测量输入端接了市电就可能形成地环路轻则数据跳动重则烧模块。我的做法是PZEM用独立的隔离电源供电RS485总线用光耦或者磁耦隔离模块彻底断开地环路。这个钱不能省。第二个坑是CT互感器的相位问题。PZEM-004T测的是有功功率如果CT装的位置或者方向不对读出来的功率会偏小甚至为负。尤其是测那种功率因数很低的负载比如空载的电机功率读数会很难看。这不是模块坏了是测量原理决定的。测阻性负载电热器、白炽灯验证一下如果读数正常说明模块没问题。第三个坑是Modbus轮询频率和SD卡寿命。Pi用SD卡做存储频繁写数据库会加速SD卡磨损。我一开始每秒写一次三个月后SD卡就出坏块了。后来改成每5秒写一次并且把数据库放在外接USB硬盘或者用内存文件系统做缓存定期刷盘。如果你长期跑建议用SSD或者把数据写到网络存储。第四个坑是Orbit OS的Modbus插件对32位数据的处理。有些框架默认按16位读寄存器读32位数据需要配置成32位大端或32位小端模式。PZEM-004T是低字在前属于小端模式。如果配置错了读出来的功率会是天文数字或者零。这个在Orbit OS的设备配置里要仔细选。5.3 精度校准与长期稳定性PZEM-004T出厂有校准但便宜模块的精度一致性一般。我用一个已知功率的电热器标称1500W做参考读出来1480W左右误差约1.3%在可接受范围内。如果你需要更高精度可以在软件里加一个校准系数把读数乘以一个修正值。长期稳定性方面我连续跑了半年多电压读数一直很稳和万用表对比误差在1V以内。电流在小电流段低于0.5A误差会大一些这是CT方案的固有特性。如果你要测待机功耗这种小电流建议选小量程CT的版本或者用专门的微电流计量模块。温度对精度也有影响。夏天配电箱里温度能到50度以上PZEM-004T的读数会有轻微漂移。如果对精度要求高尽量把模块装在通风好的位置或者选工业级的计量模块。5.4 系统扩展方向这套系统跑通之后扩展空间很大。我后来加了几个方向一是把数据同步到手机端用Orbit OS的移动端页面随时看二是加了继电器控制功率超限自动切断非关键回路三是把电能数据按天、按周汇总生成用电报告找出耗电大户。如果你也想做类似的扩展建议先把基础采集跑稳数据准确了再往上加功能。我见过不少人一上来就搞大而全结果采集层不稳定上层做得再花哨也没用。能源监测这件事数据可信是第一位的。最后分享一个我在调试Modbus时的小习惯手边常备一个USB转RS485模块和Modbus Poll任何通信问题先用它验证。硬件层通了再怀疑软件。这个顺序能帮你省下大量瞎猜的时间。