SDIO Secondary#

sl_sdio_slave_rx_intr_status_t#

sl_sdio_slave_rx_intr_status_t

Enumeration for SDIO slave receive interrupt status.

This enumeration defines the possible statuses for SDIO secondary receive interrupts, indicating whether an interrupt from the host has been received or not.

sl_sdio_secondary_callback_t#

typedef void(* sl_sdio_secondary_callback_t) (uint8_t events) )(uint8_t events)

Callback function for SDIO secondary interface events.

This function pointer defines the prototype for a callback function that will be invoked when SDIO secondary interface events occur.

sl_sdio_secondary_gpdma_callback_t#

typedef void(* sl_sdio_secondary_gpdma_callback_t) (uint8_t dma_ch) )(uint8_t dma_ch)

Callback function for SDIO secondary interface GPDMA transfers.

This function pointer defines the prototype for a callback function that will be invoked when SDIO secondary interface GPDMA transfer completes.

sl_si91x_sdio_secondary_init#

sl_status_t sl_si91x_sdio_secondary_init (void )

To initialize the SDIO secondary.

This API initializes the SDIO secondary interface. By default, the SDIO pin access is with NWP. This API gives the pin access to M4, selects the SDIO mode, and enables the SDIO primary interrupts.

Returns

• sl_status_t Initialization status:

  • SL_STATUS_OK - Initialization successful.

  • SL_STATUS_FAIL - Initialization failed.

For more information on status codes, see SL STATUS DOCUMENTATION.

sl_si91x_sdio_secondary_send#

void sl_si91x_sdio_secondary_send (uint8_t num_of_blocks, uint8_t * data_buf)

To trigger the sequence to send data from the SDIO secondary in non-blocking mode to the host/primary device.

This API accepts the number of blocks, where one block will have a block length (1 to 1024) bytes, and a pointer to the data buffer to be transferred.

sl_si91x_sdio_secondary_receive#

void sl_si91x_sdio_secondary_receive (uint8_t * data_buf)

To receive data on the SDIO secondary in non-blocking mode from the host/primary device using GPDMA.

This API receives data from the host/primary device and stores it in the provided destination buffer. The transfer is done in non-blocking mode using GPDMA.

sl_si91x_sdio_secondary_register_event_callback#

sl_status_t sl_si91x_sdio_secondary_register_event_callback (sl_sdio_secondary_callback_t callback_event, uint32_t flag)

To register the SDIO secondary user callback function.

This API registers a user-defined callback function for the SDIO secondary interface. The callback function will be called when an interrupt occurs, based on the specified interrupt flag.

• Pre-condition:

  • sl_si91x_sdio_secondary_init must be called prior.

Returns

• sl_status_t Registration status:

  • SL_STATUS_OK - Success.

  • SL_STATUS_BUSY - Driver is busy.

  • SL_STATUS_NULL_POINTER - The parameter is a null pointer.

For more information on status codes, see SL STATUS DOCUMENTATION.

sl_si91x_sdio_secondary_unregister_event_callback#

void sl_si91x_sdio_secondary_unregister_event_callback (uint32_t flag)

To unregister the SDIO secondary user callback function.

This API unregisters a user-defined callback function for the SDIO secondary interface. The callback function will no longer be called when an interrupt occurs for the specified interrupt flag.

• Pre-condition:

  • sl_si91x_sdio_secondary_init must be called prior.

  • sl_si91x_sdio_secondary_register_event_callback must be called prior.

sl_si91x_sdio_secondary_gpdma_register_event_callback#

sl_status_t sl_si91x_sdio_secondary_gpdma_register_event_callback (sl_sdio_secondary_gpdma_callback_t callback_event)

To register the SDIO secondary GPDMA user callback function.

This API registers a user-defined callback function for the SDIO secondary interface. The callback function will be called when a GPDMA interrupt occurs.

• Pre-conditions:

  • sl_si91x_sdio_secondary_init must be called prior.

Returns

• sl_status_t Registration status:

  • SL_STATUS_OK - Success.

  • SL_STATUS_BUSY - Driver is busy.

  • SL_STATUS_NULL_POINTER - The parameter is a null pointer.

For more information on status codes, see SL STATUS DOCUMENTATION.

sl_si91x_sdio_secondary_gpdma_unregister_event_callback#

void sl_si91x_sdio_secondary_gpdma_unregister_event_callback (void )

To unregister the SDIO secondary GPDMA user callback function.

This API unregisters a user-defined callback function for the SDIO secondary interface. The callback function will no longer be called when a GPDMA interrupt occurs.

sl_si91x_sdio_secondary_get_version#

sl_sdio_secondary_version_t sl_si91x_sdio_secondary_get_version (void )

To get the SDIO Secondary Driver version.

This function retrieves the version of the SDIO Secondary Driver. It can be used to verify compatibility and ensure the correct version of the driver is being used.

Returns

• sl_sdio_secondary_version_t Driver version.

