This is a Homebridge platform plugin to expose Comelit ICONA features to HK. The code is based on the reverse engineering of the official protocol, so expect bugs. The plugin currently supports only listing and opening connected doors/gates.
- Install homebridge
- Install this plugin:
npm install -g homebridge-comelit-icona
- Update your
config.json
file
You can setup the plugin by using the builtin Homebridge WEB UI tool. You need at least to provide:
- bridge_url: URL of the ICONA Bridge server
- bridge_port: TCP port of the ICONA Bridge server (optional, default is 64100)
- icona_token: Authentication token used to communicate with the bridge
Here is a sample config for the plugin:
{
"platform": "Icona",
"name": "Icona",
"bridge_url": "192.168.1.100",
"icona_token": "yoursuperrsecrettoken"
}
The plugin will automatically fetch the configuration on startup and configuring for you all the gates/doors you have mapped
in the system. By default, they will be mounted as temporized gate
with a default configuration:
{
"type": "temporized_gate",
"opening_time": 20,
"closing_time": 20,
"opened_time": 60
}
You can override these settings by adding a devices
section in the config.json file (you can use the WEB UI if you prefer).
You can choose between simple_gate
and temporized_gate
: the former is a door that will reset its state after a period
of opened_time
seconds. The latter is an automatic gate that opens in opening_time
seconds, stay opened for opened_time
seconds and then closes in closing_time
seconds. Usually opening_time
and closing_time
are equals.
Simple gate example:
{
"platform": "Icona",
"name": "Icona",
"bridge_url": "192.168.1.100",
"icona_token": "yoursuperrsecrettoken",
"devices": [
{
"name": "NAME_OF_THE_DOOR",
"type": "simple_gate",
"opened_time": 120
}
]
}
Temporized gate example:
{
"platform": "Icona",
"name": "Icona",
"bridge_url": "192.168.1.100",
"icona_token": "yoursuperrsecrettoken",
"devices": [
{
"name": "NAME_OF_THE_DOOR",
"type": "temporized_gate",
"opening_time": 30,
"closing_time": 30,
"opened_time": 120
}
]
}