Thermostat Operations

The Thermostat cluster server is mandatory for some HVAC devices, such as the Thermostat device, while the cluster client can be used on a controlling device, such as the Remote Control device.

The sections below describe common operations using the Thermostat cluster.

Initialisation

The function eCLD_ThermostatCreateThermostat() is used to create an instance of the Thermostat cluster. The function is generally called by the initialization function for the host device.

Parent topic:Thermostat Operations

Recording and Reporting the Local Temperature

A record of the local temperature is kept in the mandatory attribute i16LocalTemperature on the cluster server - this attribute is fully detailed in Section 33.2. The value of this attribute can be updated by the server application using the function eCLD_ThermostatSetAttribute() - for example, as the result of a local temperature measurement.

The value of the attribute i16LocalTemperature can be regularly reported to a cluster client - for example, to allow the local temperature to be displayed to the user. This automated reporting can be configured and started on the server using the function eCLD_ThermostatStartReportingLocalTemperature(). Reports is sent regularly, but not periodically - maximum and minimum time-intervals between consecutive reports can be specified.

Parent topic:Thermostat Operations

Configuring Heating and Cooling Setpoints

Functions are provided to update the following two optional attributes that are used to specify setpoints (target temperatures) for heating and cooling:

i16OccupiedHeatingSetpoint
i16OccupiedCoolingSetpoint

If both of these setpoints are used, the cooling setpoint value must be greater than the heating setpoint value. These attributes are fully detailed in Section 33.2.

These server attributes can be controlled remotely from a client using the function eCLD_ThermostatCommandSetpointRaiseOrLowerSend(), usually as the result of user input on a controlling device. This function is used on the client to send a SetpointRaiseOrLower command to the server to increase or decrease the value of one or both of these setpoint attributes by a specified amount. On receipt of this command, an E_CLD_THERMOSTAT_CMD_SETPOINT_RAISE_LOWER event is generated on the server to notify the server application.

The server application can modify the values of these attributes using the function eCLD_ThermostatSetAttribute().

Note: These and other attributes of the Thermostat cluster can also be written and read using the general attribute access functions, as described in Section 2.3.

Parent topic:Thermostat Operations

Parent topic:Thermostat Cluster