跳到主要内容

2.10 SPI 模块API手册

前言​

概述​

本文档主要介绍machine模块下的SPI类API。

读者对象​

本文档（本指南）主要适用于以下人员：

  • 技术支持工程师
  • 软件开发工程师

缩略词定义​

简称说明
SPISerial Peripheral Interface

修订记录​

文档版本号修改说明修改者日期
V1.0初版软件部2023-10-23

1. 概述​

K230内部包含三个SPI硬件模块，片选的极性可配置；支持时钟速率可配。 通道输出IO配置参考IOMUX模块。

2. API描述​

SPI类位于machine模块下

2.1 示例​

from machine import SPI
# spi init clock 5MHz, polarity 0, phase 0, data bitwide 8bits
spi = SPI(id, baudrate=5000000, polarity=0, phase=0, bits=8)
# Sending data to the slave
spi.write(buf)
# Sending data while reading data to variables
spi.write_readinto(write_buf, read_buf)
# close spi
spi.deinit()

2.2 构造函数​

spi = machine.SPI(id, baudrate=20, polarity=0, phase=0, bits=8)

【参数】

  • id： SPI ID, [02] (spi.SPI0spi.SPI2)
  • baudrate: SPI时钟baudrate，Fsclk_out=Fssi_clk/BAUDR
  • polarity: 极性
  • phase: 相位
  • bits: 数据位宽

2.3 read​

spi.read(nbytes)

读取指定的字节数

【参数】

  • nbytes： 读取长度

【返回值】

返回bytes对象

2.4 readinto​

spi.readinto(buf)

读入指定的缓冲区

【参数】

  • buf： bytearray类型的缓冲区

【返回值】

无

2.5 write​

spi.write(buf)

发送数据

【参数】

  • buf： bytearray 类型， 定义了数据及长度

【返回值】

无

2.6 write_readinto​

spi.write_readinto(write_buf, read_buf)

发送数据，同时读取数据到变量

【参数】

  • write_buf： bytearray 类型， 定义了需要发送的数据及长度
  • read_buf： bytearray 类型， 定义了接收数据存放的位置

【返回值】

无

2.7 deinit​

spi.deinit()

注销spi

【参数】

无

【返回值】

无