2019-10-20 19:23:59 +02:00
Peacefair PZEM-004T Energy Monitor
==================================
.. seo ::
2021-10-06 05:10:47 +02:00
:description: Instructions for setting up PZEM-004 and PZEM-004T V1 power monitors.
2021-11-16 03:19:33 +01:00
:image: pzem004t.svg
2021-10-06 05:10:47 +02:00
:keywords: PZEM-004T, PZEM-004
2019-10-20 19:23:59 +02:00
.. note ::
2021-08-29 13:10:40 +02:00
This page is incomplete and could use some work. If you want to contribute, please read the
2019-10-20 19:23:59 +02:00
:doc: `contributing guide </guides/contributing>` . This page is missing:
- An image for the front page.
- Images/screenshots/example configs of this device being used in action.
2021-10-06 05:10:47 +02:00
The `` pzem004t `` sensor platform allows you to use PZEM-004 (version with 8-segment screens, `website <https://www.instructables.com/Power-Peacefair-PZEM-004-ESP8266-Arduino-Nano/> `__ ) and PZEM-004T V1 energy monitors
2019-10-20 19:23:59 +02:00
(`website <https://innovatorsguru.com/ac-digital-multifunction-meter-using-pzem-004t/> `__ ) sensors with
ESPHome.
.. warning ::
2021-11-16 03:19:33 +01:00
This page refers to version V1 of the PZEM-004T, which has been out of stock for a while.
2021-10-06 05:10:47 +02:00
The PZEM-004, however, is still working (and selling) with this protocol and does not use modbus.
2019-10-20 19:23:59 +02:00
For using the newer V3 variant of this sensor please see :doc: `pzemac <pzemac>` .
2024-05-07 07:16:56 +02:00
The communication with this component is done via a :ref: `UART <uart>` .
2019-10-20 19:23:59 +02:00
You must therefore have a `` uart: `` entry in your configuration with both the TX and RX pins set
to some pins on your board and the baud rate set to 9600.
.. code-block :: yaml
# Example configuration entry
uart:
2019-10-31 20:12:53 +01:00
tx_pin: D1
2019-10-20 19:23:59 +02:00
rx_pin: D2
baud_rate: 9600
sensor:
2019-10-31 20:12:53 +01:00
- platform: pzem004t
2019-10-20 19:23:59 +02:00
current:
name: "PZEM-004T Current"
voltage:
name: "PZEM-004T Voltage"
power:
name: "PZEM-004T Power"
2020-05-29 00:53:08 +02:00
energy:
name: "PZEM-004T Energy"
2019-10-20 19:23:59 +02:00
update_interval: 60s
Configuration variables:
------------------------
- **current** (*Optional* ): Use the current value of the sensor in amperes. All options from
:ref: `Sensor <config-sensor>` .
- **power** (*Optional* ): Use the (active) power value of the sensor in watts. All options from
:ref: `Sensor <config-sensor>` .
- **voltage** (*Optional* ): Use the voltage value of the sensor in volts.
All options from :ref: `Sensor <config-sensor>` .
- **update_interval** (*Optional* , :ref: `config-time` ): The interval to check the
sensor. Defaults to `` 60s `` .
- **uart_id** (*Optional* , :ref: `config-id` ): Manually specify the ID of the :ref: `UART Component <uart>` if you want
to use multiple UART buses.
2021-10-06 05:10:47 +02:00
Hardware considerations:
------------------------
2021-11-16 03:19:33 +01:00
These devices have optocouplers on the UART port and the resistors mounted on the board have been designed to work with 5V devices.
ESPs need a `Level Shifter <https://www.adafruit.com/product/1875> `__ to be compatible with TTL levels.
2021-10-06 05:10:47 +02:00
.. note ::
You need a IC level shifter and not a `Mosfet-based <https://www.sparkfun.com/products/12009> `__ level shifter, because you need
to power the optocoupler's LEDs without an additional resistor in the path.
2021-11-16 03:19:33 +01:00
2021-10-06 05:10:47 +02:00
If prefer, you could change the value of the optocoupler's resistors by following `this <https://gregwareblog.wordpress.com/2020/12/13/home-power-monitoring-pzem-004/> `__ or `this <https://www.instructables.com/Power-Peacefair-PZEM-004-ESP8266-Arduino-Nano/> `__ guide.
Your ESP shall be powered by an external power supply and cannot be connected to the PZEM for power.
2019-10-20 19:23:59 +02:00
See Also
--------
- :ref: `sensor-filters`
- :doc: `pzemac`
- :doc: `pzemdc`
- :apiref: `pzem004t/pzem004t.h`
- :ghedit: `Edit`
