ra8-firmware/ra8__i3c__i2c__internal_8h_source.html

#pragma once


#ifdef __cplusplus

extern "C" {

#endif


#include <stdint.h>


#include "ra8_attributes.h"

#include "ra8_err.h"

#include "ra8_i3c_i2c.h"

#include "ra8_i3c_i2c_regs.h"


typedef struct {

  ra8_i3c_i2c_complete_fn_t cb;

  void*                     ctx;

  bool                      initialized;

  bool                      bus_held;

} ra8_i3c_i2c_state_t;


extern ra8_i3c_i2c_state_t s_iic_b_state[k_ra8_i3c_i2c_channel_count];


RA8_PRIV

void priv_i3c_i2c_start(volatile r_i3c_i2c_regs_t* reg);


RA8_PRIV

void priv_i3c_i2c_stop(volatile r_i3c_i2c_regs_t* reg);


RA8_PRIV

void priv_i3c_i2c_clear_bst(volatile r_i3c_i2c_regs_t* reg);


RA8_PRIV

ra8_err_t priv_i3c_i2c_send_address(volatile r_i3c_i2c_regs_t* reg, uint8_t address_byte);


RA8_PRIV

bool priv_i3c_i2c_len_buf_invalid(uint32_t len, const void* buf);


RA8_PRIV

bool priv_i3c_i2c_should_dispatch(uint8_t mask, const void* cb);


#ifdef __cplusplus

}

#endif

ra8_attributes.h
Annotation-attribute framework macros for ra8-firmware.

RA8_PRIV
#define RA8_PRIV
Module-private helper: shared across TUs but only inside one library.
Definition ra8_attributes.h:219

ra8_err.h
Error Code Definitions for ra8-firmware.

ra8_err_t
ra8_err_codes_t ra8_err_t
Canonical error-return type used by every ra8-firmware API.
Definition ra8_err.h:546

s_iic_b_state
ra8_i3c_i2c_state_t s_iic_b_state[k_ra8_i3c_i2c_channel_count]
Per-channel state table indexed by channel.
Definition ra8_i3c_i2c.c:132

ra8_i3c_i2c.h
IIC_B (I3C unified IP, I2C-only mode) controller driver.

ra8_i3c_i2c_complete_fn_t
void(* ra8_i3c_i2c_complete_fn_t)(void *ctx, uint8_t err_mask)
Transfer-complete / error callback signature.
Definition ra8_i3c_i2c.h:100

priv_i3c_i2c_start
void priv_i3c_i2c_start(volatile r_i3c_i2c_regs_t *reg)
Issue a START condition on the given channel registers.
Definition ra8_i3c_i2c.c:277

priv_i3c_i2c_should_dispatch
bool priv_i3c_i2c_should_dispatch(uint8_t mask, const void *cb)
Pure predicate: non-zero error mask AND a non-NULL callback.
Definition ra8_i3c_i2c.c:96

priv_i3c_i2c_clear_bst
void priv_i3c_i2c_clear_bst(volatile r_i3c_i2c_regs_t *reg)
Clear all latched bus-status flags ahead of a new transaction.
Definition ra8_i3c_i2c.c:347

priv_i3c_i2c_len_buf_invalid
bool priv_i3c_i2c_len_buf_invalid(uint32_t len, const void *buf)
Pure predicate: non-zero length AND a NULL buffer pointer.
Definition ra8_i3c_i2c.c:76

priv_i3c_i2c_send_address
ra8_err_t priv_i3c_i2c_send_address(volatile r_i3c_i2c_regs_t *reg, uint8_t address_byte)
Send a single address byte and wait for TDBEF0 readiness.
Definition ra8_i3c_i2c.c:380

priv_i3c_i2c_stop
void priv_i3c_i2c_stop(volatile r_i3c_i2c_regs_t *reg)
Issue a STOP condition and clear the prior STOP-detect flag.
Definition ra8_i3c_i2c.c:325

ra8_i3c_i2c_regs.h
IIC_B (I3C-based I2C) register layout for the Renesas RA8D2.

k_ra8_i3c_i2c_channel_count
@ k_ra8_i3c_i2c_channel_count
HUM Ch 40.1.1, p 2445.
Definition ra8_i3c_i2c_regs.h:58

r_i3c_i2c_regs_t
Memory-mapped register block for one IIC_B / I3C channel.
Definition ra8_i3c_i2c_regs.h:89

ra8_i3c_i2c_state_t
Per-channel dispatch state shared across the driver's TUs.
Definition ra8_i3c_i2c_internal.h:41

ra8_i3c_i2c_state_t::bus_held
bool bus_held
True when the previous transaction returned with restart=true and the next call must inject a RESTART...
Definition ra8_i3c_i2c_internal.h:46

ra8_i3c_i2c_state_t::ctx
void * ctx
Callback context.
Definition ra8_i3c_i2c_internal.h:43

ra8_i3c_i2c_state_t::initialized
bool initialized
Tracks ra8_i3c_i2c_init / ra8_i3c_i2c_deinit.
Definition ra8_i3c_i2c_internal.h:44

ra8_i3c_i2c_state_t::cb
ra8_i3c_i2c_complete_fn_t cb
Callback or NULL.
Definition ra8_i3c_i2c_internal.h:42