manualshive.com logo in svg

COBHAM GRMON3, Руководство пользователя, Страница: 10 / 239

Поделиться
Скачать
COBHAM GRMON3 Скачать руководство пользователя страница 10

GRMON3-UM
June 2019, Version 3.1.0

10

www.cobham.com/gaisler

3. Operation

This chapter describes how GRMON can be controlled by the user in a terminal based interactive debug session
and how it can be automated with scripts for batch execution. The first sections describe and exemplifies typical
operations for interactive use. The later sections describe automation concepts. Most interactive commands are
applicable also for automated use.

GRMON graphical user interface is described in Chapter 4, Graphical user interface.

3.1. Overview

An interactive GRMON debug session typically consists of the following steps:

1. Starting GRMON and attaching to the target system
2. Examining the hardware configuration
3. Uploading application program
4. Setup debugging, for example insert breakpoints and watchpoints
5. Executing the application
6. Debugging the application and examining the CPU and hardware state

Step 2 though 6 is performed using the GRMON terminal interface or by attaching GDB and use the standard
GDB interface. The GDB section describes how GRMON specific commands are accessed from GDB.

The following sections will give an overview how the various steps are performed.

3.2. Starting GRMON

On a Linux host, GRMON is started by giving the grmon command together with command line options in a
terminal window.  It can run either the GUI or a commandline interface depending on if a debug link option is
provided or not.

On Windows hosts, there are two executable provided. The file grmon.exe is intended to be started in a Windows
command prompt (cmd.exe). It can run either the GUI or a commandline interface depending on if a debug link
option is provided or not. The executable grmon-gui.exe will always spawn a gui.

Command line options are grouped by function as indicated below.

• The debug link options: setting up a connection to GRLIB target
• General options: debug session behavior options
• Debug driver options: configure the hardware, skip core auto-probing etc.

NOTE: If any debug-link option is given to grmon or grmon.exe, then the GRMON command line interface
will be started.

If no debug-link option is given to grmon or grmon.exe, then the GRMON graphical user interface will be started.
For more information, see Chapter 4, Graphical user interface.

Below is an example of GRMON connecting to a GR712 evaluation board using the FTDI USB serial interface,
tunneling the UART output of APBUART0 to GRMON and specifying three RAM wait states on read and write:

$ grmon -ftdi -u -ramws 3

To connect to a target using the AHBUART debug link, the following example can be used:

$ grmon -uart -u

The 

-uart

 option uses the first UART of the host (ttyS0 or COM1) with a baud rate of 115200 baud by default.

3.2.1. Debug link options

GRMON connects to a GRLIB target using one debug link interface, the command line options selects which
interface the PC uses to connect to the target and optionally how the debug link is configured. All options are
described in Chapter 5, Debug link.

Содержание GRMON3

Страница 1: ...r for LEON based computer systems and SOC designs based on the GRLIB IP library 2019 User s Manual The most important thing we build is trust GRMON3 User s Manual GRMON3 UM 1 www cobham com gaisler Ju...

Страница 2: ...Inserting breakpoints and watchpoints 16 3 4 5 Displaying processor registers 16 3 4 6 Backtracing function calls 16 3 4 7 Displaying memory contents 17 3 4 8 Instruction disassembly 18 3 4 9 Using th...

Страница 3: ...configurations 41 4 4 1 Target image setup 42 4 4 2 Launch properties 43 4 5 Views 44 4 5 1 CPU Registers View 44 4 5 2 IO Registers View 45 4 5 3 System Information View 47 4 5 4 Terminals View 47 4...

Страница 4: ...tistics Unit 69 6 12 LEON2 support 71 6 12 1 Switches 71 6 13 On chip logic analyzer driver 71 6 14 Memory controllers 72 6 14 1 Switches 73 6 14 2 Commands 74 6 15 Memory scrubber 74 6 16 MIL STD 155...

Страница 5: ...be found futher down 1 Extract the archive 2 Install the Sentinel LDK Runtime GRMON Pro version only 3 Optionally install third party drivers for the debug interfaces 4 Optionally setup the path for...

Страница 6: ...GRMON license file can be found in the share folder of the installation For example on Windows it can be found in c opt grmon pro windows share grmon or on Linux it could be found in opt gr mon pro li...

Страница 7: ...ommand layer debug driver layer and debug interface layer The command layer takes input from the user and parses it in a Tcl Shell It is also possible to start a GDB server service which has its own s...

Страница 8: ...listed below The detailed system view also provides information about address mapping interrupt allocation and IP core configuration Information about which AMBA AHB and APB buses a core is connected...

Страница 9: ...t not correspond to the actual target It is however possible to load a custom configuration file that describes the target system configuration using see Section 2 2 2 Configuration file target initia...

Страница 10: ...if a debug link option is provided or not On Windows hosts there are two executable provided The file grmon exe is intended to be started in a Windows command prompt cmd exe It can run either the GUI...

Страница 11: ...ile at start up Has no effect unless c is also set edac Enable EDAC operation in memory controllers that support it freq sysclk Overrides the detected system frequency The frequency is specified in MH...

Страница 12: ...states and hardware registers without going through commands The GRMON Tcl interface is described in Section 3 5 Tcl integration GRMON dynamically loads libreadline so if available on your host system...

Страница 13: ...mory write access 3 4 Common debug operations This section describes and gives some examples of how GRMON is typically used the full command reference can be found in Appendix A Command index 3 4 1 Ex...

Страница 14: ...rting GRMON The current memory settings can be viewed in detail by listing the registers with info reg or by accessing the registers by the Tcl variables exported by GRMON grmon3 info sys mctrl0 Cobha...

Страница 15: ...y located in FLASH can be started by specifying an absolute address The cont command resumes execution after a temporary stop e g a breakpoint hit go also affects the CPU execution the difference comp...

Страница 16: ...ted using bp bus or bp data When a bus watchpoint is hit the trace buffer will freeze The processor can optionally be put in debug mode when the bus watchpoint is hit This is controlled by the tmode c...

Страница 17: ...y read access list a range of addresses memb AMBA bus 8 bit memory read access list a range of addresses memh AMBA bus 16 bit memory read access list a range of addresses vmemb AMBA bus 8 bit virtual...

