Remote services

Remote services #

URL format #

Change the IP and password according to your LM settings

http://remote:remote@192.168.0.10/scada-remote?m=rss&r=alerts


Request parameters #

m - return value format #

  • json
  • xml
  • rss - only for alerts and errors

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:

  • day number (0-7), day of the week, optional
  • hour number (0-23)
  • minute number (0-59)
  • second number (0-59)

Parameters for date datatype:

  • day number (1-31)
  • month number (1-12)
  • year number (1990-2089)

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