Instruction/ maintenance manual of the product DUI 0137A ARM
Go to page of 42
Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. ARM DUI 0137A ARM ® RMHost User Guide.
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.
ARM DUI 0137A Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. iii Contents User Guide Preface About this book ............. .............. .............. .............. .............. .............. ......... -vi Feedback ..
Contents iv Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. ARM DUI 0137A.
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.
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.
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.
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.
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 .
Preface x Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. ARM DUI 0137A.
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.
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.
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 .
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.
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 .
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.
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.
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.
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 .
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.
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.
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.
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.
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.
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.
Connecting to RMHost 212 Copyright © 2000 ARM Limited. All ri ghts reserved.. All rights reserved. ARM DUI 0137A.
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.
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.
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.
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 ).
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.
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.
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.
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.
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.
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 .
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 me.
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.
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.
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.
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.
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 m.
An important point after buying a device ARM ARM DUI 0137A (or even before the purchase) is to read its user manual. We should do this for several simple reasons:
If you have not bought ARM ARM DUI 0137A yet, this is a good time to familiarize yourself with the basic data on the product. First of all view first pages of the manual, you can find above. You should find there the most important technical data ARM ARM DUI 0137A - thus you can check whether the hardware meets your expectations. When delving into next pages of the user manual, ARM ARM DUI 0137A you will learn all the available features of the product, as well as information on its operation. The information that you get ARM ARM DUI 0137A will certainly help you make a decision on the purchase.
If you already are a holder of ARM ARM DUI 0137A, but have not read the manual yet, you should do it for the reasons described above. You will learn then if you properly used the available features, and whether you have not made any mistakes, which can shorten the lifetime ARM ARM DUI 0137A.
However, one of the most important roles played by the user manual is to help in solving problems with ARM ARM DUI 0137A. Almost always you will find there Troubleshooting, which are the most frequently occurring failures and malfunctions of the device ARM ARM DUI 0137A along with tips on how to solve them. Even if you fail to solve the problem, the manual will show you a further procedure – contact to the customer service center or the nearest service center
