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 format:

Change the IP address and password according to your controller settings.

The URL format is as follows: http://remote:remote@192.168.0.10/scada-remote?m=rss&r=alerts

Request parameters

m – return value format

r – requested function name

alerts – latest 50 alerts; return values:
- alert alert text
- time alert time (UNIX timestamp)
- date alert time (RFC date)
errors – latest 50 errors; return values:
- error error text
- script error script name
- time error time (UNIX timestamp)
- date error time (RFC date)
objects – list of objects ordered by update time; return values:
- 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 – execute one of grp functions; parameters:
- fn – function name, required
  - getvalue return current object value if found
  - find return object info
  - write send group write telegram
  - response send group response telegram
  - read send group read telegram
  - update update local 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 datatypes
- datatype – optional for write / response / update, data type is taken from the database if not specified

Parameters for time datatype:

Parameters for date datatype:

Examples:

Write value of 50 to 1/1/1:

http://remote:remote@192.168.0.10/scada-remote?m=json&r=grp&fn=write&alias=1/1/1&value=50

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

http://remote:remote@192.168.0.10/scada-remote?m=json&r=grp&fn=write&alias=1/1/2&value=true

Explicit set data type to scale, send value of 50 to 1/1/1:

http://remote:remote@192.168.0.10/scada-remote?m=json&r=grp&fn=write&alias=1/1/1&value=50&datatype=scale