I-DUCO L2003592-F Modbus TCP

Imininingwane Yomkhiqizo

• Igama Lomkhiqizo: Ibhodi Lokuxhumana le-Duco
• Amamodeli Asekelwe: DucoBox Silent Connect, DucoBox Focus, DucoBox Energy
• Modbus Subset Support: HEX 0x03, 0x04, 0x06, 0x10
• Modbus Component Interface: TCP on port 502

Imiyalo yokusetshenziswa komkhiqizo

Ukusebenza namarejista/amapharamitha
The DucoBox Silent Connect, Focus, and Energy support the following Modbus subset functions:

• Funda amarejista amaningi okubambile (HEX 0x03)
• Funda amarejista amaningi we-INPUT (HEX 0x04)
• Write a single HOLDING register (HEX 0x06)
• Bhala amarejista amaningi okubambile (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.

Ukuxhumana ne-Control Unit
The external control unit communicates with each component through read parameters (INPUT) and write parameters (HOLDING).

• Funda Amapharamitha (INPUT): Ventilation system type, ventilation status, indoor air quality based on relative humidity, indoor air quality based on CO2 value, etc.
• Bhala Amapharamitha (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.

Kuphelileview ye-Parameters
Ngezansi i-overview of the INPUT and HOLDING parameters for the ventilation system and its components:

Bhalisa	INPUT (Funda ipharamitha)	Ukuguqulwa Kwedatha	Isicelo	Imvamisa Yenhlolovo Enconyiwe
0020	Izinga lokushisa ODA	Ibonisa izinga lokushisa lomoya wokuhlinzeka kusuka ngaphandle kuya ku iyunithi (Umoya Wangaphandle).	I-DucoBox Amandla	1/min

Isingeniso

• 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:
  

  I-HEX	DEC	SUPPORT FUNCTION
  0x03	3	Funda amarejista amaningi okubaMBA
  0x04	4	Funda amarejista amaningi we-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), …
    Qaphela: Read parameters can be read without restriction. There are, however, two important limits to writing actions:
    1. A daily limit of 200 write actions. From a second supply or extraction zone, 100 write actions are added per additional zone.
    2. 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.
• Indawo ngayinye nemingcele yayo yabelwe ikhodi: XXyy (XX=inombolo yenodi, yy=inombolo yepharamitha).
• This allows all values to be read and controlled from the external control unit. There are specific parameters for each component.
  Qaphela
  • 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.

Kuphelileview kwamapharamitha

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).
  Ngezansi i-overview we-INPUT kanye nemingcele yokubamba kokubili isistimu yokukhipha umoya kanye nezingxenye.

Amapharamitha wesistimu:

INPUT (funda ipharamitha)
Bhalisa	Idatha	Ukuguqulwa	Isicelo	Imvamisa yohlolo olunconyiwe
0020	Izinga lokushisa ODA Displays the temperature of the supply air from outside to the unit (Outdawu Air).	°C / 10	I-DucoBox Amandla	1 / iminithi
0021	SUP temperature displays the temperature of the supply air from the unit to the home (Supply Air).	°C / 10	I-DucoBox Amandla	1 / iminithi
0022	Izinga lokushisa I-ETA Displays the temperature of the exhaust air from the home to the unit (Extract Air).	°C / 10	I-DucoBox Amandla	1 / iminithi
0023	Izinga lokushisa EHA Displays the temperature of the exhaust air from the unit to the outside (Exhaust Air).	°C / 10	I-DucoBox Amandla	1 / iminithi
0024	Izinga lokushisa langaphandle measured via the weather station.	°C / 10	I-DucoBox enesiteshi sezulu	1 / iminithi
0025	Isivinini somoya Measured via the weather station.	Idesimetha/yesibili	I-DucoBox enesiteshi sezulu	1 / iminithi
0026	Imvula Measured via the weather station.	0 = Cha (Amanga) 1 = Yebo (Iqiniso)	I-DucoBox enesiteshi sezulu	1 / iminithi

0027	Light intensity south was measured via the weather station.	I-Kilolux	I-DucoBox enesiteshi sezulu	1 / iminithi
0028	Light intensity east was measured via the weather station.	I-Kilolux	I-DucoBox enesiteshi sezulu	1 / iminithi
0029	Light intensity west was measured via the weather station.	I-Kilolux	I-DucoBox enesiteshi sezulu	1 / iminithi
0030	Local API Version Displays the local API version.	Inombolo ephelele Example: 2.4 becomes 204. Public API version ‘X.Y’ becomes Modbus = X · 100 + Y	DucoBox Silent Connect DucoBox Focus DucoBox Energy	1 / ngosuku
0031	Remaining write actions: Displays the number of corrective commands until midnight.	Inombolo ephelele	DucoBox Silent Connect DucoBox Focus DucoBox Energy	1 / iminithi

