Generic ground-loadable table engine implementation. More...

#include "icarus/icarus.h"
#include <string.h>

Data Structures
struct	tbl_slot_t

Functions
static tbl_slot_t *	find_slot (tbl_id_t id)

void	__tbl_init (void)

bool	__tbl_register (const tbl_descriptor_t *desc)

bool	__tbl_load (tbl_id_t id, const uint8_t *data, uint16_t len, uint16_t schema_crc)

bool	__tbl_activate_prepare (tbl_id_t id, uint8_t out_data, uint16_t out_len, tbl_activate_fn *out_activate)
	Validate a staged table and copy it into a caller-provided scratch buffer for the activate callback.

bool	__tbl_activate_commit (tbl_id_t id, const uint8_t *data, uint16_t len)
	Commit a previously prepared table into the active buffer.

int16_t	__tbl_dump (tbl_id_t id, uint8_t *out, uint16_t max)

const tbl_descriptor_t *	__tbl_get_descriptor (tbl_id_t id)

uint8_t	__tbl_count (void)

Variables
static tbl_slot_t	registry [8]

static uint8_t	reg_count

Detailed Description

Generic ground-loadable table engine implementation.

Maintains a registry of up to TBL_MAX_REGISTERED table descriptors. Each registered table has a staging buffer and an active buffer (double-buffered swap):

tbl_load() — writes raw bytes to staging (chunked OK).
tbl_activate() — validates CRC, calls activate callback, copies staging → active on success.
tbl_dump() — returns the active buffer contents.

Registry, staging, and active buffers all live in DTCM_DATA_PRIV. Public access goes through SVC gates.

tbl_activate is split across two privileged calls so the user activate callback can run in thread mode between them:

__tbl_activate_prepare() — validate + copy staging into a caller-provided scratch buffer user activate(scratch) — runs in thread mode, no SVC __tbl_activate_commit() — copy scratch into active

The engine itself is silent — no logging dependency.

Author: Souham Biswas

Date: 2026

Copyright: Copyright 2025-2026 Souham Biswas https://github.com/ironhide23586/icarus-os-core Licensed under the Apache License, Version 2.0

Definition in file tables.c.

Function Documentation

◆ __tbl_activate_commit()

bool __tbl_activate_commit	(	tbl_id_t	id,
		const uint8_t *	data,
		uint16_t	len
	)

Commit a previously prepared table into the active buffer.

Called only after the user activate callback has succeeded.

< Maximum bytes per table buffer

Definition at line 176 of file tables.c.

References tbl_slot_t::active, tbl_slot_t::active_len, find_slot(), and TBL_MAX_SIZE.

Referenced by SVC_Handler_C(), and tbl_activate().

◆ __tbl_activate_prepare()

bool __tbl_activate_prepare	(	tbl_id_t	id,
		uint8_t *	out_data,
		uint16_t *	out_len,
		tbl_activate_fn *	out_activate
	)

Validate a staged table and copy it into a caller-provided scratch buffer for the activate callback.

The active buffer is not touched yet.

Parameters

id	Table id.
out_data	Caller scratch buffer (must be ≥ TBL_MAX_SIZE).
out_len	[out] Number of bytes written to scratch.
out_activate	[out] Pointer to the user activate callback (or NULL).