1 概述
本文介绍使用ARM DS-5创建一个裸机程序，并用DS-5里面的ARM编译器进行编译，编译之后通过DSTREAM
仿真器将程序加载到MYD-SAMA5D34
开发板的SRAM（内存）上。
通过DS-5和DSTREAM，就可以对SRAM上的程序进行调试，包括单步调试、全速运行、设置断点、寄存器、变量和函数调用等。
本文的程序是一个简单的打印程序，程序在MYD-SAMA5D34开发板SRAM上运行，通过DSTREAM仿真器的半主机机制将打印信息传送到主机上，在DS-5上显示。
说明：如果是应用程序开发，请跳过这一章节，直接进入《ARM DS-5创建和编译linux应用程序》及其后面的 章节，因为裸机程序和kernel调试部分都用到DSTREAM仿真器，没有则无法进行。直接进行应用程序的开发可以不用DSTREAM仿真器，直接使用DS-5就可以了。
2 设备 编号 | |
| |
| ARM开发工具，在Window主机下使用其自带的Linux应用程序。ARM DS-5的社区版、 |
| 在调试开发板时，PC机和开发板之间，用以接受DS-5的调试命令，并控制开发板执行。4 | | 米尔科技基于ARM Cortex-A5内核开发板，板载的Android操作系统可以完整结合 本文用到开发板的 |
3 设备介绍 关于本例程使用的设备，除PC机是通用的设备不做介绍以外，其他设备请参考以下地址了解详细情况。
（1）ARM DS-5详细介绍：
http://www.myir-tech.com/product/ds-5.htm。
（2）获取ARM DS-5的30天评估板：
http://www.myir-tech.com/faq_list.asp?id=473。
（3）MYD-SAMA5D34（D31/33/35）开发板详细介绍：
http://www.myir-tech.com/product/myd-sama5d3x.htm。
（4）MYD-SAMA5D34（D31/33/35）核心板/工控板详细介绍：
http://www.myir-tech.com/product/myc-sama5d3x.htm。
（5）DSTREAM仿真器详细介绍：
http://www.myir-tech.com/product/dstream.htm。
4 开发步骤 M1 创建工程并生成二进制文件 （1）从开发菜单选择“ARM DS-5” >“Eclipse for DS-5”打开DS-5，或者直接双击DS-5桌面快捷图标（需自己创建）打开。然后点击“Go to the workbench”进入DS-5的工程管理界面。
（2）选择菜单栏 File > New > Project，在弹出的对话框中选择“C/C++”下的“C Project”，再点击“Next”。
（3）在C++ Project对话框中，“Project name”中输入工程名称，我们这里以“MYD-SAMA5D34”作为工程名称，再点选“Bare-metal Executable”下的“Empty Project”，点击“Next”进入下一步，如下图：
（4）进入下一步后，点击“Finish”完成新建并进入工作界面。
此时在DS-5左侧的工程管理器（project explorer）会看到新创建的工程“MYD-SAMA5D34”，展开会看到”Includes”下自动包含了一些目录，这些是我们编译的时候要用到的，DS-5已经自动添加好了。
（5）再选择菜单File > New > source file”，弹出对话框中的“source file”中输入文件名为”main.c”的C文件，点击“Finish”完成。
（6）自动打开“main.c”文件后（或者双击打开），在注释后面添加mian()函数代码并保存。
/*
* main.c
*
* Created on: 2013-8-27
* Author: GARY
*
* Copyright: Shenzhen MYIR Tech Limited
*
*/
#include
int main(int argc, char** argv)
{
while(1){
printf("Welcome to ARM DS-5!"); //打印内容
}
return 0;
}
添加后如下图：
（7）接下来我们还要创建一个“scatter”文件。择菜单File > New >“Other…”，在弹出的对话框中选择“scatter file editor” > “scatter file”，点击“next”进入下一步。
（8）在父项目框中选择刚刚创建的工程“MYD-SAMA5D34”，“File name”栏输入scatter文件的名称，我们这里用“sama5d3”（该文件可以用于MYD-SAMA5D3X系列开发板，包括MYD-SAMA5D31、MYD-SAMA5D33、MYD-SAMA5D34、MYD-SAMA5D35）。点击“finish”完成，如下图。
（9）DS-5自动打开“sama5d3.scat”文件，我们在文件中输入如下的信息，具体可参考芯片用户手册中的SRAM地址。
SRAM 0x00300000
{
APP_CODE +0
{
* (+RO, +RW, +ZI)
}
ARM_LIB_STACKHEAP 0x00301000 EMPTY 0x00001000 ; Application heap and stack { }
}
输入完成后如下图。
（10）然后我们要配置一下编译选项。点击“MYD-SAMA5D34”工程，选择菜单“Project” > “Properties”打开“Properties for MYD-SAMA5D34”对话框。如下图，显示工程的一些基本信息。
（11）选择左侧的“C/C++ Build”，点选其中的“general makefile automatically”（默认也是选择），表示使用DS-5自动生成的Makefile文件。如果要用自己手动编写的makefile文件，需要取消点选该项。
（12）点击“C/C++ Build”前面的三角符号，点击“Settings”选项，配置右侧的“Tool Settings”编译工具。
“ARM C Compiler” > “Code Generation” > “Target CPU (--cpu)”配置为“Cortex-A5”。
“ARM Assembler” > “Code Generation” > “Target CPU (--cpu)”配置为“Cortex-A5”。
“ARM Linker” > “Image Layout” > “Scatter file (--scatter)”选择上面创建的scatter文件的地址，如下图。
配置好后，点击“OK”完成并返回工程管理界面。
（13）点选工程管理器（Project Explorer）下的“MYD-SAMA5D34”工程，选择菜单”Project” >“Build Project”编译工程。此时DS-5会自动在“Debug”目录下创建makefile文件，并按照这些规则进行编译。
如果Problems栏下没有“Error”提示，说明编译成功，同时在“MYD-SAMA5D34”工程的“Debug”目录下生成二进制文件“MYD-SAMA5D34.axf”，如下图。
M2 连接开发板
（14）连接好DSTREAM仿真器，包括DSTREAM仿真器5V
电源线、转接板、USB线（或网线）。
（15）连接好MYD-SAMA5D34开发板，包括开发板5V电源线、DSTREAM上的20PIN-JTAG调试线、以及串口线。
（16）给开发板上电，通过串口终端将开发板停止在“u-boot”界面，如下图。这样做是防止开发板进入系统，影响裸机调试。
M3 调试配置
（16）点选工程管理器（Project Explorer）下的“MYD-SAMA5D34”工程，选择菜单“Run” > “Debug Configurations…”，在弹出的对话框中右击“DS-5 Debugger”，选择“New”新建一个调试选项。
（17）在新建的调试选项中，将调试选项名称改为“MYD-SAMA5D34_Debug”。在“Connection”选项的filter platform中输入“SAMA5D3”，然后选择过滤后 “SAMA5D3x”下 “Bare Metal Debug” > “Debug cortex-a5 via DSTREAM/RVI”。选项的目的是，通过DSTREAM对MYD-SAMA5D34开发板进行裸机调试。如下图。
然后再点击“connections”中的“Browse…”按钮，选择DS-5搜索到的DSTREAM仿真器，选择后点击“OK”使用该仿真器，如下图。
（18）点击调试选项名称下方的“File”选项，在“Target Configuration”下点击“Workspace…”按钮，然后从“Open”对话框中选择上面生成的二进制文件。
添加后如下图，然后选择“Load symbols”。
（19）点击“Debug”按钮开始调试。出现提示是否切换到调试窗口，点击“Yes”即可。
（20）如果连接成功，可看到蓝色标示的“connected”文字，同时调试控制窗口显示开发板相应的内核。如下图，DS-5已经连接上了开发吧，并且显示当前连接SAMA5D34里面的第一个Cortex-A5核（如果有多个核，会用#1、#2等标注多核的序号）。
（21）点击如上图的绿色三角形“
”，程序就会全速运行，在“App console”栏会打印从MYD-SAMA5D34开发板打印的信息。如下图。
M4 调试视图详解
（21）还是上面的图 “调试控制栏”，显示当前所有的调试名称，并且可以进行调试控制。
上图中，各控制按钮的作用为：
连接目标板
断开连接
删除连接
从main函数或者entry point调试
继续全速运行
停止运行
单步调试
选择按C程序单步调试，或者按汇编程序调试
（22）命令栏，可以在“commands”后面敲入命令，让开发板执行，比如敲入“step”就会进行单步调试。鼠标位于输入框内，按“Alt + /”可获得命令提示。
（23）历史栏，显示所有历史使用的命令。
（24）变量栏，显示程序使用的所有变量，在调试的时候可以进行修改。
（25）寄存器栏，显示内核里面的所有寄存器，在调试的时候可以对寄存器进行修改。
（25）函数栏，显示程序使用的所有函数，以及它们的开始和结束地址。
（25）源代码栏，显示源代码。
（26）汇编程序栏，显示程序对应的汇编程序、地址和操作数等。
（27）存储器栏，通过输入地址和大小，可以看到相应存储器的内容。如下图，地址输入“0x00300000”（内部SRAM地址），大小输入“1024”，就可以看到对应的存储地址的值。
（28）应用程序控制台，这里显示了通过半主机机制从开发板（如MYD-SAMA5D34）返回的打印信息。
（29）另外，还有一个比较重要的栏目“Progress”。有时候调试配置不正确，DS-5会一直“connecting”，从“调试控制”栏目又无法停止，这时候就要通过“progress”来停止了，如下图使用进度条后面的红色按钮就可以停止了。
“Progress”可以从菜单栏“window” > “show view” > “Progress”调出。
以上就是使用ARM DS-5和DSTREAM仿真器对裸机进行调试的内容。
5 说明
本文使用的是DS-5自带的gcc编译器，适用于ARM Cortex-A5/A7/A8/A9/A12/A15 Linux系统，包括但不限于以下芯片系统：
Avnet ZedBoard, Freescale i.MX6 Dual, Mindspeed T2200 / T3300, pandaboard.org OMAP 5432, Renesas RZ/A1H R7S721001, ST-Ericsson U8540, TI OMAP 543X and TI TMDX570LS04HDK / TMDX570LS12HDK / TMDX570LS31HDK / TMDXRM42HDK / TMDXRM46HDK / TMDXRM48HDK
Altera Arria V SoC, Altera Cyclone V SoC and Atmel ATSAMA5D3x
ARM Versatile Express AEMv7A RTSM (configured as Cortex-A15), ARM Versatile Express Cortex-A15x1 + Cortex-A7x1 RTSM, ARM Versatile Express Cortex-A15x4 + Cortex-A7x4 RTSM, ARM Versatile Express Cortex-A15x1 RTSM, ARM Versatile Express Cortex-A15x2 RTSM, ARM Versatile Express Cortex-A15x4 RTSM, ARM Versatile Express V2P Cortex-A15x2 + Corex-A7x3 and Freescale Vybrid VF6xx
ARM Versatile Express V2P Cortex-A15, ARM Versatile Express with Cortex-A15 NEON Soft Macrocell Model, ARM Versatile Express with Cortex-R5x2, ARM Versatile Express Cortex-A15x4 + CortexA7x4 RTSM, CALAO Systems Snowball board, NVIDIA Tegra 3, PandaBoard ES, ST-Ericsson AP9500, TI AM3352/4/6/7/8/9 / OMAP 4460 and Xilinx Zynq-7000 EPP ZC702
ARM Emulation Baseboard with ARM1156T2F-S Core Tile, ARM Versatile Express with Cortex-A15x2 Soft Macrocell Model, Atmel AT91SAM9G25 / AT91SAM9X35, LG Electronics L9, Mindspeed M84000 (Transcede 4000) and NXP LPC3131 / LPC3141 / LPC3152,
ARM Microcontroller Prototyping System (Cortex-M0/Cortex-M1/Cortex-M4), Keil MCBSTR9, ST STA2064/65, ST STR912, TI AM1707 / AM1808 / DM3725 / DM3730 / DM8168 / OMAP 3530 / OMAP L138
ARM Emulation Baseboard with ARM11 MPCore or Cortex-R4F Core Tile, ARM Microcontroller Prototyping System (Cortex-M3), ARM Platform Baseboard for ARM1176JZF-S, ARM Versatile Express A5x2, ARM Versatile Express with Cortex-A15 Soft Macrocell Model, Atmel AT91SAM9M10 / AT91SAM9G35 / AT91SAM9263-EK, CSR SiRFprimaII, Freescale i.MX233, Kyoto KZM-A9-Dual, ST SPEAr1310 and TI DM6467 / Blaze MDP
Atmel AT91SAM9M10, Core Logic CLM9721, Freescale i.MX50, nVidia Tegra 250, Samsung Exynos 4210, ST SPEAr 600, ST-Ericsson U8500 and TI Sitara AM1707/AM1808/AM387x, Integra C6A814x, and OMAP4430。
本文来自
米尔科技，原文地址：
http://www.myir-tech.com/resource/496.asp，转载请注明出处。
