Windows下ESP32 环境搭建（基于esp-idf FreeRTOS)

2022 年 8 月 17 日
筆記
ESP32, ESP8266/ESP32, freeRTOS

1. 之前的尝试（失败的尝试）

咸鱼买了3块ESP32开发板。背面写了NODEMCU v1.1，好像这玩意可以直接写lua，也可以刷Micropython写python，还可以用Arduino IDE写c。我想直接用官方库写C。

和乐鑫的这块开发板（ESP32-DevKitC）外观还挺像的（外观和引脚），可以参考这个文档

图1 ESP32-DevKitC

ESP32-DevKitC V4 入门指南
乐鑫：ESP-IDF 编程指南有引脚布局

…… 经历了一段失败的尝试。

这期间玩了下ESP8266，稍微有了点环境方面的经验。可参考 ESP8266 系统环境搭建。

先直接用之前的程序什么也不改（只改个串口号）来烧录。

报错：

Running stub...

A fatal error occurred: Invalid head of packet (0x46)
make: *** [/e/labs/esp8266/ESP8266_RTOS_SDK/components/esptool_py/Makefile.projbuild:76: flash] Error 2

ESP8266的RTOS是 //github.com/espressif/ESP8266_RTOS_SDK

ESP32 的RTOS是 //github.com/espressif/esp-idf

ESP8266设置时除了设置RTOS路径，还要设置专用的工具链，而ESP32不需要另外下载工具链。

下载RTOS

git clone --recursive //github.com/espressif/esp-idf.git

在环境中设置rtos目录

编辑 vim ~/.bash_profile，上面注释的两行是之前配置的ESP8266路径，最后一行是新增的配置

图2 配置文件

编译

复制个 hello world 项目过来。make 报错

make menuconfig
make: *** No rule to make target 'menuconfig'.  Stop.

新建了 Makefile

PROJECT_NAME := myProject

include $(IDF_PATH)/make/project.mk

发现 idf 目录下没有make目录，切换个版本：

git checkout release/v4.4

V4.4对应文档在构建系统 (传统 GNU Make)

而且有4.4到5的升级指南，看来5这次升级改动比较大，那就一直用V4版本吧。

又经历了一段失败的尝试…

2. 新的尝试（vscode + espressif）

上面的不用看了，全都PASS掉。直接用官网教程 github – vscode-esp-idf-extension install 一步步进行即可。

直接使用 vscode 下的扩展。

在python自动安装库的时候，出现错误

Could not fetch URL //pypi.org/simple/pip/: There was a

修改当前使用的pip源即可，参考Python基础-03-设置pip源

在家里装好了后，将.espressif 和 esp-idf 目录都拷下来。到公司直接放到指定目录后，选择 EXPRESS （再选择本地的ESP-IDF 以及 tools 目录）运行安装，发现总是报错，包含：

        module = __import__(self.module_name, fromlist=['__name__'], level=0)
    ModuleNotFoundError: No module named 'setuptools.command.build'
    ----------------------------------------
ERROR: Command errored out with exit status 1: python setup.py egg_info Check the logs for full command output.
Traceback (most recent call last):
  File "d:\Software\esp-idf\tools\idf_tools.py", line 1860, in <module>
    main(sys.argv[1:])
  File "d:\Software\esp-idf\tools\idf_tools.py", line 1856, in main
    action_func(args)
  File "d:\Software\esp-idf\tools\idf_tools.py", line 1577, in action_install_python_env
    subprocess.check_call(run_args, stdout=sys.stdout, stderr=sys.stderr, env=env_copy)
  File "subprocess.py", line 364, in check_call
subprocess.CalledProcessError: Command '['C:\\Users\\Administrator\\.espressif\\python_env\\idf4.4_py3.8_env\\Scripts\\python.exe', '-m', 'pip', 'install', '--no-warn-script-location', '-r', 'd:\\Software\\esp-idf\\requirements.txt', '--extra-index-url', '//dl.espressif.com/pypi']' returned non-zero exit status 1.

的一大长串错误。想着这么安装到底行不行，看到配置中有两个大大的路径名

便把这两个路径加到环境变量中，重启vscode 后，现在有三种选项了，直接选最后一个（使用用户配置），就成功了。

还得再备注一下，这之前我还修改了 .espressif/esp-idf.json 文件。修改为了当前目录，不知道有没有影响，也一块贴到这里了

{
  "$schema": "//json-schema.org/schema#",
  "$id": "//dl.espressif.com/dl/schemas/esp_idf",
  "_comment": "Configuration file for ESP-IDF IDEs.",
  "_warning": "Use / or \\ when specifying path. Single backslash is not allowed by JSON format.",
  "gitPath": "C:\\Users\\Administrator\\.espressif\\tools\\idf-git\\2.30.1\\cmd\\git.exe",
  "idfToolsPath": "C:\\Users\\Administrator\\.espressif",
  "idfSelectedId": "esp-idf-ba516b215dd292dbb871744b96db338d",
  "idfInstalled": {
    "esp-idf-ba516b21593292dbb8dd744b96db338d": {
      "version": "4.4.2",
      "python": "C:\\Users\\Administrator\\.espressif\\python_env\\idf4.4_py3.8_env\\Scripts\\python.exe",
      "path": "d:\\Software\\esp-idf"
    }
  }
}

基本使用Tutorials。