OVE_*_DEFINE_STATIC Macros

One-step static primitive declaration with automatic initialisation. More...

Collaboration diagram for OVE_*_DEFINE_STATIC Macros:

Macros
#define	OVE_MUTEX_DEFINE_STATIC(name)
	Declare and auto-initialise a static mutex.
#define	OVE_RECURSIVE_MUTEX_DEFINE_STATIC(name)
	Declare and auto-initialise a static recursive mutex.
#define	OVE_SEM_DEFINE_STATIC(name, initial, max)
	Declare and auto-initialise a static semaphore.
#define	OVE_EVENT_DEFINE_STATIC(name)
	Declare and auto-initialise a static event object.
#define	OVE_CONDVAR_DEFINE_STATIC(name)
	Declare and auto-initialise a static condition variable.
#define	OVE_THREAD_DEFINE_STATIC(hname, stack_sz, fn, ctx, prio, tname)
	Declare and auto-initialise a static thread.
#define	OVE_QUEUE_DEFINE_STATIC(name, item_sz, max)
	Declare and auto-initialise a static message queue.
#define	OVE_TIMER_DEFINE_STATIC(name, cb, user_data, period_ms, one_shot)
	Declare and auto-initialise a static timer.
#define	OVE_EVENTGROUP_DEFINE_STATIC(name)
	Declare and auto-initialise a static event group.
#define	OVE_WORKQUEUE_DEFINE_STATIC(name, stack_sz, wq_name, prio)
	Declare and auto-initialise a static work queue.
#define	OVE_WORK_DEFINE_STATIC(name, handler)
	Declare and auto-initialise a static work item.
#define	OVE_STREAM_DEFINE_STATIC(name, buf_sz, trigger)
	Declare and auto-initialise a static stream buffer.
#define	OVE_WATCHDOG_DEFINE_STATIC(name, timeout_ms)
	Declare and auto-initialise a static watchdog timer.
#define	OVE_MODEL_DEFINE_STATIC(name, model_ptr, model_sz, arena_sz)
	Declare and auto-initialise a static ML model.
#define	OVE_I2C_DEFINE_STATIC(name, inst, spd)
	Declare and auto-initialise a static I2C bus.
#define	OVE_SPI_DEFINE_STATIC(name, cfg_ptr)
	Declare and auto-initialise a static SPI bus.
#define	OVE_UART_DEFINE_STATIC(name, rx_buf_sz, cfg_ptr)
	Declare and auto-initialise a static UART.
#define	OVE_I2S_DEFINE_STATIC(name, tx_dma_bytes, rx_dma_bytes, cfg_ptr)
	Declare and auto-initialise a static I2S bus with caller-supplied DMA buffers.
#define	OVE_NETIF_DEFINE_STATIC(name)
	Declare and auto-initialise a static network interface.
#define	OVE_SOCKET_DEFINE(name)   static ove_socket_storage_t name
	Declare a static socket storage variable named name.
#define	OVE_TLS_DEFINE_STATIC(name)
	Declare and auto-initialise a static TLS session.
#define	OVE_HTTP_CLIENT_DEFINE_STATIC(name)
	Declare and auto-initialise a static HTTP client.
#define	OVE_MQTT_CLIENT_DEFINE_STATIC(name)
	Declare and auto-initialise a static MQTT client.

Detailed Description

One-step static primitive declaration with automatic initialisation.

Each macro declares a handle, allocates the corresponding static storage, and registers a C constructor (__attribute__((constructor))) that initialises the handle before main(). No runtime init boilerplate is needed.

The constructor calls the corresponding _init() function with static storage in both heap and zero-heap modes — the macros perform a true static allocation regardless of build configuration.

Usage:

OVE_QUEUE_DEFINE_STATIC(my_q, sizeof(int), 8);
// my_q is ready to use in any function.

Macro Definition Documentation

OVE_MUTEX_DEFINE_STATIC

#define OVE_MUTEX_DEFINE_STATIC

(

name

)

