Face

Embest ICE Server for ARM

User Guide

May 2004 Version 1.0









Shenzhen Embest Info&Tech Co., Ltd.
Add.: Room 210, Luohu Keji Building, No. 85, Taining Rd.,
Luohu Dist., Shenzhen (518020)
Tel: 86-755-25631365 86-755-25635656 Fax:86-755-25616057
E-mail: sales@embedinfo.com support@embedinfo.com
Web: http://www.embedinfo.com http://www.embed.com.cn


Contents
1. Overview 2

2. Software installation 3
3. Usage of software 4
3.1 Connect to Embest JTAG emulator........................ 5
3.2 ICE Server settings............................................... 9
3.3 Debugging software setting................................ 14
4. Software interface 20
4.1 Menu................................................................... 20
4.2 Icon status indication......................................... 27
5. Application example 28
5.1 Example program............................................... 28
5.2 SDT simple example (RMTest_EB40x) ................ 33
5.3 SDT integrated example ( LED_EV40_SDT) ........ 36
5.4 ADS simple example (RMTest_EV40).................. 40
5.5 ADS integrated example (LED_EB40x_ADS) ....... 43
6. Information Reference 46
6.1 Info Reference.................................................... 46
6.2 Warning Reference............................................. 47
6.3 Error Reference .................................................. 48
7. Customer Service 52


.ii.
1. Overview
Embest ICE Server for ARM supports development environment in ARM
environment
ARM Software Development Toolkit (SDT)
ARM Developer Suite (ADS)
JTAG interface based series emulators of
Embest are used
Embest Emulator
Embest PowerICE
For software development and debugging.

Embest ICE Server for ARM has the following features:
Supports Windows 98/NT/XP/2000/ME;
Supports SDT versions 2.50 and 2.51, and ADS version 1.2;
Supports all Embest series ARM emulators;
Supports little and big Endian modes;
Supports ARM/THUMB command modes;
Supports all debugging functions of SDT and ADS, processor
register/memory edit view, assembly/C/C++ code level
breakpoint and single step;
Unlimited software breakpoint;
Icon and animation effect indication and debugging statuses;
Enhanced information prompt, alarm and error output;

Page 2 of 53
2. Software installation
System requirements
Computer: Pentium II or higher
Memory: 64M or higher
Hard discs: 10M is necessary to setup the complete software.
Monitor: VGA or a monitor with resolution higher than VGA
Driver: CD-ROM driver
Operation
system:
Microsoft Windows 98, Windows Me, Windows XP,
Serivice Pack 3 or updated Windows NT, Windows 2000.
Installation
The installation of the Embest ICE Server is very simple. You can just run
the Setup.exe in the installation package, which will guide you through the
installation step by step.

According to the installation program by default, the Embest ICE Server will
be installed under directory Program Files\Embest\Embset Ice Server, and
users can specify installation directory by customizing the installation path.
The computer has to be restarted after installation.

Page 3 of 53
3. Usage of software
After the ICE Server is installed, perform debugging by entering SDT/ADS
according to the following procedures:
1 Connect the emulator onto the computer through parallel port or
other communications ports, at the same time, connect the emulator
through JTAG onto the target board and power on;
2 Start up the ICE Server, and set all the debugging equipment to be
used in the ICE Server;
3 Set the access mapping files of the storage area in the ICE Server
according to needs;
4 Start up the SDT/ADS debugging software in the project manager of
the SDT/ADS, or independently start up the SDT/ADS debugging
software, and set the debugging modes in the debugging software;
5 Start debugging after the debugging software enters the debugging
status;
The various sections of this chapter describe the related details for settings
in the procedures mentioned above.
Page 4 of 53
3.1 Connect to Embest JTAG emulator
Embest JTAG Emulator contents two types of product: Standard JTAG
Emulator (Embest Emulator for ARM), and Enhanced JTAG Emulator (Embest
PowerICE for ARM).
Standard Emulator (Embest Emulator for ARM) was the standard JTAG
emulator for development series of ARM core CPU, early product of Embest
Info&Tech Co., LTD. It works at 25Kbyte per second by transmission, and capability
stabilization.
Enhanced Emulator (Embest PowerICE for ARM) was the New-generation of
JTAG emulator. Its feature power supply can be provided by internal or external
input, and works at highest speed 120Kbyte per second by transmission.
Embest JTAG Emulator has a Parallel port connecting to the Computers
parallel port, and a JTAG interface connecting to the target system.
There are 3 LEDs on the panel, indicating the Emulators working state.

Note Cable connection must not hot swap!

3.1.1 Embest Emulator
JTAG Interface Connections
A standard male-to-female 25-way parallel cable connects the Embest
PowerICE for ARM to the PC's parallel port. The connection to the target board is
made by a 20pin (or 14pin) female IDC header cable with all pins connected
straight through (1-1, 2-2, ... 20-20). There are two types of IDC interface cable:
14pin and 20 pins. JTAG pins connections are described as figure A1 and A2.

