shred86 841e06cc9f
Update Abode quality scale and minor clean up (#12367)
* Update Abode quality scale and minor clean up

Updates Abode quality scale to gold. Manifest for the integration is being updated in [this PR](https://github.com/home-assistant/core/pull/32562). Also cleaned up some left over links from a previous update and made some other minor edits for accuracy.

* Remove integration quality scale

Removed the integration quality scale ranking for now. The abode integration still needs some more work before the ranking is updated.
2020-03-18 13:27:56 +01:00

5.2 KiB

title, description, ha_category, ha_release, ha_iot_class, ha_config_flow, ha_codeowners, ha_domain
title description ha_category ha_release ha_iot_class ha_config_flow ha_codeowners ha_domain
Abode Instructions on integrating Abode home security with Home Assistant.
Hub
Alarm
Binary Sensor
Camera
Cover
Light
Lock
Sensor
Switch
0.52 Cloud Push true
@shred86
abode

The abode integration will allow users to integrate their Abode Home Security systems into Home Assistant and use its alarm system and sensors to automate their homes.

Please visit the Abode website for further information about Abode Security.

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

  • Alarm Control Panel: Reports on the current alarm status and can be used to arm and disarm the system.
  • Binary Sensor: Reports on Quick Actions, Door Contacts, Connectivity sensors (remotes, keypads, and status indicators), Moisture sensors, and Motion or Occupancy sensors.
  • Camera: Reports on Camera devices and will download and show the latest captured still image.
  • Cover: Reports on Secure Barriers and can be used to open and close the cover.
  • Lock: Reports on Door Locks and can be used to lock and unlock the door.
  • Light: Reports on Dimmer lights and can be used to dim or turn the light on and off.
  • Switch: Reports on Power Switch and Water Valve devices which can be turned on and off. Also reports on Automations set up in the Abode system and allows you to activate or deactivate them.
  • Sensor: Reports on Temperature, Humidity, and Light sensors.

Configuration

To use Abode devices in your installation, add your Abode account from the integrations page. Two-factor authentication must be disabled on your Abode account. Alternatively, Abode can be configured by adding the following abode section to your configuration.yaml file:

# Example configuration.yaml entry
abode:
  username: abode_username
  password: abode_password

{% configuration %} username: description: Username for your Abode account. required: true type: string password: description: Password for your Abode account. required: true type: string polling: description: > Enable polling if cloud push updating is less reliable. Will update the devices once every 30 seconds. required: false type: boolean default: false {% endconfiguration %}

Events

There are a number of events that can be triggered from Abode. They are grouped into the below events:

  • abode_alarm: Fired when an alarm event is triggered from Abode. This includes Smoke, CO, Panic, and Burglar alarms.
  • abode_alarm_end: Fired when an alarm end event is triggered from Abode.
  • abode_automation: Fired when an Automation is triggered from Abode.
  • abode_panel_fault: Fired when there is a fault with the Abode hub. This includes events like loss of power, low battery, tamper switches, polling failures, and signal interference.
  • abode_panel_restore: Fired when the panel fault is restored.
  • abode_disarm: Fired when the alarm is disarmed.
  • abode_arm: Fired when the alarm is armed (home or away).
  • abode_test: Fired when a sensor is in test mode.
  • abode_capture: Fired when an image is captured.
  • abode_device: Fired for device changes/additions/deletions.
  • abode_automation_edit: Fired for changes to automations.

All events have the fields:

Field Description
device_id The Abode device ID of the event.
device_name The Abode device name of the event.
device_type The Abode device type of the event.
event_code The event code of the event.
event_name The name of the event.
event_type The type of the event.
event_utc The UTC timestamp of the event.
user_name The Abode user that triggered the event, if applicable.
app_type The Abode app that triggered the event (e.g., web app, iOS app, etc.).
event_by The keypad user that triggered the event.
date The date of the event in the format MM/DD/YYYY.
time The time of the event in the format HH:MM AM.

There is a unique list of known event_codes that can be found here.

Services

Service change_setting

Change settings on your Abode system. For a full list of settings and valid values, consult the AbodePy settings section.

Service data attribute Optional Description
setting No The setting you wish to change.
value No The value you wish to change the setting to.

Service capture_image

Request a new still image from your Abode camera.

Service data attribute Optional Description
entity_id No String or list of strings that point at entity_ids of Abode cameras.

Service trigger_automation

Trigger an automation on your Abode system.

Service data attribute Optional Description
entity_id No String or list of strings that point at entity_ids of switches that represent your Abode automations.