ESP-AT 开发环境部署

本地编译 ESP-AT 工程 - ESP32-C6 - — ESP-AT 用户指南 release-v5.0.0.0 文档

1. 系统环境

  • Ubuntu Server 24.04 LTS
  • ESP32-C6-DevKitM-1 开发板

2. 获取 ESP-AT

1
2
3
4
5
6
# 创建目录
mkdir esp
cd ~/esp

# 克隆工程
git clone --recursive https://github.com/espressif/esp-at.git

2.1 切换特定版本

可以自己选择对应的 ESP-AT 版本，我这里选择了 ESP32-C6 最推荐的 V4.1.1.0：

1
2
3
4
5
# 拉取最新的远程代码和标签
git fetch --all --tags

# 检出特定标签
git checkout v4.1.1.0

3. 安装环境

3.1 安装虚拟环境工具

1
2
sudo apt update
sudo apt install python3-venv python3-full

3.2 创建虚拟环境

1
2
cd ~/esp/esp-at
python3 -m venv .venv

3.3 激活虚拟环境

1
2
3
4
5
# 进入环境
source .venv/bin/activate

# 退出环境
deactivate

3.4 安装依赖

1
2
cd ~/esp/esp-at
./build.py install

请根据自己的芯片进行选择，ESP32-C6 的配置如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
Platform name:
1. PLATFORM_ESP32
2. PLATFORM_ESP32C3
3. PLATFORM_ESP32C2
4. PLATFORM_ESP32C5
5. PLATFORM_ESP32C6
6. PLATFORM_ESP32S2
choose(range[1,6]):5

Module name:
1. ESP32C6-4MB  (Firmware description: 4MB, Wi-Fi + BLE, OTA, TX:7 RX:6)
choose(range[1,1]):1

Enable silence mode to remove some logs and reduce the firmware size?
0. No
1. Yes
choose(range[0,1]):1
Platform name:ESP32C6   Module name:ESP32C6-4MB Silence:1

4. 自定义 AT 端口管脚

默认情况下，ESP-AT 使用两个 UART 接口作为 AT 端口：一个用于输出日志（以下称为日志端口），另一个用于发送 AT 命令和接收响应（以下称为命令端口）。

4.1 修改日志端口管脚

1
./build.py menuconfig

配置项路径：

Component config -> ESP System Settings -> Channel for console output

4.2 修改命令端口管脚

默认情况下，UART1 用于发送 AT 命令和接收 AT 响应，其管脚定义在 factory_param_data.csv 表格中的 uart_port、uart_tx_pin、uart_rx_pin、uart_cts_pin 和 uart_rts_pin 列。

配置为：

1
PLATFORM_ESP32C6,ESP32C6-4MB,"4MB, Wi-Fi + BLE, OTA, TX:16 RX:17",4,78,0,1,13,CN,115200,16,17,-1,-1,1

5. 编译和烧录

记得使用 source .venv/bin/activate 来激活环境，然后再运行编译命令；

5.1 编译

1
./build.py build

5.2 烧录

1
./build.py flash -p /dev/端口号