RTEMS  5.0.0
Typedefs | Enumerations | Functions

Typedefs

typedef enum ALT_QSPI_INT_STATUS_e ALT_QSPI_INT_STATUS_t
 

Enumerations

enum  ALT_QSPI_INT_STATUS_e {
  ALT_QSPI_INT_STATUS_MODE_FAIL = (0x1 << 0), ALT_QSPI_INT_STATUS_UFL = (0x1 << 1), ALT_QSPI_INT_STATUS_IDAC_OP_COMPLETE = (0x1 << 2), ALT_QSPI_INT_STATUS_IDAC_OP_REJECT = (0x1 << 3),
  ALT_QSPI_INT_STATUS_WR_PROT_VIOL = (0x1 << 4), ALT_QSPI_INT_STATUS_ILL_AHB_ACCESS = (0x1 << 5), ALT_QSPI_INT_STATUS_IDAC_WTRMK_TRIG = (0x1 << 6), ALT_QSPI_INT_STATUS_RX_OVF = (0x1 << 7),
  ALT_QSPI_INT_STATUS_TX_FIFO_NOT_FULL = (0x1 << 8), ALT_QSPI_INT_STATUS_TX_FIFO_FULL = (0x1 << 9), ALT_QSPI_INT_STATUS_RX_FIFO_NOT_EMPTY = (0x1 << 10), ALT_QSPI_INT_STATUS_RX_FIFO_FULL = (0x1 << 11),
  ALT_QSPI_INT_STATUS_IDAC_RD_FULL = (0x1 << 12)
}
 

Functions

ALT_STATUS_CODE alt_qspi_init (void)
 
ALT_STATUS_CODE alt_qspi_uninit (void)
 
ALT_STATUS_CODE alt_qspi_disable (void)
 
ALT_STATUS_CODE alt_qspi_enable (void)
 
uint32_t alt_qspi_int_status_get (void)
 
ALT_STATUS_CODE alt_qspi_int_clear (const uint32_t mask)
 
ALT_STATUS_CODE alt_qspi_int_disable (const uint32_t mask)
 
ALT_STATUS_CODE alt_qspi_int_enable (const uint32_t mask)
 
bool alt_qspi_is_idle (void)
 

Detailed Description

The declarations and functions in this group provide general purpose control and status functions for the QSPI Flash Controller.

Typedef Documentation

◆ ALT_QSPI_INT_STATUS_t

This type definition enumerates the interrupt status conditions for the QSPI controller.

The enumerations serve as masks for the QSPI controller events that can be set when the designated conditions occur and the corresponding event is enabled. When any of these event source conditions are true, the ALT_INT_INTERRUPT_QSPI_IRQ interrupt output is asserted high.

Interrupt sources are cleared when software calls alt_qspi_int_clear(). The interrupt sources are individually maskable using alt_qspi_int_disable() and alt_qspi_int_enable().

Enumeration Type Documentation

◆ ALT_QSPI_INT_STATUS_e

This type definition enumerates the interrupt status conditions for the QSPI controller.

The enumerations serve as masks for the QSPI controller events that can be set when the designated conditions occur and the corresponding event is enabled. When any of these event source conditions are true, the ALT_INT_INTERRUPT_QSPI_IRQ interrupt output is asserted high.

Interrupt sources are cleared when software calls alt_qspi_int_clear(). The interrupt sources are individually maskable using alt_qspi_int_disable() and alt_qspi_int_enable().

Enumerator
ALT_QSPI_INT_STATUS_MODE_FAIL 

Mode fail M - indicates the voltage on pin n_ss_in is inconsistent with the SPI mode. Set = 1 if n_ss_in is low in master mode (multi-master contention). These conditions will clear the spi_enable bit and disable the SPI.

  • 0 = no mode fault has been detected.
  • 1 = a mode fault has occurred.
ALT_QSPI_INT_STATUS_UFL 

Underflow Detected.

  • 0 = no underflow has been detected.
  • 1 = underflow is detected and an attempt to transfer data is made when the small TX FIFO is empty. This may occur when AHB write data is being supplied too slowly to keep up with the requested write operation.
ALT_QSPI_INT_STATUS_IDAC_OP_COMPLETE 

Controller has completed last triggered indirect operation.

ALT_QSPI_INT_STATUS_IDAC_OP_REJECT 

Indirect operation was requested but could not be accepted. Two indirect operations already in storage.

ALT_QSPI_INT_STATUS_WR_PROT_VIOL 

Write to protected area was attempted and rejected.

ALT_QSPI_INT_STATUS_ILL_AHB_ACCESS 

Illegal AHB Access Detected. AHB write wrapping bursts and the use of SPLIT/RETRY accesses will cause this interrupt to trigger.

ALT_QSPI_INT_STATUS_IDAC_WTRMK_TRIG 

Indirect Transfer Watermark Level Breached.

ALT_QSPI_INT_STATUS_RX_OVF 

Receive Overflow. This should only occur in Legacy SPI mode.

Set if an attempt is made to push the RX FIFO when it is full. This bit is reset only by a system reset and cleared only when this register is read. If a new push to the RX FIFO occurs coincident with a register read this flag will remain set.

  • 0 = no overflow has been detected.
  • 1 = an overflow has occurred.
ALT_QSPI_INT_STATUS_TX_FIFO_NOT_FULL 

Small TX FIFO not full (current FIFO status). Can be ignored in non-SPI legacy mode.

  • 0 = FIFO has >= THRESHOLD entries.
  • 1 = FIFO has < THRESHOLD entries.
