diff --git a/_config.yml b/_config.yml index 0c9b301a4ce..333f044a7d7 100644 --- a/_config.yml +++ b/_config.yml @@ -128,9 +128,9 @@ social: # Home Assistant release details current_major_version: 0 current_minor_version: 40 -current_patch_version: 0 -date_released: 2017-03-11 +current_patch_version: 1 +date_released: 2017-03-16 # Either # or the anchor link to latest release notes in the blog post. # Must be prefixed with a # and have double quotes around it. -patch_version_notes: "#" +patch_version_notes: "#release-0401---march-16" diff --git a/sass/custom/_paulus.scss b/sass/custom/_paulus.scss index 0f870b81f88..a0467c869e6 100644 --- a/sass/custom/_paulus.scss +++ b/sass/custom/_paulus.scss @@ -330,6 +330,21 @@ p.note { -moz-transition-property: -moz-transform, opacity; transition-property: transform, opacity; } + + + .component-search{ + margin-bottom: 24px; + + input{ + width: 100%; + padding: 10px; + + background-color: #fefefe; + border-radius: 2px; + border: 1px solid; + border-color: #7c7c7c #c3c3c3 #ddd; + } + } } @media only screen and (max-width: $lap-end) { diff --git a/source/_components/binary_sensor.apcupsd.markdown b/source/_components/binary_sensor.apcupsd.markdown index 946c0112062..6c599b75b15 100644 --- a/source/_components/binary_sensor.apcupsd.markdown +++ b/source/_components/binary_sensor.apcupsd.markdown @@ -8,7 +8,7 @@ comments: false sharing: true footer: true logo: apcupsd.png -ha_category: Binary Sensor +ha_category: System Monitor ha_release: 0.13 ha_iot_class: "Local Polling" --- diff --git a/source/_components/binary_sensor.bbb_gpio.markdown b/source/_components/binary_sensor.bbb_gpio.markdown index 7d8cb35055e..3a11b6cd6ac 100644 --- a/source/_components/binary_sensor.bbb_gpio.markdown +++ b/source/_components/binary_sensor.bbb_gpio.markdown @@ -19,12 +19,12 @@ To use your BeagleBone Black's GPIO in your installation, add the following to y ```yaml # Example configuration.yaml entry binary_sensor: - - platform: bbb_gpio - pins: - P8_12: - name: Door - GPIO0_26: - name: Window + - platform: bbb_gpio + pins: + P8_12: + name: Door + GPIO0_26: + name: Window ``` Configuration variables: diff --git a/source/_components/device_tracker.unifi.markdown b/source/_components/device_tracker.unifi.markdown index f1586d50948..49fd805edd8 100644 --- a/source/_components/device_tracker.unifi.markdown +++ b/source/_components/device_tracker.unifi.markdown @@ -32,5 +32,6 @@ Configuration variables: - **username** (*Required*: The username of an user with administrative privileges, usually `admin`. - **password** (*Required*): The password for your given admin account. - **site_id** (*Optional*): Allows you to specify a `site_id` for device tracking. Defaults to `default`. Found in the URL of the controller (i.e. https://CONTROLLER:PORT/manage/site/SITE_ID/dashboard) +- **verify_ssl** (*Optional*): Controls if the SSL certificate running on your Unifi webserver must be trusted by a known Certificate Authority on the server running Home Assistant. Defaults to 'True'. See the [device tracker component page](/components/device_tracker/) for instructions how to configure the people to be tracked. diff --git a/source/_components/discovery.markdown b/source/_components/discovery.markdown index 0ab17fea3da..b0f0acb04cf 100644 --- a/source/_components/discovery.markdown +++ b/source/_components/discovery.markdown @@ -26,6 +26,10 @@ Home Assistant can discover and automatically configure zeroconf/mDNS and uPnP d * Logitech media server (Squeezebox) * DirecTV * Apple TV + * Yeelight Sunflower Bulb + * Flux Led/MagicLight + * Linn / Openhome + * Denon Network Receivers It will be able to add Google Chromecasts and Belkin WeMo switches automatically, for Philips Hue it will require some configuration from the user. @@ -43,6 +47,24 @@ Configuration variables: - **ignore** (*Optional*): A list of platforms that never will be automatically configured by `discovery`. +Valid values for ignore are: + * philips_hue: (Philips Hue) + * google_cast: (Google Chromecast) + * panasonic_viera: (Panasonic Viera) + * plex_mediaserver: (Plex media server) + * roku: (Roku media player) + * sonos: (Sonos Speakers) + * yamaha: (Yamaha media player) + * logitech_mediaserver: (Logitech media server - Squeezebox player) + * directv: (DirecTV) + * denonavr: (Denon Network Receivers) + * samsung_tv: (Samsung TV) + * yeelight: (Yeelight Sunflower Bulb) + * flux_led: (Flux Led/MagicLight) + * apple_tv: (Apple TV) + * openhome: (Linn / Openhome) + +
Home Assistant must be on the same network as the devices for uPnP discovery to work. If running Home Assistant in a Docker container use switch `--net=host` to put it on the host's network. diff --git a/source/_components/influxdb.markdown b/source/_components/influxdb.markdown index c1382750bff..4c69b010c1a 100644 --- a/source/_components/influxdb.markdown +++ b/source/_components/influxdb.markdown @@ -2,7 +2,7 @@ layout: page title: "InfluxDB" description: "Record events in InfluxDB." -date: 2015-12-06 13:08 +date: 2017-03-13 22:09 sidebar: true comments: false sharing: true @@ -27,7 +27,7 @@ You will still need to create a database named `home_assistant` via InfluxDB's w Configuration variables: -- **host** (*Optional*): IP address of your database host, eg. 192.168.1.10. Defaults to `localhost`. +- **host** (*Optional*): IP address of your database host, e.g. 192.168.1.10. Defaults to `localhost`. - **port** (*Optional*): Port to use. Defaults to 8086. - **username** (*Optional*): The username of the database user. - **password** (*Optional*): The password for the database user account. @@ -35,8 +35,8 @@ Configuration variables: - **ssl** (*Optional*): Use https instead of http to connect. Defaults to false. - **verify_ssl** (*Optional*): Verify SSL certificate for https request. Defaults to false. - **default_measurement** (*Optional*): Measurement name to use when an entity doesn't have a unit. Defaults to entity id. -- **override_measurement** (*Optional*): Measurement name to use instead of unit or default measurement. This will store all data points in the singel same measurement. -- **blacklist** (*Optional*): List of entities not logged to InfluxDB. +- **override_measurement** (*Optional*): Measurement name to use instead of unit or default measurement. This will store all data points in a single measurement. +- **blacklist** (*Optional*): List of entities that should not be logged to InfluxDB. - **whitelist** (*Optional*): List of the entities (only) that will be logged to InfluxDB. If not set, all entities will be logged. Values set by the **blacklist** option will prevail. - **tags** (*Optional*): Tags to mark the data. @@ -44,23 +44,23 @@ Configuration variables: Starting with 0.36 the InfluxDB component has a new schema to store values in the InfluxDB databases. -- There will not be any tags/fields named time anymore. +- There will no longer be any tags/fields named `time`. - All numeric fields (int/float/bool) will be stored as float inside InfluxDB database. - All string fields corresponding to state attributes will be renamed as `FIELDNAME_str`, where `FIELDNAME` is the state attribute, to avoid type conflicts. -- All string fields corresponding to a state will be renamed as state (former value). -- Fields named value will always be stored as float. -- Fields named state will always be stored as string. +- All string fields corresponding to a state will be renamed as `state` (former value). +- Fields named `value` will always be stored as float. +- Fields named `state` will always be stored as string. ### {% linkable_title Migration script %} -If you need to migrate your database, you may require to run the `influxdb_migrator` script. Run the script after upgrade to 0.36 but before first regular start of `hass` version 0.36. +If you need to migrate your database, you may require to run the `influxdb_migrator` script. Run the script after upgrade to 0.36 but before the first regular start of `hass` version 0.36. These are the steps the script will perform: 1. Create a new database (called `DBNAME__old`) to store old data. 2. Copy data from `DBNAME` database to `DBNAME__old` database. 3. Empty `DBNAME` database (using `drop` then `create`). `DBNAME` database is now considered as the new database. 4. For each measurement of `DBNAME__old` database: - 1. Read all points from the current measuremnt (by group of `1000` points by default) and convert them. + 1. Read all points from the current measurement (in groups of 1000 points by default) and convert them. 2. Send group of points to `DBNAME` database. 5. Delete the `DBNAME__old` database if needed. @@ -94,7 +94,7 @@ optional arguments: - If you run the script with only the `-h` option, you will get a help printout with a short explanation of the different options. - The host option defaults to `'127.0.0.1'`. - The port option defaults to `8086`. -- You should be able to omit username and password, if InfluxDB authentication is disabled, which it is by default. +- You should be able to omit username and password if InfluxDB authentication is disabled, which it is by default. - The step option defaults to `1000`. diff --git a/source/_components/joaoapps_join.markdown b/source/_components/joaoapps_join.markdown index 44ac2587f7c..ca6ea4650c2 100644 --- a/source/_components/joaoapps_join.markdown +++ b/source/_components/joaoapps_join.markdown @@ -37,7 +37,7 @@ Configuration variables: - **device_id** (*Required*): The Id of your device. - **api_key** (*Required*): The API key for Join. -The notify service has a few optional parameters such as icon and small icon. You can use them like so: +The notify service has two optional parameters: `icon` and `small icon`. You can use them like so: ```json {"message":"Hello!","title":"From Hass","data":{"icon":"https://goo.gl/KVqcYi","smallicon":"http://goo.gl/AU4Wf1"}} diff --git a/source/_components/light.lifx.markdown b/source/_components/light.lifx.markdown index d4be5e91192..e50d445296c 100644 --- a/source/_components/light.lifx.markdown +++ b/source/_components/light.lifx.markdown @@ -19,12 +19,8 @@ The `lifx` platform allows you to integrate your [LIFX](http://www.lifx.com) int # Example configuration.yaml entry light: - platform: lifx - broadcast: 192.168.1.255 + server: 192.168.1.10 ``` Configuration variables: - **server** (*Optional*): Your server address. Only needed if using more than one network interface. Omit if you are unsure. -- **broadcast** (*Optional*): The broadcast address, set to reach all LIFX bulbs. - -If there is an issue with lights not showing up when Home Assistant is restarted, add broadcast to your configuration. - diff --git a/source/_components/light.yeelightsunflower.markdown b/source/_components/light.yeelightsunflower.markdown index 8db047f6c9f..324ee4b2e8d 100644 --- a/source/_components/light.yeelightsunflower.markdown +++ b/source/_components/light.yeelightsunflower.markdown @@ -11,10 +11,11 @@ ha_category: Light ha_release: 0.39 --- -The `yeelightsunflower` light platform allows you to control your Yeelight Sunflower light bulbs with Home Assistant. -Note that the "Yeelight Sunflower" bulbs are not the same as the "Yeelight WiFi" bulbs. +The `yeelightsunflower` light platform allows you to control your Yeelight Sunflower light bulbs with Home Assistant. -### {% linkable_title Example configuration %} +
+The "Yeelight Sunflower" bulbs are not the same as the "Yeelight WiFi" bulbs. +
To enable your lights, add the following lines to your `configuration.yaml` file: @@ -37,4 +38,3 @@ When the hub is loaded, your lights will appear as devices with their Zigbee IDs The Yeelight Sunflower hub supports SSDP discovery, but that has not been built into the platform. Let the developer know if that would be helpful to you. - diff --git a/source/_components/media_player.firetv.markdown b/source/_components/media_player.firetv.markdown index 56798dd11db..aab8c253e0f 100644 --- a/source/_components/media_player.firetv.markdown +++ b/source/_components/media_player.firetv.markdown @@ -28,7 +28,7 @@ Steps to configure your Amazon Fire TV stick with Home Assistant: - From the main (Launcher) screen, select Settings. - Select System > About > Network. - The following commands must be run in a Python 2.x environment. They will allow the component to function in an Ubuntu 16.04/Hassbian environment. - - `apt-get install swig libssl-dev python-dev libusb-1.0-0` + - `apt-get install swig libssl-dev python-dev libusb-1.0-0 python-yaml` - `pip install flask` - `pip install https://pypi.python.org/packages/source/M/M2Crypto/M2Crypto-0.24.0.tar.gz` - `pip install firetv[firetv-server]` diff --git a/source/_components/media_player.gstreamer.markdown b/source/_components/media_player.gstreamer.markdown index 5b50029da7a..c77e8c40496 100644 --- a/source/_components/media_player.gstreamer.markdown +++ b/source/_components/media_player.gstreamer.markdown @@ -37,7 +37,7 @@ And then install the following system dependencies: Debian/Ubuntu/Rasbian: ```bash -sudo apt-get install python-gst-1.0 \ +sudo apt-get install python3-gst-1.0 \ gir1.2-gstreamer-1.0 gir1.2-gst-plugins-base-1.0 \ gstreamer1.0-plugins-good gstreamer1.0-plugins-ugly \ gstreamer1.0-tools diff --git a/source/_components/media_player.samsungtv.markdown b/source/_components/media_player.samsungtv.markdown index c59a7b8c084..75b386d7867 100644 --- a/source/_components/media_player.samsungtv.markdown +++ b/source/_components/media_player.samsungtv.markdown @@ -32,7 +32,7 @@ Configuration variables: - **host** (*Required*): The IP of the Samsung Smart TV, eg. `192.168.0.10`. - **port** (*Optional*): The port of the Samsung Smart TV. Defaults to 55000. If set to 8001, the new websocket connection will be used (required for 2016+ TVs). - **name** (*Optional*): The name you would like to give to the Samsung Smart TV. -- **timeout** (*Optional*): The time-out for the communication with the TV. Defaults to 0. +- **timeout** (*Optional*): The time-out in seconds for the communication with the TV. Defaults to 0 (no timeout). - **mac** (*Optional*): The MAC address of the Samsung Smart TV, eg. `00:11:22:33:44:55:66`. Required for power on support via wake on lan. Currently known supported models: @@ -44,6 +44,7 @@ Currently known supported models: - ES6800 - F6300 - F6500 +- EH5300 - EH5600 - F6400AF - D6505 diff --git a/source/_components/notify.twilio_call.markdown b/source/_components/notify.twilio_call.markdown index 9458a14ca0c..9caf251d046 100644 --- a/source/_components/notify.twilio_call.markdown +++ b/source/_components/notify.twilio_call.markdown @@ -9,18 +9,13 @@ sharing: true footer: true logo: twilio.png ha_category: Notifications -ha_release: "0.37" +ha_release: 0.37 --- -The `twilio` notification platform enables sending notifications via Voice, powered by [Twilio](https://twilio.com). +The `twilio_call` notification platform enables sending notifications via Voice, powered by [Twilio](https://twilio.com). Passed message will be read by Text-To-Speech service. -This component is just an adaptation from the Twilio SMS notification platform and won't exist without it. - -Free trial account is available at [Twilio](https://twilio.com) website providing free calls to verified phone numbers. -Calls are limited to 10 minutes and will play a short trial message before your message runs. - -Upgraded accounts have no limitation. +The requirement is that you have setup [Twilio](/components/twilio/). To use this notification platform in your installation, add the following to your `configuration.yaml` file: @@ -29,15 +24,11 @@ To use this notification platform in your installation, add the following to you notify: - name: NOTIFIER_NAME platform: twilio_call - account_sid: ACCOUNT_SID_FROM_TWILIO - auth_token: AUTH_TOKEN_FROM_TWILIO from_number: E164_PHONE_NUMBER ``` Configuration variables: -- **account_sid** (*Required*): Your Twilio Account SID which can be found in your [console](https://www.twilio.com/console). It starts with the letters `AC`. -- **auth_token** (*Required*): Your Twilio Account SID which can be found in your [console](https://www.twilio.com/console). It should be directly under where you found the `account_sid`. - **from_number** (*Required*): An [E.164](https://en.wikipedia.org/wiki/E.164) formatted phone number, like +14151234567. See [Twilio's guide to formatting phone numbers](https://www.twilio.com/help/faq/phone-numbers/how-do-i-format-phone-numbers-to-work-internationally) for more information. - **name** (*Optional*): Setting the optional parameter `name` allows multiple notifiers to be created. The default value is `notify`. The notifier will bind to the service `notify.NOTIFIER_NAME`. diff --git a/source/_components/notify.twilio_sms.markdown b/source/_components/notify.twilio_sms.markdown index 6931d2507eb..1e35c14866e 100644 --- a/source/_components/notify.twilio_sms.markdown +++ b/source/_components/notify.twilio_sms.markdown @@ -14,6 +14,8 @@ ha_release: "0.20" The `twilio` notification platform enables sending notifications via SMS, powered by [Twilio](https://twilio.com). +The requirement is that you have setup [Twilio](/components/twilio/). + To use this notification platform in your installation, add the following to your `configuration.yaml` file: ```yaml @@ -21,15 +23,11 @@ To use this notification platform in your installation, add the following to you notify: - name: NOTIFIER_NAME platform: twilio_sms - account_sid: ACCOUNT_SID_FROM_TWILIO - auth_token: AUTH_TOKEN_FROM_TWILIO from_number: E164_PHONE_NUMBER ``` Configuration variables: -- **account_sid** (*Required*): Your Twilio Account SID which can be found in your [console](https://www.twilio.com/console). It starts with the letters `AC`. -- **auth_token** (*Required*): Your Twilio Account SID which can be found in your [console](https://www.twilio.com/console). It should be directly under where you found the `account_sid`. - **from_number** (*Required*): An [E.164](https://en.wikipedia.org/wiki/E.164) formatted phone number, like +14151234567. See [Twilio's guide to formatting phone numbers](https://www.twilio.com/help/faq/phone-numbers/how-do-i-format-phone-numbers-to-work-internationally) for more information. - **name** (*Optional*): Setting the optional parameter `name` allows multiple notifiers to be created. The default value is `notify`. The notifier will bind to the service `notify.NOTIFIER_NAME`. diff --git a/source/_components/notify.webostv.markdown b/source/_components/notify.webostv.markdown index 24ab68a53a5..537039581dd 100644 --- a/source/_components/notify.webostv.markdown +++ b/source/_components/notify.webostv.markdown @@ -33,6 +33,7 @@ Configuration variables: - **host** (*Required*): The IP of the LG WebOS Smart TV, e.g. 192.168.0.10 - **name** (*Required*): The name you would like to give to the LG WebOS Smart TV. - **filename** (*Optional*): The filename where the pairing key with the TV should be stored. This path is relative to Home Assistant's config directory. It defaults to `webostv.conf`. +- **icon** (*Optional*): The path to an image file to use as the icon in notifications. If provided, this image will override the Home Assistant logo. A possible automation could be: @@ -49,3 +50,20 @@ automation: data: message: "You should open a window! (Livingroom Co2: {{ states.sensor.netatmo_livingroom_co2.state }}ppm)" ``` + +The icon can be overridden for individual notifications by providing a path to an alternative icon image to use: + +```yaml +automation: + - alias: Front door motion + trigger: + platform: state + entity_id: binary_sensor.front_door_motion + state: 'on' + action: + service: notify.livingroom_tv + data: + message: "Movement detected: Front Door" + data: + icon: "/home/homeassistant/images/doorbell.png" + ``` diff --git a/source/_components/rflink.markdown b/source/_components/rflink.markdown index 43fe9c4b609..e33633485f4 100644 --- a/source/_components/rflink.markdown +++ b/source/_components/rflink.markdown @@ -94,6 +94,9 @@ Wildcards only work at the end of the ID, not in the middle of front! Even though a lot of devices are supported by Rflink, not all have been tested/implemented. If you have a device supported by Rflink but not by this component please consider testing and adding support yourself or [create an issue](https://github.com/home-assistant/home-assistant/issues/new) and mention `@aequitas` in the description. +### {% linkable_title Device Incorrectly Identified %} + +If you find a device is recognized differently, with different protocols or the ON OFF is swapped or detected as two ON commands, it can be overcome with the RFlink 'RF Signal Learning' mechanism from RFLink Rev 46 (11 March 2017). http://www.nemcon.nl/blog2/faq#RFFind. ### {% linkable_title Technical overview %} diff --git a/source/_components/sensor.apcupsd.markdown b/source/_components/sensor.apcupsd.markdown index d7e6ae6ae36..57478d821ba 100644 --- a/source/_components/sensor.apcupsd.markdown +++ b/source/_components/sensor.apcupsd.markdown @@ -8,7 +8,8 @@ comments: false sharing: true footer: true logo: apcupsd.png -ha_category: Sensor +ha_release: 0.13 +ha_category: System Monitor --- The `apcupsd` sensor platform allows you to monitor a UPS (battery backup) by using data from the [apcaccess](http://linux.die.net/man/8/apcaccess) command. diff --git a/source/_components/sensor.comed_hourly_pricing.markdown b/source/_components/sensor.comed_hourly_pricing.markdown index 31480bc0635..05bef462697 100644 --- a/source/_components/sensor.comed_hourly_pricing.markdown +++ b/source/_components/sensor.comed_hourly_pricing.markdown @@ -13,10 +13,12 @@ ha_release: "0.40" ha_iot_class: "Cloud Polling" --- -The ComEd Hourly Pricing program is an optional program available to ComEd electric subscribers which charges customers a variable rate for electricity supply based on current demand rather than a traditional fixed rate. Live prices are published [here](https://hourlypricing.comed.com/live-prices/) and also via an [API](https://hourlypricing.comed.com/hp-api/) which we can integrate as a sensor in Home Assistant. +The ComEd Hourly Pricing program is an optional program available to ComEd electric subscribers which charges customers a variable rate for electricity supply based on current demand rather than a traditional fixed rate. Live prices are published [here](https://hourlypricing.comed.com/live-prices/) and also via an [API](https://hourlypricing.comed.com/hp-api/) which we can integrate as a sensor in Home Assistant. There are two price feeds available: the 5-minute price and current hour average price. +To use this sensor in your installation, add the following to your `configuration.yaml` file: + ```yaml # Example configuration.yaml entry sensor: @@ -33,5 +35,5 @@ Configuration variables: - **five_minute**: The latest 5-minute price in cents. - **current_hour_average**: The latest current hour average price in cents. - **name** (*Optional*): Custom name for the sensor. - - **offset** (*Optional*): The pricing feeds provide only the *supply* cost of the electricity. The offset parameter allows you to provide a fixed constant that will be added to the pricing data to provide a more accurate representation of the total electricity cost per kWh. + - **offset** (*Optional*): The pricing feeds provide only the *supply* cost of the electricity. The offset parameter allows you to provide a fixed constant that will be added to the pricing data to provide a more accurate representation of the total electricity cost per kWh. diff --git a/source/_components/sensor.hydroquebec.markdown b/source/_components/sensor.hydroquebec.markdown index d49ecdf9ba6..0784fee0f84 100644 --- a/source/_components/sensor.hydroquebec.markdown +++ b/source/_components/sensor.hydroquebec.markdown @@ -22,24 +22,18 @@ sensor: - platform: hydroquebec username: MYUSERNAME password: MYPASSWORD + contract: 'CONTRACT#' (NOTE:works with the ' ' ,insert your contract in between) monitored_variables: - period_total_bill - period_length - period_total_days - - period_mean_daily_bill - - period_mean_daily_consumption - - period_total_consumption - - period_lower_price_consumption - - period_higher_price_consumption - - yesterday_total_consumption - - yesterday_lower_price_consumption - - yesterday_higher_price_consumption ``` Configuration variables: -- **username** (*Required*): The App Token for your account. -- **password** (*Required*): The App Token for your account. +- **username** (*Required*): Username used to log into the Hydro-Québec site. +- **password** (*Required*): Password used to log into the Hydro-Québec site. +- **contract** (required since HA 4.0) Your contract number with Hydro-Québec - **monitored_variables** array (*Required*): Variables to monitor. - **period_total_bill** : Current period bill - **period_length**: Current period length diff --git a/source/_components/sensor.kwb.markdown b/source/_components/sensor.kwb.markdown new file mode 100644 index 00000000000..c53b43e8c27 --- /dev/null +++ b/source/_components/sensor.kwb.markdown @@ -0,0 +1,59 @@ +--- +layout: page +title: "KWB Easyfire Sensor" +description: "Instructions how to integrate the KWB Easyfire sensor into Home Assistant." +date: 2017-03-06 14:10 +sidebar: true +comments: false +sharing: true +footer: true +logo: kwb.png +ha_category: Sensor +ha_iot_class: "Local Polling" +ha_release: 0.40 +--- + +The `kwb` component integrates the sensors of KWB Easyfire pellet central heating units with the Comfort3 controller (http://www.kwbheizung.de/de/produkte/kwb-comfort-3.html) into Home Assistant. + +Direct connection via serial (RS485) or via telnet terminal server is supported. The serial cable has to be attached to the control unit port 25 (which is normally used for detached control terminals). + +Since this serial protocol is proprietary and closed, only most temperature sensors and a few control relays are supported, the rest is still WIP (see https://www.mikrocontroller.net/topic/274137). + +Direct connection via serial port: +```yaml +# Example configuration.yaml entry +- platform: kwb + name: kwb + device: "/dev/ttyUSB0" + type: serial + raw: False +``` + +Telnet terminal server with a serial-ethernet converter: +```yaml +# Example configuration.yaml entry + - platform: kwb + name: kwb + host:
diff --git a/source/_components/switch.bbb_gpio.markdown b/source/_components/switch.bbb_gpio.markdown
index 58022c11f3e..a77ac8560f7 100644
--- a/source/_components/switch.bbb_gpio.markdown
+++ b/source/_components/switch.bbb_gpio.markdown
@@ -19,12 +19,12 @@ To use yourBeagleBone Black's GPIO in your installation, add the following to yo
```yaml
# Example configuration.yaml entry
switch:
- - platform: bbb_gpio
- pins:
- GPIO0_7:
- name: LED Red
- P9_12:
- name: LED Green
+ - platform: bbb_gpio
+ pins:
+ GPIO0_7:
+ name: LED Red
+ P9_12:
+ name: LED Green
```
Configuration variables:
diff --git a/source/_components/tts.amazon_polly.markdown b/source/_components/tts.amazon_polly.markdown
index 74a72492ac7..7433a526a74 100644
--- a/source/_components/tts.amazon_polly.markdown
+++ b/source/_components/tts.amazon_polly.markdown
@@ -15,7 +15,7 @@ ha_release: 0.37
The `amazon_polly` text-to-speech platform that works with [Amazon Polly](https://aws.amazon.com/polly/) to create the spoken output.
Polly is a paid service via Amazon Web Services. There is a [free tier](https://aws.amazon.com/polly/pricing/) for the first 12 months and then a charge per million characters afterwards.
-To enable text-to-speech with Amazon Polly, add the following lines to your `configuration.yaml`:
+To get started, add the following lines to your `configuration.yaml` (example for Amazon Polly):
```yaml
# Example configuration.yaml entry
@@ -29,9 +29,54 @@ tts:
Configuration variables:
-- **aws_access_key_id** (*Required if aws_secret_access_key is provided*): Your AWS Access Key ID. For more information, please read the [AWS General Reference regarding Security Credentials](http://docs.aws.amazon.com/general/latest/gr/aws-security-credentials.html). If provided, you must also provide an `aws_secret_access_key` and must **not** provide a `profile_name`.
-- **aws_secret_access_key** (*Required if aws_access_key_id is provided*): Your AWS Secret Access Key. For more information, please read the [AWS General Reference regarding Security Credentials](http://docs.aws.amazon.com/general/latest/gr/aws-security-credentials.html). If provided, you must also provide an `aws_access_key_id` and must **not** provide a `profile_name`.
-- **profile_name** (*Optional*): A credentials profile name. For more information, please see the [boto3 documentation section about credentials](http://boto3.readthedocs.io/en/latest/guide/configuration.html#shared-credentials-file).
-- **region_name** (*Required*): The region identifier to connect to. The default is `us-east-1`.
-- **name** (*Optional*): Setting the optional parameter `name` allows multiple notifiers to be created. The default value is `notify`. The notifier will bind to the service `notify.NOTIFIER_NAME`.
+| Parameter | Value | Description |
+|---------------------|----------|-------------|
+| `aws_access_key_id` | Required | Your AWS Access Key ID. For more information, please read the [AWS General Reference regarding Security Credentials](http://docs.aws.amazon.com/general/latest/gr/aws-security-credentials.html). If provided, you must also provide an `aws_secret_access_key` and must **not** provide a `profile_name` |
+| `aws_secret_access_key` | Required | Your AWS Secret Access Key. For more information, please read the [AWS General Reference regarding Security Credentials](http://docs.aws.amazon.com/general/latest/gr/aws-security-credentials.html). If provided, you must also provide an `aws_access_key_id` and must **not** provide a `profile_name`. |
+| `profile_name` | Optional | A credentials profile name. For more information, please see the [boto3 |
+| `region_name` | Optional | The region identifier to connect to. The default is `us-east-1`. |
+| `name` | Optional | Setting the optional parameter `name` allows multiple notifiers to be created. The default value is `notify`. The notifier will bind to the service `notify.NOTIFIER_NAME`.
+ |
+| `text_type` | text/ssml | text or ssml: Specify wherever to use text (default) or ssml markup |
+## Usage
+Say to all `media_player` device entities:
+```yaml
+- service: tts.amazon_polly_say
+ data_template:
+ message: '