CLion 安装 platformIO 教程

目录

如已在Visual Studio Code中正常使用PlatformIO,则只需进行步骤3和步骤4。
本教程在windowns环境下编写,macOS / Linux 下安装流程相同。

1. 安装Python

可参考:python详细安装教程

前往Python官网的下载页面,点击下载即可下载最新版本的安装包。

Untitled

一定要勾选 Add Python.exe to PATH,然后点“Install Now”即可完成安装。

Untitled

2. 安装PlatformIO Core

要安装或升级 PlatformIO Core,先下载(右键→将链接另存为)get-platformio.py 脚本,打开cmd,进入到脚本所在路径下,然后运行以下命令:

# 进入到脚本所在路径下,根据实际填写
# cd D:\Users\xxx\Downloads

# run it
python get-platformio.py

如需在命令行中使用platformio命令,需配置环境变量:将C:\Users\你的用户名\.platformio\penv\Scripts;加到 Path 环境变量里。

Untitled

参考:https://docs.platformio.org/en/latest/core/installation/methods/installer-script.html

3. 安装CLion

有edu邮箱的可去Jetbrains官网申请教育许可证,或者使用学信网学籍验证报告申请。在申请页面选择对应的申请方式即可。完成后,选择CLion进行下载安装,安装完成后登录拥有教育许可证的JetBrains账号即可使用。

Untitled

没有教育许可证的可百度找破解版安装,版本号需大于2020.1。

4. 安装PlatformIO插件

先打开 CLion 的插件管理器, 然后搜索PlatformIO, 点 install 安装即可。

Untitled

5. 使用

点击新建项目,选择PlatformIO,选择需要的开发板及框架,设置项目路径及名称,最后点击创建即可。

Untitled

首次创建该开发板的工程时,需等待较长的一段时间,此阶段PlatformIO会下载该工程所需的配置文件。如创建失败可手动添加PlatformIO配置文件,见步骤7。

编译和下载按钮在右上角,按下图切换到上传模式即可烧入,如需调试则切换到调试模式。

1683289953496.png

Untitled

如无PlatformIO配置,下拉后选择 编辑配置,在点击+号添加对应配置即可。

Untitled

Untitled

程序上传后,如在步骤2中添加了platformio环境变量,可在CLion中使用串口监视器。

打开 终端(Terminal),输入platformio device monitor ,就可以打开串口监视器,查看串口输出。再次烧入时需将此终端关闭,或者按 Ctrl+C 键退出串口监视器。

Untitled

串口监视器的比特率默认是 9600,如想更换,比如 115200,除把代码中的Serial.begin(9600)换成Serial.begin(115200)外,还需在 platformio.ini 中加一句monitor_speed = 115200,否则会出现乱码。

6. 使用第三方库

6.1 PlatformIO提供的库

PlatformIO拥有丰富的第三方库。

使用 DHT22 传感器进行举例。

先打开 PlatformIO 的 Libraries registry,勾选Library后搜索 DHT sensor library:

Untitled

找到DHT sensor library后,点击打开:

Untitled

在库的详情页面,最需要关注的是 Readme 和 Installation,其中 Readme 介绍如何使用这个库, 而 Installation 介绍如何安装。

Untitled

首先安装,打开 Installation,根据提示将需要的库依赖写在 platform.ini 中即可:

Untitled

然后点锤子形状的编译按钮,会发现编译过程中有下载依赖的行为。

Untitled

不出意外的报错了。

Untitled

提示找不到头文件。

库被 PlatformIO 下载到了./.pio/libdeps/开发平台名/中,可以找到这些库存放头文件的路径 (一般直接就是第三方库目录,或者是其下的 src 目录)。

打开CMakeLists.txt,然后使用include_directories语句,将这些存放头文件的路径包含进去。

文件夹路径可通过 右键文件夹→复制路径/引用.…→来自内容根的路径 获取。

Untitled

Untitled

修改之后,重新右键,Reload CMake Project,或者点右上角的Reload Changes提示,重新载入CMake 工程。

Untitled

可以看到,依然报错,且报错的内容与前面相同。╰(‵□′)╯

Untitled

点开报错的内容,跳转到报错的地方。

Untitled

根据提示修改报错内容。

Untitled

编译成功

Untitled

根据例程编写程序后发现,虽然可编译通过,但是编译器还是会报红,原因可能是库文件夹名称存在空格。

Untitled

修改库文件名称。右键文件夹→重构→重命名,作用域选所有位置,修改完成后点击重构。

Untitled

记得修改CMakeLists.txt中,包含库文件的路径。修改后点击 加载CMake更改。

Untitled

以及刚才修改的头文件。

Untitled

然后就可以使用了。

Untitled

参考:用clion自带的platformIO和开发esp32!!!

6.2 其他库

只需将库文件下载下来后,复制到lib文件夹中,然后在CMakeLists.txt 文件中包含路径即可。

Arduino IDE下载的库文件均在路径 C:\Users\yourname\Documents\Arduino\libraries

Untitled

7. 手动添加PlatformIO数据包

如工程已创建成功,则不需进行此步骤。

PlatformIO相关的文件均在路径 C:\Users\yourname\.platformio 下,其中 yourname 为电脑用户名称,因此将下载好的文件复制到此处即可。

Untitled

下面提供我的PlatformIO数据包,包含ESP32和ESP8266的arduino框架。

阿里云盘:https://www.aliyundrive.com/s/pFDFnmdz8mi CSDN下载:PlatformIO 离线安装资源

Untitled

Untitled