VScode+esp-idf:编译腾讯物联网控制台ESP32例程(esp-qcloud)

ESP32通过腾讯云物联网控制台实现智能LED灯的编程指南
原创 已于 2025-10-27 15:01:54 修改 · 3.1k 阅读 · 21 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#vscode #物联网

于 2022-08-20 10:01:41 首次发布
本文档详细介绍了如何在VSCode+ESP-IDF V4.4环境中，利用腾讯物联网控制台的例程对ESP32进行智能LED灯的开发。首先从码云仓库下载esp-qcloud源代码并放入ESP-IDF的example目录，接着创建并配置led_light工程，修改CMakeLists.txt文件以指定QCLOUD_PATH。然后配置工程，包括选择开发板、设置GPIO、输入设备三元组和选择配网方式。最后，编译工程并下载程序到ESP32板，解决可能出现的头文件找不到问题。此外，还提供了使用腾讯连连小程序测试ESP设备的指引。

文章目录


腾讯物联网控制台专门为ESP32开发一个开源的例程，针对智能灯应用，可以用腾讯连连小程序控制。这篇文章我们介绍如何在vscode+esp-idfV4.4的环境下，进行可视化开发。

1.下载esp-qcloud源代码

1.码云仓库：esp-qcloud
2.github仓库：esp-qcloud
我用的是码云的仓库，下载后解压后生成文件夹 《esp-qcloud-master》，改成 《esp-qcloud》,放到 esp-idf安装目录的 《example》 文件夹里面。以我的路径为例，是这样的（后面我们要用到这个路径 《$ENV{IDF_PATH}/examples/esp-qcloud》）：
在这里插入图片描述
放在 《example》 文件夹里面的好处是，后面我们创建例程时，会拷贝一份到我们的工作目录下面，然后我们修改代码时不会影响到原文件。

2.创建led_light新工程

esp-qcloud有一个example，名字为《led_light》路径 如下：
在这里插入图片描述
我们就要对这个工程进行编译。

2.1拷贝led_light例程

在命令面板搜索 “example”：
在这里插入图片描述
选择 Use current ESP-IDF,然后路径《E:\esp32\esp-idf\examples》下面所有例程都被列出来:
在这里插入图片描述
找到《led_light》,点击蓝色按键，会跳出一个选择目标文件夹的窗口，我们选择好后，会拷贝《led_light》到目标文件夹。

2.2修改《CMakeLists.txt》

因为几乎每个文件夹都有一个《CMakeLists.txt》，是 《led_light》 下面的《CMakeLists.txt》。

正确的文件：《./led_light/CMakeLists.txt》
错误的文件：《./led_light/main/CMakeLists.txt》

修改的目的是指定 QCLOUD_PATH的路径。根据第一章我们放置《esp-qcloud》文件的位置来设置。
《CMakeLists.txt》文件内容（重点在第14，15行）：

# The following lines of boilerplate have to be in your project's CMakeLists
# in this exact order for cmake to work correctly
cmake_minimum_required(VERSION 3.5)
add_compile_options(-fdiagnostics-color=always)

if(EXISTS ${CMAKE_CURRENT_LIST_DIR}/../../config/)
    set(QCLOUD_PATH ${CMAKE_CURRENT_LIST_DIR}/../..)
elseif(EXISTS ${CMAKE_CURRENT_LIST_DIR}/components/qcloud)
    set(QCLOUD_PATH ${CMAKE_CURRENT_LIST_DIR}/components/qcloud)
elseif(EXISTS ${CMAKE_CURRENT_LIST_DIR}/components/esp-qcloud)
    set(QCLOUD_PATH ${CMAKE_CURRENT_LIST_DIR}/components/esp-qcloud)
elseif(EXISTS $ENV{IDF_PATH}/components/qcloud)
    set(QCLOUD_PATH $ENV{IDF_PATH}/components/qcloud)
elseif(EXISTS $ENV{IDF_PATH}/examples/esp-qcloud)
    set(QCLOUD_PATH $ENV{IDF_PATH}/examples/esp-qcloud)
