Open topic with navigation

Create a Macro

  1. To create a new macro, click the Create Macro button located in the toolbar or right-click on Macros in the Browser and select "Create Macro" from the context menu. The new macro will list in the Browser and the Macro workspace displays.
  2. Drag and drop an action from the Actions list into the Macro workspace to create steps for the macro. Filter the actions by Object Type using the drop down list. Depending on the action selected, additional filtering of the space and object selection may be required.
  3. The Select Action Object dialog is provided to choose the specific object that will be affected by the macro step. The affected space can be filtered which also filters the available objects related to the selected space. Select the space, and then the object from the available list. With the new macro step still selected, you may review and change its properties from the Property Editor.

    4. Note: In this example, the macro action is "Preset Activate (LTP)". Filter by space then select the preset that will be activated when the macro is executed (run).


  4. Add additional actions (steps) to the macro as desired, specifying the space and objects completely.

    5. Note: Macros will execute their steps in top-down or numeric order. For example, step one will execute first, followed by step two, etc., until the final step has been performed. This is true unless a "Link Macro" or "Condition" is specified in the steps which may alter the order. At any time you may change the order of step execution in the macro by clicking the step and dragging it to the desired place within the Macro workspace.

Delete a Macro Step 

To delete a macro step, hover your mouse over the step to be deleted and click the red "X" located on the right side of the title block.

Add a Macro Condition

A macro condition is a feature in the Macro view that allows you to design a complex macro, adding an action or set of actions that are executed only "If" certain criteria are met. To use a condition in the macro steps, drag the condition from the "Conditions" list and drop it beneath the desired macro step.

With the Condition still selected, you may review and change its properties from the Property Editor. You can also drag and drop additional actions from the Action list into the Condition. Set the condition parameters in the Property Editor. When the condition is fully defined, continue building the steps for the macro.

Macro Toggle On/Off

Macros can possess a toggle state and have unique steps assigned to both the "On" and "Off" states. When a toggled macro is executed the first time, the "on" steps will be performed. When the macro is executed a second time, the "off" steps will be performed. You may also assign a button to play specifically the "On" or "Off" steps of a macro.

The advantage of creating a toggle macro instead of creating two separate macros is that any button assigned as a macro toggle can also be configured to reflect the macro state on the station LEDs. This feature allows you to activate the macro "On" steps from one location and the "Off" steps from another.

  1. To create a toggle behavior for an existing macro, select a macro from the Macros list in the Browser and click the Allow Toggle On/Off button located in the toolbar. Notice the Macro workspace changes to reflect two tabs showing the "On Steps" and the "Off Steps".

    Tip: When "Allow Toggle On / Off" is enabled, additional views (side by side, stacked, or the default tab view) are available to display the On/Off steps in the Macro workspace. See "Macro Editor Toolbars".

  2. Specify a different set of actions or conditions for both the "On Steps" and the "Off Steps" on their specific tabs. Use the Property Editor to rename the macro and to change any of the macro properties including the display color, priority, space affected, and the actions.

Add Macro Controls

Drag and drop a macro control from the "Macro Controls" list into the macro steps. Two macro control options are available including; "Delay Macro" and "Link in Macro".

Delay Macro

The delay macro feature allows you to specify a delay time before the next step in the macro is performed. For instance, when preset activations are placed in a macro back to back, the presets will not finish the fades before the next one plays unless you specify a delay between each preset, set for at least as long as the preset fade time.

  1. Drag the "Delay Macro" control into the Macro workspace.
  2. Set the parameters of the control in the Property Editor.

Link in Macro

The link in macro feature allows linking to a specific macro step in a looping or conditional macro. For instance, if the macro is written to toggle open a wall partition then run a looping series of presets. Adding a "Link In Macro" control as the last step in the macro and setting the property to "Jump to step 2", bypasses the wall toggle step.