Value:

    static ove_mutex_storage_t _##name##_storage;         \
    static ove_mutex_t name;                              \
    OVE_DEFINE_STATIC_CTOR_BEGIN_(name)                   \
    int _err = ove_mutex_init(&name, &_##name##_storage); \
    OVE_DEFINE_STATIC_CTOR_END_(name)

Declare and auto-initialise a static mutex.

Parameters

name	Variable name for the resulting ove_mutex_t handle.

OVE_RECURSIVE_MUTEX_DEFINE_STATIC

#define OVE_RECURSIVE_MUTEX_DEFINE_STATIC

(

name

)

Value:

    static ove_mutex_storage_t _##name##_storage;                   \
    static ove_mutex_t name;                                        \
    OVE_DEFINE_STATIC_CTOR_BEGIN_(name)                             \
    int _err = ove_recursive_mutex_init(&name, &_##name##_storage); \
    OVE_DEFINE_STATIC_CTOR_END_(name)

Declare and auto-initialise a static recursive mutex.

Parameters

name	Variable name for the resulting ove_mutex_t handle.

OVE_SEM_DEFINE_STATIC

#define OVE_SEM_DEFINE_STATIC	(		name,
			initial,
			max
	)

Value:

    static ove_sem_storage_t _##name##_storage;                           \
    static ove_sem_t name;                                                \
    OVE_DEFINE_STATIC_CTOR_BEGIN_(name)                                   \
    int _err = ove_sem_init(&name, &_##name##_storage, (initial), (max)); \
    OVE_DEFINE_STATIC_CTOR_END_(name)

Declare and auto-initialise a static semaphore.

Parameters

name	Variable name for the resulting ove_sem_t handle.
initial	Initial semaphore count.
max	Maximum semaphore count.

OVE_EVENT_DEFINE_STATIC

#define OVE_EVENT_DEFINE_STATIC

(

name

)

Value:

    static ove_event_storage_t _##name##_storage;         \
    static ove_event_t name;                              \
    OVE_DEFINE_STATIC_CTOR_BEGIN_(name)                   \
    int _err = ove_event_init(&name, &_##name##_storage); \
    OVE_DEFINE_STATIC_CTOR_END_(name)

Declare and auto-initialise a static event object.

Parameters

name	Variable name for the resulting ove_event_t handle.

OVE_CONDVAR_DEFINE_STATIC

#define OVE_CONDVAR_DEFINE_STATIC

(

name

)

Value:

    static ove_condvar_storage_t _##name##_storage;         \
    static ove_condvar_t name;                              \
    OVE_DEFINE_STATIC_CTOR_BEGIN_(name)                     \
    int _err = ove_condvar_init(&name, &_##name##_storage); \
    OVE_DEFINE_STATIC_CTOR_END_(name)

Declare and auto-initialise a static condition variable.

Parameters

name	Variable name for the resulting ove_condvar_t handle.

OVE_THREAD_DEFINE_STATIC

#define OVE_THREAD_DEFINE_STATIC	(		hname,
			stack_sz,
			fn,
			ctx,
			prio,
			tname
	)

Value:

    static ove_thread_storage_t _##hname##_storage;                                       \
    OVE_THREAD_STACK_DEFINE_(_##hname##_stack, stack_sz);                                 \
    static ove_thread_t hname;                                                            \
    OVE_DEFINE_STATIC_CTOR_BEGIN_(hname)                                                  \
    int _err = ove_thread_init(&hname, &_##hname##_storage, (tname), (fn), (ctx), (prio), \
                   (stack_sz), _##hname##_stack);                             \
    OVE_DEFINE_STATIC_CTOR_END_(hname)

Declare and auto-initialise a static thread.

Parameters

hname	Variable name for the resulting ove_thread_t handle.
stack_sz	Thread stack size in bytes.
fn	Thread entry function.
ctx	Argument passed to fn.
prio	Thread priority.
tname	Human-readable thread name string.

OVE_QUEUE_DEFINE_STATIC

#define OVE_QUEUE_DEFINE_STATIC	(		name,
			item_sz,
			max
	)

Value:

    static ove_queue_storage_t _##name##_storage;                                          \
    static uint8_t _##name##_buf[(item_sz) * (max)];                                       \
    static ove_queue_t name;                                                               \
    OVE_DEFINE_STATIC_CTOR_BEGIN_(name)                                                    \
    int _err = ove_queue_init(&name, &_##name##_storage, _##name##_buf, (item_sz), (max)); \
    OVE_DEFINE_STATIC_CTOR_END_(name)

Declare and auto-initialise a static message queue.

Parameters

name	Variable name for the resulting ove_queue_t handle.
item_sz	Size of each queue item in bytes.
max	Maximum number of items in the queue.

OVE_TIMER_DEFINE_STATIC

#define OVE_TIMER_DEFINE_STATIC	(		name,
			cb,
			user_data,
			period_ms,
			one_shot
	)

Value:

    static ove_timer_storage_t _##name##_storage;                                        \
    static ove_timer_t name;                                                             \
    OVE_DEFINE_STATIC_CTOR_BEGIN_(name)                                                  \
    int _err = ove_timer_init(&name, &_##name##_storage, (cb), (user_data), (period_ms), \
                  (one_shot));                                               \
    OVE_DEFINE_STATIC_CTOR_END_(name)

Declare and auto-initialise a static timer.

Parameters

name	Variable name for the resulting ove_timer_t handle.
cb	Timer expiry callback.
user_data	Opaque pointer forwarded to cb.
period_ms	Timer period in milliseconds.
one_shot	Non-zero for a one-shot timer, zero for periodic.

OVE_EVENTGROUP_DEFINE_STATIC

#define OVE_EVENTGROUP_DEFINE_STATIC

(

name

)

Value:

    static ove_eventgroup_storage_t _##name##_storage;         \
    static ove_eventgroup_t name;                              \
    OVE_DEFINE_STATIC_CTOR_BEGIN_(name)                        \
    int _err = ove_eventgroup_init(&name, &_##name##_storage); \
    OVE_DEFINE_STATIC_CTOR_END_(name)

Declare and auto-initialise a static event group.

Parameters

name	Variable name for the resulting ove_eventgroup_t handle.

OVE_WORKQUEUE_DEFINE_STATIC

#define OVE_WORKQUEUE_DEFINE_STATIC	(		name,
			stack_sz,
			wq_name,
			prio
	)

Value:

    static ove_workqueue_storage_t _##name##_storage;                                       \
    OVE_THREAD_STACK_DEFINE_(_##name##_stack, (stack_sz));                                  \
    static ove_workqueue_t name;                                                            \
    OVE_DEFINE_STATIC_CTOR_BEGIN_(name)                                                     \
    int _err = ove_workqueue_init(&name, &_##name##_storage, (wq_name), (prio), (stack_sz), \
                      _##name##_stack);                                         \
    OVE_DEFINE_STATIC_CTOR_END_(name)

Declare and auto-initialise a static work queue.

Parameters

name	Variable name for the resulting ove_workqueue_t handle.
stack_sz	Stack size in bytes for the work queue thread.
wq_name	Human-readable work queue name string.
prio	Thread priority for the work queue thread.

OVE_WORK_DEFINE_STATIC

#define OVE_WORK_DEFINE_STATIC	(		name,
			handler
	)

Value:

    static ove_work_storage_t _##name##_storage;                           \
    static ove_work_t name;                                                \
    OVE_DEFINE_STATIC_CTOR_BEGIN_(name)                                    \
    int _err = ove_work_init_static(&name, &_##name##_storage, (handler)); \
    OVE_DEFINE_STATIC_CTOR_END_(name)

Declare and auto-initialise a static work item.

Parameters

name	Variable name for the resulting ove_work_t handle.
handler	Work handler function invoked when the item is executed.

OVE_STREAM_DEFINE_STATIC

#define OVE_STREAM_DEFINE_STATIC	(		name,
			buf_sz,
			trigger
	)

Value:

    static ove_stream_storage_t _##name##_storage;                                             \
    static uint8_t _##name##_buf[(buf_sz) + 1];                                                \
    static ove_stream_t name;                                                                  \
    OVE_DEFINE_STATIC_CTOR_BEGIN_(name)                                                        \
    int _err = ove_stream_init(&name, &_##name##_storage, _##name##_buf, (buf_sz), (trigger)); \
    OVE_DEFINE_STATIC_CTOR_END_(name)

Declare and auto-initialise a static stream buffer.

Parameters

name	Variable name for the resulting ove_stream_t handle.
buf_sz	Stream buffer capacity in bytes.
trigger	Minimum bytes required before a blocked reader is unblocked.

OVE_WATCHDOG_DEFINE_STATIC

#define OVE_WATCHDOG_DEFINE_STATIC	(		name,
			timeout_ms
	)

Value:

    static ove_watchdog_storage_t _##name##_storage;                       \
    static ove_watchdog_t name;                                            \
    OVE_DEFINE_STATIC_CTOR_BEGIN_(name)                                    \
    int _err = ove_watchdog_init(&name, &_##name##_storage, (timeout_ms)); \
    OVE_DEFINE_STATIC_CTOR_END_(name)

Declare and auto-initialise a static watchdog timer.

Parameters

name	Variable name for the resulting ove_watchdog_t handle.
timeout_ms	Watchdog timeout in milliseconds.

OVE_MODEL_DEFINE_STATIC

#define OVE_MODEL_DEFINE_STATIC	(		name,
			model_ptr,
			model_sz,
			arena_sz
	)

Value:

    static ove_model_storage_t _##name##_storage;                                 \
    static uint8_t __attribute__((aligned(16))) _##name##_arena[(arena_sz)];      \
    static ove_model_t name;                                                      \
    OVE_DEFINE_STATIC_CTOR_BEGIN_(name)                                           \
    struct ove_model_config _cfg = {                                              \
        .model_data = (model_ptr),                                            \
        .model_size = (model_sz),                                             \
        .arena_size = (arena_sz),                                             \
    };                                                                            \
    int _err = ove_model_init(&name, &_##name##_storage, _##name##_arena, &_cfg); \
    OVE_DEFINE_STATIC_CTOR_END_(name)

Declare and auto-initialise a static ML model.

Parameters

name	Variable name for the resulting ove_model_t handle.
model_ptr	Pointer to the .tflite FlatBuffer data.
model_sz	Size of the FlatBuffer in bytes.
arena_sz	Tensor arena size in bytes (must be compile-time constant).

OVE_I2C_DEFINE_STATIC

#define OVE_I2C_DEFINE_STATIC	(		name,
			inst,
			spd
	)

Value:

    static ove_i2c_storage_t _##name##_storage;                \
    static ove_i2c_t name;                                     \
    OVE_DEFINE_STATIC_CTOR_BEGIN_(name)                        \
    struct ove_i2c_cfg _cfg = {                                \
        .instance = (inst),                                \
        .speed = (spd),                                    \
    };                                                         \
    int _err = ove_i2c_init(&name, &_##name##_storage, &_cfg); \
    OVE_DEFINE_STATIC_CTOR_END_(name)

Declare and auto-initialise a static I2C bus.

Parameters

name	Variable name for the resulting ove_i2c_t handle.
inst	Peripheral instance index.
spd	Bus speed (ove_i2c_speed_t).

OVE_SPI_DEFINE_STATIC

#define OVE_SPI_DEFINE_STATIC	(		name,
			cfg_ptr
	)

Value:

    static ove_spi_storage_t _##name##_storage;                    \
    static ove_spi_t name;                                         \
    OVE_DEFINE_STATIC_CTOR_BEGIN_(name)                            \
    int _err = ove_spi_init(&name, &_##name##_storage, (cfg_ptr)); \
    OVE_DEFINE_STATIC_CTOR_END_(name)

Declare and auto-initialise a static SPI bus.

Parameters

name	Variable name for the resulting ove_spi_t handle.
cfg_ptr	Pointer to a struct ove_spi_cfg.

OVE_UART_DEFINE_STATIC

#define OVE_UART_DEFINE_STATIC	(		name,
			rx_buf_sz,
			cfg_ptr
	)

Value:

    static ove_uart_storage_t _##name##_storage;                                      \
    static uint8_t _##name##_rx_buf[(rx_buf_sz)];                                     \
    static ove_uart_t name;                                                           \
    OVE_DEFINE_STATIC_CTOR_BEGIN_(name)                                               \
    int _err = ove_uart_init(&name, &_##name##_storage, _##name##_rx_buf, (cfg_ptr)); \
    OVE_DEFINE_STATIC_CTOR_END_(name)

Declare and auto-initialise a static UART.

Parameters

name	Variable name for the resulting ove_uart_t handle.
rx_buf_sz	RX buffer size in bytes (must be compile-time constant).
cfg_ptr	Pointer to a struct ove_uart_cfg.

OVE_I2S_DEFINE_STATIC

#define OVE_I2S_DEFINE_STATIC	(		name,
			tx_dma_bytes,
			rx_dma_bytes,
			cfg_ptr
	)

Value:

    static ove_i2s_storage_t _##name##_storage;                                            \
    static uint8_t __attribute__((aligned(4))) _##name##_tx_buf[(tx_dma_bytes)];           \
    static uint8_t __attribute__((aligned(4))) _##name##_rx_buf[(rx_dma_bytes)];           \
    static ove_i2s_t name;                                                                 \
    OVE_DEFINE_STATIC_CTOR_BEGIN_(name)                                                    \
    int _err = ove_i2s_init(&name, &_##name##_storage, _##name##_tx_buf, _##name##_rx_buf, \
                (cfg_ptr));                                                    \
    OVE_DEFINE_STATIC_CTOR_END_(name)

Declare and auto-initialise a static I2S bus with caller-supplied DMA buffers.

Emits a storage object, two 4-byte-aligned DMA byte arrays (tx_dma_bytes and rx_dma_bytes), and a handle. The constructor calls ove_i2s_init with all of them.

For a unidirectional configuration, pass 1 for the unused buffer's size — ove_i2s_init does not touch a buffer whose direction is disabled in cfg_ptr. The 1-byte placeholder keeps the array declaration valid (C does not allow zero-length arrays).

Parameters

name	Variable name for the resulting ove_i2s_t handle.
tx_dma_bytes	TX DMA buffer size in bytes (compile-time constant).
rx_dma_bytes	RX DMA buffer size in bytes (compile-time constant).
cfg_ptr	Pointer to a struct ove_i2s_cfg.

OVE_NETIF_DEFINE_STATIC

#define OVE_NETIF_DEFINE_STATIC

(

name

)

Value:

    static ove_netif_storage_t _##name##_storage;         \
    static ove_netif_t name;                              \
    OVE_DEFINE_STATIC_CTOR_BEGIN_(name)                   \
    int _err = ove_netif_init(&name, &_##name##_storage); \
    OVE_DEFINE_STATIC_CTOR_END_(name)

Declare and auto-initialise a static network interface.

The constructor only allocates the ove_netif_t handle and its storage; ove_netif_up() with a config must still be called by the application to bring the link up (DHCP vs static IP is a runtime decision).

Parameters

name	Variable name for the resulting ove_netif_t handle.

OVE_SOCKET_DEFINE

#define OVE_SOCKET_DEFINE

(

name

)

static ove_socket_storage_t name

Declare a static socket storage variable named name.

The socket family / type are decided at ove_socket_open() time, so this macro only produces the storage; the application supplies the handle and calls ove_socket_open(&handle, &storage, af, type).

OVE_TLS_DEFINE_STATIC

#define OVE_TLS_DEFINE_STATIC

(

name

)

Value:

    static ove_tls_storage_t _##name##_storage;         \
    static ove_tls_t name;                              \
    OVE_DEFINE_STATIC_CTOR_BEGIN_(name)                 \
    int _err = ove_tls_init(&name, &_##name##_storage); \
    OVE_DEFINE_STATIC_CTOR_END_(name)

Declare and auto-initialise a static TLS session.

The mbedTLS context structures are embedded in the storage; their internal allocations come from the CONFIG_OVE_NET_TLS_HEAP_SIZE static buffer (zero-heap mode) or the system allocator (heap mode).

Parameters

name	Variable name for the resulting ove_tls_t handle.

OVE_HTTP_CLIENT_DEFINE_STATIC

#define OVE_HTTP_CLIENT_DEFINE_STATIC

(

name

)

Value:

    static ove_http_client_storage_t _##name##_storage;         \
    static ove_http_client_t name;                              \
    OVE_DEFINE_STATIC_CTOR_BEGIN_(name)                         \
    int _err = ove_http_client_init(&name, &_##name##_storage); \
    OVE_DEFINE_STATIC_CTOR_END_(name)

Declare and auto-initialise a static HTTP client.

Response body and headers borrow into a buffer of CONFIG_OVE_NET_HTTP_MAX_RESPONSE bytes embedded in the storage (zero-heap mode); the borrow is valid until the next request.

Parameters

name	Variable name for the resulting ove_http_client_t handle.

OVE_MQTT_CLIENT_DEFINE_STATIC

#define OVE_MQTT_CLIENT_DEFINE_STATIC

(

name

)

Value:

    static ove_mqtt_client_storage_t _##name##_storage;         \
    static ove_mqtt_client_t name;                              \
    OVE_DEFINE_STATIC_CTOR_BEGIN_(name)                         \
    int _err = ove_mqtt_client_init(&name, &_##name##_storage); \
    OVE_DEFINE_STATIC_CTOR_END_(name)

Declare and auto-initialise a static MQTT client.

Per-connection RX/TX buffers (CONFIG_OVE_NET_MQTT_RX_BUF / CONFIG_OVE_NET_MQTT_TX_BUF) are embedded in the storage.

Parameters

name	Variable name for the resulting ove_mqtt_client_t handle.