else()
    message(FATAL_ERROR "Please configure the path of `QCLOUD_PATH`")
endif()

if(NOT DEFINED IDF_TARGET)
    set(IDF_TARGET "esp32")
endif()

# Add QCloud components and other common application components
# This example uses an extra component for common functions such as led and button.
set(EXTRA_COMPONENT_DIRS ${QCLOUD_PATH} 
                         ${QCLOUD_PATH}/examples/common_components/led
                         ${QCLOUD_PATH}/examples/common_components/button)

# Performance Options
if(NOT DEFINED PERF)
    set(PERF "defaults")
endif()
set(SDKCONFIG_DEFAULTS ${QCLOUD_PATH}/config/sdkconfig_defaults/sdkconfig.${PERF}.${IDF_TARGET})

include($ENV{IDF_PATH}/tools/cmake/project.cmake)
string(REGEX REPLACE ".*/\(.*\)" "\\1" CURDIR ${CMAKE_CURRENT_SOURCE_DIR})
project(${CURDIR})

git_describe(PROJECT_VERSION ${COMPONENT_DIR})
message("Project commit: " ${PROJECT_VERSION})

在这里插入图片描述

3.配置工程

此时，我们可以开始配置工程：
在这里插入图片描述

3.1配置开发板及GPIO

这个工程提供3种开发板选项，我们选择自定义开发板，根据实际情况选择GPIO：
在这里插入图片描述

3.2输入腾讯物联网控制台设备三元组

现在腾讯物联网控制台创建一个设备，创建方法见文章 《ESP32:腾讯云物联网控制台创建iot设备(使用腾讯连连控制ESP32)》。把这个设备的参数填到这里：
在这里插入图片描述

3.3指定配网方式

这里提供了3种配网：

  1. smart config(AirKiss)
    2.soft AP
    3.blufi

我们就选第一种：
在这里插入图片描述
到此，配置完成，保存配置，可以编译工程。
在这里插入图片描述

4.编译工程，下载程序到目标板

4.1编译工程

在这里插入图片描述
编译完成，生成各种文件：
在这里插入图片描述

4.2下载bin到目标板

使目标板进入下载模式，点击下载，等待下载完成，按复位键运行程序。
在这里插入图片描述

5.填坑：找不到头文件

尽管编译没有出错，但是vscode还是提示有几个错误：
在这里插入图片描述

