Real-Time Platform Configuration

Backend-defined one-shot real-time bring-up (ADR-035). More...

Files
file	src/oal/platform/sapi_platform.c
	Real-time platform configuration service: validates parameters, then dispatches to the backend registered via sapi_platform_register_backend() (ADR-005, ADR-035).

Functions
sapi_status_t	sapi_platform_realtime_init (uint32_t rt_priority)
	Applies the registered backend's real-time platform configuration for the calling process/thread. Call once at process startup, after the backend is registered and before any sapi_timer_* / sapi_task_* thread is created.

Detailed Description

Backend-defined one-shot real-time bring-up (ADR-035).

Function Documentation

sapi_platform_realtime_init()

sapi_status_t sapi_platform_realtime_init

(

uint32_t

rt_priority

)

Applies the registered backend's real-time platform configuration for the calling process/thread. Call once at process startup, after the backend is registered and before any sapi_timer_* / sapi_task_* thread is created.

Parameters

rt_priority

Desired real-time scheduling priority, 0..99. 0 requests memory-residency configuration only, with no change to scheduling policy/priority. Values are clamped by the backend to the target's supported range.

Returns

SAPI_STATUS_INVALID_PARAM if rt_priority > 99. SAPI_STATUS_NOT_INITIALIZED if no backend is registered. SAPI_STATUS_NOT_SUPPORTED if a backend is registered but does not implement this operation. SAPI_STATUS_OK otherwise - including when the backend could only partially apply the requested configuration (REQ-OAL-PLATFORM-001).

REQ-OAL-PLATFORM-010

Definition at line 47 of file sapi_platform.c.