Страница 18: ...0000018 10803401 ba 0x4000d01c start 24 0x4000001c ac102001 mov 1 l6 start 28 0x40000020 91d02000 ta 0x0 start 32 0x40000024 01000000 nop start 36 grmon3 dis main 0x40004070 9de3beb8 save sp 328 sp ma...

Страница 19: ...2 1 0 0 0 0000 84692 4000eae8 write 00000000 2 2 1 0 0 0 0000 84695 4000eaec write 00000000 3 2 1 0 0 0 0000 grmon3 reg INS LOCALS OUTS GLOBALS 0 80000200 00000000 00000000 00000000 1 80000200 0000000...

Страница 20: ...00 text 54 8kB 54 8kB 100 4000DB30 data 2 9kB 2 9kB 100 Total size 57 66kB 786 00kbit s Entry point 0x40000000 Image home daniel examples v8 stanford exe loaded grmon3 profile on grmon3 run Starting P...

Страница 21: ...u0 fpu f1 1 984328031539917 grmon3 puts cpu1 fpu f1 2 3017966689845248e 18 NOTE Non MP software can still run on the first CPU unaffected of the additional CPUs since it is the target software that is...

Страница 22: ...This enables loops variables procedures scripts arithmetics and more for the user I a it also provides an API for the user to extend GRMON 3 5 1 Shells GRMON creates several independent TCL shells ea...

Страница 23: ...cl API for a detailed description of the API 3 6 Symbolic debug information GRMON will automatically extract the symbol information from ELF files debug information is never read from ELF files The sy...

Страница 24: ...with GRMON via GDB GDB must be built for the SPARC architecture a native PC GDB does not work together with GRMON The toolchains that Cobham Gaisler distributes comes with a patched and tested versio...

Страница 25: ...0003e3c AHB read mst 0 size 2 9610001a gdb 3 7 3 Running applications from GDB To load and start an application use the GDB load and run command sparc rtems gdb v8 stanford exe gdb target extended rem...

Страница 26: ...free to change and redistribute it There is NO WARRANTY to the extent permitted by law Type show copying and show warranty for details This GDB was configured as host i686 pc linux gnu target sparc rt...

Страница 27: ...ware you are free to change and redistribute it There is NO WARRANTY to the extent permitted by law Type show copying and show warranty for details This GDB was configured as host i686 pc linux gnu ta...

Страница 28: ...n _Thread_Dispatch at rtems threaddispatch c 109 3 Thread 167837697 UI1 ready 0x4002f760 in _Thread_Dispatch at rtems threaddispatch c 109 2 Thread 151060481 Int ready 0x4002f760 in _Thread_Dispatch a...

Страница 29: ...e MMU one typically have an image with physical addresses used to load data into the memory and a second image with debug symbols of virtual addresses It is therefore important to make sure that the M...

Страница 30: ...ed gdb break leon_init_timers Breakpoint 2 at 0xf03cff14 file home user linuxbuild 1 0 2 linux linux 2 6 git arch sparc kernel leon_kernel c line 116 gdb cont Continuing Breakpoint 2 leon_init_timers...

Страница 31: ...me exist at that point 3 7 9 GRMON GUI considerations The Graphical User Interface of GRMON can be used in parallel with GDB C C level debugging More details are described in Section 4 7 C C level deb...

Страница 32: ...rtems 5 0 rtems 4 12 rtems 4 11 rtems 4 10 rtems 4 8 rtems 4 6 3 8 2 GRMON thread commands thread info lists all threads currently available in the operating system The currently running thread is mar...

Страница 33: ...text in GRMON which is inserted into the UART receive FIFO These insertions will trigger interrupts if receiver FIFO interrupts are enabled This makes it possible to use GRMON as a terminal when runn...

Страница 34: ...ia the TCB field in MCFG3 3 10 2 LEON3 FT error injection All RAM blocks cache and register file memory in LEON3 FT are Single Event Upset SEU protected Error injection function emulates SEU in LEON3...

Страница 35: ...edac commandline option using the mcfg3 command or setting the register bit via the TCL variable mctrl mcfg3 pe When programming 32 bit EDAC checkbits it is required that no other AHB master is acces...

Страница 36: ...and for the complete syntax below are some typical use cases exemplified When interacting with a memory device via SPICTRL the driver assumes that the clock scaler settings have been initialized to at...

Страница 37: ...out the the data over the debug link For this to work safely without the need to stop execution some arbitration over the data has to be implemented such as a wait free software FIFO As an example the...

Страница 38: ...lock seconds puts format Test executed d seconds expr tend tstart set exec_ok 0 foreach result results if result SIGTERM set exec_ok 1 if exec_ok 1 puts PASS tname else incr nfail 1 puts FAIL tname re...

Страница 39: ...er and I O register inspection and edit views Optimized SPARC LEON IU register view Basic execution control such as single stepping continuing breaking Application launch dialog Tcl terminal views wit...

Страница 40: ...o connect to the target system It allows for selecting the debug link and parameters which system initialization See Figure 4 2 The System Configurations is split into several tabs which group related...

Страница 41: ...urrent tab is shown in the box Switching tabs will show different argument contributions Note that the debug link always contributes with an argument to the Argument contribution box For example choos...

Страница 42: ...mage launch type is appropriate for applications that will use a single core In the Single Core Target Image Launch properties are always assigned to the first cpu An SMP Target Image Launch provides...

Страница 43: ...e added as required The following list describes all available properties Properties Image File name of an image file to load More than one image can be added and each image can be assigned to any num...

Страница 44: ...ng images Multiple ranges can be defined by adding more Wash Memory properties The property is not CPU specific Command wash Stack Pointer Entrypoint Override stack pointer or entry point setting An a...

Страница 45: ...the visualization e g Hex Integer Show disassembly at address If no disassembly editors are open one will be opened otherwise any opened will be used The editor will focus on the selected register va...

Страница 46: ...are to be shown in the view Unless another view or operation requires the values of the registers to be loaded the values are not retrieved until they are visible in the view The register values are...

Страница 47: ...ges are expected in the available IP cores or their related information all the information can be retrieved anew from the system by pressing the Refresh button As default the view shows only basic in...

Страница 48: ...aracters such as Ctrl C to break execution and tab for auto completion among many Other examples are arrow up and down to access previous entries This also means that copy paste can t be done via keyb...

Страница 49: ...obal and always operate on physical addresses no MMU translation is performed by the Memory View 4 5 6 Disassembly View Disassembly View provides a convenient method to inspect the instruction memory...

