diff --git a/info.md b/info.md index 7b6bb26..13a3634 100644 --- a/info.md +++ b/info.md @@ -1,6 +1,7 @@ -The `attributes` platform supports sensors which break out specified `attribute` from other entities. +# HomeAssistant component: `attributes` +The `attributes` platform supports sensors which break out a specified `attribute` from other entities. -To enable Attribute sensor in your installation, add the following to your `configuration.yaml` file: +To enable the `attributes` sensor in your installation, add the following to your `configuration.yaml` file: ```yaml # Example configuration.yaml entry @@ -28,12 +29,13 @@ Configuration variables: - **entities** (*Required*): A list of entity IDs that you want to read attributes from. - **attribute** (*Required*): Which attribute to extract from defined entity IDs. -- **frindly_name** (*Optional*): Name to use in the Frontend *(will be the same for all entities specified at the moment)*. +- **friendly_name** (*Optional*): Name to use in the Frontend *(will be the same for all entities specified at the moment)*. - **icon** (*Optional*): Icon to use in the Frontend. - **unit_of_measurement** (*Optional*): Defines the units of measurement of the sensor, if any. +- **round_to** (*Optional*): round numbers to 'x' decimals, if zero it will become whole number. Skip this field if you extracting a string or you want to leave the value as it is. - **time_format** (*Optional*): **`strftime`** type string to beautify time attribute output. Applicable only when attribute `last_changed` or `last_triggered` is selected. Cheatsheet for strftime formatting [here](http://strftime.ninja/). -This example shows how to extact `battery_level` attribute. +This example shows how to extract the `battery_level` attribute. ```yaml sensor: @@ -47,7 +49,7 @@ sensor: - sensor.test3 ``` ->If an attribute is __`battery`__ or __`battety_level`__ and you don't specify __`icon`__ following icon_template is applied (fullness). The result is that battery icon become as full as battery based on percentage. +>If an attribute is __`battery`__ or __`battery_level`__ and you don't specify __`icon`__, the following icon_template is applied (fullness). The result is that the battery icon becomes as full as the battery based on percentage. ```yaml {% if batt == 'unknown' %} @@ -80,7 +82,7 @@ sensor: ``` -This example shows how to extact `last_triggered` attribute in human readable format. +This example shows how to extract the `last_triggered` attribute in human-readable format. ```yaml sensor: @@ -92,5 +94,4 @@ sensor: entities: - automation.dummy_changed ``` ->If you select attribute __`last_changed`__ or __`last_triggered`__ and you specify time_format your datetime will get translated to your local timezone and will be formatted like `strftime()` ie.: ***2017-08-08T13:14:21.651894+00:00*** gets translated into specified strftime format with timezone applied. Result would be ie.: ***8 August 15:14:21*** if you timezone is UTC+2 - +>If you select attribute __`last_changed`__ or __`last_triggered`__ and you specify time_format, your datetime will get translated to your local timezone and will be formatted like `strftime()` e.g., ***2017-08-08T13:14:21.651894+00:00*** gets translated into the specified strftime format with timezone applied. The result would be: ***8 August 15:14:21*** if your timezone is UTC+2