The User Interface Configuration Database

From HSYCO
Revision as of 11:32, 13 March 2014 by Ulde (talk | contribs)
Jump to navigation Jump to search

The systemtopo.txt file should list all the I/O Servers data points that you want to control directly from the user interface.

It also contains the names of the Wi-Fi location zones.


Several I/O Servers support a discovery mode, where all data points that are suitable for direct control from the user interface can be automatically added to the systemtopo.txt file. Refer to the Application Notes in order to configure the I/O Servers.


systemtopo.txt can be modified at any time; any change is applied within a few seconds without restarting HSYCO. Web pages are automatically reloaded after any change to systemtopo.txt.


The file format is quite simple, it is separated in sections containing the list of all the devices available in the system. For example:

(location)
1p : FIRST FLOOR
2p : SECOND FLOOR

(devices)
k.light.14 : LIGHT ; LIGHT ; 
k.light.21 : LIGHT ; DIMMER ; DIMMER
k.autom.14 : AUTOM ; VSHUT ;

Every section starts with a line where the name of the section is within brackets, followed by the list of devices corresponding to every section. Every line starts with the id, which identifies every specific device, followed by “:” and the list of parameters separated by “;”.

The file is read ignoring blank lines and blanks within the lines which are not significant.

Any mistake in the file content will be shown in the log. In case of a general syntax error, the error message is:

systemtopo.txt Parser: Syntax Error, line: nnn

The number of the file line of the first mistake will always be shown.

Note In case of error the file is not fully interpreted, therefore the Web interface would not be able to work. The content of systemtopo.txt must be formally corrected to allow the correct execution of the Web Interface.

The individual sections can be omitted if empty.

A systemtopo.txt file which is completely empty is a correct file anyway.

Every section must appear only once in the file, repeating the header of an already defined section is an error.