Страница 50: ...d will disassemble virtual memory as determined by the current CPU or thread context 4 5 7 Messages View The Messages view displays messages from the application that may be helpful for the user The m...

Страница 51: ...rface it is not possible to alter processor state or breakpoints without destroying GDB s internal representation Doing so will leave GDB in an undefined state and cause various GDB C C level issues W...

Страница 52: ...uart device Connect to the target system using a serial cable user Connect to the target system using a custom user defined library 8 16 bit access to the target system is only supported by the JTAG...

Страница 53: ...16 32 64 edclus us Increase the EDCL timeout before resending a packet Use this option if you have a large network delays The default IP address of the EDCL is normally determined at synthesis time T...

Страница 54: ...e the characteristics described above the scanning of the plug and play area may fail For such systems the AHBJTAG version assumed by GRMON during plug and play scanning can be set with the switch jta...

Страница 55: ...MON can also connect to these boards using the xilusb switch Extra options for Xilinx USB Platform cable xilusb Connect to the target system using a Xilinx USB Platform cable xilmhz 12 6 3 1 5 0 75 Se...

Страница 56: ...GRMON3 UM June 2019 Version 3 1 0 56 www cobham com gaisler...

Страница 57: ...Xilinx Platform USB cable with both GRMON and iMPACT Figure 5 2 The libusb win32 filter installer wizard may have to be run again if the Xilinx Platform USB cable is connected to another USB port or...

Страница 58: ...sion to the device file This can be achieved by creating a udev rules file etc udev rules d 51 ftdi rules containing the lines below and then reconnect the USB cable ATTR idVendor 0403 ATTR idProduct...

Страница 59: ...for Actel FlashPro fpro Connect to the target system using the Actel FlashPro cable Windows 5 3 7 Digilent HS1 JTAG debugging using a Digilent JTAG HS1 cable is supported on Linux and Windows systems...

Страница 60: ...mmc devmgmt msc in the run field of the start menu 2 In the device manager find the unknown device Right click on it to open the menu and choose Update Driver Software as Figure 5 4 shows Figure 5 4 3...

Страница 61: ...ion path address Comma separated list of addresses spa spa1 spa2 spa12 The source path address Comma separated list of addresses dkey key The destination key used by the targets RMAP interface Default...

Страница 62: ...ble module pointed out by the filename parameter dbackarg arg Set a custom argument to be passed to the user defined debug link during start up 5 6 1 API The loadable module must export a pointer vari...

Страница 63: ...backwards compatibility This function is replaced by the function init int close Called when disconnecting int setbaud int baud int pp Not used provided only for backwards compatibility int init char...

Страница 64: ...g units during GRMON s system initialization The GRCLKGATE core is accessed using the command grcg see command description in Appendix B Command syntax for more information 6 2 1 Switches cginit mask...

Страница 65: ...n at Print AHB transfer entries in the trace buffer bp Add delete or list breakpoints bt Print backtrace cctrl Display or set cache control register cont Continue execution cpu Enable disable CPU or s...

Страница 66: ...enables the user to read and write Ethernet PHY registers The info sys command displays the core s configuration settings greth0 Cobham Gaisler GR Ethernet MAC AHB Master 2 APB C0100100 C0100200 IRQ...

Страница 67: ...witches nousbrst Prevent GRMON from automatically resetting the USB host controller cores 6 6 2 Commands The drivers for the USB host controller cores provides the commands listed in Table 6 3 Table 6...

Страница 68: ...to inject check bit errors and to read out error detection information L2 Cache is enabled by default when GRMON starts This behavior can be disabled by giving the nl2c com mand line option which inst...

Страница 69: ...ounter one to count instruction cache misses on processor zero Example 6 1 grmon3 l4stat 1 events icmiss icache miss itmiss icache tlb miss ichold icache hold ithold icache mmu hold dcmiss dcache miss...

Страница 70: ...miss 0000000000 disabled 1 cpu0 dcache miss 0000000000 disabled 2 cpu0 load instructions 0000000000 disabled 3 cpu0 store instructions 0000000000 disabled grmon3 l4stat 1 runpoll 0 3 5000 Setting up...

Страница 71: ...its to input By default GRMON will setup the GPIO dir register to enable both UARTs for the AT697E F sys agga4 Disable plug and play scanning and configure GRMON for an AGGA4 system agga4 nognss Disab...

Страница 72: ...s PC133 SDRAM Controller PC133 SDRAM debug drivers provides switches for timing It also probes the memory during GRMON s initial ization In addition it also enables the sdcfg1 affects that sets the re...

Страница 73: ...e for memory configuration register 2 MCTRL FTMCTRL mcfg3 val Set the reset value for memory configuration register 3 MCTRL FTMCTRL SSRCTRL pageb Enable SDRAM page burst FTMCTRL normw Disables read mo...

Страница 74: ...s enabled on GR740 during GRMON initialization GR740 SDCTRL 6 14 2 Commands The driver for the Debug support unit provides the commands listed in Table 6 4 Table 6 4 MEMCTRL commands ddr2cfg1 Show or...

Страница 75: ...order to perform BC data transfers you must have a temporary buffer in memory to store descriptors and data this is set up with the mil buf command The data transfer commands use the asynchronous sche...

Страница 76: ...en and enables subaddress 30 in loop back mode with logging The RT event log is then polled and events arriving are printed out to the console The command exits after 60 seconds of inactivity In the B...

Страница 77: ...e Primary 0 Secondary 2 Subordinate 2 I O BASE 0x00001000 LIMIT 0x00001fff ENABLED MEMIO BASE 0x82200000 LIMIT 0x822fffff ENABLED MEM BASE 0x82100000 LIMIT 0x821fffff ENABLED Bus 0 Slot c function 0 0...

Страница 78: ...3 M1535 M1543 PCI to ISA Bridge Aladdin IV V V Bus 0 Slot 3 function 0 0x18 Vendor id 0x10b9 ULi Electronics Inc Device id 0x5457 M5457 AC 97 Modem Controller IRQ INTA LINE 0 BAR 0 82205000 4kB BAR 1...

Страница 79: ...struments device 0xac23 PCI2250 PCI to PCI Bridge class 060400 PCI PCI BRIDGE Primary 0 Secondary 2 Subordinate 2 I O Window 00001000 00002000 MEMIO Window 82200000 82300000 MEM Window 82100000 822000...