Page 5 of 53

Vsupply
RES
TDI
TMS
TCK
RES
TDO
nSRST
RES
RES
1
3
5
7
9
11
13
15
17
19
2
4
6
8
10
12
14
16
18
20
RES
GND
GND
GND
GND
GND
GND
GND
GND
GND

Figure A-1 20 Pin JTAG Connections

Vsupply
nSRST
TDI
TMS
TCK
TDO
RES
1
3
5
7
9
11
13
2
4
6
8
10
12
14
RES
GND
GND
GND
GND
GND
GND

Figure A-2 14 Pin JTAG Connections
Note: All GND pins should be connected to 0V on the target board.

The following table shows the JTAG pinouts.
Signal I/O Description
Vsupply Input This is the supply voltage to Embest Emulator for
ARM. It draws its supply current from this pin via a
step-up voltage convertor. This is normally fed by the
target Vdd. Valid power supply voltage is form 2.7V
to 5.5V.
GND - Ground.
TDI Output Test Data In signal from Embest Emulator for ARM to
the target JTAG port. It is recommended that this pin
be pulled to a defined state.
TMS Output Test Mode signal from Embest Emulator for ARM to
the target JTAG port. This pin should be pulled up on
the target so that the effect of any spurious TCKs
when there is no connection is benign.
Page 6 of 53
TCK Output Test Clock signal from Embest Emulator for ARM to
the target JTAG port. It is recommended that this pin
be pulled to a defined state.
TDO Input Test Data Out from the target JTAG port to Embest
Emulator for ARM.
nSRST Output Open collector output from Embest Emulator for ARM
to the target system reset. This pin should be pulled
up on the target to avoid unintentional resets when
there is no connection.
RES - Reserved.

Power Supply
Power is supplied to the Embest Emulator for ARM via pin 1 of the 20-way
(or 14-way) IDC connector. This is normally fed by the target Vdd. Valid power
supply voltage is form 2.7V to 5.5V.

Note Emulator cannot work if power voltage out of range, even be
badly damaged.

Target Interface Voltage Levels
The target interface voltage levels of Embest Emulator for ARM depends on
the input voltage levels It is 3V/5V compatible.
LED Indicator
There are three LED in the panel of Embest Emulator for ARM, labeled
Power Run and Con
LED Power: power indicator
LED Run: data indicator, indicate the data transmission between host pc
and target CPU.
LED Con, connection indicator
3.1.2 Embest PowerICE
JTAG Interface Connections
A standard male-to-female 25-way parallel cable connects the Embest
PowerICE for ARM to the PC's parallel port. The connection to the target board is
made by a 20pin (or 14pin) female IDC header cable with all pins connected
straight through (1-1, 2-2, ... 20-20). There are two types of IDC interface cable:
14pin and 20 pins. JTAG pins connections are described as figure A1 and A2.
Page 7 of 53
Power Supply
Power is supplied to the Embest PowerICE for ARM via pin 1 of the 20-way
(or 14-way) IDC connector. This is normally fed by the target Vdd. Valid power
supply voltage is form 2.7V to 5.5V. Power of Embest PowerICE for ARM also can
be supply by external input voltage valid 3V/5V. Connection jack of the external
voltage input show as figure A-3 following:

Figure A-3 connection jack of the external voltage input

Note
According to the way of voltage input, power supply switch
of Embest PowerICE for ARM must place in the right position.
Embest PowerICE for ARM cannot work if power voltage out
of range, even be badly damaged.

Target Interface Voltage Levels
The target interface voltage levels of Embest PowerICE for ARM depends on
the input voltage levels It is 3V/5V compatible. Normally, power supply by the
external input voltage will give the output single voltage provided 3.3V.
LED Indicator
There are three LED in the panel of Embest PowerICE for ARM, labeled
Power Run and Con
LED Power: power indicator
LED Run: data indicator, indicate the data transmission between host pc
and target CPU.
LED Con, connection indicator

Page 8 of 53
3.2 ICE Server settings
3.2.1 Debugging equipment selection and setting
Right click the ICE Server tray icon , and the ICE Server control menu will
pop up as shown in the following figure:

Select the submenu Setting, and a dialog box for debugging equipment
selection and setting will pop up, as shown in the following figure:

Remote Device: Remote device: the pull-down box displays all the
debugging equipment supported by the software, and users can select one of
them. At the lower part of the pull-down box, the equipments description and
version information will be displayed. At present, the software supports the
following programming equipment:
Page 9 of 53
Jtagarm7 Embest Emulator: standard emulator supports ARM7 core
processor
Jtagarm9 Embest Emulator: standard emulator, supports ARM9
core processor
PowerICEArm7 Embest PowerICE enhanced emulator, supports ARM7
core processor
PowerICEArm9 Embest PowerICE enhanced emulator, supports ARM9
core processor
Debug Speed: to set the download debugging speed of the emulator. This
setting is valid only when the emulator supports the debugging download
speed.
Embest Emulator Does not support the option
Embest PowerICE Full Speed, High Speed, Medium Speed and Low Speed
Communication Type: to set the connection mode between the
equipment and the host, and the host communication port connected.
Parallel Port: to be set according to the actual situations.

