home-assistant.io/source/_components/switch.mystrom.markdown
2019-03-10 04:45:59 -07:00

2.0 KiB

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_release, ha_iot_class
layout title description date sidebar comments sharing footer logo ha_category ha_release ha_iot_class
page myStrom Switch Instructions on how to integrate myStrom switches into Home Assistant. 2015-11-25 22:00 true false true true mystrom.png Switch 0.9 Local Polling

The mystrom switch platform allows you to control the state of your myStrom switches. The built-in sensor is measuring the power consumption while the switch is on.

{% linkable_title Setup %}

Make sure that you have enabled the REST API under Advanced in the web frontend of the switch.

{% linkable_title Configuration %}

To use your myStrom switch in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
switch:
  - platform: mystrom
    host: IP_ADRRESS

{% configuration %} host: description: "The IP address of your myStrom switch, e.g., http://192.168.1.32." required: true type: string name: description: The name to use when displaying this switch. required: false type: string default: myStrom Switch {% endconfiguration %}

Check if you are able to access the device located at http://IP_ADRRESS. The details about your switch is provided as a JSON response.

$ curl -X GET -H "Content-Type: application/json" http://IP_ADDRESS/report
{
  "power": 0,
  "relay": false
}

or change its state:

curl -G -X GET http://IP_ADDRESS/relay -d 'state=1'

{% linkable_title Get the current power consumption %}

The switch is measuring the current power consumption. To expose this as a sensor use a template sensor.

{% raw %}

# Example configuration.yaml entry
sensor:
  - platform: template
    sensors:
      power:
        friendly_name: "Current Power"
        unit_of_measurement: "W"
        value_template: "{{ states.switch.office.attributes.current_power_w }}"

{% endraw %}