Events and actions in programming
The driver's actions and events appear under its device in Crestron Home programming, on the Actions & Events screen.
Actions​
| Action | What it does |
|---|---|
setAway | Starts Vacation Mode. |
setHome | Stops Vacation Mode. |
toggleAway | Switches between the two. |
awayPassthrough | Raises awayPassthroughFired. |
homePassthrough | Raises homePassthroughFired, but only while Vacation Mode is on. |
The actions need a licence. Without one, the driver ignores them and notes it in the Activity tab. The A/V events aren't raised without a licence either.
A common use is a scene the family runs when they leave for a trip: add setAway to it, and the house
starts looking lived-in as they go. Add setHome to the scene they run when they get back. Avoid an everyday
Leave scene, or Vacation Mode starts every time someone goes to work.
Events​
| Event | When it fires |
|---|---|
awayModeSet | Vacation Mode has started, from the panel, the app or programming. |
homeModeSet | Vacation Mode has stopped. |
avEventAmStart / avEventAmEnd | The morning A/V window opens and closes. |
avEventPmStart / avEventPmEnd | The evening A/V window opens and closes. |
awayPassthroughFired / homePassthroughFired | Raised by the matching passthrough action. |
driverLoaded | The driver has started and read the room list. |
The A/V windows​
A lit house with no sound or flicker from a television can still look empty. The A/V events let programming switch a television or some music on and off at believable times.
| Window | Opens between | Lasts |
|---|---|---|
| Morning | 07:00 and 11:59 | 30 to 120 minutes |
| Evening | 16:00 and 19:59 | 30 to 120 minutes |
New times are drawn every midnight, so no two days are the same. The Events tab in Diagnostics & Setup shows today's times.
The A/V events fire whether or not Vacation Mode is on, so anything bound to them runs every day, including when the family is at home.
New times are also drawn when the driver starts. If the driver starts after a window's time has passed, that event doesn't fire that day.