64 lines
1.7 KiB
C
64 lines
1.7 KiB
C
#pragma once
|
|
|
|
#include "esp_err.h"
|
|
#include <stdbool.h>
|
|
#include <stdint.h>
|
|
|
|
/* Schedule types */
|
|
typedef enum {
|
|
CRON_KIND_EVERY = 0, /* Recurring interval in seconds */
|
|
CRON_KIND_AT = 1, /* One-shot at unix timestamp */
|
|
} cron_kind_t;
|
|
|
|
/* A single cron job */
|
|
typedef struct {
|
|
char id[9]; /* 8-char hex ID + null */
|
|
char name[32];
|
|
bool enabled;
|
|
cron_kind_t kind;
|
|
uint32_t interval_s; /* For EVERY: interval in seconds */
|
|
int64_t at_epoch; /* For AT: unix timestamp */
|
|
char message[256]; /* Message to inject into inbound queue */
|
|
char channel[16]; /* Reply channel (default "system") */
|
|
char chat_id[32]; /* Reply chat_id (default "cron") */
|
|
int64_t last_run; /* Last run epoch */
|
|
int64_t next_run; /* Next run epoch */
|
|
bool delete_after_run; /* Remove job after firing (for AT jobs) */
|
|
} cron_job_t;
|
|
|
|
/**
|
|
* Initialize the cron service. Loads jobs from SPIFFS.
|
|
*/
|
|
esp_err_t cron_service_init(void);
|
|
|
|
/**
|
|
* Start the cron timer. Call after WiFi is connected and time is synced.
|
|
*/
|
|
esp_err_t cron_service_start(void);
|
|
|
|
/**
|
|
* Stop the cron timer.
|
|
*/
|
|
void cron_service_stop(void);
|
|
|
|
/**
|
|
* Add a new cron job.
|
|
* @param job Pointer to job struct (id will be generated)
|
|
* @return ESP_OK on success, ESP_ERR_NO_MEM if max jobs reached
|
|
*/
|
|
esp_err_t cron_add_job(cron_job_t *job);
|
|
|
|
/**
|
|
* Remove a cron job by ID.
|
|
* @param job_id 8-char job ID
|
|
* @return ESP_OK on success, ESP_ERR_NOT_FOUND if not found
|
|
*/
|
|
esp_err_t cron_remove_job(const char *job_id);
|
|
|
|
/**
|
|
* List all cron jobs.
|
|
* @param jobs Output array of job pointers
|
|
* @param count Output: number of jobs
|
|
*/
|
|
void cron_list_jobs(const cron_job_t **jobs, int *count);
|