5. Software Control - Lightware Device Controller
UMX-HDMI-140 series– User's Manual
54
Applied firmware package: v1.3.0b5 | LDC software: v2.5.6b2
5.9.6.
Macros
DIFFERENCE:
This feature is available only in UMX-HDMI-140-Plus model from FW package v1.3.0b5.
DEFINITION:
Macro is a batch of pre-defined commands stored in the device.
#macro #new
You can create your custom macros in a file, upload to the device and run at any time. The number of the
macros depends on the device type, UMX-HDMI-140-Plus switchers can handle up to 50 macros.
Important Notes about Macros
▪
The macros are stored in the internal device preses.
▪
The commands of a macro are executed sequentially (even if error happens at a command).
▪
Macros allow long commands that is suitable for e.g. infra code sending.
▪
Macros cannot be edited in the device.
▪
Macros are not saved when backup is created. See the
section.
Macro File Structure
<preset_name>
: it will be displayed in the Settings/Backup submenu (device configurations list).
<macro_name>
: each Macro must have a unique name.
<LW3_commands>
: LW3 SET and CALL commands. Syntax is not checked, error is not reported.
ATTENTION!
If you use the same name for a new macro, the existing one will be deleted.
Open a simple text editor and save the file with 'LW3' extension.
Uploading New Macros into the Internal Device Configuration Preset
The uploading steps are the following:
Step 1.
Create the
file
with macros according to the macro file structure and save it.
Step 2.
Navigate to the
Settings/Backup
submenu.
Step 3.
Select the device configuration
preset
at the bottom of the page.
Step 4.
Press the
Upload
button, browse the LW3 file and press
Open
.
ATTENTION!
The preset and the macros of the selected slot will be erased. If there is a macro with the
same name already in the device, it will be removed and the new one will be available.
;myDeviceMacros
;Begin myMacro1
CALL /MEDIA/VIDEO/XP:unmuteSource(I3)
CALL /MEDIA/VIDEO/XP:switch(I3:O1;I3:O2)
;End myMacro1
;Begin myMacro2
CALL /MEDIA/VIDEO/XP:unmuteSource(I4)
CALL /MEDIA/VIDEO/XP:switch(I4:O1;I4:O2)
;End myMacro2
;
<preset_name>
;Begin
<macro1_name>
<LW3_commands>
;End
<macro1_name>
;Begin
<macro2_name>
<LW3_commands>
;End
<macro2_name>
Format:
Example:
Discovered Macros in the device shown under Control/Macros submenu
Adding Macros by Preserving the Current Preset and Macros
If you follow the steps below, the existing macros of the selected preset will be preserved. But if there is a
macro with the same name already in the device, it will be removed and the new will be available.
Step 1.
Navigate to the
Settings/Backup
submenu.
Step 2.
Select the device configuration
preset
at the bottom of the page.
Step 3.
Press the
Download
button and click
Save
in the pop-up window.
Step 4.
Open the
file
with a simple text editor and add the desired macros to the bottom of the commands
between the
;Begin <macro_name>
and
;End <macro_name>
labels.
Step 5.
Save the file and navigate to the
Settings/Backup
submenu.
Step 6.
Select the device configuration
preset.
Step 7.
Press the
Upload
button, browse the LW3 file and press
Open
.
Saving the Macros
When you make a backup of the device, the macros are not saved in that file. Sometimes, it is necessary to
save the macros into a file and for example apply them in another (same type of) device. Follow these steps:
Step 1.
Navigate to the
Settings/Backup
submenu.
Step 2.
Select the device configuration
preset
at the bottom of the page.
Step 3.
Press the
Download
button and click
Save
in the pop-up window.
