devices.esphome.io

Shelly 3EM

Shelly 3EM

Device Type: sensor
Electrical Standard: euukus
Board: esp8266

Shelly 3EM

NOTE: In order to power up device it's enough to connect VA and N terminal. NOTE: In order to retrieve proper data all live (VA/VB/VC) terminals needs to be connected to live wire, in other case this integration will report invalid voltage (like 0.12130 V). Check single phase connection diagram in the official device manual for more details.

GPIO Pinout

PinFunction
GPIO02LED (lower)
GPIO04button (lower LED)
GPIO05ADE7880 IRQ1
GPIO12I2C SDA
GPIO13ADE7880 IRQ0
GPIO14I2C SCL
GPIO15Contactor Control
GPIO16ADE7880 RESET

Note: The upper LED is not connected to a GPIO (it is connected to the ADE7880) so it cannot be used as a normal ESPHome output.

Calibration Data

It is critically important to retrieve the calbration data from the 3EM device before installing ESPHome onto it; without that data, it will not be possible to get accurate sensor readings. You will need to power up the device and let it connect to your network using the preloaded Shelly firmware in order to retrieve this data. If you've already converted the device to Tasmota and want to switch to ESPHome, you'll have the calibration data and can skip steps 1-2 of the instructions below.

  1. Ensure that you are able to access the device's web interface (http://ip.address.of.device).

  2. Download the calibration data file from http://ip.address.of.device/calib.dat. The file will look similar to this:

{
  "state": 0,
  "rms": {
    "current_a": 3149413,
    "current_b": 3155641,
    "current_c": 3177848,
    "current_n": -1377304018,
    "current_s": 1804948,
    "voltage_a": -746938,
    "voltage_b": -735960,
    "voltage_c": -753583
  },
  "angles": {
    "angle0": 168,
    "angle1": 184,
    "angle2": 176
  },
  "powers": {
    "totactive": {
      "a": -1346104,
      "b": -1347476,
      "c": -1352863
    },
    "apparent": {
      "a": 220798,
      "b": 220791,
      "c": 220791
    }
  },
  "energies": {
    "totactive": {
      "a": 8986,
      "b": 8985,
      "c": 8985
    },
    "apparent": {
      "a": 41655,
      "b": 41660,
      "c": 41676
    }
  }
}

  1. The current_X values from the rms section will go into the calibration -> current_gain entries in your configuration. Use the current_s value for the neutral phase, if you are enabling that phase's current sensor.

  2. The voltage_X values from the rms section will go into the calibration -> voltage_gain entries in your configuration.

  3. The totactive values from the powers section will go into the calibration -> power_gain entries in your configuration.

  4. The angleN values from the angles section will go into the calibration -> phase_angle entries in your configuration. angle0 is for phase A, angle1 is for phase B, and angle2 is for phase C.

Example Configuration

esphome:
  name: shelly-3em


esp8266:
  board: esp01_1m


# Enable logging
logger:


# Enable HA API
api:
  encryption:
    key: !secret api_key


# Enable OTAs
ota:
  password: !secret api_password


# Sync RTC with HA
time:
  - platform: homeassistant
    timezone: America/Chicago


# Wi-Fi Setup
wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password


  power_save_mode: LIGHT


  # Enable fallback hotspot (captive portal) in case Wi-Fi connection fails
  ap:
    ssid: shelly-3em AP
    password: !secret ap_password


captive_portal:


i2c:
  sda: GPIO12
  scl: GPIO14
  frequency: 200kHz


status_led:
  pin:
    number: GPIO2


switch:
  - id: relay
    name: Shelly 3EM Relay
    platform: gpio
    pin:
      number: GPIO15


binary_sensor:
  - id: button
    name: Shelly 3EM Button
    platform: gpio
    pin:
      number: GPIO4
      mode: INPUT_PULLUP
      inverted: true


sensor:
  - id: ade7880_device
    platform: ade7880
    irq0_pin:
      number: GPIO13
    irq1_pin:
      number: GPIO5
    reset_pin:
      number: GPIO16
    frequency: 60Hz
    phase_a:
      name: Phase A
      voltage: Voltage
      current: Current
      active_power: Active Power
      power_factor: Power Factor
      forward_active_energy: Forward Active Energy
      reverse_active_energy: Reverse Active Energy
      calibration:
        current_gain: 3116628
        voltage_gain: -757178
        power_gain: -1344457
        phase_angle: 188
    phase_b:
      name: Phase B
      voltage: Voltage
      current: Current
      active_power: Active Power
      power_factor: Power Factor
      forward_active_energy: Forward Active Energy
      reverse_active_energy: Reverse Active Energy
      calibration:
        current_gain: 3133655
        voltage_gain: -755235
        power_gain: -1345638
        phase_angle: 188
    phase_c:
      name: Phase C
      voltage: Voltage
      current: Current
      active_power: Active Power
      power_factor: Power Factor
      forward_active_energy: Forward Active Energy
      reverse_active_energy: Reverse Active Energy
      calibration:
        current_gain: 3111158
        voltage_gain: -743813
        power_gain: -1351437
        phase_angle: 180
    neutral:
      name: Neutral
      current: Current
      calibration:
        current_gain: 311123
Edit this page on GitHub

On this page