sl_si91x_sdio_secondary_peripheral_init#

void sl_si91x_sdio_secondary_peripheral_init (void )

To initialize the SDIO Secondary at peripheral layer.

This API initializes the SDIO secondary, by default SDIO pin access with NWP this API gives the pin access to M4, selects the SDIO mode and enable the sdio primary interrupts

sl_si91x_sdio_secondary_enable_interrupts#

__STATIC_INLINE void sl_si91x_sdio_secondary_enable_interrupts (uint32_t flags)

To enable the SDIO interrupts.

SL_SDIO_RD_INT_EN

SL_SDIO_CSA_INT_EN

SL_SDIO_CMD52_INT_EN

SL_SDIO_PWR_LEV_INT_EN

SL_SDIO_CRC_ERR_INT_EN

SL_SDIO_ABORT_INT_EN

SL_SDIO_TOUT_INT_EN

sl_si91x_sdio_secondary_disable_interrupts#

__STATIC_INLINE void sl_si91x_sdio_secondary_disable_interrupts (uint32_t flags)

To disable the SDIO interrupts.

SL_SDIO_RD_INT_EN

SL_SDIO_CSA_INT_EN

SL_SDIO_CMD52_INT_EN

SL_SDIO_PWR_LEV_INT_EN

SL_SDIO_CRC_ERR_INT_EN

SL_SDIO_ABORT_INT_EN

SL_SDIO_TOUT_INT_EN

sl_si91x_sdio_secondary_set_interrupts#

__INLINE void sl_si91x_sdio_secondary_set_interrupts (uint32_t flags)

To set the interrupts i.e., unmask according to the flags passed in the parameter.

• sl_si91x_sdio_secondary_enable_interrupts();

SL_SDIO_RD_INT_UNMSK

SL_SDIO_CSA_INT_UNMSK

SL_SDIO_CMD52_INT_UNMSK

SL_SDIO_PWR_LEV_INT_UNMSK

SL_SDIO_CRC_ERR_INT_UNMSK

SL_SDIO_ABORT_INT_UNMSK

SL_SDIO_TOUT_INT_UNMSK

sl_si91x_sdio_secondary_clear_interrupts#

__INLINE void sl_si91x_sdio_secondary_clear_interrupts (uint32_t flags)

To clear the interrupts i.e., mask according to the flags passed in the parameter.

• sl_si91x_sdio_secondary_disable_interrupts();

SL_SDIO_RD_INT_MSK

SL_SDIO_CSA_INT_MSK

SL_SDIO_CMD52_INT_MSK

SL_SDIO_PWR_LEV_INT_MSK

SL_SDIO_CRC_ERR_INT_MSK

SL_SDIO_ABORT_INT_MSK

SL_SDIO_TOUT_INT_MSK

sl_si91x_sdio_secondary_get_pending_interrupts#

__INLINE uint32_t sl_si91x_sdio_secondary_get_pending_interrupts (void )

To get the pending function interrupt.

Returns

• Return the pending interrupt status.

sl_si91x_sdio_secondary_get_enabled_interrupts#

__INLINE uint32_t sl_si91x_sdio_secondary_get_enabled_interrupts (void )

To get all the enabled interrupts in function1.

Returns

• No of interrupts enabled.

sl_si91x_sdio_secondary_get_enabled_pending_interrupts#

__INLINE uint32_t sl_si91x_sdio_secondary_get_enabled_pending_interrupts (void )

To get all the enabled interrupts in function1 and pending interrupts.

Returns

• No of interrupts enabled.

sl_si91x_sdio_secondary_get_block_cnt#

__INLINE uint32_t sl_si91x_sdio_secondary_get_block_cnt (void )

To get block count for the last received CMD53.

Returns

• No of block counts.

sl_si91x_sdio_secondary_get_block_len#

__INLINE uint32_t sl_si91x_sdio_secondary_get_block_len (void )

To get the length of each for the last received CMD53.

Returns

• Length of each block.

sl_si91x_sdio_secondary_set_tx_blocks#

__INLINE void sl_si91x_sdio_secondary_set_tx_blocks (uint8_t no_of_blocks)

To set no of blocks to be transferred.

This API is used when transferring the data from secondary to primary in block mode.

NUMGPDMADESC#

#define NUMGPDMADESC

10

Number of GPDMA Descriptors.

HOST_INTR_RECEIVE_EVENT#

#define HOST_INTR_RECEIVE_EVENT

BIT(0)

Events for HIF irq handler.

SDIO#

#define SDIO

SDIO0

SDIO Base Address.

SDIO_Handler#

#define SDIO_Handler

HIF1_IRQHandler

HIF1 interrrupt handler.

GPDMA_Handler#

#define GPDMA_Handler

IRQ031_Handler

GPDMA interrupt handler.

RX_SOURCE_ADDR#

#define RX_SOURCE_ADDR

0x20200080

SDIO Write FIFO Data Register.

