diff --git a/atom.xml b/atom.xml index a8299fe136..ce7d21be41 100644 --- a/atom.xml +++ b/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Home Assistant]]> - 2017-08-22T09:06:22+00:00 + 2017-08-22T11:07:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/announcements/atom.xml b/blog/categories/announcements/atom.xml index 00ca8f34d6..b069285278 100644 --- a/blog/categories/announcements/atom.xml +++ b/blog/categories/announcements/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Announcements | Home Assistant]]> - 2017-08-22T09:06:22+00:00 + 2017-08-22T11:07:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/community/atom.xml b/blog/categories/community/atom.xml index 56a8c0131d..b39bc6332a 100644 --- a/blog/categories/community/atom.xml +++ b/blog/categories/community/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Community | Home Assistant]]> - 2017-08-22T09:06:22+00:00 + 2017-08-22T11:07:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/device-tracking/atom.xml b/blog/categories/device-tracking/atom.xml index e0f5f9d7bf..ea0dd30f11 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]]> - 2017-08-22T09:06:22+00:00 + 2017-08-22T11:07:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/esp8266/atom.xml b/blog/categories/esp8266/atom.xml index 0379bcf34d..31344f3e4b 100644 --- a/blog/categories/esp8266/atom.xml +++ b/blog/categories/esp8266/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: ESP8266 | Home Assistant]]> - 2017-08-22T09:06:22+00:00 + 2017-08-22T11:07:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/how-to/atom.xml b/blog/categories/how-to/atom.xml index f6dc03e659..32898a5f18 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]]> - 2017-08-22T09:06:22+00:00 + 2017-08-22T11:07:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/ibeacons/atom.xml b/blog/categories/ibeacons/atom.xml index 4a53ac7149..b60a2f5106 100644 --- a/blog/categories/ibeacons/atom.xml +++ b/blog/categories/ibeacons/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: iBeacons | Home Assistant]]> - 2017-08-22T09:06:22+00:00 + 2017-08-22T11:07:51+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 fcce3f0a07..2dd2aa3db0 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]]> - 2017-08-22T09:06:22+00:00 + 2017-08-22T11:07:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/iot-data/atom.xml b/blog/categories/iot-data/atom.xml index f615a97e67..c2d17a35c8 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]]> - 2017-08-22T09:06:22+00:00 + 2017-08-22T11:07:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/media/atom.xml b/blog/categories/media/atom.xml index 265d00a9cb..68789d00cb 100644 --- a/blog/categories/media/atom.xml +++ b/blog/categories/media/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Media | Home Assistant]]> - 2017-08-22T09:06:22+00:00 + 2017-08-22T11:07:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/merchandise/atom.xml b/blog/categories/merchandise/atom.xml index 51cd869135..0fd8fe822f 100644 --- a/blog/categories/merchandise/atom.xml +++ b/blog/categories/merchandise/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Merchandise | Home Assistant]]> - 2017-08-22T09:06:22+00:00 + 2017-08-22T11:07:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/micropython/atom.xml b/blog/categories/micropython/atom.xml index cb8f9b26dd..8e3ad6837e 100644 --- a/blog/categories/micropython/atom.xml +++ b/blog/categories/micropython/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Micropython | Home Assistant]]> - 2017-08-22T09:06:22+00:00 + 2017-08-22T11:07:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/mqtt/atom.xml b/blog/categories/mqtt/atom.xml index c9a55d15f3..9651ace381 100644 --- a/blog/categories/mqtt/atom.xml +++ b/blog/categories/mqtt/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: MQTT | Home Assistant]]> - 2017-08-22T09:06:22+00:00 + 2017-08-22T11:07:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/organisation/atom.xml b/blog/categories/organisation/atom.xml index c51b6d4ede..51585edbb1 100644 --- a/blog/categories/organisation/atom.xml +++ b/blog/categories/organisation/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Organisation | Home Assistant]]> - 2017-08-22T09:06:22+00:00 + 2017-08-22T11:07:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/owntracks/atom.xml b/blog/categories/owntracks/atom.xml index b043a5a569..958fef3f23 100644 --- a/blog/categories/owntracks/atom.xml +++ b/blog/categories/owntracks/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: OwnTracks | Home Assistant]]> - 2017-08-22T09:06:22+00:00 + 2017-08-22T11:07:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/presence-detection/atom.xml b/blog/categories/presence-detection/atom.xml index 181f64aa17..f0a2682952 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]]> - 2017-08-22T09:06:22+00:00 + 2017-08-22T11:07:51+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 c62036939d..aa6773f472 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]]> - 2017-08-22T09:06:22+00:00 + 2017-08-22T11:07:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/release-notes/atom.xml b/blog/categories/release-notes/atom.xml index 99662d91db..7b7af9ccbb 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]]> - 2017-08-22T09:06:22+00:00 + 2017-08-22T11:07:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/survey/atom.xml b/blog/categories/survey/atom.xml index c26fc51116..6139c8e37b 100644 --- a/blog/categories/survey/atom.xml +++ b/blog/categories/survey/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Survey | Home Assistant]]> - 2017-08-22T09:06:22+00:00 + 2017-08-22T11:07:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/talks/atom.xml b/blog/categories/talks/atom.xml index f2e5564a25..7ee355b65b 100644 --- a/blog/categories/talks/atom.xml +++ b/blog/categories/talks/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Talks | Home Assistant]]> - 2017-08-22T09:06:22+00:00 + 2017-08-22T11:07:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/technology/atom.xml b/blog/categories/technology/atom.xml index 4971ce04a2..246241c7d7 100644 --- a/blog/categories/technology/atom.xml +++ b/blog/categories/technology/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Technology | Home Assistant]]> - 2017-08-22T09:06:22+00:00 + 2017-08-22T11:07:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/user-stories/atom.xml b/blog/categories/user-stories/atom.xml index 7c2216c6d1..68ab69d2bb 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]]> - 2017-08-22T09:06:22+00:00 + 2017-08-22T11:07:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/video/atom.xml b/blog/categories/video/atom.xml index 0b663b646f..7b07cfebad 100644 --- a/blog/categories/video/atom.xml +++ b/blog/categories/video/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Video | Home Assistant]]> - 2017-08-22T09:06:22+00:00 + 2017-08-22T11:07:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/website/atom.xml b/blog/categories/website/atom.xml index 780fd887df..c63ca0df64 100644 --- a/blog/categories/website/atom.xml +++ b/blog/categories/website/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Website | Home Assistant]]> - 2017-08-22T09:06:22+00:00 + 2017-08-22T11:07:51+00:00 https://home-assistant.io/ diff --git a/components/alarm_control_panel.alarmdotcom/index.html b/components/alarm_control_panel.alarmdotcom/index.html index 5fa81ebfe3..6dd56bdf9d 100644 --- a/components/alarm_control_panel.alarmdotcom/index.html +++ b/components/alarm_control_panel.alarmdotcom/index.html @@ -74,7 +74,7 @@
-

