GZC-ICD-001 Revision C: Glasshouse Zone Controller GZC-4 Supervisory Link

Interface control document. This document is synthetic. The GZC-4 does not exist; the document was written for the first-bite worked example in docs/icd-to-dictionary/06-worked-example/ and may be copied freely.

DocumentGZC-ICD-001
RevisionC
Date2026-10-05
DistributionUnrestricted (synthetic)

1 Scope

This document defines the messages exchanged between a GZC-4 glasshouse zone controller and its supervisor. A zone controller measures and regulates the climate and irrigation of one glasshouse zone. The supervisor collects the measurements of up to 32 zones and sends each controller its setpoints and commands.

2 Transport

Messages are carried in UDP datagrams over IPv4, one message per datagram.

InterfaceDirectionUDP portMessages
ZONEzone controller to supervisorsent from port 47010section 5
SUPVsupervisor to zone controllersent to port 47011section 6

3 Data conventions

3.1 Words and bits

A message is a sequence of 16-bit words. Words are numbered from 1. Each word is sent most significant byte first. The bits of a word are numbered 15 to 0; bit 15 is the most significant and is sent first.

3.2 Fields

The tables give each field's word and its bits, most significant bit first: 12-5 is the eight bits from bit 12 down to bit 5. A field that spans words is listed with a range of words; its Bits column then gives the field's first bit in the first word and its last bit in the last word, and the field takes every bit between them. The most significant part is in the first word.

3.3 Types

TypeMeaning
Uunsigned integer
Ssigned integer, two's complement
OBoffset binary: the value is the unsigned integer minus half the field's range, so a field of n bits reads zero at 2^(n-1)
SMsign-magnitude: the most significant bit is the sign (1 is negative), the remaining bits are the unsigned magnitude
Eenumeration; the values are in the table named in the description
Ddiscrete: one bit, 1 is set
AASCII characters, one per byte, first character in the most significant byte
—spare

3.4 Scaling

The LSB column gives the weight of the least significant bit. The value of a field is its integer multiplied by the LSB weight, in the unit of the Units column. For type OB the offset is subtracted before the multiplication.

3.5 Spare bits and reserved values

Spare bits are set to zero by the sender and ignored by the receiver. An enumeration value listed as Reserved is not sent; a receiver that gets one treats the field as invalid.

4 Message header

Every message of both interfaces begins with the four-word header of Table 4-1.

Table 4-1: Message header

FieldWordBitsTypeLSBUnitsDescription
Message ID115-8U——Identifies the message. See Table 5-1 and Table 6-1.
Message Length17-0U1wordsLength of the message in 16-bit words.
Zone Number215-10U——Zone the message concerns, 1 to 32.
Sequence Number29-0U——Incremented by the sender for each message; wraps from 1023 to 0.
Time of Day3-415-0U1msMilliseconds since local midnight when the message was built.

5 Zone controller to supervisor (ZONE)

5.1 Messages

Table 5-1: ZONE messages

IDMessageLength (words)SentDefined in
1Zone Status81 Hz5.2
2Climate Report110.2 Hz5.3
3Irrigation Report91 Hz during a run5.4
4Vent Report70.2 Hz5.5
5Alarm7on change5.6
6Event Log5 + 2Non request5.7
7Maintenance Data—on requestGZC-MNT-004

Maintenance Data is defined in the maintenance manual GZC-MNT-004 and is not part of this document.

5.2 Zone Status

Sent once a second while the controller is powered. Words 1 to 4 are the message header (Table 4-1).

Table 5-2: Zone Status

FieldWordBitsTypeLSBUnitsDescription
Operating Mode515-12E——Mode the zone is in. See Table 5-2a.
Door Open511D——Set while the zone door is open.
Heating Active510D——Set while the heating valve is open.
Irrigation Active59D——Set while an irrigation run is in progress.
Alarm Present58D——Set while at least one alarm is unacknowledged.
Spare57-0———Set to zero by the sender; ignored by the receiver.
Supply Voltage615-0U0.01VController supply voltage.
Zone Label7-815-0A——Four ASCII characters, padded with spaces.

Table 5-2a: Operating Mode values

ValueMeaning
0Off
1Manual
2Automatic
3Frost Protection
4Maintenance
5Ventilation Purge
6-15Reserved

