类 SPI – 串行外设接口总线协议 (主端)

什么是SPI?

SPI是串行外设接口(Serial Peripheral Interface)的缩写。是 Motorola 公司推出的一 种同步串行接口技术,是一种高速的,全双工,同步的通信总线。 SPI协议主要用于短距离的通信系统中,特别是嵌入式系统,很多芯片的外围设备,比如LED显示驱动器、I/O接口芯片、UART收发器等都广泛的采用SPI总线协议。

SPI是由主设备驱动的同步串行协议。在物理层面,总线由3条线组成:SCK,MOSI,MISO。 多个设备可以共享同一总线。每个设备都应有一个单独的第4个信号SS(从选择),用于选择与之进行通信的总线上的特定设备。 SS信号的管理应该在用户代码中进行(通过 machine.Pin 类)。

构建对象

class machine.SPI(id, ...)

在给定总线上构造SPI对象。

  • id - 为1 时,为硬件SPI。该值缺省时为构建软件SPI。

硬件SPI的构造:

>>> from machine import SPI
>>> hspi = SPI(1)
>>> hspi
SPI(id=1, baudrate=500000, polarity=0, phase=0, bits=8, firstbit=0, sck=-1, mosi=-1, miso=-1)
>>>

软SPI的构建:

from machine import SPI, Pin

spi = SPI(baudrate=100000, polarity=1, phase=0, sck=Pin(17), mosi=Pin(27), miso=Pin(18))

方法

SPI.init(baudrate=1000000, \*, polarity=0, phase=0, bits=8, firstbit=SPI.MSB, sck=None, mosi=None, miso=None, pins=(SCK, MOSI, MISO))

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

  • baudrate SCK时钟频率。

  • polarity 0或1,空闲时钟线所在的电平。

  • phase 0或1来分别在第一或第二时钟边沿上采样数据。

  • bits 每次传输的宽度(以位为单位)。所有硬件都保证只支持8个。

  • firstbit 可以是 SPI.MSBSPI.LSB.

  • sck, mosi, miso 是 pins (machine.Pin) 对象以用于总线信号。对于大多数硬件SPI块(由 id 构建对象的参数选择),引脚是固定的,不能更改。在某些情况下,硬件模块允许2-3个替代引脚组用于硬件SPI模块。任意引脚分配仅适用于bitbanging SPI驱动程序( id = -1)。

  • pins - esp32没有 sckmosimiso 参数,而是允许指定它们作为一个元组 pins 参数。

SPI.deinit()

关闭SPI总线。

SPI.read(nbytes, write=0)

读取指定的字节数, nbytes 同时连续写入由给定的单字节 write 。返回包含 bytes 已读取数据的对象。

SPI.readinto(buf, write=0)

读入 buf 指定的缓冲区,同时不断写入由 write 给出的单字节。

返回 None

注意:在 esp32 上,此函数返回读取的字节数。

SPI.write(buf)

写入 `` buf`` 中的字节。

返回 None

注意::在 esp32 上,此函数返回写入的字节数。

SPI.write_readinto(write_buf, read_buf)

write_buf 中写入字节,同时读入 read_buf 中。缓冲区可以是相同的,也可以是不同的,但是两个缓冲区都必须具有 长度相同。

返回 None

注意:在 esp32 上,此函数返回写入的字节数。

常数

SPI.MASTER

用于初始化SPI总线到主机; 这仅用于 esp32

SPI.MSB

将第一位设置为最高位。

SPI.LSB

将第一个位设置为最低位。