前期回顧

01VS Code中玩轉(zhuǎn)瑞薩MCU（1）——RA MCU

02VS Code中玩轉(zhuǎn)瑞薩MCU（2）——RX MCU

RL78 MCU簡(jiǎn)介

RL78家族系列MCU，以其業(yè)界領(lǐng)先的低功耗和各種內(nèi)置的高性能外圍功能，極大地提高了電源效率，降低了BOM成本，實(shí)現(xiàn)了設(shè)備的小型化。

具體步驟如下：

軟件安裝

請(qǐng)先確保安裝了VS Code（>=v1.96.0）軟件和以下VS Code extension。

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

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

2RL78 Smart Configurator

（RL78 SC）安裝

從下方鏈接下載并安裝。

RL78 Smart Configurator（RL78 SC）

https://www.renesas.com/en/software-tool/rl78-smart-configurator#downloads

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安裝編譯工具鏈CC-RL和

LLVM for Renesas RL78

CC-RL

https://www.renesas.com/us/en/software-tool/c-compiler-package-rl78-family

LLVM for Renesas RL78

https://llvm-gcc-renesas.com/rx-download-toolchains/

將CC-RL的bin文件夾路徑添加到RENESAS_CCRL_TOOLCHAIN_PATH環(huán)境變量中，將LLVM for Renesas RL78的bin文件夾路徑添加到RENESAS_LLVM_TOOLCHAIN_PATH環(huán)境變量中。

注意

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

5打開(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：Create RL78 Project with Smart Configurator。

VS Code將顯示已經(jīng)安裝的RL78 Smart Configurator列表，從列表中選擇一個(gè)RL78 Smart Configurator。

如果您看不到已經(jīng)安裝的RL78 Smart Configurator列表，VS Code右下方會(huì)彈出消息框，提示“No RL78 Smart Configurator installation found！”。

點(diǎn)擊Browse RL78 SC按鈕。

在彈出的對(duì)話框中選擇已經(jīng)安裝的RL78 Smart Configurator執(zhí)行文件（SmartConfigurator.exe）。

RL78 Smart Configurator將自動(dòng)導(dǎo)入并注冊(cè)RL78 SC到VS Code中。

創(chuàng)建工程

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

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

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

輸入項(xiàng)目名稱，配置好您的板子信息，設(shè)備類型和工具鏈。然后點(diǎn)擊Next。

點(diǎn)擊System，在On-chip debug operation setting處選擇Use emulator或者COM Port。

單擊Generate Code并閉RL78 Smart Configurator。

工程編譯

注意

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

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

在VS Code，請(qǐng)使用Command Palette中的 “CMake：Delete Cache and Reconfigure”。

第一次運(yùn)行的時(shí)候，需要對(duì)kit進(jìn)行配置，選擇“Unspecified”。

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

選擇Build Project。

工程調(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è)邊欄。

至此，在VS Code中調(diào)試和使用瑞薩RA、RX、RL78系列MCU的步驟講解已全部完成。如果在調(diào)試過(guò)程中遇到問(wèn)題或有任何好的想法，歡迎反饋給我們，讓我們一起探索更多玩法，共同玩轉(zhuǎn)瑞薩MCU！