[VSCODE]基於EIDE外掛搭建vscode下的STM32微控制器開發環境
EIDE(全稱Embedded IDE)是國內的一個大佬開發的vscode外掛,本人用下來體驗非常好,因此在這裡分享給大家,這是這個外掛的官方論壇和官方手冊
本篇文章只會提一些基本的使用,而且也只是針對基於有CUBEMX的STM32,如果想要開發其他微控制器詳細的還是得參考手冊
本篇文章是給有基礎的人看的,vscode的基本使用在這裡不會詳細展開,一些地方會講的比較粗略,如果有不懂的概念請自行查詢資料
如果你不喜歡vscode而是喜歡JetBrain家的Clion,也可以參考大佬的這篇文章
那麼我們正式開始
一、安裝GNU Arm Embedded Toolchain
這個有手就行
二、安裝vscode
這也是有手就行
注意點是安裝的時候記得把下面幾個選項開啟
確保自己的對著資料夾空白處的右擊選單裡面有通過code開啟
這個選項就行
三、安裝EIDE外掛和一些輔助性外掛
開啟vscode,在左邊的Extensions欄(或者按Ctrl+Shift+X)裡面可以搜尋你想要的外掛並安裝
搜尋EIDE,找到我們的主角,然後Install即可
我這裡是因為已經安裝過了所以沒有Install的按鈕
其他的一些外掛:
- C/C++
- C++ Intellisense
- Visual Studio IntelliCode
- Cortex-Debug 在debug的時候會用到
- Git Graph 和vscode自帶的git支援一起用會很方便
- LinkerScript 提供連結指令碼語法高亮
- BracketPair Colorizer2 彩虹括號,用了都說好
- 一些主題配色和圖示什麼的,可以網上看看推薦,我是喜歡預設黑
- background-cover 給你的vscode配上背景圖片,可以把你的老婆當背景什麼的
四、EIDE外掛的初始配置以及瞭解專案結構
4.1 外掛配置
4.1.1 配置工具鏈
如果EIDE外掛安裝成功的話vscode會在左側欄多出一個選項:
點進去會發現一共有上下兩欄,我們選擇下面的OPERATIONS,然後點選Set ToolChain Path,在彈出的選項中選擇:
接著選擇offline,然後選擇你的armgcc工具鏈安裝路徑即可,設定成功之後你再次開啟這個選項選單他就會和上面一樣打勾
4.1.2 配置燒錄器
我這裡是用的Jlink做燒錄器,如果要用其他的燒錄器自己想辦法去~
點選Open plug-in Settings
,進入外掛配置頁,找到Jlink,填入JLink的安裝路徑即可
4.2 瞭解專案結構
下文摘自官方文件
專案檔案:
.eide
eide專案資料夾,存放eide專案資訊,日誌等檔案.vscode
vscode配置檔案目錄build
編譯預設輸出目錄,可以在專案的設定中修改pack
晶片支援包的安裝位置 本篇教程不會涉及*.code-workspace
vscode工作區檔案,這對於eide專案是必須的
使用者檔案:
即專案檔案以外的檔案或資料夾
五、正式開始搭建工程
5.1 EIDE新建工程
開啟vscode,進入左邊EIDE一欄
選擇下面OPERATIONS欄裡的New Project
,接著選擇Empty Project
,32是cortex核心的所以選擇Cortex-M Project
然後會讓你選擇資料夾,選擇你平時放程式碼的資料夾即可,之後在右下角彈出來的視窗中確認,vscode就會自動進入該工作區
因為我們通過STM32CUBEMX生成程式碼所以這裡把自動生成的src資料夾刪除
5.2 用STM32CUBEMX生成程式碼
這個大家都會,我就不贅述了
需要注意的是Toolchain/IDE我們選擇Makefile(其實不改也行,改了只是方便我們後續配置)
這個時候你的專案大概是長這樣的:
5.3 配置EIDE專案
進入vscode的左邊EIDE一欄,在上面的EIDE PROJECTS裡面可以找到我們的專案了
我們展開它,發現有很多需要配置,我們一步步來
5.3.1 原始檔目錄設定
滑鼠停留在Project Resources一欄,會有一個資料夾以及綠色加號的圖示,我們點選它可以新建原始檔目錄,有虛擬資料夾和普通資料夾兩個選項,意思看它下面的註釋就能理解了
我們開啟Makefile檔案,找到C_SOURCES
那一欄,對照著把資料夾補齊(我習慣是用普通資料夾的)
然後根目錄下的.s檔案也是要加進去的,我的習慣是建一個虛擬資料夾放進去(在右鍵選單裡面可以新增檔案)
這個時候你的配置大概是這樣:
5.3.2 設定編譯器選項
在那個Builder Configurations那一欄選擇arm-gcc工具鏈
然後展開的選項裡面:
CPU Type
:你微控制器什麼核心就選什麼
Linker Script File Path
:選擇根目錄下的.ld檔案
Builder Options
:照著makefile裡面改就行,不過32的話我試下來不改也沒大事
設定完成大概是這樣:
5.3.3 設定燒錄器
選擇你的燒錄器,我這裡是用的Jlink,如果用其他的燒錄器就選其他的,也可以選擇Openocd,但是這裡不對Openocd做介紹,如有需要自行了解
展開來的選項裡面CPU Name
:選擇你的微控制器型號
設定完成就這樣:
5.3.4 專案屬性
Include Directories
:標頭檔案包含目錄,照著makefile中的C_INCLUDES
新增即可
Library Directorise
:庫目錄
Proprocessor Definitions
:預定義,也是跟著makefile來
完畢之後是這樣
5.3.5 專案設定
基本不需要動
到此為止,專案已經搭建完成
六、編譯和燒錄!
開啟專案裡面隨便一個檔案,右上角的Build按鍵即編譯,然後一個向下的箭頭即燒錄
如果出錯了就根據報錯找找原因,也翻翻上面有沒有遺漏的步驟
七、debug
考慮到文章幅度準備把這個部分放到我的下一篇文章