Macros - Lightware MMX8x4-HT420M User Manual

   
6. Software Control – Lightware Device Controller
6.11.7. Macros

DEFINITION: Macro is a batch of pre-defined commands stored in the
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, for example MMX8x4 can handle up to 50 macros.
Important Notes about Macros
The macros are stored in device presets.
▪
▪ 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
Macro File Structure
Format:
;<preset_name>
;Begin <macro1_name>
<LW3_commands>
;End <macro1_name>
;Begin <macro2_name>
<LW3_commands>
;End <macro2_name>
<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 a New Preset
The recommended way for macros is to use a Device configuration preset for this purpose exclusively. When
you have to add new macros or change any of them, use the dedicated 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 a 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.
device. #macro #new
Configuration Cloning (Backup Tab) section.
Example:
;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
Applied firmware package: v1.3.0 | LDC software: v2.4.2
MMX8x4-HT series – User's Manual
Discovered Macros in the device shown under Control/Macros submenu
Adding Macros to an Existing Preset
Step 1. Navigate to the Settings/Backup submenu.
Step 2. Select a 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 same device configuration preset as selected in Step 2.
Step 7. Press the Upload button, browse the LW3 file and press Open.
If you follow above steps, 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.
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 that is used for the macros at the bottom of the page.
Step 3. Press the Download button and click Save in the pop-up window.
81