# KentixONE

Kentix is a German company specializing in the development and production of innovative solutions for IT and building monitoring. Kentix products include smart sensors, alarm and monitoring systems, as well as access control and video surveillance systems. The devices are designed to ensure comprehensive and reliable monitoring of rooms, buildings, and IT infrastructures in order to quickly detect and avoid potential dangers. Kentix solutions are used in various industries, including office buildings, data centers, hospitals, schools, retail stores, and industrial facilities. The Eliona app for KentixONE allows access to this data and its visualization in Eliona.

## Installation

The installation of the KentixONE app is done via the app store in Eliona.

## Assets

The KentixONE app automatically creates all necessary asset templates and assets ([CAC](https://docs.buildings.ability.abb/collection/english-v14/apps/apps/broken-reference)), which are accessible via the configured endpoints. The following asset templates are created:

* **KentixONE Alarm Manager (KAM)**: a central monitoring and control system that integrates and manages various security components such as intrusion detection systems, fire alarm systems, and access control systems in a building.
* **KentixONE Multi Sensor (KMS)**: a versatile sensor that can measure various environmental parameters such as temperature, humidity, air quality, and vibrations, enabling comprehensive monitoring and early detection of potential dangers in buildings.
* **KentixONE Access Manager (KXP)**: an access control system that makes it possible to efficiently control and monitor access to buildings and rooms by managing permissions, schedules, and logs.
  * **Doorlock (DL)**: an electronic door lock that is used in conjunction with the Kentix Access Manager to control access to rooms or buildings.

The following attributes are defined for the individual asset templates:

<table><thead><tr><th width="304">Name</th><th width="259">Description</th><th width="71">KAM</th><th width="68">KMS</th><th width="68">KXP</th><th width="59">DL</th></tr></thead><tbody><tr><td>name</td><td>Name</td><td>X</td><td>X</td><td>X</td><td>X</td></tr><tr><td>ip_address</td><td>IP address</td><td>X</td><td>X</td><td>X</td><td></td></tr><tr><td>mac_address</td><td>MAC address</td><td>X</td><td>X</td><td>X</td><td></td></tr><tr><td>firmware_version</td><td>Firmware version</td><td>X</td><td>X</td><td>X</td><td></td></tr><tr><td>id</td><td>ID</td><td></td><td></td><td></td><td>X</td></tr><tr><td>device_id</td><td>Device ID</td><td></td><td></td><td></td><td>X</td></tr><tr><td>last_updated</td><td>Last updated</td><td></td><td>X</td><td></td><td></td></tr><tr><td>temperature</td><td>Temperature</td><td></td><td>X</td><td></td><td></td></tr><tr><td>humidity</td><td>Humidity</td><td></td><td>X</td><td></td><td></td></tr><tr><td>dew_point</td><td>Dew point</td><td></td><td>X</td><td></td><td></td></tr><tr><td>air_quality</td><td>Air quality</td><td></td><td>X</td><td></td><td></td></tr><tr><td>co2</td><td>CO₂</td><td></td><td>X</td><td></td><td></td></tr><tr><td>co</td><td>CO</td><td></td><td>X</td><td></td><td></td></tr><tr><td>heat</td><td>Heat</td><td></td><td>X</td><td></td><td></td></tr><tr><td>motion</td><td>Motion</td><td></td><td>X</td><td></td><td></td></tr><tr><td>vibration</td><td>Vibration</td><td></td><td>X</td><td></td><td></td></tr><tr><td>people_count</td><td>Count people</td><td></td><td>X</td><td></td><td></td></tr><tr><td>battery</td><td>Battery</td><td></td><td></td><td></td><td>X</td></tr><tr><td>open (writeable)</td><td>Open</td><td></td><td></td><td></td><td>X</td></tr></tbody></table>

## Dashboards

The KentixONE app provides a dashboard with all automatically created assets. This can be accessed via the Eliona frontend `Copy Dashboard > KentixONE` created automatically via the Eliona frontend and then customized as desired.

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/2kItGlCH2qZOcmYaPgna/image.png" alt=""><figcaption></figcaption></figure>

## Configuration

{% hint style="info" %}
More information on configuring apps can be found [↗ here](https://doc.eliona.io/collection/dokumentation/einstellungen/apps).
{% endhint %}

The KentixONE app is configured by setting up one or more Kentix devices as endpoints. It is possible to operate the devices in satellite or management mode. In satellite mode, the devices are available via the alarm manager. Devices in management mode can be accessed directly.

Each endpoint requires the following data:

<table><thead><tr><th width="203">Name</th><th>Description</th></tr></thead><tbody><tr><td>address</td><td>IP address or hostname of the KentixONE device.</td></tr><tr><td>apiKey</td><td>KentixONE API key.</td></tr><tr><td>enable</td><td>Flag to enable or disable fetching from this device.</td></tr><tr><td>refreshInterval</td><td>Interval in seconds for collecting data from the device.</td></tr><tr><td>requestTimeout</td><td>Timeout in seconds.</td></tr><tr><td>assetFilter</td><td>Filter for <a href="broken-reference">CAC</a> with regular expressions for parameter values. The expressions in the inner lists are logically AND-linked, and the lists themselves are OR-linked.</td></tr><tr><td>active</td><td>Is set to "true" by the app when it is running, and to "false" when the app is stopped.</td></tr><tr><td>projectIDs</td><td>List of project IDs for which assets are automatically created (<a href="broken-reference">CAC</a>)</td></tr></tbody></table>

Endpoints can be created in Eliona using this structure under `Apps > KentixONE > Setting` . To do this, the endpoint `/configs` with the method `PUT` must be selected.

```json
{
  "address": "10.10.10.101",
  "apiKey": "your_api_key",
  "enable": true,
  "refreshInterval": 60,
  "requestTimeout": 120,
  "assetFilter": [[ {
      "parameter": "macAddress",
      "regex": "(70:82:0e:12:28:cc|70:56:06:12:.*)"
  }]],
  "projectIDs": ["99"]
}
```