AICO HomeLINK integration for Home Assistant

The homelink platform allows you to view the status of your AICO alarm system. Note that you need an AICO HomeLINK dashboard account with Landlord access to be able to create the credentials needed to use this integration.

This table provides a list of AICO 1000 and 3000 series devices and their support status. It is possible that other RadioLINK devices will also work, but these have not been tested at all:

Model No Sensor Type Model Type Supported Notes
Ei1000G Gateway GATEWAY True Required
Ei1020 Condensation, Damp, Mould   False It may work, but untested
Ei1025 Condensation, Damp, Mould, Air ENVCO2SENSOR True  
Ei3014 Heat FIREALARM True  
Ei3016 Smoke FIREALARM True  
Ei3018 CO   False It may work, but untested
Ei3024 Heat, Smoke   False It may work, but untested
Ei3028 CO, Heat FIRECOALARM True  
Ei3030 CO, Heat, Smoke FIRECOALARM True  
Ei450 Alarm Controller EIACCESSORY True  

These are the presented as the following entity types within Home Assistant:

  • Binary Sensor
    • Property status
    • Property Fire/Heat/CO Alarm Overall Status
    • Property Environment Overall Status
    • Device status
  • Event
    • Property last MQTT event (with MQTT enabled)
    • Device last MQTT event (with MQTT enabled)
  • Sensor
    • Device last tested date
    • Device replace by date
    • CO2, Humidity, Temperature
    • Insights (with Insights enabled)

Installation

You can either use HACS or install the component manually:

  • HACS - Home Assistant Community Store (HACS) - search for and install AICO HomelINK

  • Manual - Put the files from /custom_components/homelink/ in your folder <config directory>/custom_components/homelin/

Configuration

Base Integration

Configuration is done via the Home Assistant Integrations UI dialogue which will request a Client ID and Secret that you must obtain from the HomeLINK Dashboard. You will need to have an admin account on your dashboard to enable access to the integrations dialogue. If you have a standard account you will need to request an admin account from AICO HomeLINK.

You will need to create a set of credentials by going to the Access Keys tab of the integrations dialogue and requesting a Web Api credential with the Standard scope. Make a note of the credentials generated and enter them into the standard Home Assistant integration installation dialogue. If you input incorrect credentials and it fails to authenticate at setup time, then you will likely need to delete the credentials via the Home Assistant Application Credentials and start again.

Note:- Only one instance of the integration can be installed to Home Assistant. However, all properties and devices you have access to will be exposed.

Insights

If you have environment devices (Ei1020 and Ei1025) installed, then you may optionally enable Insight sensors. These will display the level of various types of risk as a percentage.

MQTT

If you wish to receive alerts via MQTT (the base integration will update every 30 seconds) to give you quicker notification of alerts and readings, then please follow the instructions here - MQTT Setup.

Webhook

If you wish to receive alerts via Webhook (the base integration will update every 30 seconds) to give you quicker notification of alerts and readings, then please follow the instructions here - Webhook Setup.