diff --git a/source/_components/device_tracker.bluetooth_tracker.markdown b/source/_components/device_tracker.bluetooth_tracker.markdown new file mode 100644 index 00000000000..71f14c7052c --- /dev/null +++ b/source/_components/device_tracker.bluetooth_tracker.markdown @@ -0,0 +1,25 @@ +--- +layout: page +title: "Bluetooth Tracker" +description: "Instructions how to integrate bluetooth tracking within Home Assistant." +date: 2016-04-10 17:24 +sidebar: true +comments: false +sharing: true +footer: true +logo: bluetooth.png +ha_category: Presence Detection +ha_iot_class: "Local Poll" +--- + +This tracker discovers new devices on boot and tracks bluetooth devices periodically based on interval_seconds value. Devices discovered are stored with 'bt_' as the prefix for device mac in `known_devices.yaml`. + +Requires PyBluez + +```yaml +device_tracker: + platform: bluetooth_tracker + track_new_devices: true + interval_seconds: 60 + consider_home: 180 +``` diff --git a/source/_components/feedreader.markdown b/source/_components/feedreader.markdown new file mode 100644 index 00000000000..a9ccb4424ec --- /dev/null +++ b/source/_components/feedreader.markdown @@ -0,0 +1,22 @@ +--- +layout: page +title: Feedreader +description: "Instructions how to integrate RSS feeds into Home Assistant." +date: 2016-04-18 22:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: rss.gif +ha_category: Thermostat +--- + +Add an RSS/Atom feed reader that polls feeds every hour and sends new entries into the event bus + +```yaml +# Example configuration.yaml entry +feedreader: + urls: + - https://home-assistant.io/atom.xml + - https://github.com/blog.atom +``` diff --git a/source/_components/media_player.webostv.markdown b/source/_components/media_player.webostv.markdown index 0ccb2706dad..bf3aa6dc861 100644 --- a/source/_components/media_player.webostv.markdown +++ b/source/_components/media_player.webostv.markdown @@ -7,11 +7,10 @@ sidebar: true comments: false sharing: true footer: true -logo: webostv.png +logo: webos.png ha_category: Media Player ha_iot_class: "Local Poll" --------------------------- - +--- The `webostv` platform allows you to control a LG WebOS Smart TV. @@ -32,4 +31,4 @@ Configuration variables: - **host** *Optional*: The IP of the LG WebOS Smart TV, e.g. 192.168.0.10 - **name** *Optional*: The name you would like to give to the LG WebOS Smart TV. -If you do not provide a host name, all LG WebOS Smart TV's within your network will be auto-discovered if your TV network name is set to `[LG] webOS TV` \ No newline at end of file +If you do not provide a host name, all LG WebOS Smart TV's within your network will be auto-discovered if your TV network name is set to `[LG] webOS TV` diff --git a/source/_components/mysensors.markdown b/source/_components/mysensors.markdown index 21c23469150..7a67203847e 100644 --- a/source/_components/mysensors.markdown +++ b/source/_components/mysensors.markdown @@ -22,12 +22,15 @@ Integrate your Serial MySensors Gateway by adding the following to your `configu # Example configuration.yaml entry mysensors: gateways: - - port: '/dev/ttyUSB0' + - device: '/dev/ttyUSB0' persistence_file: 'path/mysensors.json' baud_rate: 38400 - - port: '/dev/ttyACM1' + - device: '/dev/ttyACM0' persistence_file: 'path/mysensors2.json' baud_rate: 115200 + - device: '192.168.1.18' + persistence_file: 'path/mysensors3.json' + tcp_port: 5003 debug: true persistence: true version: '1.5' diff --git a/source/_components/notify.webostv.markdown b/source/_components/notify.webostv.markdown index 8ebb971b068..d5d4c190d8d 100644 --- a/source/_components/notify.webostv.markdown +++ b/source/_components/notify.webostv.markdown @@ -1,17 +1,16 @@ --- layout: page -title: "LG WebOS TV" +title: "LG WebOS TV notifications" description: "Instructions how to integrate a LG WebOS TV within Home Assistant." date: 2016-04-18 23:24 sidebar: true comments: false sharing: true footer: true -logo: webostv.png +logo: webos.png ha_category: Notifications ha_iot_class: "Local Poll" --------------------------- - +--- The `webostv` platform allows you to send notifications to a LG WebOS Smart TV. @@ -33,7 +32,7 @@ Configuration variables: - **name** *Required*: The name you would like to give to the LG WebOS Smart TV. A possible automation could be: - + ```yaml # Example configuration.yaml entry automation: @@ -46,4 +45,4 @@ automation: service: notify.livingroom_tv data: message: "You should open a window! (Livingroom Co2: {{ states.sensor.netatmo_livingroom_co2.state }}ppm)" -``` \ No newline at end of file +``` diff --git a/source/_components/sensor.thinkingcleaner.markdown b/source/_components/sensor.thinkingcleaner.markdown index 6d885939c2a..564fcbda43e 100644 --- a/source/_components/sensor.thinkingcleaner.markdown +++ b/source/_components/sensor.thinkingcleaner.markdown @@ -1,6 +1,6 @@ --- layout: page -title: "ThinkingCleaner" +title: "Thinking Cleaner sensors" description: "Instructions how to integrate a ThinkingCleaner within Home Assistant." date: 2016-04-10 17:24 sidebar: true @@ -10,8 +10,7 @@ footer: true logo: thinkingcleaner.png ha_category: Sensor ha_iot_class: "Local Poll" --------------------------- - +--- The `ThinkingCleaner` sensor platform simple displays information about your [ThinkingCleaner](http://www.thinkingcleaner.com) addon. @@ -23,4 +22,4 @@ sensor: - platform: thinkingcleaner ``` -This will automatically add sensors for each Thinking Cleaner in your network. \ No newline at end of file +This will automatically add sensors for each Thinking Cleaner in your network. diff --git a/source/_components/switch.thinkingcleaner.markdown b/source/_components/switch.thinkingcleaner.markdown index 8c559269e02..15c6d553d55 100644 --- a/source/_components/switch.thinkingcleaner.markdown +++ b/source/_components/switch.thinkingcleaner.markdown @@ -1,6 +1,6 @@ --- layout: page -title: "ThinkingCleaner" +title: "Thinking Cleaner switches" description: "Instructions how to integrate a ThinkingCleaner within Home Assistant." date: 2016-04-10 17:24 sidebar: true @@ -10,10 +10,9 @@ footer: true logo: thinkingcleaner.png ha_category: Switch ha_iot_class: "Local Poll" --------------------------- +--- - -The `ThinkingCleaner` switch platform simple displays information about your [ThinkingCleaner](http://www.thinkingcleaner.com) addon. +The `ThinkingCleaner` switch platform allows you to control your [ThinkingCleaner](http://www.thinkingcleaner.com) addon. To enable this switch in your installation, add the following to your `configuration.yaml` file: diff --git a/source/_components/thermostat.eq3btsmart.markdown b/source/_components/thermostat.eq3btsmart.markdown new file mode 100644 index 00000000000..645ed3c49d9 --- /dev/null +++ b/source/_components/thermostat.eq3btsmart.markdown @@ -0,0 +1,63 @@ +--- +layout: page +title: "EQ3 Bluetooth Smart Thermostats" +description: "Instructions how to integrate EQ3 Bluetooth Smart Thermostats into Home Assistant." +date: 2016-04-18 22:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: eq3.gif +ha_category: Thermostat +ha_iot_class: "Local Poll" +--- + +This platform allows you to integrate EQ3 Bluetooth Smart Thermostats. + +The only functionality is to set the temperature, there doesn't seem to be any way to query the temperature sensor or battery level ([read more](https://forum.fhem.de/index.php/topic,39308.15.html)). + +Setup is a bit more cumbersome than for most other thermostats. It has to be paired first: + +```bash +bluetoothctl +scan on + +scan off + +pair +trust +disconnect +exit +``` + +Then check with gatttool if the connection works as expected: + +```bash +gatttool -b 00:11:22:33:44:55 -I +[00:11:22:33:44:55][LE]> connect +Attempting to connect to 00:11:22:33:44:55 +Connection successful +[00:11:22:33:44:55][LE]> char-write-req 0x0411 03 +Characteristic value was written successfully +Notification handle = 0x0421 value: 02 01 09 14 04 2d +[00:11:22:33:44:55][LE]> disconnect +[00:11:22:33:44:55][LE]> exit +``` + +Important: For gatttool or homeassistant to work, the thermostat needs to be disconnected from bluetoothd, so I found it best to modify the hass-daemon startscript by adding: + +```bash +/usr/bin/bt-device -d CC-RT-BLE +``` + +to the start function of /etc/init.d/hass-daemon. + + +```yaml +# Example configuration.yaml entry +thermostat: + platform: eq3btsmart + devices: + room1: + mac: '00:11:22:33:44:55' +``` diff --git a/source/_posts/2016-04-21-bluetooth-lg-webos-tvs-and-roombas.markdown b/source/_posts/2016-04-21-bluetooth-lg-webos-tvs-and-roombas.markdown new file mode 100644 index 00000000000..3d5daf9d9fd --- /dev/null +++ b/source/_posts/2016-04-21-bluetooth-lg-webos-tvs-and-roombas.markdown @@ -0,0 +1,83 @@ +--- +layout: post +title: "0.18: Bluetooth, LG WebOS TVs and Roombas." +description: "Home Assistant 0.18 has arrived." +date: 2016-04-19 23:10:00 -0700 +date_formatted: "April 21, 2016" +author: Paulus Schoutsen +author_twitter: balloob +comments: true +categories: Release-Notes +--- + +It's time for 0.18. This release cycle is 2 days shorter than usual as I'll be travelling to Europe. This also means that it can take some more time before you get feedback on PRs. + +Since the last release we have moved all Home Assistant source code etc into it's own [organisation on GitHub](https://github.com/home-assistant). We're growing up! This sadly did cause us to have to move all Docker images. Check the breaking changes section for more info. + + + + + +- Media Player: redesign in the UI! ([@DesignFirst], [@balloob]) +- New component: [Zeroconf] for Home Assistant discovery ([@robbiet480]) +- Garage door: [MQTT] now supported ([@joelash]) +- Thermostat: [Homematic platform] now supports Max! devices ([@bimbar]) +- New component Thinkingcleaner ([switch][switch.thinkingcleaner]/[sensor][sensor.thinkingcleaner]) to integrate your Roomba into Home Assistant ([@TheRealLink]) +- New component: [upnp] to automatically open a upnp port on your router for Home Assistant ([@robbiet480]) +- Thermostat: [EQ3 Bluetooth Smart Thermostats] now supported ([@bimbar]) +- New component [Feedreader] will track RSS feeds ([@shaftoe]) +- Device Tracker: [Bluetooth tracking platform] added ([@vmulpuru]) +- Media Player: [LG WebOS TVs][media_player.lg] now supported ([@TheRealLink]) +- Notify: [LG WebOS TVs][notify.lg] now supported ([@TheRealLink]) +- HTTP: Use constant time comparison for auth ([@JshWright]) +- Config and service validations ([@jaharkes], [@Danielhiversen]) +- MySensors: Entity IDs will more clearly differentiate between node ID and child ID ([@oeysteinhansen]) +- MySensors: Add support for [ethernet gateway][mysensors] ([@MartinHjelmare]) +- Media player: [Plex] will now monitor the server and add clients as they pop up ([@infamy]) +- Core: We now use iso8601 for datetimes ([@balloob]). +- Media Player: [MPD] now supports service to play playlists ([@Cinntax]) +- Z-Wave should be a little bit more stable ([@Turbokongen]) +- Media Player: [Sonos] will now only add visible devices ([@jpmossin]) +- Light: [Wink] will now allow controlling the colors ([@bradsk88]) + +[@balloob]: https://github.com/balloob/ +[@bimbar]: https://github.com/bimbar/ +[@bradsk88]: https://github.com/bradsk88/ +[@Cinntax]: https://github.com/Cinntax/ +[@Danielhiversen]: https://github.com/Danielhiversen/ +[@DesignFirst]: https://github.com/DesignFirst/ +[@infamy]: https://github.com/infamy/ +[@jaharkes]: https://github.com/jaharkes/ +[@joelash]: https://github.com/joelash/ +[@jpmossin]: https://github.com/jpmossin/ +[@JshWright]: https://github.com/JshWright/ +[@MartinHjelmare]: https://github.com/MartinHjelmare/ +[@oeysteinhansen]: https://github.com/oeysteinhansen/ +[@robbiet480]: https://github.com/robbiet480/ +[@shaftoe]: https://github.com/shaftoe/ +[@TheRealLink]: https://github.com/TheRealLink/ +[@Turbokongen]: https://github.com/Turbokongen/ +[@vmulpuru]: https://github.com/vmulpuru/ +[Bluetooth tracking platform]: /components/device_tracker.bluetooth_tracker/ +[EQ3 Bluetooth Smart Thermostats]: /components/thermostat.eq3btsmart/ +[mysensors]: /components/mysensors/ +[Feedreader]: /components/feedreader/ +[Homematic platform]: /components/thermostat.homematic/ +[media_player.lg]: /components/media_player.webostv/ +[notify.lg]: /components/notify.webostv/ +[MPD]: /components/media_player.mpd/ +[MQTT]: /components/garage_door.mqtt/ +[Plex]: /components/media_player.plex/ +[Sonos]: /components/media_player.sonos/ +[sensor.Thinkingcleaner]: /components/sensor.thinkingcleaner/ +[switch.Thinkingcleaner]: /components/switch.thinkingcleaner/ +[upnp]: /components/upnp/ +[Wink]: /components/light.wink/ +[Zeroconf]: /components/zeroconf/ + +### Breaking changes +- We have migrated our datetime format to be iso8601. This will only impact you if you are consuming the date times from the API directly. You can ignore this if you are just using Home Assistant via configuration and the frontend. +- The location of the Docker image has changed. There was no possibility for us to keep maintaining the old image (as it was bound to the GitHub repo under my name) or to make a redirect. So if you are using the Home Assistant Docker image, change it to run `homeassistant/home-assistant:latest` for the latest release and `homeassistant/home-assistant:dev` for the latest dev version. +- MySensors received two big changes that will cause you to update your configs. See [component page][mysensors] for new example config. + 1. All MySensors entity IDs are different! There was an error in the naming that caused MySensors to append node ID and child ID instead of separating them with an underscore. This has been fixed but will cause all your MySensors entity IDs to change. This is a one time breaking change. + 2. The second change is that we now support the TCP ethernet gateway. This is causing a slight change to the config format: you have to change `port:` under `gateways` to `device:`. diff --git a/source/images/blog/2016-04-release-18/media_player.png b/source/images/blog/2016-04-release-18/media_player.png new file mode 100644 index 00000000000..1c4f763c656 Binary files /dev/null and b/source/images/blog/2016-04-release-18/media_player.png differ diff --git a/source/images/supported_brands/bluetooth.png b/source/images/supported_brands/bluetooth.png new file mode 100644 index 00000000000..e42de683d62 Binary files /dev/null and b/source/images/supported_brands/bluetooth.png differ diff --git a/source/images/supported_brands/eq3.gif b/source/images/supported_brands/eq3.gif new file mode 100644 index 00000000000..aa6158f94c3 Binary files /dev/null and b/source/images/supported_brands/eq3.gif differ diff --git a/source/images/supported_brands/rss.gif b/source/images/supported_brands/rss.gif new file mode 100644 index 00000000000..f392663d1be Binary files /dev/null and b/source/images/supported_brands/rss.gif differ diff --git a/source/images/supported_brands/thinkingcleaner.png b/source/images/supported_brands/thinkingcleaner.png new file mode 100644 index 00000000000..77dcd69963b Binary files /dev/null and b/source/images/supported_brands/thinkingcleaner.png differ diff --git a/source/images/supported_brands/thninkingcleaner.png b/source/images/supported_brands/thninkingcleaner.png deleted file mode 100644 index f6ff527d970..00000000000 Binary files a/source/images/supported_brands/thninkingcleaner.png and /dev/null differ