timer.h

/*
 * Copyright (C) 2026 Kamil Lulko <kamil.lulko@gmail.com>
 *
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * This file is part of oveRTOS.
 */
 
#ifndef OVE_TIMER_H
#define OVE_TIMER_H
 
#include "ove/types.h"
#include "ove_config.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef struct ove_timer *ove_timer_t;
 
typedef void (*ove_timer_fn)(ove_timer_t timer, void *user_data);
 
#include "ove/storage.h"
 
#ifdef CONFIG_OVE_TIMER
 
int  ove_timer_init(ove_timer_t *timer, ove_timer_storage_t *storage,
            ove_timer_fn callback, void *user_data,
            uint32_t period_ms, int one_shot);
 
void ove_timer_deinit(ove_timer_t timer);
 
/* _create / _destroy — heap-gated */
#ifdef OVE_HEAP_TIMER
 
int  ove_timer_create(ove_timer_t *timer, ove_timer_fn callback,
              void *user_data, uint32_t period_ms, int one_shot);
 
void ove_timer_destroy(ove_timer_t timer);
 
#elif !defined(__ZIG_CIMPORT__) /* !OVE_HEAP_TIMER — zero-heap mode */
 
#define ove_timer_create(ptimer, callback, user_data, period_ms, one_shot) \
    ({ static ove_timer_storage_t _ove_stor_; \
       ove_timer_init((ptimer), &_ove_stor_, (callback), (user_data), \
              (period_ms), (one_shot)); })
#define ove_timer_destroy(timer) ove_timer_deinit(timer)
 
#endif /* OVE_HEAP_TIMER */
 
int  ove_timer_start(ove_timer_t timer);
 
int  ove_timer_stop(ove_timer_t timer);
 
int  ove_timer_reset(ove_timer_t timer);
 
#else /* !CONFIG_OVE_TIMER */
 
static inline int  ove_timer_create(ove_timer_t *t, ove_timer_fn cb, void *ud, uint32_t p, int os) { (void)t; (void)cb; (void)ud; (void)p; (void)os; return OVE_ERR_NOT_SUPPORTED; }
static inline void ove_timer_destroy(ove_timer_t t) { (void)t; }
static inline int  ove_timer_start(ove_timer_t t) { (void)t; return OVE_ERR_NOT_SUPPORTED; }
static inline int  ove_timer_stop(ove_timer_t t) { (void)t; return OVE_ERR_NOT_SUPPORTED; }
static inline int  ove_timer_reset(ove_timer_t t) { (void)t; return OVE_ERR_NOT_SUPPORTED; }
 
#endif /* CONFIG_OVE_TIMER */
 
#ifdef __cplusplus
}
#endif
 
#endif /* OVE_TIMER_H */