QSPI Peripheral

R2026b

Write data to and read data from an SPI controller device

Since R2024a

• 

QSPI Peripheral block

To add a block to a model, double-click the canvas and start typing the block name. Then, select the block from the list.

Libraries:
Embedded Coder Support Package for Infineon AURIX TC3x Microcontrollers / AURIX TC3x

Description

Add-On Required: This feature requires the Embedded Coder Support Package for Infineon AURIX TC3x Microcontrollers add-on.

Write data to and read data from an SPI controller device.

The Queued Synchronous Peripheral Interface (QSPI) Peripheral block accepts 1-D array of data type int8, uint8, int16, uint16, int32, and uint32.

The QSPI Controller block or any external controller generates and configures the clock and chip select signals for this block.

Examples

Getting Started with QSPI Communication for Infineon AURIX TC3x Microcontrollers

The use the QSPI Controller and QSPI Peripheral blocks from Embedded Coder® Support Package for Infineon® AURIX™ TC3x Microcontrollers to handle data through interrupts.

• Open Model

Ports

Input

SDO — Serial data out

scalar | vector

This port accepts the data to be transmitted to the peripheral device, with the data type defined by the Data bits and Output data type parameters.

Dependencies

To enable this port, set the Transfer mode parameter to SPI Transmit.

Data Types: int8 | uint8 | int16 | uint16 | int32 | uint32

SDImsg — SoC simulation message

scalar

If you set the Transfer mode parameter to SPI Receive, the QSPI block converts the SoC message SDImsg into output data at the SDI output port during simulation.

Dependencies

To enable this port, select the Enable simulation port parameter and set the port type as SoC Data (Message based).

SDIsig — Simulink based simulation signal

scalar | vector

If you set the Transfer modeparameter to SPI Receive, this input port acts as pass-through with the SDI output of QSPI block during simulation.

Dependencies

To enable this port, select the Enable simulation port parameter and set the port type as Signal.

Output

SDI — Serial data in

scalar | vector

This port outputs the data received from the peripheral device, with the size and type defined by the Output data length and Output data type parameters.

Dependencies

To enable this port, set the Transfer mode parameter to SPI Receive.

Data Types: int8 | uint8 | int16 | uint16 | int32 | uint32

status — Status of QSPI

scalar

The block outputs the status of the received data or any errors that occurred during the data transmission and reception as a unit16 scalar value.

Bit	Status
Bit 0	Transaction successful
Bit 1	Busy
Bit 2	Parity error
Bit 3	Configuration error
Bit 4	Baud rate error
Bit 5	Transmit buffer (Tx FIFO) overflow error
Bit 6	Tx FIFO underflow error
Bit 7	Receive buffer (Rx FIFO) overflow error
Bit 8	Rx FIFO underflow error
Bit 9	Timeout error
Bit 10	SLSI misplaced inactivation

For example, the status of 17 (sets 4^th and 0^th bit) represents successful transaction with baud rate error.

Dependencies

To enable this port, select the Enable status port parameter.

Data Types: uint16

SDOmsg — SoC simulation message

scalar

If you set the Transfer modeparameter to SPI Transmit, this port outputs the data received at SDO port in message form during simulation.

Dependencies

To enable this port, select the Enable simulation port parameter and set the Port Type as SoC Data (Message based).

SDOsig — Simulink based simulation signal

scalar | vector

If you set the Transfer mode parameter to SPI Transmit, this port outputs the data received at SDO port during simulation.

Dependencies

To enable this port, select the Enable simulation port parameter and set the Port Type as Signal.

Parameters

Basic

Transfer mode — Select QSPI communication mode

SPI Receive (default) | SPI Transmit

Select one of these operation modes:

• SPI Transmit — In this mode, the block transmits data to the peripheral device. When you select this transfer mode, the block configures an input port, SDO.

• SPI Receive — In this transfer mode, the block receives data from peripheral device. When you select this transfer mode, the block enables an output port, SDI.

Data bits — Number of data bits in QSPI communication

32 (default) | 2 | 3 | ...

This parameter specifies the frame length of each data element used in QSPI communication. The selected frame length determines the valid data type for the SDO and SDI ports.

• For frame length 2 to 8, the valid data types are int8 or unit8.

• For frame length 9 to 16, the valid data types are int16 or unit16.

• For frame length 17 to 32, the valid data types are int32 or unit32.

Enable status port — Option to configure output status port

off (default) | on

Select this parameter to output status of data transfer.

When you select this parameter, the block enables the status port.

Sample time — Frequency at which block reads input data

-1 (default) | scalar | vector

Specify in seconds how often the block should read the input data.

When you specify this parameter as -1, Simulink^® determines the best sample time for the block based on the block context within the model.

Dependencies

To enable this parameter, set the Transfer mode to SPI Receive.

Enable simulation port — Enable peripheral simulation ports in the block

off (default) | on

Select this parameter to enable peripheral simulation capability.

Port Type — Specify the type of peripheral simulation port

SoC Data (Message based) (default) | Signal

Select this parameter to configure either the SoC compatible or the Simulink signal based simulation ports to enable peripheral simulation capability.

Dependencies

To view this parameter, select the Enable simulation port parameter.

Advanced

Output data length — Specify data length to be received

1 (default) | positive integer

Specify the data length to be received from the controller device.

Note

The data length specified must match the data transmitted using QSPI controller block.

Dependencies

To enable this parameter, set the Transfer mode to SPI Receive.

Output data type — Select output data type

option vary based on the value of Data bits parameter

Select the supported data types based on the data bits selected.

Dependencies

To enable this parameter, set the Transfer mode to SPI Receive.

Programmatic Use: Add Block

To add the block programmatically, use the add_block function with one of these library block paths as the source.

"aurixtc3xxlib/QSPIPeripheral"

Example: add_block("aurixtc3xxlib/QSPIPeripheral","myModel/myBlock",MakeNameUnique="on")

Version History

Introduced in R2024a