About Macros

DR and Venue 2 receivers can be remotely controlled using commands sent over USB, a serial port, or a network port. An extensive command language is defined which is text-based and human readable. Touch panel controllers, for instance, use this command interface.

Macros are predefined groups of commands that are stored internally by a receiver frame. All of the commands contained in the macro can then be executed by issuing a single "run" command to the receiver frame. There are two advantages to this approach:

Macros are stored in nonvolatile memory. 64 macros are available, each with a maximum length of 64 command lines. Macros may be given a descriptive title which is stored along with the commands.

It is important to know that when a macro is run, the response messages normally returned when the commands are executed individually are discarded unless the command is marked as a verbose command (prefixed by a '!' (bang) character. This means that for non-verbose commands ill formed or unsuccessful commands fail silently, as the error message is discarded.

Macros can be chained if necessary, meaning that one macro can call another macro by virtue of containing a "run" command. It is important to know that a run command issued from within a macro will be delayed until after the first macro has finished running. In other words, macros aren't nested, they always run sequentially. The best practice when chaining macros is to make the "run" command the last command in a macro.

Wireless Designer contains a Macro Editor which is used to create new macros or edit existing ones. It also contains a Macro Recorder which allows a sequence of commands to be captured as a macro without typing them into the Macro Editor. The Macro Recorder works by capturing the commands generated by Wireless Designer when the mouse and keyboard are used to make changes to settings. It can be used in off-line sessions or while connected to a receiver.

A macro can be designated as the "Run on Power Up" macro, useful for initializing user-defined variables.

Follow the links below to learn more:

Using the Macro Editor

Using the Macro Recorder

Running Macros

"Run on Power Up" Macro

Backing Up and Restoring Macros