 |
Software APIs
|
|
Software APIs
|
Device Tables (DT) for IP gpio and top englishbreakfast. More...
#include "hw/top/dt/gpio.h"Go to the source code of this file.
Data Structures | |
| struct | dt_desc_gpio |
| Description of instances. More... | |
| struct | dt_desc_gpio.ipgen_ext |
Macros | |
| #define | TRY_GET_DT(dt, default) |
Return a pointer to the dt_gpio_desc_t structure of the requested dt if it's a valid index. | |
Typedefs | |
| typedef struct dt_desc_gpio | dt_desc_gpio_t |
| Description of instances. | |
Functions | |
| dt_gpio_t | dt_gpio_from_instance_id (dt_instance_id_t inst_id) |
| Get the gpio instance from an instance ID. | |
| dt_instance_id_t | dt_gpio_instance_id (dt_gpio_t dt) |
| Get the instance ID of an instance. | |
| uint32_t | dt_gpio_reg_block (dt_gpio_t dt, dt_gpio_reg_block_t reg_block) |
| Get the register base address of an instance. | |
| uint32_t | dt_gpio_memory_base (dt_gpio_t dt, dt_gpio_memory_t mem) |
| Get the base address of a memory. | |
| uint32_t | dt_gpio_memory_size (dt_gpio_t dt, dt_gpio_memory_t mem) |
| Get the size of a memory. | |
| dt_plic_irq_id_t | dt_gpio_irq_to_plic_id (dt_gpio_t dt, dt_gpio_irq_t irq) |
| Get the PLIC ID of a gpio IRQ for a given instance. | |
| dt_gpio_irq_t | dt_gpio_irq_from_plic_id (dt_gpio_t dt, dt_plic_irq_id_t irq) |
| Convert a global IRQ ID to a local gpio IRQ type. | |
| dt_periph_io_t | dt_gpio_periph_io (dt_gpio_t dt, dt_gpio_periph_io_t sig) |
| Get the peripheral I/O description of an instance. | |
| dt_clock_t | dt_gpio_clock (dt_gpio_t dt, dt_gpio_clock_t clk) |
| Get the clock signal connected to a clock port of an instance. | |
| dt_reset_t | dt_gpio_reset (dt_gpio_t dt, dt_gpio_reset_t rst) |
| Get the reset signal connected to a reset port of an instance. | |
| uint8_t | dt_gpio_input_period_counter_count (dt_gpio_t dt) |
| Get the number of input period counters. | |
Device Tables (DT) for IP gpio and top englishbreakfast.
Definition in file gpio.c.
| struct dt_desc_gpio |
| Data Fields | ||
|---|---|---|
| dt_clock_t | clock[kDtGpioClockCount] | 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 |
| top_earlgrey_plic_irq_id_t | first_irq |
PLIC ID of the first IRQ of this instance. This can be |
| top_englishbreakfast_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. |
| struct dt_desc_gpio | ipgen_ext | Extension. |
| struct dt_desc_gpio | ipgen_ext | Extension. |
| struct dt_desc_gpio.ipgen_ext | ipgen_ext | Extension. |
| uint32_t | mem_addr[kDtGpioMemoryCount] | Base address of each memory. |
| uint32_t | mem_size[kDtGpioMemoryCount] | Size in bytes of each memory. |
| dt_periph_io_t | periph_io[kDtGpioPeriphIoCount] | Description of each peripheral I/O. |
| uint32_t | reg_addr[kDtGpioRegBlockCount] | Base address of each register block. |
| dt_reset_t | reset[kDtGpioResetCount] | Reset signal connected to each reset port. |
| struct dt_desc_gpio.ipgen_ext |
| #define TRY_GET_DT | ( | dt, | |
| default ) |
Return a pointer to the dt_gpio_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.
| dt_clock_t dt_gpio_clock | ( | dt_gpio_t | dt, |
| dt_gpio_clock_t | clk ) |
| dt_gpio_t dt_gpio_from_instance_id | ( | dt_instance_id_t | inst_id | ) |
Get the gpio 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 gpio, otherwise the returned value is unspecified.
| uint8_t dt_gpio_input_period_counter_count | ( | dt_gpio_t | dt | ) |
| dt_instance_id_t dt_gpio_instance_id | ( | dt_gpio_t | dt | ) |
| dt_gpio_irq_t dt_gpio_irq_from_plic_id | ( | dt_gpio_t | dt, |
| dt_plic_irq_id_t | irq ) |
Convert a global IRQ ID to a local gpio IRQ type.
| dt | Instance of gpio. |
| irq | A PLIC ID that belongs to this instance. |
kDtGpioIrqCount.Note: This function assumes that the PLIC ID belongs to the instance of gpio passed in parameter. In other words, it must be the case that dt_gpio_instance_id(dt) == dt_plic_id_to_instance_id(irq). Otherwise, this function will return kDtGpioIrqCount.
| dt_plic_irq_id_t dt_gpio_irq_to_plic_id | ( | dt_gpio_t | dt, |
| dt_gpio_irq_t | irq ) |
| uint32_t dt_gpio_memory_base | ( | dt_gpio_t | dt, |
| dt_gpio_memory_t | mem ) |
| uint32_t dt_gpio_memory_size | ( | dt_gpio_t | dt, |
| dt_gpio_memory_t | mem ) |
| dt_periph_io_t dt_gpio_periph_io | ( | dt_gpio_t | dt, |
| dt_gpio_periph_io_t | sig ) |
| uint32_t dt_gpio_reg_block | ( | dt_gpio_t | dt, |
| dt_gpio_reg_block_t | reg_block ) |
| dt_reset_t dt_gpio_reset | ( | dt_gpio_t | dt, |
| dt_gpio_reset_t | rst ) |