ARM ARM DUI 0137A manual

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
30
31
32
33
34
35
36
37
38
39
40
41
42

Go to page of

A good user manual

The rules should oblige the seller to give the purchaser an operating instrucion of ARM ARM DUI 0137A, along with an item. The lack of an instruction or false information given to customer shall constitute grounds to apply for a complaint because of nonconformity of goods with the contract. In accordance with the law, a customer can receive an instruction in non-paper form; lately graphic and electronic forms of the manuals, as well as instructional videos have been majorly used. A necessary precondition for this is the unmistakable, legible character of an instruction.

What is an instruction?

The term originates from the Latin word „instructio”, which means organizing. Therefore, in an instruction of ARM ARM DUI 0137A one could find a process description. An instruction's purpose is to teach, to ease the start-up and an item's use or performance of certain activities. An instruction is a compilation of information about an item/a service, it is a clue.

Unfortunately, only a few customers devote their time to read an instruction of ARM ARM DUI 0137A. A good user manual introduces us to a number of additional functionalities of the purchased item, and also helps us to avoid the formation of most of the defects.

What should a perfect user manual contain?

First and foremost, an user manual of ARM ARM DUI 0137A should contain:
- informations concerning technical data of ARM ARM DUI 0137A
- name of the manufacturer and a year of construction of the ARM ARM DUI 0137A item
- rules of operation, control and maintenance of the ARM ARM DUI 0137A item
- safety signs and mark certificates which confirm compatibility with appropriate standards

Why don't we read the manuals?

Usually it results from the lack of time and certainty about functionalities of purchased items. Unfortunately, networking and start-up of ARM ARM DUI 0137A alone are not enough. An instruction contains a number of clues concerning respective functionalities, safety rules, maintenance methods (what means should be used), eventual defects of ARM ARM DUI 0137A, and methods of problem resolution. Eventually, when one still can't find the answer to his problems, he will be directed to the ARM service. Lately animated manuals and instructional videos are quite popular among customers. These kinds of user manuals are effective; they assure that a customer will familiarize himself with the whole material, and won't skip complicated, technical information of ARM ARM DUI 0137A.

Why one should read the manuals?

It is mostly in the manuals where we will find the details concerning construction and possibility of the ARM ARM DUI 0137A item, and its use of respective accessory, as well as information concerning all the functions and facilities.

After a successful purchase of an item one should find a moment and get to know with every part of an instruction. Currently the manuals are carefully prearranged and translated, so they could be fully understood by its users. The manuals will serve as an informational aid.

