The schedules feature allows you to manage and modify functioning schedules of various devices that are connected in a building.

• View, modify, delete numeric, boolean, string or enum schedules as required. 

• Create Special Events. Using a calendar style interface, schedule single dates, date ranges or weekly schedules. 

While you have the ability to discover schedules implemented in your data source, you can also create new schedules in KODE OS and sync them with your data source. 

After discovery you will be able to change schedules in KODE OS and those will be written back to your BMS controller. (KODE OS to BMS). Depending on the driver, updating schedules on the BMS will also synchronize with KODE (BMS to KODE OS). Learn more about schedule functionalities that depend on the driver in this article. 

Create a New Schedule

1. Go to the Schedules feature from the left hand navigation bar.

2. On the first page you get to see the list of all existing schedules. To create a new schedule click on the “Create Schedule” button.

3. On the “Create New Schedule” popup box give the schedule a name, select the data source and select the schedule type:

1. Calendar Schedule

1. Create Special Events and reference them on each Weekly Schedule.

2. Weekly Schedule

1. Boolean Schedule

2. Numeric Schedule

3. Enum Schedule

4. String Schedule

4. Once you have chosen the schedule type hit on Save.

Calendar Schedule

You can add exceptions to a typical schedule week by creating Calendar Schedules that can be referenced in more than one individual schedule to control various devices. This makes it much easier to manage holidays and other exceptions. All that is necessary is to change the calendar schedule rather than changing the individual schedules.

1. Go to the Schedules feature from the left hand navigation bar.

2. On the first page you get to see the list of all existing schedules. To create a new schedule click on the “Create Schedule” button.
   

3. On the “Create New Schedule” popup box give the schedule a name, select the data source and select the schedule type - Calendar Schedule and then hit on Save.

You can expand the schedule to see the devices connected to it.

1. To add special events to the schedule click on the Edit button at the top right of the page and then click on “+ New Event”.

2. On the “Add Special Event” page you can add events such as New Year’s Day:

1. Select type - Date.

1. Weekday - Any

2. Day - 1

3. Month - January

4. Year - Any

1. Using the Any Year feature allows you to create a holiday every calendar year going forward.

You can use different types of dates and customize them to meet your use cases.

6. Click on Save to add the date. 

7. Once you have the list of exceptions and holidays click on Save to save the changes and you are done! Now you have created your holiday calendar that you can use in more than one schedule.
   
   

What’s Next?

Now you can go into all the individual schedules that you want to reference the holiday calendar and add it as an exception to the regular calendar.

1. Go to Schedules feature from the left hand navigation bar.

2. Search and select the schedule you want to add the holiday calendar to.

3. Go to the Special Events tab and click on the Edit button.

4. Click on the “+New Event” button.

5. On the Add Special Event page, give the event a name.

6. Select Type - Reference, from the reference drop down list select the Calendar Schedule you want to add to the selected schedule and click on Save.

7. The final thing to do here is to select the time slots for the dates that are listed in the holiday schedule. 

1. Clicking on Holiday schedule will open up a side calendar block, clicking on it will open a drop down menu from where you can Create a Custom Event or All Day Event to make sure that on the holidays listed in the holiday schedule your regular schedule will remain unoccupied/false all day.

2. Click on Save to add the dates as exceptions.

Weekly Schedule

To Create a Schedule for different devices that are connected in a building, follow the below steps:

1. Go to the Schedules feature from the left hand navigation bar.

2. On the first page you get to see the list of all existing schedules. To create a new schedule click on the “+ New Schedule” button.

3. On the “Create New Schedule” popup box give the schedule a name, select the data source and select the schedule type:

1. Weekly Schedule

1. Boolean Schedule - which represents a binary value with only two states, such as off or on.

2. Numeric Schedule - which represents a value, such as a temperature, level, rate or similar point numbers.

3. Enum Schedule - which represents an enumerated state, more than two states such as off, slow, and fast.

4. String Schedule - which represents one or more special characters.

4. Once you have chosen the schedule type hit on Save.

5. The schedule will be created and it will direct you to the Schedule view which is divided into three tabs (Weekly Schedule, Special Events, Properties). 

6. Click on the Edit Schedule button to adjust the schedule to your preference.
   
   

7. Weekly Schedule tab - in the first tab you will see the weekly schedule, where you can schedule the things that run common each week.

1. Clicking on the schedule block of each weekday it will open up a dropdown menu with three options: 

1. Create Event - add the start and end time of the event, select the output value (e.g. Occupied or UnOccupied) and click on Save.

2. All Day Event - if you want to add an all day event choose the All day event option and the output value you want to command devices with.

3. Clear Week - this option will clear the events created within the week calendar.

2. If you want to apply the same time slots for the whole week you simply click on the event and select apply Monday to Friday.

8. Special Events tab - you can add exceptions or holidays to a typical schedule week by creating Special Events.

1. To add special events to the schedule click on the Edit Schedule button at the top right of the page and then click on “+ New Event”.

2. On the “Add Special Event” page you can add events such as New Year’s Day:

1. Select type - Date.

1. Weekday - Any

2. Day - 1

3. Month - January

4. Year - Any

1. Using the Any Year feature allows you to create a holiday every calendar year going forward.

You can use different types of dates and customize them to meet your use cases.

3. Click on Save to add the date. 

4. Once you have the list of exceptions and holidays click on Save to save the changes.

5. The final thing to do here is to select the time slots for the dates that are listed in the holiday schedule. To do so click on the event you have created to open up the side calendar block, clicking on it will open a drop down menu from where you can Create a Custom Event or All Day Event to make sure that on the holidays your regular schedule will remain unoccupied/false all day.

6. Click on Save and you are done!

9. Properties tab - The schedule has a few configurable properties that can be used to modify the schedule details, set up the Effective Period (the start and end date the schedule will run), facets which will be displayed based on the type of the schedule.

1. In the Point Reference section you get to select the devices you want to be controlled by the schedule.

2. To pick points you want to reference in the schedule click on the “+ Add point reference” button.

1. On the “Apply Point References” popup box select the Area, Device Type and Field.

2. Click on Next and select the Points and Devices you want to reference to the schedule and click on the Apply Point Reference button.

3. Click on Save and you are done!
   

Points table

Once points are picked, they will get displayed on a table. The table has the below columns:

• Source slot

• Will get the default value as out

• Point

• Name of the point

• Device

• Name of the device

• Type

• Strong - the point reference is synced and saved on the data source. 

• Weak - the point reference can not be synced with the data source. However, the reference will be available on KODE OS.

• Target slot

• The default target is 16, however you can get target slots values from 1 to 16.

• At the far right of each point you have the ability to remove specific rows and devices by clicking on the Trash Can icon. 

Schedules History

You can view logs for each version you save and in case you need to refer or switch to earlier versions you can easily
 restore earlier versions. To do so follow these steps:

• Go to the Schedules feature from the left hand navigation bar.

• Search and select the schedule of your choice.

• Click on the History tab at the top right of the screen to see the version history.

• To revert to a previous version click on a timestamp and then click on Revert.

• The changes will be active immediately and pushed to the data source.

Discovering Schedules

1. Go to the Schedules feature from the left hand navigation bar.

2. To discover devices that have schedules set to them, click on the Discover Schedules button in the top right.

3. A list of schedules will appear.

4. Click on the schedule of your choice to adjust it. The option to edit Weekly Schedule, Special Events and Properties will be displayed.

1. All the changes made in schedules in KODE OS and those will be written back to the data source.