当前位置：首页 > news >正文

esp8266 rtos sdk开发环境搭建

news 2026/4/9 9:56:08

1. 安装必要的工具

1.1 安装 Git

Git 用于从远程仓库克隆代码，你可以从Git 官方网站下载 Windows 版本的安装程序。安装过程中可保持默认设置，安装完成后，在命令提示符（CMD）或 PowerShell 中输入git --version，若显示版本信息则安装成功。

1.2 安装 MSYS2

https://dl.espressif.com/dl/esp32_win32_msys2_environment_and_toolchain-20181001.zip

将 zip 文件解压到C:\（或其他位置，但本指南假定C:\），它将创建一个msys32具有预先准备的环境的目录。我这里放在e盘ESP8266目录下

1.3下载 ESP8266 的工具链

v8.4.0

https://dl.espressif.com/dl/xtensa-lx106-elf-gcc8_4_0-esp-2020r3-win32.zip

如果您仍在使用旧版本 SDK(< 3.0)，请使用工具链 v4.8.5，如下所示：

https://dl.espressif.com/dl/xtensa-lx106-elf-win32-1.22.0-88-gde0bdc1-4.8.5.tar.gz

解压后放在msys32的opt目录下

2. 下载 ESP8266 RTOS SDK

进入home目录下新建esp8266，进到此文件夹后，右键打开命令提示符或 PowerShell，执行以下命令克隆 ESP8266 RTOS SDK 代码：

#在 Git 2.13 及更高版本中，--recurse-submodules可以代替使用--recursive：git clone --recurse-submodules -j8 https://github.com/espressif/ESP8266_RTOS_SDK.git# -j8是 2.8 版中提供的可选性能优化，可同时并行获取最多 8 个子模块
#Git 版本 1.9 到 2.12 版本（-j标志仅在 2.8+ 版本中可用）：git clone --recursive -j8 https://github.com/espressif/ESP8266_RTOS_SDK.git

--recursive参数用于递归克隆子模块，确保所有依赖的子模块都被下载。

进入ESP8266_RTOS_SDK新建mypro，将example中的gpio拷贝到mypro下面

3. 安装 Python 依赖

在命令提示符或 PowerShell 中，进入ESP8266_RTOS_SDK目录，执行以下命令安装 Python 依赖：

python -m pip install --user -i https://pypi.tuna.tsinghua.edu.cn/simple -r E:/ESP8266/msys32/home/dana0/esp8266/ESP8266_RTOS_SDK/requirements.txt

PyPI 官网下载（我这里的缺失模块）

pyelftools：访问 pyelftools 的 PyPI 页面，找到适合 Python 2.7 的版本（通常文件名中会包含 py2 相关标识），下载 .whl 或 .tar.gz 格式的文件。
click：访问 click 的 PyPI 页面，同样找到适合 Python 2.7 的版本并下载。

安装 `.whl` 文件

如果下载的是 .whl 文件，在目标设备的命令行中执行以下命令：

python -m pip install /path/to/downloaded_file.whl

将 /path/to/downloaded_file.whl 替换为你实际下载的 .whl 文件的路径。例如，如果你下载的 pyelftools 的 .whl 文件名为 pyelftools-0.29-py2.py3-none-any.whl，则命令为：

python -m pip install /path/to/pyelftools-0.29-py2.py3-none-any.whl

同理，对 click 的 .whl 文件执行相同的操作。

4. 测试开发环境

4.1 进入示例项目

进入ESP8266_RTOS_SDK目录下的示例项目，例如gpio：

cd /home/dana0/esp8266/ESP8266_RTOS_SDK/mypro/gpio

4.2 配置开发板

将开发板通过 USB 数据线连接到计算机，确定开发板的串口设备名称（在设备管理器中查看，一般为COMx）。

make menuconfig

在菜单中可以进行一些配置，如串口波特率、分区表等。使用上下箭头键选择选项，回车键进入子菜单或确认选择，Esc键返回上一级菜单，配置完成后选择 “Save” 保存配置，然后选择 “Exit” 退出。

4.3 编译项目

make all

此处是第二次编译

编译过程可能需要一些时间，请耐心等待。如果编译成功，会在项目目录下生成相应的固件文件。

4.4 烧录固件

make flash ESPPORT=COM3  # 根据实际情况修改串口设备名称

烧录过程中，开发板可能需要进入下载模式