clion + platformio搭建
参考官方指导
1.安装Clion,官网下载。
2.Clion安装platformio插件
-
关闭工程的界面如下,plugins一下就能找到,在marketplace中搜索PlatformIo
-
已打开项目的情况下,在settings中可以找到plugins。
-
安装完,重启clion.
3.安装platformio
- 已安装插件当想要新建platformIo工程提示platformIo utility 没有找到。
未安装platformio环境的同学可以点击Install guide进行安装。目前的内容就是将这个get-platformio.py 文件下载下来后,使用 Python执行它,国内多半pc解析不了某个域名,下载不下来文件,所以很麻烦。这里不能多说,可以使用阿里公共dns或者腾讯dns。
得到这个文件后,执行以下命令然后等待
python3 get-platformio.py
4.新建项目时,可以再重启Clion。
未配置环境变量,可以点击上图的Settings,选择pio。
待其加载完开发板列表,可以输入项目名称,选择自己的开发板类型。(本人使用的是wemos d1,是一种长得很像arduino的esp8266)
不出意外(多半会出意外),能新建一个项目,会初始化好对应开发板的sdk。我选择的是arduino框架的方式,因而会生成一个main.cpp里面会和arduino 一样生成两个函数setup 和loop。
按以上的图选择生成的初始化命令也会在工程刚打开的时候执行
我的生成的命令如下(看上一句这里只是记录,暂时并不需要你执行它):
/home/lustre/.platformio/penv/bin/pio init --ide clion --board d1 -O framework=arduino
如果出现报错在run界面,报错意思是下载出错一类的,可以重新执行,可以使用命令或在点击run侧边栏按钮
如果没有正确生成文件,比如这种报错
Error: Please setup environments in `platformio.ini` file
可以丢弃这个空项目再尝试新建一个,因为新建项目初始化的命令里面包含你选的板子类型,都没有写入platformio.ini文件里面,就挂了,等第二次打开初始化的时候重这里解析就报这个报错。
5.第一次很慢的原因是对应的平台SDK没有安装
如同arduino里开发板管理需要下载esp8266,esp32一样。它在选完开发板后发现没有对应SDK会自动下载,国内特别慢。
如果platformio.ini文件里面不为空同时不想被第一次初始化很慢,又被无法掌控进度拿捏心态。
可以停止它自动的初始化在终端当前文件夹执行以下命令。这样可以看到它下载的细节。
pio init --ide clion
它下载某些东西的内容也是来自github,你会看到下载进度特别慢,然后一会儿又失败了,它又开始尝试。有时候使用手机热点供PC使用偶尔有效,可以提高这个速度,但不总是有效。或许明天试一下就有效了。
6. [platformio并不是依赖于cmake]
(https://docs.platformio.org/en/latest/integration/ide/clion.html#project-configuration-and-cmake) 但使用windows用户需要注意设置Toolchains
如果是最新版的platformio 没有生成相关cmake配置文件 ,请使用232以后的clion和最新的PlatformIo for Clion插件 。则无需关注cmake。
232以后的clion使用了非cmake方式加载platformio项目,用于解决了某些开发板环境也依赖cmake导致冲突的情况。
设置Toolchains。linux和macos同学安装的相关环境,使用本系统的就好,反正最终其实还是和这个关系不大,根据自己情况安装gcc g++。
但windows同学使用clion日常会用 WSL Cygwin MinGW 来提供编译 构建工具,这样会导致cmake文件里面的路径和编译构建工具路径无法正常获取到,虽然还可能正常构建甚至上传,但clion会全程报错,标红。
本人曾经尝试完全使用WSL构建,甚至依赖包的索引目录,也都换成WSL上的路径的确不会报错。但WSL正常情况下无法连接串口,如果再利用windows本地的pio进行编译烧录也行,但那也太麻烦了,二来Clion通过WSL索引的文件,没有直接通过当前系统路径访问快。
这里windows同学可以设置 Toolchains为System这个选项,这样可以兼容windows的路径,添加一个System类型的Toolschain点击上三角🔼将它移到第一位。本人这里使用的win11的PC。
如果windows下没有检测到c和c++编译器(如下图)可能导致cmake初始化不正常,但这俩东西对于platformio并没有用处,但会影响clion.
在windows环境的情况下这里我们可以新建两个可执行的文件如bat脚本充当gcc和g++来解决该问题。
选择一个非项目的文件夹,新建两个文件如 gcc.bat
g++.bat
然后选中他们。
然后右键CMakeList.txt重新加载
待其Cmake重新加载完,如果文件路径正确,会把相关平台的库的包索引完成,这样就不会报错,才能正确跳转源码。
7. 烧录
以下是官方教程的方式不推荐,建议使用本人提供插件(Platformio Plus,请参考本文第九章),无需配置,直接点击upload 节点触发烧录
-
执行 PlatformIO Upload会触发编译和上传(生成的工程里面,运行配置里面一般含有PlatformIO Upload)
若没有则在运行配置中添加即可:
除非你想要烧录的板子驱动正常,插在当前PC上,当前PC没有其他板子,速率为9600,则不用额外配置,可以直接运行PlatformIO Upload,否则参照下一步
-
配置烧写的端口和波特率
在项目文件夹下 platformio.ini中添加两行指定这些配置
upload_port = COM8 upload_speed = 115200
更多上载相关参考官方说明
-
配置正确后执行
如上图就上载成功了。
-
串口监视
-
建议使用本人提供的插件(Platformio Plus,请参考本文第九章),无需配置,直接点击monitor节点调用pio的串口监视功能*
1.使用插件
Serial Port Monitor
-
或者使用platformio自带的
查看帮助:pio device monitor -h
-p
指定端口-b
指定波特率如:
pio device monitor -b 115200 -p COM8
或者可以写在platformio.ini中
monitor_port = COM8 monitor_speed = 115200
8.pio工具菜单(这一章可以跳过直接看第九章)
打开顶部Tools菜单项,可以看到比较潦草的加了一些pio命令封装出来的界面的按钮,当你点击之后就会打开控制台执行一个pio命令。
或者右键platformio.ini
当我们修改platformio.ini或者利用命令行或者pio home添加了库,Clion可能会出现报错找不到库,
这个时候需要修改Cmake文件,我们这里新初始化即可。
使用菜单了Re-Init或者在终端执行pio init --ide clion
9.Platformio Plus插件
由本人提供的插件。帮助Clion使用Platformio命令如同 maven或者gradle一样通过命令树执行,省去手动使用终端的麻烦。同时可以嵌入platformio home到clion里面。已上架clion插件市场。
开源地址:
github
gitcode
-
任务树
现在含有默认的任务,不含从platformio.ini中动态加载的开发板特有的任务。
一些特定 任务是需要相关 参数变量 ,则需要声明在platformio.ini中。现在只有默认的任务则只能使用platformio.ini的默认environment执行。 -
platformio home