Risco


This integration connects with Risco Alarms over Risco Cloud.

As from January 2021, Risco have implemented charges for use of their Cloud Features.

Configuration

Adding Risco to your Home Assistant instance can be done via the user interface, by using this My button:

Manual configuration steps
It is recommended to use a regular (non-owner) account with the Risco app/website, and use a different regular account with the integration. Risco has restrictions on concurrent uses by different users, especially if they have different permission levels.

4 sensors will be created to store events, depending on the category (Status, Alarm, Trouble and Other). Each sensor has the event timestamp as the state, and other event information in attributes.

If you have multiple sites, only the first site will be used.

Options

You can configure additional behavior by clicking on Options in the relevant box in the Integration panel:

How often to poll Risco (in seconds)

The lower this is, the faster your entities will reflect changes, but the more resource-intensive it’ll be.

Require pin code to arm

When checked, you’ll need to enter your pin code when arming through Home Assistant.

Require pin code to disarm

When checked, you’ll need to enter your pin code when disarming through Home Assistant.

Apart from these options, you can also define a custom mapping between your Home Assistant Alarm states and the Risco arming modes. This is an advanced configuration, and unless you’re using group arming, the default mapping should probably be best. This is a two-way mapping, meaning you can map:

  • What Home Assistant state your partition entity will report when Risco is armed in a specific mode.
  • Which arming mode to use when arming from Home Assistant using one of its modes. Note that in this step, you can only choose combinations that map to each other in the previous step.

The default mapping:

Risco Arming Mode Home Assistant State
Arm (AWAY) Armed Away
Partial Arm (STAY) Armed Home
Group A Armed Home
Group B Armed Home
Group C Armed Home
Group D Armed Home

And in the reverse direction:

Home Assistant Mode Risco Arming Mode
Arm Away Arm
Arm Home Partial Arm

Services

Service risco.bypass_zone

This service marks a zone as bypassed so that the alarm isn’t triggered when the zone is triggered.

Note you can only bypass a zone when the partitions it belongs to are disarmed, and it will take effect next time you arm.

Risco automatically un-bypasses the zone after the alarm is disarmed again.

Service Data Attribute Required Description
entity_id no String or list of strings of entity_ids of zones. Use entity_id: all to target all zones.

Service risco.unbypass_zone

This undoes a zone bypass. You can only unbypass a zone when the partitions it belongs to are disarmed.

Service Data Attribute Required Description
entity_id no String or list of strings of entity_ids of zones. Use entity_id: all to target all zones.

Supported Platforms: