The Scheduler Server model holds the current state of the Scheduler Register, and performs scheduling of the configured actions. The model notifies appropriate Scene Server and Generic OnOff Server instances about actions in progress.
The Scheduler Server relies on the Time Server that is provided during initialization. However, it is the application that should handle the Time Server events and notify the Scheduler Server if the UTC time or the Time Zone have changed.
The Scheduler Server model adds two model instances in the composition data:
Scheduler Setup Server
The two model instances share the states of the Scheduler Server, but accept different messages. This allows for a fine-grained control of the access rights for the Scheduler Server states, as the two model instances can be bound to different application keys.
Scheduler Server manages the scheduled actions.
Scheduler Setup Server provides functionality for configuration and recalling of actions in the Scheduler Server’s Scheduler Register state.
The Scheduler models perform conversion of the configuration parameters from incoming client messages into international atomic time (TAI). The configuration parameters with calculated time closest to the current time are scheduled as actions. If an action requires rescheduling when the scheduled time has expired, the Scheduler Server calculates new time and repeats the scheduling procedure. However, the Scheduler Server skips configuration parameters not allowing to calculate the exact time of the action. Such actions will never be executed.
When the scheduled action is executed, the Scheduler Server sends a notification about the action in progress to appropriate Scene or OnOff Server instances, starting with the same element on which the Scheduler Server is present. The Scene or OnOff Server instances are notified until the Scheduler Server reaches another element with a Scheduler Server instance, or there are just no elements left. The Scene or OnOff Servers publish their states if the states have changed.
The application should notify the Scheduler Server if the Time Zone or the UTC time has changed, using the Scheduler Server API:
bt_mesh_scheduler_srv_time_update(): Notify server about UTC time or Time Zone changes
The Scheduler Server will recalculate time for the actions.
- Schedule Register:
The Scheduler Server model offers a Schedule Register that contains up to sixteen registered action entries.
Each entry has the following fields:
Year: 2 least significant digits of the year
2 least significant digits of the year
All other values
Month: Bitmask of the months in the year in which the scheduled event is enabled
Day: The day of the month the scheduled event occurs
Day of the month
Hour: The hour when the scheduled event occurs
Hour of the day (00 to 23 hours)
Any hour of the day
Once a day (at a random hour)
All other values
Minute: The minute when the scheduled event occurs
Minute of the hour (00 to 59)
Any minute of the hour
Every 15 minutes (minute modulo 15 is 0) (0, 15, 30, 45)
Every 20 minutes (minute modulo 20 is 0) (0, 20, 40)
Once an hour (at a random minute)
Second: The second when the scheduled event occurs
Second of the minute (00 to 59)
Any second of the minute
Every 15 seconds (second modulo 15 is 0) (0, 15, 30, 45)
Every 20 seconds (second modulo 20 is 0) (0, 20, 40)
Once a minute (at a random second)
DayOfWeek: Bitmask of the days of the week when the scheduled event is enabled
Action: Action to be executed for a scheduled event
Transition Time: Transition time for the action
Step count: 6 bits (range 0x00 to 0x3e)
Step resolution: 2 bits
Scene Number: Scene number to be used for the action
All other values
The Scheduler Server is implemented as a root model. When a Scheduler Server model is present on an element, the Scene Server model (see the Scene Server documentation) shall also be present on the same element.
The Scheduler Server stores the following information:
Any changes to the Schedule Register state
This information is used to restore previously configured register entries when the device powers up.
The scheduler operation depends on the availability of the updated current time provided by the Time Server.
It is the application’s responsibility to call
bt_mesh_scheduler_srv_time_update() after the current local
time has been updated to schedule available entries correctly.
- group bt_mesh_scheduler_srv
API for the Scheduler Server model.
Initialization parameters for Scheduler Server model.
_action_set_cb – [in] Action Set callback.
_time_srv – [in] Timer server that is used for action scheduling.
int bt_mesh_scheduler_srv_time_update(struct bt_mesh_scheduler_srv *srv)
Update time of the scheduled action.
srv – [in] Scheduler server model.
- Return values
0 – Successfully updated time of the ongoing action.
-EINVAL – Invalid parameters.
- #include <scheduler_srv.h>
Scheduler Server model instance
struct bt_mesh_scheduler_srv.[anonymous] [anonymous]
Model state related structure of the Scheduler Server instance.
void (*const action_set_cb)(struct bt_mesh_scheduler_srv *srv, struct bt_mesh_msg_ctx *ctx, uint8_t idx, struct bt_mesh_schedule_entry *entry)
Scheduler action set callback.
Called whenever the server receives an action set both ack or unack
This handler is optional.
- Param srv
[in] Scheduler server instance.
- Param ctx
[in] Context information about received message.
- Param idx
[in] Scheduler Register state index.
- Param entry
[in] Scheduler Register state entry.
- struct bt_mesh_scheduler_srv.[anonymous] [anonymous]
- BT_MESH_SCHEDULER_SRV_INIT(_action_set_cb, _time_srv)