基于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，默认波特率9600，8位数据位，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 4B，4GB内存版本。实际上采集这种低频数据，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加ECharts，Orbit OS省了我至少一周的开发时间。当然，如果你只是想快速验证PZEM-004T能不能读通，完全可以先用Python的pymodbus库写个几十行的脚本，不必一上来就上框架。

3. 核心细节解析与实操要点

3.1 PZEM-004T的寄存器地图与数据换算

要把PZEM-004T的数据读出来，必须搞清楚它的Modbus寄存器地址和每个寄存器里数据的含义。V3.0版本的寄存器定义大致如下（基于社区广泛验证的版本）：

注意电流、功率、电能都是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 XX

01地址，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模块的DI，RX接RO，GND共地。如果你用的是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', baudrate=9600, bytesize=8, parity='N', stopbits=1, timeout=0.3 ) def read_pzem(slave_id): result = {} # 读电压 0x0000, 1个寄存器 r = client.read_holding_registers(0x0000, 1, slave=slave_id) if r.isError(): return None result['voltage'] = r.registers[0] * 0.1 # 读电流 0x0001-0x0002, 2个寄存器 r = client.read_holding_registers(0x0001, 2, slave=slave_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, slave=slave_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, slave=slave_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 通信失败排查速查表

调试过程中遇到最多的问题就是读不到数据。我把常见现象和排查方向整理成表：

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，任何通信问题先用它验证。硬件层通了，再怀疑软件。这个顺序能帮你省下大量瞎猜的时间。