UTE (Universal Teach-in for EnOcean) Telegrams
- Matthias Kassner
UTE is used as teach-in mechanism for devices using Variable Length Data (VLD) telegrams.
Variable Length Data (VLD) telegrams carry a variable length payload, therefore it is not possible to use one bit at a pre-defined location to distinguish between data and teach-in telegrams (as done in 1BS or 4BS telegrams).
Devices communicating using VLD data telegrams therefore use the generic Universal Teach-in with EEP (UTE) format when transmitting a teach-in telegram. The format of such UTE telegram is shown below.
UTE telegrams are identified by their R-ORG 0xD4 and contain the following data:
CONTROL
CHANNEL
MANUFACTURER_ID
EEP (R-ORG, FUNCTION, VARIANT)
CONTROL
The CONTROL field identifies the type of the UTE request using the structure shown below.
The different sub-fields within the CONTROL field are described in the table below. The most common setting for the CONTROL field is 0x40 which identifies a uni-directional teach-in request with no expected response.
Field | Description | Supported Values |
DIRECTION | Specifies if uni-directional or bi-directional teach-in is used | 0b0: Uni-directional teach-in 0b1: Bi-directional teach-in |
RESPONSE | Specifies if a response is expected to this UTE telegram | 0b0: Response expected 0b1: No response expected |
REQUEST_TYPE | Specifies if this UTE telegram is a teach-in request (to add a device) or a teach-out request (to delete a device) | 0b00: Teach-in request (add device) 0b01: Teach-out request (delete device) 0b10: Unspecified (teach-in or teach-out) 0b11: Reserved (do not use) |
COMMAND_ID | Specifies if this UTE telegram is a request or a response | 0b0000: Request 0b0001: Response  Others: Reserved (do not use) |
CHANNEL
The CHANNEL field of the UTE telegram allows specifying if a device should be added to a specific functional domain of the target device (for instance to a specific group of devices if more than one group is supported).
In most cases, this field is set to 0xFF indicating that the device should be added to all functional domains of the target device.
MANUFACTURER_ID
The MANUFACTURER_ID field contains the Manufacturer ID assigned by EnOcean Alliance in little endian byte order. The Manufacturer ID of EnOcean GmbH is 0x000B.
EEP (R-ORG, FUNCTION, VARIANT)
The R-ORG, FUNCTION and VARIANT fields of the UTE telegram identify the EEP used by the device.