DUCO L2003592-F Modbus TCP
Litlhaloso tsa Sehlahisoa
- Lebitso la Sehlahiswa: Boto ea Khokahano ea Duco
- Mefuta e Tšehetsoeng: DucoBox Silent Connect, DucoBox Focus, DucoBox Energy
- Modbus Subset Support: HEX 0x03, 0x04, 0x06, 0x10
- Modbus Component Interface: TCP on port 502
Litaelo tsa Tšebeliso ea Sehlahisoa
Ho sebetsa le Registers / Parameters
The DucoBox Silent Connect, Focus, and Energy support the following Modbus subset functions:
- Bala lirekoto tse ngata tsa HOLDING (HEX 0x03)
- Bala lirejisete tse ngata tsa INPUT (HEX 0x04)
- Write a single HOLDING register (HEX 0x06)
- Ngola litlaleho tse ngata tsa HOLDING (HEX 0x10)
Input registers are read-only 16-bit variables, while holding registers are read/write 16-bit variables. The Modbus address can be set via the Display menu, Duco Installation App, or Duco Network Tool.
Puisano le Lekala la Taolo
The external control unit communicates with each component through read parameters (INPUT) and write parameters (HOLDING).
- Bala Litlhophiso (INPUT): Ventilation system type, ventilation status, indoor air quality based on relative humidity, indoor air quality based on CO2 value, etc.
- Ngola Litlhophiso (HOLDING): Ventilation status, component identification, etc.
It is recommended to read the current value before performing a write action to adjust the value. There are limits on write actions to prevent excessive writing.
Fetileview ea Parameters
Ka tlase ke ho fetaview of the INPUT and HOLDING parameters for the ventilation system and its components:
| Ngodisa | INPUT (Bala Paramethara) | Phetoho ea Boitsebiso | Kopo | Recommended Survey Frequency |
|---|---|---|---|---|
| 0020 | Mocheso ODA | E bonts'a mocheso oa moea oa phepelo ho tloha kantle ho ea ho unit (Outdoor Air). |
Matla a DucoBox | 1/min |
Selelekela
- The Modbus interface on DUCO systems (via the Duco Connectivity Board option on a DucoBox)1 allows an external controller or building management system to communicate with the DUCO ventilation system.
- That way, you can retrieve info about the ventilation network via read parameters or input registers, or read or adjust settings via write parameters or holding registers.
- The supported protocol is Modbus TCP over Ethernet or Wi-Fi via the Duco Connectivity Board. The information in this document is valid from API version v2.5 onwards.
Working registers/parameters
- The DucoBox Silent Connect, Focus, and Energy support the following Modbus subset:
HEX DEC SUPPORT FUNCTION 0x03 3 Bala lirekoto tse ngata tsa HOLDING 0x04 4 Bala lirejisete tse ngata tsa INPUT 0x06 6 Write a single HOLDING register 0x10 16 Write multiple HOLDING registers - Here, input registers are 16-bit read-only variables, and holding registers are 16-bit read/write variables. Combined consecutive registers are not used. The Duco Connectivity Board functions as a Modbus component via TCP on port 502. The Modbus address can be set via the Display menu (see information sheet L8000002), the Duco Installation App, or the Duco Network Tool.
- The external control unit communicates with each component (node) through read parameters (INPUT) and write parameters (HOLDING).
- Read parameters (INPUT): ventilation system type, ventilation status, indoor air quality based on relative humidity, indoor air quality based on CO2 value, …
- Write parameters (HOLDING): ventilation status, identification (of components), …
Hlokomela: Read parameters can be read without restriction. There are, however, two important limits to writing actions:- A daily limit of 200 write actions. From a second supply or extraction zone, 100 write actions are added per additional zone.
- A periodic limit of one write action every 2 seconds.
- It is recommended to use a logic that first reads the current value before determining whether a new write action is needed to adjust the value.
- Node e 'ngoe le e 'ngoe le mekhahlelo ea eona e abetsoe khoutu: XXyy (XX=node node, yy=nomoro ea parameter).
- This allows all values to be read and controlled from the external control unit. There are specific parameters for each component.
Hlokomela- Due to a difference in some Modbus implementations compared to the official specification (on which our implementation is based), an address shift of ‘1’ may occur for the read and write parameters.
E.g.: read address ‘20’ will become ‘19’. - For any box type (Silent Connect, Focus, Energy), this can be resolved via the Duco Installation App or the Duco Network Tool under tab > Tree view-Settings-external settings. With the DucoBox Focus, moreover, this can be solved by setting ‘ > ‘RegOffs’ to ‘1’ under > CONFIG > Modbus in the Display menu. With the DucoBox Energy also possible via ‘Register Offset’ under > Setting > Modbus in the advanced menu.
- Due to a difference in some Modbus implementations compared to the official specification (on which our implementation is based), an address shift of ‘1’ may occur for the read and write parameters.
Fetileview ea li-parameter
The overview is grouped into three sections:
- Parameters that are only supported at the system level.
- Parameters that are only supported by the DucoBox.
- Parameters that are supported by the nodes (components).
Ka tlase ke ho fetaview ea INNPUT le HOLDING parameters bakeng sa tsamaiso ea moea le likarolo.
Liparamente tsa sistimi:
| KEKETSO
(bala paramente) |
||||
| Ngodisa | Lintlha | Phetoho | Kopo | Maqhubu a lipatlisiso a khothaletsoang |
| 0020 | Mocheso ODA Displays the temperature of the supply air from outside to the unit (Outdoor Air). | °C / 10 | Matla a DucoBox | 1 / mets |
| 0021 | SUP temperature displays the temperature of the supply air from the unit to the home (Supply Air). | °C / 10 | Matla a DucoBox | 1 / mets |
| 0022 | Mocheso ETA Displays the temperature of the exhaust air from the home to the unit (Extract Air). | °C / 10 | Matla a DucoBox | 1 / mets |
| 0023 | Mocheso EHA Displays the temperature of the exhaust air from the unit to the outside (Exhaust Air). | °C / 10 | Matla a DucoBox | 1 / mets |
| 0024 | Mocheso oa ka ntle measured via the weather station. | °C / 10 | DucoBox e nang le seteishene sa boemo ba leholimo | 1 / mets |
| 0025 | Lebelo la moya Measured via the weather station. |
Decimetre/motsotswana | DucoBox e nang le seteishene sa boemo ba leholimo | 1 / mets |
| 0026 | Pula Measured via the weather station. |
0 = Che (Bohata) 1 = E (Ke 'Nete) | DucoBox e nang le seteishene sa boemo ba leholimo | 1 / mets |
| 0027 | Light intensity south was measured via the weather station. | Kilolux | DucoBox e nang le seteishene sa boemo ba leholimo | 1 / mets |
| 0028 | Light intensity east was measured via the weather station. | Kilolux | DucoBox e nang le seteishene sa boemo ba leholimo | 1 / mets |
| 0029 | Light intensity west was measured via the weather station. | Kilolux | DucoBox e nang le seteishene sa boemo ba leholimo | 1 / mets |
| 0030 | Local API Version Displays the local API version. | Nomoro eohle Example: 2.4 becomes 204.
Public API version ‘X.Y’ becomes Modbus = X · 100 + Y |
DucoBox Silent Connect DucoBox Focus DucoBox Energy | 1 / letsatsi |
| 0031 | Remaining write actions: Displays the number of corrective commands until midnight. | Nomoro kaofela | DucoBox Silent Connect DucoBox Focus DucoBox Energy | 1 / mets |
- Negative temperatures are displayed as a number greater than 32767.
- To display this value correctly, you need to implement some logic to convert the value.
- The formula is: (value-65536)/ 10
- ExampLe:
- If(ModBusInputRegisterValue >= 32768)
- Temp = (ModbusInputRegisterValue – 65536)/10
E 'ngoe - Temp = ModbusInputRegisterValue/10
QETA
Litekanyetso tsa DucoBox:
| KEKETSO
(bala paramente) |
|||||
| Ngodisa | Lintlha | Phetoho | Kopo | Maqhubu a lipatlisiso a khothaletsoang | |
| 0100 | Mofuta oa sistimi Indicates the type of ventilation system |
17 = DucoBox | DucoBox Silent Connect DucoBox Focus DucoBox Energy | nako e le 'ngoe | |
| 0102 | Nako e setseng Mokgwa wa Current Ventilation E bontša nako e setseng eo DucoBox e tla kenya moea ka eona ka mokhoa ona |
Metsotsoana | DucoBox Silent Connect DucoBox Focus DucoBox Energy | 1 / mets | |
| 0103 | Sekhahla sa phallo khahlano le boemo ba sepheo E bonts'a mokhoa oa 'nete oa moea bakeng sa sebaka seo karolo e leng ho sona |
Peresentetage | DucoBox Silent Connect DucoBox Focus DucoBox Energy | 1 / mets | |
| 0104 | Boleng ba moea oa ka tlung bo thehiloeng ho RH Average indoor air quality based on measured relative humidity |
100%
95% |
Boleng bo botle haholo ba moea oa kahare | Box sensor DucoBox Silent Connect
Box sensor DucoBox Energy |
1 / mets |
| 90%
80% 65% |
Moea o motle oa ka tlung | ||||
| 50%
35% |
Boemo ba moea bo amohelehang ka hare ho ntlo ka nakoana | ||||
| 20%
5% |
Moea o fokolang oa ka tlung | ||||
| 0105 | Indoor air quality based on CO2 Average indoor air quality based on measured CO2 value |
100 % Very good indoor air 95 % quality
90% |
Box sensor DucoBox Silent Connect
Box sensor DucoBox Energy |
1 / mets | |
| 85%
80 % Good indoor air quality 75 % |
|||||
| 70%
65 % Temporarily acceptable 60 % indoor air quality 55% 50% |
|||||
| 45%
40 % Poor indoor air quality 35 % 35% |
|||||
| 0106 | Ventilation status Indicates the status of ventilation |
0 = Ho lokile 1 = Phoso 2 = Ha e sebetse |
DucoBox Silent Connect DucoBox Focus DucoBox Energy | 1 / mets | |
| 0107 | Filter Time Remaining Indicates remaining filter life |
Matsatsi | Matla a DucoBox | 1 / letsatsi | |
| 0108 |
Boemo ba sefe |
0 = Ho lokile
1 = Filter is dirty 2 = Inactive |
Matla a DucoBox | 1 / mets | |
| 0109 | Mongobo Indicates the measured humidity value. |
RH (%) (mongobo o amanang) | DucoBox Silent Connect DucoBox Focus DucoBox Energy
+ minimum 1 humidity sensor |
1 / mets | |
| 10% | Moea o fokolang oa ka tlung | ||||
| 15% | |||||
| 20 % Temporarily acceptable | |||||
| 25 % indoor air quality | |||||
| 30% | Moea o motle oa ka tlung | ||||
| 35% | |||||
| 40% | |||||
| Boleng bo botle haholo ba moea oa kahare | |||||
| 45%
50% 55% |
|||||
| 60% | Moea o motle oa ka tlung | ||||
| 65% | |||||
| 70% | |||||
| 75 % Temporarily acceptable | |||||
| 80 % indoor air quality | |||||
| 85% | Moea o fokolang oa ka tlung | ||||
| 0110 | CO2 Indicates the measured CO2 value. |
CO2 (ppm) | DucoBox Silent Connect DucoBox Focus DucoBox Energy
+ bonyane 1 CO2 Sensor |
1 / mets | |
| <800
800 900 |
Boleng bo botle haholo ba moea oa kahare | ||||
| 1000
1100 1200 |
Moea o motle oa ka tlung | ||||
| 1250
1300 1350 1400 1450 |
Boemo ba moea bo amohelehang ka hare ho ntlo ka nakoana | ||||
| 1500
1550 1600 > 1600 |
Moea o fokolang oa ka tlung | ||||
| TŠOARANG
(read/write parameter) |
||||
| Ngodisa | Lintlha | Phetoho | Kopo | Maqhubu a lipatlisiso a khothaletsoang |
| 0100 | Mokhoa oa ho kenya moea
Here, the ventilation mode can be adjusted. Conversions 11 through 16 are used to maintain manual modes longer. Bakeng sa mohlalaample, Manual 1 (conversion 4) is set to duration t by default. For Manual 1 x 2 (conversion 11), the mode t x 2 (= 2 x standard duration) will be maintained and for Manual 1 x 3 (conversion 14), the mode t x 3 (= 3 x standard duration) will be maintained. |
0 = MOSEBETSI
4 = Manual 1 5 = Manual 2 6 = Manual 3 7 = Not at home 8 = Permanent 1 9 = Permanent 2 10 = Permanent 3 11 = Manual 1 x 2 12 = Manual 2 x 2 13 = Manual 3 x 2 14 = Manual 1 x 3 15 = Manual 2 x 3 16 = Manual 3 x 3 |
DucoBox Silent Connect DucoBox Focus DucoBox Energy | 1 / mets |
| xx01 | Boitsebiso: Here, a component can be identified. This will light up blue. | 0 = Ponahalo ea Node E TLOHILE 1= Pono ea Node E BUTSE | DucoBox Silent Connect DucoBox Focus DucoBox Energy | One-time, read before write. (Read and check before writing) |
| 0102 | Mocheso oa phepelo target zone 1 Mona, mocheso oa matšeliso oa SUP zone 1 o ka fetoloa |
°C / 10 | Matla a DucoBox | One-time, read before write. (Read and check before writing) |
| 0103 | Mocheso oa phepelo target zone 2 Mona, mocheso oa matšeliso oa SUP zone 2 o ka fetoloa |
°C / 10 | Matla a DucoBox | One-time, read before write. (Read and check before writing) |
| 0104 | Mocheso oa phepelo target zone 3 Mona, mocheso oa matšeliso oa SUP zone 3 o ka fetoloa |
°C / 10 | Matla a DucoBox | One-time, read before write. (Read and check before writing) |
| 0105 | Mocheso oa phepelo target zone 4 Mona, mocheso oa matšeliso oa SUP zone 4 o ka fetoloa |
°C / 10 | Matla a DucoBox | One-time, read before write. (Read and check before writing) |
Li-parameter tsa node:
| KEKETSO
(bala paramente) |
||||
| Ngodisa | Lintlha | Phetoho | Kopo | Maqhubu a lipatlisiso a khothaletsoang |
| xx00 | Mofuta oa sistimi Indicates the type of ventilation system |
0 = Ha a tsejoe
7 = DucoTronic window ventilator 8 = User controller RF/BAT 9 = User controller RF/Wired 10 = Humidity Room sensor 12 =CO2 Room sensor 13 = Sensorless Control Valve 14 = Humidity Control Valve 16 = CO2 Control Valve 18 = Switch Sensor 22 = iAV Control valve 23 = iAV Humidity 25 = iAV CO2 27 = Sehlopha sa taolo 28 =CO2/RH control valve 29 = User Controller ‘Sun Control’ 30 = User Controller ‘Ventilative Cooling’ 31 = External multi-zone valve 35 = Humidity box sensor 37 = CO2 Box Sensor 38 = Motor relay 39 = Duco Weather Station or Outdoor Temperature Sensor 40 = Modbus motor 41 = Digital input 42 = Digital output 44 = Modbus relay 45 = Perilex 46 = Relay output |
User controller Room sensor Box sensor Control valve Switch sensor
Ventilator ea fensetere ea elektronike |
nako e le 'ngoe |
| xx02 | Nako e setseng Mokgwa wa Current Ventilation E bontša nako e setseng eo DucoBox e tla kenya moea ka eona ka mokhoa ona |
Metsotsoana | Taolo ea mosebelisi Sensor ea kamore ea ho laola valve ea ho fetola sensor | 1 / mets |
| xx03 | Sekhahla sa phallo khahlano le boemo ba sepheo E bonts'a mokhoa oa 'nete oa moea bakeng sa sebaka seo karolo e leng ho sona |
Peresentetage | Control valve, Electronic window ventilator | 1 / mets |
| xx04 | Boleng ba moea oa ka tlung bo thehiloeng ho RH Average indoor air quality based on measured relative humidity |
100%
95% |
Boleng bo botle haholo ba moea oa kahare | Sensor ea kamore ea ho laola | 1 / mets |
| 90%
80% 65% |
Moea o motle oa ka tlung | ||||
| 50%
35% |
Boemo ba moea bo amohelehang ka hare ho ntlo ka nakoana | ||||
| 20% | Moea o fokolang oa ka tlung | ||||
| xx05 | Indoor air quality based on CO2 Average indoor air quality based on measured CO2 value |
100 % Very good indoor air 95 % quality
90% |
Sensor ea kamore ea ho laola | 1 / mets | |
| 85%
80 % Good indoor air quality 75 % |
|||||
| 70%
65 % Temporarily acceptable 60 % indoor air quality 55% 50% |
|||||
| 45%
40 % Poor indoor air quality 35 % 30% |
|||||
| xx09 | Mongobo Indicates the measured humidity value. |
RH (%) (mongobo o amanang) | Humidity Room Sensor Humidity Box Sensor
Mongobo oa Taolo ea Mongobo Ventilator ea fensetere ea elektronike |
1 / mets | |
| 10%
15% |
Moea o fokolang oa ka tlung | ||||
| 20%
25% |
Boemo ba moea bo amohelehang ka hare ho ntlo ka nakoana | ||||
| 30%
35% 40% |
Moea o motle oa ka tlung | ||||
| 45%
50% 55% |
Boleng bo botle haholo ba moea oa kahare | ||||
| 60%
65% 70% |
Moea o motle oa ka tlung | ||||
| 75%
80% |
Boemo ba moea bo amohelehang ka hare ho ntlo ka nakoana | ||||
|
85% |
Moea o fokolang oa ka tlung | ||||
| xx10 | CO2 Indicates the measured CO2 value. |
CO2 (ppm) | CO2 Room Sensor CO2 Box Sensor CO2 Control Valve | 1 / mets | |
| < 800 Very good indoor air quality 800
900 |
|||||
| 1000 | |||||
| 1100 Good indoor air quality | |||||
| 1200 | |||||
| 1250 | |||||
| 1300 Temporarily acceptable
1350 indoor air quality |
|||||
| 1400 | |||||
| 1450 | |||||
| 1500
1550 1600 > 1600 |
Moea o fokolang oa ka tlung |
||||
| TŠOARANG
(read/write parameter) |
||||
| Ngodisa | Lintlha | Phetoho | Kopo | Maqhubu a lipatlisiso a khothaletsoang |
| xx00 | Mokhoa oa ho kenya moea
Here, the ventilation mode can be adjusted. Conversions 11 through 16 are used to maintain manual modes longer. Bakeng sa mohlalaample, Manual 1 (conversion 4) is set to duration t by default. For Manual 1 x 2 (conversion 11), the mode t x 2 (= 2 x standard duration) will be maintained and for Manual 1 x 3 (conversion 14), the mode t x 3 (= 3 x standard duration) will be maintained. |
0 = MOSEBETSI
4 = Manual 1 5 = Manual 2 6 = Manual 3 7 = Not at home 8 = Permanent 1 9 = Permanent 2 10 = Permanent 3 11 = Manual 1 x 2 12 = Manual 2 x 2 13 = Manual 3 x 2 14 = Manual 1 x 3 15 = Manual 2 x 3 16 = Manual 3 x 3 |
User controller Room sensor Box sensor Control valve
Ventilator ea fensetere ea elektronike |
1 / mets |
| xx01 | Boitsebiso Here, a component can be identified. This will light up blue. |
0 = Ponahalo ea Node E TLOHILE 1= Pono ea Node E BUTSE | User controller, Room sensor, Control valve,e Switch sens, or Electronic window ventilator | One-time, read before write. (Read and check before writing it) |
Lintlha tse akaretsang
Ho fumana hore na ke li-node life tse teng marang-rang, u ka (ka boikhethelo) sebelisa lirejisete tsa INPUT tse ka tlase. Ntle le moo, o ka hlahloba li-regista tsohle.
ExampLe:
|
NGOLISA |
DATA |
RETS'ELISITSOE PHUPUTSO MAKOA |
| 0000 | Bit field indicating which node numbers between 1 and 15 are occupied in the network |
nako e le 'ngoe |
| 0001 | Bit field indicating which node numbers between 16 and 31 are occupied in the network | |
| 0002 | Bit field indicating which node numbers between 16 and 31 are occupied in the network | |
| 0003 | Bit field indicating which node numbers between 48 and 63 are occupied in the network | |
| 0004 | Bit field indicating which node numbers between 64 and 79 are occupied in the network | |
| 0005 | Bit field indicating which node numbers between 80 and 95 are occupied in the network | |
| 0006 | Bit field indicating which node numbers between 96 and 111 are occupied in the network | |
| 0007 | Bit field indicating which node numbers between 112 and 127 are occupied in the network | |
| 0008 | Bit field indicating which node numbers between 128 and 143 are occupied in the network |
Lipotso Tse Botsoang Hangata
How can I set the Modbus address for the Duco Connectivity Board?
The Modbus address can be set via the Display menu, Duco Installation App, or Duco Network Tool.
What are the limits on write actions for the Duco Connectivity Board?
There is a daily limit of 200 write actions, with additional actions allowed based on the number of supply or extraction zones. Additionally, there is a periodic limit of one write action every 2 seconds.
Litokomane / Lisebelisoa
 |
DUCO L2003592-F Modbus TCP [pdf] Buka ea Taelo Silent Connect, Focus, Energy, L2003592-F Modbus TCP, L2003592-F, Modbus TCP, TCP |