【玩转RT-Thread】CPK-RA6M4智慧门禁系统教学（上）

1、项目介绍

本视频秉持着学习开放的思想，在RT-Thread夏令营经历的这几周时间，自己也是结合所学知识开发出一款智慧门禁系统，而为了大家更好的学习交流，本次将以视频录制加源码开源的方式供大家学习参考。

本次项目呢主控为CPK-RA6M4开发板，是瑞萨RA6高性能系列的一款基于Arm架构的开发板，而RA产品家族也是提供了一套成熟的工具生态链来帮助开发者更好的进行产品的研发。本次我们使用瑞萨FSP（灵活配置软件包）结合RT-Thread Studio工具进行项目的研发。

下面来说说本次项目的功能：主要就是通过四大模块结合RT-Thread内核机制，开发出一款具有人员签到打卡、温湿度读取，OLED显示以及云端数据上报这四大功能。

2、前期准备

开发工具：

• RT-Thread Studio

RT-Thread Studio是一套一站式的 RT-Thread 开发工具，通过简单易用的图形化配置系统以及丰富的软件包和组件资源，让物联网开发变得简单和高效。

RT-Thread Studio 主要包括工程创建和管理，代码编辑，SDK管理，RT-Thread配置，构建配置，调试配置，程序下载和调试等功能，结合图形化配置系统以及软件包和组件资源，减少重复工作，提高开发效率。

下载链接：RT-Thread Studio 下载

• 瑞萨FSP（灵活配置软件包）

瑞萨电子灵活配置软件包 (FSP) 是一款增强型软件包，旨在为使用瑞萨电子 RA 系列 ARM 微控制器的嵌入式系统设计提供简单易用且可扩展的高质量软件。

下载链接：瑞萨FSP v3.5.0

模块:

• AHT10
• ESP8266
• RC522及读卡标签
• ssd1306 OLED显示屏

3、模块介绍及使用

3.1 AHT10

3.1.1底层I2C通信协议简介

I2C（Inter Integrated Circuit）总线是 PHILIPS 公司开发的一种半双工、双向二线制同步串行总线。I2C 总线传输数据时只需两根信号线，一根是双向数据线 SDA（serial data），另一根是双向时钟线 SCL（serial clock）。SPI 总线有两根线分别用于主从设备之间接收数据和发送数据，而 I2C 总线只使用一根线进行数据收发。

而I2C通信的读写数据是通过等待从机的应答信号（ACK）。

也就是说，当配置方向为“写数据”时，主机每发送完一个字节数据，都要等待从机的应答信号，而当数据传输结束时，主机向从机发送一个停止传输信号，表示不再传输数据；当配置方向为“读数据”时，从机每发送完一个数据，都需要等待主机的应答信号，当主机希望停止接收数据时，会向从机发送一个非应答信号（NACK），从机就不再向主机继续发送数据。

这里需要注意的是，I2C通讯常用的是复合格式，该传输过程中有两次起始信号。在第一次传输中，主机通过slave_address找到从设备后会发送一段数据（通常表示从设备内部的寄存器或存储器系统）；而在第二次的传输中，对该地址的内容进行读写，也就是说，第一次通讯时告诉从机读写地址，第二次通讯才是读写的实际内容。

当 SCL 线是高电平时， SDA 线从高电平向低电平切换，这时候代表通讯的起始；当SCL 是高电平时， SDA线由低电平向高电平切换，这代表通讯的结束。

简单来说，就是I2C 使用 SDA 信号线来传输数据，使用 SCL 信号线进行数据同步。

3.1.2 sensor框架的使用

在RT-Thread中，我们需要了解sensor设备的作用，是为上层提供统一的操作接口，提高上层代码的可重用性。

掌握sensor框架的使用，需要了解一下API的调用：

3.1.3 AHT10对接到sensor框架

首先先来介绍下接线：

然后我们打开settings，在硬件部分使能I2C1（芯片设备驱动->Enable I2C BUS->使能I2C1），同时可以检查下组件部分I2C设备驱动程序是否使能

然后使用下面的程序完成模块初始化工作

#include "sensor_asair_aht10.h"
#define AHT10_I2C_BUS  "i2c1"
/* 模块初始化工作 */
static int rt_hw_aht10_port(void)
{
    struct rt_sensor_config cfg;
    cfg.intf.dev_name  = AHT10_I2C_BUS;
    cfg.intf.user_data = (void *)AHT10_I2C_ADDR;
    rt_hw_aht10_init("aht10", &cfg);
    return RT_EOK;
}
INIT_ENV_EXPORT(rt_hw_aht10_port);

AHT10温湿度数据读取

// AHT10设备读取数值
    float humidity, temperature;
    aht10_device_t dev;
    rt_hw_aht10_port();
    dev = aht10_init(AHT10_I2C_BUS);
    if (dev == RT_NULL)
    {
        rt_kprintf(" The sensor initializes failure");
    }
    else
    {
        rt_kprintf(" The sensor initializes ok!\n");
    }
    /* read humidity 采集湿度 */
    humidity = aht10_read_humidity(dev);
    /* read temperature 采集温度 */
    temperature = aht10_read_temperature(dev);

3.2 ESP8266

3.2.1 底层uart简介

