This is an old revision of the document!
The SPI Engine instruction set is a simple 16-bit instruction set of which 12-bit are currently allocated (bits 15,14,11,10 are always 0).
15 | 14 | 13 | 12 | 11 | 10 | 9 | 8 | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 | ||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
0 | 0 | 0 | 0 | 0 | 0 | r | w | n | n | n | n | n | n | n | n |
The transfer instructions performs a low-level SPI transfer. It will generate SCLK transitions for the specified amount of cycles according to the SPI configuration register. If the r bit is set the sdi pin will be sampled and stored in the shift register at the end of each word the data is output on the SDI_DATA stream. If the w bit is set the sdo pin will be updated with the data received from the SDO_DATA stream. If the w bit is set the sdo_t signal will also be set to 0 for the duration of the transfer. If the SDI_DATA stream is not able to accept data or the SDO_DATA stream is not able to provide data the execution is stalled at the end/start of the transfer until data is accepted/becomes available.
Name | Description | |
---|---|---|
r | Read | If set to 1 data will be read from the sdi pin during and the read words will be available on the SDI_DATA interface |
w | Write | If set to 1 data will taken from the SDO_DATA interface and output on the sdo pin. |
n | Length | n + 1 number of words will be transferred. |
15 | 14 | 13 | 12 | 11 | 10 | 9 | 8 | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 | ||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
0 | 0 | 0 | 1 | 0 | 0 | t | t | s | s | s | s | s | s | s | s |
The chip-select instruction updates the value chip-select output signal of SPI Engine execution module.
Before and after the update is performed the execution module is paused for the specified delay. The length of the delay depends on the module clock frequency, the setting of the prescaler register and the t parameter of the instruction. delay = t * (div + 1) / f_clk. This delay is inserted before and after the update of the chip-select signal, so the total execution time of the chip-select instruction is twice the delay.
Name | Description | |
---|---|---|
t | Delay | Delay before and after setting the new configuration. |
s | Chip-select | The new chip-select configuration. |
15 | 14 | 13 | 12 | 11 | 10 | 9 | 8 | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 | ||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
0 | 0 | 1 | 0 | 0 | 0 | 0 | r | v | v | v | v | v | v | v | v |
The configuration write instruction updates a configuration register of the SPI Engine execution module with a new value.
Name | Description | |
---|---|---|
r | Register | Configuration register address. 0 = SPI configuration register, 1 = |prescaler configuration register |
v | Value | New value for the configuration register. |
15 | 14 | 13 | 12 | 11 | 10 | 9 | 8 | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 | ||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
0 | 0 | 1 | 1 | 0 | 0 | 0 | 0 | n | n | n | n | n | n | n | n |
The synchronize instruction generates a synchronization event on the SYNC output stream. This can be used to monitor progress of the command stream. The synchronize instruction is also used by the SPI Engine Interconnect module to identify the end of a transaction and re-start the arbitration process.
Name | Description | |
---|---|---|
n | id | Value of the generated synchronization event. |
15 | 14 | 13 | 12 | 11 | 10 | 9 | 8 | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 | ||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
0 | 0 | 1 | 1 | 0 | 0 | 0 | 1 | t | t | t | t | t | t | t | t |
The sleep instruction stops execution of the command stream for the specified amount of time. The time is based on the external clock frequency the configuration value of the prescaler register and the time parameter of the instruction. sleep_time = t * ((div + 1) * 2) / f_clk.
Name | Description | |
---|---|---|
t | Time | The amount of time to wait. |
The SPI Engine execution module has a set of 8-bit configuration registers which can be used to dynamically modify the behavior of the module at runtime.
The SPI configuration register configures various aspects of the low-level SPI bus behavior.
Bits | Name | Description |
---|---|---|
[7:3] | reserved | Must always be 0. |
[2] | three_wire | Configures the output of the three_wire pin. |
[1] | cpol | Configures the phase of the SCLK signal. When 0, data is updated on the leading edge and sampled on the trailing edge. When 1, data is is sampled on the leading edge and updated on the trailing edge. |
[0] | cpha | Configures the polarity of the SCLK signal. When 0, the idle state of the SCLK signal is low. When 1, the idle state of the SCLK signal is high. |
The prescaler configuration register configures the divider that is applied to the module clock when generating the SCLK signal and other internal control signals used by the sleep and chip-select commands.
Bits | Name | Description |
---|---|---|
[7:0] | div | Prescaler clock divider |
The frequency of the SCLK signal is derived from the module clock frequency using the following formula: f_sclk = f_clk / ((div + 1) * 2). If no prescaler block is present div is 0.