devwiki_user
16
edits
Changes
no edit summary
This Application Note is associated with the [[https://www.dave.eu/en/news-and-media/news/multicore-debug-and-trace-su-nxp-imx8|this webinar]] organized by Lauterbach Italy, DAVE Embedded Systems, and NXP.
==Chapter 2Linux SMP debugging and trace==The following sections describe how to configure the Lauterbach TRACE32® debugger to support debug and trace of Linux running on the quad-core i.MX 8M Application Processor by NXP Semiconductors.
==== Debug and offchip trace via PCIe (PCI express) ====* LA-3505 PowerDebug PRO Ethernet + LA-3520 PowerTrace Serial 4 GigaByte for ARM-ETM* LA-3743 Debugger for Cortex-A/R (Armv8 and Armv9)* LA-3550X License for PCI Express* LA-3522 Accessories for PTSerial for ARM-ETM 7-8Lanes* LA-3527 PTSERIAL-PCIe x1 Slot-Card-Converter* TRACE32 PowerView for ARM (Release ≥ Sep 2020, Software Version: R.2020.09.000128638)* <u>Optional:</u> LA-7844X Debug Cortex-M (ARMv6/7/8 32-bit) Ext.* <u>Optional:</u> LA-7949 Analog Probe for PI/PT-II/CP/MicroTrace[[File:TBDLauterbach offchip trace via PCIe.png|thumb|center|600pxframeless|Esempio di immagine783x783px]]''TRACE32 PowerDebug PRO, PowerTrace Serial, PTSERIAL-PCIe x1 Slot-Card-Converter, MITO 8M board''
==Chapter x=TRACE32 configuration ===In an SMP system the tasks are dynamically assigned by an SMP operating system to the cores. For debugging SMP systems, only one TRACE32 instance is opened and all cores are controlled from this instance. TRACE32 PowerView distinguishes two types of information:* Core-specific information which is displayed on a colored background. Typical core-specific information are: register contents, source listing of the code currently executed by the core, the stack frame. TRACE32 PowerView uses predefined color settings for the cores. * Information common for all cores, which is displayed on a white background. Typical common information are: memory contents, values of variables, breakpoint setting.A selector is available to switch the core-specific information to a selected core.[[File:TRACE32 selector.png|center|frame]] On an SMP system the program execution on all cores is started with Go and stopped with Break. The same onchip breakpoints are programmed by the debugger at the same time to all cores. If a breakpoint is hit, TRACE32 selects the core on which the breakpoint occurred. === Startup scripts ===For more details about the PRACTICE batch language, please refer to https://www.lauterbach.com/manual.html:* Training PRACTICE manual (training_practice.pdf)* PRACTICE Script Language User´s Guide (practice_user.pdf)* PRACTICE Script Language Reference Guide (practice_ref.pdf) === Setting up the Linux debug configuration ===The symbolic information is useful for HLL debugging, or setting breakpoints, stepping through the code, viewing variables, and many other aspects of debugging. The compiler must be configured in order to generate debug symbols. The vmlinux file for the running kernel must be available, in order to load the kernel debug symbols. No instrumentation is needed in the kernel source code for debugging with Lauterbach debuggers, but it’s important that the vmlinux file is generated from the same kernel build as the zImage or uImage running on the system. Specific (TrOnchip) options must be configured to avoid automatic Break of TRACE32 debugger, in case PageAbort or DataAbort events happen due to normal Linux operations. In the following paragraphs, the basic TRACE32 Linux configuration will be introduced. For more details, please refer to https://www.lauterbach.com/manual.html:* Training Linux Debugging manual (training_rtos_linux.pdf)* RTOS Debugger for Linux - Stop Mode manual (rtos_linux_stop.pdf) ==== Kernel awareness ====The TRACE32 RTOS kernel awareness technology makes the debugger aware of the OS running in the target system. Debug is significantly simplified, as the user can immediately access all the components of the OS and the applications. The Executable and Linkable Format (ELF) binary image, created at kernel build time, is also used by the TRACE32 kernel awareness for Linux. While configuring the TRACE32 kernel awareness for Linux, a specific menu file for Linux can be loaded which includes many useful menu items developed for the TRACE32 GUI to ease Linux debugging.[[File:TRACE32 Linux menu.png|center|frame]] ==== MMU support ====In Linux embedded, the Lauterbach debuggers provide a very tight integration with the RTOS. The kernel awareness supports the Linux MMU format and is able to handle virtual memory addressing. To provide full debugging possibilities, the debugger has to know how virtual addresses are translated to physical addresses. If an OS that runs several processes at the same logical addresses (e.g. Linux) is used, the hardware MMU in the CPU only holds translation tables that allow the debugger memory accesses to the code/data of the kernel and the currently running process. The OS itself maintains the translation tables for all processes, because the OS is responsible for the reprogramming of the hardware MMU on a process switch. The debugger can access code/data from a not currently running process using the information from the OS MMU tables. An automatic table-walk method is available in TRACE32, walking through the OS MMU tables to find a valid logical-to-physical translation, in case it’s not already cached in TRACE32.[[File:TRACE32 MMU page tables reduced.png|center|frame]] ==== Debug of kernel modules ====The Linux kernel can be compiled to allow linking of additional modules at runtime (kernel objects). The Lauterbach debuggers also support kernel modules debugging, starting from the initialization function.[[File:TRACE32 debug of kernel modules.png|center|frame]] ==== Debug of user processes, threads, shared objects ====User process debugging is also available, starting from the very beginning of the process. If the process loads shared objects, they are loaded in the process address space when the related instructions are executed for the first time (demand paging). The Lauterbach debuggers also support debug of threads for multithreaded processes. In this case, the same address space is shared between different threads and the symbolic information can be loaded only once per process. In general, the same techniques used for debugging kernel code, such as setting breakpoints, stepping through code, watching variables, and viewing memory contents, can be performed in the same way for processes and tasks. Virtual address spaces are distinguished in TRACE32 using the concept of spaceID. The memory addressing is extended using the lower 16 bit of the process PID, allowing in this way to distinguish between equal virtual addresses for different processes.[[File:TRACE32 debug of user process.png|center|frame]] ==== Program trace ====The ETM (Embedded Trace Macrocell) is an ARM CoreSight component which outputs program (and optionally data) trace information about the cores’ activity. The ETM trace information can be stored internally (onchip trace) or externally (offchip trace) using an external recording device. In TRACE32 many trace views are available: each trace window will follow the time / record synchronization of other trace windows, if the option /Track is used. Many statistical views are also available. For more details, please refer to https://www.lauterbach.com/manual.html:* ARM-ETM Training manual (training_arm_etm.pdf) ===== Onchip trace =====The NXP chip i.MX 8M implements the ETF (Embedded Trace FIFO) and the ETR (Embedded Trace Router) which are CoreSight hardware component providing onchip trace functionality.* The ETF is a FIFO for trace data on the chip to moderate the peak bandwidth the trace sinks need to handle. The ETF can alternatively be used as ETB (Embedded Trace Buffer) to store trace data on chip.* The ETR can send the trace data stream to a memory location on the AXI bus: in this way you can use the DRAM as a big onchip trace memory.The trace data can be read out via JTAG, when the trace recording has ended.[[File:TRACE32 onchip trace.png|center|frame]] ===== Offchip trace: TPIU =====The ETM trace information can be combined with other trace sources or passed directly offchip to the Trace Port Interface Unit (TPIU). There it will be captured by a trace port analyzer (ETM Preprocessor). The Lauterbach ETM preprocessors implement an AutoFocus technology which calibrates the trace-data sampling points in order to compensate for the effects of wave reflections, component tolerances, different trace lengths, limited pad driver capabilities, signal coupling, affecting the sampling of high-speed parallel buses.[[File:TRACE32 offchip trace.png|center|frame]][[File:TRACE32 offchip trace part 2.png|center|frame]] ===== Offchip trace: PCIe =====PowerTrace Serial is an extension to the debug module TRACE32 PowerDebug PRO and offers a trace memory of up to 4 GByte, which can record trace data conveyed offchip via a serial trace port. The i.MX 8M Application Processor implements a PCIe Gen 2 interface which allows to reach a speed of 5GT/s. The PowerTrace Serial can be configured as PCIe end-point and its PCIe memory can be mapped in the ETR. In this way the program flow trace exported via ETR can be stored offchip in the PowerTrace Serial memory. [[File:TRACE32 PCIe.png|center|frame]] === Energy profiling ===Using a Lauterbach Analog Probe, it’s possible to measure up to 4 voltage channels (1 at a time, shared with current channels) and 3 current channels (1 at a time, shared with voltage channels; shunt resistor required). The MITO 8M carrier board is equipped with a connector compatible with the Analog Probe layout. This allows to profile the energy consumed by the running application, performing an analysis of the instantaneous power consumption, which can be correlated with the program flow trace. The purpose is:* to detect unexpected consumption peaks* to check the power saving modes* to optimize the code to reduce energy consumptionSpecific views are available in TRACE32 to analyze the instantaneous power and energy consumed for a given function. Additional settings are available for triggering: e.g. voltage or current are greater / smaller than upper / lower limits.[[File:TRACE32 energy profiling.png|center|frame]] === Summary view ===In the pictures below, all the concepts previously discussed are shown as a summary global view of TRACE32 debugger.[[File:TRACE32 summary view.png|center|frame]] === Lauterbach References ===[[File:Logo Lauterbach.png|frame]]This chapter has been written by the Lauterbach italian branch office. <u>Contact information:</u> Lauterbach SRL Via Caldera 21 20153 Milan (Italy) Tel. +39 02 45490282 Email [[info_it@lauterbach.it]] Web [https://www.lauterbach.com www.lauterbach.it]
