ESP32 代码结构与函数基础全解析：Arduino 与非 Arduino 方式

极梦网络无忧

已于 2025-02-13 03:08:30 修改

阅读量1.1k

点赞数 16

分类专栏： esp32 文章标签： arduino esp32 嵌入式硬件单片机 Arduino

于 2025-02-13 03:08:14 首次发布

本文链接：https://blog.csdn.net/wangzhae/article/details/145603028

版权

esp32 专栏收录该内容

4 篇文章

订阅专栏

引言

在物联网（IoT）蓬勃发展的当下，ESP32 凭借其强大性能、丰富功能以及亲民的价格，成为众多开发者的热门选择。它集成了 Wi - Fi 和蓝牙功能，拥有充足的 GPIO 引脚，能轻松应对各类复杂应用场景。对于 ESP32 开发，常见的方式有基于 Arduino 框架和基于 ESP - IDF（Espressif IoT Development Framework）的原生开发。前者简单便捷，适合初学者快速上手；后者则能让开发者更深入地掌控硬件资源，发挥 ESP32 的全部潜力。本文将全面剖析这两种方式下 ESP32 的代码结构和函数基础，助你开启高效的开发之旅。

开发环境搭建

Arduino IDE 环境搭建

在开始使用 Arduino 框架编写 ESP32 代码前，需要搭建好开发环境。具体步骤如下：

下载并安装 Arduino IDE：从 Arduino 官方网站（https://www.arduino.cc/en/software）下载适合你操作系统的版本，并完成安装。
添加 ESP32 开发板支持：打开 Arduino IDE，依次点击“文件” -> “首选项”，在“附加开发板管理器网址”中添加 https://dl.espressif.com/dl/package_esp32_index.json。然后点击“工具” -> “开发板” -> “开发板管理器”，搜索“esp32”并安装。
选择开发板和端口：点击“工具” -> “开发板”，选择“ESP32 Dev Module”；再点击“工具” -> “端口”，选择与 ESP32 连接的串口端口。

ESP - IDF 环境搭建

基于 ESP - IDF 的原生开发，也需要完成相应的环境搭建：

安装工具链：ESP - IDF 依赖特定的工具链进行编译和调试。根据操作系统类型（如 Windows、Linux 或 macOS），从 Espressif 官方网站下载并安装对应的工具链。
获取 ESP - IDF：通过 Git 克隆 ESP - IDF 仓库到本地，或者直接下载压缩包并解压。
设置环境变量：配置系统环境变量，使系统能够找到 ESP - IDF 的相关工具和库。
初始化项目：使用 idf.py 工具初始化一个新的 ESP32 项目。

代码结构剖析

Arduino 框架下的代码结构

Arduino 框架下的 ESP32 代码具有固定的基本结构，主要由 setup() 和 loop() 两个函数组成：

`setup()` 函数

void setup() {
  // 初始化代码
  Serial.begin(115200); // 初始化串口通信，波特率为 115200
  pinMode(LED_BUILTIN, OUTPUT); // 将板载 LED 引脚设置为输出模式
}

功能：setup() 函数在程序启动时只执行一次，主要用于初始化硬件和设置初始参数。
常见操作：
- 串口通信初始化：使用 Serial.begin() 函数初始化串口通信，方便调试和输出信息。
- 引脚模式设置：使用 pinMode() 函数将 GPIO 引脚设置为输入或输出模式。

`loop()` 函数

void loop() {
  // 主循环代码
  digitalWrite(LED_BUILTIN, HIGH); // 点亮板载 LED
  delay(1000); // 延迟 1 秒
  digitalWrite(LED_BUILTIN, LOW); // 熄灭板载 LED
  delay(1000); // 延迟 1 秒
}

功能：loop() 函数会不断循环执行，是程序的主循环，用于实现具体的功能逻辑。
常见操作：
- 引脚电平控制：使用 digitalWrite() 函数控制 GPIO 引脚的高低电平。
- 延迟操作：使用 delay() 函数实现程序的延迟。

ESP - IDF 框架下的代码结构

基于 ESP - IDF 的 ESP32 项目具有特定的代码结构，理解这种结构有助于更好地组织和管理代码。以下是一个典型的项目结构示例：

project_root/
├── CMakeLists.txt
├── main/
│   ├── CMakeLists.txt
│   └── main.c
└── components/
    └── ...

`CMakeLists.txt`

项目根目录下的 CMakeLists.txt：该文件是项目的顶层配置文件，主要用于定义项目名称、版本号以及包含的组件等信息。例如：

cmake_minimum_required(VERSION 3.16)

include($ENV{IDF_PATH}/tools/cmake/project.cmake)
project(esp32_project)

main 目录下的 CMakeLists.txt：负责指定 main 目录下的源文件和编译选项。示例如下：

idf_component_register(SRCS "main.c"
                       INCLUDE_DIRS ".")

`main` 目录

main 目录是项目的核心代码所在，通常包含一个或多个源文件，其中 main.c 是程序的入口文件。以下是一个简单的 main.c 文件示例：

#include <stdio.h>
#include "esp_system.h"
#include "nvs_flash.h"

void app_main(void)
{
    esp_err_t ret = nvs_flash_init();
    if (ret == ESP_ERR_NVS_NO_FREE_PAGES || ret == ESP_ERR_NVS_NEW_VERSION_FOUND) {
        ESP_ERROR_CHECK(nvs_flash_erase());
        ret = nvs_flash_init();
    }
    ESP_ERROR_CHECK(ret);

    printf("Hello, ESP32!\n");
    esp_restart();
}

`components` 目录

components 目录用于存放项目中使用的自定义组件或第三方组件。每个组件通常有自己的 CMakeLists.txt 文件，用于描述该组件的编译规则。

核心函数基础

Arduino 框架下的常用函数

串口通信函数

Serial.begin(baud)：初始化串口通信，baud 为波特率，常用的波特率有 9600、115200 等。

Serial.begin(115200); // 初始化串口通信，波特率为 115200

Serial.print(data) 和 Serial.println(data)**：向串口发送数据，println() 会在数据末尾添加换行符。

Serial.print("Hello, ");
Serial.println("ESP32!");

Serial.read()：从串口读取一个字节的数据。

int incomingByte = Serial.read();

GPIO 控制函数

pinMode(pin, mode)：设置 GPIO 引脚的模式，pin 为引脚编号，mode 可以是 INPUT、OUTPUT 或 INPUT_PULLUP。

pinMode(2, OUTPUT); // 将 GPIO2 设置为输出模式

digitalWrite(pin, value)：控制 GPIO 引脚的高低电平，value 可以是 HIGH 或 LOW。

digitalWrite(2, HIGH); // 将 GPIO2 引脚设置为高电平

digitalRead(pin)：读取 GPIO 引脚的电平状态，返回值为 HIGH 或 LOW。

int state = digitalRead(2); // 读取 GPIO2 引脚的电平状态

延迟函数

delay(ms)：使程序暂停执行指定的毫秒数，ms 为延迟的时间。

delay(1000); // 延迟 1 秒

Wi - Fi 相关函数

ESP32 支持 Wi - Fi 功能，以下是一些常用的 Wi - Fi 函数：

WiFi.begin(ssid, password)：连接到指定的 Wi - Fi 网络，ssid 为网络名称，password 为网络密码。

#include <WiFi.h>

const char* ssid = "your_SSID";
const char* password = "your_PASSWORD";

void setup() {
  Serial.begin(115200);
  WiFi.begin(ssid, password);
  while (WiFi.status() != WL_CONNECTED) {
    delay(1000);
    Serial.println("Connecting to WiFi...");
  }
  Serial.println("Connected to WiFi");
}

WiFi.status()：返回当前 Wi - Fi 的连接状态，如 WL_CONNECTED 表示已连接。

ESP - IDF 框架下的核心函数

系统初始化函数

`nvs_flash_init()`

功能：初始化非易失性存储（NVS），用于在 ESP32 断电后保存数据。
示例：

esp_err_t ret = nvs_flash_init();
if (ret == ESP_ERR_NVS_NO_FREE_PAGES || ret == ESP_ERR_NVS_NEW_VERSION_FOUND) {
    ESP_ERROR_CHECK(nvs_flash_erase());
    ret = nvs_flash_init();
}
ESP_ERROR_CHECK(ret);

`esp_restart()`

功能：重启 ESP32 系统。
示例：

esp_restart();

GPIO 操作函数

`gpio_set_direction()`

功能：设置 GPIO 引脚的输入/输出方向。
示例：

#include "driver/gpio.h"

#define GPIO_LED_PIN GPIO_NUM_2

void setup_led_gpio()
{
    gpio_set_direction(GPIO_LED_PIN, GPIO_MODE_OUTPUT);
}

`gpio_set_level()`

功能：设置 GPIO 引脚的电平状态（高电平或低电平）。
示例：

void turn_on_led()
{
    gpio_set_level(GPIO_LED_PIN, 1);
}

void turn_off_led()
{
    gpio_set_level(GPIO_LED_PIN, 0);
}

Wi - Fi 相关函数

`esp_netif_init()`

功能：初始化网络接口。
示例：

#include "esp_netif.h"

void initialize_network()
{
    esp_netif_init();
}

`esp_wifi_init()`

功能：初始化 Wi - Fi 驱动。
示例：

#include "esp_wifi.h"

void initialize_wifi()
{
    esp_netif_create_default_wifi_sta();
    wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();
    esp_wifi_init(&cfg);
}

总结

无论是基于 Arduino 框架还是 ESP - IDF 进行 ESP32 开发，都有其独特的优势和适用场景。Arduino 框架简单易学，能让初学者快速实现功能；而 ESP - IDF 则提供了对硬件更精细的控制，适合开发复杂、高性能的应用。通过深入理解两种方式下的代码结构和核心函数，你可以根据项目需求灵活选择开发方式，构建出高效、稳定且功能丰富的 ESP32 应用程序。在实际开发过程中，不断实践和探索，你将逐渐熟练运用这些知识进行各种项目的开发。希望本文能为你在 ESP32 开发的道路上提供有益的指引。