cs.h

Go to the documentation of this file.

 
#ifndef ICARUS_CS_H
#define ICARUS_CS_H
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include <stdint.h>
#include <stdbool.h>
 
/* ============================================================================
 * CONFIGURATION
 * ========================================================================= */
 
#ifndef CS_MAX_REGIONS
#define CS_MAX_REGIONS  8
#endif
 
/* ============================================================================
 * TYPES
 * ========================================================================= */
 
typedef void (*cs_mismatch_fn)(uint8_t region_idx, uint16_t expected,
                               uint16_t actual);
 
typedef struct {
    const uint8_t *addr;     
    uint32_t       size;     
    uint16_t       baseline; 
    bool           enabled;  
} cs_region_t;
 
/* ============================================================================
 * PUBLIC API
 * ========================================================================= */
 
void cs_init(void);
 
void cs_set_callback(cs_mismatch_fn fn);
 
bool cs_add_region(uint8_t idx, const uint8_t *addr, uint32_t size);
 
bool cs_enable(uint8_t idx, bool enabled);
 
bool cs_rebaseline(uint8_t idx);
 
uint8_t cs_check_all(void);
 
bool cs_get_region(uint8_t idx, cs_region_t *out);
 
uint8_t cs_region_count(void);
 
/* ============================================================================
 * PRIVILEGED IMPLEMENTATIONS (Internal — Do Not Call Directly)
 * ========================================================================= */
 
void    __cs_init(void);
void    __cs_set_callback(cs_mismatch_fn fn);
bool    __cs_add_region(uint8_t idx, const uint8_t *addr, uint32_t size);
bool    __cs_enable(uint8_t idx, bool enabled);
bool    __cs_rebaseline(uint8_t idx);
uint8_t __cs_check_all(void);
bool    __cs_get_region(uint8_t idx, cs_region_t *out);
uint8_t __cs_region_count(void);
 
#ifdef __cplusplus
}
#endif
 
#endif /* ICARUS_CS_H */