VS Code簡(jiǎn)介

VS Code（Visual Studio Code）是微軟公司出品，它是一個(gè)免費(fèi)且多功能的代碼編輯器，幾乎支持所有主要的編程語(yǔ)言和框架。特別是最近又新加了Github Copilot功能，讓用戶(hù)平滑進(jìn)入AI編程時(shí)代，進(jìn)一步提高了用戶(hù)編寫(xiě)代碼的效率。它也支持多種操作系統(tǒng)，windows/Linux/Mac多平臺(tái)，可以在【Visual Studio Code官網(wǎng)】（>=v1.96.0）中下載。

Visual Studio Code官網(wǎng)

https://code.visualstudio.com/

瑞薩電子作為國(guó)際知名嵌入式處理器大廠，緊跟技術(shù)潮流發(fā)展，積極適配VScode開(kāi)發(fā)生態(tài)，針對(duì)瑞薩的多種類(lèi)型的MCU和MPU平臺(tái)，開(kāi)發(fā)了Renesas VS Code Extensions，幫助用戶(hù)在VS Code中構(gòu)建和調(diào)試Renesas C/C++項(xiàng)目，它包括：

Renesas Build Utilities構(gòu)建項(xiàng)目

https://marketplace.visualstudio.com/items？itemName=RenesasElectronicsCorporation.renesas-build-utilities

Renesas Debug調(diào)試項(xiàng)目

https://marketplace.visualstudio.com/items?itemName=RenesasElectronicsCorporation.renesas-debug

本文將分為三部分來(lái)逐一介紹RA，RX，RL78系列MCU平臺(tái)在VS Code的使用步驟和事項(xiàng)。

RA MCU簡(jiǎn)介

RA家族系列MCU采用ArmCortex-M33、-M23、-M4和-M85處理器內(nèi)核，并經(jīng)過(guò)PSA認(rèn)證的、是行業(yè)領(lǐng)先的32位MCU。目前，涵蓋RA0/RA2/RA4/RA6/RA8系列。

具體步驟如下：

軟件安裝

1Python安裝

從下方鏈接下載并安裝64位Python 3.10.0或者以上版本。

64位Python 3.10.0

https://www.python.org/downloads/

將Python 3.10文件夾的路徑添加到“path”環(huán)境變量中。可以參考這篇博文。

Windows上安裝Python 環(huán)境并配置環(huán)境變量（超詳細(xì)教程）_python windows環(huán)境變量-CSDN博客

https://blog.csdn.net/Lyh1gguyg/article/details/146276117

2RA Smart Configurator（RASC）安裝

從下方鏈接下載并安裝。

RA Smart Configurator（RASC）安裝

https://github.com/renesas/fsp/releases

3CMAKE和Ninja安裝

從下方鏈接下載CMake Windows x64 installer（.msi），并安裝。

注：CMAKE版本大于3.31.1即可。

CMake Windows x64 installer（.msi）

https://cmake.org/

在安裝的時(shí)候，注意將CMake文件夾的路徑添加到“path”環(huán)境變量中。

從下方鏈接下載ninja-win.zip。解壓zip文件，并把ninja.exe復(fù)制到CMake的安裝路徑下的bin文件夾下。

ninja-win.zip

https://github.com/ninja-build/ninja/releases/

打開(kāi)windows命令窗口。輸入ninja --version和cmake --version檢查是否安裝正確，并且已經(jīng)添加到了環(huán)境變量中。

4安裝編譯工具鏈GCC和LLVM

GCC

https://developer.arm.com/downloads/-/arm-gnu-toolchain-downloads

LLVM

https://github.com/ARM-software/LLVM-embedded-toolchain-for-Arm/releases

注意，確保您下載的工具鏈版本和您使用的FSP版本相匹配。

將GCC的bin文件夾路徑添加到ARM_GCC_TOOLCHAIN_PATH環(huán)境變量中，將LLVM的bin文件夾路徑添加到ARM_LLVM_TOOLCHAIN_PATH環(huán)境變量中。

注意，有些電腦用戶(hù)，如果在添加了GCC和LLVM到環(huán)境變量中后，在接下來(lái)的步驟中，遇到了上述變量找不到的情況，可以嘗試使用管理員權(quán)限打開(kāi)和運(yùn)行VS Code。

