最近读一份只能运行在嵌入式平台上的三无代码,由于数据结构比较复杂,没办法只能gdb一步步跟着读,gdb一边list、一边print还得一边next,效率很低下。在ubuntu上用过vscode之后,就觉得用vscode调嵌入式c程序应该不错,花了一些时间尝试了一下,果真不是很复杂。
原理上主要使用了gdb的远程调试,远程gdb调试时,使用了gdb的mi(machine interface)接口,把命令行调试界面化,以前DDD(Data Display Debugger)就是干这个事的,现在貌似停止维护了(宇宙最强调试器,可惜了),vscode灵活性比较大,比较通用,界面比较友好,如监控某一变量,添加到watch窗口,不用边next,边print,也方便代码修改,配置好了,就是一款嵌入式IDE。第一次配置稍微麻烦一点,但不复杂,vscode的操作习惯和vs比较像(本来就是微软的东西,这里要赞一下),上手难度低,也算是嵌入式调试较好的解决方案吧。
本文调试的是嵌入式C程序,但vscode可以说是语言无关的,大家也可以尝试调试其他语言程序。先放一张远程调试的截图:
单看截图看不出是远程调试,图中调的是一份开源代码(随便找的一份代码,不是开始说的三无代码),结构体显示这块比gdb的cli模式方便太多。
下面介绍vscode远程调试环境搭建方式,vscode调试嵌入式程序安装、配置要点如下。
安装vscode ubuntu版
相关资料比较多,可以自己查找安装。理论上用vscode的windows版本也可以,但前提是你得有windows版的交叉工具链。
交叉编译gdb与gdb-server程序
这是远程调试必要的步骤,编译时注意选项(这里以arm为例)
./configure是支持–build、–host、–target这几个选项,选项含义:
- –build=编译平台,如x86,build一般不需要指定
- –host=运行平台,软件本身运行的平台,如arm
- –target=目标平台,即需处理的指令集,如arm
通常情况下交叉编译的host与target相同,即完全在嵌入式平台上跑的程序,但远程调试是gdb的host与target不一致,配置如下:
- gdbserver: ./configure –host=arm –target=arm
- gdb: ./configure –targe=arm
gdb是运行在x86的ubuntu中,所以host可以省略,而gdbserver是运行在嵌入式板子上的,则不能省略。
注意: 不指定build、host、target时,默认用的就是当前编译平台,如x86,即./configure不带参数编译出来的就是当前平台的程序。
gdb和gdb_server编译不复杂,源码可以在官网上下载https://ftp.gnu.org/gnu/gdb/ ,也可以使用平台厂商会提供相关源码(与工具链匹配的版本)。
本人使用gdb8.1版本碰到如下问题:
1. 由于两个东西configure配置选项不一致,gdbserver和gdb先后编译了两次,后编译的可能会出现如下错误:
configure: loading cache ./config.cache
configure: error: ‘host_alias’ has changed since the previous run:
configure: former value: ‘arm-linux’
configure: current value: ‘i686-pc-linux-gnu’
是因为上次编译的cache文件没删除,make clean不会删除cache,make distclean也只删除了部分cache文件,还是删掉这份源码,重新解压编译吧,或者按报错慢慢删cache文件。
2.如果不想安装(make install,可能会影响原gdb使用)该gdb,且gdb版本较高(如8.1,应该是7.0以上就可能有此问题),可能会报如下错误:
./gdb-arm8.1: warning:
Could not load the Python gdb module from `/usr/local/share/gdb/python’.
Limited Python support is available from the _gdb module.
Suggest passing –data-directory=/path/to/gdb/data-directory.
Python Exception type ‘exceptions.NameError\’> Installation error: gdb.execute_unwinders function is missing:
按网上的操作,把gdb python相关东西(源码里面)copy进去可以解决
# mkdir -p /usr/local/share/gdb/python/gdb
# cp -rf ~/gdb-8.1/gdb/python/lib/gdb/* /usr/local/share/gdb/python/gdb/
配置vscode
这一步最关键,建议先了解vscode的用法,最重要的就是配置configuration,launch.json配置如下:
{
// Use IntelliSense to learn about possible attributes.
// Hover to view descriptions of existing attributes.
// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
"version": "0.2.0",
"configurations": [
{
"name": "(gdb) ARM remote debug",
"type": "cppdbg",
"request": "launch",
"program": "/opt/nfs/test",
"args": [],
"stopAtEntry": false,
"cwd": "${workspaceFolder}/build/test",
"environment": [],
"externalConsole": true,
"MIMode": "gdb",
"miDebuggerPath": "/home/sw/gdb-arm8.1",
"miDebuggerServerAddress": "192.168.30.14:2018",
"setupCommands": [
{
"description": "Enable pretty-printing for gdb",
"text": "-enable-pretty-printing",
"ignoreFailures": true
}
],
}
]
}
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 24
- 25
- 26
- 27
- 28
- 29
远程调试launch.json配置要点:
- “name”:这个还是有必要改下,如我们项目工程包括几个主进程,多个测试程序,可以为每个程序添加一个configuration,名称需区分开,用的时候切换一下configuration即可。
- “program”:这个一般指向挂载目录的嵌入式可执行程序,也可以不指向板子上的程序,但该程序必须与板子上运行的程序一致,否则会出问题。
- “cwd”: 当前工作目录,应指向需调试程序的编译目录,如例子中的”${workspaceFolder}/build/test”,设置不正确,可能会找不到源码。
- “miDebuggerPath”:gdb路径,需执行前面编译的gdb
- “miDebuggerServerAddress”:远程调试服务器地址,也就是gdbsever运行的ip地址,注意端口和服务器监听端口保持一致。
遇到问题:
本人的ubuntu下的vscode添加 configurations不会自动刷新,添了过后,需要重新打开一下工程才能刷新过来。
远程调试嵌入式程序
1.编译被调试程序
需注意,交叉编译板子上运行的程序时,需带-g选项,调试信息中有行号等信息,如项目部分没有源码或编译时未加-g选项,该部分就不能单步跟踪和设置断点(如c库),但不影响其他部分表示。
这里用vscode只是调试代码,源码的编译没必要用vscode,当然也可以配置,感觉有点费力不讨好,vscode中集成了terminal,可以直接在该terminal使用make来编译。
2.启动被调试程序
一般在挂载目录中,telnet或ssh到嵌入式上板子上通过上面编好的gdbserver启动被调试程序,需指定端口
/var/sw # ./gdbsever-arm 127.0.0.1:2018 ./test
这一步也可以通过vscode的terminal远程登录到板子上操作,避免频繁切换。
3.vscode连接被调试程序
配置好launch.json后,直接F5启动即可,可以通过F9设断点,F10单步等来调试程序。