Variable-Management; Value Assignment; Addition And Subtraction (Add Method) - Lightware MMX8x4-HT420M User Manual

   
8. LW3 Programmers' Reference
8.23. Variable-Management
DIFFERENCE:
This feature and below commands are available from FW package v1.3.0.
Custom variables (30 pcs.) can be defined in number or text format which are available also in the Event
Manager. The maximum length of a variable can be 15 characters and they are stored in a non-volatile
memory, thus, the value is kept in case of a reboot. The type of the variable (text or string) is determined
automatically based on the value. If an operation cannot be performed (e.g. adding number value to a string-
type variable), error will be the response.
8.23.1. Value Assignment
Command and Response
SET·/CTRL/VARS/V<loc>.Value=<value>
ç
pw·/CTRL/VARS/V<loc>.Value=<value>
æ
Parameters
Parameter Parameter description
<loc> The location of the variable
<value> The value of the variable
Example
ç SET /CTRL/VARS/V1.Value=120
æ pw /CTRL/VARS/V1.Value=120
8.23.2. Addition and Subtraction (Add Method)
The value of a numeric variable can be increased by adding a positive value or it can be decreased by adding
a negative value. Minimum and maximum values can be defined as limits.
Command and Response
ç CALL·/CTRL/VARS/V<loc>:add(<operand>;<min>;<max>)
æ mO·/CTRL/VARS/V<loc>:add
Parameters
Parameter Parameter description
<loc> The location of the variable
<operand> The value that is added to the variable
<min> The lowest allowed value (optional)
<max> The highest allowed value (optional)
If the value of the variable is higher or equals with <max>, the new value will be <max>. Likewise, in case of
<min> setting: if the value of the variable is lower or equals with <min>, the new value will be <min>.
#variables
Value Value description
1-30
Length can be max 15 characters.
Numeric variable is defined between
Custom
-2147483648 and 2147483647.
Value Value description
1-30
Negative value is also accepted
Integer
Negative value is also accepted
Integer
Negative value is also accepted
Integer
Applied firmware package: v1.3.0 | LDC software: v2.4.2
MMX8x4-HT series – User's Manual
Examples
Change messages (CHG) can be seen after each response for the better understanding, which is not the part
of the command, but it can be set as described in the
Example 1 – addition
ç GET /CTRL/VARS/V1.Value
æ pw /CTRL/VARS/V1.Value=6
ç CALL /CTRL/VARS/V1:add(1)
æ mO /CTRL/VARS/V1:add
æ CHG /CTRL/VARS/V1.Value=7
ç CALL /CTRL/VARS/V1:add(1)
æ mO /CTRL/VARS/V1:add
æ CHG /CTRL/VARS/V1.Value=8
ç CALL /CTRL/VARS/V1:add(2)
æ mO /CTRL/VARS/V1:add
æ CHG /CTRL/VARS/V1.Value=10
Example 3 – addition with 'max' value
ç GET /CTRL/VARS/V1.Value
æ pw /CTRL/VARS/V1.Value=16
ç CALL /CTRL/VARS/V1:add(2;10;20)
æ mO /CTRL/VARS/V1:add
æ CHG /CTRL/VARS/V1.Value=18
ç CALL /CTRL/VARS/V1:add(2;10;20)
æ mO /CTRL/VARS/V1:add
æ CHG /CTRL/VARS/V1.Value=20
ç CALL /CTRL/VARS/V1:add(2;10;20)
æ mO /CTRL/VARS/V1:add
æ CHG /CTRL/VARS/V1.Value=20
Subscription section.
Example 2 – subtraction
ç GET /CTRL/VARS/V1.Value
æ pw /CTRL/VARS/V1.Value=10
ç CALL /CTRL/VARS/V1:add(-2)
æ mO /CTRL/VARS/V1:add
æ CHG /CTRL/VARS/V1.Value=8
ç CALL /CTRL/VARS/V1:add(-2)
æ mO /CTRL/VARS/V1:add
æ CHG /CTRL/VARS/V1.Value=6
ç CALL /CTRL/VARS/V1:add(-10)
æ mO /CTRL/VARS/V1:add
æ CHG /CTRL/VARS/V1.Value=-4
Example 4 – subtraction with 'min' value
ç GET /CTRL/VARS/V1.Value
æ pw /CTRL/VARS/V1.Value=14
ç CALL /CTRL/VARS/V1:add(-2;10;20)
æ mO /CTRL/VARS/V1:add
æ CHG /CTRL/VARS/V1.Value=12
ç CALL /CTRL/VARS/V1:add(-2;10;20)
æ mO /CTRL/VARS/V1:add
æ CHG /CTRL/VARS/V1.Value=10
ç CALL /CTRL/VARS/V1:add(-2;10;20)
æ mO /CTRL/VARS/V1:add
æ CHG /CTRL/VARS/V1.Value=10
148