diff --git a/atom.xml b/atom.xml index 717bdca117..1e867ba1ca 100644 --- a/atom.xml +++ b/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Home Assistant]]> - 2018-01-05T10:46:51+00:00 + 2018-01-05T12:20:56+00:00 https://home-assistant.io/ diff --git a/blog/categories/announcements/atom.xml b/blog/categories/announcements/atom.xml index 5ad9f6ed9a..6ef62720ee 100644 --- a/blog/categories/announcements/atom.xml +++ b/blog/categories/announcements/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Announcements | Home Assistant]]> - 2018-01-05T10:46:51+00:00 + 2018-01-05T12:20:56+00:00 https://home-assistant.io/ diff --git a/blog/categories/community/atom.xml b/blog/categories/community/atom.xml index 5d98b55215..c624cdc801 100644 --- a/blog/categories/community/atom.xml +++ b/blog/categories/community/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Community | Home Assistant]]> - 2018-01-05T10:46:51+00:00 + 2018-01-05T12:20:56+00:00 https://home-assistant.io/ diff --git a/blog/categories/device-tracking/atom.xml b/blog/categories/device-tracking/atom.xml index f11bccb99c..2920cf1d12 100644 --- a/blog/categories/device-tracking/atom.xml +++ b/blog/categories/device-tracking/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Device-Tracking | Home Assistant]]> - 2018-01-05T10:46:51+00:00 + 2018-01-05T12:20:56+00:00 https://home-assistant.io/ diff --git a/blog/categories/esp8266/atom.xml b/blog/categories/esp8266/atom.xml index e67318940d..0d1b5b629a 100644 --- a/blog/categories/esp8266/atom.xml +++ b/blog/categories/esp8266/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: ESP8266 | Home Assistant]]> - 2018-01-05T10:46:51+00:00 + 2018-01-05T12:20:56+00:00 https://home-assistant.io/ diff --git a/blog/categories/how-to/atom.xml b/blog/categories/how-to/atom.xml index a81590a4fa..7824b19a78 100644 --- a/blog/categories/how-to/atom.xml +++ b/blog/categories/how-to/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: How-To | Home Assistant]]> - 2018-01-05T10:46:51+00:00 + 2018-01-05T12:20:56+00:00 https://home-assistant.io/ diff --git a/blog/categories/ibeacons/atom.xml b/blog/categories/ibeacons/atom.xml index 5e7ab29983..3b976a52ec 100644 --- a/blog/categories/ibeacons/atom.xml +++ b/blog/categories/ibeacons/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: iBeacons | Home Assistant]]> - 2018-01-05T10:46:51+00:00 + 2018-01-05T12:20:56+00:00 https://home-assistant.io/ diff --git a/blog/categories/internet-of-things/atom.xml b/blog/categories/internet-of-things/atom.xml index f7531c1e2c..a908f2fa3b 100644 --- a/blog/categories/internet-of-things/atom.xml +++ b/blog/categories/internet-of-things/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Internet-of-Things | Home Assistant]]> - 2018-01-05T10:46:51+00:00 + 2018-01-05T12:20:56+00:00 https://home-assistant.io/ diff --git a/blog/categories/iot-data/atom.xml b/blog/categories/iot-data/atom.xml index daf663ee4e..caf95f09f8 100644 --- a/blog/categories/iot-data/atom.xml +++ b/blog/categories/iot-data/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: IoT-Data | Home Assistant]]> - 2018-01-05T10:46:51+00:00 + 2018-01-05T12:20:56+00:00 https://home-assistant.io/ diff --git a/blog/categories/media/atom.xml b/blog/categories/media/atom.xml index 1149bf255e..06443ce62a 100644 --- a/blog/categories/media/atom.xml +++ b/blog/categories/media/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Media | Home Assistant]]> - 2018-01-05T10:46:51+00:00 + 2018-01-05T12:20:56+00:00 https://home-assistant.io/ diff --git a/blog/categories/merchandise/atom.xml b/blog/categories/merchandise/atom.xml index 4390120404..c0a075bfad 100644 --- a/blog/categories/merchandise/atom.xml +++ b/blog/categories/merchandise/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Merchandise | Home Assistant]]> - 2018-01-05T10:46:51+00:00 + 2018-01-05T12:20:56+00:00 https://home-assistant.io/ diff --git a/blog/categories/micropython/atom.xml b/blog/categories/micropython/atom.xml index 0777c1f120..ab148ec0ae 100644 --- a/blog/categories/micropython/atom.xml +++ b/blog/categories/micropython/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Micropython | Home Assistant]]> - 2018-01-05T10:46:51+00:00 + 2018-01-05T12:20:56+00:00 https://home-assistant.io/ diff --git a/blog/categories/mqtt/atom.xml b/blog/categories/mqtt/atom.xml index 51576c399b..559a542987 100644 --- a/blog/categories/mqtt/atom.xml +++ b/blog/categories/mqtt/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: MQTT | Home Assistant]]> - 2018-01-05T10:46:51+00:00 + 2018-01-05T12:20:56+00:00 https://home-assistant.io/ diff --git a/blog/categories/organisation/atom.xml b/blog/categories/organisation/atom.xml index f314178cfc..02149c6996 100644 --- a/blog/categories/organisation/atom.xml +++ b/blog/categories/organisation/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Organisation | Home Assistant]]> - 2018-01-05T10:46:51+00:00 + 2018-01-05T12:20:56+00:00 https://home-assistant.io/ diff --git a/blog/categories/owntracks/atom.xml b/blog/categories/owntracks/atom.xml index 8b3d6418e5..29a540b6df 100644 --- a/blog/categories/owntracks/atom.xml +++ b/blog/categories/owntracks/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: OwnTracks | Home Assistant]]> - 2018-01-05T10:46:51+00:00 + 2018-01-05T12:20:56+00:00 https://home-assistant.io/ diff --git a/blog/categories/presence-detection/atom.xml b/blog/categories/presence-detection/atom.xml index b0995d3e94..5b4d149f5a 100644 --- a/blog/categories/presence-detection/atom.xml +++ b/blog/categories/presence-detection/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Presence-Detection | Home Assistant]]> - 2018-01-05T10:46:51+00:00 + 2018-01-05T12:20:56+00:00 https://home-assistant.io/ diff --git a/blog/categories/public-service-announcement/atom.xml b/blog/categories/public-service-announcement/atom.xml index 72338306bb..bfccfdb736 100644 --- a/blog/categories/public-service-announcement/atom.xml +++ b/blog/categories/public-service-announcement/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Public-Service-Announcement | Home Assistant]]> - 2018-01-05T10:46:51+00:00 + 2018-01-05T12:20:56+00:00 https://home-assistant.io/ diff --git a/blog/categories/release-notes/atom.xml b/blog/categories/release-notes/atom.xml index b491d6a375..5e2ca5163d 100644 --- a/blog/categories/release-notes/atom.xml +++ b/blog/categories/release-notes/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Release-Notes | Home Assistant]]> - 2018-01-05T10:46:51+00:00 + 2018-01-05T12:20:56+00:00 https://home-assistant.io/ diff --git a/blog/categories/survey/atom.xml b/blog/categories/survey/atom.xml index 178d6aa2a2..6ec09457c6 100644 --- a/blog/categories/survey/atom.xml +++ b/blog/categories/survey/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Survey | Home Assistant]]> - 2018-01-05T10:46:51+00:00 + 2018-01-05T12:20:56+00:00 https://home-assistant.io/ diff --git a/blog/categories/talks/atom.xml b/blog/categories/talks/atom.xml index 0d21ebee65..65006a2ced 100644 --- a/blog/categories/talks/atom.xml +++ b/blog/categories/talks/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Talks | Home Assistant]]> - 2018-01-05T10:46:51+00:00 + 2018-01-05T12:20:56+00:00 https://home-assistant.io/ diff --git a/blog/categories/technology/atom.xml b/blog/categories/technology/atom.xml index 5d16b4fd70..36fac1bfaf 100644 --- a/blog/categories/technology/atom.xml +++ b/blog/categories/technology/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Technology | Home Assistant]]> - 2018-01-05T10:46:51+00:00 + 2018-01-05T12:20:56+00:00 https://home-assistant.io/ diff --git a/blog/categories/user-stories/atom.xml b/blog/categories/user-stories/atom.xml index 424d081d95..d0747278eb 100644 --- a/blog/categories/user-stories/atom.xml +++ b/blog/categories/user-stories/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: User-Stories | Home Assistant]]> - 2018-01-05T10:46:51+00:00 + 2018-01-05T12:20:56+00:00 https://home-assistant.io/ diff --git a/blog/categories/video/atom.xml b/blog/categories/video/atom.xml index f1b7ddd563..673011536d 100644 --- a/blog/categories/video/atom.xml +++ b/blog/categories/video/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Video | Home Assistant]]> - 2018-01-05T10:46:51+00:00 + 2018-01-05T12:20:56+00:00 https://home-assistant.io/ diff --git a/blog/categories/website/atom.xml b/blog/categories/website/atom.xml index 10b4791020..37fb17b54d 100644 --- a/blog/categories/website/atom.xml +++ b/blog/categories/website/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Website | Home Assistant]]> - 2018-01-05T10:46:51+00:00 + 2018-01-05T12:20:56+00:00 https://home-assistant.io/ diff --git a/components/input_boolean/index.html b/components/input_boolean/index.html index 7d2af86fab..0d7c331784 100644 --- a/components/input_boolean/index.html +++ b/components/input_boolean/index.html @@ -84,18 +84,36 @@ icon: mdi:car -

