Macros - Lightware HDMI-TPS-TX226 User Manual

   
5.SoftwareControl-LightwareDeviceController
5.9.5. Macros
DIFFERENCE:
ThisfeatureisavailableonlyforSW4-TPS-TX240-PlusfromFWpackagev1.3.0b6.
DEFINITION:
Macroisabatchofpre-definedcommandsstoredinthedevice.
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.SeetheSavingtheMacros
Macro File Structure
Format:
;<preset_name>
;Begin <macro1_name>
<LW3_commands>
;End <macro1_name>
;Begin <macro2_name>
<LW3_commands>
;End <macro2_name>
<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. NavigatetotheSettings/Backup submenu.
Step 3. Selectadeviceconfigurationpreset atthebottomofthepage.
Step 4. PresstheUpload button,browsetheLW3fileandpressOpen.
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.
#macro
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
Appliedfirmwarepackage:v1.3.2b3 | LDCsoftware:v2.5.7b2
HDMI-TPS-TX200series–User'sManual
Discovered Macros in the device shown under Control/Macros submenu
Adding Macros to an Existing Preset
Step 1. NavigatetotheSettings/Backup submenu.
Step 2. Selectadeviceconfigurationpreset atthebottomofthepage.
Step 3. PresstheDownload 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. SavethefileandnavigatetotheSettings/Backup submenu.
Step 6. Selectthesamedeviceconfigurationpreset as selected in Step 2.
Step 7. PresstheUpload button,browsetheLW3fileandpressOpen.
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. NavigatetotheSettings/Backup submenu.
Step 2. Selectthedeviceconfigurationpreset thatisusedforthemacrosatthebottomofthepage.
Step 3. PresstheDownload button and click Save inthepop-upwindow.
53