【0基础秒入门】Arduino ESP32 项目教程

1. 项目的目录结构及介绍

Arduino ESP32 项目的目录结构如下：

arduino-esp32/
├── README.md
├── LICENSE
├── CODE_OF_CONDUCT.md
├── boards.txt
├── platform.txt
├── programmers.txt
├── tools/
├── libraries/
├── cores/
├── variants/
├── package/
├── tests/
├── docs/
└── examples/

目录介绍

• README.md: 项目介绍文件，包含项目的基本信息和使用说明。
• LICENSE: 项目许可证文件，本项目使用 LGPL-2.1 许可证。
• CODE_OF_CONDUCT.md: 项目行为准则，指导项目参与者的行为规范。
• boards.txt: 定义了不同开发板的配置信息。
• platform.txt: 定义了平台的构建和上传选项。
• programmers.txt: 定义了编程器的配置信息。
• tools/: 包含构建和上传所需的工具。
• libraries/: 包含项目使用的库文件。
• cores/: 包含核心代码，提供基本的 Arduino 功能。
• variants/: 包含不同开发板的变体代码。
• package/: 包含用于 Boards Manager 的包文件。
• tests/: 包含项目的测试代码。
• docs/: 包含项目的文档。
• examples/: 包含示例代码，帮助用户快速上手。

2. 项目的启动文件介绍

项目的启动文件主要位于 cores/ 目录下，其中 main.cpp 是主要的启动文件。

main.cpp

#include "sdkconfig.h"
#include "Arduino.h"

void setup() {
    // 初始化代码
}

void loop() {
    // 主循环代码
}

• sdkconfig.h: 包含项目的配置选项。
• Arduino.h: 包含 Arduino 核心库的头文件。
• setup(): 初始化函数，在程序启动时执行一次。
• loop(): 主循环函数，程序运行时不断循环执行。

3. 项目的配置文件介绍

项目的配置文件主要位于项目根目录下，包括 boards.txt, platform.txt, 和 programmers.txt。

boards.txt

# 定义开发板的配置信息
esp32.name=ESP32 Dev Module
esp32.upload.tool=esptool
esp32.upload.maximum_size=4194304
esp32.build.core=esp32
esp32.build.variant=esp32

• esp32.name: 开发板名称。
• esp32.upload.tool: 上传工具。
• esp32.upload.maximum_size: 上传文件的最大大小。
• esp32.build.core: 构建时使用的核心。
• esp32.build.variant: 构建时使用的变体。

platform.txt

# 定义平台的构建和上传选项
compiler.c.extra_flags=-DARDUINO_ESP32
compiler.cpp.extra_flags=-DARDUINO_ESP32
compiler.c.elf.extra_flags=-T esp32.ld
compiler.ar.extra_flags=
compiler.c.elf.extra_flags=
compiler.c.elf.extra_flags=-T esp32.ld

• compiler.c.extra_flags: C 编译器的额外标志。
• compiler.cpp.extra_flags: C++ 编译器的额外标志。
• compiler.c.elf.extra_flags: ELF 文件的额外标志。

programmers.txt

# 定义编程器的配置信息
esptool.name=esptool
esptool.protocol=esp
esptool.program.tool=esptool
esptool.program.extra_params=

• esptool.name: 编程器名称。
• esptool.protocol: 编程器协议。
• esptool.program.tool: 编程器工具。
• esptool.program.extra_params: 编程器的额外参数。

以上是 Arduino ESP32