Страница 80: ...idge AHB Master 5 AHB C0000000 D0000000 AHB FFF00000 FFF40000 APB 80000600 80000700 IRQ 6 Trace buffer size 1024 lines pcitrace1 Cobham Gaisler GRPCI2 Trace buffer APB 80040000 80080000 Trace buffer s...

Страница 81: ...sler SVGA frame buffer AHB Master 2 APB C0800000 C0800100 clk0 25 00 MHz clk1 25 00 MHz clk2 40 00 MHz clk3 65 00 MHz The SVGACTRL core is accessed using the command svga see command description in Ap...

Страница 82: ...ull including company affiliation and site name and address Please identify exactly what product that is used specifying if it is an IP core with full name of the library distribution archive file com...

Страница 83: ...data cache dccfg Display or set data cache configuration register dcom Print or clear debug link statistics ddr2cfg1 Show or set the reset value of the memory register ddr2cfg2 Show or set the reset v...

Страница 84: ...A MP status information l2cache L2 cache control l3stat Control Leon3 statistics unit l4stat Control Leon4 statistics unit la Control the LOGAN core leon Print leon specific registers load Load a fil...

Страница 85: ...backtrace timer Show information about the timer devices tmode Select tracing mode between none processor only AHB only or both uhci Controll the USB host UHCI core usrsh Run commands in threaded use...

Страница 86: ...GRMON3 UM June 2019 Version 3 1 0 86 www cobham com gaisler Appendix B Command syntax This section lists the syntax of all documented commands available in GRMON3...

Страница 87: ...GRMON3 UM June 2019 Version 3 1 0 87 www cobham com gaisler 1 about syntax NAME about Show information about GRMON SYNOPSIS about DESCRIPTION about Show information about GRMON...

Страница 88: ...ahb filter addresses boolean address mask Enable or disable filtering options if supported by the DSU core When enabling the addresses filter the second AHB breakpoint register will be used to define...

Страница 89: ...00000800 91D02000 01000000 01000000 01000000 read 267007 00000810 91D02000 01000000 01000000 01000000 read TCL returns AHB 266718 0xFF900004 0x00000084 0x00000084 0x00000084 0x00000084 R 0 2 2 0 0 0...

Страница 90: ...starting at address If a transfer is already in progress then the command will fail with the error code set to EBUSY amem wait name Wait for an access to finish The command returns when handle name i...

Страница 91: ...on 3 1 0 91 www cobham com gaisler grmon3 amem list NAME STATE ADDRESS LENGTH PRIO NREQ BYTES ERRORS myhandle IDLE 4 1 1048576 0 test0 DONE 0x00000004 0x00000064 4 1 100 0 SEE ALSO mem Section 3 4 7 D...

Страница 92: ...tach syntax attach Stop execution and attach GRMON to processor again SYNOPSIS attach DESCRIPTION attach This command will stop the execution on all CPUs that was started by the command detach and att...

Страница 93: ...f left out then the address and mask will be ignored They can also be set with the command at filter range at filter range address mask devname Set the base address and mask that the AHB trace buffer...

Страница 94: ...read TCL returns AHB 266718 0xFF900004 0x00000084 0x00000084 0x00000084 0x00000084 R 0 2 2 0 0 0 0 0 AHB 266727 0xFF900000 0x0000000D 0x0000000D 0x0000000D 0x0000000D W 0 2 2 0 0 0 0 0 AHB 266760 0x00...

Страница 95: ...ets up the variables argv0 argv and argc in the global namespace While executing the scrip argv0 will contain the script filename argv will contain a list of all the arguments that appear after the fi...

Страница 96: ...dump command may be used to store memory contents a binary file It s an alias for dump binary bdump address length filename Dumps length bytes starting at address to a file in binary format The defaul...

Страница 97: ...t belongs to The options is specified below OPTIONS delay ms The delay option can be used to specify a delay between each word written If the delay is non zero then the maximum block size is 4 bytes b...

Страница 98: ...p watch options address mask cpu Create a hardware watchpoint The options read write can be used to make it watch only reads or writes by default it will watch both reads and writes bp bus options add...

Страница 99: ...the options is negative RETURN VALUE Command bp returns an breakpoint id when adding a new breakpoint When printing all breakpoints a list will be returned containing one element per breakpoint Each...

Страница 100: ...ALUE Upon successful completion bt returns a list of tuples where each tuple consist of a PC and SP register values EXAMPLE Show backtrace on current active CPU grmon3 bt TCL returns 1073746404 134217...

Страница 101: ...cpu cctrl flush cpu DESCRIPTION cctrl value cpu Display or set cache control register cctrl flush cpu Flushes both instruction and data cache RETURN VALUE Upon successful completion cctrl will return...

Страница 102: ...ported by DSU4 OPTIONS noret Do not evaluate the return value Then this options is set no return value will be set RETURN VALUE Upon successful completion cont returns a list of signals one per CPU Po...

Страница 103: ...or status cpu enable cpuid cpu disable cpuid Enable disable the specified CPU cpu active cpuid Set current active CPU RETURN VALUE Upon successful completion cpu returns the active CPU and a list of b...

Страница 104: ...emory Optionally a specific way or line can be checked dcache flush cpu Flushes the data cache dcache way windex lindex cpu Show the contents of specified way windex or optionally a specific line lind...

Страница 105: ...data cache configuration register for the active CPU GRMON will not keep track of this register value and will not reinitialize the register when starting or resuming software execution RETURN VALUE...

Страница 106: ...com gaisler 16 dcom syntax NAME dcom Print or clear debug link statistics SYNOPSIS dcom dcom clear DESCRIPTION dcom dcom clear Print debug link statistics Clear debug link statistics RETURN VALUE Upo...

Страница 107: ...et value of the memory register SYNOPSIS ddr2cfg1 value DESCRIPTION ddr2cfg1 value Set the reset value of the memory register If value is left out then the reset value will be printed RETURN VALUE Upo...

Страница 108: ...et value of the memory register SYNOPSIS ddr2cfg2 value DESCRIPTION ddr2cfg2 value Set the reset value of the memory register If value is left out then the reset value will be printed RETURN VALUE Upo...

