From f74a11110ecc9c1f25574a63e277180347d4d648 Mon Sep 17 00:00:00 2001 From: Nate Clark Date: Mon, 18 Feb 2019 15:36:10 -0500 Subject: [PATCH 1/3] add temperature sensor config documentation for Konnected --- source/_components/konnected.markdown | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/source/_components/konnected.markdown b/source/_components/konnected.markdown index d6b35102fd38..d66b2815075b 100644 --- a/source/_components/konnected.markdown +++ b/source/_components/konnected.markdown @@ -12,6 +12,7 @@ ha_category: - Alarm - Binary Sensor - Switch + - Sensor ha_release: "0.70" redirect_from: - /components/binary_sensor.konnected/ @@ -94,6 +95,24 @@ devices: description: Inverts the open/closed meaning of a binary sensor circuit. Commonly needed for normally open wired smoke alarm circuits. required: false default: false + sensors: + description: A list of digital sensors (currently supported: DHT and DS18B20 sensors) connected to the device + required: false + type: list + keys: + pin: + description: The number corresponding to the _IO index_ of the labeled pin on the NodeMCU dev board. See the [NodeMCU GPIO documentation](https://nodemcu.readthedocs.io/en/master/en/modules/gpio/) for more details. Valid values are 1, 2, 5, 6, 7 and 8. + required: exclusive + zone: + description: The number corresponding to the labeled zone on the [Konnected Alarm Panel](https://konnected.io) board or the word `out` to specify the dedicated ALARM/OUT terminal on the Konnected board. Valid values are `1`, `2`, `3`, `4`, `5` and `out`. + required: exclusive + name: + description: The name of the device used in the front end. + required: false + default: automatically generated + type: + description: The type of sensor. Valid values: `dht` or `ds18b20` + required: true switches: description: A list of actuators (on/off switches) connected to the device. See [Konnected Switch](/components/switch.konnected/) for configuration variables. required: false @@ -213,6 +232,10 @@ Konnected runs on an ESP8266 board with the NodeMCU firmware. It is commonly use ### {% linkable_title Revision History %} +#### 0.89 + +- Added support for `dht` and `ds18b20` temperature sensors + #### 0.80 - Added ability to specify `host` and `port` to set up devices without relying on discovery. From ce2e435937ec92a7596a3d9a94741e16b3593ae8 Mon Sep 17 00:00:00 2001 From: Nate Clark Date: Mon, 18 Feb 2019 19:50:45 -0500 Subject: [PATCH 2/3] update Konnected sensor doc --- source/_components/konnected.markdown | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/source/_components/konnected.markdown b/source/_components/konnected.markdown index d66b2815075b..9a8c8ece6976 100644 --- a/source/_components/konnected.markdown +++ b/source/_components/konnected.markdown @@ -96,22 +96,22 @@ devices: required: false default: false sensors: - description: A list of digital sensors (currently supported: DHT and DS18B20 sensors) connected to the device + description: A list of digital sensors (currently supports DHT and DS18B20 sensors) connected to the device required: false type: list keys: pin: - description: The number corresponding to the _IO index_ of the labeled pin on the NodeMCU dev board. See the [NodeMCU GPIO documentation](https://nodemcu.readthedocs.io/en/master/en/modules/gpio/) for more details. Valid values are 1, 2, 5, 6, 7 and 8. + description: The number corresponding to the _IO index_ of the labeled pin on the NodeMCU dev board. See the [NodeMCU GPIO documentation](https://nodemcu.readthedocs.io/en/master/en/modules/gpio/) for more details. Valid values for sensors are 1, 2, 5, 6, 7 and 9. required: exclusive zone: - description: The number corresponding to the labeled zone on the [Konnected Alarm Panel](https://konnected.io) board or the word `out` to specify the dedicated ALARM/OUT terminal on the Konnected board. Valid values are `1`, `2`, `3`, `4`, `5` and `out`. + description: The number corresponding to the labeled zone on the [Konnected Alarm Panel](https://konnected.io) board. Valid values for sensors are `1`, `2`, `3`, `4`, `5` and `6`. required: exclusive name: description: The name of the device used in the front end. required: false default: automatically generated type: - description: The type of sensor. Valid values: `dht` or `ds18b20` + description: The type of sensor. Valid values are`dht` or `ds18b20` required: true switches: description: A list of actuators (on/off switches) connected to the device. See [Konnected Switch](/components/switch.konnected/) for configuration variables. From 1367f9b8c8c8ea525467012fcf2b0512ea2b4320 Mon Sep 17 00:00:00 2001 From: Nate Clark Date: Thu, 28 Feb 2019 13:07:35 -0500 Subject: [PATCH 3/3] update docs for digital sensor config --- source/_components/konnected.markdown | 29 ++++++++++++++++++++------- 1 file changed, 22 insertions(+), 7 deletions(-) diff --git a/source/_components/konnected.markdown b/source/_components/konnected.markdown index 9a8c8ece6976..e49c2096d20b 100644 --- a/source/_components/konnected.markdown +++ b/source/_components/konnected.markdown @@ -27,8 +27,13 @@ The component currently supports the following device types in Home Assistant: - Binary Sensor: Wired door and window sensors, motion detectors, glass-break detectors, leak sensors, smoke & CO detectors or any open/close switch. - Switch: Actuate a siren, strobe, buzzer or relay module. +- Sensor: Periodic measurements from DHT temperature/humidity sensors and DS18B20 temperature sensors. -This component requires the [`discovery`](/components/discovery) component to be enabled. +This component uses the [`discovery`](/components/discovery) component, which must be enabled for device discovery to work. If you don't want to use discovery, set the _host_ and _port_ for each device in the description. + +

+Konnected devices communicate with Home Assistant over your local LAN -- there is no cloud component! For best performance we recommend allowing unsecured HTTP API traffic between Konnected devices and Home Assistant on your LAN. This means that you should not use the `http` component to serve SSL/TLS certificates. Instead, use a proxy like Nginx or Caddy to serve SSL/TLS. [Read more.](https://help.konnected.io/support/solutions/articles/32000023964-set-up-hass-io-with-secure-remote-access-using-duckdns-and-nginx-proxy) +

### {% linkable_title Configuration %} @@ -78,7 +83,7 @@ devices: type: list keys: pin: - description: The number corresponding to the _IO index_ of the labeled pin on the NodeMCU dev board. See the [NodeMCU GPIO documentation](https://nodemcu.readthedocs.io/en/master/en/modules/gpio/) for more details. Valid values are 1, 2, 5, 6, 7 and 9. + description: The number corresponding to the _IO index_ of the labeled pin on the NodeMCU dev board. See the [NodeMCU GPIO documentation](https://nodemcu.readthedocs.io/en/master/en/modules/gpio/) for more details. Valid values are `1`, `2`, `5`, `6`, `7` and `9`. required: exclusive zone: description: The number corresponding to the labeled zone on the [Konnected Alarm Panel](https://konnected.io) board. Valid values are `1`, `2`, `3`, `4`, `5` and `6`. @@ -101,7 +106,7 @@ devices: type: list keys: pin: - description: The number corresponding to the _IO index_ of the labeled pin on the NodeMCU dev board. See the [NodeMCU GPIO documentation](https://nodemcu.readthedocs.io/en/master/en/modules/gpio/) for more details. Valid values for sensors are 1, 2, 5, 6, 7 and 9. + description: The number corresponding to the _IO index_ of the labeled pin on the NodeMCU dev board. See the [NodeMCU GPIO documentation](https://nodemcu.readthedocs.io/en/master/en/modules/gpio/) for more details. Valid values for sensors are `1`, `2`, `5`, `6`, `7` and `9`. required: exclusive zone: description: The number corresponding to the labeled zone on the [Konnected Alarm Panel](https://konnected.io) board. Valid values for sensors are `1`, `2`, `3`, `4`, `5` and `6`. @@ -111,8 +116,13 @@ devices: required: false default: automatically generated type: - description: The type of sensor. Valid values are`dht` or `ds18b20` + description: The type of sensor. Valid values are `dht` or `ds18b20` required: true + poll_interval: + type: integer + description: The frequency (in minutes) that the Konnected device will report sensor data. Minimum `1` minute. _Note:_ this is only implemented for `dht` sensors. + required: false + default: not set (device default is 3 minutes) switches: description: A list of actuators (on/off switches) connected to the device. See [Konnected Switch](/components/switch.konnected/) for configuration variables. required: false @@ -203,17 +213,22 @@ konnected: binary_sensors: - pin: 1 type: motion - name: 'Office Motion' + name: Office Motion - pin: 2 type: door - name: 'Office Door' + name: Office Door switches: - pin: 5 - name: 'Garage Door' + name: Garage Door activation: low momentary: 500 - pin: 8 name: LED Light + sensors: + - pin: 6 + name: Kitchen + type: dht + ``` ### {% linkable_title Pin Mapping %}