TRACE32 Documents... ICD In-Circuit Debugger... Processor Architecture Manuals... ARM/CORTEX/XSCALE... RAM Trace Port Overview... 2 FAQ...

Transcription

1 RAM Trace Port TRACE32 Online Help TRACE32 Directory TRACE32 Index TRACE32 Documents... ICD In-Circuit Debugger... Processor Architecture Manuals... ARM/CORTEX/XSCALE... RAM Trace Port... 1 Overview... 2 FAQ... 3 Quick Start... 5 Commands... 7 RTP Ram trace port (RTP) 7 RTP.CLEAR Clear tracebuffer 7 RTP.DirectDataMode Simple trace mode 8 RTP.DirectDataMode.Mode Direct data mode read/write 8 RTP.DirectDataMode.Width Trace width in bits 8 RTP.HaltOnOverflow Halt system on RTP FIFO overflow 9 RTP.Mode Select the trace mode 9 RTP.OFF Disables the RTP module 9 RTP.ON Activates the RTP module 10 RTP.PortSize Size of RTP data port 10 RTP.Register Display the RTP register 10 RTP.PortClock Configure RTPCLK 11 RTP.RESet Resets RTP settings 11 RTP.state Display RTP setup 12 RTP.TraceMode Complex trace mode 13 RTP.TraceMode.RAM<x>.SECTion<y> Configures a trace region 13 RTP.TraceMode.TraceExclude Invert all trace regions 14 Products Product Information 15 Order Information 15 RAM Trace Port 1

2 RAM Trace Port Version 16-Nov-2018 Overview The main purpose of the Ram Trace Port (RTP) is to allow for non-intrusive tracing of write- or read accesses to the internal RAMs of Texas Instruments (TI) automotive microcontrollers. Besides that, also CPU controlled data tracing is supported. In the non-intrusive mode - called TraceMode - the RTP module is capable of tracing three different RAMs as well as the peripheral bus. Tracing of each RAM (or peripheral bus) in turn is limited to two independent trace regions, which makes a total of eight different trace regions. In order to configure these trace regions, RTP commands starting with RTP.TraceMode must be used. Trace data can also be generated by writing to a dedicated capture register via CPU or DMA. This mode in turn is called DirectDataMode and can be configured via the RTP.DirectDataMode commands. It is worth mentioning that the DirectDataMode also can be used to trace data reads from the RAMs of the microcontroller; however the TraceMode should be preferred to that kind of configuration of the DirectDataMode. RAM Trace Port 2

3 FAQ TMS470/TMS5 70 Address exceeds maximum size What does the error message "Address exceeds maximum size" mean? Every address within the trace region defined by base address + size must not exceed 18 bits (RAM) or 24 bits (peripheral), respectively. Ref: 0351 TMS470/TMS5 70 address matched to blocksize What does the warning "Entered address has been corrected to match the current blocksize" mean? The base address of the section to be traced must always be a multiple of the specified blocksize. If not, it will automatically be truncated to the next lower valid address. Ref: 0353 TMS470/TMS5 70 Missing RAM/Periphera l address Ref: 0390 What does the error message "Internal error: No RAM/Peripheral address defined for this CPU" mean? This error occurs if the base address of the RAM and/or peripheral address space is not configured for the current device. You can configure the base address(es) by the following PRACTICE commands: SYStem.CONFIG.RAMBASE <address>; RAM base address SYStem.CONFIG.PERBASE <address> ; Peripheral base address TMS470/TMS5 70 Target FIFO overflow Ref: 0354 How to avoid "TARGET FIFO OVERFLOW" error messages in the trace window? Increase the traceport data throughput via RTP.PortClock. Increase the frequency of the system clock (HCLK) in relation to the CPU clock (GCLK). Reduce the size of the RAM area to be traced via RTP.Trace- Mode.RAM<x>.SECTion<y>.Size. Include some 'nop' operations in the relevant parts of your target s executable code. RAM Trace Port 3

4 TMS540/TMS5 70 How to unlock the 'RTP' command? RTP command is locked Ref: 0389 RAM Trace Port 4

