Generation 1 “Shelly 4Pro” and “Shelly Sense” are not supported (devices based on old CoAP v1 protocol) An awning that follows the weather - Outdoor motorized awnings offer pleasant shade for your guests on sunny days. However, a strong, unexcepted wind can damage them beyond repair. By combining it with a wind sensor connected to the Shelly Plus Add-on, Shelly Plus 2PM can automatically close the outside awning to protect them from the wind. Additionally, Shelly Plus Add-on with a rain sensor can trigger Shelly Plus 2PM to open the awning just in time to protect your guests. Depending on how a device’s button type is configured, the integration will create binary sensors corresponding to those inputs. binary sensors are not created when the button type is momentary or momentary_on_release, for these types you need to use events for your automations. Binary input sensors (generation 2) If Channel Name is set in the device, the integration will use it to generate the entities’ name, e.g. Kitchen Light

platform: mqtt name: Rolling Shutters command_topic: shellies/shellyswitch25-/roller/0/command # rc, open, close and stop state_topic: shellies/shellyswitch25-/roller/0 # open, close, stop position_topic: shellies/shellyswitch25-/roller/0/pos set_position_topic: shellies/shellyswitch25-/roller/0/command/pos availability_topic: shellies/shellyswitch25-/online json_attributes_topic: shellies/shellyswitch25-/info payload_open: open payload_close: close payload_stop: stop state_opening: open state_closing: close position_open: 100 position_closed: 0 payload_available: true payload_not_available: false qos: 1 switch: platform: mqtt name: Rolling Shutters - Calibrate command_topic: shellies/shellyswitch25-/roller/0/command payload_on: rc - platform: mqtt name: Rolling Shutters - FW upgrade command_topic: shellies/shellyswitch25-/command payload_on: update_fw binary_sensor: sensors/energy/shelly_3em.yaml - platform: mqtt name: "3EM - Phase A - Energy" value_template: "{{ value|float / 60000 }}" # Wm to kWh unit_of_measurement: 'kWh' expire_after: 86400 device_class: energy state_class: total_increasing qos: 1 state_topic: "shellies/shellyem3-/emeter/0/energy" - platform: mqtt name: "3EM - Phase A - Returned Energy" value_template: "{{ value|float / 60000 }}" unit_of_measurement: 'kWh' expire_after: 86400 device_class: energy state_class: total_increasing qos: 1 state_topic: "shellies/shellyem3-/emeter/0/returned_energy" - platform: mqtt name: "3EM - Phase A - Total Energy" value_template: "{{ value|float / 60000 }}" unit_of_measurement: 'kWh' expire_after: 86400 device_class: energy state_class: total_increasing qos: 1 state_topic: "shellies/shellyem3-/emeter/0/total_energy" - platform: mqtt name: "3EM - Phase A - Total Returned Energy" value_template: "{{ value|float / 60000 }}" unit_of_measurement: 'kWh' expire_after: 86400 device_class: energy state_class: total_increasing qos: 1 state_topic: "shellies/shellyem3-/emeter/0/total_returned" - platform: mqtt name: "3EM - Phase A - Power" unit_of_measurement: 'W' expire_after: 86400 device_class: power qos: 1 state_topic: "shellies/shellyem3-/emeter/0/power" - platform: mqtt name: "3EM - Phase A - Voltage" unit_of_measurement: 'V' expire_after: 86400 device_class: voltage qos: 1 state_topic: "shellies/shellyem3-/emeter/0/voltage" - platform: mqtt name: "3EM - Phase A - Current" unit_of_measurement: 'A' expire_after: 86400 device_class: current qos: 1 state_topic: "shellies/shellyem3-/emeter/0/current" - platform: mqtt name: "3EM - Phase A - Power Factor" # If the PF is returned as a value between 0.0 and 1.0 # instead of a % value between 0 and 100 # uncomment the line below #value_template: "{{ value|float * 100 }}" unit_of_measurement: '%' expire_after: 86400 device_class: power_factor qos: 1 state_topic: "shellies/shellyem3-/emeter/0/pf" Binary Sensors ¶ Shelly H&T is the worst H&T out there. I’ve got 4 of them in my house and they are just atrocious. I was looking up for a way to flash them with ESPHome but apparently Alterco refuses to share the GPIO pinouts. I could see this sensor being useful for those working from home. You could plug it in overnight and monitor the air quality, temperature, and humidity while you sleep, and in the morning, place it on your desk. The CO2, PM2.5, and PM10 readings will give you an extra insight as to when your window should be opened.platform: mqtt name: Rolling Shutters - switch open payload_on: 1 payload_off: 0 state_topic: shellies/shellyswitch25-/input/0 - platform: mqtt name: Rolling Shutters - switch close payload_on: 1 payload_off: 0 state_topic: shellies/shellyswitch25-/input/1 - platform: mqtt name: Rolling Shutters - overtemperature payload_on: 1 payload_off: 0 state_topic: shellies/shellyswitch25-/overtemperature - platform: mqtt name: Rolling Shutters - firmware available payload_on: true payload_off: false value_template: "{{ value_json.new_fw }}" state_topic: shellies/shellyswitch25-/announce sensor: lights/room_x/lamps.yaml # Lamp room X - Shelly 1PM - platform: mqtt name: Room X - lamp payload_on: "on" payload_off: "off" qos: 1 state_topic: shellies/shelly1pm-[SHELLY ID]/relay/0 command_topic: shellies/shelly1pm-[SHELLY ID]/relay/0/command json_attributes_topic: shellies/shelly1pm-[SHELLY ID]/info ## /lights/room_y/lamps.yaml # Lamp room Ya - Shelly 2.5 - platform: mqtt name: Room Y - lamp A payload_on: "on" payload_off: "off" qos: 1 state_topic: shellies/shellyswitch25-[SHELLY ID]/relay/0 command_topic: shellies/shellyswitch25-[SHELLY ID]/relay/0/command json_attributes_topic: shellies/shellyswitch25-[SHELLY ID]/info # Lamp room Yb - Shelly 2.5 - platform: mqtt name: Room Y - lamp B payload_on: "on" payload_off: "off" qos: 1 state_topic: shellies/shellyswitch25-[SHELLY ID]/relay/1 command_topic: shellies/shellyswitch25-[SHELLY ID]/relay/1/command json_attributes_topic: shellies/shellyswitch25-[SHELLY ID]/info Binary sensors ¶

