docs-58297516d707/api/time_8h_source.html

#ifndef NEXUS_TIME_H

#define NEXUS_TIME_H


#include "nexus/core/status.h"

#ifdef __cplusplus

extern "C" {

#endif

typedef uint64_t nx_time_us_t;

#define NX_DEADLINE_NEVER UINT64_MAX


typedef struct {

    nx_time_us_t (*read)(void* context);

    void* context;

} nx_clock_t;


typedef struct {

    uint64_t ticks;

    uint32_t previous;

    uint32_t frequency_hz;

    bool initialized;

} nx_clock32_t;


nx_time_us_t nx_time_now_us(void);

bool nx_deadline_expired(nx_time_us_t deadline, nx_time_us_t now);

nx_time_us_t nx_deadline_after(nx_time_us_t now, uint64_t duration_us);

nx_result_t nx_clock32_initialize(nx_clock32_t* clock, uint32_t counter,

                                  uint32_t frequency_hz);

nx_result_t nx_clock32_observe(nx_clock32_t* clock, uint32_t counter,

                               nx_time_us_t* time_us);

#ifdef __cplusplus

}

#endif


#endif

status.h
Small vendor-independent result vocabulary.

nx_result_t
nx_result_t
Operation result; success at submission means admission only.
Definition status.h:21

nx_clock32_t
State for extending one 32-bit free-running hardware counter.
Definition time.h:34

nx_clock32_t::ticks
uint64_t ticks
Definition time.h:35

nx_clock32_t::frequency_hz
uint32_t frequency_hz
Definition time.h:37

nx_clock32_t::previous
uint32_t previous
Definition time.h:36

nx_clock32_t::initialized
bool initialized
Definition time.h:38

nx_clock_t
An explicitly injected clock; its context outlives all borrowers.
Definition time.h:26

nx_clock_t::read
nx_time_us_t(* read)(void *context)
Definition time.h:27

nx_clock_t::context
void * context
Definition time.h:28

nx_clock32_initialize
nx_result_t nx_clock32_initialize(nx_clock32_t *clock, uint32_t counter, uint32_t frequency_hz)
Initialize counter extension and its clock domain.

nx_deadline_expired
bool nx_deadline_expired(nx_time_us_t deadline, nx_time_us_t now)
Test an absolute deadline against a clock snapshot.

nx_time_now_us
nx_time_us_t nx_time_now_us(void)
Read the selected provider's monotonic clock.

nx_deadline_after
nx_time_us_t nx_deadline_after(nx_time_us_t now, uint64_t duration_us)
Add a duration without wrapping the monotonic domain.

nx_time_us_t
uint64_t nx_time_us_t
Microseconds in one boot/clock domain; no wall-clock semantics.
Definition time.h:20

nx_clock32_observe
nx_result_t nx_clock32_observe(nx_clock32_t *clock, uint32_t counter, nx_time_us_t *time_us)
Extend a wrapping counter and convert to microseconds.