Configuration variables:

-
    -
  • [alias] (Required): Alias for the input. -
      -
    • name (Optional): Friendly name of the input.
    • -
    • initial (Optional): Initial value when Home Assistant starts. Defaults to False.
    • -
    • icon (Optional): Icon for entry.
    • -
    -
  • -
-

Pick an icon that you can find on materialdesignicons.com to use for your input and prefix the name with mdi:. For example mdi:car, mdi:ambulance, or mdi:motorbike.

-

Here’s an example of an automation using the above input_boolean. This action will only occur if the switch is on.

+
+

Configuration Variables

+
+
input_boolean
+
+

(map)(Required)Alias for the input. Multiple entries are allowed.

+
+
+
+
name
+
+

(String)(Optional)Friendly name of the input.

+
+
initial
+
+

(boolean)(Optional)Initial value when Home Assistant starts.

+

Default value: false

+
+
icon
+
+

(icon)(Optional)Icon to display for the component. Refer to the Customizing devices page for possible values.

+
+
+
+
+
+

Restore State

+

This component supports the restore_state function which restores the state after Home Assistant has started to the value it has been before Home Assistant stopped. To use this feature please make sure that the recorder component is enabled and your entity does not have a value set for initial. Additional information can be found in the Restore state section of the recorder component documentation.

