Air780E的I2C软件使用指南

​

今天我们学习合宙低功耗4G模组Air780E的I2C接口操作方法，文末【阅读原文】获取最新资料。

一、I2C概述

Air780E可支持1路I2C接口，如果复用的话最多有两路：

​

I2C配置：

兼容PhilipsI2C标准协议。

支持Fastmode（400Kbps）和Slowmode（100Kbps）。

只支持master模式，不支持slaver模式。

可通过软件来配置内部的上拉电阻，1.8K或者20K。

理论上最多可支持127个从设备。

管脚名	类型	序号	电压域	描述
I2C_SCL	IO	67	VDD_EXT	I2C时钟信号，用作I2C时需外加上拉
I2C_SDA	IO	66	VDD_EXT	I2C时钟信号，用作I2C时需外加上拉

I2C的参考电路如下：

​

Air780E的I2C接口电压是1.8V/3.3V可配置，通过PIN100IO_SEL配置IO口电平，能够满足大部分外设的直接需求，但是如果要和5V或者以上电平的外设通信，那就必须要加电平转换电路

​

二、演示功能概述

本例程将使用I2C协议读取传感器数据并打印出来。

三、准备硬件环境

3.1 780E开发板一套

此核心板的详细使用说明参考：Air780E产品手册中的<<开发板Core_Air780E使用说明V1.0.5.pdf>>；核心板使用过程中遇到任何问题，可以直接参考这份使用说明pdf文档。

​

3.2 数据通信线

typec接口USB数据线即可。

3.3 PC电脑

WINDOWS系统。

3.4 sht20温湿度传感器一个

​

3.5 780E与sht20接线图如下

​

四、准备软件环境

4.1 基本的下载调试工具

使用说明参考：Luatools下载和详细使用；

https://docs.openluat.com/Luatools/

五、使用I2C读取sht20软硬件资料

5.1 文档和工具：

• 780E模块使用固件：SDK&Demo-合宙文档中心，本demo使用的固件版本是：

  LuatOS-SoC_V1112_EC618_FULL.soc

• 本教程使用的demo：

  https://gitee.com/openLuat/LuatOS-Air780E/tree/master/demo/sht20

• 将固件和脚本烧录到模块中：Luatools下载和使用教程-合宙模组资料中心

• 源码和固件已打包，如下所示：右键点我,另存为,下载完整压缩文件包

5.2demo使用api介绍

i2c.setup(id,speed,pullup)

作用：i2c初始化

参数：

传入值类型	解释
int	设备id,例如i2c1的id为1,i2c2的id为2
int	I2C速度,例如i2c.FAST
bool	是否软件上拉,默认不开启，需要硬件支持

返回值：

返回值类型	解释
int	成功就返回1,否则返回0

i2c.send(id,addr,data,stop)

作用：i2c发送数据

参数：

传入值类型	解释
int	设备id,例如i2c1的id为1,i2c2的id为2
int	I2C子设备的地址,7位地址
integer/string/table	待发送的数据,自适应参数类型
integer	可选参数是否发送停止位1发送0不发送默认发送(105不支持)

返回值：

传入值类型	解释
true/false	发送是否成功

i2c.recv(id,addr,len)

作用：i2c接收数据

传入值类型	解释
int	设备id,例如i2c1的id为1,i2c2的id为2
int	I2C子设备的地址,7位地址
int	接收数据的长度

返回值：

传入值类型	解释
string	收到的数据

六、代码示例介绍

6.1 读取SHT20温湿度传感器

6.1.1 SHT20简介：

SHT20是使用I2C协议进行通信的温湿度传感器。

首先我们可以发送STH20的7位从机地址+1位读写位（写0读1），然后发送8位的命令，0xF3是读取温度的命令，0xF5是读取湿度的命令。发送完后接收应答，等待20us之后我们发出I2C的结束时序。

6.1.2 demo介绍

首先初始化i2c，然后给sht20发送读取温湿度命令，接收sht20回传的数据即可。

​

6.1.3 将程序下载到开发板：

使用说明参考：Luatools下载和详细使用

https://docs.openluat.com/Luatools/

七、功能验证

成功使用I2C协议读取到sht20传感器的温湿度数值。

​

八、总结

本例程使用i2c协议读取了sht20传感器传输的温湿度数值。

九、常见问题

9.1 i2c每次读写数据前都需要setup一次吗？

不需要。

正常的业务逻辑为：

i2c.setup，

…此处可以多次读写数据，

i2c.close，

setup之后，只要没有close，就可以反复读写数据，

一旦执行了close，下次读写数据前，必须再次setup。

9.2 i2c通信时模块可以做从设备吗？

注意：模块I2C只能做主设备，外部需要上拉，在配置FAST速率时，上拉电阻阻值不要大于4.7K。

9.3 i2c设备7位的地址为0x38，需要我手动转换到8位地址吗？

这里i2c_addr地址是7bit地址，如果i2c外设手册中给的是8bit地址，需要把8bit地址右移1位，赋值给i2c_addr变量；如果i2c外设手册中给的是7bit地址，直接把7bit地址赋值给i2c_addr变量即可。

​