ALT_QSPI_INT_STATUS_TX_FIFO_FULL 

Small TX FIFO full (current FIFO status). Can be ignored in non-SPI legacy mode.

  • 0 = FIFO is not full.
  • 1 = FIFO is full.
ALT_QSPI_INT_STATUS_RX_FIFO_NOT_EMPTY 

Small RX FIFO not empty (current FIFO status). Can be ignored in non-SPI legacy mode.

  • 0 = FIFO has < RX THRESHOLD entries.
  • 1 = FIFO has >= THRESHOLD entries.
ALT_QSPI_INT_STATUS_RX_FIFO_FULL 

Small RX FIFO full (current FIFO status). Can be ignored in non-SPI legacy mode.

  • 0 = FIFO is not full.
  • 1 = FIFO is full.
ALT_QSPI_INT_STATUS_IDAC_RD_FULL 

Indirect Read partition of SRAM is full and unable to immediately complete indirect operation.

Function Documentation

◆ alt_qspi_disable()

ALT_STATUS_CODE alt_qspi_disable ( void  )

Disable the QSPI Controller.

Disable the QSPI once the current transfer of the data word (FF_W) is complete. All output enables are inactive and all pins are set to input mode.

Return values
ALT_E_SUCCESSIndicates successful completion.
ALT_E_ERRORIndicates an error occurred.

◆ alt_qspi_enable()

ALT_STATUS_CODE alt_qspi_enable ( void  )

Enable the QSPI Controller.

Return values
ALT_E_SUCCESSIndicates successful completion.
ALT_E_ERRORIndicates an error occurred.

◆ alt_qspi_init()

ALT_STATUS_CODE alt_qspi_init ( void  )

Initialize the QSPI flash controller for use.

Return values
ALT_E_SUCCESSIndicates successful completion.
ALT_E_ERRORIndicates an error occurred.

◆ alt_qspi_int_clear()

ALT_STATUS_CODE alt_qspi_int_clear ( const uint32_t  mask)

Clears the specified QSPI controller interrupt status conditions identified in the mask.

This function clears one or more of the status conditions as contributors to the ALT_INT_INTERRUPT_QSPI_IRQ interrupt signal state.

Parameters
maskSpecifies the QSPI interrupt status conditions to clear. mask is a mask of logically OR'ed ALT_QSPI_INT_STATUS_t values that designate the status conditions to clear.
Return values
ALT_E_SUCCESSIndicates successful completion.
ALT_E_ERRORIndicates an error occurred.

◆ alt_qspi_int_disable()

ALT_STATUS_CODE alt_qspi_int_disable ( const uint32_t  mask)

Disable the specified QSPI controller interrupt status conditions identified in the mask.

This function disables one or more of the status conditions as contributors to the ALT_INT_INTERRUPT_QSPI_IRQ interrupt signal state.

This API requires that the QSPI controller be idle, as determined by alt_qspi_is_idle().

NOTE: A cleared bit for any status condition in the mask value does not have the effect of enabling it as a contributor to the ALT_INT_INTERRUPT_QSPI_IRQ interrupt signal state. The function alt_qspi_int_enable() is used to enable status source conditions.

Parameters
maskSpecifies the status conditions to disable as interrupt source contributors. mask is a mask of logically OR'ed ALT_QSPI_INT_STATUS_t values that designate the status conditions to disable.
Return values
ALT_E_SUCCESSIndicates successful completion.
ALT_E_ERRORIndicates an error occurred.

◆ alt_qspi_int_enable()

ALT_STATUS_CODE alt_qspi_int_enable ( const uint32_t  mask)

Enable the specified QSPI controller interrupt status conditions identified in the mask.

This function enables one or more of the status conditions as contributors to the ALT_INT_INTERRUPT_QSPI_IRQ interrupt signal state.

This API requires that the QSPI controller be idle, as determined by alt_qspi_is_idle().

NOTE: A cleared bit for any status condition in the mask value does not have the effect of disabling it as a contributor to the ALT_INT_INTERRUPT_QSPI_IRQ interrupt signal state. The function alt_qspi_int_disable() is used to disable status source conditions.

Parameters
maskSpecifies the status conditions to enable as interrupt source contributors. mask is a mask of logically OR'ed ALT_QSPI_INT_STATUS_t values that designate the status conditions to enable.
Return values
ALT_E_SUCCESSIndicates successful completion.
ALT_E_ERRORIndicates an error occurred.

◆ alt_qspi_int_status_get()

uint32_t alt_qspi_int_status_get ( void  )

Returns the QSPI controller interrupt status register value.

This function returns the current value of the QSPI controller interrupt status register value which reflects the current QSPI controller status conditions.

Returns
The current value of the QSPI controller interrupt status register value which reflects the current QSPI controller status conditions as defined by the ALT_QSPI_INT_STATUS_t mask. If the corresponding bit is set then the condition is asserted.

◆ alt_qspi_is_idle()

bool alt_qspi_is_idle ( void  )

Returns true the serial interface and QSPI pipeline is IDLE.

Returns
Returns true the serial interface and QSPI pipeline is IDLE.

◆ alt_qspi_uninit()

ALT_STATUS_CODE alt_qspi_uninit ( void  )

Uninitialize the QSPI flash controller.

Uninitialize the QSPI flash controller by cancelling any indirect transfers in progress and putting the QSPI controller into reset.

Return values
ALT_E_SUCCESSIndicates successful completion.
ALT_E_ERRORIndicates an error occurred.