Using the Scheduler agent

Use the Agents and Programming views to program this agent. The Scheduler agent lets you schedule time on the Control4 system to trigger specific events to occur. You can program a specific one-time event or multiple events to re-occur daily, weekly, monthly, yearly, etc. 

Example: Schedule an event to play dad’s favorite song at 7:30 AM on his birthday.

Prerequisites

The following devices are added and identified (with a network address) in the project:

  • Controller
  • Keypad

To set up the Scheduler agent:

  1. Start Composer Pro and connect to a Director.
  1. Click Agents.
  2. (First time only) In the Agents pane, click Add to add the Scheduler agent to the project.
  3. Select Scheduler in the Agents list, and click OK.
  4. In the Agents pane, select Scheduler. The Scheduler panes appear.
  1. In the Scheduler pane, click Add.
  2. In the New Event dialog, enter the relevant information for this Scheduler instance:
  1. In Name: type Dads Birthday.
  1. In Time, add the following:
  • Select the Time radio button.
  • Highlight the hour: 07, minutes: 30, and AM. Use the drop-down menu to select each time separately, or
  • Select Sunrise/Sunset, and select Sunrise from the drop-down menu.
  1. In Randomize time by +/-, keep the default of 15 minutes. This executes the Scheduler either 15 minutes before or 15 minutes after the actual time you assigned. This is useful when you go on vacation and you want your lights to go on at different times so outsiders think someone is home.
  1. In Start Date, select one of the following:
  • Select the Start on radio button. Use the drop-down menu and select today’s date.
  • Select the Start on the radio button to select an exact day, month, and year. Use the drop-down menus to make your selections.
  1. Select Repeats.
  • Select Yearly.

Example: You want dad’s favorite song to play at 7:30 AM. This dialog lets you schedule one-time events and recurring events.

  • Select Stop on, and use the drop-down menu to select a month and year to stop this agent.
  1. Click OK. The event is now added to the list of events.
  1. To delete an event, select the event in the list, and click Delete.
  1. Click Programming.
  2. In the Device Events pane, select the Scheduler object at the bottom of the list.
  3. In Scheduler Events, click Dads Birthday event. The Script pane shows Dads Birthday event.
  4. Select the device actions to initiate in the Actions panes.
  5. Drag the actions to the Script pane. These scripted actions execute when the Dad’s Birthday event executes.
  6. You can use the Scheduler agent in programming also to add conditionals or loops to your scripts.
  7. In the project tree, select 3 Button Keypad.
  1. In the Actions pane, scroll down and select the Scheduler agent.
  1. Click the Conditionals tab, select Time, and Within 5 minute(s) Before Sunset.
  1. Drag the blue question mark to the Script pane.
  1. In the project tree, select the light.
  1. In the Commands tab, select turn the room on, and drag the green arrow on top of the blue question mark in the Script pane.

Results: When the top button on the 3-Button Keypad is pressed, if it is within five minutes before sunrise, the light comes on. The Scheduler agent lets you define one-time events and recurring events.