UART（Universal Asynchronous Receiver/Transmitter）通用异步收发传输器，UART 作为异步串口通信协议的一种，工作原理是将传输数据的每个字符一位接一位地传输。是在应用程序开发过程中使用频率最高的数据总线。

UART作为异步串行通信协议的一种，工作原理是将传输数据的每个二进制位一位接一位地传输。在UART通信协议中信号线上的状态为高电平时代表‘1’，信号线上的状态为低电平时代表‘0’。比如使用UART通信协议进行一个字节数据的传输时就是在信号线上产生八个高低电平的组合。

• 串行通信是指利用一条传输线将数据一位位地顺序传送，也可以用两个信号线组成全双工通信。特点是通信线路简单，利用简单的线缆就可实现通信，降低成本，适用于远距离通信，但传输速度慢的应用场合。
• 异步通信以一个字符为传输单位，通信中两个字符间的时间间隔多少是不固定的，然而在同一个字符中的两个相邻位间的时间间隔是固定的。也就是说两个uart设备之间通信的时候不需要时钟线，但是需要在两个uart设备上指定相同的传输速率，以及空闲位、起始位、校验位、结束位，也就是遵循相同的协议。
• 数据传送速率用波特率来表示，即每秒钟传送的二进制位数。例如数据传送速率为120字符/秒，而每一个字符为10位（1个起始位，7个数据位，1个校验位，1个结束位），则其传送的波特率为10×120＝1200字符/秒＝1200波特。

空闲位：UART协议规定，当总线处于空闲状态时信号线的状态为‘1’即高电平，表示当前线路上没有数据传输。

起始位：每开始一次通信时发送方先发出一个逻辑”0”的信号（低电平），表示传输字符的开始。因为总线空闲时为高电平所以开始一次通信时先发送一个明显区别于空闲状态的信号即低电平。

数据位：起始位之后就是我们所要传输的数据，数据位可以是5、6、7、8，9位等，构成一个字符（一般都是8位）。如ASCII码（7位，剩下的1位二进制为0），扩展BCD码（8位）。先发送最低位，最后发送最高位，使用低电平表示‘0’高电平表示‘1’完成数据位的传输。

3.2.2 MQTT通讯协议介绍

MQTT（Message Queuing Telemetry Transport，消息队列遥测传输协议），是一种基于发布/订阅（publish/subscribe）模式的"轻量级"通讯协议，该协议构建于TCP/IP协议上，由IBM在1999年发布。

其优点就是利用极少的代码和有限的带框，为物联网设备远程通讯提供消息传输服务， 相比于HTTP协议在互联网上的客户端请求，服务端应答模式，MQTT的发布订阅模式在物联网设备上更适用。

实现MQTT协议需要客户端和服务器端通讯完成，在通讯过程中，MQTT协议中有三种身份：发布者（Publish）、代理（Broker）（服务器）、订阅者（Subscribe）。其中，消息的发布者和订阅者都是客户端，消息代理是服务器，消息发布者可以同时是订阅者。

3.2.3 AT组件

AT 命令集是一种应用于 AT 服务器（AT Server）与 AT 客户端（AT Client）间的设备连接与数据通信的方式。 其基本结构如下图所示：

由上图可知，AT的使用需要AT Client和AT Server这两部分共同完成，AT Client通过AT命令向Server发送请求，等待Server的响应，并对响应的数据或主动发送给Client的数据（URC数据）进行解析处理，并获取相关信息。

3.2.4 MQTT协议及AT组件在RT-Thread中的使用

RT-Thread Settings设置

添加AT Device及OneNET软件包

AT Device配置：

OneNET配置:

首先我们需要前往ONENET官网进行产品创建及设备绑定，没有onenet账号的可以去注册一个。

然后将创建的信息填写到settings中

在组件中使能AT命令

接线示意：

FSP配置

由于RT-Thread提供了有限的驱动配置，所以需要我们使用瑞萨FSP进行相关的配置

首先点击RA Smart Configurator,记住这里使用的FSP版本为v3.5.0

完成上述操作后保存并编译，注意这里由于RT-Thread版本问题，可能出现#include <dfs_posix.h>未参与编译以及还有其他一些问题，可以参考这一issue[CPK-RA6M4] onenet上云报错<RT-Thread 的版本为 4.1.0 及以上>

现在可以下载到开发板了，由于我们使用的AT例程中是默认初始化运行，所以在上电后就会自动连接WIFI了。

然后就是数据上云，代码如下：

if (onenet_mqtt_upload_digit("temperature",temperature) < 0)
            {
                LOG_E("upload has an error, stop uploading");
            }
            else
            {
                rt_kprintf("humidity : %d.%d\n", (int)temperature, (int)(temperature * 10) % 10);
            }
            rt_thread_delay(5000);
            if (onenet_mqtt_upload_digit("humidity",humidity ) < 0)
            {
                LOG_E("upload has an error, stop uploading");
            }
            else
            {
                rt_kprintf("humidity : %d.%d\n", (int)humidity, (int)(humidity * 10) % 10);
            }

这里我们创建了两个数据流，分别是温度以及湿度。在AHT10读取温湿度之后，就可以进行数据的上报了，然后可以在onenet官网不断看到数据的上报了。