3.2.2 Setting of mapping files in storage area
During the software debugging, there may be something abnormal in some
processors or target boards when accessing nonexistent storage addresses or
other illegal storage areas. If the problem is not solved, software debugging
may discontinue, and use of the mapping files (*.map) in the storage area can
prevent the problem from happening.
Users can opt whether to set mapping files of the storage area or not
according to specific situations, and the steps for setting the mapping files of the
storage area are as follows:
Right click the ICE Server tray icon , and the ICE Server control menu will
pop up as shown in the following figure:
Page 10 of 53

Select the submenu Options, and a dialog box will pop up, as shown in the
following figure:

To select Use map file, the full path name for the memory mapping file has
to be set in the edit box at the same time, then reading and writing memory
during the debugging process will be done according to the memory scope and
attributes set in the memory mapping files.
Format of mapping files in memory area
Each line of the mapping files in the storage area describes a storage area,
and the column starting with # is for note. The description line of the storage
area comprises 9 parts, and a space symbol is used to separate the various
parts.
Item Type Description
Name Character string Item name of storage area with a maximum of
64 digits
Page 11 of 53
Start address Hexadecimal
number
Start address of storage area
Length Hexadecimal
number
Length of storage area
Attribute Character string Read and write attributes. R means reading,
and W means writing
Bus width Number Bus width of storage area, 1 represents 8
digits, 2 represents 16 digits, and 4 represents
32 digits.
Access size Number Access size of storage area. 1 represents 8
digits, 2 represents 16 digits, and 4 represents
32 digits.
Read waiting Number Read waiting cycle, with a unit of ns
Write waiting Number Write waiting cycle, with a unit of ns
High-speed
access waiting
Number To tell access waiting cycle, with a unit of ns

Note: the 4 leading items for the various parts above are mandatory,
while other items are optional, and - means that users do not pay
attention.

Example of mapping file of storage area
Generally, BusWidth AccessSize ReadWait WriteWait BurstWait
means does not pay attention (notWarry), and the map file is given below for
illustration:

#Name Start Size Attribute notWarry
INTERNRAM 10000000 2000 RW - - - - -
COREINTERNALIO 78000000 8000000 RW - - - - -
STANDARDAPBIO B0000000 8000000 RW - - - - -
COREAPBIO B8000000 8000000 RW - - - - -
Page 12 of 53
EXTERNDRAM C0000000 800000 RW - - - - -
EXTERNSRAM C8000000 100000 RW - - - - -
FLASH C8100000 200000 R - - - - -
EXTERNSRAM D0000000 80000 RW - - - - -
EXTERNIO F0000000 8000000 RW - - - - -

Page 13 of 53
3.3 Debugging software setting
3.3.1 SDT debugging setting
In the ARM SDT2.50/2.51 software, the debugging setting procedures are
as follows:
(1) Start up ARM Debugger
You can directly run the ARM Debugger, or select menus Project -> Debug
xxxx.apj to run it in the ARM Project Manager.
(2) Open the dialog box for debugging configuration
In the ARM Debugger, select menus Options Configure Debugger, and
open the dialog box for ARM Debugger debugging configuration.

(3) Debugging configuration
Remote_A Select the Target attribute tab in the debugging configuration
dialog box as shown in the following figure, and select Remote_A from the
combo box Target Environment.
Page 14 of 53

Click the Configure button, and the dialog box for Remote_A
configuration will pop up.
Select Ethernet for Remote Connection, and input the host IP address for
Embest ICE Server running in the edit box. If the Embest ICE Server and the
ARM Debugger run on the same host, the loopback IP address 127.0.0.1 can be
entered, as shown in the following figure.

(3) Little and big Endian setting
Page 15 of 53
Select the Debugger attribute tab for debugging configuration, and select
Little Endian or Big Endian according to the targets to be debugged, as shown in
the following figure:

3.3.2 ADS debugging setting
In the ARM ADS 1.2 software, the debugging setting procedures are as
follows:
(1) Start up AXD
You can separately and directly run the AXD, or select menus Project
Debug to in the CodeWarrior for ADS project management window to open the
AXD.
(2) Open target selection dialog box
If no configuration debugging mode is set for the ADS, a prompt dialog box
will pop up during startup of AXD. Click the Configure button to open the dialog
box for target selection, as shown in the following figure:

Page 16 of 53
If debugging mode is configured for the ADS, select menus Options
Configure Target to open the dialog box for target selection, as shown in the
following figure:

(3) Select target ADP
Select the ADP from the list of the dialog box for target selection.

