This app enables you to use your Homey as a surveillance system.
Important: Action needed due to upcoming new firmware
Athom will release firmware 12.2.0 for Homey Pro 2023, please see this post on how to prepare or fix broken flows.
Supported languages
Dutch
English
German
French
Italian
Swedish
Norwegian
Spanish
Danish
Links
- App Store: Heimdall App for Homey | Homey
- Github: GitHub - daneedk/com.uc.heimdall: Heimdall for Homey
- issues: Issues · daneedk/com.uc.heimdall · GitHub
- FAQ: Heimdall - Let Homey watch over your home - #2 by DaneedeKruyff
- Change log: Heimdall - Let Homey watch over your home - #3 by DaneedeKruyff
If you want to support this app, please consider a donation
Donations are very welcome, though they come with no guarantees, warranties, or preferential treatment (just think of it that you’re donating for the work already done, not the work to be done).
How does it work?
All detected motion and opened/closed doors/windows on the sensors you select will be seen by Heimdall. All these events will be logged and when Heimdall is in a Surveillance Mode the Alarm State will be activated.
Instructions
- Select the devices to monitor on the settings page.
- Add a Surveillance Mode Switch.
- Add methods to control the Surveillance Mode.
- Add a flow with the desired actions when the alarm is triggered.
- Add a flow to deactivate the alarm.
- Add an Alarm Button.
After you’ve completed the instructions above and feel comfortable with Heimdall you’re ready for the Advanced Functions in Heimdall
Select the devices to monitor on the settings page
There are three possible Surveillance Modes these are: Disarmed , Armed and Partially Armed . Per sensor you can decide if it will be monitored while Armed , Partially Armed or in both modes. To give you the opportunity to leave the house after setting an Armed or Partially Armed mode or to Disarm when entering your house you can enable a Delay on the desired sensor.
Instructions overviewAdd a Surveillance Mode Switch
Go to the devices and click the plus icon to add a device and select Heimdall from the presented brands.
Choose the Mode device in the devices overview screen…
and click Install followed by clicking Next to finish the installation.
Add methods to control the Surveillance Mode
There are several methods to change the Surveillance Mode , either by a flow and/or by using the Surveillance Mode Switch in the Homey app on your phone. If you have the Homekitty app installed you can even use the Homekit app on your iPhone or iPad to set the Surveillance Mode.
If you want to use a keypad to set the Surveilance Mode you can, check out the Ring Security App.
To change the Surveillance Mode from a flow you will have to use the Set Surveillance Mode card from the Surveillance Mode Switch as an action.
Add a flow with the desired actions when the alarm is triggered
To set the action Homey should take when the Alarm State is activated you need to make a flow with the The alarm is activated flow card as the trigger. That flow card has the Zone and Reason token which will show what sensor was the tripped and which zone it belongs in.
Add a flow to deactivate the alarm
Deactivating the alarm can be done in either of two ways. The first is by using the Deactivate Alarm flow action card, the second by using the Alarm Button you can add from the app.
Add an Alarm Off Button
Go to the devices and click the plus icon to add a device and select Heimdall from the presented brands.
Choose the Alarm device in the devices overview screen…
and click Install followed by clicking Next to finish the installation.
Advanced functions
Settings
The Arming Delay can be used for delaying the changing of the Surveillance Mode to give you time to leave the house when using for example an Alarm panel. You can select the delay when arming for each of the armed Surveillance Modes, see Delays for more information. The Alarm Delay can be used to give you time to set the Surveillance Mode to disarmed when entering the house. Both delays can be set to any value in the 0-300 seconds range.
For logging you can choose to always log any event from a sensor or only when a Surveillance Mode is active and you can decide to only log activating of sensors. The setting to also Listen to tampering reports from sensors will enable this for all sensors supporting this capability.
When the Surveillance Mode is set a Pre Arming Check is preformed, you can select what type of sensors should be checked during the Pre Arming Check. If you use an Arming Delay you can also decide to perform the Pre Arming Check when the Arming Delay starts instead of when the Surveillance Mode is actually set. See Pre Arming Check for more information.
Heimdall can write important events to your Timeline, you can select which events should be written to it.
And it supports speech output for certain actions.
Delays
The Alarm Delay can be used to give you enough time to set the Surveillance Mode to Disarm after entering the house through a door that has a door sensor.
When a sensor is tripped and the Surveillance Mode is in any of the Armed states the Alarm State will be set to activated immediately when no Delayed Trigger is configured on the triggered device.
If the Delayed Trigger is configured on the triggered device a countdown will start for the duration of the Alarm Delay setting. If the Surveillance Mode is not set to Disarmed during the countdown on the end of it the Alarm State will be activated.
When the countdown starts the trigger flow card The alarm delay is activated can be used to inform you the countdown has started. The card has three tags, Zone, Reason and Duration which you can use in for example a spoken or a push message. The trigger card The time until alarm changed is called every second during the countdown and the tag Seconds holds the number off seconds until the Alarm State is activated.
When the option Use delay when enabling Armed mode or Use delay when enabling Partially Armed mode is checked the The arming delay is activated card will is activated. The card has one tag; Duration. During the countdown the The time until armed changed trigger flow card is called every second holding a tag Seconds which is again the seconds until the Surveillance Mode is activated.
Last Door Functionality
The Last Door Functionality can be used to shorten the Arming Delay to 10 seconds after leaving the house. This function is automatically enabled on a Door Sensor that has the Delayed Trigger set to yes. To use it, just make sure the door is closed when the Surveillance Mode is set. When the Surveillance Mode is set the normal Arming Delay will start, after opening and closing a door which has the Delayed Trigger set the Arming Delay will be lowered to 10 seconds.
Pre Arming check
When setting the Surveillance Mode to either Armed or Partially Armed Heimdall can do a Pre Arming check, you can choose what sensor types to include:
When using an Arming Delay the Pre-Arming check will be done when the actual Surveillance Mode is set, so when the delay countdown ends, you can let the Pre Arming check be performed before the Arming Delay by enabling the Perform check before Arming Delay setting.
When a sensor is not in the desired state during the Pre Arming check the flowcard Sensor active at arming will be triggered with the token Warning containing the text “Warning, sensor active…”
and it will be logged to the history:
There is also the option to let Homey tell you when a sensor is active, see the possible speech options below.
Log
If you do not want a device to activate an Alarm State but do want to log if for example motion is detected you can select the Log option for that device.
When a device with the Log option changes state the A logline was written flow card will be triggered. This card has the tags Zone, Device and State.
All Flow Cards
Triggers: when…
Conditions: …and…
Actions: …then
If you have any questions and or remarks please post them here.
