Discover and manage time-based schedules in connected building systemsSchedules define how devices behave over time — when HVAC systems turn on, when lights dim, and when access doors lock. For integrations that support schedule management, KODE OS lets you discover, create, update, and delete schedules directly in the external system.
Schedule types
KODE OS supports two types of schedules.Weekly schedules
Weekly schedules define recurring routines for each day of the week. They are the foundation for regular building operations. Example: An HVAC system runs in Occupied mode Monday through Friday from 6 AM to 8 PM, and switches to Unoccupied mode during evenings and weekends. Weekly schedules can contain:- A single value per time slot (for example, a temperature setpoint or an on/off state)
- Different values for each day of the week
- Special event overrides that temporarily change the normal pattern
Calendar schedules
Calendar schedules handle exceptions and one-time events that override the regular weekly pattern. Use cases:- Holidays: Building closes on December 25 — all systems switch to holiday mode
- Maintenance windows: HVAC zone 3 shuts down Saturday 2–4 PM for filter replacement
- Temporary overrides: Conference room stays at 20°C for a special event on March 15
- Specific dates (for example, December 25, 2026)
- Date ranges (for example, December 23–27, 2026)
- Week and day patterns (for example, every third Monday)
Schedule values
Each schedule entry can hold a value of one of these types:
Schedules can also include point references, which link the schedule’s values directly to device points. When the schedule activates, the linked point receives the scheduled value.
Schedule operations
Discover schedules
For integrations that support it, you can discover schedules already configured in the external system. KODE OS queries the controller or system and retrieves available schedules.Create schedule
Create a new schedule in the external system from KODE OS. Specify the schedule type (weekly or calendar), set values for each time slot, and optionally link it to device points.Update schedule
Modify an existing schedule’s time slots, values, or point references. Changes are pushed to the external system immediately.Delete schedule
Remove a schedule from the external system. This action cannot be undone.Sync schedules
Synchronize schedule states between KODE OS and the external system. Sync keeps changes made in either system reflected in the other.Schedule workflow
Supported integrations
Schedule management is available for integrations that expose schedule APIs. Common integrations with full schedule support include:- Tridium Niagara — Weekly and calendar schedules with full create, read, update, and delete operations
- Distech BACnet — Schedule discovery and management via BACnet objects
- Other BMS controllers that expose schedule endpoints
Troubleshooting
Schedule changes are not reflected in the device
Schedule changes are not reflected in the device
Verify that the schedule is linked to the correct device points. If the schedule has point references, ensure those points exist and are active in the external system. Some controllers also use priority arrays where manual overrides take precedence over scheduled values.
Schedule discovery returns no results
Schedule discovery returns no results
Not all controller configurations expose schedules via their API. Verify that the controller has schedules configured and that the API credentials can read schedule objects. For BACnet systems, ensure the schedule objects are accessible at the configured BACnet device address.
Cannot create or update schedules
Cannot create or update schedules
Write operations require elevated permissions in the external system. Verify that the connector’s credentials have read-write access. Some integrations support schedule discovery (read-only) without supporting schedule creation or modification.