# KentixONE

Kentix is a German company that specializes in the development and production of innovative solutions for IT and building monitoring. Kentix products include smart sensors, alarming 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 to quickly detect and prevent potential dangers. Kentix solutions are used in various industries, including office buildings, data centers, hospitals, schools, retail stores, and industrial facilities. The BuildingPro Suites App for KentixONE allows access to this data and the display of the data in BuildingPro Suites.

### Installation

The KentixONE App is installed via the BuildingPro Suites App Store.

### Assets

The KentixONE App automatically creates all necessary asset templates and assets (CAC) that 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 burglar alarm 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 to enable comprehensive monitoring and early detection of potential dangers in buildings.
* **KentixONE Access Manager (KXP)**: a system for access control 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>People count</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 offers a dashboard with all automatically created assets. This can be automatically created via the BuildingPro Suites Frontend `Copy Dashboard > KentixONE` and then customized as desired.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2F93nUc2IdX27FAerLXoCl%2Fimage.png?alt=media&#x26;token=07c365e5-fb0e-4c28-aa9b-11344c63f165" alt=""><figcaption></figcaption></figure>

### Configuration

{% hint style="info" %}
You can find more information on app configuration [↗ here](https://doc.eliona.io/collection/dokumentation/einstellungen/apps).
{% endhint %}

The KentixONE App is configured by configuring 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 activate or deactivate the retrieval 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 CAC with regular expressions for parameter values. The expressions in the inner lists are logically AND-linked and the lists themselves with a logical OR.</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>tenantIDs</td><td>List of tenant IDs for which assets are automatically created (CAC)</td></tr></tbody></table>

Endpoints can be created with this structure in BuildingPro Suites under `Apps > KentixONE > Setting`. To do this, select the endpoint `/configs` with the method `PUT`.

```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:.*)"
  }]],
  "tenantIDs": ["99"]
}
```