5安裝和配置RASC

對(duì)于RA項(xiàng)目，建議在開(kāi)始開(kāi)發(fā)之前安裝和配置RASC（RA Smart Configurator）。從下方鏈接下載安裝RASC。

https://github.com/renesas/fsp/releases

6打開(kāi)VS Code

打開(kāi)VS Code，請(qǐng)先確保已經(jīng)在VS Code中已經(jīng)安裝好Renesas Build Utilities和Renesas Debug擴(kuò)展。

打開(kāi)Command Palette（鼠標(biāo)左鍵選擇View=>Command Palette菜單，或者使用CTRL+SHIFT+P快捷鍵），然后再點(diǎn)擊Renesas：Open Renesas Support Files Manager。

選擇左邊RA，然后再選擇Install，等待安裝完成。

添加Smart Configurators。

點(diǎn)擊Select RA SC按鈕。

在彈出的對(duì)話框中選擇已經(jīng)安裝的rasc.exe。

Renesas Debug擴(kuò)展將自動(dòng)導(dǎo)入并注冊(cè)RASC到VS Code中。

此過(guò)程將注冊(cè)Smart Configurator以供使用，并導(dǎo)入調(diào)試所需的設(shè)備文件。

7創(chuàng)建工程

打開(kāi)VS Code，點(diǎn)擊View→Command Palette 后，選擇Renesas：Create RA Project with Smart Configurator。

VSCode會(huì)顯示已經(jīng)安裝的RA Smart Configurator列表，選擇其中的一個(gè)Smart Configurator。

選擇創(chuàng)建工程的文件夾

輸入項(xiàng)目名稱(chēng)，然后點(diǎn)擊Next。

配置好您的板子信息，設(shè)備類(lèi)型和工具鏈。然后點(diǎn)擊Next。

選擇“No RTOS”，然后點(diǎn)擊Next。

選擇下圖中的工程模板，然后再點(diǎn)擊Finish完成項(xiàng)目創(chuàng)建。

當(dāng)工程生成完畢后，關(guān)閉RA Smart Configurator。

工程編譯

注意

VS Code中的Restricted模式，會(huì)造成Command Palette中CMake命令不可用。

需要將Restricted模式關(guān)閉。點(diǎn)擊左下角的Restricted Mode，點(diǎn)擊Trust。

當(dāng)?shù)谝淮未蜷_(kāi)先前步驟創(chuàng)建的工程時(shí)，請(qǐng)使用Command Palette中的CMake configure來(lái)配置CMake和Kit selection。

然后對(duì)kit進(jìn)行配置，選擇“ARM GCC - Ninja”。

注意：如果在此步驟，選擇了錯(cuò)誤的CMake kit會(huì)導(dǎo)致編譯失敗。您可以通過(guò)Command Palette中的“CMake：Select a kit”重新配置Kit。

點(diǎn)擊菜單中的Terminal→Run Build Task。

選擇Build Project。

當(dāng)工程編譯完成，默認(rèn)情況下，.elf會(huì)生成在“build//CMakeFiles/.elf.dir/”文件夾中。

工程調(diào)試

可以通過(guò)點(diǎn)擊Run→Start Debugging，或者F5鍵來(lái)啟動(dòng)調(diào)試。

當(dāng)調(diào)試開(kāi)始后，通用的調(diào)試控制按鈕將顯示，包括如返回，暫停，單步，單步跳過(guò)，單步跳出，重啟，調(diào)試停止。在Debug Console處，將顯示調(diào)試過(guò)程中的一些有用信息。

在調(diào)試期間，本地變量，設(shè)備寄存器，調(diào)用堆棧，監(jiān)視變量，外設(shè)狀態(tài)的詳細(xì)信息將顯示在Run and Debug選項(xiàng)卡中VS Code主側(cè)邊欄。

通過(guò)上述步驟，用戶(hù)完整體驗(yàn)了在VS Code中使用瑞薩RA系列MCU的全過(guò)程。接下來(lái)的內(nèi)容將介紹如何在VS Code中操作瑞薩RX和RL78系列MCU，敬請(qǐng)繼續(xù)關(guān)注！