(4) Configure ADP parameters
Click the Configure button in the dialog box for target selection, open the
dialog box for ADP configuration, and select Little Endian or Big Endian
according to debugging objects.
Page 17 of 53

Click the Select button, and a dialog box for selection of usable drive
programs will pop up, and select the ARM Ethernet driver, as shown in the
following figure:

Click the Configure button, and a dialog box for network connection will pop
up. Enter the host IP address run by the Embest ICE Server. If the Embest ICE
Server and the AXD are running in the same host, the loopback IP address
127.0.0.1 can be entered, as shown in the following figure:

Page 18 of 53
(5) Cancel Semihosting
Select AXD software menus Options Configure Processor to open the
dialog box for processor configuration.

Cancel Semihosting in the dialog box for processor configuration, as shown
in the following figure:



Page 19 of 53
4. Software interface
4.1 Menu
Output Window
Display of information output window.
Right click the ICE Server tray icon , and the ICE Server control menu will
pop up. Select menu Output Window, and the output window will pop up.
The green characters in the information output window show the software
version and company information, while the black characters show the
debugging information, as shown in the following figure:

The yellow characters show the debugging alarm information, while the red
characters show the debugging error information, as shown in the following
figure:

Page 20 of 53
For explanations on the debugging information, please refer to the sections
below.
Stop Server
Stop running Embest ICE Server.
If a user will not use the ICE Server temporarily, he can select Stop Server
menu to stop running.
When stopping ICE Server, if the ARM SDT/ADS debugger is still running, a
dialog box for prompt will pop up to suggest the user close the debugger first.

Click OK to stop the ICE Server, or click Cancel to stop the operation.

Note: if the ICE Server is stopped during debugging, reception error or
communications timeout error will appear in the ARM SDT/ADS.

Restart Server
Restart the Embest ICE Server.
When restarting the ICE Server, if the ARM SDT/ADS debugger is still
running, a dialog box for prompt will pop up to suggest the user close the
debugger first.

Click OK to restart the ICE Server, or click Cancel to abandon the
operation.

Page 21 of 53
Note: if the ICE Server is restarted during debugging, reception error or
communications timeout error will appear in the ARM SDT/ADS.

Settings
Right click the ICE Server tray icon , and the ICE Server control menu will
pop up, as shown in the following figure:

Select submenu Settings, and a dialog box for debugging equipment
selection and setting will pop up, as shown in the following figure:

Remote device: the pull-down box displays all the debugging equipment
supported by the software, and users can select one of them. At the lower part
of the pull-down box, the equipments description and version information will
Page 22 of 53
be displayed. At present, the software supports the following programming
equipment:
Jtagarm7 Embest Emulator: standard emulator, supports ARM7
core processor
Jtagarm9 Embest Emulator: standard emulator, supports ARM9
core processor
PowerICEArm7 Embest PowerICE enhanced emulator, supports ARM7
core processor
PowerICEArm9 Embest PowerICE enhanced emulator, supports ARM9
core processor
Debug Speed: to set the download debugging speed of the emulator. This
setting is valid only when the emulator supports the debugging download
speed.
Embest Emulator Does not support the option
Embest PowerICE Full Speed, High Speed, Medium Speed and Low Speed
Communication Type: to set the connection mode between the
equipment and the host, and the host communication port connected.
Parallel Port: to be set according to the actual situations.

Options
During the software debugging, there may be something abnormal in some
processors or target boards when accessing nonexistent storage addresses or
other illegal storage areas. If the problem is not resolved, software debugging
may discontinue, and use of the mapping files (*.map) in the storage area can
prevent the problem from happening.
Users can opt whether to set mapping files of the storage area or not
according to specific situations, and the steps for setting the mapping files of the
storage area are as follows:
Page 23 of 53
Right click the ICE Server tray icon , and the ICE Server control menu will
pop up as shown in the following figure:

Select the submenu Options, and a dialog box will pop up, as shown in the
following figure:

To select Use map file, the full path name for the memory mapping file has
to be set in the edit box at the same time, then reading and writing memory
during the debugging process will be done according to the memory scope and
attributes set in the memory mapping files.
Format of mapping files in memory area
Each line of the mapping files in the storage area describes a storage area,
and the column starting with # is for note. The description line of the storage
area comprises 9 parts, and a space symbol is used to separate the various
parts.
Item Type Description
Page 24 of 53
Name Character string Item name of storage area with a maximum of
64 digits
Start address Hexadecimal
number
Start address of storage area
Length Hexadecimal
number
Length of storage area
Attribute Character string Read and write attributes. R means reading,
and W means writing
Bus width Number Bus width of storage area, 1 represents 8
digits, 2 represents 16 digits, and 4 represents
32 digits.
Access size Number Access size of storage area. 1 represents 8
digits, 2 represents 16 digits, and 4 represents
32 digits.
Read waiting Number Read waiting cycle, with a unit of ns
Write waiting Number Write waiting cycle, with a unit of ns
High-speed
access waiting
Number To tell access waiting cycle, with a unit of ns

