background image

Introduction

1

i!-MacroManager

Introduction

i!-MacroManager allows users to create custom macros from any NetLinx compatible touch panel 

and execute them in real time without modification to the NetLinx program. i!-MacroManager is 

composed of a series of modules that allow users to create, edit, delete, execute and schedule 

macros from any NetLinx compatible touch panel.

 i!-MacroManager creates macros from the actions available through i!-ConnectLinx. Each macro 

can contain up to 50 actions. Each action can have an associated delay, set in 1/100-second 

increments, to handle time delays required between actions. The user can configure a macro 

execution button to execute any macro.

i!-MacroScheduler allows users to schedule NetLinx macros directly from any NetLinx compatible 

touch panel. i!-MacroScheduler provides a user interface for creating up to 240 scheduled events to 

run any available macro on a repeating or non-repeating basis. i!-MacroScheduler also provides a 

scheduling engine that will trigger each event at the appropriate time and reschedule repeating 

events.

i!-ConnectLinx provides the mechanism to expose actions to i!-MacroManager and to manage 

action execution on the NetLinx system. Once i!-MacroManager builds a macro from the actions in 

the i!-ConnectLinx action list, i!-MacroManager makes a request to i!-ConnectLinx to execute 

those actions. i!-ConnectLinx handles this request and presents it to the NetLinx program for 

execution.

Macro and Schedule Persistence

i!-MacroManager stores macros on the NetLinx master's file system in macro files. These files are 

located in the doc:\user\macros directory. You can use i!-MacroManager to create and delete 

macros.

i!-MacroManager does not store macros in memory, only on the file systems. If a macro is 

scheduled via i!-MacroScheduler and then the macro is deleted, the macro will fail to run since the 

macro no longer exists on the file system. Deleting macros will not delete all references to the 

macro, only the macro itself.

i!-MacroScheduler stores the schedule information in a file called MMSchedule.bin located in the 

doc:\user\schedule directory. All event information will be stored in this file and recalled during 

power up. Any event scheduled by the user is stored and will not be lost during a power cycle.

The scheduling engine will always attempt to read the MMSchedule.bin file on start up. If you are 

loading a new program containing macro scheduling into an old master that used to have macro 

scheduling, you should use FTP to browse the NetLinx master's file system and delete the old 

schedule file. Otherwise, the old scheduling information will be automatically loaded.

NetLinx Master firmware (build 130 or greater) supports up to 199 macros.

Summary of Contents for I!-MACROMANAGER

Page 1: ...instruction manual integration Solutions i MacroManager...

Page 2: ...any accompanying hardware This limited warranty gives you specific legal rights You may have others which vary from state country to state country NO LIABILITY FOR CONSEQUENTIAL DAMAGES In no event sh...

Page 3: ...acroEngineMod 4 Commands 4 Strings 5 i MacroEngineMod Module Definition 5 Parameters 5 Touch Panel Pages 5 Programming i MacroEditorMod 5 Commands 5 Parameters 6 Touch Panel Pages 10 Programming i Mac...

Page 4: ...ii i MacroManager Table of Contents i MacroSchedulerEditorMod Module Definition 17 Parameters 18 Touch Panel Pages 23...

Page 5: ...he i ConnectLinx action list i MacroManager makes a request to i ConnectLinx to execute those actions i ConnectLinx handles this request and presents it to the NetLinx program for execution Macro and...

Page 6: ...Introduction 2 i MacroManager...

Page 7: ...oManager and some simple examples appear in the i MacroManager test file For complete documentation on i ConnectLinx download the i ConnectLinx install from the AMX web site Once the i ConnectLinx pro...

Page 8: ...e This module manages the systems clock by synchronizing with Internet timeservers This module also provides sunrise and sunset information If you are including the i MacroSchedulerEngineMod module yo...

Page 9: ...device has 1 port with channels levels commands and strings like most other devices Commands i MacroEditorMod supports the following out bound commands master to device i MacroEngineMod Strings Comman...

Page 10: ...irtual device of the KeyboardMod module for editing text dvKB An array of touch panel base devices implementing i MacroEditorMod DEFINE_MODULE i MacroEditorMod mdlMMEdt vdvMacroEditor vdvMacroEngine v...

