Module-stop (MSTP) shadow + address->bit gate table (engine-free half). More...

#include <stdint.h>
#include "board_periph_mstp_internal.h"
#include "ra8_attributes.h"
#include "ra8_mstp_regs.h"

Include dependency graph for board_periph_mstp_model.c:

Data Structures
struct	mstp_family_t
	One strided family of peripheral instances sharing a mapping shape. More...

Enumerations
enum	mstp_dim_t : uint32_t { k_mstp_reg_count = 5U , k_mstp_bytes_per_reg = 4U , k_mstp_byte_bits = 8U , k_mstp_byte_mask = 0xFFU , k_mstp_id_reg_shift = 8U , k_mstp_id_bit_mask = 0xFFU }
	Shadow-array dimensions + bit-field packing constants. More...
enum	mstp_reset_t : uint32_t { k_mstp_reset_a = 0xFFFFFFF0U , k_mstp_reset_rest = 0xFFFFFFFFU }
	Per-register reset values: all peripheral bits stopped (HUM 11.2.6). More...
enum	mstp_family_base_t : uint64_t { k_mstp_base_sci = 0x40358000UL , k_mstp_base_spi = 0x4035C000UL , k_mstp_base_riic = 0x4025E000UL , k_mstp_base_i3c = 0x4035F000UL , k_mstp_base_agt = 0x40221000UL , k_mstp_base_gpt = 0x40322000UL , k_mstp_base_ulpt = 0x40220000UL , k_mstp_base_dac = 0x40233000UL , k_mstp_base_ssie = 0x4025D000UL , k_mstp_base_poeg = 0x40212000UL , k_mstp_base_canfd0 = 0x40380000UL , k_mstp_base_canfd1 = 0x40382000UL , k_mstp_base_cac = 0x40202400UL , k_mstp_base_crc = 0x40310000UL , k_mstp_base_doc = 0x40311000UL , k_mstp_base_ceu = 0x40348000UL , k_mstp_base_pdm = 0x40256000UL , k_mstp_base_adc = 0x40338000UL , k_mstp_base_sdhi = 0x40252000UL , k_mstp_base_xspi = 0x40268000UL , k_mstp_base_drw = 0x40444000UL }
	Peripheral-family register-window bases (RA8D2 peripheral memory map). More...
enum	mstp_family_span_t : uint64_t { k_mstp_chan_stride = 0x100UL , k_mstp_span_i3c = 0x214UL , k_mstp_span_canfd = 0x1920UL , k_mstp_span_cac = 0x10UL , k_mstp_span_crc = 0x20UL , k_mstp_span_doc = 0x20UL , k_mstp_span_pdm = 0x400UL , k_mstp_span_adc = 0x2224UL , k_mstp_span_sdhi = 0x200UL , k_mstp_span_xspi = 0x200UL , k_mstp_span_drw = 0x104UL }
	Per-family instance stride / single-instance window span (bytes). More...
enum	mstp_family_count_t : uint32_t { k_mstp_count_1 = 1U , k_mstp_count_2 = 2U , k_mstp_count_3 = 3U , k_mstp_count_4 = 4U , k_mstp_count_10 = 10U , k_mstp_count_14 = 14U }
	Instance counts per family (channels with a module-stop bit). More...

Functions
static const mstp_family_t *	internal_mstp_family_for_addr (uint64_t addr, uint32_t *out_idx)
	Resolve `addr` to the family + instance index that owns it.
static bool	internal_mstp_bit_set (uint16_t id)
	True iff the module-stop bit `id` (packed ra8_mstp_t) reads set.
void	priv_board_mstp_reset (void)
	Restore `MSTPCRA`..MSTPCRE to their all-stopped reset values.
void	priv_board_mstp_apply_write (uint64_t off, unsigned size, uint32_t value)
	Apply a firmware write to the `MSTPCRA`..MSTPCRE shadow.
uint32_t	priv_board_mstp_read_reg (uint64_t off, unsigned size)
	Read the tracked `MSTPCRA`..MSTPCRE shadow (the read-back path).
bool	priv_board_mstp_addr_stopped (uint64_t addr)
	Report whether the peripheral instance owning `addr` is module-stopped.
void	priv_board_mstp_note_gated_access (uint64_t addr, bool is_write)
	Record that an MMIO access to a module-stopped peripheral was dropped.
uint32_t	priv_board_mstp_gated_read_count (void)
	Number of reads zeroed because their peripheral was module-stopped.
uint32_t	priv_board_mstp_gated_write_count (void)
	Number of writes dropped because their peripheral was module-stopped.
const char *	priv_board_mstp_last_gated_name (void)
	Label of the peripheral whose access was most recently gated off.

