SEND_COMMANDs
48
Mio Modero R-4 Remote - Instruction Manual
“^” Button Commands with Embedded Codes
These Button Commands are used in the NetLinx protocol and are case insensitive.
All commands that begin with “^” have the capability of assigning a variable text address range and button state range.
A device
must first be defined in the NetLinx programming language with values for the Device: Port: System
(in all programming
examples -
Remote
is used in place of these values).
Variable text ranges
allow you to target 1 or more variable text channels in a single command.
Button State ranges
allow you to target 1 or more states of a variable text button with a single command.
The
"."
Character is used for the 'through' notation, also the "
&
" character is used for the 'And' notation.
Button Commands (Cont.)
^TXT
Assign a text string to those buttons with a defined address range. Sets Non-Unicode text.
Syntax:
"'^TXT-<vt addr range>,<button states range>,<new text>'"
Variables:
• variable text address range = 1 - 4000.
• button states range = 1 - 2 (1 = Off state, 2 = On state).
• new text = 1 - 50 ASCII characters.
Example:
SEND_COMMAND Device,"'^TXT-500.504&510.515,1&2,Test Only'"
Sets the On and Off state text for buttons with the variable text ranges of 500-504 & 510-515.
?TXT
Get the current text information.
Syntax:
SEND_COMMAND <DEV>,"'?TXT-<vt addr range>,<button states range>,<optional index>'"
Variables:
• variable text address range = 1 - 4000.
• button states range = 1 - 256 for multi-state buttons (0 = All states, for General buttons 1 = Off state and 2 = On state).
• optional index = This is used if a string was too long to get back in one command. The reply will start at this index.
• custom event type = 1001:
Flag - Zero
Value1 - Button state number
Value2 - Actual length of string
Value3 - Index
Text - Text from the button
Text length - Button text length
Example:
SEND COMMAND Device,"'?TXT-529,1'"
Gets the button 'OFF state' text information.
The result sent to the Master would be:
ButtonGet Id = 529 Type = 1001
Flag = 0
VALUE1 = 1
VALUE2 = 14
VALUE3 = 1
TEXT = This is a test
TEXT LENGTH = 14
^UNI
Set Unicode text. For the ^UNI command (%UN and ^BMF command), the Unicode text is sent as ASCII-HEX nibbles.
Syntax:
"'^UNI-<vt addr range>,<button states range>,<unicode text>'"
Variables:
• variable text address range = 1 - 4000.
• button states range = 1 - 2 (1 = Off state, 2 = On state).
• unicode text = Unicode HEX value.
Example:
SEND_COMMAND Device,"'^UNI-500,1,0041'"
Sets the button’s unicode character to ’A’.
Note: To send the variable text ’A’ in unicode to all states of the variable text button 1, (for which the character code is 0041 Hex),
send the following command:
SEND_COMMAND Device,"'^UNI-1,0,0041'"
Note: Unicode is always represented in a HEX value.
