Eastron SDM Energy Monitor ========================== .. seo:: :description: Instructions for setting up SDM power monitors. :image: sdm220m.jpg :keywords: SDM220M, SDM220, SDM630 The ``sdm_meter`` sensor platform allows you to use Eastron SDM modbus energy monitors (`website `__) with ESPHome. .. figure:: images/sdm220m-full.png :align: center :width: 50.0% SDM220M Energy Monitor. The communication with this integration is done over a :ref:`UART bus ` using the :ref:`Modbus protocol ` over RS485 wiring. You will need an RS485 to UART converter for communication. 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: rx_pin: D1 tx_pin: D2 baud_rate: 9600 stop_bits: 1 sensor: - platform: sdm_meter phase_a: current: name: "SDM220M Current" voltage: name: "SDM220M Voltage" active_power: name: "SDM220M Power" power_factor: name: "SDM220M Power Factor" apparent_power: name: "SDM220M Apparent Power" reactive_power: name: "SDM220M Reactive Power" phase_angle: name: "SDM220M Phase Angle" frequency: name: "SDM220M Frequency" total_power: name: "SDM220M Total Power" import_active_energy: name: "SDM220M Import Active Energy" export_active_energy: name: "SDM220M Export Active Energy" import_reactive_energy: name: "SDM220M Import Reactive Energy" export_reactive_energy: name: "SDM220M Export Reactive Energy" update_interval: 60s Configuration variables: ------------------------ - **phase_a** (*Optional*): The group of exposed sensors for Phase A/1. - **current** (*Optional*): Use the current value of the sensor in amperes. All options from :ref:`Sensor `. - **voltage** (*Optional*): Use the voltage value of the sensor in volts (V). All options from :ref:`Sensor `. - **active_power** (*Optional*): Use the (active) power value of the sensor in watts (W). All options from :ref:`Sensor `. - **power_factor** (*Optional*): Use the power factor value of the sensor. All options from :ref:`Sensor `. - **apparent_power** (*Optional*): Use the apparent power value of the sensor in volt amps (VA). All options from :ref:`Sensor `. - **reactive_power** (*Optional*): Use the reactive power value of the sensor in volt amps reactive (VAR). All options from :ref:`Sensor `. - **phase_angle** (*Optional*): Use the phase angle value of the sensor in degrees (°). All options from :ref:`Sensor `. - **phase_b** (*Optional*): The group of exposed sensors for Phase B/2 on applicable meters. eg: SDM630 - All options from **phase_a** - **phase_c** (*Optional*): The group of exposed sensors for Phase C/3 on applicable meters. eg: SDM630 - All options from **phase_a** - **frequency** (*Optional*): Use the frequency value of the sensor in hertz. All options from :ref:`Sensor `. - **total_power** (*Optional*): Use the total power value of the sensor in watts (W). All options from :ref:`Sensor `. - **import_active_energy** (*Optional*): Use the import active energy value of the sensor in kilowatt hours (kWh). All options from :ref:`Sensor `. - **export_active_energy** (*Optional*): Use the export active energy value of the sensor in kilowatt hours (kWh). All options from :ref:`Sensor `. - **import_reactive_energy** (*Optional*): Use the import reactive energy value of the sensor in kilovolt amps reactive hours (kVArh). All options from :ref:`Sensor `. - **export_reactive_energy** (*Optional*): Use the export reactive energy value of the sensor in kilovolt amps reactive hours (kVArh). All options from :ref:`Sensor `. - **update_interval** (*Optional*, :ref:`config-time`): The interval to check the sensor. Defaults to ``60s``. - **address** (*Optional*, int): The address of the sensor if multiple sensors are attached to the same UART bus. You will need to set the address of each device manually. Defaults to ``1``. See Also -------- - :ref:`sensor-filters` - :apiref:`sdm220m/sdm220m.h` - :ghedit:`Edit`