IoT Quick Start Guide

Sensor Template Import

5min

In the web configuration, a template file for the automatic setup of sensors can be uploaded in the "Software" section under the menu item "Templates". Possibly the log of a previous template import is already displayed here.



Document image


Make sure that you have selected the checkbox in front of the warning. This will enable the upload button and you can submit the file.



Document image


The template file must have the extension ".template". A simple template consists of one sensor entry per line. The structure of each line is as follows:

<SensorID>=<ReferenceID>

<SensorID> is replaced by the sensor ID in decimal or hexadecimal notation. Important for hexadecimal notation a "0x" must be prefixed.

The <ReferenceID> is replaced by an internal identifier. For EEPs, the reference ID is structured as follows:

enocean.enocean.eep.<RORG>-<FUNCTION>-<TYPE>

The placeholders must be replaced with the respective hexadecimal value (without 0x). Letters must be written in lower case! Example:

enocean.enocean.eep.d2-01-12

A valid template would be for example a file with the following content:

0x38e021a=enocean.enocean.eep.d2-01-12 94462172=enocean.enocean.eep.a5-02-17 0xe025d1a5=enocean.pressac.slr

If the upload was successful, it will take a few seconds and the green LED of the gateway will start flashing rapidly. When the import is complete, the device restarts.



Document image


During the restart, the web configuration indicates that the connection to the gateway has been lost. After the device is restarted, the web configuration should show the login page again. If this does not happen automatically, please reload the web configuration manually.



Document image


The result of the import can now be viewed under the "Templates" menu item. The imported device types including the assigned EnOcean IDs are displayed here. The result can also be printed, for this purpose the printer button in the upper right corner can be used.



Document image


Important!

Imported sensors are always created in addition to existing sensors. Exception is if a device with the same ID already exists. This will then be overwritten.