class SPI – SPI通信

该类提供串行外设接口总线协议功能。

构造函数

machine.SPI

class machine.SPI(port, mode, clk, [group])

参数描述：

• port - 通道选择[0,1]，int类型。
• mode - SPI 的工作模式，说明如下：
  时钟极性CPOL：即SPI空闲时，时钟信号SCLK的电平(0:空闲时低电平; 1:空闲时高电平)
  0 : CPOL=0, CPHA=0
  1 : CPOL=0, CPHA=1
  2: CPOL=1, CPHA=0
  3: CPOL=1, CPHA=1
• clk - 时钟频率，说明如下：
  EC600N/EC600S/EC800N/BG95M3/EC600M/EC800M/EG810M/EG912N/EC200A/EC600E/EC800E/EC800Z:
  0 : 812.5kHz
  1 : 1.625MHz
  2 : 3.25MHz
  3 : 6.5MHz
  4 : 13MHz
  5 : 26MHz(EC600E/EC800E/EC800Z不支持)
  6：52MHz(EC600E/EC800E/EC800Z不支持)
  EC600U/EC200U/EG915U:
  0 : 781.25KHz
  1 : 1.5625MHz
  2 : 3.125MHz
  3 : 5MHz
  4 : 6.25MHz
  5 : 10MHz
  6 : 12.5MHz
  7 : 20MHz
  8 : 25MHz
  9 : 33.33MHz
  BC25PA：
  0 ：5MHz
  X : XMHz (X in [1,39])
  EC600G/EC800G:
  0:97.656kHz
  1:100kHz
  2:812.5kHz
  3:1.3MHz
  4:1.625MHz
  5:2MHz
  6:3.25MHz
  7:4.333MHz
  8:6.6MHz
  9:11.93MHz
  10:13MHz
  11:13.92MHz
  12:16.7MHz
  13:20.875MHz
  14:27.83MHz
  FCM360W/FCM362K:
  0:500kHz
  1:1MHz
  2:5MHz
  3:10MHz
  4:20MHz
  
• [group] - 选择在不同管脚使用spi，缺省值为0
  

BC25PA平台不支持1、2模式。

group参数目前仅EC600M/EC800M/EG810M系列支持，group = 1 不支持挂载 nor flash

52MHz时钟频率对硬件要求较高。

示例：

>>> from machine import SPI
>>> # 创建SPI对象
>>> spi_obj = SPI(1, 0, 1)

SPI引脚对应关系：

方法

SPI.read

SPI.read(recv_data, datalen)

该方法用于读取数据。

参数描述：

• recv_data - 接收读取数据的数组，bytearray类型。
• datalen - 读取数据的长度，int类型。

返回值描述：

成功返回整型值0，失败返回整型值-1。

SPI.write

SPI.write(data, datalen)

该方法用于写入数据。

参数描述：

• data - 写入的数据，bytes类型。
• datalen - 写入的数据长度，int类型。

返回值描述：

成功返回整型值0，失败返回整型值-1。

SPI.write_read

SPI.write_read(r_data, data, datalen)

该方法用于写入和读取数据。

参数描述：

• r_data - 接收读取数据的数组，bytearray类型。
• data - 发送的数据，bytes类型。
• datalen - 读取数据的长度，int类型。

返回值描述：

成功返回整型值0，失败返回整型值-1。

SPI.close

SPI.close()

该方法用于关闭spi。

返回值描述：

成功返回整型值0，失败返回整型值-1。

使用示例：

需要配合外设使用！

import log
from machine import SPI
import utime

spi_obj = SPI(0, 0, 1)

# 设置日志输出级别
log.basicConfig(level=log.INFO)
spi_log = log.getLogger("SPI")

if __name__ == '__main__':
    r_data = bytearray(5)  # 创建接收数据的buff
    data = b"world"  # 测试数据

    ret = spi_obj.write_read(r_data, data, 5)  # 写入数据并接收
    spi_log.info(r_data)