Страница 109: ...et value of the memory register SYNOPSIS ddr2cfg3 value DESCRIPTION ddr2cfg3 value Set the reset value of the memory register If value is left out then the reset value will be printed RETURN VALUE Upo...

Страница 110: ...et value of the memory register SYNOPSIS ddr2cfg4 value DESCRIPTION ddr2cfg4 value Set the reset value of the memory register If value is left out then the reset value will be printed RETURN VALUE Upo...

Страница 111: ...et value of the memory register SYNOPSIS ddr2cfg5 value DESCRIPTION ddr2cfg5 value Set the reset value of the memory register If value is left out then the reset value will be printed RETURN VALUE Upo...

Страница 112: ...l delays A value can be specified to calibrate each data byte separately The value is written to the 16 LSB of the DDR2 control register 3 ddr2delay reset Set the delay to the default value ddr2delay...

Страница 113: ...s DESCRIPTION ddr2skew inc steps ddr2skew dec steps Increment decrement the delay with one step Commands inc and dec can optionally be given the number of steps to increment decrement as an argument d...

Страница 114: ...GRMON3 UM June 2019 Version 3 1 0 114 www cobham com gaisler...

Страница 115: ...bham com gaisler 24 detach syntax detach Resume execution with GRMON detached from processor SYNOPSIS detach DESCRIPTION detach This command will detach GRMON and resume execution on enabled CPUs RETU...

Страница 116: ...sassemble address length cpu Disassemble memory If length is left out it defaults to 16 and the address defaults to current PC value Symbols may be used as address disassemble r start stop cpu Disasse...

Страница 117: ...can be used to store data to a binary file bsize The bsize option may be used to specify the size blocks of data in bytes that will be read Sizes that are not even words may require a JTAG based debug...

Страница 118: ...addr2line addr cpu This command will lookup the filename and line number for a given address dwarf clear cpu Remove all dwarf debug information to the active CPU or a specific CPU RETURN VALUE Upon su...

Страница 119: ...set otherwise the command will print the current EDCL ip The EDCL will be disabled if the ip address is set to zero and enabled if set to a normal address If more than one device exists in the system...

Страница 120: ...hey will be placed at the base address of the detected RAM The cpu argument can be used to specify which CPU it belongs to The options is specified below OPTIONS binary The binary option can be used t...

Страница 121: ...TION ehci endian devname Displays the endian conversion setting ehci capregs devname Displays contents of the capability registers ehci opregs devname Displays contents of the operational registers eh...

Страница 122: ...he SEU correction counters are modified This option should not be used with software which itself monitors SEU error counters ei prob ei prob itag dtag idata ddata stag iurf fprf cpu Show or set proba...

Страница 123: ...GRMON3 UM June 2019 Version 3 1 0 123 www cobham com gaisler dcache...

Страница 124: ...able is and it marks the end of options It should be used if a symbol name is in conflict with a subcommand i e a symbol called disable ep disable cpu Remove the entry point from the current active CP...

Страница 125: ...be used to manage execution hooks grmon execsh eval arg arg Evaluate command arg in the execution shell If a script is running then the command will fail with the error result set to EBUSY grmon execs...

Страница 126: ...syntax NAME exit Exit the GRMON application SYNOPSIS exit code DESCRIPTION exit code Exit the GRMON application GRMON will return 0 or the code specified RETURN VALUE Command exit has no return value...

Страница 127: ...lash memory at the time If there are multiple CFI compatible flash memories connected to the PROM area then it is possible to switch device using the command flash scan addr If the PROM width or bank...

Страница 128: ...swell If the address argument is present then binary files will be compared against data at this address if left out then they will be compared to data at the base address of the detected RAM The bina...

Страница 129: ...ham com gaisler EXAMPLE A typical command sequence to erase and re program a flash memory could be grmon3 flash unlock all grmon3 flash erase all grmon3 flash load file prom grmon3 flash lock all SEE...

Страница 130: ...registers SYNOPSIS float DESCRIPTION float Display FPU registers RETURN VALUE Upon successful completion float returns 2 lists The first list contains the values when the registers represents floats...

Страница 131: ...el Enable I O forwarding for a device If a custom channel is not specified then the default channel for the shell will be enabled The I O forwarding configuration is stored per shell forward disable d...

Страница 132: ...y listen to the specified port Default port is 2222 gdb stop Stop the built in GDB remote server gdb status Print status RETURN VALUE Only the command gdb status has a return value Upon successful com...

Страница 133: ...f the count parameter is set then the CPU will run the specified number of instructions Note that the count parameter is only supported by the DSU4 OPTIONS noret Do not evaluate the return value Then...

Страница 134: ...0 134 www cobham com gaisler 40 gr1553b syntax gr1553b MIL STD 1553B Interface commands SYNOPSIS gr1553b subcommand args DESCRIPTION The gr1553b command is an alias for the mil command See help of co...

Страница 135: ...ists the controller names grcg clkinfo grcg Show register values grcg enable number grcg grcg disable number grcg Enable or disable a clock gate Argument number may be replaced by the keyword all RETU...

Страница 136: ...grpwm Control GRPWM core SYNOPSIS grpwm subcommand args DESCRIPTION grpwm info devname Displays information about the GRPWM core grpwm wave devname Displays the waveform table RETURN VALUE Command grp...

Страница 137: ...set Reset DMA and TM encoder grtmtx release Release TM encoder grtmtx rate rate Set rate register grtmtx len nbytes Set frame length actual number of bytes grtmtx limit nbytes Set limit length actual...

Страница 138: ...the graphical user interface This command has not effect if the GUI has already been started gui status Print status for the GUI connection RETURN VALUE Only the command gui status has a return value...

Страница 139: ...and SYNOPSIS help command DESCRIPTION help command When omitting the command parameter this command will list commands If the command parameter is specified it will print a long detailed description o...

Страница 140: ...0021D4 restore o0 o0 0000000D 266954 000019E4 mov 0 g1 00000000 266955 000019E8 mov g1 i0 00000000 266956 000019EC ret 000019EC 266957 000019F0 restore 00000000 266960 0000106C call 0x00009904 0000106...

Страница 141: ...is specified then a simple write will be performed Commands to interact with DVI transmitters i2c dvi devices List supported devices i2c dvi delay direction Change delay applied to clock before latch...

Страница 142: ...he memory Optionally a specific way or line can be checked icache flush cpu Flushes the instruction cache icache way windex lindex cpu Show the contents of specified way windex or optionally a specifi...