Table of contents for the manual

  • Page 1

    Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. ARM DUI 0137A ARM ® RMHost User Guide[...]

  • Page 2

    ii Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. ARM DUI 0137A ARM RMHost User Guide Copyright © 2000 A RM Limited. All rights reserved.. All rights reserved. Release Information The following changes ha ve been made to this document. Proprietary Notice W ords and logos mark ed with ® or ™ are registered trademarks [...]

  • Page 3

    ARM DUI 0137A Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. iii Contents User Guide Preface About this book ............. .............. .............. .............. .............. .............. ......... -vi Feedback ........... .............. .............. .............. .............. .............. ..............[...]

  • Page 4

    Contents iv Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. ARM DUI 0137A[...]

  • Page 5

    ARM DUI 0137A Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. v Preface This preface introduce s the User Guide for ARM ® RMHost. It contains the follo wing sections: • About this book on page vi • F eedback on page ix.[...]

  • Page 6

    Preface vi Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. ARM DUI 0137A About this book This book describes how to configure the RealMonitor host controller, RealMonitor.dll , and how to debug RealMonitor-enabled applications using RMHost. This book documents only the host-side functionality of RealMonit or . For complet[...]

  • Page 7

    Preface ARM DUI 0137A Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. vii italic Highlights special termin ology , de notes intern al cross-references, and citations. typewriter Denotes text that can be entered at the ke yboard, such as commands, file and program names, and source code. typewriter Denotes a permitted abbr[...]

  • Page 8

    Preface viii Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. ARM DUI 0137A Other publicatio ns Please refer to the following publications for addi tional informati on: • E5903-97000 , T race P ort Analysis fo r ARM ETM User’ s Guide , Agil ent, 1999. • E3459-97002 , Emulation for the ARM7/ARM 9 User’ s Guide , Agi[...]

  • Page 9

    Preface ARM DUI 0137A Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. ix Feedback ARM Limited welcomes feedb ack on both RMHost, and its documentation. Feedbac k on RM Host If you hav e any problems with RMHost, please contact your supplier . T o help them provide a ra pid and useful response, please gi ve: • details of[...]

  • Page 10

    Preface x Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. ARM DUI 0137A[...]

  • Page 11

    ARM DUI 0137A Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. 11 Chapter 1 Overview of RMHost This chapter introduces RMHo st. It describes the host -side functionality of ARM RealMonitor , and how it is distinct from RMT arget. It also describes the system requirements for using RMHost. This chapter contains the followin[...]

  • Page 12

    Overview of RMHost 12 Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. ARM DUI 0137A 1.1 About RMHost RMHost is the host component of RealMonito r . It allows you to perform nonstop debugging on a RealMonitor-en abled application in a real-t ime en vironment. That is, when using RMHost, you can perform certain debugging op[...]

  • Page 13

    Overview of RMHost ARM DUI 0137A Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. 13 The RMHost controller con verts RDI function calls into RealMonito r protocol packets, and uses the chosen JT A G uni t to send these ov er the Debug Communications Channel (DCC) of the ARM processor . Additionally , RMHost uses the signal[...]

  • Page 14

    Overview of RMHost 14 Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. ARM DUI 0137A 1.2 RMHost requirements This section describes the requirement s n ecessary to use RMHost. RMHost works with any applica tion that has b een integrated with RMT ar get. For details on building RMT ar get, and integrating it with an applica[...]

  • Page 15

    ARM DUI 0137A Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. 21 Chapter 2 Connecting to RMHost This chapter describes the procedure for connecting to the debug tar get using AXD, including details on selecting and configuring the RMHost controller . It also describ es the connection messages you recei ve in AXD when you [...]

  • Page 16

    Connecting to RMHost 22 Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. ARM DUI 0137A 2.1 Procedure f or connecti ng to RMHost using AXD This section describes the steps you m ust follow to connect to RMHost using AXD 1.1. If you are using anot her deb ugger , see its accompan ying documentation for details on how to perf[...]

  • Page 17

    Connecting to RMHost ARM DUI 0137A Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. 23 T o use RMHost with a RealMonitor -enabled image: 1. Start AXD, and configure the tar get as follo ws: a. Select Conf igure T arget from the Options menu. The Choose T arget dialog box is displayed. b . Select a supported JT A G unit DLL[...]

  • Page 18

    Connecting to RMHost 24 Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. ARM DUI 0137A Note If Load Image is disabled, you must stop the current ly running application by selecting Stop from the Execute menu. The image might stop at main() if the program contains th is function. In this case, select Go from the Execute men[...]

  • Page 19

    Connecting to RMHost ARM DUI 0137A Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. 25 If not present in the list, click Add and select RealMonitor.dll from the Bin directory of the ADS installation. (If DLL files do not appear , use W indo ws Explorer to ensure that files of ex tension .dll are not hidden from view .) The[...]

  • Page 20

    Connecting to RMHost 26 Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. ARM DUI 0137A Figure 2-4 RealMonitor Configurati on dialog bo x Select an RDI 1.5. 1rt-compliant JT A G controller DLL (see RMHost r equirements on page 14), using one of the following methods: • If present in either the Bin directory of the ADS ins[...]

  • Page 21

    Connecting to RMHost ARM DUI 0137A Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. 27 Figure 2-5 JT A G controll er search dialog bo x 6. Click Configur e... to configure the JT A G controlle r you hav e selected. For details on configuring Multi-ICE 2.0, see the Using Mu lti-ICE with Debugger s chapter of the Multi-ICE U[...]

  • Page 22

    Connecting to RMHost 28 Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. ARM DUI 0137A Caution The module server does not work with the RMHost controller if you disabled support for the ExecuteCode packet when you b uilt RMT ar get. See the description of the RM_OPT_EXECUTECODE build option in the building the RMT ar get c[...]

  • Page 23

    Connecting to RMHost ARM DUI 0137A Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. 29 Note If RMHost detects an error in the co nf iguration you hav e selected, an error message is displayed. If this happens, you can click one of the following: OK Stores the configuration, although the error can prevent you from using RMH[...]

  • Page 24

    Connecting to RMHost 210 Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. ARM DUI 0137A Figure 2-7 No pc read acces s message[...]

  • Page 25

    Connecting to RMHost ARM DUI 0137A Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. 211 2.2 AXD connection messages When you connect the debugger to RMHost, messages are displayed in the RDI Log window of AXD, as sho wn in Example 2-1. If you are using a deb ugger other than A XD, see the documentat ion that accompanies yo[...]

  • Page 26

    Connecting to RMHost 212 Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. ARM DUI 0137A[...]

  • Page 27

    ARM DUI 0137A Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. 31 Chapter 3 Deb ug ging with RMHost This chapter describes all the deb ugging feat ures you can use in th e real-time debugging en vironment a v ailable when you are connect ed to RMHost. It also describes the restrictions to debugging a RealMon itor-enabled a[...]

  • Page 28

    Debugging with RMHost 32 Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. ARM DUI 0137A 3.1 Debugging with RMHost When connected to RMHost, th e AXD user interface is identi cal to that when connected to other debug tar gets such as Multi-ICE. (For details on connecting to RMHost, see Chapter 2 Connecting to RMHost .) Y ou[...]

  • Page 29

    Debugging with RMHost ARM DUI 0137A Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. 33 3.1.2 Back ground memory acces s In addition to being able to access memory when your application is stopped (as with Multi-ICE, for example), memory can also be read or written to while your appl ication is running. Therefore, the memo[...]

  • Page 30

    Debugging with RMHost 34 Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. ARM DUI 0137A Note This workaround is performed only if you hav e built RMT arget to support the ExecuteCode packet (see RM_OPT_EXECUTECODE in the building chapte r of the ARM RMT ar get Inte gration Guide ). It is recommended that you build RMT ar g[...]

  • Page 31

    Debugging with RMHost ARM DUI 0137A Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. 35 3.1.5 Bac kgro und setting and c learing of breakpo ints and watchpo ints When connected to RMHost, you can set and clear breakpoin ts and watchpoints without stopping your applicatio n. Y ou can also set and clear breakpo ints and watc[...]

  • Page 32

    Debugging with RMHost 36 Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. ARM DUI 0137A This message is display ed when the application is writing to the console, and you st op your application at the same time RMHost is performi ng a write. In this case, the data that has not been written is lost, and is not display ed. F[...]

  • Page 33

    Debugging with RMHost ARM DUI 0137A Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. 37 3.2 Error messa ges This section describes all error messages you might recei ve when connecting to, or using, RMHost. Note Error messages can be generated by both the de b ugger and the JT A G unit you are usi ng. Errors that come from[...]

  • Page 34

    Debugging with RMHost 38 Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. ARM DUI 0137A This error might also be displayed when any of the follo wing occurs: • Y ou connect to a remote target, that is, one that is not connect ed to the local machine. In this case, a timeo ut typically r esults from a network error . • [...]

  • Page 35

    Debugging with RMHost ARM DUI 0137A Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. 39 Memory map forbids reading from location Either you or the d ebugger attempted to read a location, but the memory map on the target forbids the reading of locations in that region. Memory map forbids setting of breakpoint/watchpoint Eit[...]

  • Page 36

    Debugging with RMHost 310 Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. ARM DUI 0137A RMHost could not load the specified JTAG controller This is displayed when the JT A G controller DLL could not be loaded . RMHost internal error Indicates some consistency failure inside the RMHost controller . Y ou must report this er[...]

  • Page 37

    Debugging with RMHost ARM DUI 0137A Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. 311 3.2.1 Other mess ages fr om RMHost In addition to the messages described in Err or messag es on page 37, you can also recei ve a message similar to that shown in Figure 3-1 when either of the following occurs: • you write to the CPSR[...]

  • Page 38

    Debugging with RMHost 312 Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. ARM DUI 0137A Cancel Abort. RMHost returns an error to the deb ugger . Note In ge neral, if your application en ables interrupts itself, yo u must start it with inter rupts disabled. Otherwise, it is typically safe to st art it with interrupts enabl[...]

  • Page 39

    Debugging with RMHost ARM DUI 0137A Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. 313 3.3 Using RMHost with T race Deb ug T ools RMHost can work with the ARM T race Deb ug T ools (TDT) version 1.1 or later . The system configuration is illustrated in Figure 3-2. Figure 3-2 Using RMHo st with TDT Note The ARM CPU core sh[...]

  • Page 40

    Debugging with RMHost 314 Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. ARM DUI 0137A 3.3.1 Configuring AXD to enable t racing with RMHost The process of connecting to a target system using both RMHost and TDT is similar to connecting to a target system using only RMH ost. The only difference is that you must enable tra[...]

  • Page 41

    ARM DUI 0137A Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. Index-1 Inde x The items in this inde x are listed in alphabetical order , with symbols and numerics appearing at the end. The references giv en are to page numbers. A ARM Developer Suite (ADS) 2--5 ARM eXtended Debugger. See AXD. ARM Flash Utility (AFU) 2--2 A[...]

  • Page 42

    Index Index-2 Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. ARM DUI 0137A G GetPC packet 3--5 H Host requirements 1--4 I Image cache 3--14 IRQ 3--11 J JTAG errors 3--7 M main() 2--4 Memory access 3--3 Module server 2--7 Multi-ICE 2--3, 2--6, 3--2, 3--7 N Nonstop debug 3--2 Nonstop startup 3--4 P PATH 2--6 pc (program co[...]