Is SwitchBot Bot Compatible with Home Assistant?
Verdict Badge
VERDICT: [ NATIVELY SUPPORTED ]
Protocol: Bluetooth LE
Bridge Needed: NO
Hardware Safety & Verification Specs
Electrical parameters & logic voltage safety limits before powering ICs
⚠️ Mains Voltage Isolate Circuit
🧪 Verified in Lab
Logic Voltage Internal Isolated Converter
Voltage Rating 100-240V AC / 50-60Hz
Current Profile Mains AC (10A MAX Relay)
Environment Rating IP20 Indoor Climate Control
## Compatibility Overview
Physical button pusher for non-smart appliances; integrates via BLE local connection.
Interactive Pinout & Wiring Diagram
Hover over any pin to view voltage limits and pull-up specifications
VCC
3.3V Power
GND
Ground Common
SDA / TX
Data Line (GPIO 21)
SCL / RX
Clock Line (GPIO 22)
CS / INT
Chip Select (GPIO 19)
Bi-Directional 4-Channel I2C Level Shifter Diagram BSS138 MOSFET
3.3V Microcontroller
ESP32 / Pico W (LV Pin)
HV ↔ LV Shifter
Low Voltage: 3.3V | High Voltage: 5.0V
5.0V Sensor Peripheral
HC-SR04 / Relay (HV Pin)
## Technical Specification Matrix
| Feature / Attribute | Specification / Status |
|---|---|
| Hardware Protocol | Bluetooth LE |
| Bridge Required | NO |
| Border Router Needed | None (Bluetooth Adapter/Proxy) |
| Exposed Entities | Switch (Push/Press) Battery Level |
| Pairing Complexity | Plug-and-Play |
| Factory Reset Instruction | Press and hold the reset button inside the battery cover for 15 seconds until the icon flashes. |
## Step-by-Step Pairing Guide
1
Factory Reset Device
Press and hold the reset button inside the battery cover for 15 seconds until the icon flashes.
2
Initialize Pairing Mode on Home Assistant
Open Home Assistant administration console, navigate to Integrations / Add Device, and start pairing scanner.
3
Confirm Entity Binding & State Verification
Verify that primary entities (Switch (Push/Press), Battery Level) report live state changes inside Home Assistant.
Production Code Generator & Preset Toolkit
Pre-configured pinouts & drivers for SwitchBot Bot
👥 Community Verified Database
Continuous hardware testing updates
Report a Pinout Error or Submit Tested Code Snippets
Found a pin mapping quirk or built a custom ESPHome YAML driver for SwitchBot Bot? Help us keep this matrix 100% accurate.
Hardware Correction Form (sh-switchbot-bot-ha)
## Frequently Asked Questions
Does this device operate in Offline Mode?
Local BLE.
What is the expected Battery Life & Power specification?
CR2 Battery.
How does Signal Mesh & Range Extension function?
N/A