SPI类 – 串行外设接口

SPI是由主机驱动的串行协议。其物理层包括3道线：SCK、MOSI、MISO。

请参见I2C的用法示例；SPI十分类似。主要区别在于初始化SPI总线的参数:

from pyb import SPI
spi = SPI(1, SPI.MASTER, baudrate=600000, polarity=1, phase=0, crc=0x7)

仅需参数为模式，SPI.MASTER或SPI.SLAVE。极性可为0或1，且为空闲时钟线所在的水平。 相位可为0或1，分别在第一或第二时钟沿采样数据。无CRC时Crc可为None或一个多项式说明符。

SPI的其他方法:

data = spi.send_recv(b'1234')        # send 4 bytes and receive 4 bytes
buf = bytearray(4)
spi.send_recv(b'1234', buf)          # send 4 bytes and receive 4 into buf
spi.send_recv(buf, buf)              # send/recv 4 bytes from/to buf

构造函数

class pyb.SPI(bus, ...)

在给定总线上创建一个SPI对象。bus 可为1，2 ‘X’ ‘Y’。无附加参数的情况下，SPI对象可创建但未进行初始化（若存在，其设置来自总线的最后一次初始化）。初始化参数参见 init 。

SPI总线的物理引脚为：

  • SPI(1) is on the X position: (NSS, SCK, MISO, MOSI) = (X5, X6, X7, X8) = (PA4, PA5, PA6, PA7)

  • SPI(2) is on the Y position: (NSS, SCK, MISO, MOSI) = (Y5, Y6, Y7, Y8) = (PB12, PB13, PB14, PB15)

此时，NSS引脚并未被SPI驱动占用，为可用状态。

方法

SPI.deinit()

关闭SPI总线。

SPI.init(mode, baudrate=328125, *, prescaler, polarity=1, phase=0, bits=8, firstbit=SPI.MSB, ti=False, crc=None)

使用给定参数初始化SPI总线：

  • mode 须为 SPI.MASTER 或 SPI.SLAVE.

  • baudrate 为SCK时钟频率。

  • prescaler 从APB总线频率中派生SCK所使用的的前置分频器； prescaler 的使用覆盖 baudrate.

  • polarity 可为0或1，并为闲置时钟线所在的层级。

  • phase 可为0或1，分别对应第一和第二时钟脉冲边缘的采样数据。

  • bits 可为8或16，且为每个传输词的位数。

  • firstbit 可为 SPI.MSB 或 SPI.LSB 。

  • ti 为True为Texas Instruments。

  • crc 在无CRC时可为None，或一个多项式说明符。

注意：SPI时钟线未必是符合要求的波特率。硬件仅支持APB总线频率除以预分频器的波特率（见p:meth:pyb.freq ），baudrate 可为2、4、8、16、32、64、128和256。SPI（2）在AHB1上。要精确控制SPI时钟频率，请指定 prescaler 而不是 baudrate。

打印SPI对象将显示计算波特率和所选预分频器。

SPI.recv(recv, *, timeout=5000)

Receive data on the bus:

  • recv 是一个接收字节的正数。或是一个接收数的缓冲区的元组

  • timeout is the timeout in milliseconds to wait for the receive.

返回值：若 recv 为一个整数，则有一个新的字节缓冲区来接收，否则这一缓冲区将传递给 recv .

SPI.send(send, *, timeout=5000)

在总线上发送数据:

  • send 是要发送的数据（一个整数或一个缓冲区对象）。

  • timeout 是以毫秒计的等待接收的超时时长。

Return value: None.

SPI.send_recv(send, recv=None, *, timeout=5000)

同时在总线上发送和接收数据：

  • send 是要发送的数据（一个整数或一个缓冲区对象）。

  • recv 是一个使用收到的字节来填充的可变缓冲区。可与 send 相同或省略。若省略，则创建一个新的缓冲区。

  • timeout is the timeout in milliseconds to wait for the receive.

返回值：内含接收字节的缓冲区。

常量

SPI.MASTER
SPI.SLAVE

将SPI总线初始化为主模式或从模式。

SPI.LSB
SPI.MSB

将首位设置为最小或最重要的位。