在文件《 c_cpp_properties.json》加入esp-qcloud所在路径 “${config:idf.espIdfPathWin}/examples/esp-qcloud/**”，
在这里插入图片描述
注意，有2个地方增加相同的内容。
重新编译一下，就可以消除错误。

6.使用腾讯连连小程序测试ESP设备

详情见：《ESP32:腾讯云物联网控制台创建iot设备(使用腾讯连连控制ESP32)》

精选资源
VSCode-ESP-IDF:VSCode的ESP32 ESP-IDF模板
05-12
**VSCode-ESP-IDF: 使用VSCode进行ESP32 ESP-IDF开发详解** ESP32是一款高性能、低功耗的32位微处理器，广泛应用于物联网(IoT)项目中。Espressif Systems开发了ESP-IDF(ESP32 Integrated Development Framework)，...
利用VScode进行ESP32 Arduino开发.docx
09-24
利用VScode进行ESP32 Arduino开发开发环境搭建、最简易进行arduino操作esp32/8266的办法！总结文档
ESP32 例程使用全指南：从环境到实战，30分钟玩转基础功能
IAMIF12的博客
09-28 1061
准备 ESP32 开发板（如 ESP32-DevKitC）和 Micro USB 线，连接电脑后，在终端输入 ls /dev/ttyUSB* （Linux/macOS）或通过“设备管理器”（Windows）确认串口（如 COM3 ）。3. 点击 工具 -> 开发板 -> 开发板管理器，搜索“ESP32”，选择“ESP32 by Espressif Systems”，点击“安装”（约 10-15 分钟，需耐心等待）。- 解决：查开发板原理图确认 LED 连接的 GPIO 引脚，修改例程中的引脚号；
0·ESP IDF搭建VScode环境踩坑记（找不到头文件）
热门推荐
TenYao_的博客
01-14 1万+
整理了esp32和vscode环境配置的前期流程以及自己遇到的一些问题
图文手把手教程--ESP32 MQTT连接腾讯云物联网平台及OTA固件升级
felix_tao的博客
09-15 1万+
1）在腾讯云物联网开发平台，新建项目，并在项目下新建设备“light_001”。 2）下载腾讯云SDK-esp-qcloud，使用例程led_light，通过“腾讯连连”微信小程序控制。 3）在腾讯云物联网开发平台进行OTA固件升级。 4）在腾讯云物联网开发平台，查看设备、管理设备、调试设备。
VScode+esp-idf:编译安信可esp32-a1s例程(基于ESP音频框架esp-adf)
hwd00001的博客
08-18 2086
使用vscode，通过可视化的操作编译ESP-ADF例程，目标板为安信可ai_thinker_audio_kit_v2_3。
SOC-ESP32S3部分：2-2-VSCode进行编译&烧录
嵌入式成长手册
05-20 1633
无论是使用Window搭建IDF开发环境，还是使用Linux Ubuntu搭建IDF开发环境，我们都建议使用VSCode进行代码编写和编译，VSCode界面友好，支持各类免费的插件，可以大大加速我们开发，接下来，我们看看如何使用VScode进行工程编译烧录。我们可以看到VSCode的底部出现了一个powershell的终端，这就是使用VSCode的好处，编辑源码，编译，烧录都可以在一个IDE完成，这样，我们就不用手动另外在打开powershell啦。然后，我们执行脚本配置下IDF的环境变量。
ESP32在VScode下编译
m0_38012497的博客
04-12 779
3，如果有更改文件夹或更改文件夹名，删除“build”文件夹，重新编译一遍即可。这里只有main文件夹，CMakeLists.txt 和README.md。一个是用于存放esp-idf(SDK)的文件；一个用于存放编译等工具。2，可以拷贝一个工程，到指定文件下下，进行开发。1，搭建好环境之后，会有以下两个重要的文件夹。编译之后，多出build文件夹。VScode打开如下。
基于VScode的ESP32开发学习（二）：官方例程softap，提供wifi，详解
Newbie_H的学习之路
04-17 3291
完整代码放在文末 1.wifi事件处理函数 /*wifi事件处理函数*/ static void wifi_event_handler(void* arg, esp_event_base_t event_base, int32_t event_id, void* event_data) { if (event_id == WIFI_EVENT_AP_STACONNECTED) {
VSCode 中编译 ESP32 项目查看参与编译的文件列表
weixin_61268790的博客
04-01 1195
安装并配置 CMake Tools 插件后，可在 VSCode 底部状态栏看到 CMake 相关操作按钮。该文件记录了所有被编译的源文件路径及编译参数‌35。此命令会输出所有参与编译的源文件路径及编译命令‌45。文件，并在侧边栏展示参与编译的源码文件树状结构‌7。‌ 时，输出窗口会实时显示参与编译的文件列表‌57。在 VSCode 终端运行以下命令，添加。运行此任务后，终端会输出详细的编译文件信息‌。编译完成后，在项目根目录的。此插件可解析编译过程生成的。
VSCode + ESP-IDF安装与配置全过程
phmatthaus的专栏
04-20 6736
VSCode + ESP-IDF安装与配置全过程
精选资源
ESP32工程模板，基于vscode+esp-idf
08-11
ESP32是一款高性能、低功耗的微控制器，集成了Wi-Fi和蓝牙功能，广泛应用于物联网(IoT)、智能硬件等领域。ESP-IDF（Espressif IoT Development Framework）是Espressif Systems提供的一个用于开发ESP32应用的框架，...
VScode+ESP-IDF搭建ESP32开发环境
若有博文对您有帮助，欢迎点赞关注，收藏评论。
01-22 1154
ESP-IDF安装方式：这里选择VSCode 环境 ESP-IDF 插件方式安装， VSCode 插件市场中搜索并安装 ESP-IDF 插件：安装完成后侧边栏会多出一个 ESP-IDF 标志，点开后可以看到左侧的导航视窗中包含了开发 ESP32 的所有工具：此时右侧主窗口会显示插件配置界面，这里存在三个选项：选择hello_word模板创建项目：这一步选择Yes:选择芯片型号（选择开发板ESP32芯片系列）：
VSCode开发ESP32
风间琉璃的博客
11-20 2388
提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档 文章目录前言一、VSCode坏境配置二、CP210X三、串口连接问题总结 前言 提示：以下是本篇文章正文内容 一、VSCode坏境配置 安装好VSCode后下载PlatformIO IDE 安装后可以看到如下界面 然后再新建立一个工程 工程名字，开发板类型一般选ESP32 Dev Module即可，框架选择Arduino, 最后可以选择文件创建的位置，点击完成等待下载即可。 然后就可以编写程序了 编译，下载过程： 1是编
使用vscode开发esp32
ching的专栏
09-29 1万+
在vscode中开发esp32 设置好下载目录，等待下载完成，下载sdk时默认是从github上拉取，网络不好可能比较耗时。这里会列出来详细的命令 点击查看，命令面板或者使用快捷键ctrl + shift + p输入Show Examples Projects 这里会列出来当前sdk支持的全部demo 这里选择一个blink的demo 服务
linux下VScode开发ESP32,使用 vscode 编辑 esp32 代码
weixin_36343495的博客
05-15 696
8种机械键盘轴体对比本人程序员，要买一个写代码的键盘，请问红轴和茶轴怎么选？本文将介绍如何使用 VSCode 编写 ESP32 应用程序，值得注意的是 VSCode 只是编辑器。编译、下载等操作仍然需要使用命令行工具完成。由于 VSCode 是跨平台应用(支持 Windows、Linux、MacOS)，并且操作方法一致(在路径上会有所不同)，所以本文将以 Ubuntu 平台为主，同时兼顾 Win...
[ESP32]在vscode中搭建ESP32编译环境
weixin_42756460的博客
11-19 3457
使用vscode中的ESP-IDF插件配置ESP32编译环境的方法。
在VSCODE中配置开发ESP32（超简单）
Nibudao的博客
06-30 1450
到这里差不多就结束了，编写代码就在VSCODE中编写，编译和下载就要去ESP-IDF powershell去了，这和在LINUX中开发差不多，这是比较简单的方法了，找了网上很久的教程，都是一些配置很复杂的，初学不想搞那么复杂了，就这样了。
win11系统下vscode+esp-idf第一次编译卡住
最新发布
11-21
<think> 我们正在处理一个关于在Windows 11系统下使用VSCode和ESP-IDF进行第一次编译时卡住的问题。根据常见问题，这通常是由于环境配置、依赖下载或工具安装问题引起的。以下将分步骤提供解决方案。 ### 步骤1: 检查ESP-IDF环境配置 确保已正确安装ESP-IDF插件并设置环境。在VSCode中，按下`F1`打开命令面板，输入`ESP-IDF: Configure ESP-IDF extension`，选择`Advanced`模式进行安装。确保安装路径无空格和特殊字符，且选择正确的版本（推荐稳定版）[^1]。 ### 步骤2: 设置工具安装源 由于国内网络问题，建议将工具下载源设置为国内镜像。在配置ESP-IDF扩展时，选择`Custom`设置，在`Espressif IoT Development Framework Setup`界面中，找到`Tools mirrors`，选择`China (Gitee)`或`China (Espressif Systems)`镜像[^2]。 ### 步骤3: 检查环境变量 确保系统环境变量中已添加必要的路径。通常包括： - `IDF_PATH`：指向ESP-IDF安装目录 - `PATH`：添加`%IDF_PATH%\tools\bin`和`%IDF_PATH%\components\esptool_py\esptool`等 ### 步骤4: 启用详细日志 在编译时卡住，可以通过启用详细日志来定位问题。在VSCode的ESP-IDF插件设置中，将日志级别设置为`Debug`。然后重新编译，查看输出窗口中的详细错误信息。 ### 步骤5: 手动下载工具 如果卡在下载工具（如`xtensa-esp32-elf`）的步骤，可以尝试手动下载： 1. 从官方或镜像站点下载所需工具包（如`https://dl.espressif.com/dl/`或`https://github.com/espressif`）。 2. 将工具包解压到`%USERPROFILE%\.espressif\tools`目录下。 3. 重新运行编译命令。 ### 步骤6: 禁用杀毒软件和防火墙 临时禁用Windows Defender或其他杀毒软件，因为它们可能阻止编译过程中的文件访问或网络连接。 ### 步骤7: 使用离线安装包 如果网络问题持续，考虑下载离线安装包（从ESP-IDF GitHub releases页面获取）并按照官方文档进行离线安装。 ### 步骤8: 更新ESP-IDF和工具 确保使用最新版本的ESP-IDF和工具。在VSCode命令面板中运行`ESP-IDF: Update ESP-IDF Tools`。 ### 步骤9: 检查Python环境 ESP-IDF需要Python 3.7以上版本。确保系统默认Python版本符合要求，且已安装必要的依赖： ```bash python -m pip install -r %IDF_PATH%/requirements.txt ``` ### 步骤10: 清理并重建 尝试清理项目并重新编译： 1. 在VSCode终端中运行： ```bash idf.py fullclean idf.py build ``` §§相关问题§§ 1. 如何验证ESP-IDF环境配置是否正确？ 2. 在Windows 11下使用VSCode开发ESP32有哪些常见问题？ 3. 如何解决ESP-IDF编译过程中出现的Python依赖错误？ </think> 针对在Windows 11系统下使用VSCode和ESP-IDF首次编译卡住的问题，以下是分步解决方案： ### 1. **检查网络连接和镜像源设置** ESP-IDF首次编译需要下载大量工具链和依赖库（约1GB），国内用户建议设置镜像源： ```bash # 设置环境变量（在PowerShell执行） $env:IDF_GITHUB_ASSETS = "dl.espressif.com/github_assets" $env:GIT_SSL_NO_VERIFY = "1" ``` 或在ESP-IDF安装目录的`tools/idf_tools.py`中添加： ```python url_prefix = "https://dl.espressif.com/dl" ``` ### 2. **禁用实时防护** Windows Defender可能拦截编译进程： - 打开`Windows安全中心` → `病毒和威胁防护` → `管理设置` - 临时关闭`实时保护` - 添加VSCode和ESP-IDF目录到排除列表 ### 3. **更新基础依赖** ```bash # 在VSCode终端执行 python -m pip install --upgrade pip pip install -r %IDF_PATH%/requirements.txt ``` ### 4. **修复环境变量** 在VSCode终端手动激活环境： ```bash # 替换路径为你的实际安装位置 . $env:USERPROFILE/esp/esp-idf/export.ps1 ``` ### 5. **清理并重建项目** ```bash idf.py fullclean idf.py build -v # -v显示详细日志 ``` ### 6. **关键目录权限** 确保以下目录有完全控制权限： - `C:\Users\<用户名>\.espressif` - ESP-IDF安装目录 - 项目目录 （右键文件夹 → 属性 → 安全 → 编辑 → 添加用户权限） ### 常见卡住点解决方案 | 卡住阶段 | 现象 | 解决方案 | |---------|------|---------| | **下载工具链** | 长时间无进度 | 手动下载`xtensa-esp32-elf`解压到`.espressif/tools` | | **Python依赖** | 提示缺少模块 | 运行`pip install -r requirements.txt` | | **编译bootloader** | 卡在`.config` | 检查`make menuconfig`是否被拦截 | | **链接阶段** | 内存不足 | 关闭其他程序，增加虚拟内存 | ### 验证安装 创建测试项目验证： ```bash idf.py create-project test_build cd test_build idf.py build ``` > **注意**：首次编译通常需要30-60分钟，如超过2小时无响应需干预。建议使用有线网络连接[^1]。
评论 12
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值