在VSCode中玩转MCU

VS Code是一款免费且多功能的代码编辑器，几乎支持支持市面上所有主流的编程语言和框架。特别是最近又新加了Github Copilot功能，让用户平滑进入AI编程时代，进一步提高了用户编写代码的效率。

本文将介绍瑞萨RA系列MCU平台在VS Code的使用步骤和事项。

• Renesas Build Utilities构建项目

• 从下方链接下载并安装64位Python 3.10.0或者以上版本。（您可复制下方链接至浏览器，或扫描二维码进行查看）

• 将Python 3.10文件夹的路径添加到“path”环境变量中。可以参考这篇博文。（您可复制下方链接至浏览器，或扫描二维码进行查看）

• 从下方链接下载并安装。（您可复制下方链接至浏览器，或扫描二维码进行查看）

• 从下方链接下载CMake Windows x64 installer（.msi），并安装。（您可复制下方链接至浏览器，或扫描二维码进行查看）

        注：CMAKE版本大于3.31.1即可。

• 在安装的时候，注意将CMake文件夹的路径添加到“path”环境变量中。

• 从下方链接下载ninja-win.zip。解压zip文件，并把ninja.exe复制到CMake的安装路径下的bin文件夹下。（您可复制下方链接至浏览器，或扫描二维码进行查看）

• 打开windows命令窗口。输入ninja --version和cmake --version检查是否安装正确，并且已经添加到了环境变量中。

• GCC（您可复制下方链接至浏览器，或扫描二维码进行查看）

• LLVM（您可复制下方链接至浏览器，或扫描二维码进行查看）

• 注意，确保您下载的工具链版本和您使用的FSP版本相匹配。

• 将GCC的bin文件夹路径添加到ARM_GCC_TOOLCHAIN_PATH环境变量中，将LLVM的bin文件夹路径添加到ARM_LLVM_TOOLCHAIN_PATH环境变量中。

  注意，有些电脑用户，如果在添加了GCC和LLVM到环境变量中后，在接下来的步骤中，遇到了上述变量找不到的情况，可以尝试使用管理员权限打开和运行VS Code。

• 打开Command Palette（鼠标左键选择View=>Command Palette菜单，或者使用CTRL+SHIFT+P快捷键），然后再点击Renesas：Open Renesas Support Files Manager。

• 选择左边RA，然后再选择Install，等待安装完成。

• 添加Smart Configurators。

• 点击Select RA SC按钮。

• 在弹出的对话框中选择已经安装的rasc.exe。

• Renesas Debug扩展将自动导入并注册RASC到VS Code中。

• 此过程将注册Smart Configurator以供使用，并导入调试所需的设备文件。

• 打开VS Code，点击View→Command Palette 后，选择Renesas：Create RA Project with Smart Configurator。

• VSCode会显示已经安装的RA Smart Configurator列表，选择其中的一个Smart Configurator。

• 选择创建工程的文件夹

• 输入项目名称，然后点击Next。

• 配置好您的板子信息，设备类型和工具链。然后点击Next。

• 选择“No RTOS”，然后点击Next。

• 选择下图中的工程模板，然后再点击Finish完成项目创建。

• 当工程生成完毕后，关闭RA Smart Configurator。

• 当第一次打开先前步骤创建的工程时，请使用Command Palette中的CMake configure来配置CMake和Kit selection。

• 然后对kit进行配置，选择“ARM GCC - Ninja”。

• 注意：如果在此步骤，选择了错误的CMake kit会导致编译失败。您可以通过Command Palette中的“CMake：Select a kit”重新配置Kit。

• 点击菜单中的Terminal→Run Build Task。

• 选择Build Project。

• 可以通过点击Run→Start Debugging，或者F5键来启动调试。

• 当调试开始后，通用的调试控制按钮将显示，包括如返回，暂停，单步，单步跳过，单步跳出，重启，调试停止。在Debug Console处，将显示调试过程中的一些有用信息。

• 在调试期间，本地变量，设备寄存器，调用堆栈，监视变量，外设状态的详细信息将显示在Run and Debug选项卡中VS Code主侧边栏。