Страница 143: ...struction cache configuration register for the active CPU GRMON will not keep track of this register value and will not reinitialize the register when starting or resuming software execution RETURN VA...

Страница 144: ...that can be used to access the registers via TCL variables It also returns a list of all the register names No registers values will be read Setting a will also return the address in the list of all t...

Страница 145: ...CPU0 win 8 hwbp 2 itrace 256 V8 mul div srmmu lddel 1 GRFPU stack pointer 0x07fffff0 icache 4 4 kB 32 B line lru dcache 4 4 kB 32 B line lru CPU1 win 8 hwbp 2 itrace 256 V8 mul div srmmu lddel 1 GRFPU...

Страница 146: ...mplementations RETURN VALUE Upon successful completion inst returns a list of trace buffer entries Each entry is a sublist on the format format INST time addr inst result trap em mc Detailed descripti...

Страница 147: ...N3 UM June 2019 Version 3 1 0 147 www cobham com gaisler INST 266951 0x000021D4 0x91E80008 0x0000000D 0 0 0 INST 266954 0x000019E4 0x82102000 0x00000000 0 0 0 SEE ALSO Section 3 4 9 Using the trace bu...

Страница 148: ...ag Write full cache line including tag at set address addr i e the number of data words depends on the size of the cache line See example below iommu disable iommu enable Disables enable the core iomm...

Страница 149: ...otection bit Command iommu cache addr returns a tuple containing valid and protection bits Command iommu cache show returns a list of entries Each entry contains line address tag and the cached data w...

Страница 150: ...and also support the ASMP extension provided in the IRQ A MP core irq boot mask Boot CPUs specified by mask for IRQ A MP irq ctrl index Show select controller register interface to use for IRQ A MP ir...

Страница 151: ...l2cache flush direct address mode Perform a cache flush to the cache lines addressed with address using a flush mode l2cache invalidate Invalidate all cache lines l2cache flushinvalidate Flush and in...

Страница 152: ...For data each entry contains an address and 8 data words The entry for tag contains index address LRU and list of valid bit dirty bit and tag for each way Upon successful completion l2cache ft l2cach...

Страница 153: ...when disabling it be left out l3stat poll start stop interval hold Continuously poll counters between start and stop The interval parameter sets how many seconds between each iteration If hold is set...

Страница 154: ...when disabling it be left out l4stat poll start stop interval hold Continuously poll counters between start and stop The interval parameter sets how many seconds between each iteration If hold is set...

Страница 155: ...umps the trace buffer in VCD format to the file specified default is logan vcd la mask trigl bit value logan Sets displays the specified bit in the mask of the specified trig level to 0 1 la page valu...

Страница 156: ...GRMON3 UM June 2019 Version 3 1 0 156 www cobham com gaisler SEE ALSO Section 6 13 On chip logic analyzer driver...

Страница 157: ...GRMON3 UM June 2019 Version 3 1 0 157 www cobham com gaisler 58 leon syntax NAME leon Print leon specific registers SYNOPSIS leon DESCRIPTION leon Print leon specific registers...

Страница 158: ...rgument is specified then only that CPU will be listed load show cpu This command will list which files that have been loaded to the CPU s If the cpu argument is specified then only that CPU will be l...

Страница 159: ...GRMON3 UM June 2019 Version 3 1 0 159 www cobham com gaisler SEE ALSO Section 3 4 2 Uploading application and data to target memory...

Страница 160: ...cfg1 syntax mcfg1 Show or set reset value of the memory controller register 1 SYNOPSIS mcfg1 value DESCRIPTION mcfg1 value Set the reset value of the memory register If value is left out then the rese...

Страница 161: ...cfg2 syntax mcfg2 Show or set reset value of the memory controller register 2 SYNOPSIS mcfg2 value DESCRIPTION mcfg2 value Set the reset value of the memory register If value is left out then the rese...

Страница 162: ...cfg3 syntax mcfg3 Show or set reset value of the memory controller register 3 SYNOPSIS mcfg3 value DESCRIPTION mcfg3 value Set the reset value of the memory register If value is left out then the rese...

Страница 163: ...dio paddr raddr greth DESCRIPTION mdio paddr raddr greth Show value of PHY address paddr and register raddr If more than one device exists in the system the greth can be used to select device default...

Страница 164: ...Other debug links will do a 32 bit read and then parse out the unaligned data OPTIONS ascii If the ascii flag has been given then a single ASCII string is returned instead of a list of values cstr If...

Страница 165: ...Other debug links will do a 32 bit read and then parse out the unaligned data OPTIONS ascii If the ascii flag has been given then a single ASCII string is returned instead of a list of values cstr If...

Страница 166: ...given then a single ASCII string is returned instead of a list of values cstr If the cstr flag has been given then a single ASCII string up to the first null character is returned instead of a list o...

Страница 167: ...dr Set address of temporary buffer for transfer commands mil bufmode mode Select if the temporary buffer should be kept or restored Valid mode values are keep or restore mil get rtaddr subaddr count P...

Страница 168: ...e MMU from the current active CPU and the cpu can be used to select a different CPU RETURN VALUE The commands mmu returns a list of the MMU registers The commands mmu va and mmu walk returns the trans...

Страница 169: ...RMON3 UM June 2019 Version 3 1 0 169 www cobham com gaisler 0x00620000 0x00620fff r xr x 1 0x00621000 0x00621fff 0x00621000 0x00621fff crwx 1 SEE ALSO Section 3 4 14 Memory Management Unit MMU support...

Страница 170: ...of stdout of a command SYNOPSIS nolog command args DESCRIPTION nolog command args The nolog command be put in front of other GRMON commands to suppress the logging of the output This can be useful to...

Страница 171: ...ad and writing PCI devices configuration space easier The Tcl variables are named in a similar fashion to AMBA devices for example puts pdev0 status prints the STATUS register of PCI device0 See pci b...

Страница 172: ...e name pdev 3 host It s allowed to skip the bus index i e only specifying slot func it will then default to bus index 0 The ID numbers are specified in hex If host is given the Host Bridge Controller...

Страница 173: ...hey return their values The pci trace log command returns a list of triples where the triple contains the address a list of signals and buffer index Command pci trace state returns a tuple of the addr...

