Dummy
The DUMMY I/O Server is a virtual server that doesn’t actually connect to any external system, but simulates basic lighting and automation devices, and general purpose virtual data points.
Data points can also be remotely set or read using a simple HTTP API, based on the /x/httpcall interface.
Contents
HSYCO Configuration
Add a DUMMY I/O Server in the I/O Servers section of the Settings and set its parameters.
High Availability
- Shutdown when inactive: defaults to false.
Options
| ID | Default | Values | Description |
|---|---|---|---|
| discovery | true | true | automatically lists all virtual devices in the systemtopo.txt file |
| false | auto-detect for devices is disabled | ||
| lights | 10 | 0 ... 10000 | number of on/off light devices to generate |
| dimmers | 10 | 0 ... 10000 | number of dimmer devices to generate |
| automations | 10 | 0 ... 10000 | number of automation devices to generate |
| httpcallpassword | string of 8 or more uppercase or lowercase letters and digits | enables the HTTP API |
The Device Configuration Database
The systemtopo.txt file contains the list of all virtual devices that should be directly associated to graphic objects in the Web-based user interface.
This file can be filled manually or automatically by HSYCO at start-up. To enable automatic discovery and automatic generation of devices’ information in the systemtopo.txt file, use the discovery option in Settings.
This is an example of an automatically generated systemtopo.txt file:
(devices) dummy.autom.1 : AUTOM ; VSHUT ; DUMMY dummy.autom.2 : AUTOM ; VSHUT ; DUMMY dummy.autom.3 : AUTOM ; VSHUT ; DUMMY dummy.autom.4 : AUTOM ; VSHUT ; DUMMY dummy.autom.5 : AUTOM ; VSHUT ; DUMMY dummy.dimmer.1 : LIGHT ; DIMMER ; DUMMY dummy.dimmer.2 : LIGHT ; DIMMER ; DUMMY dummy.dimmer.3 : LIGHT ; DIMMER ; DUMMY dummy.dimmer.4 : LIGHT ; DIMMER ; DUMMY dummy.dimmer.5 : LIGHT ; DIMMER ; DUMMY dummy.light.1 : LIGHT ; LIGHT ; DUMMY dummy.light.2 : LIGHT ; LIGHT ; DUMMY dummy.light.3 : LIGHT ; LIGHT ; DUMMY dummy.light.4 : LIGHT ; LIGHT ; DUMMY dummy.light.5 : LIGHT ; LIGHT ; DUMMY
You should then manually add comments and other optional parameters:
(devices) dummy.autom.1 : AUTOM ; VSHUT ; Dummy automation 1 dummy.autom.2 : AUTOM ; VSHUT ; Dummy automation 2
Datapoints
| ID | Value | R/W | Description |
|---|---|---|---|
| connection | online | R | I/O Server ready |
| light.<n> | 0 | R | light <n> is off |
| W | switch off light <n> | ||
| off | W | ||
| 1 | R | light <n> is on | |
| W | switch on light <n> | ||
| on | W | ||
| dimmer.<n> | 0 | R | dimmer <n> is off |
| W | switch off dimmer <n> | ||
| off | W | ||
| 1 | W | switch on dimmer <n> | |
| on | W | ||
| 1% ... 100% | R | the light level of dimmer <n> corresponds to the reported value | |
| W | set the light level of dimmer <n> to the specified value | ||
| autom.<n> | offup | R | autom <n> is stopped in upper position
(set to this value 30 seconds after a 'up' command) |
| offdown | R | autom <n> is stopped in lower position
(set to this value 30 seconds after a 'down' command) | |
| stop | W | stop autom <n> | |
| off | |||
| 0 | |||
| up | R | autom <n> is moving upwards (opening) | |
| W | move autom <n> upwards | ||
| down | R | autom <n> is moving downwards (closing) | |
| W | move autom <n> downwards | ||
| <name> | <value> | R | generic data point <name> has value <value> |
| W | set value of generic data point <name> to <value> |
Virtual automation devices automatically go to the offup or offdown state 30 seconds after the up or down command.
Note that generic data point names must not start with "light", "autom" or "dimmer".
User Interface
All the devices that have been added in systemtopo.txt (automatically or manually) are listed in the Project Editor and can be directly associated to button and dimmer objects.
For example, adding a slider for a dimmer requires just a few clicks and no additional EVENTS logic.
Release Notes
3.6.0
- added support for generic read/write data points
3.0.0
- initial release
