nxa.ExecuteXCommand

This function is used to execute an XLogic command within LUA.

Signature

nxa.ExecuteXCommand (string, ...)

Parameters

NameTypeMandatory/OptionalDescription
XCommandNamestringMName of XCommand. The variable scope is encoded as " : " . If no scope is needed only the XCommand name shall be given.
InputsParametersOutputs ...OInputs, Parameters and Outputs

Provide a function call argument for each input, parameter, and output.

Refer to this table to choose the correct format for passing arguments:

XLogic typeLUA typenotes
BOOLboolean, number, string

valid expressions for true are:

true, "T", "TRUE", 1

valid expressions for false are:

false, "F", "FALSE", 0

String expressions are non-case-sensitive.

ITEM IDstringA backslash inside the string has to be escaped by a backslash: "NETx\\XIO\\KNX\\172.16.1.3\\05/8/012"
NUMBERnumber
STRINGstring
ANYstring

A type indicator prefix is required in the string:

"{<type indicator>}:<value>"

Type indicators:

  • S: String
  • B: Boolean
  • I: Item
  • N: Number

Example

Following XCommand is to be called:

XCommand argumentXLogic typeValue
InputITEM IDNETx\XIO\KNX\172.16.1.3\05/8/012
InputNUMBER123
InputBOOLTRUE
ParameterANYnumber: 987
ParameterANYboolean: true
OutputITEM IDNETx\XIO\KNX\172.16.1.3\05/8/013

The respective call from LUA is

nxa.ExecuteXCommand ("NETx\\XIO\\KNX\\172.16.1.3\\05/8/012", 123, true, "{N}:987", "{B}:T", "NETx\\XIO\\KNX\\172.16.1.3\\05/8/013")

Return

None.