Страница 174: ...isler 71 perf syntax perf Measure performance SYNOPSIS perf perf subcommand args DESCRIPTION The performance command is only available when a DSU4 exists in the system perf Display result perf disable...

Страница 175: ...lt PHY address SYNOPSIS phyaddr adress greth DESCRIPTION phyaddr adress greth Set the default PHY address to address If more than one device exists in the system the greth can be used to select device...

Страница 176: ...will profile the application being executed on the system profile Show profiling information for all CPUs or specified CPU When printing the information for all the CPUs only a single table with the s...

Страница 177: ...SYNOPSIS quit DESCRIPTION quit When using the command line version cli of GRMON this command will be the same as exit 0 In the GUI version it will close down a single console window Use exit to close...

Страница 178: ...isters o0 o1 o2 o3 o4 o5 o6 o7 Special purpose registers sp fp Windows N is the number of implemented windows w0 w1 wN Single register from a window w1l3 w1o3 w2i5 etc In addition the following non wi...

Страница 179: ...ow 2 f1 pc and w1 grmon3 reg g0 w2l3 f1 pc w1 TCL returns 0 0 0 0 0 1073741824 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 Set register g1 to the value 2 and display register g2 gr...

Страница 180: ...an opportunity to reset themselves into a known state For example will the memory controllers reset it s registers to their default value and some drivers will turn off DMA It is in many cases crucial...

Страница 181: ...is loaded into a procedure in the system shell The procedure is executed in init level 6 therefore it is possible to override the script in level 5 by redefining the the fdir init procedure using the...

Страница 182: ...uence The RTG4 SERDES initcode is loaded into a procedure in the system shell The procedure is executed in init level 6 therefore it is possible to override the script in level 5 by redefining the the...

Страница 183: ...nt parameter is set then the CPU will run the specified number of instructions Note that the count parameter is only supported by the DSU4 OPTIONS noret Do not evaluate the return value When this opti...

Страница 184: ...ub patttern word1 word2 Write pattern words into the scrubbers initialization register If the number of words specified are larger then the size if the burst length then the remaining words be ignored...

Страница 185: ...sdcfg1 syntax sdcfg1 Show or set reset value of SDRAM controller register 1 SYNOPSIS sdcfg1 value DESCRIPTION sdcfg1 value Set the reset value of the memory register If value is left out then the rese...

Страница 186: ...une 2019 Version 3 1 0 186 www cobham com gaisler 82 sddel syntax sddel Show or set the SDCLK delay SYNOPSIS sddel value DESCRIPTION sddel value Set the SDCLK delay value SEE ALSO Section 6 14 Memory...

Страница 187: ...OO2 SmartFusion2 DDR initcode is loaded into a procedure in the system shell The proce dure is executed in init level 6 therefore it is possible to override the script in level 5 by redefining the the...

Страница 188: ...IGLOO2 SmartFusion2 SERDES initcode is loaded into a procedure in the system shell The proce dure is executed in init level 6 therefore it is possible to override the script in level 5 by redefining t...

Страница 189: ...shell The grmon shell command is just an alias for the TCL com mand exec wrapped with puts i e its equivalent to puts exec For more information see doc umentation about the exec command http www tcl...

Страница 190: ...d args DESCRIPTION silent command args The silent command be put in front of other GRMON commands to suppress their output and it will not be logged This can be useful to remove unnecessary output whe...

Страница 191: ...address length filename Dumps length bytes starting at address of the SPI device i e not AMBA address to a file The default name of the file is grmon spiflash dump srec spim flash erase spim flash era...

Страница 192: ...present then binary files will be compared with data at the address of the SPI device i e not AMBA address oth erwise binary files will be compared against data at the beginning of the device The bin...

Страница 193: ...in Mode register Available fields cpol cpha div16 len value amen loop ms pm value tw asel fact od tac rev aseldel value tto igsel cite spi slvsel value Set slave select register spi status Displays c...

Страница 194: ...the slave select register When the device is deselected GRMON will write all ones to the slave select register Example Set slave select line 0 to low all other lines high when selecting a device grmon...

Страница 195: ...MPLE Set AM configuration register grmon3 spi am cfg strict ovdb Set AM period register grmon3 spi am per 1000 Poll queue 10 times grmon3 spi am poll 10 Set fields in Mode register grmon3 spi set ms c...

Страница 196: ...sical or logical can be used to filter out ports Options nh can be used to suppress the printing of the header spwrtr rt add options port dst spwrtr Enable one more destination ports to the routing ta...

Страница 197: ...tial stack pointer or the CPU specified by cpu stack address cpu Set the current active CPUs initial stack pointer or the CPU specified by cpu RETURN VALUE Upon successful completion stack returns a l...

Страница 198: ...hen only the specified CPU index will be stepped When single stepping over a conditional or unconditional branch with the annul bit set and if the delay instruction is effectively annulled the delay i...

Страница 199: ...and it is safe to access CPU registers immediately after If nowait option is given the command will not block until the CPU execution stop request has been completed Instead the command will return im...

Страница 200: ...w file bitdepth The svga draw command will determine the resolution of the specified picture and select an appropriate format resolution and refresh rate based on the video clocks available to the cor...

Страница 201: ...ns and objects are listed The optional argument cpu can be used to limit the listing for a specific CPU Options global List global symbols local List local symbols func List functions object List obje...

Страница 202: ...mbols list List all loaded symbols grmon3 symbols list all List all function symbols grmon3 symbols list func local global List all symbols that begins with the letter m grmon3 puts lsearch index 3 su...

Страница 203: ...n number name Name of the thread current Boolean describing if the thread is the current running thread pc Program counter sp Stack pointer cpu Value greater or equal to 0 means that the thread is exe...

Страница 204: ...name This command will show information about the timer device Optionally which device to show information about can be specified Device names are listed in info sys timer reg devname This command wil...

Страница 205: ...ode proc boolean cpu DESCRIPTION tmode Print the current tracing mode tmode none Disable tracing tmode both Enable both AHB and instruction tracing tmode ahb boolean Enable or disable AHB transfer tra...

Страница 206: ...SYNOPSIS uhci subcommand args DESCRIPTION uhci endian devname Displays the endian conversion setting uhci opregs devname Displays contents of the I O registers uhci reset devname Performs a Host Contr...

Страница 207: ...be evaluated in the background and GRMON will return to the prompt If the option std in combination with option bg then output from the background operation will be forwarded to the current shells std...

