The Satel Integra Alarm System allows openHAB to connect to your alarm system via TCP/IP network with ETHM-1/ETHM-1 Plus module installed, or via RS-232 serial port with INT-RS/INT-RS Plus module installed.
For ETHM-1 the binding uses integration protocol, so it must be enabled and properly configured.
Also it is always a good idea to update module/mainboard firmware to the latest version.
For ETHM-1 and INT-RS modules it is a must.
For "Plus" modules however it is not required.
In order to use encryption with ETHM-1/ETHM-1 Plus, Java Runtime Environment must support 192 bit AES keys.
Oracle Java by default supports only 128 bit keys, therefore ["Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files"](https://www.oracle.com/technetwork/java/javase/downloads/index.html) must be installed.
OpenJDK supports unlimited AES keys by default (but OpenJDK is sometimes discouraged for openHAB).
More details and all documentation about Integra system you can find on their site: [satel.pl](https://www.satel.pl/pl/cat/2#cat15)
| host | yes | Host name or IP addres of ETHM-1 module. |
| port | no | TCP port for the integration protocol, defaults to 7094. |
| timeout | no | Timeout value in milliseconds for connect, read and write operations, defaults to 5000 (5secs). |
| refresh | no | Polling interval in milliseconds, defaults to 5000 (5secs). As of version 2.03 ETHM-1 Plus firmware the module disconnects after 25 seconds of inactivity. Setting this parameter to value greater than 25000 will cause inability to correctly communicate with the module. |
| userCode | no | Security code of the user in behalf of all operations will be executed. If empty, only read operations are allowed. |
| encryptionKey | no | Encryption key used to encrypt data sent and received. If empty, communication is not encrypted. |
| encoding | no | Encoding for all the texts received from the module. |
| extCommands | no | Check this option to enable extended commands, supported by ETHM-1 Plus and newer versions of ETHM-1. Enabled by default, turn off in case of communication timeouts. |
**NOTE:** There can be only one client connected to ETHM-1 module.
It does not accept new connections if there is already a connection established.
In case you have troubles connecting to the system using this module, please make sure there is no other client (for example installed 1.x version of the binding) already connected to it.
### int-rs bridge
You can configure the following settings for this bridge:
| port | yes | Serial port connected to the module. |
| timeout | no | Timeout value in milliseconds for connect, read and write operations, defaults to 5000 (5secs). |
| refresh | no | Polling interval in milliseconds, defaults to 5000 (5secs). |
| userCode | no | Security code of the user in behalf of all operations will be executed. If empty, only read operations are allowed. |
| encoding | no | Encoding for all the texts received from the module. |
| extCommands | no | Check this option to enable extended commands, supported by version 2.xx of INT-RS. Enabled by default, turn off in case of communication timeouts. |
| date_time | DateTime | Date and time on the alarm system |
| troubles | Switch | Active when the system has troubles (trouble LED is blinking on a panel) |
| troubles_memory | Switch | Memorized state of system troubles |
| service_mode | Switch | Active when the system is in service mode |
| acu100_present | Switch | Active when there is an ACU-100 module installed in the system |
| intrx_present | Switch | Active when there is an INT-RX module installed in the system |
| grade23_set | Switch | Active when Grade2/Grade3 option is set in the system |
| user_code | String | Accepts string commands that override configured user code. Send empty string to revert user code to the one in the configuration. |
### event-log (deprecated)
These channels and the thing will be removed in the future release of the binding. Please use `readEvent` rule action instead.
In openHAB all channels have strict types, which means you cannot use other type then designated for a channel.
In Satel binding all binary items are now of 'Switch' type. Using other item types, like 'Contact' is not possible in this version of the binding.
For this reason, when migrating 1.x item files, besides changing binding configuration for each item, you must replace all 'Contact' items to 'Switch' type.
### 'module' channels
In version 2.x of the binding all 'module' channels have been removed.
You can easily replace them with the following configuration:
To control Integra partitions and outputs, you need to provide security code of a user in behalf of all those operations will be executed.
It is highly recommended to use a separate user for openHAB integration with only required access rights set in Integra configuration, like access to certain partitions, etc.
This allows you to distinguish actions made by openHAB and a user using Integra panel, also it will block unwanted operations in case someone breaks into your local network.
### Disarming and clearing alarms
Although this binding allows you to configure disarming a partition and clearing alarms for a partition, this should be used only in cases when security is not the priority.
Don't forget both these operations can be executed in openHAB without specifying a user code, which is required to disarm or clear alarms using Integra panel.
Consider adding a keypad in your sitemap to temporarily change user code to execute sensitive operations.
You can find such keypad in the [Full Example](#full-example) section.
## Media
* [Arming and clearing troubles](https://www.youtube.com/watch?v=ogdgn0Dk1G8)
