These instructions are provided "as-is" by the Boundary team. We cannot guarantee success and only limited support but the methods have been tested and confirmed as working on our own installations
Home Assistant (HA) or HASS is a smart home assistant that works locally on a device such as Raspberry Pi, a home PC or a dedicated microcomputer. Most smart home devices will connect directly through the local network to HA via Wifi, Zwave or Zigbee networks allowing control of these devices and also giving the owner the ability to create advanced automations. It is aimed at the slightly more technical end of the market but with a bit of wrangling, it is possible to use Boundary with HA.
Reminder - The method below is not a direct integration with HA and does come with a few caveats and workarounds.
In order to integrate Boundary with HA you will need:
- A Boundary system with a paid subscription
- Your Boundary system connected to a Smartthings account
- A working HA installation with external access either through Nabu Casa or your own domain
You do need to ensure that your Boundary installation is integrated with Smartthings correctly before proceeding further in this guide as it is integral to the HA integration.
Home Assistant Integration
The first step is to bring your Boundary sensors and hub into your HA system. HA has a native integration available for Smartthings that is quick and simple to set up. You can find full details on how to add the integration on the HA site here: https://www.home-assistant.io/integrations/smartthings/
Once you have connected HA to Smartthings, your sensors will now all be available in HA. Although this is completed through a cloud connection, the speed is actually pretty good for automation.
Boundary Alarm Status and Activation
The one area that is not exposed through this Smartthings > HA bridge is the current state of the alarm or if it is currently activated. This information is only available on the Smartthings side. To get around this, you can create a virtual switch in Smartthings to store the status of the alarm and then expose this to HA.
The Smartthings virtual switch is simply a sensor not attached to a physical device. The steps for creation are very simple:
- Login to your Smartthings account at: https://graph.api.smartthings.com/
- Create a new device handler by selecting Device Handlers and Add New
- On the new handler page, select the From Code option
- To get the required code, visit https://raw.githubusercontent.com/bjpierron/SmartThings-Alexa/master/devicetypes/bjpierron/simulated-alexa-switch.src/simulated-alexa-switch.groovy and select all the code, copy to your clipboard and paste into the code field on Smartthings
- Tap the Create button and then publish the handle using the Publish button
What you have done here is create a method to handle the switching on and off of a sensor/switch. This switch can also be used in Alexa routines but that's a different story. Now it's time to create the switches that will use this handler to control the alarm states:
- Select Devices in the IDE and then Create a New Device
- You will now see a form with several fields. If they are not mentioned in the instructions below then just leave them blank:
- Name: A name for the device so you could call this one Boundary Armed
- Label: Set this to what you like or just the name of the device
- Device Network ID: Again can be anything but it has to be unique, letters and numbers and no spaces e.g. BoundArmSwitch1
- Type: Dropdown this field and scroll to the bottom and you will see Simluated Alexa Switch as the handler you created above
- Version: Should be set to Published
- All done! You now need to repeat these steps to add a second switch to handle if the Boundary alarm is activated. Just complete the fields as before using the same handler but make sure the name and network ID of this second switch are different.
If you have got this far then you should now have two new switches in your Smartthings app. Just assign them to the same room as your Boundary hub in the Smartthings app. We now need to create a couple of automations in Smartthings to control these switch states. Again super simple to achieve.
- Login to the Smartthings app and select Automations
- Tap the plus (+) symbol at the top right and select Add Routine
- There is a few routines we need to create, four in total so just create them as below:
- Boundary Armed: If Boundary Hub status is Armed then set the Boundary Armed Switch to On
- Boundary Disarmed: If Boundary Hub status is Disarmed then set the Boundary Armed Switch to Off
- Boundary Activated: If Boundary Hub Alarm Activation Status is Alarmed then set the Boundary Alarmed Switch to On
- Boundary De-Activated: If Boundary Hub Alarm Activation Status is All Clear then set the Boundary Alarmed Switch to Off
- Now, of course, you can add other conditions in there and your switch names may be different but as long as you have a method of switching the switches on and off then you're good to go.
Head back over to your HA installation and you will need to refresh the Smartthings integration to include these two new switches:
- Select Configuration > Integrations > Smartthings
- Reload the integration
- The new switches will be added to HA
All done. You can now create automations in HA using Boundary sensors and the alarm status!