EasySens airConfig: Remote Management and Configuration Tool

Application

airConfig is a tool for configuring EasySens products, supporting wireless configuration and remote management. EasySens products supporting airConfig are marked with the airConfig symbol.

To use the airConfig software, a computer or laptop with a USB port is required, along with a USB airScan transceiver (Article No. 566704), necessary for field strength testing and fine-tuning devices. A 3m USB extension cable (Article No. 574044) is recommended to position the USB airScan transceiver optimally.

The software can be downloaded from the Thermokon website www.thermokon.de/download-center/, ensuring you get the latest version. The software will automatically check for new versions on the Thermokon server upon startup.

Installation

System Requirements:

Thermokon airConfig is available for devices with Microsoft® Windows XP or newer operating systems.

To use the USB airScan transceiver, the device requires a USB 2.0 port. Java Runtime Engine (JRE) must be installed.

Equipment:

Connect the USB airScan transceiver to a USB port on your laptop/PC. Follow the driver installation instructions. If the driver is not automatically detected, please download the latest driver version from the FTDI website for your operating system: http://www.ftdichip.com/Drivers/VCP.htm.

If the USB airScan transceiver driver was not installed correctly, a window like the following will appear:

Diagram Description: A dialog box titled 'USB transceiver not found!' with the message 'Please plug-in compatible device and restart.' and an 'OK' button.

If this occurs, check in the Windows Device Manager if airScan is detected correctly and the driver is installed. If the driver is missing, visit http://www.ftdichip.com/Drivers/VCP.htm and download the appropriate driver file for your system. Ensure you have administrator rights to install the driver.

Software

Download the software from the Thermokon media center at www.thermokon.de.

Navigate to 'Downloads/Media'.

Select the 'AirConfig' category, then the 'Software' group, and install the 'Install' product.

Follow the installation instructions.

Diagram Description: A screenshot of the Thermokon Download/Multimedia Center, showing categories like Air Quality, AirScan, CE Conformity Declarations, EasySens - Wireless, Humidity, etc. The 'AirScan' category is selected, and under 'Software', 'AirScan_Setup_3.20.exe' is listed with its size and date.

Automatic Updates: To keep the software up-to-date, ensure PORT 2015 for your internet connection is open. This will automatically trigger a search for new updates. Consult your system administrator if necessary. The installation is completed upon the next launch of airConfig. If you purchased airConfig once, all subsequent updates are free.

Starting airConfig

When airConfig starts, it searches for a connected USB airScan transceiver or an IP-based STC-BACnet gateway. If an STC-BACnet gateway is detected, airConfig can use the IP-BACnet gateway as an alternative to the USB airScan transceiver.

If multiple USB airScan transceivers or STC-BACnet gateways are connected, the desired device can be selected from the dropdown list on the startup screen.

To begin commissioning devices, click the 'Commissioning' button.

Diagram Description: A screenshot of the airConfig startup screen showing 'looking for USB-transceiver...' and a dropdown list showing a connected USB device (COM15-0x0189D8BD-868 MHz). Buttons for 'Commissioning' and 'EEP-Virtuoso' are visible.

The small button labeled 'EEP virtuoso' is intended only for factory use and troubleshooting.

Signal Repeaters (Repeaters)

Repeaters, especially simpler versions that cannot be configured, repeat every telegram regardless of whether it needs repeating or not. This multiplies the traffic (number of telegrams in the air), blocking the radio channel and significantly increasing the risk of collisions.

First-generation EnOcean radio module repeaters cannot repeat special message types. If incoming signals were repeated by first or second-level repeaters, airConfig will display a repetition warning at the top of the screen.

Typically, direct radio communication with the device is used during commissioning, rather than repeaters.

Diagram Description: ⚠️ Repeater! 2

Main airConfig Window

The main window is divided into 4 columns/fields. The leftmost field contains symbols of EasySens products that support remote management via airConfig. Select the product type for configuration here and right-click the selected icon.

Diagram Description: A screenshot of the main airConfig window. It shows columns for 'Product Type', 'Identifiers of the selected product', 'Parameter selection by ID', and 'Received Telegrams'. The 'Product Type' column shows 'Thermokon airConfig 4.00.80 (Commissioning)'. The 'Identifiers' column shows device types like 'Sensors (80)' and 'Devices (1)'. The 'Parameter selection by ID' column shows various configuration options like 'Query devices <F11>', 'Rename <F2>', 'Load device', 'Send configuration <F6>', 'Connect through TCP/IP', 'Radio Pass-Through', etc. The 'Received Telegrams' column lists various device IDs and their properties (e.g., 4BS, VLD, RSSI).