Page 11: ...variable text channels Macro Name nchMMMacroList An INTEGER array with the following buttons Macro Browser List Items 1 10 nvtMMMacroList An INTEGER array with the following variable text channels Mac...

Page 12: ...n Level Parameter Done Enumeration Level Parameter Abort Previous Parameter Next Parameter nvtMMParameterEdit An INTEGER array with the following variable text channels String Parameter Value Number P...

Page 13: ...Sub Sec Field nchMMStepList An INTEGER array with the following buttons Macro Step List Item 1 10 nvtMMStepList An INTEGER array with the following variable text channels Macro Step List Total Items...

Page 14: ...ems i ConnectLinx Action List Slider Level Code i ConnectLinx Action List Systems Name i ConnectLinx Action List Folder Name i ConnectLinx Action List Items Name 1 i ConnectLinx Action List Items Icon...

Page 15: ...s also use a channel code to trigger the execution of the macro and to provide feedback if the macro is running The programer can place the macro buttons anywhere on the touch panel allowing the user...

Page 16: ...ing buttons Add New Macro Save Macro Name To Preset Clear Macro Name From Preset nchMMExeMacroList An INTEGER array with the following buttons Macro Browser List Items 1 10 nvtMMExeMacroList An INTEGE...

Page 17: ...8 Unused 9 Total Event Slots 10 Available Slots 11 Next free Event index 12 Unused 13 Next Event to start 14 Next Event to stop 15 Total Events today 16 Events completed today 17 Number of current eve...

Page 18: ...through Start Count ordered by number GET PLIST Start Count Get list of today s past events from Start through Start Count ordered by time GET CLIST Start Count Get list of today s current events from...

Page 19: ...o Any valid macro file Command Description PAST Binary Event List String List of past event indexes CURRENT Binary Event List String List of current active event indexes FUTURE Binary Event List Strin...

Page 20: ...e of the i TimeManager module for sunrise and sunset information Touch Panel Pages i MacroEngineMod does not require any touch panel pages Programming i MacroSchedulerEditorMod i MacroSchedulerEditorM...

Page 21: ...rn off debug Default VERSION Send version information to master debug port master messaging DEFINE_MODULE i MacroSchedulerEditorMod mdlSchEdt vdvSchEditor vdvSchEngine vdvTmEvents vdvMacroEditor vdvKB...

Page 22: ...the Keyboard module for editing text dvKB An array of touch panel base devices implementing i MacroScheduler dvTPSch An array of touch panel devices implementing i MacroScheduler nchSchEventList An IN...

Page 23: ...ode Today s Event List Items 1 6 nchSchEngineListCtrl An INTEGER array with the following buttons Page Up Page Down Top of List End of List Slider Channel Code nvtSchEngineInfo An INTEGER array with t...

Page 24: ...xt channels Date Time Sunrise Time Sunset Time nchSchEventEdit An INTEGER array with the following buttons Edit Event New Event Delete Confirm Delete Event nvtSchEventEdit An INTEGER array with the fo...

Page 25: ...t Time Hour Start time Minute Start Time AM PM End time None End time Fixed End time Sunrise End time Sunset End time Before Sunrise End time Before Sunset End time After Sunrise End time After Sunset...

Page 26: ...ly Date Monthly Date Yearly nvtSchDateSelect An INTEGER array with the following variable text channels Daily Repeat Weekly Repeat Monthly Repeat Monthly Yearly Date of Month Monthly Yearly Day Occurr...

Page 27: ...of variable text channels codes for editing Date and Time parameters 37 channel codes see touch panel pages nchSchMacroList An INTEGER array with the following buttons Macro Browser List Items 1 10 nv...

Page 28: ...nthly SchDate SchYearly SchDate SchDateUS SchDate SchDateUK SchDate SchHourAMPM SchSelect SchHourMilitary SchSelect SchMinute SchSelect SchDay SchSelect SchMonth SchSelect SchYear SchSelect SchDateOcc...

Page 29: ...Programming i MacroManager 25 i MacroManager...

Page 30: ...of AMX Corporation AMX reserves the right to alter specifications without notice at any time In Canada doing business as Panja Inc DALLAS TEXAS LOS ANGELES CALIFORNIA MEXICO CITY MEXICO ONTARIO CANADA...

Reviews: