ESP8266_RTOS_SDK v3创建一个新项目使用GPIO

陈拓 2021/02/04-2021/02/09

 

1. 概述

在《用乐鑫国内镜像构建ESP8266_RTOS_SDK开发环境》

https://zhuanlan.zhihu.com/p/347711847

https://blog.csdn.net/chentuo2000/article/details/113349010

一文中我们已经构建好了ESP8266_RTOS_SDK开发环境，在此基础上我们创建一个新项目，试试ESP8266的GPIO输出控制。

1.1 新老版本对GPIO操作的区别

ESP8266_RTOS_SDK 3.0以前的版本使用宏来操作GPIO，例如：

PIN_FUNC_SELECT();

GPIO_OUTPUT_SET();

在ESP8266_RTOS_SDK 3.0以后版本的例子中看不到这些宏的使用了。官方给出的例子SP8266_RTOS_SDK/examples/peripherals/gpio/main/user_main.c中展示了新的GPIO操作方法。相关的文档见：

https://docs.espressif.com/projects/esp8266-rtos-sdk/en/latest/api-reference/peripherals/gpio.html

1.2 更新并查看当前ESP8266_RTOS_SDK版本

• 进入ESP8266_RTOS_SDK目录

cd ~/esp/ESP8266_RTOS_SDK

• 更新远程代码到本地

git pull

• 查看分支

git branch -vva

绿色的是本地分支，红色的是远程分支。

对比commit id 89a3f254可知本地ESP8266_RTOS_SDK版本是最新的v3.4版。

2. 硬件

• ESP8266-12F模块

ESP8266-12F正面

ESP8266-12F背面

ESP8266-12F模块上有一个板载的LED连在GPIO2上。

• 开发板

3. 创建新项目

创建新项目最快的方法就是在现有项目的基础上进行改造。下面我们以get-started/hello_world为基础创建一个名为led的项目。

• 复制项目

cd ~/esp

cp -r ./ESP8266_RTOS_SDK/examples/get-started/hello_world/ .

• 修改项目名称

mv hello_world led

• 修改C程序的名字

mv led/main/hello_world_main.c led/main/user_main.c

• 修改Makefile

将hello-world改为led：

nano led/Makefile

4. 改写代码

参考ESP8266_RTOS_SDK/examples自带的例子gpio。

cat ESP8266_RTOS_SDK/examples/peripherals/gpio/main/user_main.c

修改代码如下：

cd ~/esp/led

nano main/user_main.c

/* led on off */
#include <stdio.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_spi_flash.h"

#include "driver/gpio.h"
#include "esp_system.h"

#define LED GPIO_NUM_2 // LED连接在gpio2上

void app_main()
{
    /* 定义gpio配置结构体 */
    gpio_config_t io_conf;

    /* 初始化gpio配置结构体 */
    io_conf.pin_bit_mask = (1ULL << LED); // 选择gpio
    io_conf.intr_type = GPIO_INTR_DISABLE; // 禁用中断
    io_conf.mode = GPIO_MODE_OUTPUT; // 设置为输出模式
    io_conf.pull_down_en = 0; // 不用下拉模式
    io_conf.pull_up_en = 0; // 不用上拉模式

    /* 用给定的设置配置GPIO */
    gpio_config(&io_conf);

    while(1)
    {
        gpio_set_level(LED, 1); // 输出高电平，LED熄灭
        vTaskDelay(500 / portTICK_RATE_MS); // 调用任务睡眠函数，延时500ms
        gpio_set_level(LED, 0); // 输出低电平，点亮LED
        vTaskDelay(500 / portTICK_RATE_MS); // 延时
    }
}

5. 程序说明

• 程序结构

一般单片机的程序是从main函数开始执行的，而ESP8266 SDK程序中没有main函数，用户程序写在上层程序的⼊⼝函数app_main()中。

注意：ESP8266 RTOS SDK v3.0之前的版本这个函数是user_init()。

• ESP8266的GPIO

https://www.espressif.com/sites/default/files/documentation/esp8266-technical_reference_cn.pdf

• GPIO操作

https://docs.espressif.com/projects/esp8266-rtos-sdk/en/latest/api-reference/peripherals/gpio.html

• 结构gpio_config_t

用来初始化GPIO。

使用时先定义结构体gpio_config_t，再初始化结构体。

• 函数gpio_set_level

引脚输出电平控制。

• 枚举GPIO_NUM_2

ESP12F上自带的LED连在GPIO2上；所以我们用宏定义LED引用引脚编号2：

#define LED GPIO_NUM_2

6. 编译烧写运行

• 编译

cd ~/esp/led

make

• 烧写

make flash

按RST键，程序运行，LED闪烁。