Variables
static uint32_t	s_mstpcr [k_mstp_reg_count]
	MSTPCRA..E live values.
static uint32_t	s_gated_reads
	Reads zeroed (peripheral off).
static uint32_t	s_gated_writes
	Writes dropped (periph off).
static const char *	s_last_gated = "-"
	Label of last gated access.
static const uint16_t	s_k_ids_sci []
	SCI0..SCI9 (0x40358000, 0x100 stride) – MSTPCRB31..22, HUM 11.2.7.
static const uint16_t	s_k_ids_spi []
	SPI0..SPI1 (0x4035C000, 0x100 stride) – MSTPCRB19..18, HUM 11.2.7.
static const uint16_t	s_k_ids_riic []
	IIC0..IIC2 / RIIC (0x4025E000, 0x100 stride) – MSTPCRB9..7, HUM 11.2.7.
static const uint16_t	s_k_ids_i3c [] = {(uint16_t)k_ra8_mstp_i3c}
	I3C0 (0x4035F000) – MSTPCRB4, HUM 11.2.7.
static const uint16_t	s_k_ids_agt []
	AGT0..AGT1 (0x40221000, 0x100 stride) – MSTPCRD5..4, HUM 11.2.9.
static const uint16_t	s_k_ids_gpt []
	GPT0..GPT13 (0x40322000, 0x100 stride) – MSTPCRE31..18, GPT4..9 share MSTPE27, HUM 11.2.10.
static const uint16_t	s_k_ids_ulpt []
	ULPT0..ULPT1 (0x40220000, 0x100 stride) – MSTPCRE9..8, HUM 11.2.10.
static const uint16_t	s_k_ids_dac []
	DAC_B0..DAC_B1 (0x40233000, 0x100 stride) – MSTPCRD20..19, HUM 11.2.9.
static const uint16_t	s_k_ids_ssie []
	SSIE0..SSIE1 (0x4025D000, 0x100 stride) – MSTPCRC8..7, HUM 11.2.8.
static const uint16_t	s_k_ids_poeg []
	POEG group A..D (0x40212000, 0x100 stride) – MSTPCRD14..11, HUM 11.2.9.
static const uint16_t	s_k_ids_canfd0 [] = {(uint16_t)k_ra8_mstp_canfd0}
	CANFD0 (0x40380000) – MSTPCRC27, HUM 11.2.8.
static const uint16_t	s_k_ids_canfd1 [] = {(uint16_t)k_ra8_mstp_canfd1}
	CANFD1 (0x40382000) – MSTPCRC26, HUM 11.2.8.
static const uint16_t	s_k_ids_cac [] = {(uint16_t)k_ra8_mstp_cac}
	CAC (0x40202400) – MSTPCRC0, HUM 11.2.8.
static const uint16_t	s_k_ids_crc [] = {(uint16_t)k_ra8_mstp_crc}
	CRC (0x40310000) – MSTPCRC1, HUM 11.2.8.
static const uint16_t	s_k_ids_doc [] = {(uint16_t)k_ra8_mstp_doc}
	DOC (0x40311000) – MSTPCRC13, HUM 11.2.8.
static const uint16_t	s_k_ids_ceu [] = {(uint16_t)k_ra8_mstp_ceu}
	CEU (0x40348000) – MSTPCRC16, HUM 11.2.8.
static const uint16_t	s_k_ids_pdm [] = {(uint16_t)k_ra8_mstp_pdmif}
	PDM-IF (0x40256000) – MSTPCRC24, HUM 11.2.8.
static const uint16_t	s_k_ids_adc [] = {(uint16_t)k_ra8_mstp_adc16h}
	ADC_B (0x40338000) – MSTPCRD21, HUM 11.2.9.
static const uint16_t	s_k_ids_sdhi [] = {(uint16_t)k_ra8_mstp_sdhi0}
	SDHI0 (0x40252000) – MSTPCRC12, HUM 11.2.8.
static const uint16_t	s_k_ids_xspi [] = {(uint16_t)k_ra8_mstp_ospi0}
	XSPI0 / OSPI0 (0x40268000) – MSTPCRB16, HUM 11.2.7.
static const uint16_t	s_k_ids_drw [] = {(uint16_t)k_ra8_mstp_drw}
	DRW / D-AVE 2D (0x40444000) – MSTPCRC6, HUM 11.2.8.
static const mstp_family_t	s_k_families []
	The gate table: every module-stop-gated modelled peripheral instance.

Detailed Description

Module-stop (MSTP) shadow + address->bit gate table (engine-free half).

Owns the five MSTPCRA..MSTPCRE words the RA8D2 uses to clock-gate every peripheral (R_MSTP at 0x4020_3000 – HUM Ch 11.2.6..11.2.10 p 443-450) and the table that maps a peripheral register address to the module-stop bit that governs it. priv_board_mstp_addr_stopped answers the one question the ra8_emulator core asks per MMIO access: "is the peripheral that owns this address currently unclocked?" – and if so the core reads 0 / drops the write, matching silicon.

This translation unit deliberately takes NO Unicorn dependency: it is pure state + arithmetic, so the gate table is unit-tested directly on the host (tests/misc/src/test_ra8_emulator_mstp_gate.c) rather than only through a full emulation run. The board_periph block glue that needs the engine (register window ownership, reset hook, end-of-run report) is the separate board_periph_mstp.c.

Gate table scope

An entry exists for each modelled peripheral instance that (a) has a module-stop bit and (b) is answered by an OWNING board_periph block, so that gating it has an observable effect. Peripherals with no module-stop control (GPIO/PORT, ICU, SYSC), memory controllers (SRAM/MRAM), always-on blocks (WDT), the observe-only snoops (GLCDC, PRCR) and the delicate shared/loop families (DMAC+DTC on MSTPA22/23, the R-Switch Ethernet cluster, the USB self-loop model) are intentionally NOT gated here and answer as before; each is a documented deferral rather than an implicit gap. The bit for every entry is taken from ra8_mstp_regs.h (k_ra8_mstp_*), whose per-bit HUM citations are the source of truth.

Copyright: Copyright (c) 2026 Brighton Sikarskie SPDX-License-Identifier: MIT

Since: 0.1.0

Definition in file board_periph_mstp_model.c.

Enumeration Type Documentation

◆ mstp_dim_t

enum mstp_dim_t : uint32_t

Shadow-array dimensions + bit-field packing constants.

Enumerator
k_mstp_reg_count	MSTPCRA..MSTPCRE.
k_mstp_bytes_per_reg	32-bit registers.
k_mstp_byte_bits	Bits per byte.
k_mstp_byte_mask	Low-byte mask.
k_mstp_id_reg_shift	ra8_mstp_t: reg in bits 15:8.
k_mstp_id_bit_mask	ra8_mstp_t: bit in bits 7:0.

Definition at line 45 of file board_periph_mstp_model.c.

◆ mstp_family_base_t

enum mstp_family_base_t : uint64_t

Peripheral-family register-window bases (RA8D2 peripheral memory map).

Enumerator
k_mstp_base_sci	SCI0 (SCI family base).
k_mstp_base_spi	SPI0 (SPI_B family base).
k_mstp_base_riic	IIC0 (RIIC family base).
k_mstp_base_i3c	I3C0.
k_mstp_base_agt	AGT0 (AGT family base).
k_mstp_base_gpt	GPT0 (GPT family base).
k_mstp_base_ulpt	ULPT0 (ULPT family base).
k_mstp_base_dac	DAC_B0 (DAC family base).
k_mstp_base_ssie	SSIE0 (SSIE family base).
k_mstp_base_poeg	POEG group A (POEG base).
k_mstp_base_canfd0	CANFD0.
k_mstp_base_canfd1	CANFD1.
k_mstp_base_cac	CAC.
k_mstp_base_crc	CRC.
k_mstp_base_doc	DOC.
k_mstp_base_ceu	CEU.
k_mstp_base_pdm	PDM-IF.
k_mstp_base_adc	ADC_B.
k_mstp_base_sdhi	SDHI0.
k_mstp_base_xspi	XSPI0.
k_mstp_base_drw	DRW / D-AVE 2D.

Definition at line 198 of file board_periph_mstp_model.c.

◆ mstp_family_count_t

enum mstp_family_count_t : uint32_t

Instance counts per family (channels with a module-stop bit).

Enumerator
k_mstp_count_1	Single-instance peripheral.
k_mstp_count_2	SPI/AGT/ULPT/DAC/SSIE (two).
k_mstp_count_3	RIIC (three channels).
k_mstp_count_4	POEG (four groups).
k_mstp_count_10	SCI (ten channels).
k_mstp_count_14	GPT (fourteen channels).

Definition at line 238 of file board_periph_mstp_model.c.

◆ mstp_family_span_t

enum mstp_family_span_t : uint64_t

Per-family instance stride / single-instance window span (bytes).

Enumerator
k_mstp_chan_stride	Channel stride (also CEU window).
k_mstp_span_i3c	I3C window (through BCST).
k_mstp_span_canfd	CANFD channel window.
k_mstp_span_cac	CAC register window.
k_mstp_span_crc	CRC register window.
k_mstp_span_doc	DOC register window.
k_mstp_span_pdm	PDM common + channel banks.
k_mstp_span_adc	ADC_B register window.
k_mstp_span_sdhi	SDHI0 register window.
k_mstp_span_xspi	XSPI0 register window.
k_mstp_span_drw	DRW register window.

Definition at line 223 of file board_periph_mstp_model.c.

◆ mstp_reset_t

enum mstp_reset_t : uint32_t

Per-register reset values: all peripheral bits stopped (HUM 11.2.6).

MSTPCRA keeps the SRAM0..3 bits (0..3) running (0) because the CPU stack lives there; every other bit resets to 1 (stopped). MSTPCRB..E reset fully stopped. This is the same all-stopped baseline ra8_mstp_init writes, so a peripheral reads 0 until its driver clears its bit.

Enumerator
k_mstp_reset_a	MSTPCRA: SRAM0-3 (bits 0-3) running.
k_mstp_reset_rest	MSTPCRB..E: all peripherals stopped.

Definition at line 63 of file board_periph_mstp_model.c.

Function Documentation

◆ internal_mstp_bit_set()

bool internal_mstp_bit_set ( uint16_t id )

static

True iff the module-stop bit id (packed ra8_mstp_t) reads set.

True iff the module-stop bit id (packed ra8_mstp_t) reads set; this step is contained within the board periph module-stop model model and uses bounded caller or module-owned storage.

Parameters

[in] id Id input used by the operation.

Returns: The module-stop bit set result produced by the board periph module-stop model model.

Return values

true	The module-stop bit set condition holds or completed successfully; false otherwise.

Precondition: Arguments satisfy the ranges documented for module-stop bit set.; The call executes on the emulator's single owning thread.

Postcondition: State changes remain confined to the board periph module-stop model model and documented output objects.; Ownership of caller-supplied storage is unchanged.

Note: The operation is synchronous and does not transfer heap ownership.

Since: 0.1.0

Definition at line 395 of file board_periph_mstp_model.c.

References k_mstp_byte_mask, k_mstp_id_bit_mask, k_mstp_id_reg_shift, k_mstp_reg_count, and s_mstpcr.

Referenced by priv_board_mstp_addr_stopped().

◆ internal_mstp_family_for_addr()

const mstp_family_t * internal_mstp_family_for_addr	(	uint64_t	addr,
		uint32_t *	out_idx )

static

Resolve addr to the family + instance index that owns it.

Parameters

[in]	addr	Absolute peripheral address.
[out]	out_idx	Instance index within the family on a hit.

Returns: The owning family, or NULL when addr is not gated.

Since: 0.1.0

Definition at line 370 of file board_periph_mstp_model.c.

References mstp_family_t::base, mstp_family_t::count, s_k_families, and mstp_family_t::stride.

Referenced by priv_board_mstp_addr_stopped(), and priv_board_mstp_note_gated_access().

◆ priv_board_mstp_addr_stopped()

bool priv_board_mstp_addr_stopped ( uint64_t addr )

Report whether the peripheral instance owning addr is module-stopped.

Maps addr through the address->module-stop-bit gate table (each entry cites the governing MSTPCRx bit from HUM Ch 11.2.6..11.2.10) and returns whether that bit is currently set. An address covered by no gate entry – a peripheral with no module-stop control (GPIO, ICU, SYSC), or one ra8_emulator does not gate – is never stopped, so unmodelled and un-gated blocks answer exactly as before.

Parameters

[in] addr Absolute peripheral register address being accessed.

Returns: true when addr belongs to a gated instance whose module-stop bit is set (unclocked); false otherwise.

Return values

true	The owning instance is stopped: reads 0, writes dropped.
false	Not gated, or the owning instance is running.

Postcondition: No state is mutated (pure query).

Note: Not thread-safe; single-threaded run-loop / test use.

Since: 0.1.0

Precondition: Arguments satisfy the ranges documented for board module-stop addr stopped.; The call executes on the emulator's single owning thread.

Postcondition: Ownership of caller-supplied storage is unchanged.

Definition at line 452 of file board_periph_mstp_model.c.

References mstp_family_t::ids, internal_mstp_bit_set(), internal_mstp_family_for_addr(), and RA8_PRIV.

Referenced by board_periph_read(), and board_periph_write().

◆ priv_board_mstp_apply_write()

void priv_board_mstp_apply_write	(	uint64_t	off,
		unsigned	size,
		uint32_t	value )

Apply a firmware write to the MSTPCRA..MSTPCRE shadow.

Merges value into the tracked register bytes at off (a 0-based offset into the 20-byte block), so any 8/16/32-bit access width lands correctly. Clearing a bit ungates that peripheral; setting it re-gates it. HUM Ch 11.2.6 p 443: "bit clear == ungate the peripheral". The model accepts every bit (PSAR Non-secure attribution is not re-modelled here) because firmware never relies on a Secure write to a delegated bit sticking.

Parameters

[in]	off	Byte offset within the R_MSTP window (0..19).
[in]	size	Access width in bytes (1/2/4).
[in]	value	Little-endian value being written.

Returns: Nothing.

Postcondition: Bytes of value inside the window replace the tracked bytes.

Note: Not thread-safe; single-threaded run-loop use.

Since: 0.1.0

Precondition: Arguments satisfy the ranges documented for board module-stop apply write.; The call executes on the emulator's single owning thread.

Postcondition: Ownership of caller-supplied storage is unchanged.

Definition at line 421 of file board_periph_mstp_model.c.

References k_board_mstp_win_span, k_mstp_byte_bits, k_mstp_byte_mask, k_mstp_bytes_per_reg, RA8_PRIV, and s_mstpcr.

Referenced by internal_mstp_write().

◆ priv_board_mstp_gated_read_count()

uint32_t priv_board_mstp_gated_read_count ( void )

Number of reads zeroed because their peripheral was module-stopped.

Returns: The dropped-read counter since the last priv_board_mstp_reset.

Postcondition: No state is mutated.

Since: 0.1.0

Number of reads zeroed because their peripheral was module-stopped; this step is contained within the board periph module-stop model and uses bounded caller or module-owned storage.

Return values

value The operation-specific board module-stop gated read count value.

Precondition: Arguments satisfy the ranges documented for board module-stop gated read count.; The call executes on the emulator's single owning thread.

Postcondition: Ownership of caller-supplied storage is unchanged.

Note: The operation is synchronous and does not transfer heap ownership.

Definition at line 476 of file board_periph_mstp_model.c.

References RA8_PRIV, and s_gated_reads.

Referenced by internal_mstp_report().

◆ priv_board_mstp_gated_write_count()

uint32_t priv_board_mstp_gated_write_count ( void )

Number of writes dropped because their peripheral was module-stopped.

Returns: The dropped-write counter since the last priv_board_mstp_reset.

Postcondition: No state is mutated.

Since: 0.1.0

Number of writes dropped because their peripheral was module-stopped; this step is contained within the board periph module-stop model and uses bounded caller or module-owned storage.

Return values

value The operation-specific board module-stop gated write count value.

Precondition: Arguments satisfy the ranges documented for board module-stop gated write count.; The call executes on the emulator's single owning thread.

Postcondition: Ownership of caller-supplied storage is unchanged.

Note: The operation is synchronous and does not transfer heap ownership.

Definition at line 481 of file board_periph_mstp_model.c.

References RA8_PRIV, and s_gated_writes.

Referenced by internal_mstp_report().

◆ priv_board_mstp_last_gated_name()

const char * priv_board_mstp_last_gated_name ( void )

Label of the peripheral whose access was most recently gated off.

Returns: A static string (e.g. "SCI"), or "-" when nothing has been gated.

Postcondition: No state is mutated.

Since: 0.1.0

Definition at line 486 of file board_periph_mstp_model.c.

References RA8_PRIV, and s_last_gated.

Referenced by internal_mstp_report().

◆ priv_board_mstp_note_gated_access()

void priv_board_mstp_note_gated_access	(	uint64_t	addr,
		bool	is_write )

Record that an MMIO access to a module-stopped peripheral was dropped.

Called by the core dispatch when priv_board_mstp_addr_stopped forced a read to 0 or a write to be discarded. Bumps the dropped-access counter and remembers the offending peripheral's label so the end-of-run report can make the masked bug LOUD instead of silent.

Parameters

[in]	addr	Absolute address that was gated off.
[in]	is_write	`true` for a dropped write, `false` for a zeroed read.

Returns: Nothing.

Postcondition: The matching counter grows by one and the last-gated label is updated.

Note: Not thread-safe; single-threaded run-loop use.

Since: 0.1.0

Precondition: Arguments satisfy the ranges documented for board module-stop note gated access.; The call executes on the emulator's single owning thread.

Postcondition: Ownership of caller-supplied storage is unchanged.

Definition at line 462 of file board_periph_mstp_model.c.

References internal_mstp_family_for_addr(), mstp_family_t::name, RA8_PRIV, s_gated_reads, s_gated_writes, and s_last_gated.

Referenced by board_periph_read(), and board_periph_write().

◆ priv_board_mstp_read_reg()

uint32_t priv_board_mstp_read_reg	(	uint64_t	off,
		unsigned	size )

Read the tracked MSTPCRA..MSTPCRE shadow (the read-back path).

