clion + platformio搭建

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
  

2. 或者使用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