5.SoftwareControl-LightwareDeviceController
HDMI-TPS-TX200series–User'sManual
53
Appliedfirmwarepackage:v1.3.2b3 | LDCsoftware:v2.5.7b2
5.9.5.
Macros
DIFFERENCE:
ThisfeatureisavailableonlyforSW4-TPS-TX240-PlusfromFWpackagev1.3.0b6.
DEFINITION:
Macroisabatchofpre-definedcommandsstoredinthedevice.
#macro
Youcancreateyourcustommacrosinafile,uploadtothedeviceandrunatanytime.Thenumberofthe
macrosdependsonthedevicetype,SW4-TPS-TX240-Plustransmitterscanhandleupto50macros.
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).
▪
Macrosallowlongcommandsthatissuitablefore.g.infracodesending.
▪
Macros cannot be edited in the device.
▪
Macrosarenotsavedwhenbackupiscreated.Seethe
Macro File Structure
<preset_name>
:itwillbedisplayedintheSettings/Backupsubmenu(deviceconfigurationslist).
<macro_name>
:eachMacromusthaveauniquename.
<LW3_commands>
:LW3SETandCALLcommands.Syntaxisnotchecked,errorisnotreported.
ATTENTION!
Ifyouusethesamenameforanewmacro,theexistingonewillbedeleted.
Openasimpletexteditorandsavethefilewith'LW3'extension.
Uploading New Macros into a New Preset
TherecommendedwayformacrosistouseaDeviceconfigurationpresetforthispurposeexclusively.When
youhavetoaddnewmacrosorchangeanyofthem,usethepreset.Theuploadingstepsarethefollowing:
Step 1.
Create the
file
withmacrosaccordingtothemacrofilestructureandsaveit.
Step 2.
Navigatetothe
Settings/Backup
submenu.
Step 3.
Selectadeviceconfiguration
preset
atthebottomofthepage.
Step 4.
Pressthe
Upload
button,browsetheLW3fileandpress
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 to an Existing Preset
Step 1.
Navigatetothe
Settings/Backup
submenu.
Step 2.
Selectadeviceconfiguration
preset
atthebottomofthepage.
Step 3.
Pressthe
Download
button and click
Save
inthepop-upwindow.
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.
Savethefileandnavigatetothe
Settings/Backup
submenu.
Step 6.
Selectthesamedeviceconfiguration
preset
as selected in
Step 2
.
Step 7.
Pressthe
Upload
button,browsetheLW3fileandpress
Open
.
Ifyoufollowabovesteps,theexistingmacrosoftheselectedpresetwillbepreserved.Butifthereisamacro
with the same name already in the device, it will be removed and the new will be available.
Saving the Macros
Whenyoumakeabackupofthedevice,themacrosarenotsavedinthatfile.Sometimes,itisnecessaryto
savethemacrosintoafileandforexampleapplytheminanother(sametypeof)device.Followthesesteps:
Step 1.
Navigatetothe
Settings/Backup
submenu.
Step 2.
Selectthedeviceconfiguration
preset
thatisusedforthemacrosatthebottomofthepage.
Step 3.
Pressthe
Download
button and click
Save
inthepop-upwindow.