5.3 Climate Report

Sent every five seconds with the zone's air and weather measurements. Words 1 to 4 are the message header (Table 4-1).

Table 5-3: Climate Report

FieldWordBitsTypeLSBUnitsDescription
Air Temperature515-0S0.01°CAir temperature at canopy height.
Relative Humidity615-6U0.1%Relative humidity at canopy height.
Leaf Wetness65-0U1—Leaf wetness index, a 6-bit value from 0 (dry) to 60 (saturated).
Outside Temperature715-4OB0.05°COutside air temperature, offset binary: zero is 2048.
Spare73-0———Set to zero by the sender; ignored by the receiver.
CO2 Concentration815-0U1ppmCarbon dioxide concentration.
Solar Irradiance915-0U0.1W/m²Global irradiance above the canopy.
Wind Speed1015-0U0.01m/sWind speed at the roof ridge.
Dew Point1115-0S0.01°CDew point computed from air temperature and relative humidity.

5.4 Irrigation Report

Sent once a second while an irrigation run is in progress, and once when it ends. Words 1 to 4 are the message header (Table 4-1).

Table 5-4: Irrigation Report

FieldWordBitsTypeLSBUnitsDescription
Spare515-12———Set to zero by the sender; ignored by the receiver.
Valve 4 Open511D——Set while valve 4 is open.
Valve 3 Open510D——Set while valve 3 is open.
Valve 2 Open59D——Set while valve 2 is open.
Valve 1 Open58D——Set while valve 1 is open.
Pump State57-4E——State of the dosing pump. See Table 5-4a.
Spare53-0———Set to zero by the sender; ignored by the receiver.
Flow Rate615-0U0.1L/minFlow through the zone manifold.
Volume Delivered7-815-8U0.1LVolume delivered since the run began, a 24-bit value.
Nutrient Solution pH87-0U0.1pHAcidity of the nutrient solution, as pH.
Electrical Conductivity915-0U0.001mS/cmConductivity of the nutrient solution.

Table 5-4a: Pump State values

ValueMeaning
0Stopped
1Starting
2Running
3Fault
4-15Reserved

5.5 Vent Report

Sent every five seconds with the position of the roof vents. Words 1 to 4 are the message header (Table 4-1).

Table 5-5: Vent Report

FieldWordBitsTypeLSBUnitsDescription
Roof Vent Offset515-6SM0.1degAngle of the roof vents from the commanded angle, sign-magnitude: bit 15 is the sign (1 is negative), bits 14-6 the magnitude.
Spare55-0———Set to zero by the sender; ignored by the receiver.
Windward Vent Position615-8U0.5%Opening of the windward vents.
Leeward Vent Position67-0U0.5%Opening of the leeward vents.
Vent Drive State715-12E——State of the vent drive. See Table 5-5a.
Drive Current711-0U1mACurrent drawn by the vent drive.

Table 5-5a: Vent Drive State values

ValueMeaning
0Idle
1Opening
2Closing
3Stalled
4-14Reserved
15Not Fitted

5.6 Alarm

Sent when an alarm is raised, acknowledged or cleared. Words 1 to 4 are the message header (Table 4-1).

Table 5-6: Alarm

FieldWordBitsTypeLSBUnitsDescription
Alarm Code515-8E——What the alarm is. See Table 5-6a.
Severity57-6E——How serious the alarm is. See Table 5-6b.
Acknowledged55D——Set once an operator has acknowledged the alarm.
Spare54-0———Set to zero by the sender; ignored by the receiver.
Occurrence Count615-0U1—Times this alarm has been raised since midnight.
Minutes Since Raised715-5U1minWhole minutes since the alarm was last raised.
Spare74-0———Set to zero by the sender; ignored by the receiver.

Table 5-6a: Alarm Code values

ValueMeaning
0Reserved
1High Temperature
2Low Temperature
3High Humidity
4Sensor Fault
5Pump Fault
6Vent Stalled
7Power Supply
8Low Battery
9-199Reserved
200-255Manufacturer specific

Table 5-6b: Severity values

ValueMeaning
0Advisory
1Caution
2Warning
3Reserved

5.7 Event Log

Sent on request with the most recent events of the zone. Words 1 to 4 are the message header (Table 4-1).

