Generic SPI#

gspi_event_typedef_t#

gspi_event_typedef_t

Enumeration for different GSPI callback events.

sl_gspi_power_state_t#

sl_gspi_power_state_t

Enumeration for GSPI power state.

clock_mode_typedef_t#

clock_mode_typedef_t

Enumeration for GSPI clock modes.

master_mode_typedef_t#

master_mode_typedef_t

Enumeration for GSPI master modes.

slave_select_mode_typedef_t#

slave_select_mode_typedef_t

Enumeration for GSPI slave select mode.

sl_gspi_instance_t#

sl_gspi_instance_t

Enumeration for GSPI Master instance, enum for one member, future provision is provided.

sl_gspi_slave_number_t#

sl_gspi_slave_number_t

Enumeration for GSPI Slave numbers.

sl_gspi_signal_event_t#

typedef ARM_SPI_SignalEvent_t sl_gspi_signal_event_t

Renamed signal event structure.

sl_gspi_status_t#

typedef ARM_SPI_STATUS sl_gspi_status_t

Renamed status structure.

sl_gspi_driver_t#

typedef ARM_DRIVER_SPI sl_gspi_driver_t

Renamed GSPI driver structure.

sl_gspi_handle_t#

typedef const void* sl_gspi_handle_t

Created GSPI handle type.

sl_si91x_gspi_configure_clock#

sl_status_t sl_si91x_gspi_configure_clock (sl_gspi_clock_config_t * clock_configuration)

Set the clock for the GSPI peripheral, Configures the PLL clock and SOC clock with the value set by user in the clock configuration structure.

Returns

• status 0 if successful, else error code SL_STATUS_OK (0x0000) - Success SL_STATUS_NULL_POINTER (0x0022) - The parameter is null pointer SL_STATUS_INVALID_PARAMETER (0x0021) - Parameters are invalid SL_STATUS_FAIL (0x0001) - The function is failed SL_STATUS_NOT_INITIALIZED (0x0011) - Clock is not initialized

sl_si91x_gspi_init#

sl_status_t sl_si91x_gspi_init (sl_gspi_instance_t instance, sl_gspi_handle_t * gspi_handle)

Initialize the GSPI.

If the DMA is enabled, it also initializes the DMA. Pass the address of the pointer for storing the GSPI master handle, which can be used in future for other function calls.

• sl_si91x_gspi_configure_clock

Returns

• status 0 if successful, else error code SL_STATUS_OK (0x0000) - Success SL_STATUS_INVALID_PARAMETER (0x0021) - Parameters are invalid SL_STATUS_BUSY (0x0004) - Driver is busy

sl_si91x_gspi_deinit#

sl_status_t sl_si91x_gspi_deinit (sl_gspi_handle_t gspi_handle)

Uninitialize the GSPI.

If the DMA is enabled, it also uninitializes the DMA.

• sl_si91x_gspi_init

Returns

• status 0 if successful, else error code SL_STATUS_OK (0x0000) - Success SL_STATUS_NULL_POINTER (0x0022) - The parameter is null pointer

sl_si91x_gspi_configure_power_mode#

sl_status_t sl_si91x_gspi_configure_power_mode (sl_gspi_handle_t gspi_handle, sl_gspi_power_state_t state)

Change the power mode of GSPI, the supported modes are.

• POWER_OFF

• FULL_POWER

• sl_si91x_gspi_configure_clocksl_si91x_gspi_init

Returns

• status 0 if successful, else error code SL_STATUS_OK (0x0000) - Success SL_STATUS_NULL_POINTER (0x0022) - The parameter is null pointer SL_STATUS_INVALID_PARAMETER (0x0021) - Parameters are invalid SL_STATUS_FAIL (0x0001) - The function is failed SL_STATUS_NOT_SUPPORTED (0x000F) - Parameter is not supported

sl_si91x_gspi_set_configuration#

sl_status_t sl_si91x_gspi_set_configuration (sl_gspi_handle_t gspi_handle, sl_gspi_control_config_t * control_configuration)

sl_si91x_gspi_receive_data#

sl_status_t sl_si91x_gspi_receive_data (sl_gspi_handle_t gspi_handle, void * data, uint32_t data_length)

Receive data from the slave device.

• sl_si91x_gspi_configure_clocksl_si91x_gspi_initsl_si91x_gspi_configure_power_mode sl_si91x_gspi_set_configuration sl_si91x_gspi_set_slave_number

Returns

• status 0 if successful, else error code SL_STATUS_OK (0x0000) - Success SL_STATUS_NULL_POINTER (0x0022) - The parameter is null pointer SL_STATUS_INVALID_PARAMETER (0x0021) - Parameters are invalid SL_STATUS_FAIL (0x0001) - The function is failed SL_STATUS_BUSY (0x0004) - Driver is busy

sl_si91x_gspi_send_data#

sl_status_t sl_si91x_gspi_send_data (sl_gspi_handle_t gspi_handle, const void * data, uint32_t data_length)

