SmartHome – system variables

Reading time 2 minutes

Aktualisiert – Dezember 31, 2022

Some system variables are predefined, but you can also create them yourself and can be accessed via the “Settings – System Variables” menu. System variables must be unique and may therefore only be assigned once per control center. Special characters in the name should be avoided.

In the view of the system variables you can click on the “New” button at the bottom left

a system variable can be created.

The desired name of the system variable is entered in the “Name” field, e.g. “Presence”. The description of the system variable can be different from the name or identical.

There are several options to choose from as a variable type.

If you want to check the "presence" of a person, the only choice is "logic value", because the statement of the system variable "presence" can only assume the state "true" or "false". “True” is therefore equivalent to “the person is present" or "not present“. Here “not present” was deliberately chosen instead of “absent” because “present” and “absent” can easily be confused with each other

A list of values is interesting when a condition needs to be fulfilled depending on several values.

A list of values can contain numbers, but also numeric values, such as “Summer; “Autumn”, each separated from the other by a semicolon.

All data in the “number” format are served via this type. You can take positive and negative values,

Data of type “String” consists of any string of alphanumeric values including special characters.

The system variable “Alarm” is set by the system to “triggered”, corresponding to “true”, if an error occurs, otherwise to “not triggered”, corresponding to “false”.

In the “Unit of measurement” field, “kW” or “°C”, for example, can be entered if these are power values or temperatures, for example.

The information in the “Value” field defines the initial value at system start, whether this should be assumed as “true” or “false” by default.

If you assign a channel of a device to the system variable, click on the radio button “with” under “Channel assignment”. In this case, the system variable is no longer displayed under “System Variables”, but rather in the web frontend for the corresponding device.

In the script language you call the value of a system variable

var myvar= dom.GetObject("Sysvar").Value();

from, or sets a value with

dom.GetObject("Sysvar").State(myvar);.

You can call up the value of a device channel

var myvar = dom.GetObject("BidCos-RF.MEQ0817107:1.LOWBAT").Value();

away. Here “BidCos-RF.” is the standardized header, and the following character string is the unique ID of the respective device, which was transmitted when the control center was trained, separated by a colon from the channel, here “1”, its value, here “LOWBAT”. , the battery charge level, should be queried.

With

WriteLine(myvar);

the determined value can be output.