Table 5-7: Event Log

FieldWordBitsTypeLSBUnitsDescription
Record Count515-8U1—Number of event records that follow, 0 to 20.
Spare57-0———Set to zero by the sender; ignored by the receiver.

Record Count event records follow word 5, most recent first. Each is two words.

Table 5-7b: Event record

FieldWord of the recordBitsTypeLSBUnitsDescription
Event Code115-8U——What happened. The codes are listed in GZC-MNT-004.
Device17-0U——Number of the device the event concerns.
Event Time215-0U2sSeconds since local midnight, in steps of two seconds.

6 Supervisor to zone controller (SUPV)

6.1 Messages

Table 6-1: SUPV messages

IDMessageLength (words)SentDefined in
1Setpoint Command8on change6.2
2Irrigation Command7on demand6.3
3Vent Command6on demand6.4
4Time Synchronisation71 per hour6.5

6.2 Setpoint Command

Sets the climate the zone holds in Automatic mode. Words 1 to 4 are the message header (Table 4-1).

Table 6-2: Setpoint Command

FieldWordBitsTypeLSBUnitsDescription
Day Temperature Setpoint515-0S0.01°CAir temperature to hold between sunrise and sunset.
Night Temperature Setpoint615-0S0.01°CAir temperature to hold between sunset and sunrise.
Humidity Setpoint715-6U0.1%Relative humidity above which the vents open.
Spare75-0———Set to zero by the sender; ignored by the receiver.
CO2 Setpoint815-0U1ppmCarbon dioxide concentration to hold while the vents are closed.

6.3 Irrigation Command

Starts an irrigation run on the valves selected. Words 1 to 4 are the message header (Table 4-1).

Table 6-3: Irrigation Command

FieldWordBitsTypeLSBUnitsDescription
Spare515-12———Set to zero by the sender; ignored by the receiver.
Open Valve 4511D——Set to include valve 4 in the run.
Open Valve 3510D——Set to include valve 3 in the run.
Open Valve 259D——Set to include valve 2 in the run.
Open Valve 158D——Set to include valve 1 in the run.
Spare57-0———Set to zero by the sender; ignored by the receiver.
Run Time615-0U1sLongest time the run may last.
Volume Limit715-0U0.1LVolume at which the run ends.

6.4 Vent Command

Moves the roof vents. Words 1 to 4 are the message header (Table 4-1).

Table 6-4: Vent Command

FieldWordBitsTypeLSBUnitsDescription
Windward Vent Target515-8U0.5%Opening to move the windward vents to.
Leeward Vent Target57-0U0.5%Opening to move the leeward vents to.
Vent Command Mode615-12E——What the vent drive is to do. See Table 6-4a.
Spare611-0———Set to zero by the sender; ignored by the receiver.

Table 6-4a: Vent Command Mode values

ValueMeaning
0Hold
1Go To Target
2Close All
3Storm Close
4-15Reserved

6.5 Time Synchronisation

Sets the controller's calendar and clock offset. Words 1 to 4 are the message header (Table 4-1).

Table 6-5: Time Synchronisation

FieldWordBitsTypeLSBUnitsDescription
Year515-9U1—Years since 2000.
Month58-5U1—Month of the year, 1 to 12.
Day54-0U1—Day of the month, 1 to 31.
UTC Offset615-0S1minLocal time minus UTC.
Daylight Saving Active715D——Set while daylight saving time is in force.
Spare714-0———Set to zero by the sender; ignored by the receiver.

Appendix A Summary of field types used

TypeUsed by
OBClimate Report, Outside Temperature
SMVent Report, Roof Vent Offset
AZone Status, Zone Label

Appendix B Example messages

Each example gives a complete message as 16-bit words in hexadecimal, in the order sent, and the value of each field.

B.1 Zone Status (ZONE)

0108 0C11 0293 2E00 2500 096F 4E33 2020
FieldRawValue
Message ID11
Message Length88 words
Zone Number33
Sequence Number1717
Time of Day4320000043200000 ms
Operating Mode2Automatic
Door Open0Not set
Heating Active1Set
Irrigation Active0Not set
Alarm Present1Set
Supply Voltage241524.15 V
Zone Label0x4E332020"N3"

B.2 Climate Report (ZONE)