Returns the bytes of the shadow at off, so the firmware's mandated module-stop read-back (HUM Ch 11.2.6 Note 2 p 443) sees the value it just wrote and settles immediately – deterministic, unlike the sparse fallback's spin-settle toggle.

Parameters

[in]	off	Byte offset within the R_MSTP window (0..19).
[in]	size	Access width in bytes (1/2/4).

Returns: The tracked register bytes at off, or 0 for bytes outside the window.

Precondition: off addresses the R_MSTP window.

Postcondition: No state is mutated (pure read).

Note: Not thread-safe; single-threaded run-loop use.

Since: 0.1.0

Return values

value The operation-specific board module-stop read reg value.

Precondition: The call executes on the emulator's single owning thread.

Postcondition: Ownership of caller-supplied storage is unchanged.

Definition at line 436 of file board_periph_mstp_model.c.

References k_board_mstp_win_span, k_mstp_byte_bits, k_mstp_byte_mask, k_mstp_bytes_per_reg, RA8_PRIV, and s_mstpcr.

Referenced by internal_mstp_read().

◆ priv_board_mstp_reset()

void priv_board_mstp_reset ( void )

Restore MSTPCRA..MSTPCRE to their all-stopped reset values.

Every peripheral bit returns to 1 (module stopped), matching the silicon power-on state, so a gated block reads 0 until firmware ungates it. The MSTPCRA SRAM bits (0..3) are left running (0), mirroring the safe pattern ra8_mstp_init writes (HUM Ch 11.2.6 p 443).

Returns: Nothing.

Postcondition: Every application-peripheral module-stop bit reads 1 (stopped).; The dropped-access counters and the family-lookup cache are cleared.

Note: Not thread-safe; ra8_emulator drives all blocks from one thread.

Since: 0.1.0

Precondition: Arguments satisfy the ranges documented for board module-stop reset.; The call executes on the emulator's single owning thread.

Definition at line 410 of file board_periph_mstp_model.c.

References k_mstp_reg_count, k_mstp_reset_a, k_mstp_reset_rest, RA8_PRIV, s_gated_reads, s_gated_writes, s_last_gated, and s_mstpcr.

Referenced by internal_mstp_block_register().

Variable Documentation

◆ s_gated_reads

uint32_t s_gated_reads

static

Reads zeroed (peripheral off).

Definition at line 74 of file board_periph_mstp_model.c.

Referenced by priv_board_mstp_gated_read_count(), priv_board_mstp_note_gated_access(), and priv_board_mstp_reset().

◆ s_gated_writes

uint32_t s_gated_writes

static

Writes dropped (periph off).

Definition at line 75 of file board_periph_mstp_model.c.

Referenced by priv_board_mstp_gated_write_count(), priv_board_mstp_note_gated_access(), and priv_board_mstp_reset().

◆ s_k_families

const mstp_family_t s_k_families[]

static

The gate table: every module-stop-gated modelled peripheral instance.

Definition at line 248 of file board_periph_mstp_model.c.

Referenced by internal_mstp_family_for_addr().

◆ s_k_ids_adc

const uint16_t s_k_ids_adc[] = {(uint16_t)k_ra8_mstp_adc16h}

static

ADC_B (0x40338000) – MSTPCRD21, HUM 11.2.9.

Definition at line 174 of file board_periph_mstp_model.c.

◆ s_k_ids_agt

const uint16_t s_k_ids_agt[]

static

Initial value:

                                  = {
  (uint16_t)k_ra8_mstp_agt0,
  (uint16_t)k_ra8_mstp_agt1,
}

AGT0..AGT1 (0x40221000, 0x100 stride) – MSTPCRD5..4, HUM 11.2.9.

Definition at line 115 of file board_periph_mstp_model.c.

◆ s_k_ids_cac

const uint16_t s_k_ids_cac[] = {(uint16_t)k_ra8_mstp_cac}

static

CAC (0x40202400) – MSTPCRC0, HUM 11.2.8.

Definition at line 164 of file board_periph_mstp_model.c.

◆ s_k_ids_canfd0

const uint16_t s_k_ids_canfd0[] = {(uint16_t)k_ra8_mstp_canfd0}

static

CANFD0 (0x40380000) – MSTPCRC27, HUM 11.2.8.

Definition at line 160 of file board_periph_mstp_model.c.

◆ s_k_ids_canfd1

const uint16_t s_k_ids_canfd1[] = {(uint16_t)k_ra8_mstp_canfd1}

static

CANFD1 (0x40382000) – MSTPCRC26, HUM 11.2.8.

Definition at line 162 of file board_periph_mstp_model.c.

◆ s_k_ids_ceu

const uint16_t s_k_ids_ceu[] = {(uint16_t)k_ra8_mstp_ceu}

