ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀,每一条都经过真实交付验证。

ESP-IDF框架学习

2026/8/13 13:30:41 拓冰建站 浏览量
ESP-IDF框架学习

摘要:本文详细介绍了ESP-IDF框架的安装、常用命令及基于CLion的开发环境配置,并重点讲解了如何将小智AI项目从GitHub/Gitee克隆到本地,完成引脚修改、编译配置等移植工作。文章涵盖Git安装、Gitee注册、Git基本操作等前置知识,适合ESP32开发者快速上手。

1.ESP-IDF框架介绍

  • 乐鑫官方开发
  • Arduino是上层,简单开发运用

2.ESP-IDF安装

  • ESP-IDF Installation Manager Downloads
  • C盘是工具链,D盘是源码。

3.ESP-IDF各种常用命令介绍

  • 先用一下测试代码:
  • 设置目标芯片类型
  • 然后打开菜单配置
  • 配置一些信息
  • 然后idf.py.build,去编译我们的程序

4.基于CLion的IDF环境配置

  • Clion:专业的C/C++开发
  • 需要我们创建工具链,工具链在这里
  • 然后创建,正常写代码即可

项目信息表

字段内容
项目名称小智AI移植(ESP32 LCD触屏版)
项目目标在Windows环境下搭建ESP-IDF + CLion开发环境,通过Git从GitHub/Gitee克隆小智AI项目代码,根据目标硬件原理图修改引脚定义和板型配置,成功编译并烧录到带LCD触摸屏的ESP32开发板,使小智AI应用在目标硬件上正常运行。
硬件清单
  • ESP32开发板(带LCD触摸屏)
  • LCD触摸屏
  • 面包板(用于配置相关类型)
用到的库/协议/框架
  • ESP-IDF(乐鑫官方IoT开发框架)
  • CLion(C/C++集成开发环境)
  • Git(版本控制系统)
  • GitHub / Gitee(代码托管平台)
  • idf.py(ESP-IDF编译工具)
  • PowerShell(Windows命令行工具)
通信架构本文聚焦本地开发环境搭建与代码移植,未涉及设备与云端、小程序或AI服务的通信架构。
关键代码套路/函数名
  • idf.py set-target <芯片型号>– 设置目标芯片类型
  • idf.py menuconfig– 打开菜单配置(S保存,Q退出)
  • idf.py build– 编译项目
  • git clone <SSH链接>– 克隆远程仓库到本地
  • CLion中“从现有源打开”导入项目
  • 删除build文件夹后执行Full Clean重新编译
踩坑点
  1. 必须使用CLion的“从现有源打开”功能导入项目,不能新建项目。
  2. 代码移植后必须对照硬件原理图修改引脚编号,否则硬件无法工作。
  3. 编译异常时,删除build文件夹(编译缓存)后重新编译通常可以解决问题。
  4. CLion中需要手动创建并指定ESP-IDF工具链路径。
  5. menuconfig中配置的板型必须与实际使用的LCD触屏型号一致。
部署/产品化
  • 通过USB串口将编译好的固件烧录到ESP32开发板。
  • 使用Git进行版本管理,支持多设备协作开发。
  • 本文未涉及Docker容器化、服务器部署、OTA(空中升级)或小程序开发等产品化步骤。

5.小智AI移植

  • 将虾哥的小智AI进行迁移,用Clion打开,然后修改代码。
  • 打开GitHub代码。用Git方式去使用。

5.1 项目开发-Git安装

  • 什么是git:代码的版本管理,有问题可以快速调节。核心能力:版本跟踪回退
  • 举例:家里和学校分别有2个电脑,在家修改代码提交git到gitte,到学校直接下载git就可以接着修改代码了
  • 安装git:
  • 打开powershell看一下是否安装成功

5.2 项目开发-Gitee注册

  • 其实Gitee以及GitHub都是基于Git工具的代码托管服务器
  • Gitee账号注册

5.3 项目开发-Git基本操作

  • 搞好了仓库,怎么去Git克隆
  • 复制链接然后打开powershell,先转到D盘,然后git clone 复制的ssh链接
  • 添加公用密钥:允许我们克隆项目,克隆成功后,我们的D盘就有我们本地的文件夹
  • 提交是在本地进行提交,推送是发到Git云端

5.4 小智代码移植

  • 复制好Git链接,然后git clone 后面放代码链接,然后在本地仓库就有了小智代码
  • 这里一定是从现有的源打开!!!!
  • 我们代开代码后,选择和我们适配的板子,我们有lcd触摸屏
  • 代码是写好的,只需要修改引脚编号即可。
  • 对照原理图,修改好引脚后,我们加载新项目。把build(编译缓存文件)文件夹给删除掉。然后Full Clean。我们还要Menu Config配置我们的板子类型。S保存,Q退出
  • 如果遇见一些问题,把build(随便删除)删除一下,然后再编译build按钮就行。
  • 主要:更改引脚,以及配置相关类型的面包板。了解了怎么把Github的代码克隆到我们本地计算机上面来,cd D:以及git clone 路径。到编译软件打开文件夹