廉江市住房和城乡建设局网站yy直播

学物联网，来万物简单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的从机设备写入缓冲区数据