使用VS Code 搭建 platformio 平臺

2022-08-31 18:02:54

一、需要的資源網站

arduino GitHub:https://github.com/arduino
espressif GitHub:https://github.com/espressif
platformio GitHub:https://github.com/platformio
platformio 資源搜尋:https://registry.platformio.org/search

二、安裝VS Code

  1. 下載VS Code
    官網:https://code.visualstudio.com/

  2. 安裝比較簡單,這裡就不贅述了

三、安裝 platformio 環境

  1. 在VS Code 中搜尋 platformio

  2. 點選安裝即可

  3. platformio 開啟

  4. platformio 面板

四、platformio使用

  1. 新建工程

    注意:

    • 專案的預設路徑是:C:\Users\Administrator\Documents\PlatformIO\Projects
    • 首次建立專案時會很慢,如果網不好的話,等待一天都是有可能的,具體解決辦法耐心看完後面的筆記
  2. 工程目錄

    • .pio:存放工程編譯產生的檔案
    • .vscode: 存放針對工程客製化化的 vscode 組態檔
    • include:存放統一管理的 h 標頭檔案
    • lib:存放自己編寫的庫檔案
    • src:存放工程專案的 C/C++ 原始檔
    • test:存放工程專案的測試檔案,一般用不到
    • .gitignore:git 倉庫的忽略檔案,方便 git 進行工程專案的版本控制
    • travis.yml:持續整合的組態檔,一般用不到
    • platformio.ini:專案的核心組態檔,這個會經常用到,所以得了解其中可用的設定項[4]
  3. 測試程式
    在 src/main.cpp 檔案中新增下面程式

    #include <Arduino.h>
    
    void setup() {
    	// put your setup code here, to run once:
    	pinMode(LED_BUILTIN, OUTPUT);
    }
    
    void loop() {
    	// put your main code here, to run repeatedly:
    	digitalWrite(LED_BUILTIN, HIGH);
      	delay(1000);
     	digitalWrite(LED_BUILTIN, LOW);
      	delay(1000);
    }
    
    
  4. 編譯下載

五、新建工程比較慢的解決辦法

下載慢的原因主要是因為網路不好,因為伺服器都在國外,當然檔案也比較大。所以首次建立專案需要耐心等待

  1. 更改下載倉庫
    在 「C:\Users\Administrator.platformio\penv\pip.conf」 檔案中新增一下類容

    [global]
    index-url = https://mirrors.aliyun.com/pypi/simple/
    
    [install]
    trusted-host = mirrors.aliyun.com
    

    我測試過,沒有什麼效果,可能是我這裡的網本來就不好,詳細測試方式看這位大佬的筆記

  2. 離線安裝
    這位大佬採用了離線安裝的方式,我也沒測試過,需要的小夥伴可以自己研究一下。

  3. 替換平臺和包檔案
    這個和離線安裝的方式差不多,都是需要找到已經下載的平臺檔案和包檔案,然後進行替換。

    • 下載平臺檔案
      platformio GitHub 中下載自己需要的環境

      下載完成後,將其解壓放在路徑 「C:\Users\Administrator.platformio\platforms」 下,開啟VS Code,即可看到平臺已經安裝完成,如下圖所示:

    • 工具包檔案
      點選對應的平臺,可以檢視需要的工具包及版本,如下圖所示:

      注意:

      1. 工具包和環境可以工作platformio倉庫檢視
      2. 包檔案是自動下載的,所以就沒有提供額離線的現在方式,但是我們可以找已經安裝的電腦將工具包拷出來替換即可,工具包存放的路徑在 「C:\Users\Administrator.platformio\packages」
      3. 安裝好平臺及工具包後在建立專案就快很多了,只需要十多分鐘即可,如果還出現網不好的現場,可以通過手機熱點之類的下載即可。
  4. 建立檔案沒進度條
    這裡就比較坑了,因為首次建立專案時,下載的檔案還是比較大的,一共有幾個G的樣子,但是又沒進度條,讓我沒等下去的耐心了,這裡有一個間接的辦法。
    我們可以通過檢視 「.platformio」檔案的大小來檢視下載的速度,如下圖所示:

參考文獻

platformIO環境安裝_kimiyang123的部落格-CSDN部落格_platformio安裝:https://blog.csdn.net/kimiyang123/article/details/110871196
基本使用 - 新建專案 - 知乎:https://zhuanlan.zhihu.com/p/78722930
解決一直無法建立工程問題 - 知乎:https://zhuanlan.zhihu.com/p/444466189>
Visual Studio Code PlatformIo IDE 新建專案下載慢的解決辦法:https://blog.csdn.net/ngl272/article/details/124776171