Note: the 4 leading items for the various parts above are mandatory,
while other items are optional, and - means that users do not pay
attention.

Example of mapping file of storage area
Generally, BusWidth AccessSize ReadWait WriteWait BurstWait
means does not pay attention (notWarry), and the map file is given below for
illustration:

#Name Start Size Attribute notWarry
INTERNRAM 10000000 2000 RW - - - - -
Page 25 of 53
COREINTERNALIO 78000000 8000000 RW - - - - -
STANDARDAPBIO B0000000 8000000 RW - - - - -
COREAPBIO B8000000 8000000 RW - - - - -
EXTERNDRAM C0000000 800000 RW - - - - -
EXTERNSRAM C8000000 100000 RW - - - - -
FLASH C8100000 200000 R - - - - -
EXTERNSRAM D0000000 80000 RW - - - - -
EXTERNIO F0000000 8000000 RW - - - - -

Using Help
Open the on-line help for the Embest ICE Server.
Embest Products
Open the website browser to display Embests products webpage.
About Embest ICE
A software about dialog box will pop up to display the software version and
company information.

Exit
Exit from the Embest ICE Server.
Page 26 of 53
4.2 Icon status indication
When the Embest ICE Server is running, different figures or animations are
displayed through the software tray icon to indicate the current running status
of the software.

Normal running of the software

Debugging status of the software

Stop running status of the software

Debugging error indication

Debugging alarm indication

Page 27 of 53
5. Application example
5.1 Example program
The example program is under subdirectory Examples under the Embest
ICE Server installation directory, which comprises four SDT/ADS based project
examples:

Project
name
Directory Based
on
Evaluation
board
Function
Rmtest RMTest_EB40x SDT
ADS
ATBEB40x To test the read/write of the
ATEB40x evaluation board
processor and register, and read
and write of memory data.
Led_test LED_EV40_SDT SDT S3CEV40 Including startup codes and a
complete example of C program,
and running example, and the
interval point will light the LED on
the S3CEV40 evaluation board and
8LED.
Rmtest RMTest_EV40 SDT
ADS
S3CEV40 To test the read/write of the
S3CEV40 evaluation board
processor and register, and read
and write of memory data.
LedSwing LED_EB40x_ADS ADS ATEB40x Including startup codes and a
complete example of C program,
and running example, and
continuous flash of 8 LEDs on the
ATEB40x evaluation board.

Page 28 of 53
5.1.1 Embest S3CEV40 Evaluation Board
ARM - Samsung S3C44B0X EVB
------10 BaseT, USB, 2x RS232, LCD, Boot Code...

Embest S3CEV40 Evaluation Board
Embest S3CEV40 EVB for S3C44B0X is a platform that is suitable for code
development of Samsung's S3C44B0X 16/32-bit RISC microcontroller (General
ARM) for hand-held device and general applications.
S3C44B0X consists of 16-/32-bit RISC (ARM7TDMI) CPU core, 8KB cache,
optional internal SRAM, LCD controller (up to 256 color DSTN), 2-ch UART with
hand-shake (IRDA1.0,16-byte FIFO), 4-ch DMA, System manager (chip select
logic, FP/ EDO/SDRAM controller), 6-ch timers with PWM, 71-bit general
purpose I/O ports, RTC, 8-ch 10-bit ADC, IIC-BUS interface, IIS-BUS interface,
Sync. SIO interface and PLL for clock.
Embest S3CEV40 EVB consist of S3C44B0X, boot Flash, SDRAM, LCD&TSP
touch screen interface, two serial communication ports, ethernet interface, USB
interface, keyboard interface, IIS(sound) interface, exterior IDE port, Nand
Flash, RTC, JTAG interface and 8-SEG. Embest S3CEV40 EVB provide a high
performance and low cost solution for embedded engineers.
Page 29 of 53
Hardware specification
5.0V DC or USB power supply
2 M bytes 16-bit Flash
8 M bytes 16-bit SDRAM
4K bit EEPROM with IIC BUS
2x RS232
USB connecter
10M Ethernet interface connector
microphone import
IIS audio frequency export (speaker out)
16 M Bytes Nand Flash
external IDE port
LCD&TSP touch screen port
320240 LCD * (optional)
44 keyboard * (optional)
Reset button
2 interrupt buttons and 2 LEDS
8 segment leds
20-pin JTAG interface connector
4 groups 220 PIN expansion connectors of CPU


Page 30 of 53
5.1.2 Embest ATEB40x Evaluation Board

