SwitchBot Bluetooth for Home Assistant (built-in integration)

About

SwitchBot Bluetooth is a built-in integration that controls SwitchBot devices locally over Bluetooth. It covers many device types, with platforms for covers, locks, climate, fans, humidifiers, lights, vacuums, switches and buttons, plus sensors and binary sensors. Sensors include air quality level, light level, water level, radar and PIR trigger readings, and Bluetooth and Wi-Fi signal. Other controls cover child lock, oscillation, wireless charging, time format and the night light. Options set the curtain movement speed, force the Nightlatch mode and choose how many times commands are retried. Devices are found automatically on the network, and setup is done in the UI, where some devices ask for a password or encryption key.

Automatic summary of Home Assistant's source code. Something wrong? Get in touch

Supports

Works locally Talks to your devices on your own network. No vendor cloud in between.
Set up in the UI Add it in Settings, Devices and services. Nothing to download.
Found by itself Home Assistant spots it on the network and offers to add it.
Gold quality Home Assistant's own rating of its code and setup experience.
Updated with Home Assistant Ships and updates with every Home Assistant release.

Provides

Lights
Climate
Humidifiers
Fans
Covers
Locks
Vacuums
Switches
Sensors

Setting it up

Home Assistant usually finds it on the network and offers to add it. It can also be added by hand under Settings, Devices and services.

Sign in

PasswordThe password required for the Bot device access

Cloud login

PasswordThe password of your SwitchBot account
UsernameThe username of your SwitchBot account

Also asked when at the encrypted auth step.

Encrypted key

Encryption keyThe encryption key for the device
Key IDThe ID of the encryption key

Choose a device

MAC addressThe Bluetooth MAC address of your SwitchBot device

After setup

Curtain movement speedSpeed for curtain open and close operations (1-255, where 1 is slowest and 255 is fastest)
Force Nightlatch operation modeForce Nightlatch operation mode even if Nightlatch is not detected
Retry countHow many times to retry sending commands to your SwitchBot devices

Texts from Home Assistant's source code, Apache License 2.0.

Entities

Binary sensorsCalibration, Auto-lock paused, Timeout, Unclosed alarm, Unlocked alarm, Duress alarm, Half-lock calibration, Half locked, High temperature, Lockout alarm, Low temperature
ButtonsHalf lock, Light sensor, Next image, Previous image, Sync date and time
LightsLight
NumbersDisplay time offset, Horizontal oscillation angle, Vertical oscillation angle
SelectsNight light, Time format
SensorsAir quality level, Battery range, Bluetooth signal, Light level, PIR triggered level, Radar triggered distance, Radar triggered level, Water level, Wi-Fi signal
SwitchesChild lock, Horizontal oscillation, Vertical oscillation, Wireless charging