ESP32 快速入门

ESP32 与 ESP8266 的区别

ESP8266 是乐鑫 2014 年发布的第一款 Wi-Fi SoC，以极低的价格（约 1 美元）迅速风靡 Maker 社区。ESP32 是其 2016 年发布的继任者，在几乎所有维度都做了大幅提升。理解它们的区别有助于你在项目中做出正确的芯片选型。

双核 Xtensa LX6 架构详解

ESP32 的处理器是 Tensilica 公司（现属 Cadence）设计的 Xtensa LX6 架构，乐鑫对其进行了定制化扩展。理解这个架构对于后续的多任务开发和调试至关重要。

两个核心的职责分工

开发框架对比

ESP32 生态支持三种主流开发框架，各有侧重：

安装 ESP-IDF 开发环境

前置要求

ESP-IDF 需要 Python 3.7+、Git 和若干系统工具。以下是各平台的安装方式：

# ── macOS ──
# 1. 安装 Homebrew（如未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 2. 安装依赖
brew install cmake ninja dfu-util python3

# ── Ubuntu / Debian Linux ──
sudo apt-get install git wget flex bison gperf python3 python3-pip \
  python3-venv cmake ninja-build ccache libffi-dev libssl-dev \
  dfu-util libusb-1.0-0

# ── Windows ──
# 推荐使用官方 ESP-IDF Windows Installer：
# https://dl.espressif.com/dl/esp-idf/?idf=latest

克隆 ESP-IDF 并安装工具链

# 克隆 ESP-IDF（推荐使用稳定版，如 v5.2）
mkdir -p ~/esp
cd ~/esp
git clone --recursive https://github.com/espressif/esp-idf.git
cd esp-idf
git checkout v5.2
git submodule update --init --recursive

# 安装 Xtensa/RISC-V 工具链和工具
./install.sh esp32

# 设置环境变量（每个终端会话都需要运行）
. $HOME/esp/esp-idf/export.sh

# 或将以下别名加入 ~/.bashrc / ~/.zshrc 方便调用
alias get_idf='. $HOME/esp/esp-idf/export.sh'

# 验证安装
idf.py --version    # 应输出 ESP-IDF v5.2.x

创建第一个 ESP-IDF 项目

项目结构

# 复制 hello_world 示例
cp -r $IDF_PATH/examples/get-started/hello_world ~/esp/
cd ~/esp/hello_world

# ESP-IDF 项目标准结构：
hello_world/
├── CMakeLists.txt       # 顶层 CMake：注册项目名
├── sdkconfig            # 配置文件（menuconfig 生成）
├── partitions.csv       # 可选：自定义分区表
└── main/
    ├── CMakeLists.txt   # 组件 CMake：注册源文件
    └── hello_world_main.c

Hello World 源码解析

// main/hello_world_main.c
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_log.h"
#include "esp_chip_info.h"

static const char *TAG = "HELLO";

void app_main(void)
{
    /* ESP_LOGI：Info 级别日志，格式类似 printf */
    ESP_LOGI(TAG, "Hello, ESP32!");

    /* 获取芯片信息 */
    esp_chip_info_t chip_info;
    esp_chip_info(&chip_info);
    ESP_LOGI(TAG, "ESP32 芯片：%d 个 CPU 核心, Wi-Fi%s%s",
             chip_info.cores,
             (chip_info.features & CHIP_FEATURE_BT) ? "/BT" : "",
             (chip_info.features & CHIP_FEATURE_BLE) ? "/BLE" : "");

    for (int i = 10; i >= 0; i--) {
        ESP_LOGI(TAG, "%d 秒后重启...", i);
        vTaskDelay(pdMS_TO_TICKS(1000));   // 延迟 1000ms
    }
    esp_restart();   // 软件重启
}

编译、烧录与监视

# 配置目标芯片（首次必须运行）
idf.py set-target esp32

# 可选：打开图形化配置菜单
idf.py menuconfig

# 编译项目
idf.py build

# 烧录到设备（替换 /dev/ttyUSB0 为实际串口）
idf.py -p /dev/ttyUSB0 flash

# 打开串口监视器（Ctrl+] 退出）
idf.py -p /dev/ttyUSB0 monitor

# 一键：编译 + 烧录 + 监视
idf.py -p /dev/ttyUSB0 flash monitor

LED 闪烁实战

ESP-IDF 版本

#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "driver/gpio.h"
#include "esp_log.h"

#define LED_PIN    GPIO_NUM_2   // 大多数 DevKit 板载 LED 在 GPIO2
static const char *TAG = "BLINK";

void app_main(void)
{
    /* 配置 GPIO2 为输出模式 */
    gpio_config_t io_conf = {
        .pin_bit_mask = (1ULL << LED_PIN),
        .mode         = GPIO_MODE_OUTPUT,
        .pull_up_en   = GPIO_PULLUP_DISABLE,
        .pull_down_en = GPIO_PULLDOWN_DISABLE,
        .intr_type    = GPIO_INTR_DISABLE,
    };
    gpio_config(&io_conf);

    while (1) {
        gpio_set_level(LED_PIN, 1);          // LED 亮
        ESP_LOGI(TAG, "LED ON");
        vTaskDelay(pdMS_TO_TICKS(500));

        gpio_set_level(LED_PIN, 0);          // LED 灭
        ESP_LOGI(TAG, "LED OFF");
        vTaskDelay(pdMS_TO_TICKS(500));
    }
}

Arduino 版本（对比参考）

#define LED_PIN 2

void setup() {
  Serial.begin(115200);
  pinMode(LED_PIN, OUTPUT);
}

void loop() {
  digitalWrite(LED_PIN, HIGH);
  Serial.println("LED ON");
  delay(500);
  digitalWrite(LED_PIN, LOW);
  Serial.println("LED OFF");
  delay(500);
}

常见 ESP32 开发板选型