v3.5.1 (#990)

## [3.5.1](https://github.com/OpenWonderLabs/homebridge-switchbot/releases/tag/v3.5.1) (2024-06-27) ### What's Changed - Added troubleshooting section about bluetoothctl for linux systems to readme. [#984](#984), Thanks [@martenmatrix](https://github.com/martenmatrix) - Housekeeping and updated dependencies. **Full Changelog**: v3.5.0...v3.5.1
OpenWonderLabs · Jun 28, 2024 · d3193b4 · d3193b4
1 parent 6beef47
commit d3193b4
Show file tree

Hide file tree

Showing 45 changed files with 9,151 additions and 9,744 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -2,6 +2,13 @@
 
 All notable changes to this project will be documented in this file. This project uses [Semantic Versioning](https://semver.org/)
 
+## [3.5.1](https://github.com/OpenWonderLabs/homebridge-switchbot/releases/tag/v3.5.1) (2024-06-27)
+
+### What's Changed
+- Housekeeping and updated dependencies.
+
+**Full Changelog**: https://github.com/OpenWonderLabs/homebridge-switchbot/compare/v3.5.0...v3.5.1
+
 ## [3.5.0](https://github.com/OpenWonderLabs/homebridge-switchbot/releases/tag/v3.5.0) (2024-05-26)
 
 ### What's Changed

diff --git a/README.md b/README.md
@@ -49,6 +49,22 @@
      - Copy BLE Mac aka `deviceId`
   4. Input your `deviceId` into the Device Config
 
+## Troubleshooting
+
+- ### If using Linux / Raspberry Pi OS
+
+  1. `bluetoothctl` must be installed on the device, otherwise it cannot communicate via Bluetooth. Enable it with `sudo bluetoothctl power on`.
+
+  2. If errors occur, while enabling it, restart the process:
+     - `rfkill block bluetooth`
+     - `rfkill unblock bluetooth`
+
+  3. Also make sure, that the computer can discover the SwitchBot device: 
+     - `sudo bluetoothctl`
+     - `scan on`
+
+     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.
+
 ## Supported SwitchBot Devices
 
 - [SwitchBot Humidifier](https://www.switch-bot.com/products/switchbot-smart-humidifier)

diff --git a/config.schema.json b/config.schema.json
@@ -275,7 +275,7 @@
                   ],
                   "description": "Bluetooth (BLE) API is only available for the following Device Types: Humidifier, Meter, MeterPlus, Curtain, Bot, Motion Sensor, Contact Sensor, Plug Mini (US), Plug Mini (JP), & Color Bulb",
                   "condition": {
-                    "functionBody": "return (model.options && model.options.devices && model.options.devices[arrayIndices].deviceId && !model.options.devices[arrayIndices].hide_device && model.options.devices[arrayIndices].configDeviceType !== 'Hub 2');"
+                    "functionBody": "return (model.options && model.options.devices && model.options.devices[arrayIndices].deviceId && !model.options.devices[arrayIndices].hide_device);"
                   }
                 },
                 "webhook": {
@@ -965,22 +965,22 @@
                   }
                 },
                 "mqttURL": {
-                  "title": "MQTT URL",
+                  "title": "MQTT URL (Device Specific)",
                   "type": "string",
                   "placeholder": "192.168.7.1",
                   "condition": {
                     "functionBody": "return (model.options && model.options.devices && !model.options.devices[arrayIndices].hide_device && model.options.devices[arrayIndices].deviceId && (model.options.devices[arrayIndices].configDeviceType === 'Curtain' || model.options.devices[arrayIndices].configDeviceType === 'Water Detector' || model.options.devices[arrayIndices].configDeviceType === 'WoIOSensor' || model.options.devices[arrayIndices].configDeviceType === 'Hub 2' || model.options.devices[arrayIndices].configDeviceType === 'Meter' || model.options.devices[arrayIndices].configDeviceType === 'MeterPlus' || model.options.devices[arrayIndices].configDeviceType === 'Meter Plus (JP)'));"
                   }
                 },
                 "mqttOptions": {
-                  "title": "MQTT Options",
+                  "title": "MQTT Options (Device Specific)",
                   "type": "string",
                   "condition": {
                     "functionBody": "return (model.options && model.options.devices && !model.options.devices[arrayIndices].hide_device && model.options.devices[arrayIndices].deviceId && model.options.devices[arrayIndices].mqttURL && (model.options.devices[arrayIndices].configDeviceType === 'Curtain' || model.options.devices[arrayIndices].configDeviceType === 'Water Detector' || model.options.devices[arrayIndices].configDeviceType === 'WoIOSensor' || model.options.devices[arrayIndices].configDeviceType === 'Hub 2' || model.options.devices[arrayIndices].configDeviceType === 'Meter' || model.options.devices[arrayIndices].configDeviceType === 'MeterPlus' || model.options.devices[arrayIndices].configDeviceType === 'Meter Plus (JP)'));"
                   }
                 },
                 "mqttPubOptions": {
-                  "title": "MQTT Pub Options",
+                  "title": "MQTT Pub Options (Device Specific)",
                   "type": "string",
                   "condition": {
                     "functionBody": "return (model.options && model.options.devices && !model.options.devices[arrayIndices].hide_device && model.options.devices[arrayIndices].deviceId && model.options.devices[arrayIndices].mqttURL && (model.options.devices[arrayIndices].configDeviceType === 'Curtain' || model.options.devices[arrayIndices].configDeviceType === 'Water Detector' || model.options.devices[arrayIndices].configDeviceType === 'WoIOSensor' || model.options.devices[arrayIndices].configDeviceType === 'Hub 2' || model.options.devices[arrayIndices].configDeviceType === 'Meter' || model.options.devices[arrayIndices].configDeviceType === 'MeterPlus' || model.options.devices[arrayIndices].configDeviceType === 'Meter Plus (JP)'));"
@@ -1652,6 +1652,19 @@
             "type": "string",
             "placeholder": "http://${FQDN}:${PORT}/${PATH}"
           },
+          "mqttURL": {
+            "title": "MQTT URL",
+            "type": "string",
+            "placeholder": "192.168.7.1"
+          },
+          "mqttOptions": {
+            "title": "MQTT Options",
+            "type": "string"
+          },
+          "mqttPubOptions": {
+            "title": "MQTT Pub Options",
+            "type": "string"
+          },
           "maxRetries": {
             "title": "Max Retries for OpenAPI",
             "type": "number",
@@ -1882,20 +1895,23 @@
       "expanded": false,
       "items": [
         "options.webhookURL",
+        "options.mqttURL",
+        "options.mqttOptions",
+        "options.mqttPubOptions",
         "options.maxRetries",
         "options.delayBetweenRetries",
         {
           "key": "options.refreshRate",
           "description": "<em class='primary-text'>Specifies the interval, in seconds, for retrieving the latest device status from the SwitchBot API.</em>"
-          },
+        },
         {
           "key": "options.updateRate",
           "description": "<em class='primary-text'>Specifies the interval, in seconds, at which devices will request updates from the SwitchBot API while in motion, for Curtain(s) and Blind Tilt(s) only.</em>"
-          },
+        },
         {
           "key": "options.pushRate",
           "description": "<em class='primary-text'>Specifies the interval, in seconds, between pushes to the SwitchBot API.</em>"
-          },
+        },
         "options.logging"
       ]
     }