Page Comparison

...

Anchor11429751142975 SPI BSP Anchor11429761142976Among the most common—and simplest—serial interfaces supported by built-in CPU peripherals is Serial Peripheral Interface (SPI). Four hardware signals connect a defined master (or host) to each slave (or device): a slave select, a clock, a slave input and a slave output. Three of these, all except the slave select, may be shared among all slaves, though hosts often have several SPI controllers to simplify integration and allow simultaneous access to multiple slaves. Serial flash, serial EEPROM and SD/MMC cards are among the many devices which use SPI. Anchor11429981142998  

...

...

...

...

...

...

...

...

...

...

...

Anchor11430001143000Table C-3 SPI signals

No specification exists for SPI, a condition which invites technological divergence. So though the simplicity of the interface limits variations between implementations, the required transfer unit length, shift direction, clock frequency and clock polarity and phase do vary from device to device. Take as an example Figure C Figure C-3 which gives the bit form of a basic command/response exchange on a typical serial flash. The command and response both divide into 8-bit chunks, the transfer unit for the device. Within these units, the data is transferred from most significant bit (MSB) to least significant bit (LSB), which is the slave’s shift direction. Though not evident from the diagram—the horizontal axis being labeled in clocks rather than time—the slave cannot operate at a frequency higher than 20-MHz. Finally, the clock signal prior to slave select activation is low (clock polarity or CPOL is 0), and data is latched on the rising clock edge (clock phase or CPHA is 0). Together, those are the aspects of SPI communication that may need to be configured: Anchor11430041143004

...

If CPOL = 1, the clock is high when inactive.

...

...

If CPHA = 1, data is “changed” on the leading edge of the clock and “read” on the leading edge.

...

The most commonly-supported settings are {CPOL, CPHA} = {0, 0} and {1, 1}.

...

A BSP is required that abstracts a CPU’s SPI peripheral. The port includes one code file named according to the following rubric: Anchor11430211143021

FS_DEV_<dev_name>_BSP.C or FS_DEV_<dev_name>_SPI_BSP.c Anchor11430221143022

This file is generally placed with other BSP files in a directory named according to the following rubric: Anchor11430231143023

\Micrium\Software\EvalBoards\<manufacturer>\<board_name>

Anchor11430241143024\<compiler>\BSP\ Anchor11430251143025

Several example ports are included in the µC/FS distribution in files named according to the following rubric: Anchor11430261143026

\Micrium\Software\uC-FS\Examples\BSP\Dev\NAND\<manufacturer>\<cpu_name>

...

\Micrium\Software\uC-FS\Examples\BSP\Dev\NOR\<manufacturer>\<cpu_name>
...
\Micrium\Software\uC-FS\Examples\BSP\Dev\SD\SPI\<manufacturer>\<cpu_name> Anchor11430291143029
Check all of these directories for ports for a CPU if porting any SPI device; the CPU may be been used with a different type of device, but the port should support another with none or few modifications. Each port must implement the functions to be placed into a FS_DEV_SPI_API structure: Anchor11430631143063  
...
rowspan
11
...
...
 Anchor11430671143067The functions which must be implemented are listed and described in Table C Table C-4. SPI is no more than a physical interconnect. The protocol of command-response interchange the master follows to control a slave is specified on a per-slave basis. Control of the chip select (SSEL) is separated from the reading and writing of data to the slave because multiple bus transactions (e.g., a read then a write then another read) are often performed without breaking slave selection. Indeed, some slaves require bus transactions (or “empty” clocks) AFTER the select has been disabled. Anchor11431091143109  
...
Function
...
Description
...
Open()
...
Open (initialize) hardware for SPI.
...
...
Close()
...
Close (uninitialize) hardware for SPI.
...
...
Lock()
...
Acquire SPI bus lock.
...
Unlock()
...
Release SPI bus lock.
...
Rd()
...
Read from SPI bus.
...
...
Wr()
...
Write to SPI bus.
...
ChipSelEn()
...
Enable device chip select.
...
ChipSelDis()
...
Disable device chip select
...
SetClkFreq()
...
Set SPI clock frequency
...
Table C-4 SPI port functions
...
 Anchor11431121143112
The first argument of each of these port functions is the device unit number, an identifier unique to each driver/device type—after all, it is the number in the device name. For example, “sd:0:” and “nor:0:” both have unit number 1. If two SPI devices are located on the same SPI bus, either of two approaches can resolve unit number conflicts: Anchor11431131143113
...