static

CEU (0x40348000) – MSTPCRC16, HUM 11.2.8.

Definition at line 170 of file board_periph_mstp_model.c.

◆ s_k_ids_crc

const uint16_t s_k_ids_crc[] = {(uint16_t)k_ra8_mstp_crc}

static

CRC (0x40310000) – MSTPCRC1, HUM 11.2.8.

Definition at line 166 of file board_periph_mstp_model.c.

◆ s_k_ids_dac

const uint16_t s_k_ids_dac[]

static

Initial value:

                                  = {
  (uint16_t)k_ra8_mstp_dac12_0,
  (uint16_t)k_ra8_mstp_dac12_1,
}

DAC_B0..DAC_B1 (0x40233000, 0x100 stride) – MSTPCRD20..19, HUM 11.2.9.

Definition at line 143 of file board_periph_mstp_model.c.

◆ s_k_ids_doc

const uint16_t s_k_ids_doc[] = {(uint16_t)k_ra8_mstp_doc}

static

DOC (0x40311000) – MSTPCRC13, HUM 11.2.8.

Definition at line 168 of file board_periph_mstp_model.c.

◆ s_k_ids_drw

const uint16_t s_k_ids_drw[] = {(uint16_t)k_ra8_mstp_drw}

static

DRW / D-AVE 2D (0x40444000) – MSTPCRC6, HUM 11.2.8.

Definition at line 180 of file board_periph_mstp_model.c.

◆ s_k_ids_gpt

const uint16_t s_k_ids_gpt[]

static

Initial value:

                                  = {
  (uint16_t)k_ra8_mstp_gpt0,
  (uint16_t)k_ra8_mstp_gpt1,
  (uint16_t)k_ra8_mstp_gpt2,
  (uint16_t)k_ra8_mstp_gpt3,
  (uint16_t)k_ra8_mstp_gpt4_9,
  (uint16_t)k_ra8_mstp_gpt4_9,
  (uint16_t)k_ra8_mstp_gpt4_9,
  (uint16_t)k_ra8_mstp_gpt4_9,
  (uint16_t)k_ra8_mstp_gpt4_9,
  (uint16_t)k_ra8_mstp_gpt4_9,
  (uint16_t)k_ra8_mstp_gpt10,
  (uint16_t)k_ra8_mstp_gpt11,
  (uint16_t)k_ra8_mstp_gpt12,
  (uint16_t)k_ra8_mstp_gpt13,
}

GPT0..GPT13 (0x40322000, 0x100 stride) – MSTPCRE31..18, GPT4..9 share MSTPE27, HUM 11.2.10.

Definition at line 121 of file board_periph_mstp_model.c.

◆ s_k_ids_i3c

const uint16_t s_k_ids_i3c[] = {(uint16_t)k_ra8_mstp_i3c}

static

I3C0 (0x4035F000) – MSTPCRB4, HUM 11.2.7.

Definition at line 113 of file board_periph_mstp_model.c.

◆ s_k_ids_pdm

const uint16_t s_k_ids_pdm[] = {(uint16_t)k_ra8_mstp_pdmif}

static

PDM-IF (0x40256000) – MSTPCRC24, HUM 11.2.8.

Definition at line 172 of file board_periph_mstp_model.c.

◆ s_k_ids_poeg

const uint16_t s_k_ids_poeg[]

static

Initial value:

                                   = {
  (uint16_t)k_ra8_mstp_poeg_a,
  (uint16_t)k_ra8_mstp_poeg_b,
  (uint16_t)k_ra8_mstp_poeg_c,
  (uint16_t)k_ra8_mstp_poeg_d,
}

POEG group A..D (0x40212000, 0x100 stride) – MSTPCRD14..11, HUM 11.2.9.

Definition at line 153 of file board_periph_mstp_model.c.

◆ s_k_ids_riic

const uint16_t s_k_ids_riic[]

static

Initial value:

                                   = {
  (uint16_t)k_ra8_mstp_iic0,
  (uint16_t)k_ra8_mstp_iic1,
  (uint16_t)k_ra8_mstp_iic2,
}

IIC0..IIC2 / RIIC (0x4025E000, 0x100 stride) – MSTPCRB9..7, HUM 11.2.7.

Definition at line 107 of file board_periph_mstp_model.c.

◆ s_k_ids_sci

const uint16_t s_k_ids_sci[]

static