SDIO write FIFO Data Register.

TX_SOURCE_ADDR#

#define TX_SOURCE_ADDR

0x20200040

SDIO Read FIFO Data Register.

SDIO_MODE_SELECT#

#define SDIO_MODE_SELECT

0x0705

SDIO Mode Select.

MASK_HOST_INTERRUPT#

#define MASK_HOST_INTERRUPT

0xF0

MASK Host Interrupt.

M4_MISC_CONFIG_BASE#

#define M4_MISC_CONFIG_BASE

0x46008000

SDIO MISC Configuration.

SDIO_BASE#

#define SDIO_BASE

0x20200000

SDIO BASE Address.

SL_SDIO_WR_INT_EN#

#define SL_SDIO_WR_INT_EN

BIT(0)

This bit is used to enable CMD53 write interrupt.

SL_SDIO_RD_INT_EN#

#define SL_SDIO_RD_INT_EN

BIT(1)

This bit is used to enable CMD53 read interrupt.

SL_SDIO_CSA_INT_EN#

#define SL_SDIO_CSA_INT_EN

BIT(2)

This bit is used to enable CMD53 CSA interrupt.

SL_SDIO_CMD52_INT_EN#

#define SL_SDIO_CMD52_INT_EN

BIT(3)

This bit is used to enable CMD52 interrupt.

SL_SDIO_PWR_LEV_INT_EN#

#define SL_SDIO_PWR_LEV_INT_EN

BIT(4)

This bit is used to enable power level change interrupt.

SL_SDIO_CRC_ERR_INT_EN#

#define SL_SDIO_CRC_ERR_INT_EN

BIT(5)

This bit is used to enable CRC error interrupt.

SL_SDIO_ABORT_INT_EN#

#define SL_SDIO_ABORT_INT_EN

BIT(6)

This bit is used to enable abort interrupt.

SL_SDIO_TOUT_INT_EN#

#define SL_SDIO_TOUT_INT_EN

BIT(7)

This bit is used to enable "read FIFO wait time over" interrupt.

SL_SDIO_WR_INT_MSK#

#define SL_SDIO_WR_INT_MSK

BIT(0)

This bit is used to mask CMD53 write interrupt.

SL_SDIO_RD_INT_MSK#

#define SL_SDIO_RD_INT_MSK

BIT(1)

This bit is used to mask CMD53 read interrupt.

SL_SDIO_CSA_INT_MSK#

#define SL_SDIO_CSA_INT_MSK

BIT(2)

This bit is used to mask CMD53 CSA interrupt.

SL_SDIO_CMD52_INT_MSK#

#define SL_SDIO_CMD52_INT_MSK

BIT(3)

This bit is used to mask CMD52 interrupt.

SL_SDIO_PWR_LEV_INT_MSK#

#define SL_SDIO_PWR_LEV_INT_MSK

BIT(4)

This bit is used to mask power level change interrupt.

SL_SDIO_CRC_ERR_INT_MSK#

#define SL_SDIO_CRC_ERR_INT_MSK

BIT(5)

This bit is used to mask CRC error interrupt.

SL_SDIO_ABORT_INT_MSK#

#define SL_SDIO_ABORT_INT_MSK

BIT(6)

This bit is used to mask abort interrupt.

SL_SDIO_TOUT_INT_MSK#

#define SL_SDIO_TOUT_INT_MSK

BIT(7)

This bit is used to mask "read FIFO wait time over" interrupt.

SL_SDIO_WR_INT_UNMSK#

#define SL_SDIO_WR_INT_UNMSK

BIT(0)

This bit is used to unmask CMD53 write interrupt.

SL_SDIO_RD_INT_UNMSK#

#define SL_SDIO_RD_INT_UNMSK

BIT(1)

This bit is used to unmask CMD53 read interrupt.

SL_SDIO_CSA_INT_UNMSK#

#define SL_SDIO_CSA_INT_UNMSK

BIT(2)

This bit is used to unmask CMD53 CSA interrupt.

SL_SDIO_CMD52_INT_UNMSK#

#define SL_SDIO_CMD52_INT_UNMSK

BIT(3)

This bit is used to unmask CMD52 interrupt.

SL_SDIO_PWR_LEV_INT_UNMSK#

#define SL_SDIO_PWR_LEV_INT_UNMSK

BIT(4)

This bit is used to unmask power level change interrupt.

SL_SDIO_CRC_ERR_INT_UNMSK#

#define SL_SDIO_CRC_ERR_INT_UNMSK

BIT(5)

This bit is used to unmask CRC error interrupt.

SL_SDIO_ABORT_INT_UNMSK#

#define SL_SDIO_ABORT_INT_UNMSK

BIT(6)

This bit is used to unmask abort interrupt.

SL_SDIO_TOUT_INT_UNMSK#

#define SL_SDIO_TOUT_INT_UNMSK

BIT(7)

This bit is used to unmask "read FIFO wait time over" interrupt.