Device Tables (DT) for IP spi_device and top englishbreakfast. More...

#include "hw/top/dt/dt_spi_device.h"

Data Structures
struct	dt_desc_spi_device
	Description of instances. More...

Macros
#define	TRY_GET_DT(dt, default)
	Return a pointer to the `dt_spi_device_desc_t` structure of the requested `dt` if it's a valid index.

Typedefs
typedef struct dt_desc_spi_device	dt_desc_spi_device_t
	Description of instances.

Functions
dt_spi_device_t	dt_spi_device_from_instance_id (dt_instance_id_t inst_id)
	Get the spi_device instance from an instance ID.

dt_instance_id_t	dt_spi_device_instance_id (dt_spi_device_t dt)
	Get the instance ID of an instance.

uint32_t	dt_spi_device_reg_block (dt_spi_device_t dt, dt_spi_device_reg_block_t reg_block)
	Get the register base address of an instance.

uint32_t	dt_spi_device_memory_base (dt_spi_device_t dt, dt_spi_device_memory_t mem)
	Get the base address of a memory.

uint32_t	dt_spi_device_memory_size (dt_spi_device_t dt, dt_spi_device_memory_t mem)
	Get the size of a memory.

dt_plic_irq_id_t	dt_spi_device_irq_to_plic_id (dt_spi_device_t dt, dt_spi_device_irq_t irq)
	Get the PLIC ID of a spi_device IRQ for a given instance.

dt_spi_device_irq_t	dt_spi_device_irq_from_plic_id (dt_spi_device_t dt, dt_plic_irq_id_t irq)
	Convert a global IRQ ID to a local spi_device IRQ type.

dt_periph_io_t	dt_spi_device_periph_io (dt_spi_device_t dt, dt_spi_device_periph_io_t sig)
	Get the peripheral I/O description of an instance.

dt_clock_t	dt_spi_device_clock (dt_spi_device_t dt, dt_spi_device_clock_t clk)
	Get the clock signal connected to a clock port of an instance.

dt_reset_t	dt_spi_device_reset (dt_spi_device_t dt, dt_spi_device_reset_t rst)
	Get the reset signal connected to a reset port of an instance.

Detailed Description

Device Tables (DT) for IP spi_device and top englishbreakfast.

Definition in file dt_spi_device.c.

Data Structure Documentation

◆ dt_desc_spi_device

struct dt_desc_spi_device

Description of instances.

Definition at line 19 of file dt_spi_device.c.

Data Fields
dt_clock_t	clock[kDtSpiDeviceClockCount]	Clock signal connected to each clock port.
top_darjeeling_alert_id_t	first_alert	Alert ID of the first Alert of this instance. This value is undefined if the block is not connected to the Alert Handler.
top_earlgrey_alert_id_t	first_alert	Alert ID of the first Alert of this instance. This value is undefined if the block is not connected to the Alert Handler.
top_darjeeling_plic_irq_id_t	first_irq	PLIC ID of the first IRQ of this instance. This can be `kDtPlicIrqIdNone` if the block is not connected to the PLIC.
top_earlgrey_plic_irq_id_t	first_irq	PLIC ID of the first IRQ of this instance. This can be `kDtPlicIrqIdNone` if the block is not connected to the PLIC.
top_englishbreakfast_plic_irq_id_t	first_irq	PLIC ID of the first IRQ of this instance. This can be `kDtPlicIrqIdNone` if the block is not connected to the PLIC.
dt_instance_id_t	inst_id	Instance ID.
uint32_t	mem_addr[kDtSpiDeviceMemoryCount]	Base address of each memory.
uint32_t	mem_size[kDtSpiDeviceMemoryCount]	Size in bytes of each memory.
dt_periph_io_t	periph_io[kDtSpiDevicePeriphIoCount]	Description of each peripheral I/O.
uint32_t	reg_addr[kDtSpiDeviceRegBlockCount]	Base address of each register block.
dt_reset_t	reset[kDtSpiDeviceResetCount]	Reset signal connected to each reset port.

Macro Definition Documentation

◆ TRY_GET_DT

#define TRY_GET_DT	(		dt,
			default )

Value:

({ if ((dt) < (dt_spi_device_t)0 || (dt) >= kDtSpiDeviceCount) return (default); &spi_device_desc[dt]; })

Return a pointer to the dt_spi_device_desc_t structure of the requested dt if it's a valid index.

Otherwise, this macro will return (i.e. exit the function) with the provided default value.

Definition at line 121 of file dt_spi_device.c.

Function Documentation

◆ dt_spi_device_clock()

dt_clock_t dt_spi_device_clock	(	dt_spi_device_t	dt,
		dt_spi_device_clock_t	clk )

Get the clock signal connected to a clock port of an instance.

Parameters

dt	Instance of spi_device.
clk	Clock port.

