Hardware monitor and debugger for LEON, NOEL-V and GRLIB SoC Systems GRMON3 GRMON3 User's Manual Document: GRMON3-UM Cobham Gaisler AB June 2021, Version 3.2.13 Kungsgatan 12 | SE-41119 Gothenburg | Sweden +46 31 7758650 | www.cobhamaes.com/gaisler Table of Contents 1. Introduction .......................................................................................................................... 4 1.1. Overview ................................................................................................................... 4 1.2. Supported platforms and system requirements ................................................................... 4 1.3. Obtaining GRMON ...................................................................................................... 4 1.4. Installation ................................................................................................................. 4 1.5. License ...................................................................................................................... 5 1.6. NOEL-V Support ........................................................................................................ 5 1.6.1. Limitations ....................................................................................................... 5 1.7. GRMON Evaluation version .......................................................................................... 5 1.8. Problem reports ........................................................................................................... 5 2. Debugging concept ................................................................................................................. 6 2.1. Overview ................................................................................................................... 6 2.2. Target initialization ...................................................................................................... 6 2.3. Memory register reset values ......................................................................................... 8 2.4. Hardware reset ............................................................................................................ 8 3. Operation .............................................................................................................................. 9 3.1. Overview ................................................................................................................... 9 3.2. Starting GRMON ........................................................................................................ 9 3.2.1. Debug link options ............................................................................................ 9 3.2.2. Debug driver options ......................................................................................... 9 3.2.3. General options ............................................................................................... 10 3.3. GRMON command-line interface (CLI) ......................................................................... 11 3.4. Common debug operations .......................................................................................... 12 3.4.1. Examining the hardware configuration ................................................................ 12 3.4.2. Uploading application and data to target memory .................................................. 13 3.4.3. Running applications ........................................................................................ 13 3.4.4. Inserting breakpoints and watchpoints ................................................................. 14 3.4.5. Displaying processor registers ............................................................................ 15 3.4.6. Backtracing function calls ................................................................................. 15 3.4.7. Displaying memory contents ............................................................................. 16 3.4.8. Instruction disassembly ..................................................................................... 17 3.4.9. Using the trace buffer ...................................................................................... 17 3.4.10. Profiling ....................................................................................................... 18 3.4.11. Attaching to a target system without initialization ................................................ 19 3.4.12. Multi-processor support .................................................................................. 19 3.4.13. Stack and entry point ..................................................................................... 20 3.4.14. Memory Management Unit (MMU) support ....................................................... 20 3.4.15. CPU cache support ........................................................................................ 20 3.5. Tcl integration ........................................................................................................... 21 3.5.1. Shells ............................................................................................................ 21 3.5.2. Commands ..................................................................................................... 21 3.5.3. API ............................................................................................................... 21 3.6. Symbolic debug information ........................................................................................ 22 3.6.1. Multi-processor symbolic debug information ........................................................ 22 3.7. GDB interface ........................................................................................................... 23 3.7.1. Connecting GDB to GRMON ............................................................................ 23 3.7.2. Executing GRMON commands from GDB ........................................................... 23 3.7.3. Running applications from GDB ........................................................................ 23 3.7.4. Running SMP applications from GDB ................................................................. 24 3.7.5. Running AMP applications from GDB ................................................................ 25 3.7.6. GDB Thread support ........................................................................................ 26 3.7.7. Virtual memory ............................................................................................... 27 3.7.8. Specific GDB optimization ............................................................................... 29 3.7.9. Limitations of GDB interface ............................................................................ 29 3.8. Thread support .......................................................................................................... 30 3.8.1. GRMON thread options .................................................................................... 30 3.8.2. GRMON thread commands ............................................................................... 30 3.9. Forwarding application console I/O ............................................................................... 31 Document: GRMON3-UM Cobham Gaisler AB June 2021, Version 3.2.13 2 Kungsgatan 12 | SE-41119 Gothenburg | Sweden +46 31 7758650 | www.cobhamaes.com/gaisler 3.10. FLASH programming ............................................................................................... 32 3.10.1. CFI compatible Flash PROM ........................................................................... 32 3.10.2. SPI memory device ........................................................................................ 33 3.11. Automated operation ................................................................................................. 33 3.11.1. Tcl commanding during CPU execution ............................................................. 34 3.11.2. Communication channel between target and monitor ............................................ 34 3.11.3. Test suite driver ............................................................................................ 34 4. Debug link .......................................................................................................................... 36 4.1. UART debug link ...................................................................................................... 36 4.2. Ethernet debug link .................................................................................................... 37 4.3. JTAG debug link ....................................................................................................... 37 4.3.1. Xilinx parallel cable III/IV ................................................................................ 38 4.3.2. Xilinx Platform USB cable ............................................................................... 38 4.3.3. Altera USB Blaster or Byte Blaster .................................................................... 41 4.3.4. FTDI FT4232/FT2232 ...................................................................................... 41 4.3.5. Amontec JTAGkey .......................................................................................... 42 4.3.6. Actel FlashPro 3/3x/4/5 .................................................................................... 42 4.3.7. Digilent HS1/HS2/HS3/SMT2/SMT3 .................................................................