manualshive.com logo in svg

COBHAM GRMON3, User Manual

Share
Download
COBHAM GRMON3 User Manual Download Page 236

GRMON3-UM
June 2019, Version 3.1.0

236

www.cobham.com/gaisler

Appendix E. License key installation

GRMON is licensed using a Sentinel LDK USB hardware key and has support for node-locked and floating license
keys. The type of key can be identified by the color of the USB dongle. The node-locked keys are purple and the
floating license keys are red.

1. Node-locked keys (purple USB key)

For node-locked keys, the Sentinel LDK Run-time for the key must be installed before the key can be used (see
below).

2. Floating keys (red USB key)

In the case of floating keys, the Sentinel LDK Run-time must be installed on the server and the client computer
(see below).

Sentinel LDK communicates via TCP and UDP on socket 1947. This socket is IANA-registered exclusively for
this purpose. By default the client will find the server by issuing 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 Control Center is accessed by opening the url localhost:1947 in an webbrows-
er.  The  network  settings  are  reached  by  selecting  "Configuration"  in  the  menu  and  then  selecting  the  "Access
to Remote License Managers" tab. Detailed information on how to setup the network settings can be found by
selecting "Help" in the menu.

3. Sentinel LDK Runtime

The latest runtime can be found at the GRMON download page. Included in the downloaded Sentinel LDK runtime
archive is a README file which contains detailed installation instructions. However, ignore all instructions about
installing 

haspvlib_<vendorID>.so

 and/or 

haspvlib_x86_64_<vendorID>.so

.

Administrator privileges are required on Windows. On Linux it is required that the runtime is installed as root user.

GRMON download page  [http://www.gaisler.com/index.php/downloads/debug-tools]

Summary of Contents for GRMON3

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 56: ...GRMON3 UM June 2019 Version 3 1 0 56 www cobham com gaisler...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 114: ...GRMON3 UM June 2019 Version 3 1 0 114 www cobham com gaisler...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 123: ...GRMON3 UM June 2019 Version 3 1 0 123 www cobham com gaisler dcache...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 156: ...GRMON3 UM June 2019 Version 3 1 0 156 www cobham com gaisler SEE ALSO Section 6 13 On chip logic analyzer driver...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 208: ...GRMON3 UM June 2019 Version 3 1 0 208 www cobham com gaisler SEE ALSO Section 3 5 Tcl integration...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Reviews:

No comments

Brands by name

Popular brands

Load more brands