加载中...

博客记录

0%

RP2040配置VSCODE开发环境 —— 一劳永逸版

发表于 更新于 分类于
本文字数： 3.8k 阅读时长 ≈ 8 分钟

上一篇文章：树莓派RP2040开发环境配置集合版(基于Raspberry Pico)。 前面的环境搭建基本上介绍了所有的开发环境配置，也对比了各个环境的优劣。如果是非商业开发的话，个人可能Segger Embedded Studio是最好的IDE，但是我不太习惯他的使用方式，这个会另外开一篇谈。 而通吃的方案则是使用VSCODE+ARMGCC+GCC，PlatformIO也是不错的，但是我个人不太习惯后者，而且经常出错。

因此最后仍然选择了VSCODE作为开发工具。由于上一篇写的太杂了所以单独写一篇只负责在VSCODE下配置环境的。

更新：整合包杀死了比赛：Raspberry Pi Pico Windows Installer - Raspberry Pi （未测试，但是肯定能用）

其实这篇文章起源是重装了系统，所以决定找一个尽量不依赖环境变量的方法，比如有些软件可以不安装运行，重装后不需要重新安装，可以直接使用，也懒得追加环境变量。另外尽可能减少手工操作。所谓一劳永逸不是装好不管，而是下次崩坏还能迅速有条理地重建。

其实官方的工程生成器已经尽可能减少手工操作了，但是那个是针对Linux的，本身安装也十分简单。所以这里要做一点修改，这里的教程也是按照Windows来做。 再一个就是官方的方法有些方法并不好，这里也做出一些改进。

安装软件和免安装软件配置

这一步是我尽量避免的，但是之前有些软件装在C盘，重装后直接没了，所以还是得走这一步，所以这一步我也没有验证如果直接使用之前下载好的可执行文件会不会踩什么坑。下面就是按照顺序安装就可以了。

gcc arm none eabi

点安装包直接安装就好了。 我的安装目录改到 D:\MyPrograms\InstalledProgram\10 2021.10 这里就安装的时候先把环境变量加进去，毕竟只需要打个钩。 然后这个就不用管了，同时他有个选项是注册这个编译器，我不知道如果不用安装包的话这一步的影响是什么。

CMake

这个不用自己加路径，所以直接用安装包安装，勾选添加到Path.

pyocd

由于是python安装的所以重新安装一次就行。

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
pip install –U pyocd

其实这个和openocd工具二选一即可，推荐用这个。

pyocd这个工具配置安装极为简单，一个软件支持rp2040的所有仿真器，而且连接稍微快一点点，（同一个工程openocd 15s ,pyocd 14s，真就一点点), 自带gdb配置，不知道为啥网上很少再rp2040的教程中提到。一次只能连接一个核心。

免安装软件配置

mingw-w64

之前下好的，可以不用再次安装，直接找到之前部署的路径，我这里是： D:\MyProgramData\Toolchain\mingw-w64\mingw64\bin 所以对应的mingw32-make 路径位于： D:\MyProgramData\Toolchain\mingw-w64\mingw64\bin\mingw32-make.exe

如果要安装的话，安装包来源：MinGW-w64 - for 32 and 64 bit Windows - Browse Files at SourceForge.net 点下面的MinGW-W64 GCC-8.1.0标题下面的包，因为如果用在线安装包压根连不上。
选择最新版本（8.1.0）的 x86_64-win32-seh

openocd （可选）

直接添加到环境里面。虽然可以配置到cortex-debug的路径里面，但是这个工具比较有用（不如pyocd），可能有时候会在命令行里面用一用。

工程部署

利用树莓派官方提供的生成工程脚本（pico-project-generator）还需要提供 PICO_SDK_PATH 这个环境变量用于生成cmakelists.txt, 这里只需要在环境变量中添加这个名称和填写SDK的路径即可； 同样，用于编译生成工具的make工具链也需要增加到环境变量Path，前面说过一次了。

这里为了方便操作，直接做了一个BAT批处理来处理环境变量并打开pico-project-generator。

实际上完全可以在启动器的python脚本内部完成这个事情，但是我不太想改那个庞大的代码加上参数什么的，于是就把这些简单的东西分离出来。

由于这个生成器本身就要加上–gui参数来启动图形界面，所以一起集成到了BAT文件里面：

@REM "设置文字编码UTF8(不然这里中文是UFT8,在命令行中会默认不是UTF8会出现斤拷棍,但是还是可能有问题建议不要用)"
@echo off
chcp 65001>nul

@REM "下面是要自己指定的部分(=左右不要空格)，后面都是set来设定临时环境变量，如果希望直接设置好，改成setx就行，写了检测，不会重复"
set picosdkpath_temp=D:\MyProgramData\MCU_SDK\pico-sdk
@REM mingw32-make.exe
set "make_bin_path=D:\MyProgramData\Toolchain\mingw-w64\mingw64\bin"
set make_exe_name=mingw32-make.exe
@REM 初始化一下环境变量,获取系统的环境变量
set "env_path=%PATH%"
  
@REM "起手就问工程名称，免得还要写一次,不要写空格"
set /p projectname=your projectname:
echo your projectname is %projectname% 

@REM 检测PICO_SDK，如果不存在就添加
@echo off
if not defined PICO_SDK_PATH (
    echo Environment variable PICO_SDK_PATH is not set
    echo now, set it to %picosdkpath_temp%
    set PICO_SDK_PATH=%picosdkpath_temp%
) else (
    echo Environment variable PICO_SDK_PATH is set to %PICO_SDK_PATH%
)
  
@REM "检测PICO_SDK，如果不存在就添加（用if not exist mingw32-make.exe会一直显示不存在，只能查找字符串。或者findstr /C:%make_bin_path%"

echo "%path%" | find /i "%make_bin_path%" >nul  
if %errorlevel% equ 0 (
    @REM "存在就显示一下好了"
    echo mingw toolchain has been set to %make_bin_path%
) else (
    @REM "不存在就添加一下"
    echo mingw toolchain is not set

    @REM "追加变量"
    @set "path=%env_path%;%make_bin_path%"
    echo mingw toolchain is set to %make_bin_path%
)

@REM "调用tsv文件，虽然默认也是这个，设置名称，默认打开vscode"
python pico_project.py  %projectname%  -t pico_configs.tsv -p vscode --gui

@REM "完事打开code"
code ../%projectname%

这里没有配置用户环境变量，而是使用临时环境变量，不过我还是自己手动在Windows中配置了环境变量，这个批处理就当作记录了。

如果要一次配置好，就把里面的 ``set`` 命令改成``setx``，就可以把环境变量添加到用户变量了(系统变量需要提权，没必要）。

其中，这个批处理调用pico_project.py 文件的时候，添加了几个参数，一个是在启动BAT文件的时候要求输入工程名称，因为我觉得这种方式最方便，没必要像原来那样打开生成器之后，点击名称位置，删掉原来的默认名称后修改自己的。那样很麻烦。

另一个是添加默认勾选配置vscode，使用配置文件从tsv文件加载预设值(这个文件可以用excel打开)，虽然默认也是这个，但是记下来方便修改。

我尝试给他添加默认特性，例如PIO,但是似乎在图形界面里面不生效，没注意看原因。

这个--feature 我实在是没看明白,试了一下它没啥用，写进去什么参数都不报错。。

然后就可以启动生成器了，关闭生成器后会自动在刚刚生成的项目文件夹下打开vscode。

但是这还不够，下面是工程生成器（pico-project-generator）的修改。

生成器修改点

先说槽点，也就是为什么要修改这个修改器： 1、LOGO图片太大，小屏幕塞不下好吧（虽然可以通过DPI兼容来解决） 2、工程生成路径和python文件在同一层，就离谱，一堆零散文件里面塞个工程。 3、daplink只配置了自己的专用Link，这TM能用？ 4、vscode配置文件只配置了linux下自己的Link的配置，这TM能用？不然在Windows下每次都要复制vscode的配置文件。 5、个人爱好，包含主函数的文件就叫main.c而不是工程名

下面一个一个修改。

去掉LOGO和修改显示设置

不记得在哪里了，反正就是找那个图案的路径。然后是勾选python.exe，兼容性->勾选高DPI->改成应用程序，不然打开很模糊。

显示设置每次换电脑或者更换python版本都要做一次，这个没办法，Windows的问题。

1、工程路径修改到当前生成器的上一层

        self.locationName.set(os.path.abspath(os.path.join(os.getcwd(), "..")))

查找这个函数名找到后替换set内容即可。

默认是第一个可以用通用的DAPLink，所以直接加到第一个，对应配置文件是cmsis-dap.cfg

debugger_list = ["DapLink","raspSWD", "PicoProbe"]

debugger_config_list = ["cmsis-dap.cfg","raspberrypi-swd.cfg", "picoprobe.cfg"]

这里这个选项其实是给Openocd的参数用的，如果是只用pyocd来调试，这个选项没啥用，因为pyocd配置没这么麻烦。。

3、vscode生成.vscode文件部分

def generateProjectFiles(projectPath, projectName, sdkPath, projects, debugger):

它这里是直接一行一行写在python文件里面每一行都带个单引号，修改起来真是脑溢血，但是我当时改的时候脑抽了，所以最后都是按照他那个格式写的。下面是加进去的内容。

3.1 生成启动文件部分

  • 启动文件为launch.json 首先，修改第一个配置为Pyocd的配置，因为pyocd兼容性最好，配置也最简单。 然后，添加多个Openocd的选项，分别为： 指定pico-debug固件作为debugger的仿真Core0; 另外一个据说不会过时的指定core0的命令方法; 以及理论上是同时连接双核的调试方法，但是实际上cortex-debug的双核调试还在路上。 其中Pyocd的配置如下：
    {
      "name": "rp2040_core0 Debug with PyOcd",
      "cwd": "${workspaceFolder}",
      "executable": "${command:cmake.launchTargetPath}",
      "request": "launch",
      "type": "cortex-debug",
      "servertype": "pyocd",
       //可以修改为rp2040_core1  
      "targetId": "rp2040_core0",
      "showDevDebugOutput": "none",
      "svdFile": "${env:PICO_SDK_PATH}/src/rp2040/hardware_regs/rp2040.svd",
      "runToEntryPoint": "main",
      // Give restart the same functionality as runToEntryPoint - main
      "postRestartCommands": [
          "break main",
          "continue"
      ]
    },

具体Pyocd的配置和cortex-debug的联合使用见我另外写的PyOCD配置。（我还没写）

TODO: ARM也出了一个调试插件，但是要装好几个插件，而且对应rp2040还有点问题，文档太少了，我就没折腾出来，不知道这个会不会更好，以后没问题了再加上去。

  • 同时，写入文件添加指定编码utf-8,以便使用vscode默认utf-8编辑之后输出支持中文。

    吐槽,他这个生成器代码写的好挫.

  • 添加自动判断对应系统应该用什么gdb server的名字

    if isWindows:
        gdb_path = 'arm-none-eabi-gdb'
    else:
        gdb_path = 'gdb-multiarch'

  • 修改设置,默认显示build按钮，方便使用

  • 推荐扩展文件添加一个 twxs.cmake

最后，c_cpp_properites.json 中它写的也不对，只有linux的配置，而且如果是Windows写入的路径也没有转换。但是这个配置打开vscode的时候点配置会被替换掉，也不影响使用，所以无所谓，就先不改了。

  • 预计其他增加（以后有精力再说） task.json 来实现只烧录 参考arm的Arm Embedded Debugger的方式，当然也可以用pyocd来做。 使用PICO TOOL，就是前面说过的PICO USB那个东西，可以实现烧录和简单的启动停止。 推荐扩展增加Arm Embedded Debugger以及Arm Device Manager，如果可用的话。

完成这些之后，直接点击前面的启动脚本，就可以直接生成可用的工程并打开vscode了，总算有点IDE的样子了。

vscode配置点（踩坑点）

如果是从头配置起来的基本上不会遇到下面这些问题，这里做个记录。

cmake tools

插件如果是之前备份的到新电脑的，需要重新安装，否则插件加载不出来。

Cmake编译的时候会报错：

CMake Error: CMake was unable to find a build program corresponding to "MinGW Makefiles".  CMAKE_MAKE_PROGRAM is not set.  You probably need to select a different build tool.

似乎可以通过添加 CMAKE_MAKE_PROGRAM 来解决，但是由于没有环境变量，这还需要指定编译器位置，虽然可以通过cmake tools的脚本解决，但是那还需要额外添加一个文件。设置里面的设置cmake 环境变量似乎并不能给命令用。

所以最简单的办法就是添加mingw32的目录到环境变量。

如果追求极致不要修改环境变量，那么就在启动vscode的时候添加临时环境变量，这个文件放在工程文件夹下面。

...  前面就和启动生成器里面添加环境变量的脚本一样
code ../

关于Makefile：找不到CMAKE_MAKE_PROGRAM | 码农家园 (codenong.com) 上面这个老哥说了，很多方法都不如加个环境变量。 但是这个mingw32-make确实很常用，就加到系统里面去吧。

cortex-debugger

之前备份的会启动不了。。。重新安装也不行。只好全部移除了vs配置文件。

Arm Embedded Debugger

vscode上除了cortex-debugger Arm Embedded Debugger 似乎也可以： ARM-software/vscode-embedded-debug: Extension support for VS Code Embedded Debug Extension (github.com) 但是官方文档还不全，给的方法也有问题。。。。我试了一下还是连不上, 报错RDDI-ERROR 13 但是工具本身应该没问题。

${command:device-manager.getSerialNumber}

上面这句命令要安装一个arm device manager扩展才行，但是还是会报错没有连接的设备，指定串号之后可以连接上（串号可以用keil中的配置看到或者使用“pyocd list“命令找到设备的uid），用的是wch-link, 自调试固件不行，不知道是不是被复位了。但是即使连接上了会进入断点进不了主程序，不知道缺什么。 所以暂时不搞了，估计效果不会超过pyocd。

由于armgcc工具链移动路径导致的原来cmakelist失效的问题需要迁移原工程

直接编译或者选择对应的kit都会会报错找不到正确的工具链吧啦吧啦。 所以我的建议是不要移动工具链的位置，保持原来的路径。。。。。这样可以套用上次的设置。 不过迁移很简单： 在cmake插件的选择kit的按钮上，点选unspecified ，然后编译一下，再选对应的arm gcc就可以了。当然，不选回去也行，能用就算成功。

总结

通过这些配置，就可以做到同步到另一台电脑上也可以直接使用，只需要修改脚本中的环境变量的路径，如果工具本身被同步了，不用修改也可以直接使用。 同时ARM GCC是被自动查找的，所以路径不影响，只要之前安装过就行。

附录

修改后的pico-project-generator: alwaysmy/pico-project-generator_fix: Tool to automatically generate a Pico C SDK Project with VSCODE also supported in Windows (github.com)