Schedules¶
NF supports creating local BACnet schedule objects that automatically write values to target devices based on a weekly timetable.
Creating Schedules¶
Create schedules from the Schedules page in the management console. Specify a name and optionally an instance number (auto-assigned if omitted). After creation, edit the schedule to configure its weekly timetable and write targets.
Weekly Schedule¶
Each day of the week has a list of time-value transitions. At each specified time, the schedule's effective value changes. Supported value types include real numbers, integers, booleans, and enumerated values.
When no schedule entry matches the current time, the default value is used.
Write Targets¶
Schedules can automatically write their current value to one or more BACnet objects on local or remote devices. Configure targets in the Targets tab of the schedule editor.
Each target specifies:
- Device ID
- Object type and instance (e.g.,
analog-output:5) - Property to write (default: present-value)
Local targets (on the gateway) are written synchronously. Remote targets are written asynchronously with automatic retry.
Retry Behavior¶
Failed remote writes are retried with exponential backoff. Per-schedule settings control retry behavior:
| Setting | Default | Description |
|---|---|---|
| Max retries | 3 | Maximum retry attempts before marking target as failed |
| Backoff base | 2s | Initial retry delay; doubles each attempt (capped at 30s) |
The schedule worker evaluates the current value every 5 seconds and only writes to targets when the value changes.
Write Status¶
Monitor target write status via the management console or the
GetScheduleWriteStatus / GetAllScheduleWriteStatus API calls.
Each target reports one of:
- OK -- last write succeeded
- RETRYING -- write failed, retrying with backoff
- FAILED -- all retries exhausted
Additional Properties¶
| Property | Description |
|---|---|
| Effective period | Date range during which the schedule is active |
| Priority for writing | BACnet write priority (1-16) used for target writes |
| Exception schedule | Special dates that override the weekly schedule |
| Out of service | Disables the schedule when set |