jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-04-28 23:37:35 +00:00
Code Issues Packages Projects Releases Wiki Activity
home-assistant.io/source/_integrations/switchbot.markdown

1.3 KiB
Raw Blame History

title description ha_category ha_release ha_iot_class ha_codeowners ha_domain ha_platforms
SwitchBot Instructions on how to set up Switchbot switches.
Switch
0.78 Local Polling
@danielhiversen
switchbot
switch

The switchbot switch platform allows you to control SwitchBot devices.

Manual Configuration

To enable it, add the following lines to your configuration.yaml:

switch:
  - platform: switchbot
    mac: "MAC_ADDRESS"

{% configuration %} mac: description: The device MAC address with upper-case letters. required: true type: string name: description: The name used to display the switch in the frontend. required: false type: string password: description: The password of the switch if set required: false type: string {% endconfiguration %}

SwitchBot Entity

There are two attributes available on the SwitchBot entity to give you more information about your device.

  • last_run_success: If true if the last action sent to the SwitchBot succeeded. This attribute is useful for error trapping when Bluetooth connectivity is intermittent. If false, see home-assistant.log for specific error messages.
  • assumed_state: Always true. If the state of the SwitchBot entity cannot be determined, it is assumed to be on.