5 Quick Start 1. Turn off the target. 2. Please follow the hardware installation instructions in trace_arm_etm.pdf to set up the trace hardware. 3. If you are using the AutoFocus II preprocessor, follow the instructions under 4). For the AutoFocus 600 MIPI preprocessor proceed with 5). 4. AutoFocus II: Connect the plug of the preprocessor (LA-3905) marked TRACE A to the appropriate socket of the RTP to Mictor38 converter (LA-3835) using the mictor flex extension delivered with your preprocessor. Continue with 7). 5. AutoFocus 600 MIPI: Attach the header of the preprocessor (or flex extension LA-1228) to the MIPI 60 to Mictor38 converter (LA-3769). 6. AutoFocus 600 MIPI: Fit the MIPI 60 to Mictor 38 converter into the RTP to Mictor38 converter (LA-3835). 7. Depending on your target board and debug cable, either attach the debug cable to the target board directly or make use of the ARM-20 connector provided by the RTP to Mictor38 converter. 8. Attach the RTP to Mictor38 converter to the target. 9. Start the TRACE32 software. 10. Power up the target and connect to the target CPU. 11. Run your start-up script(s). 12. Make sure your target is stopped. 13. Configure the RTP module: - Optional: Configure the parallel ETM and RTP asynchronous mode: <trace>.porttype TPIU+RTP (AutoFocus II only). RAM Trace Port 5

6 - Run RTP.state to display the RTP setup window, and/or - Make use of the RTP commands described in the Commands section of this manual. 14. Execute some of the target s code. 15. Stop the target. 16. Display the trace data via RTPAnalyzer.List 17. In order to start a new trace, clear the current trace window via RTP.CLEAR. 18. It further on is recommended to read the trace documentation in general_ref_t.pdf. RAM Trace Port 6

7 Commands RTP Ram trace port (RTP).CLEAR.DirectDataMode.HaltOnOverflow.Mode.OFF.ON.PortClock.PortSize.Register.RESet.state.TraceMode RTP.CLEAR Clear tracebuffer RTP.CLEAR Clears the tracebuffer; all entries of the trace window will be removed..state RAM Trace Port 7

8 RTP.DirectDataMode Simple trace mode To activate either the complex or the simple trace mode, use the RTP.Mode command..directdatamode.mode.directdatamode.width.mode.state RTP.DirectDataMode.Mode Direct data mode read/write RTP.DirectDataMode.Mode [Read Write] Read (default) Write Traces data read operations on RAM (addresses are discarded). Writes to the Direct Data Mode Write register (RTPDDMW) are traced..directdatamode RTP.DirectDataMode.Width Trace width in bits RTP.DirectDataMode.Width [ ] Default: 8 Sets the number of bits to be traced per read- or write access. If the access width is greater than the configured trace width, the upper bits will be truncated. If on the other hand the access width is smaller than the configured trace width, the upper bits will be filled with indeterminate data..directdatamode RAM Trace Port 8

9 RTP.HaltOnOverflow Halt system on RTP FIFO overflow RTP.HaltOnOverflow [ON OFF] Default: OFF If [OFF], data written to an already full RTP FIFO will be discarded. Otherwise the initiator of a data write (CPU or DMA) will be kept in a halted state until the FIFO is ready to receive new data..state RTP.Mode Select the trace mode RTP.Mode [TraceMode DirectDataMode] Default: TraceMode TraceMode DirectDataMode Selects one of the two possible trace modes (RTP.TraceMode and RTP.DirectDataMode commands)..directdatamode.state.tracemode RTP.OFF Disables the RTP module RTP.OFF Simply turns off the RTP module..state RAM Trace Port 9

10 RTP.ON Activates the RTP module RTP.ON The RTP module is enabled..state Commands in RAM Trace Port RTP.PortSize Size of RTP data port RTP.PortSize [ R 4R 8R 16R] Default: 2 Defines the number of parallel RTP data pins. Suffix R denotes a remapped pin configuration that matches the pinout of the RTP to Mictor38 converter (LA-3835)..state RTP.Register Display the RTP register RTP.Register [<file>] [/<option>] <option>: SpotLight DualPort Displays the RTP registers. SpotLight DualPort Highlight all changes on the control registers. Update control registers while the program is running. RAM Trace Port 10

11 RTP.Register RTP.Register permyrtp.per RTP.Register, /SpotLight ; display the RTP registers based ; on the description of the ; default PER-file ; display the RTP registers based ; on the description of the ; specified PER-file ; display the RTP registers based ; on the description of the ; default PER-file ; mark changes.state RTP.PortClock Configure RTPCLK RTP.PortClock [1/1 1/2 1/3 1/4 1/5 1/6 1/7 1/8] Default: 1/1 Sets the resulting frequency of RTPCLK, which is derived from HCLK: RTPCLK = [PortClock] * HCLK. HCLK must not exceed 100MHz..state RTP.RESet Resets RTP settings RTP.RESet Resets the RTP settings and the RTP module..state RAM Trace Port 11

