2022-11-27 19:25:31 +01:00
# Qolsys IQ Binding
This binding directly controls a [Qolsys IQ ](https://qolsys.com/security/ ) security panel.
This allows for local monitoring of alarm and zone statuses as well as arming, disarming and triggering alarms.
Qolsys (a division of Johnson Controls) is a popular manufacturer of alarm systems.
2022-12-14 16:52:43 +01:00
The Qolsys IQ line of panels supports both wireless and hard wire sensors and features built in Cellular and Wi-Fi dual path communication that natively integrates with Alarm.com monitoring and supervision.
2022-11-27 19:25:31 +01:00
2022-12-14 16:52:43 +01:00
This binding directly interfaces with the panel and does not require cloud access.
2022-11-27 19:25:31 +01:00
## Supported Things
| Thing | Description | Thing Type | Thing UID |
|---------------------|-------------------------------------------------------------------------------------------|------------|-----------|
| Qolsys IQ Panel | A Qolsys IQ security panel (all current models, which is 2+ and 4 at the time of writing) | Bridge | panel |
| Qolsys IQ Partition | A logical partition which can be armed, disarmed, and is responsible for managing zones | Bridge | partition |
| Qolsys IQ Zone | A generic zone sensor | Thing | zone |
## Discovery
### Qolsys IQ Panel (Bridge)
The Qolsys IQ Panel must be manually added using a host name or ip address along with a secure access token from the panel settings.
To enable 3rd party control and retrieve the access token follow the following steps on the security panel touch screen:
`Settings` --> `Advanced Settings` --> `Installation` --> `Dealer Settings` -> `6 Digit User Code` (set to enabled)
`Settings` --> `Advanced Settings` --> `Installation` --> `Devices` --> `Wi-Fi Devices` --> `Control4` (set to enabled)
2022-12-14 16:52:43 +01:00
Panel will _reboot_
2022-11-27 19:25:31 +01:00
`Settings` --> `Advanced Settings` --> `Installation` --> `Devices` --> `Wi-Fi Devices` --> `Reveal Secure Token` (copy token to use in panel configuration)
2024-09-28 17:46:53 +02:00
At this point you may add the panel thing in openHAB using the secure token along with the IP or host name of the panel.
2022-11-27 19:25:31 +01:00
### Partition (Bridge)
Once a panel is added, partitions will be automatically discovered and appear in the inbox.
### Zone (Thing)
Once a partition is added, zones will be automatically discovered and appear in the inbox.
## Thing Configuration
### `panel` Thing Configuration
| Name | Type | Description | Default | Required | Advanced |
|-------------------|---------|-----------------------------------------------------|---------|----------|----------|
| hostname | text | Hostname or IP address of the device | N/A | yes | no |
| port | integer | Port the device is listening on | 12345 | no | no |
| key | text | Access token / key found in the panel settings menu | N/A | yes | no |
### `partition` Thing Configuration
| Name | Type | Description | Default | Required | Advanced |
|------------|---------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------|----------|----------|
| id | integer | Partition id of the panel, staring with '0' for the first partition | N/A | yes | no |
| disarmCode | text | Optional disarm code to use when receiving a disarm command without a code. Required for integrations like Alexa and Homekit who do not provide codes when disarming. Leave blank to always require a code | blank | no | no |
| armCode | text | Optional arm code to use when receiving arm commands without a code. Only required if the panel has been configured to require arm codes. Leave blank to always require a code | blank | no | yes |
### `zone` Thing Configuration
| Name | Type | Description | Default | Required | Advanced |
|---------|---------|---------------------------------------------------------------------------------------------------------|---------|----------|----------|
| id | integer | Id of the zone, staring with '1' for the first zone | N/A | yes | no |
## Channels
### Panel Channels
None.
### Partition Channels
| Channel | Type | Read/Write | Description | State Options | Command Options |
|-------------|--------|------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------|----------------------------|
| armState | String | RW | Reports the current partition arm state or sends an arm or disarm command to the system. Security codes can be appended to the command using a colon delimiter (e.g. 'DISARM:123456'). Codes appended to the command will be used in place of the `armCode` configuration property if set. | ALARM, ARM_AWAY, ARM_STAY, DISARM, ENTRY_DELAY, EXIT_DELAY | ARM_AWAY, ARM_STAY, DISARM |
| alarmState | String | RW | Reports on the current alarm state, or triggers an instant alarm | AUXILIARY, FIRE, POLICE, ZONEOPEN, NONE | AUXILIARY, FIRE, POLICE |
| armingDelay | Number | R | The arming delay countdown currently in progress | Seconds remaining | N/A |
| errorEvent | String | R | Last error event message reported by the partition. Clears after 30 seconds | Error text | N/A |
### Zone Channels
2022-12-14 16:52:43 +01:00
| Channel | Type | Read/Write | Description | State Options |
2022-11-27 19:25:31 +01:00
|---------|---------|------------|------------------------|---------------------------------------------|
| status | String | R | The zone status | ACTIVE, CLOSED, OPEN, FAILURE, IDLE, TAMPER |
| state | Number | R | The zone state | Number |
| contact | Contact | R | The zone contact state | OPEN, CLOSED |
## Full Example
### qolsysiq.things
2022-12-14 16:52:43 +01:00
```java
2022-11-27 19:25:31 +01:00
Bridge qolsysiq:panel:home "Home Security Panel" [ hostname="192.168.3.123", port=12345, key="AAABBB00" ] {
Bridge partition 0 "Partition Main" [ id=0, armCode="123456" ] {
Thing zone 1 "Window" [ id=1 ]
Thing zone 2 "Motion" [ id=2 ]
}
}
```
### qolsysiq.items
Sample items file with both Alexa and Homekit voice control
2022-12-14 16:52:43 +01:00
```java
2022-11-27 19:25:31 +01:00
Group PartitionMain "Alarm System" ["Equipment"] {alexa="SecurityPanel", homekit = "SecuritySystem"}
String PartitionMain_PartitionArmState "Partition Arm State" < Alarm > (PartitionMain) ["Point"] {channel="qolsysiq:partition:home:0:armState", alexa="ArmState" [DISARMED="DISARM",ARMED_STAY="ARM_STAY",ARMED_AWAY="ARM_AWAY:EXIT_DELAY"], homekit = "SecuritySystem.CurrentSecuritySystemState,SecuritySystem.TargetSecuritySystemState" [STAY_ARM="ARM_STAY", AWAY_ARM="ARM_AWAY", DISARM="DISARM", DISARMED="DISARM", TRIGGERED="ALARM"]}
String PartitionMain_PartitionAlarmState "Partition Alarm State" < Alarm > (PartitionMain) ["Point"] {channel="qolsysiq:partition:home:0:alarmState"}
Number PartitionMain_PartitionArmingDelay "Partition Arming Delay" (PartitionMain) ["Point"] {channel="qolsysiq:partition:home:0:armingDelay"}
String PartitionMain_ErrorEvent "Error Event" (PartitionMain) ["Point"] {channel="qolsysiq:partition:home:0:errorEvent" }
Group ZoneKitchenWindows "Qolsys IQ Zone: Kitchen Windows" ["Equipment"]
Number ZoneKitchenWindows_ZoneState "Kitchen Windows Zone State" (ZoneKitchenWindows) ["Point"] {channel="qolsysiq:zone:home:0:1:state"}
String ZoneKitchenWindows_ZoneStatus "Kitchen Windows Zone Status" (ZoneKitchenWindows) ["Point"] {channel="qolsysiq:zone:home:0:1:status"}
Contact ZoneKitchenWindows_ZoneContact "Kitchen Windows Zone Contact" (ZoneKitchenWindows) ["Point"] {channel="qolsysiq:zone:home:0:1:contact"}
Group ZoneMotionDetector1 "Motion Detector 1" ["Equipment"]
Number ZoneMotionDetector_ZoneState1 "Motion Detector 1 Zone State" (ZoneMotionDetector1) ["Point"] {channel="qolsysiq:zone:home:0:2:state"}
2024-09-28 17:46:53 +02:00
String ZoneMotionDetector_ZoneStatus1 "Motion Detector 1 Zone Status" (ZoneMotionDetector1) ["Point"] {channel="qolsysiq:zone:home:0:2:status"}
2022-11-27 19:25:31 +01:00
```
