Welasco / HubitatAlarm

6 stars 1 forks source link

Hubitat Alarm

Hubitat Alarm is a solution to integrate DSC (IT-100 or Envisalink) or Honeywell (Envisalink) alarm system to Hubitat Elevation. It will allow you to control your home alarm (DSC or Honeywell) using Hubitat from everywhere. It's compatible with HSM (Hubitat Safety Monitor) you can ARM, Disarm all modes using HSM, Rule Machine or any other automation.

You can also build your own Alarm dashboard: app10

Hubitat Alarm is all in one solution with the following features:

DSC Alarm

DSC with IT-100

IT-100 is a serial board (RS-232) that can be integrated with DSC Alarm system. It implement an interface to interact with DSC main Alarm board by sending/receiving commands. More information.

DSC with Envisalink

Honeywell Alarm

Honeywell with Envisalink

Connectivity

Hubitat Alarm was build to run in a single board compute like Raspberry Pi. There are many possible options to connect Hubitat Alarm to your home alarm (DSC or Honeywell) using a Raspberry Pi. Here is a list of possible options:

Connection logic:

Hubitat Diagram

Hubitat Alarm technical details

Hubitat Alarm is a Node.JS application that works like a bridge between DSC or Honeywell alarms to Hubitat HUB. It will detect all events in the alarm and will communicate with Hubitat application.

It supports either DSC-IT100 or Envisalink to connect to DSC or Honeywell alarms.

The communication between Hubitat app and Hubitat Alarm can be configured in two possible ways:

Setup Hubitat Alarm

There are two methods to install Hubitat Alarm to a Raspberry Pi. It can be installed using a script or docker container.

Script Installation method

To install Hubitat Alarm in your Raspberry Pi using script just copy and paste the following command line:

curl -SL https://raw.githubusercontent.com/Welasco/HubitatAlarm/master/Alarm/install.sh | sudo -E bash -

To update just run the same command again. It will detect if it was already installed and update to the latest version. Hubitat Alarm will be installed under this path: /opt/Alarm. It will create a config.json file that should be backup to preserve all your settings.

To uninstall run the following command:

curl -SL https://raw.githubusercontent.com/Welasco/HubitatAlarm/master/Alarm/uninstall.sh | sudo -E bash -

Docker method

You must have Docker installed. You can use the following commands to install Docker in your Raspberry Pi.

sudo curl -sL get.docker.com | bash
sudo usermod -a -G docker pi

Run Hubitat Alarm container using the following command:

docker run --name=hubitatalarm -d -p 3000:3000 -v /home/pi/hubitatalarmConfig:/opt/Alarm/config --device=/dev/ttyUSB0 -e TZ=America/Chicago --restart always welasco/hubitatalarm:latest
docker run --name=hubitatalarm -d -p 3000:3000 -v /home/pi/hubitatalarmConfig:/opt/Alarm/config -e TZ=America/Chicago --restart always welasco/hubitatalarm:latest

Hubitat Alarm will create a config.json file in the mounted folder /home/pi/hubitatalarmConfig. It's important to keep this file out of the container in case you have to update or reinstall the container.

To update a container you run the following commands:

# Updating Alarm conatiner
docker pull welasco/hubitatalarm:latest
docker stop hubitatalarm
docker rm hubitatalarm
# Run command for DSC-IT100
docker run --name=hubitatalarm -d -p 3000:3000 -v /home/pi/hubitatalarmConfig:/opt/Alarm/config --device=/dev/ttyUSB0 --restart always welasco/hubitatalarm:latest
# Run command for Envisalink
docker run --name=hubitatalarm -d -p 3000:3000 -v /home/pi/hubitatalarmConfig:/opt/Alarm/config --restart always welasco/hubitatalarm:latest

Installing Hubitat App in your HUB

The Hubitat App consist in two files the App HubitatAlarmApp.groovy and the driver HubitatAlarmPanel.groovy. You can manually download both App and the driver and install using the respective instructions steps. I recommend the installation to be done using Hubitat Package Manager it's easier and has an update process to keep the code always updated.

Installing Hubitat Alarm code using Hubitat Package Manager

In case you don't have Hubitat Package Manager installed yet you can follow the instructions here to get it installed.

Installing Hubitat Alarm app

After you have installed the code using Hubitat Package Manager it's the time to install the App

Using Hubitat Safety Monitor

Hubitat Alarm is compatible with Hubitat Safety Monitor. You can install Hubitat Safe Monitor from a Built-in App and configure as follow.