Giacomini

The Giacoklima bus system equipped with the KM203 network controller allows for remote control and supervision, via Serial communication, of the whole heating/cooling framework.

Communication

Connect HSYCO to the KM203 controller employing an RS485 gateway.

RS-232 parameters:

Baud rate	19200
Data bits	8
Stop bit	1
Parity	none
Flow control	none

The Giacoklima bus architecture

This image illustrates an example of the system architecture:

The RS-485 port is on the top left corner of the KM203 interface as shown in the picture above.

HSYCO Configuration

Add a GKBUS I/O Server in the I/O Servers section of the Settings and set its parameters:

Communication

• Comm ID: select the comm port connected to the device.

High Availability

• Shutdown when inactive: defaults to true.

Options

ID	Default	Values	Description
gui	true	true	enable support for the UI object, UISET actions and USER commands
		false	disable UI support
startupevents	false	true	generate IO events also during the driver’s start-up phase
		false	start generating events only after HSYCO is aligned with the current status of the system
pollinterval	1	n > 0	the data acquisition interval, in seconds

gkbus.ini

The gkbus.ini file is a specific configuration file located in the main directory (same directory as hsyco.ini or hsyco.jar).

Here you must add a line for each thermostat belonging to the framework and optionally specify a descriptive name of the corresponding area.

Use the format “<ioserver_id>.k<n>.<addr> = name”, where <ioserver_id> is the id of the referred I/O server, <n> is the number of the KPM20 module the thermostat is connected to and <addr> is the secondary address of the thermostat.

For instance:

gk.k0.0 = Kitchen
gk.k0.1 = Bedroom
gk.k1.0 = Entrance

Datapoints

ID	Value	R/W	Description
connection	online	R	connection established
	offline	R	HSYCO can’t connect to the panel
k<n>.<addr>.name	<name>	R	the name of the addressed thermostat is set to the reported string
k<n>.<addr>.temp	<val>	R	the room temperature measured by the addressed thermostat is equal to <val> in °C/10
k<n>.<addr>.setpoint.temp	<val>	R	the set-point temperature measured by the addressed thermostat is equal to <val> in °C/10
		W	set the temperature set-point of the addressed thermostat to <val> in °C/10
k<n>.<addr>.setpoint.humidity	<val>	R	the set-point relative humidity of the addressed thermostat is equal to <val>
		W	set the relative humidity set-point of the addressed thermostat to <val>
k<n>.<addr>.humidity	<val>	R	the relative humidity measured by the addressed thermostat is equal to <val>
season	summer	R	the current season is set to summer
		W	set the current season to summer
	winter	R	the current season is set to winter
		W	set the current season to winter
k<n>.<addr>.mode	off	R	the addressed thermostat is set to mode “OFF”
		W	set the addressed thermostat to mode “OFF”
	com	R	the addressed thermostat is set to mode “Comfort”
		W	set the addressed thermostat to mode “Comfort”
	stb	R	the addressed thermostat is set to mode “Stand-by”
		W	set the addressed thermostat to mode “Stand-by”
	ngt	R	the addressed thermostat is set to mode “Night"
		W	set the addressed thermostat to mode “Night”
mode	off	W	set all the thermostats to mode “OFF”
	com	W	set all the thermostats to mode “Comfort”
	stb	W	set all the thermostats to mode “Stand-by”
	ngt	W	set all the thermostats to mode “Night”
k<n>.pump	0	R	the pump of the addressed KPM20 module is not active
	1	R	the pump of the addressed KPM20 module is active
k<n>.in.temp	<val>	R	the inlet temperature of the addressed KPM20 module is equal to <val>
k<n>.out.temp	<val>	R	the return temperature of the addressed KPM20 module is equal to <val> in °C/10
k<n>.setpoint.temp	<val>	R	the working set-point temperature of the addressed KPM20 module is equal to <val> in °C/10
k<n>.valve	<val>	R	the opening percentage value of the mixing valve calculated by the addressed KPM20 module is equal to val
ext.temp	<val>	R	the measured external temperature is equal to <val> in °C/10
t1.winter	<val>	R	the T1 temperature parameter’s value for winter climatic compensation is equal to <val> in °C/10
		W	set the T1 temperature parameter’s value for winter climatic compensation to <val> in °C/10
t2.winter	<val>	R	the T2 temperature parameter’s value for winter climatic compensation is equal to <val> in °C/10
		W	set the T2 temperature parameter’s value for winter climatic compensation to <val> in °C/10
lim.winter	<val>	R	the T-Lim temperature parameter’s value for winter climatic compensation is equal to <val> in °C/10
		W	set the T-Lim temperature parameter’s value for winter climatic compensation to <val> in °C/10