Returns: Clock signal.

Definition at line 189 of file dt_spi_device.c.

◆ dt_spi_device_from_instance_id()

dt_spi_device_t dt_spi_device_from_instance_id ( dt_instance_id_t inst_id )

Get the spi_device instance from an instance ID.

For example, dt_uart_from_instance_id(kDtInstanceIdUart3) == kDtUart3.

Parameters

inst_id Instance ID.

Returns: A spi_device instance.

Note: This function only makes sense if the instance ID has device type spi_device, otherwise the returned value is unspecified.

Definition at line 123 of file dt_spi_device.c.

◆ dt_spi_device_instance_id()

dt_instance_id_t dt_spi_device_instance_id ( dt_spi_device_t dt )

Get the instance ID of an instance.

Parameters

dt	Instance of spi_device.

Returns: The instance ID of that instance.

Definition at line 130 of file dt_spi_device.c.

◆ dt_spi_device_irq_from_plic_id()

dt_spi_device_irq_t dt_spi_device_irq_from_plic_id	(	dt_spi_device_t	dt,
		dt_plic_irq_id_t	irq )

Convert a global IRQ ID to a local spi_device IRQ type.

Parameters

dt	Instance of spi_device.
irq	A PLIC ID that belongs to this instance.

Returns: The spi_device IRQ, or kDtSpiDeviceIrqCount.

Note: This function assumes that the PLIC ID belongs to the instance of spi_device passed in parameter. In other words, it must be the case that dt_spi_device_instance_id(dt) == dt_plic_id_to_instance_id(irq). Otherwise, this function will return kDtSpiDeviceIrqCount.

Definition at line 166 of file dt_spi_device.c.

◆ dt_spi_device_irq_to_plic_id()

dt_plic_irq_id_t dt_spi_device_irq_to_plic_id	(	dt_spi_device_t	dt,
		dt_spi_device_irq_t	irq )

Get the PLIC ID of a spi_device IRQ for a given instance.

If the instance is not connected to the PLIC, this function will return kDtPlicIrqIdNone.

Parameters

dt	Instance of spi_device.
irq	A spi_device IRQ.

Returns: The PLIC ID of the IRQ of this instance.

Definition at line 156 of file dt_spi_device.c.

◆ dt_spi_device_memory_base()

uint32_t dt_spi_device_memory_base	(	dt_spi_device_t	dt,
		dt_spi_device_memory_t	mem )

Get the base address of a memory.

Parameters

dt	Instance of spi_device.
mem	The memory requested.

Returns: The base address of the requested memory.

Definition at line 142 of file dt_spi_device.c.

◆ dt_spi_device_memory_size()

uint32_t dt_spi_device_memory_size	(	dt_spi_device_t	dt,
		dt_spi_device_memory_t	mem )

Get the size of a memory.

Parameters

dt	Instance of spi_device.
mem	The memory requested.

Returns: The size of the requested memory.

Definition at line 149 of file dt_spi_device.c.

◆ dt_spi_device_periph_io()

dt_periph_io_t dt_spi_device_periph_io	(	dt_spi_device_t	dt,
		dt_spi_device_periph_io_t	sig )

Get the peripheral I/O description of an instance.

Parameters

dt	Instance of spi_device.
sig	Requested peripheral I/O.

Returns: Description of the requested peripheral I/O for this instance.

Definition at line 182 of file dt_spi_device.c.

◆ dt_spi_device_reg_block()

uint32_t dt_spi_device_reg_block	(	dt_spi_device_t	dt,
		dt_spi_device_reg_block_t	reg_block )

Get the register base address of an instance.

Parameters

dt	Instance of spi_device.
reg_block	The register block requested.

Returns: The register base address of the requested block.

Definition at line 135 of file dt_spi_device.c.

◆ dt_spi_device_reset()

dt_reset_t dt_spi_device_reset	(	dt_spi_device_t	dt,
		dt_spi_device_reset_t	rst )

Get the reset signal connected to a reset port of an instance.

Parameters

dt	Instance of spi_device.
rst	Reset port.

Returns: Reset signal.

Definition at line 196 of file dt_spi_device.c.

Data Structures

Macros

Typedefs

Functions

Detailed Description

Data Structure Documentation

◆ dt_desc_spi_device

Macro Definition Documentation

◆ TRY_GET_DT

Function Documentation

◆ dt_spi_device_clock()

◆ dt_spi_device_from_instance_id()

◆ dt_spi_device_instance_id()

◆ dt_spi_device_irq_from_plic_id()

◆ dt_spi_device_irq_to_plic_id()

◆ dt_spi_device_memory_base()

◆ dt_spi_device_memory_size()

◆ dt_spi_device_periph_io()

◆ dt_spi_device_reg_block()

◆ dt_spi_device_reset()