物联网AI MicroPython学习之语法 I2C总线

news2024/10/6 13:30:42

学物联网，来万物简单IoT物联网！！

I2C 介绍

模块功能:
I2C Master设备驱动

接口说明

I2C - 构建硬件I2C对象

函数原型：I2C(id, scl, sda, freq)
参数说明：

参数	类型	必选参数？	说明
id	int	Y	I2C外设，esp32有两个外设（id = 0/1）
scl	int	N	对应I2C的时钟线，可以定义任意脚默认(不选参数) I2C0:Pin(18) I2C1:Pin(9)
sda	int	N	对应I2C的时钟线，可以定义任意脚默认(不选参数) I2C0:Pin(19) I2C1:Pin(8)
freq	int	N	I2C通信频率

返回值：
构建的I2C对象。

SoftI2C - 构建软I2C对象

函数原型：SoftI2C(scl, sda, freq)
参数说明：

参数	类型	必选参数？	说明
scl	int	Y	对应I2C的时钟线，可以定义任意脚
sda	int	Y	对应I2C的时钟线，可以定义任意脚
freq	int	Y	I2C通信频率

返回值：
构建的SoftI2C对象。

scan - 扫描从设备

函数原型：scan()
参数说明：

无

返回值：
无

start - 起始位信号

函数原型：start()
参数说明：

无

返回值：
无

stop - 停止位信号

函数原型：stop()
参数说明：

无

返回值：
无

readfrom - 从I2C总线读取数据

函数原型：readfrom(devAddr,number)
参数说明：

参数	类型	必选参数？	说明
devAddr	int	Y	I2C总线上从设备地址
number	int	Y	需要从总线上读取的数据字节数

返回值：
buffer - 总线上读取的数据缓冲区，长度为参数number

writeto - 向I2C总线写数据

函数原型：writeto(devAddr,buffer)
参数说明：

参数	类型	必选参数？	说明
devAddr	int	Y	I2C总线上从设备地址
buffer	array[]	Y	发送数据的缓冲区，期待发送的字节数为buffer的长度

返回值：
无

readfrom_mem - 从I2C设备指定地址读取数据

函数原型：readfrom_mem(devAddr, memaddr, number)
参数说明：

参数	类型	必选参数？	说明
devAddr	int	Y	I2C总线上从设备地址
memaddr	int	Y	起始地址
number	int	Y	需要从总线上读取的数据字节数

返回值：
buffer - 指定地址读取的数据缓冲区，长度为参数number

writeto_mem - 向I2C设备指定地址写数据

函数原型：writeto_mem(devAddr, memaddr,buffer)
参数说明：

参数	类型	必选参数？	说明
devAddr	int	Y	I2C总线上从设备地址
memaddr	int	Y	起始地址
buffer	array[]	Y	发送数据的缓冲区，期待发送的字节数为buffer的长度

返回值：
无
案例代码

from machine import Pin, SoftI2C, I2C

# 构建1个I2C对象
i2c = SoftI2C(scl=Pin(5), sda=Pin(4), freq=100000)

# 构建一个硬件 I2C 总线
i2c = I2C(0)
i2c = I2C(1, scl=Pin(22), sda=Pin(21), freq=400000)

i2c.scan()              # 扫描从设备

i2c.readfrom(0x3a, 4)   # 从地址为0x3a的从机设备读取4字节数据
i2c.writeto(0x3a, '12') # 向地址为0x3a的从机设备写入数据"12"

buf = bytearray(10)     # 创建1个10字节缓冲区
i2c.writeto(0x3a, buf)  # 向地址为0x3a的从机设备写入缓冲区数据