woz_port.h

Fstatic inline void *woz_malloc(size_t size)

Allocate size bytes.

size

Number of bytes to allocate.

returns

Pointer to allocated memory, or NULL on failure.

Fstatic inline void *woz_calloc(size_t n, size_t size)

Allocate and zero-initialize n elements of size bytes each.

n

Number of elements.

size

Bytes per element.

returns

Pointer to allocated and zeroed memory, or NULL on failure.

Fstatic inline void woz_free(void *ptr)

Deallocate memory.

ptr

Pointer to memory to free (may be NULL).

Fstatic inline int64_t woz_uptime_us(void)

Monotonic microseconds since boot.

returns

Microseconds elapsed since system start.

Fstatic inline int64_t woz_uptime_ms(void)

Monotonic milliseconds since boot.

returns

Milliseconds elapsed since system start.

Fstatic inline void woz_sleep_ms(int32_t ms)

Sleep for a given number of milliseconds (host-test stub).

ms

milliseconds to sleep; ignored in deterministic host tests.

Fstatic inline void woz_sleep_us(int64_t us)

Sleep for a given number of microseconds (host-test stub).

us

microseconds to sleep; ignored in deterministic host tests.

Fstatic inline uint32_t woz_cycle_get_32(void)

Retrieve a 32-bit cycle counter with microsecond resolution.

returns

current uptime in microseconds, cast to uint32_t.

Ctypedef int woz_mutex_t

Opaque mutex type for host tests (single-threaded, no-op).

Fstatic inline void woz_mutex_init(woz_mutex_t *m)

Initialize a mutex (host-test stub).

m

pointer to mutex to initialize; no-op in single-threaded tests.

Fstatic inline void woz_mutex_lock(woz_mutex_t *m)

Acquire a mutex (host-test stub).

m

pointer to mutex to lock; no-op in single-threaded tests.

Fstatic inline void woz_mutex_unlock(woz_mutex_t *m)

Release a mutex (host-test stub).

m

pointer to mutex to unlock; no-op in single-threaded tests.