在基于Linux的AM335x软件开发流程中,第一步就是U-Boot/SPL(SecondProgram Loader)的移植。在移植中遇到问题比较常见,而U-Boot/SPL的调试手段比较简陋,不便于迅速找到问题。利用仿真器可以单步调试的特点,就可以迅速定位到出问题的代码所在位置,加速移植的调试过程。本文主要介绍如何用CCS+emulator调试基于AM335x的U-Boot/SPL。
1. AM335x Linux启动过程以及U-Boot/SPL调试代码的准备
1.1 [url=]AM335x Linux[/url]的启动过程
AM335x Linux的启动主要包括ROM,SPL, U-Boot 和kernel四个启动步骤:
A. ROM code
ROM code是固化在芯片内部的代码,当上电时序正确,而且晶振等芯片启动所需的条件都具备时,AM335x会从ROM code开始运行。
ROM code首先会读取sys_boot引脚上的配置,以确定存放SPL的存储器,或者可以获取SPL的外设。
具体可以参考AM335x technical reference manual中的第26章 Initialization。
ROM code会从相应的地方读取/获取SPL,并运行SPL。
B. SPL
SPL 和U-Boot 是bootloader的两个阶段。这里分为两个阶段的原因是, ROM code中不会配置DDR,时钟等最小系统,所以ROM code只能把bootloader加载到片上SRAM中,而片上SRAM对成本影响很大,所以通常很小,例如在AM335x上只有64K,不足够放下整个U-Boot,所以将U-Boot分成两部分,SPL和U-Boot。
SPL主要的职责就是初始化DDR,时钟等最小系统,以读取U-Boot,并加载到DDR中。具体来看,SPL 由ROM code加载到片上SRAM的起始位置,也就是0x402F0400。SPL会进一步对芯片进行配置,主要包括以下几个方面以完成其主要职责:
a. 配置ARM core。 主要包括对中断向量表,cache,MMU等的配置。
b. 配置时钟系统,主要是PLL等。这个是配置各个功能模块的基础。
c. 配置UART,timer等。主要用于输出必要的调试信息,或者提供些时钟工具。
d. 配置I2C和PMIC。这个主要是为了配置电源管理芯片。
e. 配置DDR。
f. 配置 U-Boot所在的存储器或者外设。
完成配置后,SPL会读取U-Boot,并运行U-Boot。
C. U-Boot
U-Boot 主要的工作就是正确加载Kernel。和SPL类似,U-Boot也是要加载下一个阶段的image,但是U-Boot提供了更多外设的支持和更多的调试工具。所以,U-Boot也要进行各个模块的配置,上述SPL配置的部分, 除了DDR外,U-Boot也会根据需求重新配置(这里重置主要是U-Boot是一个开源工程,其要兼容某些特殊的芯片,从而需要做重载)。此外,U- Boot也会对网口,SD卡等根据需求进行配置。
U-Boot 和SPL的工作流程比有一点是有较大差异的,就是会对自身进行一次重载。这个在后面介绍U-Boot调试的时候,会有具体介绍。
完成配置后,U-Boot 会从相应的存储器或者外设读取Kernel,并传递参数给kernel,运行kernel。
D. Kernel
Kernel运行起来就代表Linux运行起来了,表明了启动过程的结束。
1.2 U-Boot/SPL 调试代码的准备
1.2.1下载U-Boot/SPL 代码
U-Boot/SPL的代码在一个包里面,通过编译宏来分别编译。目前TI U-Boot/SPL 代码发布主要有两个渠道,具体如下
A. 通过GIT开源的方式发布:
git://arago-project.org/git/projects/U-Boot-am33x.git
可以获取最新的代码,包含了最新的bug的修复。
B. 通过TI的官网的EZSDK发布:
http://software-dl.ti.com/dsps/dsps_public_sw/am_bu/sdk/AM335xSDK/latest/index_FDS.html
EZSDK是正式发布的软件包,经过全面测试,性能稳定,U-Boot/SPL在board-support 目录中。可以选择EZSDK作为开发的基础代码。当有问题时, 可到GIT上查找最新的代码是否有bug fix。
1.2.2 U-Boot/SPL的编译
为了便于用CCS进行调试, 在编译上需要注意两点,其一,是要加入调试信息,就是为了加入symbol等信息;其二,去掉编译器的性能优化编译选项,这个主要是因为,优化后的代码执行顺序相对C代码会有调整。
针对这两点,在Uboot/SPL中,需要在config.mk中进行修改:
A. 在CFLAG 和 AFLAG中加入调试编译选项,从而加入调试信息:
278ALL_AFLAGS = $(AFLAGS) $(AFLAGS_$(BCURDIR)/$(@F)) $(AFLAGS_$(BCURDIR)) –g
279ALL_CFLAGS = $(CFLAGS) $(CFLAGS_$(BCURDIR)/$(@F)) $(CFLAGS_$(BCURDIR)) –g
B. 去掉 CFLAG中的编译选项, -O2(U-Boot中默认是-O2)
61 HOSTCFLAGS = -Wall -Wstrict-prototypes -O2-fomit-frame-pointer
编译过程可以参考http://processors.wiki.ti.com/index.php/AM335x_U-Boot_User%27s_Guide
1.2.3 可执行文件
经过编译后,就会生成可执行文件,也就是我们通常所说的image,这里会生成的image主要用AM335xLinux启动的两个阶段,MLO(SPL)和U-Boot。
这里,SPL生成的image在am335/U-Boot-am33x/am335x/spl中,
A. am335/U-Boot-am33x/MLO 负责AM335x启动的第一阶段。
B. U-Boot-spl 作为带有调试信息的image,可以在CCS中用作导入调试信息。
C. U-Boot-spl.bin 包含有调试信息,是调试时需要的image。
D. U-Boot-spl.map 这个文件里面存储了spl的memory map信息,可以找到各函数入口的地址。
U-Boot生成的image在U-Boot-am33x/am335x中,具体如下:
A. U-Boot.img负责AM335x启动的第二阶段
B. U-Boot 包含有调试信息,属于ELF格式,是调试时需要的image。
C. U-Boot.map这个文件里面存储了U-Boot的memory map信息,可以找到各函数入口的地址
调试环境主要包含3个部分,仿真器,集成调试环境和开发板。下面将逐一介绍:
2.1 仿真器(emulator)
目前支持AM335x的仿真器的型号比较多,有XDS560v2,XDS510,XDS100v2, XDS100v3,等,比较常见的是XDS560v2和XDS100v2。
XDS560v2,性能好,速度快,具有trace功能,但是价格偏贵。 XDS100v2价格比较便宜。 其具备和XDS560v2一样的基本调试功能,只是XDS100v2的速度相对略慢。
XDS560v2和XDS100v2在PC机上的驱动(Windows,Linux)都已经包含在CCS中了,所以安装了最新版的CCS,就会安装相应的驱动。
2.2 集成开发环境
TI有自己的集成开发环境(IDE)CCS.目前最新的版本是基于Eclipse IDE架构的,界面新颖方便。
下载地址 http://processors.wiki.ti.com/index.php/Download_CCS。
CCS有Windows版本和Linux 版本,后面会在介绍调试过程中具体介绍两者的差异。
2.3 开发板
目前,针对不同的应用,TI发布了基于AM335x的多个开发板。其中BeagleBone,Starter Kit和ICE上配置了基于FT2232的xds100v2。而GPEVM和IDK上引出了CTI JTAG接口。
这里选择GP EVM和 Spectrum DigitalXDS560v2 作为调试平台。
3. CCS 调试Uboot/SPL的具体步骤
下面正式开始CCS的调试。调试的过程主要分为导入U-Boot/SPL 工程, CCS 连接AM335x,代码调试等几个部分。
3.1 导入CCS代码
在CCS中, Menu File -》 Import … 选择 Makefile 方式导入,如下图所示:
在ezsdk中,U-Boot/SPL所对应的Makefile的具体路径如下:
/home/sitara/ti-sdk-am335x-evm-05.05.00.00/board-support/U-Boot-2011.09-psp04.06.00.08
如前面所提到,U-Boot 和SPL的源码在同一个文件夹的,通过不同的Makefile管理不同的编译宏来区分的。这里导入的是U-Boot的代码对应的Makefile,会相应的导入U-Boot对应的预编译选项,因为其包含了所有的代码。而对于SPL,也会相应的一起带入,只是在CCS中看到的代码的宏定义有些不对,但这个不影响调试。
3.2 CCS 连接 AM335x.
主要分成仿真器的连接,target连接和Debug配置等几部分:
3.2.1 [url=]仿真器的连接[/url]
对于 AM335x GP EVM选用Spectrum DigitalXDS560v2 的20 pin的接口板,连在baseboard的J2口上即可,注意pin脚的顺序,不要把JTAG 接口插反了。
对于beaglebone,StarterKit,ICE等,这些板子已经把XDS100v2 仿真器集成到板子上了,所以直接用usb线连到PC机上即可。
A. CCS的配置
CCS的配置主要包括Target的配置和连接两部分。
a. Target 配置
Target的配置包含两个部分,一个是仿真器(XDS560v2),另一个就是SOC(AM335x)。具体操作如下:
i. View -》 Target Configurations
ii. 点右键选择New Target Configuration.
iii. 新建一个叫做AM335_EVM的target.
iv. Connection中选择 Spectrum Digital XDS560V2 STM USB Emulator.
v. 对于XDS100v2 , 可以选择 Texas InstrumentsXDS100v2 USB Emulator.
vi. 在Board or Device 中选择AM335x.
vii. 点击Save 保存。
viii. 点击Test Connection 看是否能够正常连接。
配置target成功后,会看到如下界面
3.2.2 Target 连接
A. 右键选中Target Configurations中已配置好的target,AM335x_EVM.ccxml, 在右键菜单中选择Launch SelectedConfiguration,连接成功后,可以得到下图
此时,PC 和仿真器以及仿真器和SOC的JTAG连接成功,但是ARM core还没有连上。从图中可以看到,有多个core的配置选项,由于U-Boot/SPL,Linux 运行在ARM coretex-A8 core上,这里只关注ARM core。
B. 在Debug窗口中,右键点击CortxA8 core, 选择Connect Target. 连接成功后,如下图所示:
此时,已经成功连上AM335x的Cortex-A8 core了。
3.2.3 Debug配置
这里的debug配置,是对emulator连上core后行为的设置。 可以通过鼠标右键点击properties,得到以下界面:
在该页配置中,在调试过程需要调整的就是Auto RunOptions,可以根据需要设置,当加载了image后,core自动运行到指定的symbol,并且被JTAG接口所停住
调试U-Boot/SPL的方式有两种,主要涉及如何加载image:一种是把image通过JTAG下载到片上RAM或者DDR中,然后导入 symbol,重置 PC指针到image的入口处,进行调试;另一种,把image烧到SD卡或者其他启动存储器上,启动板子,通过JTAG停住core的PC指针,导入 symbol,重置 PC指针到image的入口处,进行调试。
下面会在具体步骤中说明这两种方式如何操作:
A. 下载SPL image到AM335x中。
如果AM335x是从SD卡方式启动,此时 SPL image已经被ROM code成功读到片上 RAM中,就不需要加载 SPLimage了。
如果选择SPL image通过CCS下载,鼠标左键选择CortxA8core , 然后在CCS菜单中, Tools -》 Load Memory, 选择编译好的SPL image U-Boot-spl.bin,如下图所示:
选择加载的地址。由于加载的U-Boot-spl.bin是RAW data,所以需要指定loadaddress,这个地址就是SPL的入口地址
对于AM335x,SPL的入口地址是0x402F0400,对应的宏定义为CONFIG_SPL_TEXT_BASE, 该宏定义在include/configs/am335x_evm.h中。通过编译出的map文件U-Boot-spl.map也可以查到,是 __startsymbol对应的地址。
设定加载image内型。 由于所有的代码都是运行在ARM(32bit)模式下。所以Type-size也要设成32bit。设置界面如下:
最后点击Finish,SPL就会被load到片上RAM中了。如果在console窗口中有错误信息,需要把SPL image重新加载 一遍。
B. 加载 symbol。
在上一步里,只是加载了RAW image,还没有加载调试所需要的带有调试信息的symbol。
可以通过Run -》 Load -》 LoadSymbols 加载symbol信息,界面如下:
这里选择的是带有symbol信息的U-Boot-spl.
C. 设置Cortex-A8 core到ARM状态。
ARM core 启动后,默认在Thumb(16bit)模式下,如前面所说,需要将其切换到ARM(32bit)下。具体做法是,View-》Registers, 展开CPSR寄存器,把T位设置为0。界面如下:
D. SPL的单步调试。
a. 从SPL编译的memory map可知,SPL从0x402f0400开始执行,所以首先就要把寄存器PC的值设为0x402f0400。可以通过 View-》Registers中设置PC指针的值即可, 界面如下,将红色框里面的改为0x402f0400即可。
b. 点击Debug窗口(view-》debug)上tool bar中的汇编单步按钮,如下图所示,就开始调试了。
这时,在反汇编窗口(view-》disassembly)中,如下图所示,看到的是汇编代码,而且在编辑窗口这边看不到源码。这是由于开始执行的代码在/arch/arm/cpu/armv7/start.s 中,反汇编和汇编一样,所以没有显示源码。
同时,可以看到PC指针运行到0x402f0458处。这里只是单步执行了一条指令,为什么跳过了这么大块地址?这里的单步运行,指令地址空间跳转了n指令,而不是一条指令,这是因为0x402f0400处存放的是异常中断向量表,通过默认启动的入口跳到reset symbol对应的地址了,也就是在0x402f0400处跳转到0x402f0458了,具体代码(arch/arm/cpu/armv7 /start.S)如下:
_start: b reset
reset:
bl save_boot_params
接下来,可以在C代码中设置断点,进行调试了。有两点值得注意:
i. 如果编译的时候,交叉编译器的性能优化选项是开着的,那么优化后编译生成的代码,其执行循序和C源码有差别,这时设置断点时,其实际的位置不会很准。所以,这里可以根据需要,决定是否关闭-O2选项。
ii. 在CCS中,把core停下来时,CCS会根据image中调试信息所包含的源码路径,找到对应的源码和symbol。由于U-Boot/SPL是在 Linux中编译,所以其路径都是Linux下的路径,所以Linux版本的CCS可以直接找到对应的源码,而对于Windows版本的CCS不能直接找到,需要通过手动找到源码,但是找到一个文件的源码后,CCS会根据相对路径找到其他文件。除了这点外,Linux和Windows的CCS配置使用是一样的。
3.4 U-Boot的调试
总体来说, U-Boot的调试过程和SPL调试过程是类似的,这里主要说明不同的几点:
A. 从AM335x的启动过程可知,U-Boot是运行在DDR中的,而DDR是由SPL来初始化的,所以,加载U-Boot前,先加载并运行SPL。
B. 加载U-Boot 的image是 U-Boot。 这里U-Boot 是ELF格式的, 其包含了加载地址, symbol等信息,所以使用CCS 菜单 Run-》 Load-》 LoadProgram, 加载U-Boot 即可。加载成功后, 如下图所示:
如图所示, PC直接指到0x80100000地址了,也就是U-Boot的起始地址(入口)了,该地址是CCS从头ELF头里面得到的,其定义在CONFIG_SYS_TEXT_BASE(include/configs/am335x_evm.h)中。
C. 相对 SPL 的调试, U-Boot有个地方不同,即有代码的重载(code relocation), 重载后代码的在SOC上的memory map和编译出的memory map会有个偏移。这个过程是在函数relocate_code()中完成的。 relocate_code()函数是在board_init_f()中调用的,如果需要调试从调用该函数开始后面的代码,则加上偏移重载symbol。
在CCS的菜单, Run-》 Load -》 Add Symbols, 加载的image还是前面的U-Boot, data/code offset 都是0x9FF88000。 这里的offset是从gd-》relocaddr(arch/arm arch/arm/lib/board.c)得到的。设置界面如下:
注意到上述几点,然后就可以按照SPL的调试过程对U-Boot进行调试了。
4. 总结
关于用CCS+emulator对AM335x的U-Boot/SPL的调试就介绍完了。这里介绍的方法,包含了CCS+emulator调试的基本原则,不仅仅可以运用于U-Boot/SPL调试,也可以运用于Starterware,Kernel等调试。