If Shelly devices are in a different subnet than the Home Assistant server, you should ensure communication on UDP port 5683 between these subnets. If Home Assistant is running as a virtual machine or service on an operating system other than Home Assistant OS, you should open UDP port 5683 on the device’s firewall and/or ensure that communication from this port is redirected to the Home Assistant service. For an introduction on MQTT for Shelly devices, see my blog post: Getting started with MQTT and Home Assistant (and Shelly). shellies-discovery ¶ Control your lights based on luminousity - Together with an LDR (photoresistor), Shelly Plus Add-on can trigger Shelly Plus 2PM to open the blinds when the room is too dark and it's still daytime. Additionally, when luminosity is low, Shelly Plus Add-on can trigger Shelly Plus 1 to turn on the lights at just the right time. These relays can be used to control 2 different loads (e.g. 2 lamps in a room) or to control the up/down motion of rolling shutters.

Applications that can benefit from this feature include HVAC environmental controls, temperature monitoring systems inside buildings, equipment or machinery and process monitoring and control systems Features and Functionality: Turn the cheapest heaters into the smartest devices with Shelly Humidity & Temperature Sensor and Shelly Plug - you can automatically control any electric heater. 365-Day History

binsensors/room_z/switch.yaml # Online - platform: mqtt name: "Room Z - switch" payload_on: true payload_off: false state_topic: "shellies/shellyix3-[SHELLY ID]/online" json_attributes_topic: "shellies/shellyix3-[SHELLY ID]/info" # Switch 1 - platform: mqtt name: "Room Z - switch - switch 1" expire_after: 604800 qos: 1 payload_on: 1 payload_off: 0 state_topic: "shellies/shellyix3-[SHELLY ID]/input/0" # Switch 2 - platform: mqtt name: "Room Z - switch - switch 2" expire_after: 604800 qos: 1 payload_on: 1 payload_off: 0 state_topic: "shellies/shellyix3-[SHELLY ID]/input/1" # Switch 3 - platform: mqtt name: "Room Z - switch - switch 3" expire_after: 604800 qos: 1 payload_on: 1 payload_off: 0 state_topic: "shellies/shellyix3-[SHELLY ID]/input/2" # Firmware upgrade - platform: mqtt name: "Room Z - switch - firmware" state_topic: "shellies/shellyix3-[SHELLY ID]/announce" value_template: "{{ value_json.new_fw }}" payload_on: true payload_off: false Shelly Plug (S) ¶ Since a Shelly relay (e.g. Shelly 1 or 2.5) only supports on/off toggling, so it doesn’t really matter whether it’s configured as a light or a switch. However, it’s just a matter of setting the correct platform and/or adding the config in the right file for your Shelly to be configured as switch, cover, … Shelly relays (1, 1PM, 1L, 2.5) ¶ If you think your Shelly devices are working correctly and don’t want to change your network/configuration, you can ignore the repair issue. Still, you must know you are giving up the best experience of using first-generation Shelly devices with Home Assistant.customize_domain: ! include customisations/customize_domain.yaml customize_glob: ! include customisations/customize_glob.yaml customize: ! include customisations/customize.yaml automation: ! include automations.yaml group: ! include group.yaml script: ! include scripts.yaml binary_sensor: ! include_dir_merge_list binsensors/ light: include_dir_merge_list lights/ sensor: include_dir_merge_list sensors/ switch: include_dir_merge_list switchess/ MQTT Templates ¶ Some time ago I switched from manually adding Shelly devices via MQTT configurations to an automated script: ha-shellies-discovery. Shelly Humidity & Temperature Sensor (H&T) is open to the world and developers. Shellys are secured but at the same time give everyone the opportunity to use them easily in new and existing projects. With the embedded web server and the HTTP commands Shelly can be made compatible with your existing home automation system. Some devices, like the Shelly2.5 have multiple switch inputs and outputs. These need to be added individually. Light vs Switch setup ¶

