home-assistant.io/source/_components/sensor.zigbee.markdown
2018-10-24 16:11:36 +02:00

2.6 KiB

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_release, ha_iot_class
layout title description date sidebar comments sharing footer logo ha_category ha_release ha_iot_class
page Zigbee Sensor Instructions on how to set up Zigbee sensors within Home Assistant. 2016-01-28 10:08 true false true true zigbee.png Sensor 0.12 Local Polling

There are two types of Zigbee sensor available to Home Assistant:

To configure an analog input pin sensor, add the following to your configuration.yaml file:

# Example configuration.yaml entry
sensor:
  - platform: zigbee
    name: My Analog Zigbee Input
    type: analog
    pin: 0
    address: 0013A2004233D138

{% configuration %} name: description: The name you would like to give the sensor in Home Assistant. required: true type: string type: description: Set to analog or temperature. required: true type: string pin: description: The number identifying which pin to sample. required: false type: integer address: description: The long 64-bit address of the remote Zigbee device whose pin you would like to sample. Do not include this variable if you want to sample the local Zigbee device's pins. required: false type: string max_volts: description: The maximum voltage which the input pin is able to read. required: false default: 1.2 type: float {% endconfiguration %}

{% linkable_title Examples %}

{% linkable_title Analog Input Pin %}

The analog input pins on an XBee (non-Pro) will read 0V to 1.2 V. This is translated by the xbee-helper library into a percentage. The maximum voltage your Zigbee device will read is configurable using the max_volts configuration variable.

To configure an analog input pin sensor, add the following to your configuration.yaml file:

## Example configuration.yaml entry
sensor:
  - platform: zigbee
    name: My Analog Zigbee Input
    type: analog
    pin: 0
    address: 0013A2004233D138

See the Digi knowledge base for more XBee sampling details.

{% linkable_title Temperature Sensor %}

The XBee Pro (and perhaps other third party modules) contains a thermometer device which can be read by using the TP AT command.

To configure a temperature sensor device, add the following to your configuration.yaml file:

# Example configuration.yaml entry
sensor:
  - platform: zigbee
    name: Living Room Temperature Zigbee
    type: temperature
    address: 0013A20050E752C5