Embest ATEB40x Evaluation Board
Embest ATEB40x Evaluation Board enables real-time code development and
evaluation. It supports the AT91x40 series with its various memory options. The
Embest ATEB40x Evaluation Board is comprised a mother board and a daughter
board. The daughter board is a microcontroller core board, it can be:
an AT91M40800 daughter board, with 8K Bytes of On-chip SRAM
an AT91R40807 daughter board, with 136K Bytes of On-chip SRAM
an AT91R40008 daughter board, with 256K Bytes of On-chip SRAM
an AT91FR40162 daughter board, with 256K Bytes of On-chip SRAM
and 1024K Words 16-bit Flash Memory
Orders must sepcify MCU in AT91FR40162, AT91R40807, AT91M40800 and
AT91R40008.
Page 31 of 53
Hardware specification
Evaluation Board based on AT91x40 series
5.0V DC-only power supply
Two serial ports
Reset push button
Four user-defined push buttons
Eight LEDs
A footprint of a 256-KB 16-bit SRAM (upgradeable to 512K Bytes)
1-MB 16-bit Flash
512K Bytes of EEPROM with two-wire interface access (controlled by a
software twowire interface)
16-pin LCD expansion connector
20-pin JTAG interface connector

Page 32 of 53
5.2 SDT simple example (RMTest_EB40x)
RMTest_EB40x is based on SDTs simple assembled language example,
demonstrates debugging program on Embest ATEb40x evaluation board, and
observes the read and write in the register and storage area.
(1) Open and activate project
Run ARM Project Manager, and open project file
Examples\RMTest_EB40x\rmtest.apj. Select the Debug sub project of the
project management window, so as to become the current active project.
(2) Assembly and link configuration
Edit, assembly and link configurations have been set in the project, users
can understand the related setting process, and do not require re-setting.
Select menus Poject -> Tool Configuration for Debug <asm> = armasm
set, and a dialog box for setting assembler translation options will pop up,
select the Options attribute tab, and select Keep Symbols button and Source
Line Debug button.

Select menus Poject -> Tool Configuration for Debug armlink set,
and a dialog box for setting Linker options will pop up, select the Entry and Base
attribute tab, and input 0x0 in Base of Image / Read-Only.
Page 33 of 53

(3) Edit
In the Build Debug sub project, edit the executable mapping file Exam
ples\RMTest_EB40x\Debug\rmtest.axf output by the link.
(4) Debugging
Select menus Project Debug rmtest.apj debug to start ARM
Debugger for debugging.
Directly start up ARM Debugger, select ARM Debuggers menus File
Load Imageto load executable mapping file
Examples\RMTest_EB40x\Debug\rmtest.axf, and download it onto the
development board for debugging.
Implement each assembly command step by step. When the registers
read/write command is implemented, observe the change of the registers value
for the registers window; when the write memory command is implemented,
observe the change of the memory unit value of the memory window for the
designated address.
Page 34 of 53

Page 35 of 53
5.3 SDT integrated example ( LED_EV40_SDT)
LED_EV40_SDT is an integrated example program based on SDT, including
startup code of the assembly language and demonstration of C language
programs of LED and 8LED for the Embest S3CEV40 evaluation board.
(1) Open and activate project
Run ARM Project Manager, and open project file
Examples\LED_EV40_SDT\led_test.apj. Click the Debug sub project of the
project management window, so as to become the current active project.
(2) Assembly and link configuration
Edit, assembly and link configurations have been set in the project, users
can understand the related setting process, and do not require re-setting.
Select menus Poject -> Tool Configuration for Debug <asm> = armasm
set to set the assembly options for the Assembler. A dialog box for setting
Assembler edit options will pop up, select the Options attribute page, and select
check buttons Keep Symbols and Source Line Debug.

Select menus Poject Tool Configuration for Debug <cc> = armcc >
set to set the edit options for C. A dialog box for setting C language options will
pop up, select the Language and Debug attribute page, and select radio button
Optimisation Level /None (best debug view). Select check button Enable debug
table generation, and the corresponding C edit option is O0 g+.
Page 36 of 53
Select menus Poject Tool Configuration for Debug armlink set to
set the link options of the Linker. A dialog box for setting Linker link options will
pop up, and select the Entry and Base attribute tab. Input 0x0C000000 in the
Base of Image / Read-Only, and the corresponding Linker edit option is -ro-base
0x0C000000.

(3) Edit link
In the Build Debug sub project, edit the executable mapping file Examples\
LED_EV40_SDT \Debug\led_test.axf output by the link.
(4) Debugging
Run the Embest ICE Server, and correctly connect the emulator with the
S3CEV40 development board. Select menus Project Debug
rmtest.apj debug, start up ARM Debugger for debugging, or click the
shortcut button on the rightmost of the toolbar to start up the ARM
Debugger for debugging.
You can also directly start up the ARM Debugger, select ARM Debugger
menus File Load Imageto open the executable mapping file
Examples\LED_EV40_SDT\Debug\led_test.axf, and download it to the
development board for debugging.
Select menus View Command to open the command window, and input
Obey boot.ini to execute the command script
Examples\LED_EV40_SDT\Debug\boot.ini.
Page 37 of 53


