Blogpost about 0.7 release
This commit is contained in:
parent
81f2e68af4
commit
e2e5a078ab
10 changed files with 214 additions and 6 deletions
|
@ -15,6 +15,7 @@ Home Assistant can discover and automatically configure zeroconf/mDNS and uPnP d
|
|||
* Google Chromecast
|
||||
* Belkin WeMo switches
|
||||
* Philips Hue
|
||||
* Netgear routers
|
||||
|
||||
It will be able to add Google Chreomcasts and Belkin WeMo switches automatically, for Philips Hue it will require some configuration from the user.
|
||||
|
||||
|
|
|
@ -33,7 +33,10 @@ The MQTT component has no TLS support at the moment. This means that only plain-
|
|||
|
||||
## Building on top of MQTT
|
||||
|
||||
There are two ways to integrate MQTT into your process. One is by using the [MQTT-automation rule](/components/automation.html#mqtt-based-automation). The other one is by integrating it into a component. See the [MQTT example component](https://github.com/balloob/home-assistant/blob/dev/config/custom_components/mqtt_example.py) how to do this.
|
||||
- [MQTT Sensor](/components/sensor.mqtt.html)
|
||||
- [MQTT Switch](/components/switch.mqtt.html)
|
||||
- [MQTT-automation rule](/components/automation.html#mqtt-based-automation).
|
||||
- Integrating it into a component. See the [MQTT example component](https://github.com/balloob/home-assistant/blob/dev/config/custom_components/mqtt_example.py) how to do this.
|
||||
|
||||
## Testing
|
||||
|
||||
|
|
|
@ -1,7 +1,7 @@
|
|||
---
|
||||
layout: page
|
||||
title: "Bitcoin support"
|
||||
description: "Instructions how to integrate the time and the date within Home Assistant."
|
||||
description: "Instructions how to integrate Bitcoin data within Home Assistant."
|
||||
date: 2015-05-08 17:15
|
||||
sidebar: false
|
||||
comments: false
|
||||
|
|
|
@ -24,7 +24,7 @@ sensor:
|
|||
- humidity
|
||||
```
|
||||
|
||||
The name of the pin to which the sensor is connected has a different names on different platfroms. 'P8_11' for Beaglebone, '23' for Raspberry Pi.
|
||||
The name of the pin to which the sensor is connected has different names on different platforms. 'P8_11' for Beaglebone, '23' for Raspberry Pi.
|
||||
|
||||
<p class='note warning'>
|
||||
As this requires access to the GPIO, you will need to run Home Assistant as root.
|
||||
|
|
31
source/components/sensor.mqtt.markdown
Normal file
31
source/components/sensor.mqtt.markdown
Normal file
|
@ -0,0 +1,31 @@
|
|||
---
|
||||
layout: page
|
||||
title: "MQTT Sensor support"
|
||||
description: "Instructions how to integrate MQTT sensors within Home Assistant."
|
||||
date: 2015-05-30 23:21
|
||||
sidebar: false
|
||||
comments: false
|
||||
sharing: true
|
||||
footer: true
|
||||
---
|
||||
|
||||
<img src='/images/supported_brands/mqtt.png' class='brand pull-right' />
|
||||
This generic sensor implementation uses the MQTT message payload
|
||||
as the sensor value. If messages in this state_topic are published
|
||||
with RETAIN flag, the sensor will receive an instant update with
|
||||
last known value. Otherwise, the initial state will be undefined.
|
||||
|
||||
```yaml
|
||||
# Example configuration.yml entry
|
||||
sensor:
|
||||
platform: mqtt
|
||||
name: "MQTT Sensor"
|
||||
state_topic: "home/bedroom/temperature"
|
||||
unit_of_measurement: "ºC"
|
||||
```
|
||||
|
||||
state_topic: The MQTT topic subscribed to receive sensor values. *Required*
|
||||
|
||||
name: The name of the sensor. Default is 'MQTT Sensor'. *Optional*
|
||||
|
||||
unit_of_measurement: Defines the units of measurement of the sensor, if any. *Optional*
|
49
source/components/switch.mqtt.markdown
Normal file
49
source/components/switch.mqtt.markdown
Normal file
|
@ -0,0 +1,49 @@
|
|||
---
|
||||
layout: page
|
||||
title: "MQTT switch support"
|
||||
description: "Instructions how to integrate MQTT switches into Home Assistant."
|
||||
date: 2015-08-30 23:38
|
||||
sidebar: false
|
||||
comments: false
|
||||
sharing: true
|
||||
footer: true
|
||||
---
|
||||
|
||||
<img src='/images/supported_brands/mqtt.png' class='brand pull-right' />
|
||||
In an ideal scenario, the MQTT device will have a state topic to publish
|
||||
state changes. If these messages are published with RETAIN flag, the MQTT
|
||||
switch will receive an instant state update after subscription and will
|
||||
start with correct state. Otherwise, the initial state of the switch will
|
||||
be false/off.
|
||||
|
||||
When a state topic is not available, the switch will work in optimistic mode.
|
||||
In this mode, the switch will immediately change state after every command.
|
||||
Otherwise, the switch will wait for state confirmation from device
|
||||
(message from state_topic).
|
||||
|
||||
Optimistic mode can be forced, even if state topic is available.
|
||||
Try to enable it, if experiencing incorrect switch operation.
|
||||
|
||||
```yaml
|
||||
# Example configuration.yml entr
|
||||
switch:
|
||||
platform: mqtt
|
||||
name: "Bedroom Switch"
|
||||
state_topic: "home/bedroom/switch1"
|
||||
command_topic: "home/bedroom/switch1/set"
|
||||
payload_on: "ON"
|
||||
payload_off: "OFF"
|
||||
optimistic: false
|
||||
```
|
||||
|
||||
command_topic: The MQTT topic to publish commands to change the switch state. *Required*
|
||||
|
||||
name: The name of the switch. Default is 'MQTT Switch'. *Optional*
|
||||
|
||||
state_topic: The MQTT topic subscribed to receive state updates. *Optional*
|
||||
|
||||
payload_on: The payload that represents enabled state. Default is "ON". *Optional*
|
||||
|
||||
payload_off: The payload that represents disabled state. Default is "OFF". *Optional*
|
||||
|
||||
optimistic: Flag that defines if switch works in optimistic mode. Default is true if no state topic defined, else false. *Optional*
|
|
@ -9,10 +9,10 @@ sharing: true
|
|||
footer: true
|
||||
---
|
||||
|
||||
<img src='/images/supported_brands/belkin_wemo.png' class='brand' />
|
||||
The wemo platform allows you to control your [Belkin WeMo](http://www.belkin.com/us/p/P-F7C027/) switches from within Home Assistant.
|
||||
<img src='/images/supported_brands/belkin_wemo.png' class='brand pull-right' />
|
||||
The wemo platform allows you to control your [Belkin WeMo](http://www.belkin.com/us/p/P-F7C027/) switches from within Home Assistant.
|
||||
|
||||
To add Wemo switches to your installation, add the following to your `configuration.yaml` file:
|
||||
They will be automatically discovered if the discovery component is enabled.
|
||||
|
||||
```yaml
|
||||
# Example configuration.yaml entry
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue