1.问题定位
ubuntu下开发GD32，通过vscode的插件cortex-debug+openocd+GD-Link调试GD32遇到问题。问题如下：
openocd -s "/opt/openocd-0.12.0-4/openocd/scripts/" -f "./openocd/gd32f470_cmsis_dap.cfg"
xPack Open On-Chip Debugger 0.12.0+dev-01685-gb9224c0c0-dirty (2024-08-02-19:50)
Licensed under GNU GPL v2
For bug reports, read
http://openocd.org/doc/doxygen/bugs.html
Info : DEPRECATED target event trace-config; use TPIU events {pre,post}-{enable,disable}
Info : Listening on port 6666 for tcl connections
Info : Listening on port 4444 for telnet connections
Error: unable to open CMSIS-DAP device 0x28e9:0x58f
Error: unable to find a matching CMSIS-DAP device
使用sudo命令是没找到openocd命令，将openocd加入sudo的环境变量中。
sudo visudo
找到 secure_path 配置行，在其后增加/opt/openocd-0.12.0-4/bin
Defaults secure_path="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/snap/bin:/opt/openocd-0.12.0-4/bin"
执行openocd命令连接GD_Link调试器，用sudo权限：
sudo openocd -s "/opt/openocd-0.12.0-4/openocd/scripts/" -f "./openocd/gd32f470_cmsis_dap.cfg"
xPack Open On-Chip Debugger 0.12.0+dev-01685-gb9224c0c0-dirty (2024-08-02-19:50)
Licensed under GNU GPL v2
For bug reports, read
http://openocd.org/doc/doxygen/bugs.html
Info : DEPRECATED target event trace-config; use TPIU events {pre,post}-{enable,disable}
Info : Listening on port 6666 for tcl connections
Info : Listening on port 4444 for telnet connections
Info : CMSIS-DAP: SWD supported
Info : CMSIS-DAP: JTAG supported
Info : CMSIS-DAP: Atomic commands supported
Info : CMSIS-DAP: Test domain timer supported
Info : CMSIS-DAP: FW Version = 2.0.0
Info : CMSIS-DAP: Interface Initialised (SWD)
Info : SWCLK/TCK = 1 SWDIO/TMS = 1 TDI = 1 TDO = 1 nTRST = 0 nRESET = 1
Info : CMSIS-DAP: Interface ready
Info : clock speed 2000 kHz
Info : SWD DPIDR 0x2ba01477
Info : [gd32f4xx.cpu] Cortex-M4 r0p1 processor detected
Info : [gd32f4xx.cpu] target has 6 breakpoints, 4 watchpoints
Info : [gd32f4xx.cpu] Examination succeed
Info : [gd32f4xx.cpu] starting gdb server on 3333
Info : Listening on port 3333 for gdb connections
不用sudo权限时
openocd -s "/opt/openocd-0.12.0-4/openocd/scripts/" -f "./openocd/gd32f470_cmsis_dap.cfg"
xPack Open On-Chip Debugger 0.12.0+dev-01685-gb9224c0c0-dirty (2024-08-02-19:50)
Licensed under GNU GPL v2
For bug reports, read
http://openocd.org/doc/doxygen/bugs.html
Info : DEPRECATED target event trace-config; use TPIU events {pre,post}-{enable,disable}
Info : Listening on port 6666 for tcl connections
Info : Listening on port 4444 for telnet connections
Error: unable to open CMSIS-DAP device 0x28e9:0x58f
Error: unable to find a matching CMSIS-DAP device
查看cmsis-dap设备的权限，cmsis-dap是hid设备，在/dev下表现为hidraw*
ls -l /dev/hidraw*
crw------- 1 root root 241, 0 11月 15 18:46 /dev/hidraw0
crw------- 1 root root 241, 1 11月 15 19:33 /dev/hidraw1
确实只有root权限。
2.修改设备权限
2.1创建 udev 规则
在 /etc/udev/rules.d/ 目录下创建一个新的 udev 规则文件，如 99-cmsis-dap.rules，并将以下内容添加到该文件中。
sudo vim /etc/udev/rules.d/99-cmsis-dap.rules
SUBSYSTEM=="hidraw", ATTRS{idVendor}=="28e9", ATTRS{idProduct}=="058f", MODE="0666"
xendless@ubuntu22:~/ohos/openharmony-4.1-release$ lsusb
Bus 002 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 001 Device 008: ID 28e9:058f GDMicroelectronics CMSIS-DAP
Bus 001 Device 002: ID 80ee:0021 VirtualBox USB Tablet
Bus 001 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub
28e9:058f中28e9为idVendor，258f为idProduct。
2.2重载 udev 规则： 创建完规则后，重新加载 udev 规则：
sudo udevadm control --reload-rules
重新插拔cmsis-dap调试器。
ls -l /dev/hidraw*
crw------- 1 root root 241, 0 11月 15 18:46 /dev/hidraw0
crw-rw-rw- 1 root root 241, 1 11月 15 19:50 /dev/hidraw1
权限发生变化。
再次执行openocd命令
openocd -c "gdb_port 50000" -c "tcl_port 50001" -c "telnet_port 50002" -s /opt/openocd-0.12.0-4/openocd/scripts -f /home/xendless/.vscode-server/extensions/marus25.cortex-debug-1.12.1/support/openocd-helpers.tcl -f /home/xendless/ohos/openharmony-4.1-release/openocd/gd32f470_cmsis_dap.cfg
xPack Open On-Chip Debugger 0.12.0+dev-01685-gb9224c0c0-dirty (2024-08-02-19:50)
Licensed under GNU GPL v2
For bug reports, read
http://openocd.org/doc/doxygen/bugs.html
DEPRECATED! use 'gdb port', not 'gdb_port'
DEPRECATED! use 'tcl port' not 'tcl_port'
CDLiveWatchSetup
Info : DEPRECATED target event trace-config; use TPIU events {pre,post}-{enable,disable}
Info : Listening on port 50001 for tcl connections
Info : Listening on port 50002 for telnet connections
Info : CMSIS-DAP: SWD supported
Info : CMSIS-DAP: JTAG supported
Info : CMSIS-DAP: Atomic commands supported
Info : CMSIS-DAP: Test domain timer supported
Info : CMSIS-DAP: FW Version = 2.0.0
Info : CMSIS-DAP: Interface Initialised (SWD)
Info : SWCLK/TCK = 1 SWDIO/TMS = 1 TDI = 1 TDO = 1 nTRST = 0 nRESET = 1
Info : CMSIS-DAP: Interface ready
Info : clock speed 2000 kHz
Info : SWD DPIDR 0x2ba01477
Info : [gd32f4xx.cpu] Cortex-M4 r0p1 processor detected
Info : [gd32f4xx.cpu] target has 6 breakpoints, 4 watchpoints
Info : [gd32f4xx.cpu] Examination succeed
Info : [gd32f4xx.cpu] starting gdb server on 50000
Info : Listening on port 50000 for gdb connections
问题解决。
3.总结
问题出在cmsis-dap设备只有root权限，没有用户权限。
4.测试
之后按F5进入调试状态。
cmsis-dap.png
相关的.cfg文件见git仓库
虽然写的有点随意，如果觉得有用，帮忙点个赞，感谢！
