Eclipse
Luban-Lite 支持使用 Eclipse IDE 来进行调试,请先下载 Eclipse IDE for Embedded C/C++ Developers。
生成 Eclipse 工程
注解
首先确保工程已经在命令行环境下正确配置并且能成功编译以后,再使用下述命令一键生成工程对应的 Eclipse 工程文件。在工程配置发生改变以后,需要重新在命令行下编译成功后再重新生成 Eclipse 工程文件。
使用命令生成当前工程对应的 Eclipse 工程文件:
$ cd luban-lite
$ scons --target=eclipse // 生成当前工程对应的 Eclipse 工程文件
2
生成的 Eclipse 工程文件存储在 luban-lite/output/xxxx/project_eclipse 目录:
$ ls -a output/d21x_demo100-nand_rt-thread_helloworld/project_eclipse
./ ../ .cproject .project .settings/
2
还增加了一条命令来生成 Eclipse SDK 软件包,该命令会把用户需要的所有源文件和库文件都独立的拷贝一份:
$ scons --target=eclipse_sdk // 生成当前工程对应的 Eclipse SDK 工程
生成的 Eclipse 工程文件存储在 luban-lite/output/xxxx/project_eclipse_sdk 目录。因为所有需要的文件都已经拷贝,所以 project_eclipse_sdk 目录已经是一份独立的 SDK 了,可以拷贝到任何路径下进行调试。
eclipse
和 eclipse_sdk
两种类型工程的区别在于:eclipse
工程使用的源码文件是和 Luban-Lite SDK 共享的,所以它可以使用 menuconfig 配置菜单来更改工程配置。eclipse_sdk
工程会把所有的源码文件拷贝一份,它脱离了 Luban-Lite SDK 框架,所以不能使用 menuconfig 配置菜单来更改工程配置了。
注解
建议在开发阶段使用 eclipse 类型的工程,在发布阶段使用 eclipse_sdk 类型的工程。
导入 Eclipse 工程
打开下载的 Eclipse IDE for Embedded C/C++ Developers,通过菜单 File -> Import -> Existing Projects into Workspace 来导入上一步创建的 Eclipse 工程:
编译
在 Project Explorer 中选择成功导入的工程,在右键菜单中选择 Build Project 即可对整个工程进行编译。
编译生成的目标文件在 luban-lite/output/xxxx/project_eclipse/Debug 目录:
$ ll output/d21x_demo100-nand_rt-thread_helloworld/project_eclipse/Debug/
d21x.bin
d21x.elf // 调试需要的 elf 文件
d21x.map
d21x_demo100_nand_page_2k_block_128k_v1.0.0.img // 烧录需要的 img 文件
2
3
4
5
为了避免一些环境的兼容性问题,在第一次编译之前选择 Clean Project 清理一下工程。
更改 Eclipse 工程配置
对于使用 scons --target=eclipse
命令生成的 Eclipse 工程,可以通过 menuconfig
菜单来更新工程的配置。
$ cd luban-lite
$ scons --menuconfig // 更改当前工程配置
2
在 menuconfig
菜单退出时,系统会自动更新 luban-lite/output/xxxx/project_eclipse
目录下的 Eclipse 配置文件。用户在 Eclipse 工程的右键菜单中选择 Refresh
刷新即可同步配置:
调试
串口调试
Eclipse 连接串口具体步骤如下:
GDB调试
Eclipse 通过 JTAG 调试器在线调试还需要以下关键组件:
- AiBurn:烧录软件,把上述固件烧录到单板。
- CKLink:JTAG 调试器。
- T-HeadDebugServer:调试器在 PC 端的代理,以 GDB-Server 的形式提供调试服务。
Eclipse 在线调试的具体步骤如下:
Step 1:安装 AiBurn 软件,使用 AiBurn 将编译生成的固件烧录到单板;
Step 2:切换至调试串口工具,按住 Ctrl + C ,重启板卡,系统停止在 SPL 阶段;
Step 3:启动 T-HEADDebugServer,在 Setting -> Socket Setting 中可以配置 GDB-Server 端口号:
- Step 3: Eclipse 中创建对应的 Debug Configuration。通过菜单 Run -> Debug Configurations 给编译成功的工程新建一个对应的调试配置:
经过上述配置以后,就可以方便的在 Eclipse 下进行在线调试了。