 |
Software APIs
|
|
Software APIs
|
Device Tables (DT) for IP sysrst_ctrl and top earlgrey. More...
#include "hw/top/dt/dt_sysrst_ctrl.h"Go to the source code of this file.
Data Structures | |
| struct | dt_desc_sysrst_ctrl |
| Description of instances. More... | |
Macros | |
| #define | TRY_GET_DT(dt, default) |
Return a pointer to the dt_sysrst_ctrl_desc_t structure of the requested dt if it's a valid index. | |
Typedefs | |
| typedef struct dt_desc_sysrst_ctrl | dt_desc_sysrst_ctrl_t |
| Description of instances. | |
Device Tables (DT) for IP sysrst_ctrl and top earlgrey.
Definition in file dt_sysrst_ctrl.c.
| struct dt_desc_sysrst_ctrl |
Description of instances.
Definition at line 19 of file dt_sysrst_ctrl.c.
| Data Fields | ||
|---|---|---|
| dt_clock_t | clock[kDtSysrstCtrlClockCount] | Clock signal connected to each clock port. |
| 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_earlgrey_plic_irq_id_t | first_irq |
PLIC ID of the first IRQ of this instance. This can be |
| dt_instance_id_t | inst_id | Instance ID. |
| uint32_t | mem_addr[kDtSysrstCtrlMemoryCount] | Base address of each memory. |
| uint32_t | mem_size[kDtSysrstCtrlMemoryCount] | Size in bytes of each memory. |
| dt_periph_io_t | periph_io[kDtSysrstCtrlPeriphIoCount] | Description of each peripheral I/O. |
| uint32_t | reg_addr[kDtSysrstCtrlRegBlockCount] | Base address of each register block. |
| dt_reset_t | reset[kDtSysrstCtrlResetCount] | Reset signal connected to each reset port. |
| #define TRY_GET_DT | ( | dt, | |
| default ) |
Return a pointer to the dt_sysrst_ctrl_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 186 of file dt_sysrst_ctrl.c.
| dt_sysrst_ctrl_alert_t dt_sysrst_ctrl_alert_from_alert_id | ( | dt_sysrst_ctrl_t | dt, |
| dt_alert_id_t | alert ) |
Convert a global alert ID to a local sysrst_ctrl alert type.
| dt | Instance of sysrst_ctrl. |
| alert | A global alert ID that belongs to this instance. |
kDtSysrstCtrlAlertCount.Note: This function assumes that the global alert ID belongs to the instance of sysrst_ctrl passed in parameter. In other words, it must be the case that dt_sysrst_ctrl_instance_id(dt) == dt_alert_id_to_instance_id(alert). Otherwise, this function will return kDtSysrstCtrlAlertCount.
Definition at line 252 of file dt_sysrst_ctrl.c.
| dt_alert_id_t dt_sysrst_ctrl_alert_to_alert_id | ( | dt_sysrst_ctrl_t | dt, |
| dt_sysrst_ctrl_alert_t | alert ) |
Get the alert ID of a sysrst_ctrl alert for a given instance.
Note: This function only makes sense if the instance is connected to the Alert Handler. For any instances where the instance is not connected, the return value is unspecified.
| dt | Instance of sysrst_ctrl. |
| alert | A sysrst_ctrl alert. |
Definition at line 246 of file dt_sysrst_ctrl.c.
Get the clock signal connected to a clock port of an instance.
| dt | Instance of sysrst_ctrl. |
| clk | Clock port. |
Definition at line 270 of file dt_sysrst_ctrl.c.
| dt_sysrst_ctrl_t dt_sysrst_ctrl_from_instance_id | ( | dt_instance_id_t | inst_id | ) |
Get the sysrst_ctrl instance from an instance ID.
For example, dt_uart_from_instance_id(kDtInstanceIdUart3) == kDtUart3.
| inst_id | Instance ID. |
Note: This function only makes sense if the instance ID has device type sysrst_ctrl, otherwise the returned value is unspecified.
Definition at line 188 of file dt_sysrst_ctrl.c.
| dt_instance_id_t dt_sysrst_ctrl_instance_id | ( | dt_sysrst_ctrl_t | dt | ) |
Get the instance ID of an instance.
| dt | Instance of sysrst_ctrl. |
Definition at line 195 of file dt_sysrst_ctrl.c.
| dt_sysrst_ctrl_irq_t dt_sysrst_ctrl_irq_from_plic_id | ( | dt_sysrst_ctrl_t | dt, |
| dt_plic_irq_id_t | irq ) |
Convert a global IRQ ID to a local sysrst_ctrl IRQ type.
| dt | Instance of sysrst_ctrl. |
| irq | A PLIC ID that belongs to this instance. |
kDtSysrstCtrlIrqCount.Note: This function assumes that the PLIC ID belongs to the instance of sysrst_ctrl passed in parameter. In other words, it must be the case that dt_sysrst_ctrl_instance_id(dt) == dt_plic_id_to_instance_id(irq). Otherwise, this function will return kDtSysrstCtrlIrqCount.
Definition at line 231 of file dt_sysrst_ctrl.c.
| dt_plic_irq_id_t dt_sysrst_ctrl_irq_to_plic_id | ( | dt_sysrst_ctrl_t | dt, |
| dt_sysrst_ctrl_irq_t | irq ) |
Get the PLIC ID of a sysrst_ctrl IRQ for a given instance.
If the instance is not connected to the PLIC, this function will return kDtPlicIrqIdNone.
| dt | Instance of sysrst_ctrl. |
| irq | A sysrst_ctrl IRQ. |
Definition at line 221 of file dt_sysrst_ctrl.c.
| uint32_t dt_sysrst_ctrl_memory_base | ( | dt_sysrst_ctrl_t | dt, |
| dt_sysrst_ctrl_memory_t | mem ) |
Get the base address of a memory.
| dt | Instance of sysrst_ctrl. |
| mem | The memory requested. |
Definition at line 207 of file dt_sysrst_ctrl.c.
| uint32_t dt_sysrst_ctrl_memory_size | ( | dt_sysrst_ctrl_t | dt, |
| dt_sysrst_ctrl_memory_t | mem ) |
Get the size of a memory.
| dt | Instance of sysrst_ctrl. |
| mem | The memory requested. |
Definition at line 214 of file dt_sysrst_ctrl.c.
Get the peripheral I/O description of an instance.
| dt | Instance of sysrst_ctrl. |
| sig | Requested peripheral I/O. |
Definition at line 263 of file dt_sysrst_ctrl.c.
| uint32_t dt_sysrst_ctrl_reg_block | ( | dt_sysrst_ctrl_t | dt, |
| dt_sysrst_ctrl_reg_block_t | reg_block ) |
Get the register base address of an instance.
| dt | Instance of sysrst_ctrl. |
| reg_block | The register block requested. |
Definition at line 200 of file dt_sysrst_ctrl.c.
Get the reset signal connected to a reset port of an instance.
| dt | Instance of sysrst_ctrl. |
| rst | Reset port. |
Definition at line 277 of file dt_sysrst_ctrl.c.