ESPHome 2026.1.0-dev
Loading...
Searching...
No Matches
automation.cpp
Go to the documentation of this file.
1#include "automation.h"
2
3#include "esphome/core/log.h"
4
5#include <cinttypes>
6
7namespace esphome::time {
8
9static const char *const TAG = "automation";
10static const int MAX_TIMESTAMP_DRIFT = 900; // how far can the clock drift before we consider
11 // there has been a drastic time synchronization
12
13void CronTrigger::add_second(uint8_t second) { this->seconds_[second] = true; }
14void CronTrigger::add_minute(uint8_t minute) { this->minutes_[minute] = true; }
15void CronTrigger::add_hour(uint8_t hour) { this->hours_[hour] = true; }
16void CronTrigger::add_day_of_month(uint8_t day_of_month) { this->days_of_month_[day_of_month] = true; }
17void CronTrigger::add_month(uint8_t month) { this->months_[month] = true; }
18void CronTrigger::add_day_of_week(uint8_t day_of_week) { this->days_of_week_[day_of_week] = true; }
19bool CronTrigger::matches(const ESPTime &time) {
20 return time.is_valid() && this->seconds_[time.second] && this->minutes_[time.minute] && this->hours_[time.hour] &&
21 this->days_of_month_[time.day_of_month] && this->months_[time.month] && this->days_of_week_[time.day_of_week];
22}
24 ESPTime time = this->rtc_->now();
25 if (!time.is_valid())
26 return;
27
28 if (this->last_check_.has_value()) {
29 if (*this->last_check_ > time && this->last_check_->timestamp - time.timestamp > MAX_TIMESTAMP_DRIFT) {
30 // We went back in time (a lot), probably caused by time synchronization
31 ESP_LOGW(TAG, "Time has jumped back!");
32 } else if (*this->last_check_ >= time) {
33 // already handled this one
34 return;
35 } else if (time > *this->last_check_ && time.timestamp - this->last_check_->timestamp > MAX_TIMESTAMP_DRIFT) {
36 // We went ahead in time (a lot), probably caused by time synchronization
37 ESP_LOGW(TAG, "Time has jumped ahead!");
38 this->last_check_ = time;
39 return;
40 }
41
42 while (true) {
43 this->last_check_->increment_second();
44 if (*this->last_check_ >= time)
45 break;
46
47 if (this->matches(*this->last_check_))
48 this->trigger();
49 }
50 }
51
52 this->last_check_ = time;
53 if (!time.fields_in_range()) {
54 ESP_LOGW(TAG, "Time is out of range!");
55 ESP_LOGD(TAG, "Second=%02u Minute=%02u Hour=%02u DayOfWeek=%u DayOfMonth=%u DayOfYear=%u Month=%u time=%" PRId64,
56 time.second, time.minute, time.hour, time.day_of_week, time.day_of_month, time.day_of_year, time.month,
57 (int64_t) time.timestamp);
58 }
59
60 if (this->matches(time))
61 this->trigger();
62}
64void CronTrigger::add_seconds(const std::vector<uint8_t> &seconds) {
65 for (uint8_t it : seconds)
66 this->add_second(it);
67}
68void CronTrigger::add_minutes(const std::vector<uint8_t> &minutes) {
69 for (uint8_t it : minutes)
70 this->add_minute(it);
71}
72void CronTrigger::add_hours(const std::vector<uint8_t> &hours) {
73 for (uint8_t it : hours)
74 this->add_hour(it);
75}
76void CronTrigger::add_days_of_month(const std::vector<uint8_t> &days_of_month) {
77 for (uint8_t it : days_of_month)
78 this->add_day_of_month(it);
79}
80void CronTrigger::add_months(const std::vector<uint8_t> &months) {
81 for (uint8_t it : months)
82 this->add_month(it);
83}
84void CronTrigger::add_days_of_week(const std::vector<uint8_t> &days_of_week) {
85 for (uint8_t it : days_of_week)
86 this->add_day_of_week(it);
87}
89
91 rtc->add_on_time_sync_callback([this]() { this->trigger(); });
92}
93
94} // namespace esphome::time
void trigger(const Ts &...x)
Definition automation.h:204
void add_second(uint8_t second)
void add_minutes(const std::vector< uint8_t > &minutes)
void add_month(uint8_t month)
std::bitset< 8 > days_of_week_
Definition automation.h:38
void add_hour(uint8_t hour)
void add_day_of_month(uint8_t day_of_month)
void add_seconds(const std::vector< uint8_t > &seconds)
bool matches(const ESPTime &time)
void add_months(const std::vector< uint8_t > &months)
float get_setup_priority() const override
void add_days_of_month(const std::vector< uint8_t > &days_of_month)
std::bitset< 32 > days_of_month_
Definition automation.h:36
std::bitset< 61 > seconds_
Definition automation.h:33
CronTrigger(RealTimeClock *rtc)
void add_minute(uint8_t minute)
std::bitset< 24 > hours_
Definition automation.h:35
optional< ESPTime > last_check_
Definition automation.h:40
void add_days_of_week(const std::vector< uint8_t > &days_of_week)
void add_day_of_week(uint8_t day_of_week)
std::bitset< 60 > minutes_
Definition automation.h:34
std::bitset< 13 > months_
Definition automation.h:37
void add_hours(const std::vector< uint8_t > &hours)
The RealTimeClock class exposes common timekeeping functions via the device's local real-time clock.
void add_on_time_sync_callback(std::function< void()> &&callback)
ESPTime now()
Get the time in the currently defined timezone.
SyncTrigger(RealTimeClock *rtc)
uint8_t month
Definition date_entity.h:1
uint8_t second
uint8_t minute
uint8_t hour
const float HARDWARE
For components that deal with hardware and are very important like GPIO switch.
Definition component.cpp:80
A more user-friendly version of struct tm from time.h.
Definition time.h:15
uint8_t minute
minutes after the hour [0-59]
Definition time.h:21
uint8_t second
seconds after the minute [0-60]
Definition time.h:19
uint8_t hour
hours since midnight [0-23]
Definition time.h:23
time_t timestamp
unix epoch time (seconds since UTC Midnight January 1, 1970)
Definition time.h:37
uint16_t day_of_year
day of the year [1-366]
Definition time.h:29
bool is_valid() const
Check if this ESPTime is valid (all fields in range and year is greater than 2018)
Definition time.h:61
uint8_t day_of_month
day of the month [1-31]
Definition time.h:27
bool fields_in_range() const
Check if all time fields of this ESPTime are in range.
Definition time.h:64
uint8_t month
month; january=1 [1-12]
Definition time.h:31
uint8_t day_of_week
day of the week; sunday=1 [1-7]
Definition time.h:25