+

Automation Examples

+

Here’s an example of an automation using the above input_boolean. This action will only occur if the switch is on.

automation:
   alias: Arriving home
   trigger:
diff --git a/components/input_datetime/index.html b/components/input_datetime/index.html
index 4d9a7e8333..208fc1f7b8 100644
--- a/components/input_datetime/index.html
+++ b/components/input_datetime/index.html
@@ -92,25 +92,72 @@
     has_time: true
 
-

Configuration variables:

-
    -
  • [alias] (Required): Alias for the datetime input. Multiple entries are allowed. -
      -
    • name (Optional): Friendly name of the datetime input.
    • -
    • has_time (Optional): Set to true if this input should have time. Defaults to false.
    • -
    • has_date (Optional): Set to true if this input should have a date. Defaults to false.
    • -
    • initial (Optional): Set the initial value of this input. Defaults to ‘1970-01-01 00:00’. If has_time is false this must be just a date (e.g.: ‘1970-01-01’). If has_date is false this must be just a time (e.g.: ‘15:16’).
    • -
    -
  • -
-

A datetime input entity’s state exports several attributes that can be useful in automations and templates:

-
    -
  • has_time: true if this entity has time.
  • -
  • has_date: true if this entity has a date.
  • -
  • year, month, day (Only available if has_date is true): The year, month and day of the date.
  • -
  • hour, minute, second (Only available if has_time is true): The hour, minute and second of the time.
  • -
  • timestamp: A timestamp representing the time held in the input. If has_date is true, this is the UNIX timestamp of the date / time held by the input. Otherwise (i.e., if only has_time is true) the number of seconds since midnight representing the time held by the input.
  • -
+
+

Configuration Variables

+
+
input_datetime
+
+

(map)(Required)Alias for the datetime input. Multiple entries are allowed.

+
+
+
+
name
+
+

(String)(Optional)Friendly name of the datetime input.

+
+
has_time
+
+

(Boolean)(Optional)Set to true if the input should have a time. At least one has_time or has_date must be defined.

+

Default value: false

+
+
has_date
+
+

(Boolean)(Optional)Set to true if the input should have a date. At least one has_time or has_date must be defined.

+

Default value: false

+
+
initial
+
+

(datetime | time | date)(Optional)Set the initial value of this input, depending on has_time and has_date.

+

Default value: 1970-01-01 00:00 | 1970-01-01 | 00:00

+
+
+
+
+
+

Attributes

+

A datetime input entity’s state exports several attributes that can be useful in automations and templates.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
AttributeDescription
has_timetrue if this entity has a time.
has_datetrue if this entity has a date.
year
month
day
The year, month and day of the date.
(only availabel if has_date: true)
hour
minute
second
The hour, minute and second of the time.
(only available if has_time: true)
timestampA timestamp representing the time held in the input.
If has_date: true, this is the UNIX timestamp of the date / time held by the input. Otherwise if only has_time: true, this is the number of seconds since midnight representing the time held by the input.
+

Restore State

+

This component supports the restore_state function which restores the state after Home Assistant has started to the value it has been before Home Assistant stopped. To use this feature please make sure that the recorder component is enabled and your entity does not have a value set for initial. Additional information can be found in the Restore state section of the recorder component documentation.