FIRVENA EO-MOD-IP EnOcean to Modbus/IP Gateway User Manual
- June 9, 2024
- FIRVENA
Table of Contents
EO-MOD-IP EnOcean to Modbus/IP Gateway
EnOcean to Modbus/IP Gateway
The EnOcean to Modbus/IP Gateway is a device that enables the
communication between EnOcean devices and Modbus servers. It
converts the wireless EnOcean protocol into the Modbus protocol via
an Ethernet connection.
Hardware Overview
The device comes with an Ethernet port and an EnOcean radio
module. It can be powered by Power over Ethernet (PoE) or an
external power supply.
Technical Data
The following are the technical data for the EnOcean to
Modbus/IP Gateway:
-
Power supply: PoE (IEEE 802.3af) or external 12VDC
-
IP address configuration: DHCP or static IP address
-
Supported EnOcean devices: see Annex A for mapping
examples -
Supported Modbus function codes: 01, 02, 03, 04, 05, 06, 15,
and 16
Safety Information and Warnings
The following safety information and warnings should be observed
when using the device:
-
Do not connect the device to any voltage source exceeding the
permitted voltage range of 9-30VDC. -
Do not touch any electrical components while the device is
powered. -
Do not use the device in areas with explosive atmospheres.
Power Supply
The device can be powered through PoE or an external power
supply with a voltage range of 9-30VDC. The power supply must be
connected to the DC power jack on the device.
Configuration
Accessing Web Interface
To access the device’s web interface, follow these steps:
- Connect the device to a network using an Ethernet cable.
- Open a web browser and enter the device’s IP address.
- Enter the default login credentials (admin/admin) to access the
web interface.
Web UI
The web interface allows users to configure the device’s EnOcean
and Modbus settings. It also provides status information and allows
for firmware updates.
Connection to Modbus Server
The EnOcean to Modbus/IP Gateway can be connected to a Modbus
server using the device’s web interface. Users can select the
Modbus function codes and registers to use for communication. See
sections 7.3 and 7.4 for supported function codes and
registers.
Firmware Update
Over Network
To update the device’s firmware over the network, follow these
steps:
-
Download the latest firmware from the manufacturer’s
website. -
Access the device’s web interface.
-
Select “Firmware Update” from the menu.
-
Click “Choose File” and select the downloaded firmware
file. -
Click “Upload” to start the firmware update process.
Over USB
To update the device’s firmware over USB, follow these
steps:
-
Download the latest firmware from the manufacturer’s
website. -
Extract the firmware file onto a USB flash drive.
-
Connect the USB flash drive to the device’s USB port.
-
Access the device’s web interface.
-
Select “Firmware Update” from the menu.
-
Click “Start USB Update” to start the firmware update
process.
Annex A: Mapping examples of EnOcean devices
The EnOcean to Modbus/IP Gateway supports various EnOcean
devices. Annex A provides mapping examples for basic devices, RPS
buttons and switches, HVAC components, and electronic switches and
dimmers with energy measurement and local control.
EnOcean to Modbus/IP Gateway
EO-MOD-IP User Manual V1.4
English
Contents
Contents
Contents ……………………………………………………………………………………………………………………………….. 2 Terms and Abbreviations ………………………………………………………………………………………………………… 4 List of Figures and Tables ………………………………………………………………………………………………………… 5 1 Introduction……………………………………………………………………………………………………………………. 6
2 Hardware Overview…………………………………………………………………………………………………………. 7
3 Technical Data ………………………………………………………………………………………………………………… 8
4 Safety Information and Warnings ……………………………………………………………………………………. 10
5 Power Supply………………………………………………………………………………………………………………… 11 6
Configuration………………………………………………………………………………………………………………… 12
6.1 Accessing Web Interface …………………………………………………………………………………………. 12 6.2 Web
UI………………………………………………………………………………………………………………….. 14
6.2.1 Main Page Overview………………………………………………………………………………………… 14 6.2.2 Assigning
EnOcean elements unidirectional …………………………………………………….. 15 6.2.3 Assigning
EnOcean elements bidirectional ………………………………………………………. 16 6.2.4 Assigning
Smart ACK devices …………………………………………………………………………….. 17
6.2.5 Definition of Virtual Device ………………………………………………………………………………. 17 6.2.6 Removing EnOcean elements……………………………………………………………………………. 18 6.2.7 Backup and Restore…………………………………………………………………………………………. 19 7 Modbus Interface ………………………………………………………………………………………………………….. 20 7.1 Mapping of EnOcean Devices…………………………………………………………………………………… 20
7.2 Connection to Modbus Server………………………………………………………………………………….. 23
7.3 Supported Function Codes ………………………………………………………………………………………. 23
7.4 Modbus Registers …………………………………………………………………………………………………… 24
7.4.1 7.4.2 7.4.3 7.4.4 7.4.5
RX Values ……………………………………………………………………………………………………….. 24 TX Values ……………………………………………………………………………………………………….. 25 RX Raw Data …………………………………………………………………………………………………… 26 Channel Config………………………………………………………………………………………………… 27 Channel Labels………………………………………………………………………………………………… 28
7.4.6 Value Descriptors ……………………………………………………………………………………………. 29
8 Firmware Update…………………………………………………………………………………………………………… 30
8.1 Over Network ………………………………………………………………………………………………………… 30
8.2 Over USB……………………………………………………………………………………………………………….. 31
EnOcean to Modbus/IP Gateway User Manual
V1.4 / 2023-01-25
2/42
Contents References…………………………………………………………………………………………………………………………… 32 Revision
History ……………………………………………………………………………………………………………………. 33 ANNEX A Mapping
examples of EnOcean devices …………………………………………………………………. 34
A.1 Basic Examples ………………………………………………………………………………………………………. 34 A.2 RPS Buttons
and Switches ……………………………………………………………………………………….. 35 A.3 A5-20-01 HVAC
Components, Battery Powered Actuator ……………………………………………. 35 A.4 D2-01-XX
Electronic switches and dimmers with Energy Measurement and Local Control. 36
A.4.1 Example with NodOn Micro Smart Plug (D2-01-0E) Measurements …………………….
36 A.4.2 Example with NodOn Relay Switch (D2-01-12) Controlling the output
………………… 38 A.5 D2-11-XX Bidirectional Room Operating Panel (Smart
ACK)…………………………………………. 39 A.5.1 Example with Thermokon SR06 LCD (D2-11-07)
………………………………………………….. 39 A.6 D2-15-00 People Activity Sensor
………………………………………………………………………………. 41 ANNEX B Enumeration of Units
………………………………………………………………………………………….. 42
EnOcean to Modbus/IP Gateway User Manual
V1.4 / 2023-01-25
3/42
Terms and Abbreviations
Terms and Abbreviations
Term/Abbr.
Explanation
Channel number (CH) …………….Identifier of EnOcean device within the gateway DHCP……………………………………Dynamic Host Configuration Protocol EEP ………………………………………EnOcean Equipment Pofiles EURID…………………………………..EnOcean Unique Radio Identifier Label ……………………………………User-friendly name of EnOcean device IP…………………………………………Internet Protocol PoE………………………………………Power over Ethernet RX………………………………………..Receive, reception Teach-in ……………………………….Pairing of EnOcean devices Telegram………………………………EnOcean message TX ………………………………………..Transmit, transmission UPnP ……………………………………Universal Plug and Play Value index …………………………..Identifier of a data unit within the channel
EnOcean to Modbus/IP Gateway User Manual
V1.4 / 2023-01-25
4/42
List of Figures and Tables
List of Figures and Tables
Figures
Fig. 1.1 Functional overview…………………………………………………………………………………………………….. 6 Fig.
2.1 Gateway overview front side ……………………………………………………………………………………… 7 Fig. 2.2
Gateway overview meaning of manual switches ………………………………………………………….. 7 Fig.
5.1 Power supply via ETHERNET connector………………………………………………………………………… 11 Fig.
5.2 Power supply via POWER connector ……………………………………………………………………………. 11 Fig.
6.1 Main page overview…………………………………………………………………………………………………… 14 Fig. 6.2
Adding elements teach-in procedure ………………………………………………………………………… 15 Fig. 6.3
Adding elements manually ………………………………………………………………………………………. 16 Fig. 6.4
Adding elements bidirectional teach-in procedure ……………………………………………………… 17
Fig. 6.5 Adding elements virtual device…………………………………………………………………………………. 18
Fig. 6.6 Virtual device send teach-in telegram ………………………………………………………………………..
18 Fig. 7.1 Conversion of data …………………………………………………………………………………………………….. 20
Fig. 7.2 Values………………………………………………………………………………………………………………………. 21 Fig. 7.3
Mapping of EnOcean devices………………………………………………………………………………………. 22
Tables
Tab. 3.1 Technical data……………………………………………………………………………………………………………. 8 Tab. 7.1
Helper values …………………………………………………………………………………………………………… 21 Tab. 7.2 Supported
Modbus functions…………………………………………………………………………………….. 23 Tab. 7.3 Register
map……………………………………………………………………………………………………………. 24 Tab. 7.4 RX Values
………………………………………………………………………………………………………………… 25 Tab. 7.5 RX Values Error
register ………………………………………………………………………………………….. 25 Tab. 7.6 TX Values
………………………………………………………………………………………………………………… 26 Tab. 7.7 TX Values Send
option register………………………………………………………………………………… 26 Tab. 7.8 Raw data RPS, 1BS
…………………………………………………………………………………………………. 26 Tab. 7.9 Raw data 4BS
………………………………………………………………………………………………………… 27 Tab. 7.10 Raw data VLD,
MSC………………………………………………………………………………………………. 27 Tab. 7.11 Channel config
……………………………………………………………………………………………………….. 27 Tab. 7.12 Channel
labels………………………………………………………………………………………………………… 28 Tab. 7.13 Value descriptors
……………………………………………………………………………………………………. 29
EnOcean to Modbus/IP Gateway User Manual
V1.4 / 2023-01-25
5/42
Introduction
1 Introduction
The EO-MOD-IP device is a gateway between EnOcean and Modbus/IP communication
protocols (Fig. 1.1). The EnOcean is a set of technologies and communication
protocol that enables the use of wireless and batteryless sensors, switches
and actuators. The Modbus is a communication protocol that is simple to
implement and is widely used in building automation systems. The EO-MOD-IP
gateway can receive data from up to 40 EnOcean devices, store it and provide
it through the Modbus interface to other devices connected to the network.
The first part of this manual describes the hardware of the gateway. Chapter 6
describes the Modbus interface and explains how EnOcean devices are mapped to
Modbus registers. Chapter 6 contains brief instructions for configuring the
gateway, especially for connecting EnOcean devices. For firmware update
procedure refer to Chapter 8.
Fig. 1.1 Functional overview
EnOcean to Modbus/IP Gateway User Manual
V1.4 / 2023-01-25
6/42
Hardware Overview
2 Hardware Overview
There is a power connector, RJ45 Ethernet connector, type B USB connector,
antenna connector and LED indicators on the front panel (Fig. 2.1). The LEDs
indicates the connection of power supply (POWER), traffic in the Modbus
network (MOD RX, MOD TX), traffic in the EnOcean wireless network (ENOC),
communication through the USB interface (USB) and error states (ERROR). The
USB connector is used for configuration and firmware update, it is used by the
EO-BAC Tool configuration application. The green POWER connector is removable,
which simplifies device handling if wires are connected.
Fig. 2.1 Gateway overview front side
There is a switch to the right of the POWER connector that is accessible after
pulling out the POWER connector (Fig. 2.2). It sets the USB interface mode:
the “HID” position (default) allows the EO-BAC Tool application to be
connected the “MSC” position activates the firmware update mode (see Ch. 8.2)
Fig. 2.2 Gateway overview meaning of manual switches
EnOcean to Modbus/IP Gateway User Manual
V1.4 / 2023-01-25
7/42
3 Technical Data
Technical Data
Tab. 3.1 Technical data
Category
Parameter
Product
Electrical data
Ethernet (Modbus/IP)
EnOcean
USB Operating conditions Dimensions in mm
Weight Box material
EMC
Product name Product title Product ID Vendor name Rated supply voltage Supply
voltage range Rated input current Rated input power Speed Connector PoE PoE
power supply Frequency Maximum number of handled devices Repeater Device class
Connector IP Code Operating temperature Relative humidity Dimensions without
antenna Weight without antenna
In accordance with the directive
EMC
Approvals tests
Value
EO-MOD-IP EnOcean to Modbus/IP Gateway 11.2 FIRVENA s.r.o. 24 V DC / 24 V AC
1032 V DC / 24 V AC ( 10 %) 50 mA 1.2 W 10, 100 Mbit/s RJ45
According to standard 802.3af, ACTIVE only 868 MHz
40 (max. 20 with SmartACK)
Custom HID or Mass Storage Type B IP20 20 to 70 °C max. 80 % Width=126,
Height=71, Depth=25 115 g ABS, white 2014/53/EU, 2011/65/EU RoHS CSN EN 55032,
CSN EN 55035, CSN EN 6100-4-2, CSN EN 6100-4-3, CSN EN 6100-4-4, CSN EN
6100-4-5, CSN EN 6100-4-6, CSN EN 6100-4-11, CSN EN IEC 6100-6-2
EnOcean to Modbus/IP Gateway User Manual
V1.4 / 2023-01-25
8/42
Dimensions in mm:
Technical Data
EnOcean to Modbus/IP Gateway User Manual
V1.4 / 2023-01-25
9/42
Safety Information and Warnings
4 Safety Information and Warnings
Please follow the general safety requirements. This equipment may only be
installed by a qualified person (accredited electrician) and after reading
these instructions. Improper installation may cause damage to health, property
or the equipment itself.
The product meets the general safety requirements. Cover IP 20 allows
installation only in normal space.
The gateway must be powered from a safe voltage source that meets the
requirements for input voltage range and must be installed in accordance with
national and safety standards.
The product may only be used in accordance with this manual.
To avoid a risk of an electrical shock or fire, the maximum of gateway’s
operating parameters must not be exceeded.
Use only unmodified products.
It can be used types of cables with sufficient electrical strength for
connection.
Storage
Store products at temperature 0-40 °C and relative humidity up to 80 %, and in
spaces where condensation on products is eliminated. Products must not be
exposed shocks, harmful vapors or gases.
Repairs
Products are repaired by the manufacturer. Products to be repaired are shipped
in a package that ensures shock absorption and protects the products against
damage during shipment.
Guarantee
The product is warranted 24 months from the date of delivery that is mentioned
on the delivery note. The manufacturer guarantees technical and operational
products parameters in the range of valid documentation. The warranty period
runs from personal goods acceptance by the buyer or from the transport
company. Claimed products and written claims for defects are claimed by the
manufacturer during warranty period. The complainant shall provide products
identification, number of delivery note and defects description. The
manufacturer is not responsible for defects caused by improper storage,
improper external connection, damages caused by external influences especially
due to unacceptable size, incorrect adjustment, improper installation,
incorrect operation or normal wear and tear.
Product disposal
The product does not belong to municipal waste. The product must be disposed
to the separate waste collection with the possibility of recycling, according
to local regulations and legislation. The product contains electronic
components.
ROHS Directive
The device is manufactured in accordance with the directive 2015/863/EU (RoHS 3) of the European Parliament and of the Council on the restriction of the use of certain hazardous substances in electrical and electronic equipment.
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
10/42
5 Power Supply
There are two possible power supply connections. Power supply via PoE (Power
over Ethernet):
Power Supply
Fig. 5.1 Power supply via ETHERNET connector
The device supports PoE according to the 802.3af standard. Network elements
must support this type of power interface. Passive PoE is not possible through
the ETHERNET input. For passive PoE power supply, we recommend to use a
splitter cable with connection to the POWER input. Power supply from an
external source:
Fig. 5.2 Power supply via POWER connector
The gateway must be powered from a safe voltage source that meets the
requirements for input voltage range. The electrical installation must be in
accordance with national requirements and safety standards.
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
11/42
Configuration
6 Configuration
The gateway has a built-in web application (Web UI) that serves to configure
it using a web browser. Alternatively, you can use the EO-BAC Tool
application, in that case, a USB connection is required.
6.1 Accessing Web Interface
This chapter describes different ways to access the Web UI. Connect the gateway to your network (Ethernet connector).
The DHCP client is enabled by default, so the IP address and other network parameters should be obtained from the DHCP server automatically.
If DHCP fails, e.g. there is no DHCP server, the last saved network configuration is used. The default network configuration is:
Parameter IP address Subnet mask Default gateway DNS server
Value 192.168.1.90 255.255.255.0 192.168.1.1 8.8.8.8
The methods of discovering the gateway are as follows:
Discovery using UPnP
This method is recommended when using the Windows operating system and UPnP messages are allowed in the network to which the gateway is connected.
Open the Network item in the File Explorer:
The gateway is under the group “Other Devices”. The description and IP address
of the gateway are shown. Double click on the device item to open the Web UI.
[Right click > Properties] will display additional information.
If the gateway is not shown, try to refresh the list: [Click on the list >
press F5 key] or [Right click > Refresh].
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
12/42
Configuration
USB MSC In the USB MSC mode (see Ch. 2), the gateway presents itself as an
external USB drive. Connect the gateway to your computer using USB. Find a
file named NETINFO.TXT in the root directory and open it. The file contains
the current IP address. To access the Web UI, enter the IP address to the
address bar of your web browser.
Using EO-BAC Tool
In the USB HID mode (see Ch. 2), the gateway presents itself as a Custom HID
USB device. Connect the gateway to your computer using USB and use the EO-BAC
Tool.
DHCP server
If you have access to the local DHCP server (usually through the configuration
interface of your router), the IP address should be in DHCP client list, look
for the host name “EO-MOD-IP”. To access the Web UI, enter the IP address to
the address bar of your web browser.
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
13/42
Configuration
6.2 Web UI
This chapter is a brief guide to the use of the Web UI application.
The Web UI is used to configure the gateway. The main purpose of the
application is to manage EnOcean devices connected to the gateway. The
application is also a useful verification tool whereby you can evaluate
whether your system works well. It allows to see the states, measured
quantities, communication intervals or signal strength of the connected
EnOcean devices.
6.2.1 Main Page Overview
1. Dashboard overview of configured channels 2. Toggles dashboard view:
Detailed more information, only configured channels are displayed Condensed
less information, both configured and empty channels are displayed 3. Menu
items: Add new device Settings Telegram log 4. Login button: Locked
configuration locked and cannot be changed, only dashboard is accessible
Unlocked configuration of the gateway can be changed 5. Gateway
identification
The main page is accessible without a password. The default password is “123”,
you can change it in [Settings > Change Password].
Fig. 6.1 Main page overview
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
14/42
Configuration
6.2.2 Assigning EnOcean elements unidirectional
This teach-in procedure is only applicable for unidirectional communication
when the gateway only receives data.
Let’s have a humidity sensor (A5-04-01) we want to assign to the channel 1.
The procedure is as follows (see Fig. 6.2):
1. Click the “Add new” icon, a dialog box appears. 2. Push the pairing button
to transmit a teach-in telegram. 3. The received telegram is displayed in the
dialog box. 4. Select the channel number 1. 5. Click “Save” to confirm changes
6. Now the sensor is assigned to channel 1 and its data is available through
the Modbus interface.
Fig. 6.2 Adding elements teach-in procedure
Optionally, the Label can be set for the device. The Label text is used in the
Channel labels registers (see Ch. 7.4.5). If the Label field is left empty,
the default text will be used.
The knowledge of EEP allows the gateway to interpret the received data
correctly. Some types of EnOcean devices do not provide the EEP information in
their teach-in telegram or even not have a special telegram for teach-in (e.g.
buttons and switches). In that case, the EEP must be set manually, it is
usually given by a label on the device or a datasheet
Devices can also by assigned manually by entering the ID and EEP see Fig.
6.3.
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
15/42
Configuration
Fig. 6.3 Adding elements manually
Click on the channel box to view more settings and status information:
6.2.3 Assigning EnOcean elements bidirectional
This teach-in procedure is applicable for EnOcean devices with bidirectional
communication profiles when the gateway is supposed to receive data from the
device and also transmit data to the assigned device.
Let’s have a valve actuator (A5-20-01) we want to assign to the channel 1. The
procedure is as follows (see Fig. 6.4):
1. Click the “Add new” icon, a dialog box appears. 2. Check “LRN enable” 3.
Select the channel number 1.
Channel 1 is now in the teach-in mode.
4. Push the pairing button to transmit a teach-in telegram from the actuator.
5. Gateway receives the telegram and sends a teach-in response. 6. The device
is automatically saved to the selected channel and its data is available
through the
Modbus interface.
To change the Label, enter the new text and click “Save”.
Notes: The device being assigned usually signals successful teach-in, e.g. by
flashing LED. If it signals an error, the teach-in must be repeated.
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
16/42
Configuration
Fig. 6.4 Adding elements bidirectional teach-in procedure
6.2.4 Assigning Smart ACK devices
To assign a Smart ACK device to the gateway, the procedure is the same as for
bidirectional profiles (6.2.3). Repeaters are not supported, there must be a
direct connection between the gateway and the Smart ACK device.
6.2.5 Definition of Virtual Device
The gateway can be used to simulate a real EnOcean device. This function is
necessary when controlling actuators that do not implement any bidirectional
profile, typically some types of relay switches.
For example, we want to control a relay switch that supports reception of a
Door/Window Contact D500-01. The procedure is as follows.
First, define a virtual device of type D5-00-01, for example at channel 1 (see
Fig. 6.5):
1. Click the “Add new” icon, a dialog box appears. 2. Check “Simulate device”
3. Select a channel number (channel 1) 4. Select the type of device (D5-00-01)
5. Click “Save” to confirm changes 6. The device is saved to the selected
channel and its data is available through the Modbus
interface.
Second, pair the virtual device with the relay switch:
1. Click on the channel 1 box to see channel details (Fig. 6.6) 2. Put the
relay switch to the pairing mode (follow the procedure given by the
manufacturer of
the switch) 3. In channel details click on the “Send LRN” button 4. The
gateway will transmit a teach-in telegram of the virtual device 5. The switch
will receive the teach-in telegram and save the virtual device
Third, test the connection:
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
17/42
1. Navigate to [Edit channel > Values] 2. Set the data to be transmitted
(0:closed or 1:open) 3. Use “Send Now” to transmit a data telegram
Notes: Each virtual device must have a unique ID, this is given by the MyID
setting. To enable receiving the actual state of the switch, assign it to a
different channel.
Configuration
Fig. 6.5 Adding elements virtual device
Fig. 6.6 Virtual device send teach-in telegram
6.2.6 Removing EnOcean elements 1. Click on a channel box. 2. Click on the
“Delete” button.
To remove all elements, use [Settings > Factory Reset].
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
18/42
Configuration
6.2.7 Backup and Restore
The configuration of the gateway can be exported to a file for later recovery
or reuse. The backup file is compatible with the file used by EO-BAC Tool
application.
To back up the configuration:
1. Navigate to [Settings > Backup and Restore]. 2. Click on Download. 3. A
file named config.json is downloaded.
To restore the configuration:
1. Navigate to [Settings > Backup and Restore]. 2. Select a file or drag it
to the dashed rectangle. 3. Click on Upload.
Notes: Only channels are restored, the “Gateway Settings” are preserved.
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
19/42
7 Modbus Interface
Modbus Interface
7.1 Mapping of EnOcean Devices
EnOcean devices are mapped as a set of Modbus registers. The gateway can
handle up to 40 EnOcean devices. To assign an EnOcean device, the teach-in
procedure has to be carried out (see Ch. 6.2). The assigned EnOcean devices
are identified by Channel (CH1…40) within the gateway, the Channel is selected
by user during teach-in procedure.
Data fields received in a telegram are divided into individual Modbus
registers so that they can be accessed using Modbus standard functions from
the network see Fig. 7.1. The gateway contains a database of supported
EnOcean products, the meaning of individual data registers depends on the type
of EnOcean device (EEP) that is assigned to the channel during teach-in
procedure.
Fig. 7.1 Conversion of data
Three types of data fields are distinguished:
Numeric value: usually a measured physical quantity such as temperature,
humidity, etc. Enumeration: defined as a list of items that express a state or
configuration of the device Boolean: two-state enumeration whose items can be
interpreted as true/false, such as on/off,
enabled/disabled, open/closed, etc.
In addition, two directions are distinguished:
RX: data received by the gateway (incoming telegrams) TX: data transmitted by
the gateway (outgoing telegrams)
The data fields are stored internally as Values. The Values are identified by
Value index, 15 Values is reserved per channel (indexes 0 to 14) see Fig.
7.2 and Fig. 7.3. The Values from Telegram data range represent a model of
EnOcean telegram. For simple devices (such as sensors with unidirectional
communication) the model of telegram can also be assumed to be a model of
EnOcean device. Some more complex EEP definitions consist of several types of
telegrams
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
20/42
Modbus Interface
that represent different commands, so the device cannot be described by a
single telegram. Special mapping is created for these devices.
For direction “RX”, all used Values are mapped to RX Values registers
(starting at address 0). For direction “TX” all used Values are mapped to TX
Values registers (starting at address 1000). If the channel is not occupied
the associated Value registers are zeroed.
The mapped data fields from EnOcean telegram are indexed in the same order as
they appear in the EEP definition see [3].
Besides the data values, there are also helper values for each channel that
provide status information see Tab. 7.1.
Index RX
15
Name
Telegram counter
16 Telegram age
17 Signal
18 reserved 19 Error TX
Telegram 15
counter
16 Telegram age
17 Send option 18 reserved
Meaning
Tab. 7.1 Helper values
Number of received telegrams
Time elapsed since the last telegram Signal strength (RSSI value measured by
the EnOcean transceiver)
Enumeration of channel state and error codes
Number of sent telegrams Time elapsed since the last telegram Data transmission control
Value Range
0…65535 (overflows to zero) 0…65000 s (65535: no telegram, 65001: range
exceeded) 0…255 dBm
See Tab. 7.5
0…65535 (overflows to zero) 0…65000 s (65535: no telegram, 65001: range
exceeded) See Tab. 7.7
Examples of mapping for individual EnOcean devices can be found in ANNEX A.
Fig. 7.2 Values
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
21/42
Modbus Interface
Register
Value 1 0 Temperature
Value 2 1
Value 3 2
Value 4 3
Value 5 4
CH1
…
…
Value 16 15
… T. Counter
A5-02-05 Temperature Sensors, Temperature Sensor Range 0°C to +40°C
Value 17 16
T. Age
Value 18 17
Signal
Value 19 18
Value 20 19
Error
Value 1 0 Humidity
Value 2 1 Concentration
Value 3 2 Temperature
Value 4 3
Value 5 4
CH2
…
…
Value 16 15
Value 17 16
H-Sensor T-Sensor
… T. Counter
T. Age
A5-09-04 Gas Sensor, CO2 Sensor
Value 18 17
Signal
Value 19 18
Value 20 19
Error
…
Value 1 0
Value 2 1
Value 3 2
Value 4 3
Value 5 4
CH40
…
…
Value 16 15
Value 17 16
Value 18 17
Value 19 18
Value 20 19
Power Fail Divisor
Channel 1 Channel 2 Channel 3
… T. Counter
T. Age Signal
D2-32-02 A.C. Current Clamp, 3 channels
Error Fig. 7.3 Mapping of EnOcean devices
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
22/42
Modbus Interface
7.2 Connection to Modbus Server
Gateway’s Modbus server is on TCP port 502 or UDP port 502. There is a limit
of two simultaneous TCP connections.
7.3 Supported Function Codes
Code 3 (0x03) 6 (0x06) 16 (0x10)
Tab. 7.2 Supported Modbus functions
Name Read Holding Registers Write Single Register Write Multiple Registers
Description Reads a continuous block of registers starting at a given address. Zero values are returned for unused registers within a defined area. Writes any writable register. Writes a block of writable registers, behaviour differs depending on the area, see below.
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
23/42
Modbus Interface
7.4 Modbus Registers
The registers are divided into several areas according to their use. All
registers can be read by Modbus function 3 or 4. Readonly registers are marked
as “R”, writable registers are marked as “R/W”. “P” marks persistent (non-
volatile) registers whose values are retained when the gateway is turned off.
Tab. 7.3 Register map
Area name RX Values Reserved TX Values Reserved RX Raw data Reserved Channel config Reserved Channel labels Reserved Value descriptors Reserved
Address range 0…799
1000…1799
2000…2799
4000…4399
10000…13999
20000… 32000
Access R R/W R R, P R, P R, P
Description Last received telegram values extracted from raw data
Telegram to send values are built into raw data
Last received telegram raw data as received in telegram
Channel configuration (i.e. assignment of EnOcean device)
User defined descriptions for channels
Description of values (e.g. type, unit, multiplier, range)
Channel
CH1 CH2 … CH40
CH1 CH2 … CH40
CH1 CH2 … CH40
CH1 CH2 … CH40
CH1 CH2 … CH40
CH1 CH2 … CH40
Base address 0 20
780
1000 1020
1780
2000 2020
2780
4000 4010
4390
10000 10100
13900
20000 20300
31700
7.4.1 RX Values
20 registers are reserved for each channel. When the gateway receives a data
telegram from a device that is assigned to a channel, it uses the database of
supported devices to convert the data contents into RX Values. The received
data fields are stored in registers from V1 up. The number of data fields
depends on the type of EnOcean device, which is specified during the
commissioning phase. For devices that use the EEP protocol, the device type is
given by RORG, FUNC and TYPE (see [2][1]).
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
24/42
Address = BaseAddress + Offset BaseAddress = 0 + 20 (ChannelNumber – 1)
Modbus Interface
Tab. 7.4 RX Values
Group Values
Status
Offset 0 1 2 3 … 14 15 16
17
18 19
Access R R R R R R R R
R
R R
Name V1 V2 V3 V4
V15 Telegram counter Telegram age
Signal
Reserved Error
Description Value 1 Value 2 Value 3 Value 4
Value 15 Number of received telegrams Time elapsed since the last telegram
Signal strength (RSSI value measured by the EnOcean transceiver)
Enumeration of channel state and error codes
Value range
Depends on device type
0…65535 (overflows to zero) 0…65000 s (65535: no telegram, 65001: range
exceeded) 0…255 dBm (decimal value without minus)
See Tab. 7.5
Tab. 7.5 RX Values Error register
Error register Value 0 OK 1 ASSIGNED 3 NOT SUPPORTED 7 TIMEOUT 255 FREE
Meaning Telegram OK, data has been stored in Values Device assigned, waiting for the first data telegram Device assigned, unsupported device type, data cannot be converted to Values 120 minutes without a telegram received The channel is not configured, no device assigned
7.4.2 TX Values
20 registers are reserved for each channel. When the send condition is true,
the gateway uses the database of supported devices to convert the TX Values
into the raw data contents and sends a data telegram. The data fields to send
are stored in registers from V1 up. The number of data fields depends on the
type of EnOcean device, which is specified during the commissioning phase. For
devices that use the EEP protocol, the device type is given by RORG, FUNC and
TYPE (see [2]).
The registers can be set individually by the function 6 or all at once by
function 16. It is possible to set more channels using a single request, the
starting address must be the base address of the first channel being written,
unused and readonly registers can be set to any value in the request.
Address = BaseAddress + Offset BaseAddress = 0 + 20 (ChannelNumber – 1)
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
25/42
Modbus Interface
Tab. 7.6 TX Values
Group Values
Status
Offset 0 1 2 3 … 14 15
16
17 18 19
Access R/W R/W R/W R/W R/W R/W R
R
R/W R R
Name V1 V2 V3 V4
V15 Telegram counter
Telegram age
Send option Reserved Reserved
Description Value 1 Value 2 Value 3 Value 4
Value 15 Number of sent telegrams Time elapsed since the last telegram Data
transmission control
Value range
Depends on device type
0…65535 (overflows to zero) 0…65000 s (65535: no telegram, 65001: range
exceeded) See Tab. 7.7
Tab. 7.7 TX Values Send option register
Send option register
Value
Meaning
0 NotChange
Writing this value has no effect, the send option will not change
1 None (default) Transmitting disabled
2 SendNow
Transmit once immediately, the send option will not change
3 OnReceived Automatic response when telegram received from the assigned device (default for A5-20-01, etc.)
4…10
Reserved
11 OnWriteV1 Transmit when register V1 written1)
…
25 OnWriteV15 Transmit when register V15 written
26 OnWriteAny Transmit when any register V1…V15 written
- When using function 16, the telegram is sent after all registers updated.
7.4.3 RX Raw Data
20 registers are reserved for each channel. These registers contain the
payload bytes of the last received telegram. The length of the data varies
depending on the telegram type, which is identified by the RORG byte (see
[2][1]>Ch.3). In most cases, it is not necessary to use these registers and
Value registers should be used instead.
Address = BaseAddress + Offset BaseAddress = 2000 + 20 (ChannelNumber – 1)
Tab. 7.8 Raw data RPS, 1BS
Offset 0 1 2 3…19
Access R R R
Name RORG DB_0 Status Reserved
Description RORG byte Data byte 0 ERP1 Status byte
Value range 0xF6: RPS, 0xD5: 1BS 0…0xFF Bits 3…0: Repeater count
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
26/42
Modbus Interface
Tab. 7.9 Raw data 4BS
Offset 0 1 2 3 4 5 6…19
Access R R R R R R
Name RORG DB_3 DB_2 DB_1 DB_0 Status Reserved
Description RORG byte Data byte 3 Data byte 2 Data byte 1 Data byte 0 ERP1 Status byte
Value range 0xA5: 4BS 0…0xFF 0…0xFF 0…0xFF 0…0xFF Bits 3…0: Repeater count
Tab. 7.10 Raw data VLD, MSC
Offset 0 1
2…8
Type UINT8 UINT8
UINT8[14]
Access R R
R
Name RORG Data length (N)
Data
Description RORG byte Number of bytes in the Data array
Data bytes DB_(N1)…DB_0
Value range 0xD2: VLD, 0xD1: MSC 1…14 HI: DB(N1); LO: DB(N2)1) … HI: DB_3; LO: DB_2 HI: DB_1; LO: DB_0
9
UINT8
R
10…19
Status Reserved
ERP1 Status byte
Bits 3…0: Repeater count
- HI is the high byte of the register (bits 15…8), LO is the low byte of the register (bits 7…0).
7.4.4 Channel Config
10 registers are reserved for each channel. Sender ID identifies the EnOcean
device that the channel is listening to. The EEP identifies the type of the
device and is needed for conversion of raw data to Values.
The registers can be set individually by the function 6 or all at once by
function 16. It is possible to set more channels using a single request, the
starting address must be the base address of the first channel being written,
unused and readonly registers can be set to any value in the request.
Address = BaseAddress + Offset BaseAddress = 4000 + 10 (ChannelNumber – 1)
Tab. 7.11 Channel config
Group ID EEP
Offset Bits 15…8
0 Bits 7…0 Bits 15…8
1 Bits 7…0
2 3 4 5…9
Access R, P R, P R, P R, P R, P R, P R, P
Name ID3 ID2 ID1 ID0 RORG FUNC TYPE Reserved
Description Sender ID_3 (MSB) Sender ID_2 Sender ID_1 Sender ID_0 (LSB)
Value range 0…0xFF 0…0xFF 0…0xFF 0…0xFF 0…0xFF 0…0xFF 0…0xFF
Default 0xFF 0xFF 0xFF 0xFF 0x00 0x00 0x00
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
27/42
Modbus Interface
7.4.5 Channel Labels
100 registers are reserved for each channel. The channel label is designed to
store text information, it can be a user friendly name that helps to identify
the data or EnOcean device. The maximum size of Label is 126 bytes. The UTF-8
encoding is used because it is compatible with ASCII encoding, ASCII
characters (Unicode 0x0000 to 0x007F) are encoded into one byte in UTF-8 (0x00
to 0x7F).
Address = BaseAddress + Offset BaseAddress = 10000 + 100 (ChannelNumber – 1)
Offset Type
0
UINT8
1
UINT8
Tab. 7.12 Channel labels
Access R, P
R, P
Name Encoding Label length (N)
Description Character encoding of Label Number of bytes in the Label array
2…64 UINT8[126] R, P Label
Array of bytes b0…b(N1)
Value range 0: UTF-8
Default 0: UTF-8
0…126
HI: b0; LO: b1
HI: b2; LO: b3
…
HI: b(N2); LO: b(N1)
65…99
Reserved
- Default label is “{EEP} {Title} (SenderID)”, e.g. “A5-02-05 Temperature Sensors, Temperature Sensor Range 0°C to +40°C (05-0C-54-74)”
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
28/42
Modbus Interface
7.4.6 Value Descriptors
Address = BaseAddress + Offset BaseAddress = 20000 + 300 (ChannelNumber – 1)
Tab. 7.13 Value descriptors
Group
Value 1 RX
Value 2 … Value 15 Value 1 TX Value 2 … Value 15
Offset 0
1
2 3
4
5 6…9 10…19
140…149 150 … 160…169
290…299
Access R R R R R R
R
Name Value ID Type Min Max Step Unit
Value ID
Description e.g. 3704 -> Channel 37, Value 4
Type of the value
Minimum valid value Maximum valid value Conversion of register value: Value =
Register Step Unit of measurement Reserved
e.g. 13704 -> TX, Channel 37, Value 4
Value range 100…4000 0:none; 1:UINT16; 2:INT16; 3:UINT32_MSB 4:UINT32_LSB
1:1; 2:0.1; 3:0.01; 4:0.001; See below
10100…14000
Type 0:none means that the corresponding Value register is unused.
Conversion example for temperature -10…30 °C stored in register RX.CH37.V1. Descriptors are as follows:
Group
Offset Access Name Dec (s16)
0
R
1
R
2
R
RX Value 1 3
R
4
R
5
R
6…9
Value ID Type Min Max Step Unit
3701 2 -100 300 2 62
Value of register is interpreted as follows:
Hex (u16)
0x0E75 0x0002 0xFF9C 0x012C 0x0002 0x005F
Interpreted value
INT16 -10°C 30°C 0.1 °C
Dec (s16) 227 -51
Hex (u16) 0x00E3 0xFFCD
Interpreted value Register Step = 22.7°C Register Step = -5.1°C
Codes for units are listed in ANNEX B (compatible with BACnetEngineeringUnits enumeration).
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
29/42
Firmware Update
8 Firmware Update
The firmware is constantly being improved and extended to support new features
and EnOcean devices. The actual version of the firmware is available for
download on the FIRVENA website.
8.1 Over Network
Open the Web UI and navigate to [Settings > Firmware Update]:
BIN
Select a file or drag it to the dashed rectangle and click on “Upload”. When
the uploading is done, the gateway reboots and the connection is lost:
Gateway checks the file and overwrites the current firmware with the new one.
The connection should be resumed within several minutes.
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
30/42
8.2 Over USB
The number of firmware version can be determined using the EO-BAC Tool:
Firmware Update
To update firmware in the gateway:
Unplug the POWER connector Set the left switch to the “MSC” position Connect
the gateway to a computer using a USB cable with type B connector The device
appears as an external disk, copy the new firmware file to the disk
Set the left switch back to the “HID” position, the gateway reboots Now, the gateway checks the file and overwrites the current firmware with the new one The result is indicated by LEDs Disconnect the USB cable and plug the POWER connector back
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
31/42
References
References
[1] EnOcean Technical Specifications (https://www.enocean-
alliance.org/specifications/)
[2] EnOcean Equipment Profiles (https://www.enocean-alliance.org/wp-
content/uploads/2020/07/EnOcean-EquipmentProfiles-3-1.pdf)
[3] Communication telegrams defined in EnOcean equipment profiles
(http://tools.enocean-alliance.org/EEPViewer/)
[4] Smart Acknowledge Bidirectional communication with energy harvesting
devices (https://www.enocean-
alliance.org/wpcontent/uploads/2020/04/SmartAcknowledge_Specification_v1.7.pdf)
[5] EnOcean Unique Radio Identifier EURID Specification (https://www
.enocean-alliance.org/wp-content/uploads/2021/03/EURID-v1.2.pdf)
[6] Modbus Protocol Specifications and Implementation Guides:
https://modbus.org/specs.php
[7] Modbus Application Protocol Specification:
https://modbus.org/docs/Modbus_Application_Protocol_V1_1b3.pdf
[8] Modbus TCP/IP Implementation Guide:
https://modbus.org/docs/Modbus_Messaging_Implementation_Guide_V1_0b.pdf
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
32/42
Revision History
Date 2022-04-01 2022-08-05
Version V1.0 V1.1
2022-11-01
V1.2
2022-12-14
V1.3
2022-01-23
V1.4
Description
Initial release Added bidirectional communication Added Ch. 6.2.5 Updated
figures Updated ANNEX A Chapters rearranged Added Ch 4, 5 Extended ANNEX A
(D2-01-XX)
Revision History
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
33/42
Mapping examples of EnOcean devices
ANNEX A Mapping examples of EnOcean devices
A.1 Basic Examples
RX Values:
Ch. Device A5-02-05
1
Register Value Name 0 Temperature
15 Telegram counter 16 Telegram age 17 Signal
Range 0…40 °C
0…65535 0…65000 s 0…255dBm
Value 22.4°C
Dec Hex 224 0x00E0
12
12 0x000C
252s 252 0x00FC
49dBm 49 0x0031
2
00-00-00
19 Error
20 None
…
…
34 None
35 Telegram counter
36 Telegram age
37 Signal
0…65535 0…65000 s 0…255dBm
0 (OK) 0 … 0 0
65535 0
… D5-00-01
32
39 Error
620 Contact
635 Telegram counter 636 Telegram age 637 Signal
0:open, 1:closed
0…65535 0…65000 s 0…255dBm
255 (FREE)
1
50 10s 58dBm
…
39
00-00-00
A5-09-04 40
639 Error
0 (OK)
780 Humidity 781 Concentration 782 Temperature 783 H-Sensor 784 T-Sensor
795 Telegram counter 796 Telegram age 797 Signal
0…100 % 0…2550 ppm 0…51 °C 0:Not available, 1:Available 0:Not available, 1:Available
45% 1451ppm
23.2°C 1 1
450 1451 232
0x01C2 0x05AB 0x00E8
0…65535 0…65000 s 0…255dBm
50 10s 52dBm
7999 Error
0 (OK)
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
34/42
Mapping examples of EnOcean devices
A.2 RPS Buttons and Switches
The following example applies to F6-02-01, F6-02-02, F6-02-03 and F6-02-04
Ch. Device F6-02-02
1
Register 0 1 2 3 4 5
Value Name BI B0 AI A0 Rocker B Rocker A
Range 0:released, 1:pressed 0:released, 1:pressed 0:released, 1:pressed 0:released, 1:pressed -1:null, 0:off, 1:on -1:null, 0:off, 1:on
Value 1 0 0 0 1 0
Dec Hex
2
00-00-00
…
V4 and V5 remember the rocker state for channel A and B, this is out of the EEP definition. Rocker B goes 1:on when BI was pressed, Rocker B goes 0:off when B0 was pressed. When no telegram has been received yet, rocker has the initial value -1:null.
A.3 A5-20-01 HVAC Components, Battery Powered Actuator
The actuator wakes up periodically, transmits the actual value and waits for a response with a new setpoint, which must be sent within 1 second. The response is built from TX Values registers. The response also contains other settings, e.g. Set point type selection, Set point inverse, Summer mode, Service mode.
Direction RX (from actuator):
Ch. Device
A5-20-01 1
Register 0 1 2 3 4 5 6
7
8 9
Value Name Current Value Service On Energy input enabled Energy Storage Battery capacity Contact, cover open Failure temperature sensor, out off range Detection, window open Actuator obstructed Temperature
Range 0…100 % 1:on 1:true 1:true 0:true 1:true 1:true
1:true
1:true 0…40 °C
Value 25% 0 0 1 1 0
0
Dec Hex 25 0x0019
0 0x0000 0 0x0000 1 0x0001 1 0x0001 0 0x0000
0 0x0000
0
0 0x0000
0
0 0x0000
22.59°C 226 0x00E2
2
00-00-00
…
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
35/42
Direction TX (to actuator):
Ch. Device 1 A5-20-01
Register 1000
1001 1002 1003 1004
Value Name Valve position or Temperature Setpoint Temperature from RCU Summer mode Setpoint selection Set point inverse
Range 0…100 %
0…40 °C 0…1 0…1 0…1
Mapping examples of EnOcean devices
Value
25%
0°C 0 0 0
Dec Hex
25 0x0019
0 0x0000 0 0x0000 0 0x0000 0 0x0000
2 00-00-00 …
SEND
3 (OnReceive)
A.4 D2-01-XX Electronic switches and dimmers with Energy Measurement and Local
Control
Device types from the D2-01-XX group share the same telegram definitions see
the profile D2-01-00 (http://tools.enocean-
alliance.org/EEPViewer/profiles/D2/01/00/D2-01-00.pdf). There are several
messages distinguished by the Command ID data field. Each type supports only
certain commands and functions, e.g. type 0x02 has one dimmable output, type
0x12 has two relay outputs without dimming function or type 0x0B supports
energy and power measurements.
The gateway creates a universal interface for all device types from the
D2-01-XX group, regardless of the features supported by a particular type.
A.4.1 Example with NodOn Micro Smart Plug (D2-01-0E) Measurements This
actuator has one output channel and supports energy and power measurements.
Incoming data Registers 1…6 contains data from the status message CMD 4,
registers 7…10 from the measurement message CMD 7. The register 0 indicates
which CMD was received last.
CMD4 status CMD7 measurement The most important is CMD4 -> Output value, which indicates the ON/OFF state of the actuator.
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
36/42
Mapping examples of EnOcean devices Outgoing data It is possible to transmit
different commands. The command is switched by the Command ID value, which is
always at the first position (register 1000). The meaning of the values from
register 1001 up depends on the Command ID. The default command is CMD1.
CMD1 set output
The most important is CMD 1, which is used to switch ON/OFF the output (0% =>
OFF; 100% => ON). The Output value in percent and Dim value is only applicable
to devices with the dimming feature supported. The value 127% corresponds to
0x7F: Output value not valid / not applicable. Setting up the measurement
through Modbus interface in Web UI
1. Go to Edit channel -> Values 2. Set Command ID (register 1000) to CMD 5
Set Measurement 3. Confirm “Apply” 4. The UI gets updated:
CMD5 set measurement
5. Enter inputs, there are several parameters according to the EEP
specification. 6. “Send Now” will transmit the telegram to the actuator.
The type D2-01-0E supports measurement report on query (CMD 6) or automatic
reporting based on the configuration sent in the CMD 5.
The power and energy measurements are configured and reported separately,
determined by CMD 5 -> Measurement mode and Unit; CMD 4 -> Unit.
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
37/42
Mapping examples of EnOcean devices
The measured value is 4 byte in size, split into two 16-bit values
(Measurement value = 256 * MSB + LSB), the physical unit is indicated by the
Unit value.
A.4.2 Example with NodOn Relay Switch (D2-01-12) Controlling the output
This actuator has two output channels, the example shows switching ON of the
second channel. TX data are first prepared by writing into the TX data
registers, then the control telegram (CMD1 Set output) is sent by writing
Send option = 2:SendNow. The actuator returns a status message (CMD4 Status
response), the message says the channel 2 (numbered from zero) is ON.
The Send option can also be configured so that the gateway sends when Output value is written (Send option = 13:OnWriteV2).
Dim value is not supported by this type and is ignored. Direction TX (to actuator):
Ch. Device
Register 1000 1002 1003
Value Name Command ID I/O channel Output value
1 D2-01-12 1001
Dim value
Range 1:Set Output;2:Set Local; … 0…31
0…127 %
0:Switch to output value;1:Dim to output value timer 1; …
Value 1 1
100%
0
Dec Hex 1 0x0001 1 0x0001
100 0x0064
0 0x0000
1017 SEND
2 00-00-00 …
Direction RX (from actuator):
Ch. Device
Register Value Name
D2-01-12 0
Command ID
1
1
2
…
2
00-00-00
…
I/O channel Output value Other values
Send option for Device1
2
2 0x0002
(SendNow)
Range 4:Status Response; 7:Measurement Response; 0…31 0…127 %
Value Dec Hex
4
4 0x0004
1
1 0x0001
100% 100 0x0064
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
38/42
Mapping examples of EnOcean devices
A.5 D2-11-XX Bidirectional Room Operating Panel (Smart ACK)
What is Smart ACK?
EnOcean sensors are in sleep mode most of the time to reduce power
consumption, so they cannot receive any telegram. The Smart ACK protocol
enables bidirectional communication with energy selfsufficient devices. For
example, Room Operating Panels D2-11-XX utilize the Smart ACK communication to
receive data, which is used to show symbols on the display or override some
parameters.
The Smart ACK protocol is described in [4]. When a message is sent to a Smart
ACK Sensor, a device called “Post Master” stores it in a “Mailbox” until the
sensor is ready to receive telegrams. When the sensor wakes up, it checks the
Mailbox. The Post Master sends the message buffered in the Mailbox or Mailbox
Empty message if the Mailbox is empty. The sensor receives the response from
Post Master and returns to sleep mode. The Mailbox is established in Post
Master during teach-in process.
The gateway does not support repeaters, there must be a direct connection
between the gateway and the Smart ACK device, i.e. Post Master and Mailbox are
located in the gateway.
A.5.1 Example with Thermokon SR06 LCD (D2-11-07)
Direction RX (from sensor):
The sensor sends two types of messages, ID 0 or ID 2. When Message ID is 0, only Set Point Type is valid, other values should be ignored.
Communication is initiated by the sensor on heartbeat (default 1000 s), change of measured value or button press (parameter change), which is indicated by TelegramType.
Ch. Device
Register Value Name
0
Set Setpoint type
D2-11-07 1
1
Telegram Type
2
Message ID
3
Temperature
4
Humidity
5
Setpoint offset
6
Basesetpoint
7
Valid temperature
correction
8
Fan speed
9
Occupancy state
Range
0:Temperature correction;1:Temperature setpoint
0:Heartbeat;1:Change of temperature or humidity value;2:User caused parameter
change
0:ID-0;2:ID-2
0…40 °C 0…100 %
0…255
15…30 °C
1:-1…1K;2:-2…2K;3:3…3K;4:-4…4K;5:-5…5K;6:6…6K;7:-7…7K;8:-8…8K;9:9…9K;10:-10…10K
0:Auto;1:Speed 0;2:Speed 1;3:Speed 2;4:Speed 3;7:Not available
0:State Unoccupied;1:State Occupied
Value Dec Hex
1
1 0x0001
2
2 0x0002
2
2 0x0002
23.84°C 238 0x00EE
0%
0 0x0000
170 170 0x00AA
21°C 21 0x0015
3
3 0x0003
7
7 0x0007
0
0 0x0000
2
00-00-00
…
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
39/42
Mapping examples of EnOcean devices
Direction TX (to sensor):
The gateway responds with message ID 1. Settings are changed by writing these values and SendOption = 2:SendNow, changes will apply next time the sensor wakes up. Without a response, the sensor uses the last settings.
SetPointType, TemperatureCorrection, BaseSetpoint and ValidTemperatureCorrection must be mirrored from RX data if no change is required.
Ch. Device
Register Value Name 1000 Set Setpoint type
1001 Display heating symbol
1002 Display cooling symbol
1 D2-11-07
1003
1004 1005 1006
Display window open symbol
Message ID Temperature correction Basesetpoint
1007
Valid temperature correction
1008 Fan speed 1009 Occupancy state
Range
0:Temperature correction;1:Temperature setpoint
0:Heating symbol off;1:Heating symbol on
0:Cooling symbol off;1:Cooling symbol on
0:Window open symbol off;1:Window open symbol on
1:ID-1
0…255
15…30 °C
1:-1…1K;2:-2…2K;3:-3…3K;4:4…4K;5:-5…5K;6:-6…6K;7:7…7K;8:-8…8K;9:-9…9K;10:10…10K
0:Auto;1:Speed 0;2:Speed 1;3:Speed 2;4:Speed 3;7:Not available
0:State Unoccupied;1:State Occupied
Value 1 0 0 1 1
128 21°C
3
0 0
Dec Hex 1 0x0001 0 0x0000 0 0x0000 1 0x0001 1 0x0001
128 0x0080 21 0x0015 3 0x0003
0 0x0000 0 0x0000
2 00-00-00 …
1017 SEND
2 2 0x0002
(SendNow)
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
40/42
Mapping examples of EnOcean devices
A.6 D2-15-00 People Activity Sensor
Ch. Device D2-15-00
1
Register Value Name
0
Presence
1
Energy Storage
Status
2
Pir Update Rate
3
Pir Counter
4
Activity
Range
0:Present;1:Not Present;2:Not detectable;3:Presence Detector error
Value 0
0:High;1:Medium;2:Low;3:Critical
0
1…16 s 0…65535 0…100 %
1s 7568 52%
Dec Hex 0 0x0000
0 0x0000
1 7568
52
0x0001 0x1D90 0x0034
2
00-00-00
…
The Activity is computed by gateway based on two subsequent values of the Pir Counter. When the Pir Update Rate is 1s and the sensor transmits data every 2 minutes, 100% corresponds to the Pir Counter increment of 120.
[%]
=
( – ) [] [] – []
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
41/42
ANNEX B Enumeration of Units
/000/”m2″, /001/”ft2″, /002/”mA”, /003/”A”, /004/”Ohm”, /005/”V”, /006/”kV”, /007/”MV”, /008/”VA”, /009/”kVA”, /010/”MVA”, /011/”var”, /012/”kvar”, /013/”Mvar”, /014/”°”, /015/”[?]”, /016/”J”, /017/”kJ”, /018/”Wh”, /019/”kWh”, /020/”Btu”, /021/”UK”, /022/”th”, /023/”J/kg”, /024/”[?]”, /025/”cph”, /026/”cpm”, /027/”Hz”, /028/”g/kg”, /029/”% rh”, /030/”mm”, /031/”mm”, /032/”Inch”, /033/”[?]”, /034/”w/f2″, /035/”[?]”, /036/”lm”, /037/”lx”, /038/”fc”, /039/”kg”, /040/”[?]”, /041/”t”, /042/”kg/s”, /043/”kg/min”, /044/”kg/h”, /045/”[?]”, /046/”[?]”, /047/”W”, /048/”kW”, /049/”MW”, /050/”Btu/h”, /051/”hp”, /052/”[?]”, /053/”Pa”, /054/”kPa”, /055/”Bar”, /056/”[?]”, /057/”[?]”, /058/”[?]”, /059/”[?]”, /060/”[?]”, /061/”[?]”, /062/”°C”, /063/”K”, /064/”°F”, /065/”[?]”, /066/”[?]”, /067/”Year”, /068/”Month”, /069/”week”, /070/”Day”,
/071/”h”, /072/”m”, /073/”s”, /074/”m/s”, /075/”km/h”, /076/”ft/s”, /077/”ft/min”, /078/”[?]”, /079/”[?]”, /080/”[?]”, /081/”[?]”, /082/”l”, /083/”[?]”, /084/”[?]”, /085/”m3/s”, /086/”[?]”, /087/”l/s”, /088/”l/min”, /089/”[?]”, /090/”°”, /091/”°C/h”, /092/”°C/min”, /093/”[?]”, /094/”[?]”, /095/””, /096/”ppm”, /097/”ppb”, /98/”%”, /99/”%/s”, /100/”[?]”, /101/”[?]”, /102/”[?]”, /103/”rad”, /104/”[?]”, /105/”[?]”, /106/”[?]”, /107/”[?]”, /108/”[?]”, /109/”[?]”, /110/”[?]”, /111/”[?]”, /112/”[?]”, /113/”[?]”, /114/”[?]”, /115/”inch2″, /116/”cm2″, /117/”[?]”, /118/”cm”, /119/”[?]”, /120/”[?]”, /121/”°K”, /122/”kOhm”, /123/”MOhm”, /124/”mV”, /125/”kJ/kg”, /126/”MJ”, /127/”[?]”, /128/”[?]”, /129/”kHz”, /130/”MHz”, /131/”[?]”, /132/”mW”, /133/”hPa”, /134/”mBar”, /135/”m3/h”, /136/”l/h”, /137/”[?]”, /138/”[?]”, /139/”[?]”, /140/”[?]”, /141/”[?]”,
EnOcean to Modbus/IP Gateway User Manual V1.4 / 2023-01-25
/142/”[?]”, /143/”[?]”, /144/”[?]”, /145/”mOhm”, /146/”MWh”, /147/”kBtu”, /148/”[?]”, /149/”[?]”, /150/”[?]”, /151/”[?]”, /152/”[?]”, /153/”N”, /154/”g/s”, /155/”g/min”, /156/”t/h”, /157/”[?]”, /158/”[?]”, /159/”ms”, /160/”Nm”, /161/”mm/s”, /162/”[?]”, /163/”[?]”, /164/”[?]”, /165/”[?]”, /166/”[?]”, /167/”[?]”, /168/”[?]”, /169/”A/m2″, /170/”F”, /171/”H”, /172/”[?]”, /173/”S”, /174/”S/m”, /175/”T”, /176/”[?]”, /177/”[?]”, /178/”Wb”, /179/”cd”, /180/”cd/m2″, /181/”K/h”, /182/”K/min”, /183/”J/s”, /184/”rad/s”, /185/”m2/N”, /186/”kg/m3″, /187/”Ns”, /188/”N/m”, /189/”W/m/K”, /190/”uS”, /191/”[?]”, /192/”[?]”, /193/”km”, /194/”um”, /195/”g”, /196/”mg”, /197/”mm”, /198/”mm/s”, /199/”dB”, /200/”dBmV”, /201/”dBV”, /202/”mS”, /203/”W/hr”, /204/”kWhr”, /205/”[?]”, /206/”[?]”, /207/”[?]”, /208/”g/g”, /209/”kg/kg”, /210/”g/kg”, /211/”mg/g”, /212/”mg/kg”,
Enumeration of Units
/213/”g/ml”, /214/”g/l”, /215/”mg/l”, /216/”ug/l”, /217/”g/m3″,
/218/”mg/m3″, /219/”ug/m3″, /220/”[?]”, /221/”g/cm3″, /222/”Bq”,
/223/”[?]”, /224/”[?]”, /225/”Gy”, /226/”mGy”, /227/”[?]”,
/228/”Sv”, /229/”[?]”, /230/”[?]”, /231/”[?]”, /232/”[?]”,
/233/”[?]”, /234/”pH”, /235/”[?]”, /236/”[?] 42/42