12 RTP.state Display RTP setup RTP.state Displays the RTP setup window. A A For descriptions of the commands in the RTP.state window, please refer to the RTP.* commands in this chapter. Example: For information about ON, see RTP.ON..CLEAR.DirectDataMode.HaltOnOverflow.Mode.OFF.ON.PortClock.PortSize.Register.RESet.TraceMode RAM Trace Port 12

13 RTP.TraceMode Complex trace mode To activate either the complex or the simple trace mode, use the RTP.Mode command..tracemode.traceexclude.mode.state RTP.TraceMode.RAM<x>.SECTion<y> Configures a trace region RTP.TraceMode.RAM<x>.SECTion<y> <parameter> <x>: [1 2 3] <y>: [1 2] <parameter>: ACCess [ANY CPU DMA] Address <address> CYcle [Read Write] Size [OFF k 2k 4k 8k 16k 32k 64k 128k 256k] Configures section #<y> of RAM #<x>. In case a peripheral region instead of a RAM shall be traced, RTP.TraceMode.PER1.SECTion<y> must be used. ACCess [ANY CPU DMA] Address CYcle [Read Write] Size Defined whether only CPU, only DMA or both types of accesses to the specified RAM region are traced. (default: ANY) Base address of trace region. (default: 0) Either read- or write accesses to the specified RAM region are traced. (default: Read) Sets the size of the trace region. All data accesses to the RAM from RTP.TraceMode.RAM<x>.SECTion<y>.Address to RTP.TraceMode.RAM<x>.SECTion<y>.Address + RTP.TraceMode.RAM<x>.SECTion<y>.Size are traced. (default: OFF) NOTE: The size of the peripheral trace regions is limited to 128k. RAM Trace Port 13

14 ;Example configuration: ;CPU write accesses to RAM1 region 0x200 to 0x600 to be traced. RTP.TraceMode.RAM1.SECTion1.ACCess CPU RTP.TraceMode.RAM1.SECTion1.CYcle Write RTP.TraceMode.RAM1.Section1.Address 0x200 RTP.TraceMode.RAM1.SECTion1.Size 1k RTP.ON ; Only trace CPU ; accesses. Instead of ; SECTion1 also ; SECTion2 could be used. ; Only trace write ; accesses. ; Base address = 0x200 ; Trace region = 0x200 to ; 0x600 ; Turn on RTP module. RTP.TraceMode.TraceExclude Invert all trace regions RTP.TraceMode.INVert [ON OFF] OFF (default) ON Data accesses to regions defined by RTP.TraceMode.RAM<x>.SECTion<x>.Address and RTP.TraceMode.RAM<x>.SECTion<x>.Size are traced. Data accesses to the area outside the regions defined by RTP.TraceMode.RAM<x>.SECTion<x>.Address and RTP.TraceMode.RAM<x>.SECTion<x>.Size are traced..tracemode RAM Trace Port 14

15 Products Product Information OrderNo Code LA-3905 PP-RTP-AF-2 LA-3905A PP-RTP-AF-2-A LA-3835 CON-ARM-RTP Text Preproc. for RAM Trace Port AUTOFOCUS II Flex Preprocessor for RAM Trace Port on TI chips 500 MHz clock speed Variable threshold level and termination voltage, AUTOFOCUS self calibration technology, Supports 1.2 to 3.3V - else contact support Requires PowerTrace (PowerTrace Ethernet Version 6 or higher) May require LA-3835 Conv. Mictor38/RTP to Mictor38/ETM+JTAG20 Trace License for RAM Trace Port AUTOFOCUS II Supports off-chip RAM trace port for of TI chips if applied to an AUTOFOCUS II preprocessor please add the serial number of the preprocessor to your order AUTOFOCUS II Preprocessors with serial number C0806xxxxxx and lower have to be send to Lauterbach Germany for an hardware upgrade May require LA-3835 Conv. Mictor38/RTP to Mictor38/ETM+JTAG20 Conv. Mictor38/RTP to Mictor38/ETM+JTAG20 Converter from Mictor38 of RTP port of TI chips to Mictor38 of the ETM trace port plus JTAG 20 pin Order Information Order No. Code Text LA-3905 PP-RTP-AF-2 Preproc. for RAM Trace Port AUTOFOCUS II Flex LA-3905A PP-RTP-AF-2-A Trace License for RAM Trace Port AUTOFOCUS II LA-3835 CON-ARM-RTP Conv. Mictor38/RTP to Mictor38/ETM+JTAG20 RAM Trace Port 15