Страница 208: ...GRMON3 UM June 2019 Version 3 1 0 208 www cobham com gaisler SEE ALSO Section 3 5 Tcl integration...

Страница 209: ...dress SYNOPSIS va address cpu DESCRIPTION va address cpu Translate a virtual address The command will use the MMU from the current active CPU and the cpu can be used to select a different CPU RETURN V...

Страница 210: ...used to force GRMON to stop verifying when num errors have been found bsize bytes The bsize option may be used to specify the size of blocks of data in bytes that will be read Sizes that are not even...

Страница 211: ...nly JTAG debug links supports byte accesses Other debug links will do a 32 bit read and then parse out the unaligned data OPTIONS ascii If the ascii flag has been given then a single ASCII string is r...

Страница 212: ...nly JTAG debug links supports byte accesses Other debug links will do a 32 bit read and then parse out the unaligned data OPTIONS ascii If the ascii flag has been given then a single ASCII string is r...

Страница 213: ...rned off this command will behave like the command vwmem OPTIONS ascii If the ascii flag has been given then a single ASCII string is returned instead of a list of values cstr If the cstr flag has bee...

Страница 214: ...MMU exists or if it is turned off this command will behave like the command vwmemb NOTE Only JTAG debug links supports byte accesses Other debug links will do a 32 bit read modi fy write when writing...

Страница 215: ...U exists or if it is turned off this command will behave like the command vwmemh NOTE Only JTAG debug links supports byte accesses Other debug links will do a 32 bit read modi fy write when writing un...

Страница 216: ...ified by data including the terminating NULL character If no MMU exists or if it is turned off this command will behave like the command vwmems NOTE Only JTAG debug links supports byte accesses Other...

Страница 217: ...they will be stored at consecutive physical addresses If no MMU exists or if it is turned off this command will behave like the command vwmem OPTIONS bsize bytes The bsize option may be used to speci...

Страница 218: ...on SYNOPSIS walk address cpu DESCRIPTION walk address cpu Translate a virtual address and print translation The command will use the MMU from the current active CPU and the cpu can be used to select a...

Страница 219: ...and set each word to value The parameter value defaults to 0 OPTIONS delay ms The delay option can be used to specify a delay between each word written nic Disable the instruction cache while washing...

Страница 220: ...addr raddr value greth DESCRIPTION wmdio paddr raddr value greth Set value of PHY address paddr and register raddr If more than one device exists in the system the greth can be used to select device d...

Страница 221: ...ll be stored at consecutive addresses NOTE Only JTAG debug links supports byte accesses Other debug links will do a 32 bit read modi fy write when writing unaligned data OPTIONS bsize bytes The bsize...

Страница 222: ...be stored at consecutive addresses NOTE Only JTAG debug links supports byte accesses Other debug links will do a 32 bit read modi fy write when writing unaligned data OPTIONS bsize bytes The bsize op...

Страница 223: ...e string value specified by data including the terminating NULL character to address NOTE Only JTAG debug links supports byte accesses Other debug links will do a 32 bit read modi fy write when writin...

Страница 224: ...ddress If more than one data word has been specified they will be stored at consecutive addresses OPTIONS bsize bytes The bsize option may be used to specify the size blocks of data in bytes that will...

Страница 225: ...iple shells GRMON creates the following shells sys System shell exec Execution shell cli Command line interface shell term GUI terminal shell is replaced by a number gdb GDB remote server shell Exampl...

Страница 226: ...n be used in scripts A list of the variables can be found below grmon_version The version number of GRMON grmon_shell The name of the shell grmon settings suppress_output The variable is a bitmask to...

Страница 227: ...vname 1 pnp ahb 0 mask devname 1 pnp ahb 0 type devname 1 pnp ahb custom0 devname 1 pnp ahb custom1 devname 1 pnp ahb custom2 devname 1 pnp ahb irq devname 1 pnp ahb idx devname 1 pnp apb start devnam...

Страница 228: ...apptr devname 1 res0 devname 1 res1 devname 1 rombar devname 1 iline devname 1 ipin devname 1 min_gnt devname 1 max_lat devname 1 bridge_ctrl If the PCI bus has been registered into the GRMON s device...

Страница 229: ...up script To uninstall hooks either remove the procedure name from the list using the Tcl lreplace or delete the variable using unset to uninstall all hooks Hooks in the system shell can only be unins...

Страница 230: ...alue definitions for the hook procedure Argument Type Description bus integer Bus index slot integer Slot index func integer Function index ofs integer Offset into the device s configuration space siz...

Страница 231: ...ormat 0x x pci cfg16 0 1 0 0 4 User defined driver It is possible to extend GRMON with user defined drivers by implementing certain hooks and variables in Tcl GRMON scans the namespace drivers for use...

Страница 232: ...requested register It s required to be implemented if the variable regs is implemented NOTE If the variable regs is implemented then the procedure regaddr is required namespace eval drivers mydrv The...

Страница 233: ...he fields are quadruple of the format name pos bits description Registers and fields can be added removed or changed up to initialization level 8 After level 8 TCL variables are created and the regs v...

Страница 234: ...low grxml Parents Children grlib Attribute Description version Version of the XML syntax grlib Parents grxml Children bus Attribute Description build GRLIB build identification number device GRLIB dev...

Страница 235: ...r address 0x20000000 length 0x20000000 bar address 0x40000000 length 0x40000000 slave AHB APB Bridge slave vendor 0x1 device 0x6 bar address 0x80000000 length 0x100000 bus type APB ffactor 1 000000 LE...

Страница 236: ...uing a UDP broadcast to local subnets on port 1947 If broadcasting is not working or unwanted then advanced network settings can be setup via the Sentinel Admin Control Center The Sentinel Admin Contr...

Страница 237: ...stem variables will affect all users Select the desired variable and press Edit to edit the variable value If the variable does not exist a new can be created by pressing the button New To append the...

Страница 238: ...ine options The GRMON 2 0 options leon2 at697 at697e at697f agga4 are no longer available Corresponding options in GRMON3 are sys leon2 sys at697 sys at697e sys at697f sys agga4 Execution hooks Execut...

Страница 239: ...document is current before using this product Cobham does not assume any responsibility or liability arising out of the application or use of any product or service described herein except as expressl...

Отзывы:

Нет отзывов