The debugging script file is used to initialize the system configuration
register, the storage control register and the broken mask code register.
; Disable all vector catch to not have AXD to warn you that a vector
exception has been caught.
let $vector_catch = 0x00
; Disable the semihosting.
let $semihosting_enabled = 0x00
; WTCON (watchdog timer control Register) disable warch dog
let 0x01D30000 = 0x00000000
; INTMSK (disable all interrupt
let 0x01E0000C = 0x07ffffff
; BWSCON (Bus Width & Wait Status Control Register)
let 0x01D8000C = 0x00000fff
; BANKCON0 ~ BANKCON7 REFRESH BAKSIZE
let 0x01C80000 = 0x11110101
let 0x01C80004 = 0x00000600
let 0x01C80008 = 0x00007FFC
let 0x01C8000C = 0x00007FFC
let 0x01C80010 = 0x00007FFC
let 0x01C80014 = 0x00007FFC
let 0x01C80018 = 0x00007FFC
let 0x01C8001C = 0x00018000
let 0x01C80020 = 0x00018000
let 0x01C80024 = 0x00860459
Page 38 of 53
let 0x01c80028 = 0x00000010
; MRSRB6 MRSRB7
let 0x01C8002C = 0x00000020
let 0x01C80030 = 0x0000002013


Test single step execution, entry function, and exit function. Set breakpoint
and clear breakpoint, and perform routine debugging operations such as full
speed running. Observe the change of the registers value of the register
window, or observe the change of the memory unit value of the memory window,
or observe the change of statuses or values of corresponding windows for
breakpoints, partial variables, and so on. During full speed running of the
example, the LED and 8LED of the S3CEV40 development board will be
alternately lit.

Page 39 of 53
5.4 ADS simple example (RMTest_EV40)
RMTest_EV40 is based on ADS simple assembled language example,
demonstrates debugging program on Embest S3CEV40 evaluation board, and
observes the read and write in the register and storage area.
(1) Open and activate project
Run Metrowerks CodeWarrior for ARM Developer Suite, and open project file
Examples\RMTest_EV40\rmtest.mcp. Select the Debug sub project as the
current active project.
(2) Assembly and link configuration
Edit, assembly and link configurations have been set in the project, users
can understand the related setting process, and do not require re-setting.
Click Setting button to set the options for the Debug sub project.
Click Language Settings / ARM Assembler in the Target Settings Pannels to
set the Assemblers assembly options. Select the Options attribute tab, choose
the Keep Symbol check button and Source Line Debug check button, and the
corresponding Assembler option is keep g.

Page 40 of 53
Click Linker / ARM Linker in the Target Settings Pannels to set the Linker link
options. Select the Output attribute tab, input the address 0x0C000000 in the
RO Base, and the corresponding link option is ro-base 0x0C000000.

(3) Edit
Click the Make button, and the assembly link will output executable
mapping file Rmtest.axf.
(4) Debugging
Run the Embest ICE Server, and correctly connect the emulator with the
S3CEV40 development board. Click the Debug button to start up the
AXD for debugging of Rmtest.axf.
Run the Embest ICE Server, correctly connect the emulator with the
S3CEV40 development board. Or directly run the AXD, select the AXD
menus File Load Image to open the executable mapping file
rmtest.axf, and download it to the development board for debugging.
Implement each assembly command step by step. When the registers
read/write command is implemented, observe the change of the registers value
for the registers window; when the write memory command is implemented,
observe the change of the memory unit value of the memory window for the
designated address.
Page 41 of 53

Page 42 of 53
5.5 ADS integrated example (LED_EB40x_ADS)
The LED_EB40x_ADS is an integrated project example based on the ADS,
demonstrated on the Embest ATEb40x evaluation board with continuous
lighting or outage of the LED.
(1) Open and activate project
Run the ADS, and open the Examples\LED_EB40x_ADS\LedSwing.mcp
project file. Select the current active project as Multi_ICE sub project.
(2) Edit, assembly and link configuration
Edit, assembly and link configurations have been set in the project, users
can understand the related setting process, and do not require re-setting.
Click the Setting button to set the options for the Multi_ICE sub
project.
Click Language Settings / ARM C Compliler on the Target Settings Pannels
to set the C edit options, and the settings are illustrated in the following figure:

Click the Language Settings / ARM Assembler in the Target Settings Pannels
to set the options for the Assembler, and the settings are illustrated in the
following figure:
Page 43 of 53

Click the Linker / ARM Linker in the Target Settings Pannels to set the
options for the Linker, and the settings are illustrated in the following figure:

(3) Edit
Click the Make button, and the edit link will output the executable
mapping file LedSwing.axf.
(4) Debugging
Page 44 of 53
Click the Debug button to start up the AXD to debug the mapping
file LedSwing.axf.
Directly run the AXD, select the AXD menus File -> Load Imageto open
the executable mapping file LedSwing.axf, and download it to the
development board for debugging.
Users can execute operations such as single step, entry function, exit
function, setting breakpoint, clearing breakpoint, full speed running, and so on,
and observe changes of debugging information such as global and partial
variables after the operations. When the example is run at full speed, the 8 LEDs
of the ATEB40x development board will flash quickly.
(5) About command script file
At the beginning, the project during debugging will automatically implement
command script files.
Users can input debugging commands into the Comand window to
implement the command script:
Obey LedSwing_flash.dat
Command Script: in the process of software debugging, some special
functions, like resetting object board, clearing windog, shielding interrupt
register, memory mapped etc., should be automatically finished in an
integrated environment; these special functions can be finished by
executing one command sequence and the file that stores the command
sequence is called command script file.
If users have not burnt the bare board for the program, or there is broken
program on the shielding board, or the storage area is mapped to different
addresses, the command script file can be implemented. The explanations on
the command script files for the project are as follows:
spp semihosting_enabled 0 semihosting. forbidden
spp vector_catch 0x0 Vector capture forbidden
setmem 0xFFE00000 0x01002539 32 To set chip option register
setmem 0xFFE00024 0x6 32 To set access width
setmem 0xFFE00020 0x1 32 Remap
ld ledSwing.axf Load file

Page 45 of 53
6. Information Reference
6.1 Info Reference
1001 Info: target device ID is: 0x????????
Description Read the ARM cores ID and display
Cause and
Resolution
Reason:
because of the first time to connect to
the Target CPU.
No disposal

Page 46 of 53
6.2 Warning Reference
2001 too many breakpoints.
Description Breakpoints amount out of range.
Cause and
Resolution
Reason of warning: (Embest JTAG
emulator for arm7 V2001)
More than two hardware breakpoints.
More then one hardware breakpoint
and 255 software breakpoint.
Delete at least one breakpoint before
setting a new one.

Page 47 of 53
6.3 Error Reference
1001 emulator not found, please check power and hardware
connection.
Description Can not find the emulator, maybe its
power or connect to hardware
abnormally.
Cause and
Resolution
Reason of error:
emulator do not connect to the PC
emulator do not connect to the target
board
No power on the target board
Communication ports configuration
error or damaged
Please check power and hardware
connection.
1002 unable to load emulator module.
Description Failed to load CPU module.
Cause and
Resolution
Reason of error:
emulator driver module(s) damaged
emulator driver module(s) directory has
changed
Please reinstall the software.
1003 device driver error.
Description Driver program error
Cause and
Resolution
Reason of error:
device driver did not install or was
deleted
device driver has not started
device driver has damaged
Please reinstall the software.
Page 48 of 53
1004 target CPU not found.
Description Emulator can not communicate with target
CPU.
Cause and
Resolution
Reason of error:
JTAG pins were used incorrectly of
target board
CPU was damaged
CPU does with JTAG debugging
the voltage of emulator mismatch with
the CPU or does not support this type of
CPU
1005 Initialize failed. Can't execute this command.
Description Can not initialize the target, and can not
execute the command.
Cause and
Resolution
Reason of error:
Reference:1001-1004
1006 get target status failed.
Description Emulator can not get the target boards
status.
Cause and
Resolution
Reason of error:
emulator communicate with the target
board abnormally
program of target board running
incorrectly
Reset the target board and reconnect.
1007
1008
1009
run target failed.
step target failed.
stop target failed.
Description Run the target boards program failed,
Execute the Step command failed,
Program running failed when Stop target
Page 49 of 53
board.
Cause and
Resolution
Reason of error:
emulator communicate with the target
board abnormally
program of target board running
incorrectly
Reset the target board and reconnect.
1010
1011
breakpoint set failed.
clear breakpoint failed.
Description Set or Clear breakpoint failed
Cause and
Resolution
Reason of error:
more then tow of Hardware breakpoint
more then 255 software breakpoint while
one hardware breakpoint has set
other causes
Set the breakpoints within available rang.
1012
1013
dump memory failed.
fill memory failed.
Description Read or Write to memory failed.
Cause and
Resolution
Reason of error:
emulator failed to communication with
target board or un-normal
users program fault
Reset the target board and connect it
again.
1014
1015
read register failed.
write register failed.
Description Write new value to Register failed
Cause and
Resolution
Reason of error:
emulator failed to communication with
Page 50 of 53
target board or un-normal
users program fault
Reset the target board and connect it
again.

Page 51 of 53
7. Customer Service
Get support on demand. Connect Customer Service for more information on
how to use the Embests products.
Web Site
Get the latest information and docs about Embests products from the web
site: http://www.embedinfo.com
You may have noticed some trouble issues at the support forums. In the
meantime, you can get help by subscribing to the following forum:
http://www.embedinfo.com/cforum/login.asp
E-Mail
If you have any question, comments, feedback or suggestions as to how our
products could be improved, let us know at support@embedinfo.com
Telephone Number
You can also call 86-755-25635626 with the extension to the Customer
Service Center.
Fax Number
Our fax number is 86-755-25616057.

Page 52 of 53