• 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
    Okunye
  • Temp = ModbusInputRegisterValue/10
    Qeda

Amapharamitha we-DucoBox:

INPUT (funda ipharamitha)
Bhalisa	Idatha	Ukuguqulwa		Isicelo	Imvamisa yohlolo olunconyiwe
0100	Uhlobo lwesistimu Indicates the type of ventilation system	17 = DucoBox		DucoBox Silent Connect DucoBox Focus DucoBox Energy	isikhathi esisodwa
0102	Isikhathi esisele Imodi yamanje Yokungenisa umoya Ibonisa isikhathi esisele lapho i-DucoBox izokhipha umoya ngayo kule modi	Imizuzwana		DucoBox Silent Connect DucoBox Focus DucoBox Energy	1 / iminithi
0103	Izinga lokugeleza liqhathaniswa neleveli eqondiwe Ibonisa imodi yokungenisa umoya yangempela yezoni lapho ingxenye etholakala khona	Iphesentitage		DucoBox Silent Connect DucoBox Focus DucoBox Energy	1 / iminithi
0104	Ikhwalithi yomoya wasendlini esekelwe ku-RH Average indoor air quality based on measured relative humidity	100 % 95 %	Ikhwalithi yomoya yasendlini enhle kakhulu	Box sensor DucoBox Silent Connect Box sensor DucoBox Energy	1 / iminithi
		90 % 80 % 65 %	Ikhwalithi yomoya yasendlini enhle
		50 % 35 %	Ikhwalithi yomoya yasendlini eyamukelekayo okwesikhashana
		20 % 5 %	Ikhwalithi yomoya yasendlini ephansi
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 / iminithi
		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 = KULUNGILE 1 = Iphutha 2 = Ayisebenzi		DucoBox Silent Connect DucoBox Focus DucoBox Energy	1 / iminithi
0107	Filter Time Remaining Indicates remaining filter life	Izinsuku		I-DucoBox Amandla	1 / ngosuku
0108	Hlunga isimo Indicates the status of the filter	0 = KULUNGILE 1 = Filter is dirty 2 = Inactive		I-DucoBox Amandla	1 / iminithi
0109	Umswakama Indicates the measured humidity value.	I-RH (%) (umswakama ohlobene)		DucoBox Silent Connect DucoBox Focus DucoBox Energy + minimum 1 humidity sensor	1 / iminithi
		10 %	Ikhwalithi yomoya yasendlini ephansi
		15 %
		20 %   Temporarily acceptable
		25 %   indoor air quality
		30 %	Ikhwalithi yomoya yasendlini enhle
		35 %
		40 %
			Ikhwalithi yomoya yasendlini enhle kakhulu
		45 % 50 % 55 %
		60 %	Ikhwalithi yomoya yasendlini enhle
		65 %
		70 %
		75 %   Temporarily acceptable
		80 %   indoor air quality
		85 %	Ikhwalithi yomoya yasendlini ephansi

0110	CO2 Indicates the measured CO2  value.	I-CO2 (ppm)		DucoBox Silent Connect DucoBox Focus DucoBox Energy + ubuncane benzwa ye-CO2 engu-1	1 / iminithi
		<800 800 900	Ikhwalithi yomoya yasendlini enhle kakhulu
		1000 1100 1200	Ikhwalithi yomoya yasendlini enhle
		1250 1300 1350 1400 1450	Ikhwalithi yomoya yasendlini eyamukelekayo okwesikhashana
		1500 1550 1600 > 1600	Ikhwalithi yomoya yasendlini ephansi

UKUBAMBA (read/write parameter)
Bhalisa	Idatha	Ukuguqulwa	Isicelo	Imvamisa yohlolo olunconyiwe
0100	Imodi yokungenisa umoya Here, the ventilation mode can be adjusted. Conversions 11 through 16 are used to maintain manual modes longer. Okwesiboneloample, 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 = NGOKUZENZAKALELAYO 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 / iminithi
xx01	Ukuhlonza: Here, a component can be identified. This will light up blue.	0 = Ukubonakala Kwenodi KUVALIWE 1= Ukubona Ngeso leNodi KUVULIWE	DucoBox Silent Connect DucoBox Focus DucoBox Energy	One-time, read before write. (Read and check before writing)

0102	Izinga lokushisa lokunikezela target zone 1 Lapha, izinga lokushisa lokunethezeka le-SUP zone 1 lingalungiswa	°C / 10	I-DucoBox Amandla	One-time, read before write. (Read and check before writing)
0103	Izinga lokushisa lokunikezela target zone 2 Lapha, izinga lokushisa lokunethezeka le-SUP zone 2 lingalungiswa	°C / 10	I-DucoBox Amandla	One-time, read before write. (Read and check before writing)
0104	Izinga lokushisa lokunikezela target zone 3 Lapha, izinga lokushisa lokunethezeka le-SUP zone 3 lingalungiswa	°C / 10	I-DucoBox Amandla	One-time, read before write. (Read and check before writing)
0105	Izinga lokushisa lokunikezela target zone 4 Lapha, izinga lokushisa lokunethezeka le-SUP zone 4 lingalungiswa	°C / 10	I-DucoBox Amandla	One-time, read before write. (Read and check before writing)

