SPRADI3 June   2024 AM625 , AM62P , AM67 , AM67A , AM68 , AM68A , AM69 , AM69A , DRA829J , DRA829J-Q1 , DRA829V , DRA829V-Q1 , TDA4AEN-Q1 , TDA4AH-Q1 , TDA4AL-Q1 , TDA4AP-Q1 , TDA4VE-Q1 , TDA4VEN-Q1 , TDA4VH-Q1 , TDA4VL-Q1 , TDA4VM , TDA4VM-Q1 , TDA4VP-Q1

 

  1.   1
  2.   Abstract
  3.   Trademarks
  4. 1Introduction
  5. 2Common Issues with Graphics Applications
    1. 2.1 System or Application Freeze
      1. 2.1.1 Typical Kernel Panic Logs
    2. 2.2 Screen Tearing
    3. 2.3 Artifacts or Corruption in the Screen
    4. 2.4 Blank Screen
    5. 2.5 Low Frame Rate
    6. 2.6 GPU Driver Logs and Hardware Recoveries
      1. 2.6.1 Typical GPU HWR Logs
  6. 3Support Flow for Graphics Issues
    1. 3.1 Submit Preliminary Description
    2. 3.2 Determine if the Issue Reproduces on TI EVM
    3. 3.3 Provide Follow-Up Testing and Logs
  7. 4Tools for GPU Driver Debug
    1. 4.1 Driver Status in Linux® DebugFS
    2. 4.2 Driver AppHints
    3. 4.3 PVR Log Dump Collection
    4. 4.4 Adding Log Groups to Firmware Traces
    5. 4.5 Disabling the Driver After Hardware Recovery
    6. 4.6 Disable Autoloading of the GPU Driver
  8. 5Integrating Patched GPU Drivers
    1. 5.1 UM Libraries Installation
    2. 5.2 KM Libraries Installation
    3. 5.3 Post-Installation Steps
  9. 6Summary

Submit Preliminary Description

Now that a graphics-related issue has been identified, the following information needs to be collected for the next steps of the debug. The more complete this information is presented, the smoother the debug experience.

  1. Symptoms: What are the symptoms seen at the system level? At the console output? Section 2 detailed many of the common symptoms, and some can happen at the same time.
  2. Set up: How is the GPU used? Is the display a native Linux® display, or is this a remote display? Is this a vision processing pipeline in a RTOS plus Linux setup? What is the GPU driver and Software Development Kit (SDK) version used?
  3. Scenario: In what situation did this issue occur? Where there other processors running? Is the processing part of a larger vision processing pipeline or similar? Does the issue occur immediately after starting the application or after some time?
  4. Reproducibility: How easily can the issue be reproduced? Does the issue only happen on one board or does the issue happen on all boards? How long does the issue take to reproduce?
  5. Recovery: Does the issue recover without any intervention, or does the system stay in a crashed state?
  6. Logging: Please share all of the logs in the console and in the kernel (dmesg), or note that there are no logs when the failure happens.

This preliminary information is required throughout the debug and goes in tandem with the logs to identify the issue.