Skip to content

KWLEC200

Jump to bottom
Peter Trimmel edited this page Feb 19, 2019 · 1 revision

KWLEC200

This library provides access to various data field from the Helios KWL EC 200 ventilation unit. The data properties are based on the specification "Helios Ventilatoren Funktions- und Schnittstellenbeschreibung" NR. 82 269 - Modbus Gateway TCP/IP mit EasyControls. Druckschrift-Nr. 82269/07.14.

The Helios KWL EC 200 is a compact central ventilation unit with heat recovery for central ventilation.

Remote control: Equipped with Helios easyControl, a control concept supporting network connection and a Web browser interface.

Modbus TCP: A Modbus TCP interface allows remote access to read and write data.

Helios Modbus Interface

The KWLEC200 library uses the Helios Modbus interface to read and write data values. However, the Modbus implementation is not as straight forward but rather uses string values to be written and read at the beginning of the Modbus address space.

Reading Values

Reading a specific data value requires the following steps:

  1. write the string with the varaible name to the holding registers starting at 1 e.g. "v00004\0" to read the variable 'v00004' (Date)

  2. wait for the result...

  3. read the string from the holding registers starting at 1 e.g. "v00004=11.12.2013\0"

  4. parse the returned value (date)

It is important to read the exact number of registers otherwise an error is reported by the KWLEC200. Also after initiating the read operation no other application should write to the KWLEC200 (single master) in order to avoid errors.

Writing Values

Writing a specific data value requires the following step:

  1. write the string with the variable name and the value to the holding registers starting at 1 e.g. "v00004=24.04.2014\0" to write the variable '00004' (Date)

Note that the procedure for reading an writing data values is rather slow and requires several minutes to complete for all data values. Since typically not all data values are needed, and some are rather fixed configuration values, a subset of supported properties is provided.

  • Date
  • Time
  • TemperatureChannel
  • TemperatureExhaust
  • TemperatureExtract
  • TemperatureOutdoor
  • TemperaturePostHeater
  • TemperaturePreHeater
  • TemperatureSupply
  • OperationMode
  • VentilationLevel
  • SupplyLevel
  • ExhaustLevel
  • VentilationPercentage
  • SupplyFanSpeed
  • ExhaustFanSpeed

KWLEC200 Class

The KWLEC200 class implements all communication routines to read the data values from the KWLEC200 unit. The only data needed to instanciate a KWLEC200 class instance are:

  • A logger
  • The IP address
  • The IP port (default: 502)
  • The Modbus slave id (default: 180)

The KWLEC200 class provides simple Read() methods to update the data values. Additional property helper functions allow to read properties or get property values.

Clone this wiki locally