This app is used to control SwitchBot devices.
It supports both BLE and the hub methods for Curtains, Bots and the temperature / Humidity modules.
When adding BLE devices, it is strongly recommended that you keep Homey and the device as close together as possible. If the distance is too large then Homey may cache partial data about the device that makes it unrecognisable. Once that data is cached it can be hard to remove and might require a restart of Homey to clear it.
There is one limitation for the app:
- The SwitchBot hub API only allows 1000 accesses per day. That means the refresh of the current state to get changes is very slow, and the more devices you have the slower the refresh. It does however control the devices well.
I have made a request to SwitchBot to provide either a local hub API and / or add support for notifications via a callback / webhook. This would be the most efficient way for them and us to keep track of the device status when operated by external events.
If you would like to see the hub interface improved then maybe you can also make a request to SwitchBot for these features. The more people that ask the more likely something will be done.
Using the Hub
To get the token required to access the SwitchBot API, go to SwitchBot phone app and select Profile –> Preferences then tap 10 times on “App Version”. A new Developer Options option will appear in the list. Tap on that and the token will be displayed.
Copy this token (it is quite long so use the Copy command on your device if you can)
Next, open the Configure App screen of the Homey SwitchBot app and paste the code in to the API TOKEN field.
Bot Switch Mode (Toggle / Press)
The latest version (0.2.4) has been updated to work with the Push Button mode of the Bot. For the BLE version, this is automatic as the required information is provided in the data packet. For the Hub version, the information is not made available via the API, so there is a setting in the Advanced Settings page to enable it.
Note: The actual setting for the device has to be set via the SwitchBot phone app as there is nothing documented in the protocols to be able to change it from the Homey app.
Alternative BLE connection
I have created an app that runs on a ESP32, Arduino compatible board. I have made the app available on Github:
The boards are pretty cheap on Amazon, but the installation is medium complexity, so may not be for everyone.
Once the board is programmed, it is plug and play with the latest version of the Homey SwitchBot app (v0.2.4). You just add BLE devices to Homey in the normal way.
There are two advantages to using the board:
- Very fast feed back of device state changes via a notification method. I can see the curtain position slider animate through several positions as the curtains open and close.
- Connects to Homey via WiFi, so can be positioned to reach SwitchBot devices that are too far from Homeys built in BLE.
There are instruction in the Github repository to assist programing the board.
- Initial release
- Added BLE Temperature and Humidity
- Added HUB Temperature and Humidity, HUB Bot and BLE Bot
- Added Invert Position and Motion Mode to advanced settings for curtains
- Fixed Invert Position for HUB connected curtains
- Added Air Conditioner Remote
- Fixed operation of the Switch Bot to honour the single press mode when selected in the SwitchBot app. BLE can detect the mode setting but for the hub you have to adjust the Advanced setting.
Fix for the Homey BLE caching issue.
Note, this fix is only for devices that are in the app and will not help fix the issue of detection when adding devices, if Homey has cached bad data for the new device that makes it impossible to recognise it.
- Added On/Off capability to curtains so they can be fully opened/closed by tapping on the tile
- Added a check for a SwitchBot device with no service data in the discovery, so the entry in the BLE cache can be cleared ready for the next discovery.
- Fix Bot state check when using Homey’s BLE.
- Adding my BLE hub no longer disables Homey’s BLE checking so both are now used.
- Added error handler around JSON parsing to cope with bad data.
- Attempt to add devices based on the localName id there is no service data.
- Changed logging to multi-level to make it easier to spot general issues.
- Cleaned up the retries loops.
- Ensure log level is initialised at start up.
- Optimised for Homey V6 firmware, but still compatible with V5.
- Optimised for activating multiple devices simultaneously.
- Added Position value to information.
- Added buttons to send the logs from the configuration page.
If you have any requests or find any issues please get in touch on here.