Struct XIP_SSI

source

pub struct XIP_SSI { /* private fields */ }

Expand description

DW_apb_ssi has the following features:

APB interface - Allows for easy integration into a DesignWare Synthesizable Components for AMBA 2 implementation.
APB3 and APB4 protocol support.
Scalable APB data bus width - Supports APB data bus widths of 8, 16, and 32 bits.
Serial-master or serial-slave operation - Enables serial communication with serial-master or serial-slave peripheral devices.
Programmable Dual/Quad/Octal SPI support in Master Mode.
Dual Data Rate (DDR) and Read Data Strobe (RDS) Support - Enables the DW_apb_ssi master to perform operations with the device in DDR and RDS modes when working in Dual/Quad/Octal mode of operation.
Data Mask Support - Enables the DW_apb_ssi to selectively update the bytes in the device. This feature is applicable only in enhanced SPI modes.
eXecute-In-Place (XIP) support - Enables the DW_apb_ssi master to behave as a memory mapped I/O and fetches the data from the device based on the APB read request. This feature is applicable only in enhanced SPI modes.
DMA Controller Interface - Enables the DW_apb_ssi to interface to a DMA controller over the bus using a handshaking interface for transfer requests.
Independent masking of interrupts - Master collision, transmit FIFO overflow, transmit FIFO empty, receive FIFO full, receive FIFO underflow, and receive FIFO overflow interrupts can all be masked independently.
Multi-master contention detection - Informs the processor of multiple serial-master accesses on the serial bus.
Bypass of meta-stability flip-flops for synchronous clocks - When the APB clock (pclk) and the DW_apb_ssi serial clock (ssi_clk) are synchronous, meta-stable flip-flops are not used when transferring control signals across these clock domains.
Programmable delay on the sample time of the received serial data bit (rxd); enables programmable control of routing delays resulting in higher serial data-bit rates.
Programmable features:

Serial interface operation - Choice of Motorola SPI, Texas Instruments Synchronous Serial Protocol or National Semiconductor Microwire.
Clock bit-rate - Dynamic control of the serial bit rate of the data transfer; used in only serial-master mode of operation.
Data Item size (4 to 32 bits) - Item size of each data transfer under the control of the programmer.

Configured features:

FIFO depth - 16 words deep. The FIFO width is fixed at 32 bits.
1 slave select output.
Hardware slave-select - Dedicated hardware slave-select line.
Combined interrupt line - one combined interrupt line from the DW_apb_ssi to the interrupt controller.
Interrupt polarity - active high interrupt lines.
Serial clock polarity - low serial-clock polarity directly after reset.
Serial clock phase - capture on first edge of serial-clock directly after reset.

Implementations§

source §

impl XIP_SSI

source

pub const PTR: const RegisterBlock = {0x18000000 as const xip_ssi::RegisterBlock}

Pointer to the register block

source

pub const fn ptr() -> *const RegisterBlock

Return the pointer to the register block

source

pub unsafe fn steal() -> Self

Steal an instance of this peripheral

§Safety

Ensure that the new instance of the peripheral cannot be used in a way that may race with any existing instances, for example by only accessing read-only or write-only registers, or by consuming the original peripheral and using critical sections to coordinate access between multiple new instances.

Additionally, other software such as HALs may rely on only one peripheral instance existing to ensure memory safety; ensure no stolen instances are passed to such software.