Select 'Query devices' (or press F11) to query devices within radio range. Depending on the number of devices or EnOcean devices responding, it may take several seconds for all devices of the selected type to return their EnOcean-ID. Each device will be listed with its EnOcean-ID in the SmartCom list.

AirConfig establishes radio communication with devices in the SmartCom list, blocking all devices except AirConfig. Devices queried by AirConfig will stop functioning during configuration to prevent unintended actions until the commissioning process is completed by sending settings to the device or manually ending commissioning by selecting 'End LRN' (End Learn Mode) from the context menu.

To configure a specific device, right-click its icon and select 'Request configuration' (or press F5). airConfig will prompt for a PIN code. Valid keys are numbers from 0 to 255.

Diagram Description: A dialog box titled 'Read device configuration' with the message 'Device configuration has not been read'. It has fields for 'Key 1:', 'Key 2:', 'Key 3:', and buttons 'Yes' and 'No'.

Enter the PIN codes and select 'Yes' to read the configuration from the device. To use default settings, select 'No' and use the default parameters shown in the 3rd column/field.

Configuration can be protected by a 3x8-bit PIN code, allowing for 16,581,375 variants. By default, each key is 000. Access to the device is impossible without the correct keys, and unlocking or reprogramming will require sending the device to Thermokon in Germany.

Language / Filters

Parameters shown in the larger third column/field depend on the selected device type and cannot be fully explained in this general guide. For a brief explanation/hint on each parameter, please refer to the product's Technical Specification.

Diagram Description: A dropdown menu labeled 'Operation:' with 'Level 1' selected, and a button 'Operation.Tooltip'.

In the upper part of the column/field, you can enable/disable USB airScan using the USB flash drive symbol.

The RSSI symbol opens a dialog box for filtering incoming signals based on their field strength.

Diagram Description: A dialog box titled 'RSSI threshold' with fields 'max. RSSI smart sensor' and 'max. RSSI regular sensor', both set to 0. Buttons 'Save' and 'Close' are present.

Filters can be set for both airConfig-supported devices and standard EnOcean devices.

Note that higher RSSI values correspond to weaker signals, meaning RSSI = -85dbm is much weaker than RSSI = -65dbm. The negative sign is not displayed.

Pairing and Remote Learning

To enable pairing/learning of transmitters and receivers, each device has a 'Sensors' tab. To check for pairing capability and to pair a device, airConfig must know its EEP. Therefore, only a sensor for which a learning telegram has been received can be assigned. Sensors whose symbol indicates only the message type (e.g., 4BS, VLD, MSC) cannot be paired and will be highlighted in red, indicating a problem.

Diagram Description: A screenshot showing the 'Network FDR Configuration Inputs Outputs' section. The 'Inputs (4)' list shows device IDs like '0x01021E48 (129000)', '0x0185E09C (130000)', '0xFF95736D (131000)', '0x0642EE (auto)'. To the right, a list of sensors with their IDs and types (e.g., 4BS, VLD) is shown.

If the EEP of a specific sensor is known, the EEP can be set manually by right-clicking the sensor's icon and selecting 'change type' in the dialog box. To assign a sensor, simply drag its ID from the sensor list on the right into the 'Sensors' tab.

Dragging a sensor symbol into the 'Inputs' section does not result in device pairing, as data is not automatically transferred to the device.

Diagram Description: ⚠️ Dragging the sensor symbol into the "Inputs" section does not result in device pairing, as data is not automatically transferred to the device.

Sending Configuration

Once all parameters are set and all sensor IDs have been dragged to the 'Sensors' tab, the new parameters must be transferred to the device. Right-click the selected device ID in the second column/field and select 'Send configuration' from the context menu, or press F6.

Diagram Description: A screenshot of the airConfig window showing the 'Devices' list and the 'Sensors' list. The 'Devices' list has a device selected, and the context menu shows options like 'Send configuration <F6>'.

Devices with constant power will receive new parameters immediately after selecting 'Send configuration'.

Energy harvesting devices are often in sleep mode and need to be woken up by pressing the LRN button again. The sensor will be highlighted in green until the configuration is successfully transferred to the device.

Diagram Description: A status message showing '0x0191F703 -70 db 26343171'.