But you can also configure a device as light, which will also give you control over brightness and colour temp, if the device supports it. If you can’t find the CoIoT peer settings in the device’s web panel, it’s probably using an ancient firmware version, and you should update it to the current one. A perfect design combined with a battery lasting up to 16 months that keeps your home always comfortable. For generation 2 hardware it’s possible to select if a device’s input is connected to a button or a switch. Binary sensors are created only if the input mode is set to switch. When the input is of type button you need to use events for your automations. Event entities (generation 1)

Welcome

switches/energy/shelly_3em.yaml - platform: mqtt name: "3EM - Relay" expire_after: 604800 qos: 1 command_topic: "shellies/shellyem3-/relay/0/command" state_topic: "shellies/shellyem3-/relay/0" # Remove the line below if the value_template doesn't function properly value_template: {{ 'on' if value == 'on' else 'off' }} # Test for capturing 'overpower' state - platform: mqtt name: "3EM - Phase A - Reset Totals" expire_after: 604800 qos: 1 optimistic: true payload_on: "reset_totals" payload_off: "" command_topic: "shellies/shellyem3-/emeter/0/command" - platform: mqtt name: "3EM - Reset Device Data" expire_after: 604800 qos: 1 optimistic: true payload_on: "reset_data" payload_off: "" command_topic: "shellies/shellyem3-/command" Shelly 4Pro ¶