View source for Using Flags (no pictures)

== Question ==

'''What do Flags do in SmartMacros?'''

== Answer ==

===Important Note===
Problems running macros in X10 SmartMacros Software are often related to transceived house codes. Go into Tools-->Hardware Configuration, and make sure that the House Code for the motion sensor or remote control in question is checked in the lower right corner of the screen. Also, ensure that you run the Tools-->Download Timers and Macros command whenever you are done changing macros.

===What Flags Are===

SmartMacros adds two features to ActiveHome Pro: macro conditions and flags. Without conditions, macros always run when the interface receives the macro’s On or Off command. Some sample conditions are:

"It`s Nighttime" or "It`s Daytime AND It`s Friday."

Flags add global variables into your macro set-up. In computer programming, a global variable is one that can be accessed from any context in a program. Basically, flags let macros communicate with each other. You can have one macro set a flag, then add conditions to your other macros so they will run only if that flag is set. 

===Example===

====One Input, Two Actions====
Bob wants his MS16A ActiveEye outdoor motion sensor to sound a chime when he is home.  When he is away, he wants the same sensor to turn on two lights. 

Normally, Bob would only be able to do ''one'' of these two things since he only has one motion sensor. With Flags, Bob can essentially tell ActiveHome Pro when he is actually in the house and have his system behave differently depending on if he is Home or Away. 

Here is how he sets it up:

Bob's motion sensor is set to B1, his Chime is set to A4, and his two lights are set to A5 and A6. Bob also has a Slimline Switch set to B2 which he sticks on the wall near his front door. When Bob leaves his house, he hits B2 ON. When he returns, he hits B2 OFF.

First, Bob goes into the Tools menu and selects Preferences. In the SmartMacros tab, he makes sure that Simple or Advanced is checked, not Wizard. 

Next, Bob makes five macros (In this example, Bob is using Flag 4 to tell ActiveHome Pro that he is Home "Flag 4 Clear" or Away "Flag 4 Set")


*The first macro will tell ActiveHome Pro that Bob is Away: TRIGGER B2 ON // NO CONDITION // ACTION Set Flag 4
*The second macro will tell ActiveHome Pro that Bob is Home: TRIGGER B2 FF // NO CONDITION // ACTION ClearFlag 4
*The third macro is what Bob wants his motion sensor to do when he is Home: TRIGGER B1 ON // CONDITION: If Flag 4 is Off // ACTION Sound Chime at A4
*The fourth macro is what Bob wants his sensor to do when he is Away: TRIGGER B1 ON // CONDITION: If Flag 4 is On // ACTION A5 On, A6 On
*The last macro ensures that Bob's lights don't stay on all day: TRIGGER B1 OFF // NO CONDITION // ACTION A5 Off, A6 Off

====Conditional Timers====

Bob is happy with this, but he would also like his house to look and sound occupied when he is away. He builds some macros at unused house codes:

*M7 On // If Flag 4 Is On // A7 Light On 
*M7 Off // If Flag 4 Is On // A7 Light Off 
*M8 On // If Flag 4 Is On // A8 Radio On 
*M8 Off // If Flag 4 Is On // A8 Radio Off 

Instead of putting sensors or remotes at M7 and M8, Bob just builds Timers for these macros, scheduling a light and a radio to come on and off at certain times, but only if he is not home. You may want to click on View Advanced Layout in the Timer Designer to access the Security checkbox, which will make timers randomly vary by 20 minutes or so for a lived-in appearance.

====Multiple Camera Recording====

Here is a more complex script to automatically record 3 cameras based on motion sensors and not stop until motion ceases on all three cameras:

*A5 On // None //==> Flag 5: SET, Start Video Recording, Switch to Cam B5
*A6 On // None //==> Flag 6: SET, Start Video Recording, Switch to Cam B6
*A7 On // None //==> Flag 7: SET, Start Video Recording, Switch to Cam B7

*A5 Off // If Flags 6 and 7 are Off //==> Stop Video Recording, Set Flag 5 Off // ELSE If Flag 5 Is On// Flag 5: CLEAR
*A6 Off // If Flags 5 and 7 are Off //==> Stop Video Recording, Set Flag 6 Off // ELSE If Flag 6 Is On// Flag 6: CLEAR
*A7 Off // If Flags 5 and 6 are Off //==> Stop Video Recording, Set Flag 7 Off // ELSE If Flag 7 Is On// Flag 7: CLEAR

[[category: Software]]