Remote Services

You can enable or disable remote access for controller maintenance, control, and export purposes.

Here are the details:

• Service status: In this section, you can enable or disable remote services.

• Allow only exported objects: If you select this option, only objects marked as exported will be available for remote services.

• Username: The default username for remote access.

• Password: The password should be 8-20 characters long.

URL configuration: Change the IP address and password according to your controller settings. The URL format is as follows: https://remote:remote@192.168.0.10/scada-remote?m=rss&r=alerts

Request parameters:

m – set the return value format

• json

• xml

• rss

r – requested function name

alerts – for 50 newest alerts

• alert: alert text

• time: alert time (UNIX timestamp)

• date: alert date (RFC date)

errors – for 50 newest errors

• error: error text

• script: error script name

• time: error time (UNIX timestamp)

• date: error time (RFC date)

objects – list of return values of export

Marked objects ordered by their update time:

• address: object address: e.g., 1/1/1

• name: object name: e.g., My object

• data: decoded object value: e.g., 42 or 01.01.2012

• datatype: object datatype: e.g., 1 or 5.001

• time: object update time (UNIX timestamp)

• date: object update time (RFC date)

• comment: object comment: e.g., Second floor entry lights

tags: optional array of object tags: e.g., Light, Second floor

grp: executes one of grp functions

fn: function name, required

• getvalue: returns current object value if found

• find: return object info

• write: send KNX bus group write telegram

• response: send KNX bus group response telegram

• read: send KNX bus group read telegram

• update: update local controller object value without KNX bus group write

• alias: group address or name, required

• value: new value to write, required for write/response/update, except for time and date

time datatypes:

• day number: (0 – 7), day of the week, optional

• hour number: (0 – 23)

• minute number: (0 – 59)

• second number: (0 – 59)

date datatypes:

• day number (1 – 31)

• month number (1 – 12)

• year number (1990 – 2089)

datatype: optional for write/response/update, data type is taken from the database if not specified: bool, bit2, bit4, char, uint8, int8, uint16, int16, float16, time, date, uint32, int32, float32, access string.

Examples:

Write boolean value to 1/1/2 you can use true or false, as well as 1 or 0:

https://remote:remote@192.168.0.10/scada-remote?m=json&grp=write&1/1/2=true

Write value of 50 to 1/1/1:

https://remote:remote@192.168.0.10/scada-remote?m=json&grp=write&1/1/1=50

Explicit datatype setting to scale, send 50 to 1/1/1:

https://remote:remote@192.168.0.10/scada-remote?m=json&grp=write&1/1/1=50&datatype=scale