setpoint.winter	<val>	R	the minimum set-point temperature for winter is equal to <val> in °C/10
		W	set the minimum set-point temperature for winter to <val> in °C/10
setpoint.summer	<val>	R	the minimum set-point temperature for summer is equal to <val> in °C/10
		W	set the minimum set-point temperature for summer to <val> in °C/10

User Interface

You can use a tempmini object to create a thermostat-equivalent interface.

Set the Server ID field to the I/O Server’s name and specify the address of the thermostat (K483 module) in the Address field using the format “k<n>.<addr>” where <n> is the number of the KPM20 module the thermostat is connected to and <addr> is its address (e.g. k0.1 represents the second thermostat connected to the first KPM20):

UISET Actions

ID	Attribute	Set to
k<n>.<addr>.name	value	shows the name assigned to the addressed thermostat
k<n>.<addr>.temp	value	shows the measured room temperature in °C by the addressed thermostat
k<n>.<addr>.setpoint.temp	value	shows the set-point temperature in °C on the addressed thermostat
k<n>.<addr>.humidity	value	shows the measured relative humidity by the addressed thermostat
k<n>.in.temp	value	shows the inlet temperature of the addressed KPM20 module
k<n>.out.temp	value	shows the return temperature of the addressed KPM20 module
k<n>.setpoint.temp	value	shows the working set-point temperature in °C on the addressed KPM20 module
k<n>.valve	value	shows the opening percentage value of the mixing valve calculated by the addressed KPM20 module
ext.temp	value	shows the measured external temperature in °C
t1.winter	value	shows the T1 temperature parameter’s value for winter climatic compensation in °C
t2.winter	value	shows the T2 temperature parameter’s value for winter climatic compensation in °C
lim.winter	value	shows the T-Lim temperature parameter’s value for winter climatic compensation in °C
setpoint.winter	value	shows the minimum set-point temperature for winter
setpoint.summer	value	shows the minimum set-point temperature for summer
connection.label.online	visible	true when the system is connected to HSYCO, false otherwise
connection.label.offline	visible	true when the system is not connected to HSYCO, false otherwise
season.label.winter	visible	true when the current season is set to winter, false otherwise
season.label.summer	visible	true when the current season is set to summer, false otherwise
k<n>.<addr>.mode.label.off	visible	true when the addressed thermostat is OFF, false otherwise
k<n>.<addr>.mode.label.com	visible	true when the working mode of the addressed thermostat is set to “comfort”, false otherwise
k<n>.<addr>.mode.label.stb	visible	true when the working mode of the addressed thermostat is set to “stand-by”, false otherwise
k<n>.<addr>.mode.label.ngt	visible	true when the working mode of the addressed thermostat is set to “night”, false otherwise
k<n>.<addr>.relay.label.0	visible	true when the relay of the addressed thermostat is not active, false otherwise
k<n>.<addr>.relay.label.1	visible	true when the relay of the addressed thermostat is active, false otherwise
k<n>.pump.label.0	visible	true when the pump of the addressed KPM20 module is not active, false otherwise
k<n>.pump.label.1	visible	true when the pump of the addressed KPM20 module is active, false otherwise

USER Commands

Name	Param	Action
k<n>.<addr>.setpoint.temp	<val>	sets the set-point temperature of the addressed thermostat to the specified value (expressed in °C/10)
	up	increases the set-point temperature of the addressed thermostat by 0.5°C
	down	decreases the set-point temperature of the addressed thermostat by 0.5°C
k<n>.<addr>.mode	off	sets the addressed thermostat on mode “OFF”
	com	sets the addressed thermostat on mode “Comfort”
	stb	sets the addressed thermostat on mode “Stand-by”
	ngt	sets the addressed thermostat on mode “Night”
season	summer	sets the working mode season to summer
	winter	sets the working mode season to winter
t1.winter	<val>	sets the T1 temperature parameter’s value for winter climatic compensation to the specified value (in °C/10)
t2.winter	<val>	sets the T2 temperature parameter’s value for winter climatic compensation to the specified value (in °C/10)
lim.winter	<val>	sets the T-Lim temperature parameter’s value for winter climatic compensation to the specified value (in °C/10)
setpoint.winter	<val>	sets the minimum set-point temperature for winter to the specified value (in °C/10)
setpoint.summer	<val>	sets the minimum set-point temperature for summer to the specified value (in °C/10)

Release Notes

3.8.0

• added k<n>.<addr>.setpoint.humidity datapoint

3.3.0

• initial version release

---

Giacomini, GKBus and Giacoklima are registered trademarks of Giacomini SpA.