@switchbot/homebridge-switchbot
-@switchbot/homebridge-switchbot
-
-
+@switchbot/homebridge-switchbot
+
+
The Homebridge SwitchBot plugin allows you to access your SwitchBot Device(s) from HomeKit with
- Homebridge .
+ Homebridge .
Installation
-Search for "SwitchBot" on the plugin screen of Homebridge Config UI X
+Search for "SwitchBot" on the plugin screen of Homebridge Config UI X
Find: @switchbot/homebridge-switchbot
-See noble prerequisites for your OS. (This is used for BLE connection.)
+See noble prerequisites for your OS. (This is used for BLE connection.)
Click Install
@@ -80,10 +80,21 @@
This lists all discovered Bluetooth devices. The BLE address of the SwitchBot device should be included in this list, otherwise your computer does not discover it.
+
+
+If using MacOS
+Manually grant Bluetooth access in System Settings UI for Security & Privacy -> Privacy
to the node executable, eg /usr/local/bin/node
+
+(This is what is intended in documentation for the noble bluetooth package prerequisites by "Add terminal app", however for HomeBridge it is node
that needs the permission granted, not terminal
.
+Without this step, then you will receive the following error when the swichbot plugin launches, which will cause Homebridge or the child bridge process to restart:
+
+Error : Failed to initialize the Noble object : unauthorized at Noble .< anonymous > ( file : ///usr/local/lib/node_modules/@switchbot/homebridge-switchbot/node_modules/node-switchbot/src/switchbot.ts:244:19) at Object . onceWrapper ( node : events : 629 : 26 ) at Noble . emit ( node : events : 514 : 28 ) at Noble . onStateChange (/ usr / local / lib / node_modules /@ switchbot / homebridge - switchbot / node_modules /@ stoprocent / noble / lib / noble . js : 92 : 8 ) at NobleMac . emit ( node : events : 514 : 28 )
+
Copy
+
Supported SwitchBot Devices
-
SwitchBot Motion Sensor
+SwitchBot Motion Sensor
Supports OpenAPI & Bluetooth Low Energy (BLE) Connections
If using OpenAPI:
@@ -130,12 +141,12 @@
-
SwitchBot Contact Sensor
+SwitchBot Contact Sensor
Supports OpenAPI & Bluetooth Low Energy (BLE) Connections
If using OpenAPI:
@@ -147,13 +158,13 @@
-
SwitchBot Curtain
-
SwitchBot Curtain 3
+SwitchBot Curtain
+
SwitchBot Curtain 3
Supports OpenAPI & Bluetooth Low Energy (BLE) Connections
If using OpenAPI:
@@ -165,70 +176,70 @@
-
SwitchBot Blind Tilt
+SwitchBot Blind Tilt
Supports OpenAPI & partial Bluetooth Low Energy (BLE) Connections
If using OpenAPI:
-
SwitchBot Bulb
-
SwitchBot Ceiling Light
-
SwitchBot Ceiling Light Pro
-
SwitchBot Light Strip
+SwitchBot Bulb
+
SwitchBot Ceiling Light
+
SwitchBot Ceiling Light Pro
+
SwitchBot Light Strip
Supports OpenAPI & partial Bluetooth Low Energy (BLE) Connections
If using OpenAPI:
-
SwitchBot Lock
-
SwitchBot Lock Pro
+SwitchBot Lock
+
SwitchBot Lock Pro
Supports OpenAPI & Bluetooth Low Energy (BLE) Connections
If using OpenAPI:
-
US: SwitchBot Mini Robot Vacuum K10+
-
US: SwitchBot Floor Cleaning Robot S10
-
JP: SwitchBot Robot Vacuum Cleaner S1
-
JP: SwitchBot Robot Vacuum Cleaner S1 Plus
+ US: SwitchBot Mini Robot Vacuum K10+
+
US: SwitchBot Floor Cleaning Robot S10
+
JP: SwitchBot Robot Vacuum Cleaner S1
+
JP: SwitchBot Robot Vacuum Cleaner S1 Plus
Supports OpenAPI Connection Only
-
SwitchBot Plug
-
SwitchBot Plug Mini (US)
-
SwitchBot Plug Mini (JP)
+SwitchBot Plug
+
SwitchBot Plug Mini (US)
+
SwitchBot Plug Mini (JP)
Supports OpenAPI & Bluetooth Low Energy (BLE) Connections
If using OpenAPI:
-
SwitchBot Bot
+SwitchBot Bot
-Supported IR Devices
+Supported IR Devices
TV
Allows for On/Off and Volume Controls
@@ -353,16 +364,16 @@
SwitchBot APIs
Community
-