The alarmdotcom platform is consuming the information provided by a Alarm.com.

+

The alarmdotcom platform is consuming the information provided by Alarm.com.

To enable this, add the following lines to your configuration.yaml:

# Example configuration.yaml entry
 alarm_control_panel:
diff --git a/components/alarm_control_panel.egardia/index.html b/components/alarm_control_panel.egardia/index.html
index 44da2414a8..c0f712d181 100644
--- a/components/alarm_control_panel.egardia/index.html
+++ b/components/alarm_control_panel.egardia/index.html
@@ -97,11 +97,11 @@
   
  • report_server_codes list (Optional): List of codes for the different states.
  • Note that this basic configuration will only enable you to read the armed/armed away/disarmed status of your alarm and will not update the status if the alarm is triggered. This is because of how Egardia built their system. The alarm triggers normally go through their servers. -You can change this however, using the following procedure. This is an more advanced configuration.

    +You can change this, however, using the following procedure. This is a more advanced configuration.

      -
    1. Login into your alarm system’s control panel. You will need to access http://[ip of your control panel]. You know this already, since you need it in the basic configuration from above. Login to the control panel with your Egardia/Woonveilig username and password
    2. +
    3. Log in into your alarm system’s control panel. You will need to access http://[ip of your control panel]. You know this already since you need it in the basic configuration from above. Log in to the control panel with your Egardia/Woonveilig username and password.
    4. Once logged in, go to System Settings, Report and change the Server Address for your primary server to the IP or hostname of your Home Assistant machine. Also, update the port number 85 or to anything you like. The provided software that you will set up in the next steps runs on port 85 by default. Make sure to change the settings of the primary server otherwise the messages will not come through. Note that this will limit (or fully stop) the number of alarm messages you will get through Egardia’s / Woonveilig services. Maybe, that is just what you want. Make sure to save your settings by selecting ‘OK’.
    5. -
    6. On your Home Assistant machine run $ sudo python3 egardiaserver.py. This will receive status codes from your alarm control panel and display them. You will need the codes to include in your configuration.yaml. Make sure to change the status of your alarm to all states (disarm, arm, armhome) as well as trigger the alarm in all ways possible to get 100% coverage. Before triggering the alarm it might be good to temporarily disable the siren (can be done in Panel Settings).
    7. +
    8. On your Home Assistant machine run $ sudo python3 egardiaserver.py. This will receive status codes from your alarm control panel and display them. You will need the codes to include in your configuration.yaml. Make sure to change the status of your alarm to all states (disarm, arm, armhome) as well as trigger the alarm in all ways possible to get 100% coverage. Before triggering the alarm it might be good to disable the siren temporarily (can be done in Panel Settings).
    9. Once you have the codes, update your configuration.yaml:
      # Example configuration.yaml entry
       alarm_control_panel:
      @@ -119,13 +119,13 @@ You can change this however, using the following procedure. This is an more adva
          standby: XXXXXXXXXXXXXXXX
       
      -

      Note that your can have more than one code for triggered, since every sensor generates it’s own code. arm, disarm, armhome and standby will all be one code.

      +

      Note that you can have more than one code for triggered since every sensor generates its own code. arm, disarm, armhome and standby will all be one code.

    10. Start the egardiaserver.py script on boot of your Home Assistant machine, for example by adding the following to your /etc/rc.local:
       python3 [path/to/]egardiaserver.py &
       
      -

      Do not forget the trailing & here, otherwise you will be having a hard time logging back in to the machine.

      +

      Do not forget the trailing & here; otherwise you will be having a hard time logging back into the machine.

    11. Test your setup and enjoy. The component will update if the alarm status changes, including triggers. You can use this to build your own automations and send notifications as you wish.
    diff --git a/components/alarm_control_panel.manual/index.html b/components/alarm_control_panel.manual/index.html index bce0b2e952..77097e2912 100644 --- a/components/alarm_control_panel.manual/index.html +++ b/components/alarm_control_panel.manual/index.html @@ -89,7 +89,7 @@
  • disarm_after_trigger (Optional): If true, the alarm will automatically disarm after it has been triggered instead of returning to the previous state.
  • Examples

    -

    In this section you find some real life examples of how to use this panel.

    +

    In this section, you find some real-life examples of how to use this panel.

    Sensors

    Using sensors to trigger the alarm.

    automation:
    diff --git a/components/alarm_control_panel.manual_mqtt/index.html b/components/alarm_control_panel.manual_mqtt/index.html
    index a159ca8de7..9c838f26d2 100644
    --- a/components/alarm_control_panel.manual_mqtt/index.html
    +++ b/components/alarm_control_panel.manual_mqtt/index.html
    @@ -109,7 +109,7 @@
     

    Additionally, the following MQTT configuration variables are also available:

    • state_topic (Required): The MQTT topic HA will publish state updates to.
    • -
    • command_topic (Required): The MQTT topic HA will subscribe to to receive commands from a remote device to change the alarm state.
    • +
    • command_topic (Required): The MQTT topic HA will subscribe to, to receive commands from a remote device to change the alarm state.
    • qos (Optional): The maximum QoS level for subscribing and publishing to MQTT messages. Default is 0.
    • payload_disarm (Optional): The payload to disarm this Alarm Panel. Default is “DISARM”.
    • payload_arm_home (Optional): The payload to set armed-home mode on this Alarm Panel. Default is “ARM_HOME”.
    • diff --git a/components/alarm_control_panel.mqtt/index.html b/components/alarm_control_panel.mqtt/index.html index 322d0af3bb..0e7ead84f8 100644 --- a/components/alarm_control_panel.mqtt/index.html +++ b/components/alarm_control_panel.mqtt/index.html @@ -83,7 +83,7 @@
    • ‘pending’
    • ‘triggered’
    -

    The component is able to control your Alarm Panel by publishing to the command_topic when a user interacts with the Home Assistant frontend.

    +

    The component can control your Alarm Panel by publishing to the command_topic when a user interacts with the Home Assistant frontend.

    To enable this platform, add the following lines to your configuration.yaml:

    # Example configuration.yaml entry
     alarm_control_panel:
    diff --git a/components/alarm_control_panel.wink/index.html b/components/alarm_control_panel.wink/index.html
    index b46ade76b2..4e93db43e8 100644
    --- a/components/alarm_control_panel.wink/index.html
    +++ b/components/alarm_control_panel.wink/index.html
    @@ -82,7 +82,7 @@
       
  • Canary all-in-one security camera
  • -The above devices are confimed to work, but others may work as well. +The above devices are confirmed to work, but others may work as well.

    diff --git a/components/alarmdecoder/index.html b/components/alarmdecoder/index.html index 10667a6c42..f0a3e0fb4b 100644 --- a/components/alarmdecoder/index.html +++ b/components/alarmdecoder/index.html @@ -74,7 +74,7 @@
    -

    The alarmdecoder component will allow Home Assistant users who own either a DSC or Honeywell alarm panel to leverage their alarm system and it’s sensors to provide Home Assistant with rich information about their homes. Connectivity between Home Assistant and the alarm panel is accomplished through a device produced by Nu Tech Software Solutions, known as the AlarmDecoder. The AlarmDecoder devices provide a serial, TCP/IP socket or USB interface to the alarm panel, where it emulates an alarm keypad.

    +

    The alarmdecoder component will allow Home Assistant users who own either a DSC or Honeywell alarm panel to leverage their alarm system and its sensors to provide Home Assistant with rich information about their homes. Connectivity between Home Assistant and the alarm panel is accomplished through a device produced by Nu Tech Software Solutions, known as the AlarmDecoder. The AlarmDecoder devices provide a serial, TCP/IP socket or USB interface to the alarm panel, where it emulates an alarm keypad.

    Please visit the AlarmDecoder website for further information about the AlarmDecoder devices.

    There is currently support for the following device types within Home Assistant:

      @@ -102,12 +102,12 @@

    Configuration variables:

      -
    • type (Required): The type of AlarmDecoder device: socket, serial or usb
    • +
    • type (Required): The type of AlarmDecoder device: socket, serial or USB
    • host (Optional): The IP address of the AlarmDecoder device on your home network, if using socket type. Default: localhost
    • port (Optional): The port of the AlarmDecoder device on your home network, if using socket type. Default: 10000
    • path (Optional): The path of the AlarmDecoder device, if using socket type. Default: /dev/ttyUSB0
    • baud (Optional): The baud rate of the AlarmDecoder device, if using serial type. Default: 115200
    • -
    • panel_display (Optional): Create a sensor called sensor.alarm_display to match the Alarm Keypad dispaly. Default: off
    • +
    • panel_display (Optional): Create a sensor called sensor.alarm_display to match the Alarm Keypad display. Default: off
    • zones (Optional): AlarmDecoder has no way to tell us which zones are actually in use, so each zone must be configured in Home Assistant. For each zone, at least a name must be given. For more information on the available zone types, take a look at the Binary Sensor docs. Note: If no zones are specified, Home Assistant will not load any binary_sensor components.
    diff --git a/components/alert/index.html b/components/alert/index.html index 4c42ff4c52..931d74a707 100644 --- a/components/alert/index.html +++ b/components/alert/index.html @@ -74,9 +74,9 @@
    -

    The alert component is designed to notify you when problematic issues arise. For example, if the garage door is left open, the alert component can be used remind you of this by sending you repeating notifications at customizable intervals. This is also useful for low battery sensors, water leak sensors, or any condition that may need your attention.

    +

    The alert component is designed to notify you when problematic issues arise. For example, if the garage door is left open, the alert component can be used remind you of this by sending you repeating notifications at customizable intervals. This is also used for low battery sensors, water leak sensors, or any condition that may need your attention.

    Alerts will add an entity to the front end only when they are firing. This entity allows you to silence an alert until it is resolved.

    -

    When using the alert component it is important that the timezone used for Home Assistant and the underlying operating system match. Failing to do so may result in multiple alerts being sent at the same time (such as when Home Assistant is set to the America/Detroit timezone but the operating system uses UTC).

    +

    When using the alert component, it is important that the time zone used for Home Assistant and the underlying operating system match. Failing to do so may result in multiple alerts being sent at the same time (such as when Home Assistant is set to the America/Detroit time zone but the operating system uses UTC).

    Basic Example

    The alert component makes use of any of the notifications components. To setup the alert component, first, you must setup a notification component. Then, add the following to your configuration file:

    # Example configuration.yaml entry
    @@ -101,7 +101,7 @@
       
  • entity_id (Required): The ID of the entity to watch.
  • state (Optional): The problem condition for the entity. Defaults to on.
  • repeat (Required): Number of minutes before the notification should be repeated. Can be either a number or a list of numbers.
  • -
  • can_acknowledge (Optional): Allows the alert to be unacknowledgable. Defaults to true.
  • +
  • can_acknowledge (Optional): Allows the alert to be unacknowledgeable. Defaults to true.
  • skip_first (Optional): Controls whether the notification should be sent immediately or after the first delay. Defaults to false.
  • notifiers (Required): List of notification components to use for alerts.
  • diff --git a/components/alexa/index.html b/components/alexa/index.html index e1124560c5..a25007e7a1 100644 --- a/components/alexa/index.html +++ b/components/alexa/index.html @@ -146,7 +146,7 @@ WhereAreWeIntent where we are

    When activated, the Alexa component will have Home Assistant’s native intent support handle the incoming intents. If you want to run actions based on intents, use the intent_script component.

    Working With Scenes

    One of the most useful applications of Alexa integrations is to call scenes directly. This is easily achieved with some simple setup on the Home Assistant side and by letting Alexa know which scenes you want to run.

    -

    First we will configure Alexa. In the Amazon Interaction module add this to the intent schema:

    +

    First, we will configure Alexa. In the Amazon Interaction module add this to the intent schema:

    {
       "intent": "ActivateSceneIntent",
       "slots":
    @@ -182,7 +182,7 @@ Custom slot type for scene support.
     

    Here we are using templates to take the name we gave to Alexa e.g. downstairs on and replace the space with an underscore so it becomes downstairs_on as Home Assistant expects.

    -

    Now say Alexa ask homeassistant to activate <some scene> and Alexa will activate that scene for you.

    +

    Now say Alexa ask Home Assistant to activate <some scene> and Alexa will activate that scene for you.

    Adding Scripts

    We can easily extend the above idea to work with scripts as well. As before, add an intent for scripts:

    {
    @@ -218,12 +218,12 @@ Custom slot type for script support.
           text: OK
     
    -

    Now say Alexa ask homeassistant to run <some script> and Alexa will run that script for you.

    +

    Now say Alexa ask Home Assistant to run <some script> and Alexa will run that script for you.

    Support for Launch Requests

    There may be times when you want to respond to a launch request initiated from a command such as “Alexa, Red Alert!”.

    -

    To start you need to get the skill id:

    +

    To start, you need to get the skill id:

      -
    • Log in to Amazon developer console
    • +
    • Log into Amazon developer console
    • Click the Alexa button at the top of the console
    • Click the Alexa Skills Kit Get Started button
        @@ -330,7 +330,7 @@ Custom slot type for script support.
      • Test
          -
        • Having passed all validations to reach this screen you can now click on “< Back to All Skills” as your flash briefing is now available as in “Development” service.
        • +
        • Having passed all validations to reach this screen, you can now click on “< Back to All Skills” as your flash briefing is now available as in “Development” service.
      diff --git a/components/amcrest/index.html b/components/amcrest/index.html index 073a6fb27c..d78e75b40f 100644 --- a/components/amcrest/index.html +++ b/components/amcrest/index.html @@ -96,7 +96,7 @@

    Configuration variables:

      -
    • host (Required): The IP address or hostname of your camera. If using hostname, make sure the DNS works as expected.
    • +
    • host (Required): The IP address or hostname of your camera. If using a hostname, make sure the DNS works as expected.
    • username (Required): The username for accessing your camera.
    • password (Required): The password for accessing your camera.
    • name (Optional): This parameter allows you to override the name of your camera. The default is “Amcrest Camera”.
    • @@ -104,7 +104,7 @@
    • resolution (Optional): This parameter allows you to specify the camera resolution. For a high resolution (1080/720p), specify the option high. For VGA resolution (640x480p), specify the option low. If omitted, it defaults to high.
    • stream_source (Optional): The data source for the live stream. mjpeg will use the camera’s native MJPEG stream, whereas snapshot will use the camera’s snapshot API to create a stream from still images. You can also set the rtsp option to generate the streaming via RTSP protocol. If omitted, it defaults to snapshot.
    • ffmpeg_arguments: (Optional): Extra options to pass to ffmpeg, e.g. image quality or video filter options.
    • -
    • authentication: (Optional): Defines which authentication method to use only when stream_source is mjpeg. Currently aiohttp only support basic. It defaults to basic.
    • +
    • authentication: (Optional): Defines which authentication method to use only when stream_source is mjpeg. Currently, aiohttp only support basic. It defaults to basic.
    • scan_interval (Optional): Defines the update interval of the sensor in seconds. The default is 10 seconds.
    • sensors array (Optional): Conditions to display in the frontend. By default, none of the conditions are enabled. The following conditions can be monitored.
        @@ -114,7 +114,7 @@
    -

    Note: Amcrest cameras with newer firmwares no longer have the ability to stream high definition video with MJPEG encoding. You may need to use low resolution stream or the snapshot stream source instead. If the quality seems too poor, lower the Frame Rate (FPS) and max out the Bit Rate settings in your camera’s configuration manager. If you defined the stream_source to mjpeg, make sure your camera supports Basic HTTP authentication. Newer Amcrest firwmares may not work, then rtsp is recommended instead.

    +

    Note: Amcrest cameras with newer firmware no longer have the ability to stream high definition video with MJPEG encoding. You may need to use low resolution stream or the snapshot stream source instead. If the quality seems too poor, lower the Frame Rate (FPS) and max out the Bit Rate settings in your camera’s configuration manager. If you defined the stream_source to mjpeg, make sure your camera supports Basic HTTP authentication. Newer Amcrest firmware may not work, then rtsp is recommended instead.

    Note: If you set the stream_source option to rtsp, make sure to follow the steps mentioned at FFMPEG documentation to install the ffmpeg.

    Finish its configuration by visiting the Amcrest sensor page or Amcrest camera page.

    diff --git a/components/android_ip_webcam/index.html b/components/android_ip_webcam/index.html index c3b76c1128..02b7825e3e 100644 --- a/components/android_ip_webcam/index.html +++ b/components/android_ip_webcam/index.html @@ -75,7 +75,7 @@

    The android_ip_webcam component turns an Android phone into a network camera with multiple viewing options.

    -

    It’s setup as a mjpeg camera and all settings as switches inside of Home Assistant. You can also expose the sensors. If you have multiple phones, you can use all options inside a list.

    +

    It’s setup as an M-JPEG camera and all settings as switches inside of Home Assistant. You can also expose the sensors. If you have multiple phones, you can use all options inside a list.

    To set it up, download the IP Webcam app, and add the following information to your configuration.yaml file:

    # Example configuration.yaml entry
     android_ip_webcam:
    @@ -90,8 +90,8 @@
       
  • username (Optional): The username to access the phone.
  • password (Optional): The password to access the phone.
  • scan_interval (Optional): Default is 10 seconds. Defines the update interval of the phone.
  • -
  • sensors array (Optional): Conditions to display sensor in the frontend. See list of supported sensors.
  • -
  • switches array (Optional): Conditions to display settings in the frontend. See list of supported settings.
  • +
  • sensors array (Optional): Conditions to display sensor in the frontend. See the list of supported sensors.
  • +
  • switches array (Optional): Conditions to display settings in the frontend. See the list of supported settings.
  • motion_sensor (Optional): Activate motion sensor if auto_discovery is disabled.
  • Supported features

    diff --git a/components/apiai/index.html b/components/apiai/index.html index 9b12f419e8..997764d6c8 100644 --- a/components/apiai/index.html +++ b/components/apiai/index.html @@ -74,8 +74,8 @@
    -

    This component is designed to be used with the “webhook” integration in api.ai. When a conversation ends with an user, api.ai sends an action and parameters to the webhook.

    -

    api.ai requires a public endpoint (HTTPS recommended), so your Home Assistant should be exposed to Internet. api.ai will return fallback answers if your server do not answer, or takes too long (more than 5 seconds).

    +

    This component is designed to be used with the “webhook” integration in api.ai. When a conversation ends with a user, api.ai sends an action and parameters to the webhook.

    +

    api.ai requires a public endpoint (HTTPS recommended), so your Home Assistant should be exposed to the Internet. api.ai will return fallback answers if your server does not answer, or takes too long (more than 5 seconds).

    api.ai could be integrated with many popular messaging, virtual assistant and IoT platforms, eg.: Google Assistant (Google Actions), Skype, Messenger. See here the complete list.

    Using Api.ai will be easy to create conversations like:

    @@ -88,14 +88,14 @@

    User: In the kitchen

    Bot: Turning on kitchen light

    -

    To use this integration you should define a conversation (intent) in Api.ai, configure Home Assistant with the speech to return and, optionally, the action to execute.

    +

    To use this integration, you should define a conversation (intent) in Api.ai, configure Home Assistant with the speech to return and, optionally, the action to execute.

    Configuring your api.ai account

    • Login with your Google account.
    • Click on “Create Agent”
    • Select name, language (if you are planning to use it with Google Actions check here supported languages) and time zone
    • Click “Save”
    • -
    • Go to “Fullfiment” (in the left menu)
    • +
    • Go to “Fulfillment” (in the left menu)
    • Enable Webhook and set your Home Assistant URL with the Api.ai endpoint. Eg.: https://myhome.duckdns.org/api/apiai?api_password=HA_PASSWORD
    • Click “Save”
    • Create a new intent
    • diff --git a/components/apple_tv/index.html b/components/apple_tv/index.html index ef834648c2..a12b39e880 100644 --- a/components/apple_tv/index.html +++ b/components/apple_tv/index.html @@ -76,13 +76,13 @@

      The apple_tv platform allows you to control an Apple TV (3rd and 4th generation). See the remote platform if you want to send remote control buttons, e.g. arrow keys.

      -Currently you must have Home Sharing enabled for this to work. Support for pairing Home Assistant with your device will be supported in a later release. +Currently, you must have Home Sharing enabled for this to work. Support for pairing Home Assistant with your device will be supported in a later release.

      To use this component, you must first install some system libraries and a compiler. For Debian or a similar system, this should be enough:

      $ sudo apt-get install build-essential libssl-dev libffi-dev python-dev
       
      -

      If you want to automatically discover new devices, just make sure you have discovery: in your configuration.yaml file. To manually add one or more Apple TVs to your installation, add the following to your configuration.yaml file:

      +

      If you want to discover new devices automatically, just make sure you have discovery: in your configuration.yaml file. To manually add one or more Apple TVs to your installation, add the following to your configuration.yaml file:

      # Example configuration.yaml entry
       apple_tv:
         - host: IP_1
      @@ -102,10 +102,10 @@ Currently you must have Home Sharing enabled for this to work. Support for pairi
         
    • host (Required): The IP-address of the device.
    • login_id (Required): An identifier used to login to the device, see below.
    • name (Optional): The name of the device used in the frontend.
    • -
    • start_off (Optional): Set to true if device should start in fake standby.
    • +
    • start_off (Optional): Set to true if the device should start in fake standby.
    • credentials (Optional): Credentials used for AirPlay playback.
    -

    In order to connect to the device you need a login id. The easiest way to obtain this identifier is to use the apple_tv_scan service (described below). Additional information about start_off and credentials can also be found under the guides section.

    +

    In order to connect to the device, you need a login id. The easiest way to obtain this identifier is to use the apple_tv_scan service (described below). Additional information about start_off and credentials can also be found under the guides section.

    Guides

    Scanning for devices

    To scan for devices, press the icon in the upper left corner and select the leftmost icon according to the image:

    @@ -114,7 +114,7 @@ Currently you must have Home Sharing enabled for this to work. Support for pairi

    Scanning will be done for three seconds and notification will be shown in the state view with all found devices:

    -

    Alternatively you may use the application atvremote. Install it with pip3 install --upgrade pyatv in your Home Assistant environment (note: do not use sudo). Then run atvremote scan to scan for all devices (try again if a device is missing):

    +

    Alternatively, you may use the application atvremote. Install it with pip3 install --upgrade pyatv in your Home Assistant environment (note: do not use sudo). Then run atvremote scan to scan for all devices (try again if a device is missing):

    $ atvremote scan
     Found Apple TVs:
      - Apple TV at 10.0.10.22 (login id: 00000000-1234-5678-9012-345678901234)
    @@ -124,17 +124,17 @@ Note: You must use 'pair' with devices that have home sh
     

    Just copy and paste the login id from the device you want to add. For more details about atvremote, see: this page.

    My Apple TV turns on when I restart Home Assistant

    -

    The Apple TV will automatically turn on if a request is sent to it, e.g. if a button is pressed, something is streamed to it via AirPlay or if current state (currently playing) is accessed. This is how Apple has designed it and it will cause problems if you are using HDMI CEC. Every time Home Assistant is started, a new request is sent to the device to figure out what is currently playing. When using CEC, this will wake up your TV and other devices you have configured.

    -

    So, if your TV is randomly turning on, this is probably the reason. As stated, this is by design and there is no real fix for it. There’s also no known way to turn off the Apple TV via the procotol used for communication. You basically have the following options:

    +

    The Apple TV will automatically turn on if a request is sent to it, e.g., if a button is pressed, something is streamed to it via AirPlay or if current state (currently playing) is accessed. This is how Apple has designed it, and it will cause problems if you are using HDMI CEC. Every time Home Assistant is started, a new request is sent to the device to figure out what is currently playing. When using CEC, this will wake up your TV and other devices you have configured.

    +

    So, if your TV is randomly turning on, this is probably the reason. As stated, this is by design, and there is no real fix for it. There’s also no known way to turn off the Apple TV via the protocol used for communication. You have the following options:

    • Do not use this platform
    • Disable HDMI CEC on your Apple TV
    • Use “fake standby”
    -

    The first two points are quite obvious. Fake standby is a concept implemented in this platform that disables all requests to the device and make it appear as being “off” in the web interface. This will make sure that the device is not woken up, but it will of course not show any information or allow you to control it. It is however easy to turn it on (or off) in the web interface or using an automation with turn_on. To make it more useful, you can write automations that turns it on or off depending on some other device, like the input source on your receiver.

    +

    The first two points are quite obvious. Fake standby is a concept implemented in this platform that disables all requests to the device and makes it appear as being “off” in the web interface. This will make sure that the device is not woken up, but it will of course not show any information or allow you to control it. It is however easy to turn it on (or off) in the web interface or to use an automation with turn_on. To make it more useful, you can write automations that turn it on or off depending on some other device, like the input source on your receiver.

    To put a device into fake standby when starting Home Assistant, add start_off: true to your configuration.

    -Turning the device on/off in the user interface will not turn the physical device on/off according to description above. +Turning the device on/off in the user interface will not turn the physical device on/off according to the description above.

    Setting up device authentication

    If you, when playing media with play_url, get the following error message:

    @@ -153,10 +153,10 @@ Turning the device on/off in the user interface will not turn the physi credentials: 1B8C387DDB59BDF6:CF5ABB6A2C070688F5926ADB7C010F6DF847252C15F9BDB6DA3E09D6591E90E5
    -

    Restart Home Assistant and you should now be able to use play_url as before.

    +

    Restart Home Assistant, and you should now be able to use play_url as before.

    Services

    Service apple_tv_authenticate

    -

    In order to play media on an Apple TV with device authentication enabled (e.g. ATV4 with tvOS 10.2+), Home Assistant must properly authenticated. This method starts the process and presents the credentials needed for playback as a persistent notification. Please see guide above for usage.

    +

    To play media on an Apple TV with device authentication enabled (e.g., ATV4 with tvOS 10.2+), Home Assistant must be properly authenticated. This method starts the process and presents the credentials needed for playback as a persistent notification. Please see guide above for usage.

    diff --git a/components/arduino/index.html b/components/arduino/index.html index bbeef54f42..7b2c524a8c 100644 --- a/components/arduino/index.html +++ b/components/arduino/index.html @@ -74,10 +74,10 @@
    -

    The Arduino device family are microcontroller boards that are often based on the ATmega328 chip. They come with digital input/output pins (some can be used as PWM outputs), analog inputs, and a USB connection. The equipment depends on the type of board. The most common ones are the Arduino Uno and the Arduino Leonardo with 14 digital input/output pins and 6 analog input pins.

    -

    There are a lot of extensions (so called shields) available. Those shields can be plugged-in into the existing connectors and stacked on top of each other. This makes it possible to expand the capabilities of the Arduino boards.

    +

    The Arduino device family are microcontroller boards that are often based on the ATmega328 chip. They come with digital input/output pins (some can be used as PWM outputs), analog inputs, and a USB connection. The equipment depends on the type of the board. The most common ones are the Arduino Uno and the Arduino Leonardo with 14 digital input/output pins and 6 analog input pins.

    +

    There are a lot of extensions (so-called shields) available. Those shields can be plugged-in into the existing connectors and stacked on top of each other. This makes it possible to expand the capabilities of the Arduino boards.

    The arduino component is designed to let you use a directly attached board to your Home Assistant host over USB.

    -

    You need to have the Firmata firmware on your board. Please upload the StandardFirmata sketch to your board, please refer to the Arduino documentation for further information.

    +

    You need to have the Firmata firmware on your board. Please upload the StandardFirmata sketch to your board; please refer to the Arduino documentation for further information.

    To integrate an Arduino boards with Home Assistant, add the following section to your configuration.yaml file:

    # Example configuration.yaml entry
     arduino:
    @@ -86,13 +86,13 @@
     

    Configuration variables:

      -
    • port (Required): The port where your board is connected to your Home Assistant host. If you are using an original Arduino the port will be named ttyACM* otherwise ttyUSB*.
    • +
    • port (Required): The port where your board is connected to your Home Assistant host. If you are using an original Arduino, the port will be named ttyACM* otherwise ttyUSB*.

    The exact number can be determined with the command shown below.

    $ ls /dev/ttyACM*
     
    -

    If that’s not working, check your dmesg or journalctl -f output. Keep in mind that Arduino clones are often using a different name for the port (eg. /dev/ttyUSB*).

    +

    If that’s not working, check your dmesg or journalctl -f output. Keep in mind that Arduino clones are often using a different name for the port (e.g. /dev/ttyUSB*).

    A word of caution: The Arduino boards are not storing states. This means that with every initialization the pins are set to off/low.

    diff --git a/components/asterisk_mbox/index.html b/components/asterisk_mbox/index.html index 6a8a7eb693..ec3cfb5560 100644 --- a/components/asterisk_mbox/index.html +++ b/components/asterisk_mbox/index.html @@ -74,9 +74,9 @@
    -

    The Asterisk Voicemail integration for Home Assistant allows you to view, listen-to, and delete voicemails from a Asterisk voicemail mailbox. The component includes a panel on the frontend that provides caller-id and speech-to-text transcription (using Google’s API) of messages in addition to playback and message deletion. There is also an included sensor that provides an indication of the number of available messages. There is no requirement that the Asterisk PBX and Home Assistant are running on the same machine.

    -

    To enable the component, configuration is required in both Home Assistant as well as on the Asterisk server.

    -

    First follow the Asterisk PBX configuration guide to setup the necessary server on the Asterisk PBX server (this is necessary even if Asterisk and Home Assistant are running on the same server)

    +

    The Asterisk Voicemail integration for Home Assistant allows you to view, listen to, and delete voicemails from an Asterisk voicemail mailbox. The component includes a panel on the frontend that provides caller-id and speech-to-text transcription (using Google’s API) of messages in addition to playback and message deletion. There is also an included sensor that indicates of the number of available messages. There is no requirement that the Asterisk PBX and Home Assistant are running on the same machine.

    +

    To enable the component, a configuration is required in both Home Assistant as well as on the Asterisk server.

    +

    First follow the Asterisk PBX configuration guide to setup the necessary server on the Asterisk PBX server (this is needed even if Asterisk and Home Assistant are running on the same server)

    Once that is complete, add the the following entry configuration.yaml file:

    # Example configuration.yaml entry
     asterisk_mbox:
    @@ -88,12 +88,12 @@
     

    This will add a new ‘Mailbox’ side-panel, as well as a sensor to indicate # of messages available.

    Configuration variables:

      -
    • password (Required): The password that was set during Asterisk PBX confguration
    • +
    • password (Required): The password that was set during Asterisk PBX configuration
    • host (Required): The ip-address of the server that is running the Asterisk PBX
    • -
    • port (Required): The port on the Asterisk PBX server that was configured during Asterisk PBX confguration
    • +
    • port (Required): The port on the Asterisk PBX server that was configured during Asterisk PBX configuration

    -Communication between the Asterisk PBX server and the Home Assistant server is password-protected, but the data transmission is not encrypted. It is recommended to only use this component when communication will be contained within a local area network. +Communication between the Asterisk PBX server and the Home Assistant server is password-protected, but the data transmission is not encrypted. It is recommended to only use this component when communication is contained within a local area network.

    diff --git a/components/axis/index.html b/components/axis/index.html index 6ac625f49e..318fd71153 100644 --- a/components/axis/index.html +++ b/components/axis/index.html @@ -74,7 +74,7 @@
    -

    Axis Communications devices are surveillance cameras and other security related network connected hardware. Sensor API works with firmware 5.50 and newer.

    +

    Axis Communications devices are surveillance cameras and other security-related network connected hardware. Sensor API works with firmware 5.50 and newer.

    Home Assistant will automatically discover their presence on your network.

    Dependencies

    $ sudo apt-get install python3-gi gir1.2-gstreamer-1.0
    @@ -112,7 +112,7 @@
           
  • camera: Stream MJPEG video to Home Assistant.
  • motion: The built-in motion detection in Axis cameras.
  • vmd3: ACAP Motion Detection app which has better algorithms for motion detection.
  • -
  • pir: PIR sensor that can trigger on motion.
  • +
  • pir: PIR sensor that can trigger on a motion.
  • sound: Sound detector.
  • daynight: Certain cameras have day/night mode if they have built-in IR lights.
  • tampering: Signals when camera believes that it has been tampered with.
  • @@ -138,13 +138,13 @@

    -If you are using Python3.6 you might need to replace the 34m with 36m in the _gi.*.so filename in the gi folder. +If you are using Python 3.6, you might need to replace the 34m with 36m in the _gi.*.so filename in the gi folder.

    Any specific levels for triggers needs to be configured on the device.

    - It is recommended that you create a user on your Axis device specifically for Home Assistant. For all current functionality it is enough to create a user belonging to user group viewer. + It is recommended that you create a user on your Axis device specifically for Home Assistant. For all current functionality, it is enough to create a user belonging to user group viewer.

    Device services

    Available services: vapix_call.

    @@ -172,7 +172,7 @@ Any specific levels for triggers needs to be configured on the device.
    - + diff --git a/sitemap.xml b/sitemap.xml index 8b9a0bfe7c..b4912ff9f7 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -3884,62 +3884,62 @@ https://home-assistant.io/demo/frontend.html -2017-08-22T09:04:54+00:00 +2017-08-22T11:06:30+00:00 https://home-assistant.io/demo/index.html -2017-08-22T09:04:54+00:00 +2017-08-22T11:06:30+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-event.html -2017-08-22T09:04:54+00:00 +2017-08-22T11:06:30+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-info.html -2017-08-22T09:04:54+00:00 +2017-08-22T11:06:30+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-service.html -2017-08-22T09:04:54+00:00 +2017-08-22T11:06:30+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-state.html -2017-08-22T09:04:54+00:00 +2017-08-22T11:06:30+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-template.html -2017-08-22T09:04:54+00:00 +2017-08-22T11:06:30+00:00 https://home-assistant.io/demo/panels/ha-panel-history.html -2017-08-22T09:04:54+00:00 +2017-08-22T11:06:30+00:00 https://home-assistant.io/demo/panels/ha-panel-iframe.html -2017-08-22T09:04:54+00:00 +2017-08-22T11:06:30+00:00 https://home-assistant.io/demo/panels/ha-panel-logbook.html -2017-08-22T09:04:54+00:00 +2017-08-22T11:06:30+00:00 https://home-assistant.io/demo/panels/ha-panel-map.html -2017-08-22T09:04:54+00:00 +2017-08-22T11:06:30+00:00 https://home-assistant.io/googlef4f3693c209fe788.html -2017-08-22T09:04:54+00:00 +2017-08-22T11:06:30+00:00 https://home-assistant.io/static/fonts/roboto/DESCRIPTION.en_us.html -2017-08-22T09:04:54+00:00 +2017-08-22T11:06:31+00:00 https://home-assistant.io/static/fonts/robotomono/DESCRIPTION.en_us.html -2017-08-22T09:04:54+00:00 +2017-08-22T11:06:31+00:00 https://home-assistant.io/static/mdi-demo.html -2017-08-22T09:04:54+00:00 +2017-08-22T11:06:31+00:00
    cgi yesWhich cgi to call on device. Default is param.cgi.Which cgi to call on the device. Default is param.cgi.
    action