安装及使用（ESP-IDF／CLion）

安装及使用（ESP-IDF／CLion）

1.开发环境

操作系统：Windows 11

IDE：CLion 2025.1.1

SoC：ESP32

‍

‍

‍

‍

3.开发环境的搭建与新建项目

ESP-IDF的下载地址为

https://dl.espressif.cn/dl/esp-idf/?idf=4.4

打开网址后的界面如图所示。

框住的是离线下载，最高版本的，选择这个下载(最上面的在线的，我安装失败了，可能是我的网络问题/(ㄒoㄒ)/~~ ) ，安装后，进入刚刚安装好的文件夹内，右键选择idf_cmd_init.bat文件，选择用记事本或别的具有文本编辑功能的软件打开。

在文件的开头添加这两行代码，方便CLion检索IDF的路径，该路径应根据自己实际安装的目录来设置，添加完成后保存即可。

​: : set IDF_PATH set IDF_PATH=D:\app\appl\esp-idf\Espressif\5.4.1\Espressif\frameworks\esp-idf-v5.4.1​

配置好IDF路径后，若安装过程中勾选了新建快捷方式，桌面应该会出现这两个命令行工具。

前者简洁而后者功能强大，当然对于初期的学习，用CMD命令行就足够了。点开ESP-IDF CMD。若ESP-IDF安装无误，会出现如下界面。

使用CLion 新建ESP32_CODE空项目，用于存放个人项目.

在终端上执行 idf_cmd_init.bat 即可（必须用Command prompt）

​D:\app\appl\esp-idf\Espressif\5.4.1\Espressif\idf_cmd_init.bat​

在工程目录下创建项目

​idf.py create-project esp_demo01​

然后用CLion重新进入项目

首先点击 管理工具链 设置工具链。

接着点击+号新建一个叫ESP32的MinGW编译器，添加好ESP-IDF的环境文件后点击OK。

选择刚刚配置好的名叫EPS32的编译器。

接着配置好环境变量，如图所示，其中芯片型号需要根据自己实际使用的芯片配置，串口号需要插上开发板在设备管理器中查看。

​ESPPORT=COM3;IDF_TARGET=esp32​

然后点击确认，CLion 会自动加载项目

可以看到主文件中只有一个入口函数app_main。

接着点击小锤子构建项目。

初次构建项目时间较长，静静等待一会儿即可完成。

将开发板连接电脑，切换到flash并点击小锤子用以将程序烧录到开发板中。

稍作等待，即可烧录成功，当然由于主程序还没有写任何代码，因此暂时看不到任何现象，不过可以确定，到此为止，开发环境已经搭建成功。

回到项目的目录，可以看到目录里多出了两个文件夹和一个配置文件。

其中

• .idea用于存放CLion的配置文件

• cmake-build-debug-esp32用于存放 CMake 构建系统生成的所有临时文件和输出文件

• sdkconfig是esp32的配置文件。

由于我们目前未对芯片作任何配置，因此刚刚烧录进去的程序用的是默认的配置，该配置没办法完全利用up目前使用的开发板的性能，因此需要在menuconfig中对芯片进行配置。

4.menuconfig的配置

打开IDF命令行

输入idf.py menuconfig​命令，进入menuconfig界面。

在该界面下，ENTER键表示进入下一集目录或选中，ESC表示返回上一级。

进入到Serial flasher config目录下，可以看到其默认的配置Flash SPI mode为DIO，Flash size为2MB。

Flash SPI mode的可选项有4个，分别是QIO，QOUT，DIO，DOUT，四种模式的区别如下图所示。

可知QIO模式的速度最快，因此将Flash SPI mode更改为QIO，更改后的界面如下图所示。

设置完成后按ESC返回到初始界面后，再选择Partition table进入分区表的设置，如图所示，在该界面下有三个可编辑项。

进入第一个可编辑项，这里可以设置如图所示的五种分区表类型。

我们可以看到，IDF默认的设置是第一个。四种分区表的描述如下图所示。

前期学习时用默认的选项就行了，后期可以根据自己的需要设置对应的分区表。

返回初始界面，选择Component config，即进入ESP的相关组件配置界面，进入后往下滑动，找到ESP System Settings，如图所示。

这里默认设置的CPU主频为160MHz。

但是我们的ESP32最高主频可达240MHz，故将其设置为240MHz。

回到初始界面，点击键盘上的S键弹出确认保存弹窗，无需修改文件名，直接ENTER即可。保存成功后如图所示。

然后使用q退出

回到项目文件夹中，可以看到此处已经有了两个配置文件。

其中带.old后缀的为编辑前的旧的配置文件，而不带后缀的为我们刚刚配置并保存好后的新的配置文件。

到此，我们已经完成了所有基本配置，可以开始尽情的编写代码啦，当然，如果你以后有想更改的设置，也能回到menuconfig再次修改。

用CLion重新打开文件并切换到app对文件进行构建，由于我们对芯片进行了重新配置，因此此时会对工程进行重新编译。

切换到flash将程序重新烧录到芯片，刚刚的配置就生效啦。

参考

1. https://www.bilibili.com/opus/937647195293745176 【CLion-ESP32】从零开始的ESP-IDF

对上面的博主表示感谢。

‍