020B 0C12 0293 31E8 FF06 CB6A 76D0 019F 0DEA 01A9 FDE8
FieldRawValue
Message ID22
Message Length1111 words
Zone Number33
Sequence Number1818
Time of Day4320100043201000 ms
Air Temperature-250-2.50 °C
Relative Humidity81381.3 %
Leaf Wetness4242
Outside Temperature1901-7.35 °C
CO2 Concentration415415 ppm
Solar Irradiance3562356.2 W/m²
Wind Speed4254.25 m/s
Dew Point-536-5.36 °C

B.3 Irrigation Report (ZONE)

0309 1FFF 0149 98F4 0520 007D 12D6 873E 073A
FieldRawValue
Message ID33
Message Length99 words
Zone Number77
Sequence Number10231023
Time of Day2160050021600500 ms
Valve 4 Open0Not set
Valve 3 Open1Set
Valve 2 Open0Not set
Valve 1 Open1Set
Pump State2Running
Flow Rate12512.5 L/min
Volume Delivered1234567123456.7 L
Nutrient Solution pH626.2
Electrical Conductivity18501.850 mS/cm

B.4 Vent Report (ZONE)

0407 0C13 0293 35D0 9F40 4B00 1352
FieldRawValue
Message ID44
Message Length77 words
Zone Number33
Sequence Number1919
Time of Day4320200043202000 ms
Roof Vent Offset637-12.5 deg
Windward Vent Position7537.5 %
Leeward Vent Position00.0 %
Vent Drive State1Opening
Drive Current850850 mA

B.5 Alarm (ZONE)

0507 3004 0038 CEFC 0580 0003 0FA0
FieldRawValue
Message ID55
Message Length77 words
Zone Number1212
Sequence Number44
Time of Day37230043723004 ms
Alarm Code5Pump Fault
Severity2Warning
Acknowledged0Not set
Occurrence Count33
Minutes Since Raised125125 min

B.6 Event Log (ZONE)

0609 0C14 0293 39B8 0200 1102 1234 1202 1240
FieldRawValue
Message ID66
Message Length99 words
Zone Number33
Sequence Number2020
Time of Day4320300043203000 ms
Record Count22

Words 6 to 9 are 2 event records.

B.7 Setpoint Command (SUPV)

0108 0C05 0149 9700 08CA 0640 AF00 0320
FieldRawValue
Message ID11
Message Length88 words
Zone Number33
Sequence Number55
Time of Day2160000021600000 ms
Day Temperature Setpoint225022.50 °C
Night Temperature Setpoint160016.00 °C
Humidity Setpoint70070.0 %
CO2 Setpoint800800 ppm

B.8 Irrigation Command (SUPV)

0207 1C06 0149 97FA 0500 0258 09C4
FieldRawValue
Message ID22
Message Length77 words
Zone Number77
Sequence Number66
Time of Day2160025021600250 ms
Open Valve 40Not set
Open Valve 31Set
Open Valve 20Not set
Open Valve 11Set
Run Time600600 s
Volume Limit2500250.0 L

B.9 Vent Command (SUPV)

0306 0C07 0293 2A18 6419 1000
FieldRawValue
Message ID33
Message Length66 words
Zone Number33
Sequence Number77
Time of Day4319900043199000 ms
Windward Vent Target10050.0 %
Leeward Vent Target2512.5 %
Vent Command Mode1Go To Target

B.10 Time Synchronisation (SUPV)

0407 0C08 0000 0000 356F FE20 0000
FieldRawValue
Message ID44
Message Length77 words
Zone Number33
Sequence Number88
Time of Day00 ms
Year2626
Month1111
Day1515
UTC Offset-480-480 min
Daylight Saving Active0Not set

Appendix C Revision history

RevisionDateChange
A2026-03-02First issue.
B2026-06-15Added the Event Log message (5.7) and the Time Synchronisation message (6.5).
C2026-10-055.2: Operating Mode value 5, Ventilation Purge. 5.3: Leaf Wetness bits corrected to 5-0; Dew Point added as word 11, length now 11 words. 5.4: Flow Rate LSB changed from 0.25 to 0.1 L/min. 5.5: Motor Current renamed Drive Current. 5.6: Alarm Code value 8, Low Battery.

The source of this page is a Markdown file in the repository.