Send data to the slave device.

• sl_si91x_gspi_configure_clocksl_si91x_gspi_initsl_si91x_gspi_configure_power_mode sl_si91x_gspi_set_configuration sl_si91x_gspi_set_slave_number

Returns

• status 0 if successful, else error code SL_STATUS_OK (0x0000) - Success SL_STATUS_NULL_POINTER (0x0022) - The parameter is null pointer SL_STATUS_INVALID_PARAMETER (0x0021) - Parameters are invalid SL_STATUS_FAIL (0x0001) - The function is failed SL_STATUS_BUSY (0x0004) - Driver is busy

sl_si91x_gspi_transfer_data#

sl_status_t sl_si91x_gspi_transfer_data (sl_gspi_handle_t gspi_handle, const void * data_out, void * data_in, uint32_t data_length)

Send and receive data to the slave device simultaneously.

• sl_si91x_gspi_configure_clocksl_si91x_gspi_initsl_si91x_gspi_configure_power_mode sl_si91x_gspi_set_configuration sl_si91x_gspi_set_slave_number

Returns

• status 0 if successful, else error code SL_STATUS_OK (0x0000) - Success SL_STATUS_NULL_POINTER (0x0022) - The parameter is null pointer SL_STATUS_INVALID_PARAMETER (0x0021) - Parameters are invalid SL_STATUS_FAIL (0x0001) - The function is failed SL_STATUS_BUSY (0x0004) - Driver is busy

sl_si91x_gspi_set_master_state#

sl_status_t sl_si91x_gspi_set_master_state (sl_gspi_handle_t gspi_handle, boolean_t value)

Set main state i.e., activate/de-activate the main.

• sl_si91x_gspi_configure_clocksl_si91x_gspi_initsl_si91x_gspi_configure_power_mode

Returns

• status 0 if successful, else error code SL_STATUS_OK (0x0000) - Success SL_STATUS_NULL_POINTER (0x0022) - The parameter is null pointer SL_STATUS_BUSY (0x0004) - Driver is busy SL_STATUS_INVALID_MODE (0x0024) - Mode is invalid (Fails to activate master)

sl_si91x_gspi_register_event_callback#

sl_status_t sl_si91x_gspi_register_event_callback (sl_gspi_handle_t gspi_handle, sl_gspi_signal_event_t callback_event)

Register the user callback function.

Returns

• status 0 if successful, else error code SL_STATUS_OK (0x0000) - Success SL_STATUS_NULL_POINTER (0x0022) - The parameter is null pointer SL_STATUS_BUSY (0x0004) - Driver is busy

sl_si91x_gspi_unregister_event_callback#

void sl_si91x_gspi_unregister_event_callback (void )

Un-register the user callback function.

• sl_si91x_gspi_register_event_callback

Returns

• none

sl_si91x_gspi_get_version#

sl_gspi_version_t sl_si91x_gspi_get_version (void )

Get the release, sqa and dev version of GSPI.

Returns

• (sl_gspi_version_t) type structure

sl_si91x_gspi_get_status#

sl_gspi_status_t sl_si91x_gspi_get_status (sl_gspi_handle_t gspi_handle)

Get the transfer status GSPI.

• sl_si91x_gspi_configure_clocksl_si91x_gspi_initsl_si91x_gspi_configure_power_mode sl_si91x_gspi_set_configuration

Returns

• sl_gspi_status_t type structure

sl_si91x_gspi_get_rx_data_count#

uint32_t sl_si91x_gspi_get_rx_data_count (sl_gspi_handle_t gspi_handle)

Get data receive count of the GSPI.

• sl_si91x_gspi_configure_clocksl_si91x_gspi_initsl_si91x_gspi_configure_power_mode sl_si91x_gspi_set_configuration

Returns

• uint32_t value of the RX data count

sl_si91x_gspi_get_tx_data_count#

uint32_t sl_si91x_gspi_get_tx_data_count (void )

Get the transmit data count of GSPI.

• sl_si91x_gspi_configure_clocksl_si91x_gspi_initsl_si91x_gspi_configure_power_mode sl_si91x_gspi_set_configuration

Returns

• uint32_t value of the tx data count

sl_si91x_gspi_get_clock_division_factor#

int32_t sl_si91x_gspi_get_clock_division_factor (sl_gspi_handle_t gspi_handle)

Fetch the clock division factor.

Returns

• factor(int32_t) The value of clock division factor

sl_si91x_gspi_get_frame_length#

uint32_t sl_si91x_gspi_get_frame_length (void )

Fetch the frame length i.e., bit width.

Returns

• frame_length (uint32_t) The value of frame length

sl_si91x_gspi_set_slave_number#

__STATIC_INLINE sl_status_t sl_si91x_gspi_set_slave_number (uint8_t number)

Set the slave number in multi-slave operation.

For single slave also, this API needs to be called before transferring the data

Returns

• none