Initial value:

                                  = {
  (uint16_t)k_ra8_mstp_sci0,
  (uint16_t)k_ra8_mstp_sci1,
  (uint16_t)k_ra8_mstp_sci2,
  (uint16_t)k_ra8_mstp_sci3,
  (uint16_t)k_ra8_mstp_sci4,
  (uint16_t)k_ra8_mstp_sci5,
  (uint16_t)k_ra8_mstp_sci6,
  (uint16_t)k_ra8_mstp_sci7,
  (uint16_t)k_ra8_mstp_sci8,
  (uint16_t)k_ra8_mstp_sci9,
}

SCI0..SCI9 (0x40358000, 0x100 stride) – MSTPCRB31..22, HUM 11.2.7.

Definition at line 89 of file board_periph_mstp_model.c.

◆ s_k_ids_sdhi

const uint16_t s_k_ids_sdhi[] = {(uint16_t)k_ra8_mstp_sdhi0}

static

SDHI0 (0x40252000) – MSTPCRC12, HUM 11.2.8.

Definition at line 176 of file board_periph_mstp_model.c.

◆ s_k_ids_spi

const uint16_t s_k_ids_spi[]

static

Initial value:

                                  = {
  (uint16_t)k_ra8_mstp_spi0,
  (uint16_t)k_ra8_mstp_spi1,
}

SPI0..SPI1 (0x4035C000, 0x100 stride) – MSTPCRB19..18, HUM 11.2.7.

Definition at line 102 of file board_periph_mstp_model.c.

◆ s_k_ids_ssie

const uint16_t s_k_ids_ssie[]

static

Initial value:

                                   = {
  (uint16_t)k_ra8_mstp_ssie0,
  (uint16_t)k_ra8_mstp_ssie1,
}

SSIE0..SSIE1 (0x4025D000, 0x100 stride) – MSTPCRC8..7, HUM 11.2.8.

Definition at line 148 of file board_periph_mstp_model.c.

◆ s_k_ids_ulpt

const uint16_t s_k_ids_ulpt[]

static

Initial value:

                                   = {
  (uint16_t)k_ra8_mstp_ulpt0,
  (uint16_t)k_ra8_mstp_ulpt1,
}

ULPT0..ULPT1 (0x40220000, 0x100 stride) – MSTPCRE9..8, HUM 11.2.10.

Definition at line 138 of file board_periph_mstp_model.c.

◆ s_k_ids_xspi

const uint16_t s_k_ids_xspi[] = {(uint16_t)k_ra8_mstp_ospi0}

static

XSPI0 / OSPI0 (0x40268000) – MSTPCRB16, HUM 11.2.7.

Definition at line 178 of file board_periph_mstp_model.c.

◆ s_last_gated

const char* s_last_gated = "-"

static

Label of last gated access.

Definition at line 76 of file board_periph_mstp_model.c.

Referenced by priv_board_mstp_last_gated_name(), priv_board_mstp_note_gated_access(), and priv_board_mstp_reset().

◆ s_mstpcr

uint32_t s_mstpcr[k_mstp_reg_count]

static

MSTPCRA..E live values.

Definition at line 73 of file board_periph_mstp_model.c.

Referenced by internal_mstp_bit_set(), priv_board_mstp_apply_write(), priv_board_mstp_read_reg(), and priv_board_mstp_reset().

Data Structures

Enumerations

Functions

Variables

Detailed Description

Gate table scope

Enumeration Type Documentation

◆ mstp_dim_t

◆ mstp_family_base_t

◆ mstp_family_count_t

◆ mstp_family_span_t

◆ mstp_reset_t

Function Documentation

◆ internal_mstp_bit_set()

◆ internal_mstp_family_for_addr()

◆ priv_board_mstp_addr_stopped()

◆ priv_board_mstp_apply_write()

◆ priv_board_mstp_gated_read_count()

◆ priv_board_mstp_gated_write_count()

◆ priv_board_mstp_last_gated_name()

◆ priv_board_mstp_note_gated_access()

◆ priv_board_mstp_read_reg()

◆ priv_board_mstp_reset()

Variable Documentation

◆ s_gated_reads

◆ s_gated_writes

◆ s_k_families

◆ s_k_ids_adc

◆ s_k_ids_agt

◆ s_k_ids_cac

◆ s_k_ids_canfd0

◆ s_k_ids_canfd1

◆ s_k_ids_ceu

◆ s_k_ids_crc

◆ s_k_ids_dac

◆ s_k_ids_doc

◆ s_k_ids_drw

◆ s_k_ids_gpt

◆ s_k_ids_i3c

◆ s_k_ids_pdm

◆ s_k_ids_poeg

◆ s_k_ids_riic

◆ s_k_ids_sci

◆ s_k_ids_sdhi

◆ s_k_ids_spi

◆ s_k_ids_ssie

◆ s_k_ids_ulpt

◆ s_k_ids_xspi

◆ s_last_gated

◆ s_mstpcr