FIRVENA EO-MOD-IP EnOcean to Modbus-IP Gateway User Manual
- June 10, 2024
- FIRVENA
Table of Contents
- FIRVENA EO-MOD-IP EnOcean to Modbus-IP Gateway
- EnOcean to Modbus/IP Gateway – EO-MOD-IP User Manual V1.5
- Terms and Abbreviations
- Hardware Overview
- Technical Data
- Safety Information and Warnings
- Power Supply
- Configuration
- Mapping of EnOcean Devices
- Firmware Update
- References
- Revision History
- Introduction
- Hardware Overview
- Technical Data
- Guarantee
- Main Page Overview
- Firmware Update
- References
- Read User Manual Online (PDF format)
- Download This Manual (PDF format)
FIRVENA EO-MOD-IP EnOcean to Modbus-IP Gateway
EnOcean to Modbus/IP Gateway – EO-MOD-IP User Manual V1.5
(English)
Terms and Abbreviations
Term/Abbr. | Explanation |
---|---|
V1.5 / 2023-03-27 | The version number and date of the user manual. |
Hardware Overview
The EnOcean to Modbus/IP Gateway (EO-MOD-IP) is a device that allows EnOcean devices to communicate with Modbus devices over an IP network. It has Ethernet and USB ports for communication and can support up to 100 EnOcean devices. The device has LED indicators for power, network activity, and EnOcean device activity.
Technical Data
- Power supply: 24V DC ±10%
- Power consumption: max. 2W
- Operating temperature: -10°C to +50°C
- Storage temperature: -20°C to +70°C
- Humidity: 10% to 90% RH (non-condensing)
- Dimensions (W x H x D): 70mm x 90mm x 60mm
- Weight: approx. 200g
Safety Information and Warnings
- Do not expose the device to water or moisture.
- Do not use the device in areas where there is a risk of explosion.
- Only use the power supply provided with the device.
- Disconnect the power supply before opening the device.
Power Supply
The EO-MOD-IP requires a 24V DC power supply with a maximum power consumption of 2W. Only use the power supply provided with the device.
Configuration
To configure the EO-MOD-IP, access the device’s web interface by entering its IP address into a web browser. From there, you can configure the device’s network settings, EnOcean device mappings, and Modbus registers.
Mapping of EnOcean Devices
The EO-MOD-IP supports up to 100 EnOcean devices and allows you to map their data to specific Modbus registers. Refer to Annex A of the user manual for mapping examples.
Firmware Update
The EO-MOD-IP can be updated over the network or via USB. Refer to section 8 of the user manual for instructions.
References
Refer to Annex A of the user manual for mapping examples.
Revision History
Refer to section 2 of the user manual for the revision history.
EnOcean to Modbus/IP Gateway
EO-MOD-IP User Manual V1.5
English
EnOcean to Modbus/IP Gateway User Manual
V1.5 / 2023-03-27
3/44
Terms and Abbreviations
Terms and Abbreviations
Term/Abbr.
Explanation
EnOcean to Modbus/IP Gateway User Manual
V1.5 / 2023-03-27
4/44
List of Figures and Tables
List of Figures and Tables
Introduction
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 7.3.
Fig. 1.1 Functional overview
EnOcean to Modbus/IP Gateway User Manual
V1.5 / 2023-03-27
6/44
Hardware Overview
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 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. 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 LEDs are useful when
testing or commissioning but the light can be disruptive in normal operation,
for that reason, the LEDs can be disabled (WebUI > Settings > LED Indication).
See Tab. 2.1 for the meaning of individual indicators.
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.5 / 2023-03-27
7/44
Case
Power supply DHCP
Modbus communication
EnOcean USB
LEDs
POWER POWER MOD RX MOD TX ENOC USB ERROR
Tab. 2.1 LED functions
Hardware Overview
Behavior
Shining Goes off for 1 s Short blink Short blink Short blink Flashing
irregularly Flashing regularly
Meaning
Power supply connected and program running Network settings obtained from DHCP
server Traffic in the Modbus network received a packet Traffic in the Modbus
network sent a packet EnOcean telegram received or sent Indicates
communication through the USB port A fatal error has occurred, the device is
about to restart
EnOcean to Modbus/IP Gateway User Manual
V1.5 / 2023-03-27
8/44
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.5 / 2023-03-27
9/44
Dimensions in mm:
Technical Data
EnOcean to Modbus/IP Gateway User Manual V1.5 / 2023-03-27
10/44
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.5 / 2023-03-27
11/44
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.5 / 2023-03-27
12/44
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
Connect the gateway to your network using the 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. In this case, try to connect the gateway directly to a computer with Ethernet connector. You need to change the settings of network adapter according to the gateway. The default network configuration is:
Parameter IP address Subnet mask Default gateway
Value 192.168.1.90 255.255.255.0 192.168.1.1
Give the computer another IP address, e.g. 192.168.1.100.
When you know the IP address of the gateway, enter the IP address to the address bar of your web browser to access the WebUI.
When the gateway is connected to the network and you do not know its IP
address, you need to discover it. The methods of discovering the gateway are
as follows:
Discovery using UPnP
This method is recommended when using the Windows operating system, DHCP is
enabled and UPnP messages are allowed in the network to which the gateway is
connected.
Open the Network item in the File Explorer:
EnOcean to Modbus/IP Gateway User Manual V1.5 / 2023-03-27
13/44
Configuration 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].
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.
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.
EnOcean to Modbus/IP Gateway User Manual V1.5 / 2023-03-27
14/44
Configuration
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 clients list, look
for the host name “EO-MOD-IP_XXXXXX”. To access the WebUI, enter the IP
address to the address bar of your web browser.
EnOcean to Modbus/IP Gateway User Manual V1.5 / 2023-03-27
15/44
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.
Main Page Overview
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.5 / 2023-03-27
16/44
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.2.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.5 / 2023-03-27
17/44
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.5 / 2023-03-27
18/44
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.5 / 2023-03-27
19/44
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 Channel Details
When you click on the channel box, the “Edit channel” view is shown. There are three tabs:
1. Settings configuration of the channel 2. Values actual data of the assigned device 3. History short history of the first three RX values
In the channel box, the first three RX values are displayed. To view all actual data of the assigned device, open the “Values” tab see Fig. 6.7. Here you can find:
1. Address of the Modbus register 2. Value name and range info 3. Actual data
EnOcean to Modbus/IP Gateway User Manual
V1.5 / 2023-03-27
20/44
Configuration 4. Actual data encoded to registers For bidirectional EEPs and virtual devices, TX data can also be entered and sent using this view.
3. 4.
Fig. 6.7 Channel details Values tab
6.2.7 Removing EnOcean elements 1. Click on a channel box. 2. Click on the
“Delete” button.
To remove all elements, use [Settings > Factory Reset > Reset Channels].
6.2.8 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.5 / 2023-03-27
21/44
Modbus Interface
7 Modbus Interface
The gateway is a Modbus TCP/IP server, it processes requests sent by clients.
By default, the Modbus server listens on TCP port 502 and UDP port 502 (there
is a limit of four simultaneous TCP connections). Each Modbus server may
provide different services, which are identified by function codes in Modbus.
The definitions of standard services are described by the application layer
specification see [7], for more information about Modbus over TCP/IP see
[8].
This chapter describes how the data of EnOcean devices is translated into the
Modbus data model and how this data can be accessed by standard function
codes. A complete list of Modbus registers is also available.
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:
EnOcean to Modbus/IP Gateway User Manual V1.5 / 2023-03-27
22/44
Modbus Interface
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 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.
Tab. 7.1 Helper values
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
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.4
0…65535 (overflows to zero) 0…65000 s (65535: no telegram, 65001: range
exceeded) See Tab. 7.6
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.5 / 2023-03-27
23/44
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.5 / 2023-03-27
24/44
Modbus Interface
7.2 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.2 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.2.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.5 / 2023-03-27
25/44
Address = BaseAddress + Offset BaseAddress = 0 + 20 (ChannelNumber – 1)
Modbus Interface
Tab. 7.3 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.4
Tab. 7.4 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.2.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.5 / 2023-03-27
26/44
Modbus Interface
Tab. 7.5 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.6
Tab. 7.6 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.2.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.7 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.5 / 2023-03-27
27/44
Modbus Interface
Tab. 7.8 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.9 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.2.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.
Address = BaseAddress + Offset BaseAddress = 4000 + 10 (ChannelNumber – 1)
Tab. 7.10 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
7.2.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
EnOcean to Modbus/IP Gateway User Manual V1.5 / 2023-03-27
28/44
Modbus Interface
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.11 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.5 / 2023-03-27
29/44
Modbus Interface
7.2.6 Value Descriptors
Address = BaseAddress + Offset BaseAddress = 20000 + 300 (ChannelNumber – 1)
Tab. 7.12 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.5 / 2023-03-27
30/44
Modbus Interface
7.3 Supported Function Codes
According to the application layer specification, a client can read a maximum
of 125 registers and write a maximum of 123 registers in a single request.
Inside the defined areas (Tab. 7.2), the server allows reading any register,
it returns zeros for unused registers. Outside these areas, all requests ends
with exception code 02.
Code 3 (0x03) 6 (0x06) 16 (0x10)
Tab. 7.13 Supported function codes
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 may differ depending on the area.
EnOcean to Modbus/IP Gateway User Manual V1.5 / 2023-03-27
31/44
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.5 / 2023-03-27
32/44
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.5 / 2023-03-27
33/44
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.5 / 2023-03-27
34/44
Revision History
Date 2022-04-01 2022-08-05
Version V1.0 V1.1
2022-11-01
V1.2
2022-12-14
V1.3
2023-01-23
V1.4
2023-03-24
V1.5
Revision History
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) Updated figures Revised Ch. 6, 7 (Configuration, Modbus Interface)
Added description of Edit channel view (Ch. 6.2.6) Added description of LED
functions (Ch. 2)
EnOcean to Modbus/IP Gateway User Manual V1.5 / 2023-03-27
35/44
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.5 / 2023-03-27
36/44
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.5 / 2023-03-27
37/44
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.5 / 2023-03-27
38/44
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.5 / 2023-03-27
39/44
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.5 / 2023-03-27
40/44
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.5 / 2023-03-27
41/44
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.5 / 2023-03-27
42/44
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.5 / 2023-03-27
43/44
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.5 / 2023-03-27
/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/”[?] 44/44
References
Read User Manual Online (PDF format)
Read User Manual Online (PDF format) >>