1.0 KiB
1.0 KiB
title | sidebar_label |
---|---|
Sensor Entity | Sensor |
A sensor is a read-only entity that provides some information. Information has a value and optionally, a unit of measurement.
Properties
Properties should always only return information from memory and not do I/O (like network requests). Implement
update()
orasync_update()
to fetch data.
Name | Type | Default | Description |
---|---|---|---|
state | string | Required | The value of the sensor. |
unit_of_measurement | string | None |
The unit of measurement that the sensor is expressed in. |
device_class | string | None |
Type of sensor. |
Available device classes
If specifying a device class, your sensor entity will need to also return the correct unit of measurement.
Type | Unit | Description |
---|---|---|
battery | % | % of battery that is left. |
humidity | % | % of humidity in the air. |
illuminance | lx/lm | Light level. |
temperature | °C/°F | Temperature. |
timestamp | ISO8601 | Timestamp |
pressure | hPa,mbar | Pressure. |