Difference between revisions of "KNX"

From HSYCO
Jump to navigation Jump to search
Line 236: Line 236:
 
==== Datapoint Type 1 (1 bit, Boolean) ====
 
==== Datapoint Type 1 (1 bit, Boolean) ====
 
Values: 0, 1
 
Values: 0, 1
KNX bit-level format:
+
 
 +
KNX bit-level format: {| class="wikitable"  width="160" || 1 || 2 || 3 ||}

Revision as of 16:26, 13 December 2013

The KNX I/O Server provides for the control of a KNX installation compliant with the KNX Standard version 2.0.

The communication between HSYCO and the KNX network must employ a KNXnet/IP gateway supporting the Tunneling service.

The KNX framework must be programmed to work properly using the ETS tool.

Each defined KNX group is seen as a datapoint whose value is formatted with respect to its DPT type. Supported DPT types range from DPT 1 to DPT 18. Moreover, it is possible to have virtual datapoints that link a set of datapoints used for the control of devices such as lights, dimmers, automations and thermostats which require several KNX groups for commands and feedback.

Options

ID Default Values Description
gui true true enable automatic support of Web GUI objects to show the system status and intercept control buttons
false disable support for the Web GUI
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
discovery true true automatically creates the list of all detected datapoints with type DPT 1 and the defined virtual datapoints in the systemtopo.txt file
false auto-detect for devices is disabled
fromevents false true generates events for commands sent on the KNX BUS reporting the source address and the value of the command
false disable command events
readaftercommand false true forces the driver to read the value of a datapoint after a command is sent to it
false the driver will assume that commands detected on the BUS are always successful, thus no re-reading is performed to set the value of a datapoint
localport <port_number> specifies the port used locally by HSYCO to communicate with the KNXnet/IP gateway. This option might be necessary when employing network address translation (NAT)

Configuration

HSYCO needs to know the KNX framework configuration, which can be imported from an ETS4 project file or manually defined.

Refer to KNX Utility page for instruction on how to configure and test the integration.

Datapoints

ID Value R/W Description
connection online R connection established to the gateway and initial reading executed
offline R HSYCO can't connect to the gateway
<datapoint_id> <value> R this datapoint has value <value>
W set this datapont to value <value>
<datapoint_id>.from.<source> <value> R a command with value <value> from the device with individual address <source> has been sent to the addressed datapoint. The source address has the format “x.y.z” (e.g. 1.2.87)
light.<N> 0 R the light is off
W turn off the light
1 R the light is on
W turn on the light
flip W invert the state of the light
unknown R the state of the light is unknown
dimmer.<N> off R the dimmer is off
W turn off the dimmer
on W turn on the dimmer
1% - 100% R the dimming level is set to the reported level
W set the dimming level to the specified value
unknown R the state of the dimmer is unknown
autom.<N> up R the automation is moving upwards
W move the automation upwards
down R the automation is moving downwards
W move the automation downwards
offup R the automation is stopped in a open position
offdown R the automation is stopped in the closed position
stop W stop the automation
unknown R the state of the automation is unknown
thermo.<N>.setpoint.temp <float_value> W set the setpoint to the specified value
up W increase the setpoint by 0.5
down W decrease the setpoint by 0.5
thermo.<N>.setpoint mode W switch to the next setpoint mode


Datapoint values

The KNX I/O Server supports all datapoint types (DPTs) with main number ranging from 1 to 18.

The value of a datapoint is formatted with respect to its DPT main number. The actual behavior of the datapoint is anyhow dependent on its complete type (i.e. main number and sub number). In the following, examples for the most common cases will be provided, but for a complete reference of all available datapoint types and allowed values we strongly advice to refer to chapter 3/7/2 of the KNX Standard v2.0. For each DPT the allowed values and the corresponding data converted to the KNX format will be provided.

Datapoint Type 1 (1 bit, Boolean)

Values: 0, 1

KNX bit-level format: {| class="wikitable" width="160" || 1 || 2 || 3 ||}