ra8_ceu_api.h

Go to the documentation of this file.

 
#pragma once
 
#include <stdint.h>
 
#include "ra8_ceu_types.h"
#include "ra8_err.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
/* =============================================================================
 * Lifecycle
 * =============================================================================
 */

[[nodiscard]] ra8_err_t ra8_ceu_init(const ra8_ceu_config_t* cfg);

[[nodiscard]] ra8_err_t ra8_ceu_deinit(void);

[[nodiscard]] ra8_err_t ra8_ceu_reset(void);
 
/* =============================================================================
 * Status / IRQ
 * =============================================================================
 */

[[nodiscard]] ra8_err_t ra8_ceu_get_status(uint32_t* out_mask);

[[nodiscard]] ra8_err_t ra8_ceu_clear_status(uint32_t mask);

[[nodiscard]] ra8_err_t ra8_ceu_status_snapshot(ra8_ceu_status_t* out);

[[nodiscard]] ra8_err_t ra8_ceu_data_size_get(uint32_t* out_bytes);

[[nodiscard]] ra8_err_t ra8_ceu_interrupts_set(uint32_t mask);

[[nodiscard]] ra8_err_t ra8_ceu_attach_handler(ra8_ceu_event_fn_t fn, void* ctx);

void ra8_ceu_dispatch(void);
 
/* =============================================================================
 * Power transition
 * =============================================================================
 */

[[nodiscard]] ra8_err_t ra8_ceu_enter_stop(void);

[[nodiscard]] ra8_err_t ra8_ceu_exit_stop(void);
 
/* =============================================================================
 * Capture operation
 * =============================================================================
 */

[[nodiscard]] ra8_err_t ra8_ceu_capture_arm(uint8_t* buffer);

[[nodiscard]] ra8_err_t ra8_ceu_capture_start_ex(const ra8_ceu_buffers_t* bufs);

[[nodiscard]] ra8_err_t ra8_ceu_capture_disarm(void);
 
/* =============================================================================
 * Plane / firewall / byte-swap setters (live reconfig)
 * =============================================================================
 */

[[nodiscard]] ra8_err_t ra8_ceu_plane_b_program(const ra8_ceu_buffers_t* bufs);

[[nodiscard]] ra8_err_t ra8_ceu_plane_swap_force(void);

[[nodiscard]] ra8_err_t ra8_ceu_firewall_set(bool enable, uint32_t upper_bound);

[[nodiscard]] ra8_err_t ra8_ceu_byte_swap_set(const ra8_ceu_byte_swap_t* swap);

[[nodiscard]] ra8_err_t ra8_ceu_bundle_size_set(uint32_t size_bytes);

[[nodiscard]] ra8_err_t ra8_ceu_low_pass_set(bool enable);

[[nodiscard]] ra8_err_t ra8_ceu_capture_mode_set(ra8_ceu_capture_mode_t mode);

[[nodiscard]] ra8_err_t ra8_ceu_frame_drop_set(uint8_t count);
 
/* =============================================================================
 * DMA coupling helpers
 * =============================================================================
 */

[[nodiscard]] ra8_err_t
ra8_ceu_dma_pump(uint8_t channel, const uint8_t* src, uint8_t* dst, uint32_t bytes);
 
/* =============================================================================
 * Sweep 17: DMA-driven framebuffer + multi-frame capture
 * =============================================================================
 */

[[nodiscard]] ra8_err_t ra8_ceu_set_dma_buffer(uint8_t* buf, uint32_t len);

[[nodiscard]] ra8_err_t ra8_ceu_capture_start(uint32_t num_frames);

[[nodiscard]] ra8_err_t ra8_ceu_capture_stop(void);
 
#ifdef __cplusplus
}
#endif