类 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总线：
baudrateSCK时钟频率。polarity0或1，空闲时钟线所在的电平。phase0或1来分别在第一或第二时钟边沿上采样数据。bits每次传输的宽度（以位为单位）。所有硬件都保证只支持8个。firstbit可以是SPI.MSB或SPI.LSB.sck,mosi,miso是 pins (machine.Pin) 对象以用于总线信号。对于大多数硬件SPI块（由id构建对象的参数选择），引脚是固定的，不能更改。在某些情况下，硬件模块允许2-3个替代引脚组用于硬件SPI模块。任意引脚分配仅适用于bitbanging SPI驱动程序（id= -1）。pins- esp32没有sck，mosi，miso参数，而是允许指定它们作为一个元组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上，此函数返回写入的字节数。