From d800cb85a0ae9c5dc763451c0179847f517a6003 Mon Sep 17 00:00:00 2001 From: Aleix Murtra Date: Mon, 2 Sep 2019 19:24:40 +0200 Subject: [PATCH] Add BeeWi SmartClim BLE sensor documentation (#10222) * Add BeeWi SmartClim BLE sensor documentation * Apply requested comments * Remove non supported option 'monitored_conditions' --- source/_components/beewi_smartclim.markdown | 77 ++++++++++++++++++ .../images/supported_brands/beewi_by_otio.png | Bin 0 -> 31155 bytes 2 files changed, 77 insertions(+) create mode 100644 source/_components/beewi_smartclim.markdown create mode 100644 source/images/supported_brands/beewi_by_otio.png diff --git a/source/_components/beewi_smartclim.markdown b/source/_components/beewi_smartclim.markdown new file mode 100644 index 00000000000..7a49cf788fa --- /dev/null +++ b/source/_components/beewi_smartclim.markdown @@ -0,0 +1,77 @@ +--- +title: "BeeWi SmartClim BLE" +description: "Instructions on how to integrate MBeeWi SmartClim BLE sensor with Home Assistant." +logo: beewi_by_otio.png +ha_category: + - Sensor +ha_release: 0.99 +ha_iot_class: Local Polling +--- + +The `beewi_smartclim` sensor platform allows one to monitor room or external temperature and humidity. The [BeeWi SmartClim BLE](http://www.bee-wi.com/produits/capteurs/capteur-de-temperature/) is a Bluetooth Low Energy sensor device that monitors temperature from a room or a garden from your smartphone by using an APP. Use this integration to track these metrics from any location thanks to Home Assistant, as well as to create some automation scripts based on your room's temperature. + +## Installation + +Depending on the operating system you're running, you have to configure the proper Bluetooth backend on your system: + +- On [Hass.io](/hassio/installation/): `beewi_smartclim` will work out of the box as long as the host supports Bluetooth (like the Raspberry Pi does). +- On a [generic Docker installation](/docs/installation/docker/): Works out of the box with `--net=host` and properly configured Bluetooth on the host. +- On other Linux systems: + - Preferred solution: Install the `bluepy` and `btlewrap` library (via pip). When using a virtual environment, make sure to use install the library in the right one. + - Fallback solution: Install `btlewrap` library (via pip) and `gatttool` via your package manager. Depending on the distribution, the package name might be: `bluez`, `bluetooth` or `bluez-deprecated`. +- Windows and MacOS are currently not supported by the `btlewrap` library. + +## Configuration + +Start a scan to determine the MAC addresses of the sensor: + +```bash +$ sudo hcitool lescan +LE Scan ... +D0:5F:B8:51:9B:36 BeeWi SmartClim +[...] +``` + +Or if your distribution is using bluetoothctl: + +```bash +$ bluetoothctl +[bluetooth]# scan on +Discovery started +[CHG] Controller XX:XX:XX:XX:XX:XX Discovering: yes +[NEW] Device D0:5F:B8:51:9B:36 BeeWi SmartClim +``` + +Check for `BeeWi SmartClim` or similar entries, those are your sensor. + +To use your Mi Temperature and Humidity sensor in your installation, add the following to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +sensor: + - platform: beewi_smartclim + mac: 'xx:xx:xx:xx:xx:xx' +``` + +{% configuration %} +mac: + description: The MAC address of your sensor. + required: true + type: string +name: + description: The name displayed in the frontend. + required: false + type: string +{% endconfiguration %} + +## Full example + +A full configuration example could look like the one below: + +```yaml +# Example configuration.yaml entry +sensor: + - platform: beewi_smartclim + mac: 'xx:xx:xx:xx:xx:xx' + name: Garden +``` diff --git a/source/images/supported_brands/beewi_by_otio.png b/source/images/supported_brands/beewi_by_otio.png new file mode 100644 index 0000000000000000000000000000000000000000..6ac5e6f8782b84289badabfb505f319a0d574c70 GIT binary patch literal 31155 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%0Aet$B+}8?VIU|s-z!b_u3fb&^l6Q1v;Vl{s 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�E$h2A@5Q(cv)G)xgu? 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