Amapharamitha weNode:

INPUT (funda ipharamitha)
Bhalisa	Idatha	Ukuguqulwa	Isicelo	Imvamisa yohlolo olunconyiwe
xx00	Uhlobo lwesistimu Indicates the type of ventilation system	0 = Akwaziwa 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 = Iyunithi yokulawula 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 I-electronic window ventilator	isikhathi esisodwa
xx02	Isikhathi esisele Imodi yamanje Yokungenisa umoya Ibonisa isikhathi esisele lapho i-DucoBox izokhipha umoya ngayo kule modi	Imizuzwana	Isilawuli somsebenzisi Inzwa yegumbi Control valve Shintsha inzwa	1 / iminithi
xx03	Izinga lokugeleza liqhathaniswa neleveli eqondiwe Ibonisa imodi yokungenisa umoya yangempela yezoni lapho ingxenye etholakala khona	Iphesentitage	Control valve, Electronic window ventilator	1 / iminithi

xx04	Ikhwalithi yomoya wasendlini esekelwe ku-RH Average indoor air quality based on measured relative humidity	100 % 95 %	Ikhwalithi yomoya yasendlini enhle kakhulu	I-valve yokulawula inzwa yegumbi	1 / iminithi
		90 % 80 % 65 %	Ikhwalithi yomoya yasendlini enhle
		50 % 35 %	Ikhwalithi yomoya yasendlini eyamukelekayo okwesikhashana
		20 %	Ikhwalithi yomoya yasendlini ephansi
xx05	Indoor air quality based on CO2 Average indoor air quality based on measured CO2 value	100 % Very good indoor air 95 %   quality 90 %		I-valve yokulawula inzwa yegumbi	1 / iminithi
		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	Umswakama Indicates the measured humidity value.	I-RH (%) (umswakama ohlobene)		Humidity Room Sensor Humidity Box Sensor Ivalvu Yokulawula Umswakama I-electronic window ventilator	1 / iminithi
		10 % 15 %	Ikhwalithi yomoya yasendlini ephansi
		20 % 25 %	Ikhwalithi yomoya yasendlini eyamukelekayo okwesikhashana
		30 % 35 % 40 %	Ikhwalithi yomoya yasendlini enhle
		45 % 50 % 55 %	Ikhwalithi yomoya yasendlini enhle kakhulu
		60 % 65 % 70 %	Ikhwalithi yomoya yasendlini enhle
		75 % 80 %	Ikhwalithi yomoya yasendlini eyamukelekayo okwesikhashana
		85 %	Ikhwalithi yomoya yasendlini ephansi

xx10	CO2 Indicates the measured CO2  value.	I-CO2 (ppm)		I-CO2 Room Sensor CO2 Box Sensor CO2 Control Valve	1 / iminithi
		< 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	Ikhwalithi yomoya yasendlini ephansi

UKUBAMBA (read/write parameter)
Bhalisa	Idatha	Ukuguqulwa	Isicelo	Imvamisa yohlolo olunconyiwe
xx00	Imodi yokungenisa umoya Here, the ventilation mode can be adjusted. Conversions 11 through 16 are used to maintain manual modes longer. Okwesiboneloample, 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 = NGOKUZENZAKALELAYO 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 I-electronic window ventilator	1 / iminithi
xx01	Ukuhlonza Here, a component can be identified. This will light up blue.	0 = Ukubonakala Kwenodi KUVALIWE 1= Ukubona Ngeso leNodi KUVULIWE	User controller, Room sensor, Control valve,e Switch sens, or Electronic window ventilator	One-time, read before write. (Read and check before writing it)

Imininingwane ejwayelekile

Ukuze uthole ukuthi yimaphi ama-node akhona kunethiwekhi, ungakwazi (ngokuzithandela) ukusebenzisa amarejista we-INPUT angezansi. Ngaphandle kwalokho, ungaskena wonke amarejista.
Example:

BHALISA	IDATHA	OKUNCONYWA KWE-SURVEY FREQUENCY
0000	Bit field indicating which node numbers between 1 and 15 are occupied in the network	isikhathi esisodwa
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

imibuzo ejwayelekile ukubuzwa

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.

Amadokhumenti / Izinsiza

I-DUCO L2003592-F Modbus TCP [pdf] Incwadi Yeziqondiso I-Silent Connect, Focus, Energy, L2003592-F Modbus TCP, L2003592-F, Modbus TCP, TCP

Izithenjwa

• Imaniwali yosebenzisayo