Last edited 3 months ago

Visual troubleshooting grid

Applicable for STM32MP13x lines, STM32MP15x lines, STM32MP25x lines

Some typical issues related to the visual domain are listed below. Solutions or debugging methods are proposed for these issues.

If your issue is not listed, try also looking in the articles in the visual or troubleshooting grids categories.


Symptom Resolution
DRM/KMS
 ./myQtApplication
Could not queue DRM page flip! (Permission denied)
Could not queue DRM page flip! (Permission denied)

The psplash-drm userland splash screen is running and is then the DRM master, avoiding other DRM applications to access to DRM/KMS. Stop this psplash-drm application with the command below before running your use case:

 psplash-drm-quit

Note: You may need to enter "export QT_QPA_EGLFS_ALWAYS_SET_MODE=1" before running your Qt application. For further information, refer to the Qt documentation.

 echo 32 > /sys/class/backlight/5a000000.dsi.0/brightness
sh: write error: No such device or address

On this board, the panel backlight is related to a MIPI® DSI panel. This backlight can be modified only if the panel is already powered on. That is probably not the case here.
The panel must restart before modifying its backlight. To do so, start any display-related application. For further information, refer to DRM KMS overview and Wayland Weston overview articles.

I/TC: Resumed
E/TC:0   tzc_it_handler:79 TZC permission failure
E/TC:0   dump_fail_filter:417 Overrun violation on filter 0
E/TC:0   dump_fail_filter:420 Permission violation on filter 0
E/TC:0   dump_fail_filter:425 Violation @0xdce1ff80, non-secure
unprivileged read, AXI ID 403
E/TC:0   Panic at core/arch/arm/plat-stm32mp1/plat_tzc400.c:84
<tzc_it_handler>
E/TC:0   TEE load address @ 0xde000000

This trace indicates that the TZC internal peripheral is detecting a "permission violation" made by the master whose AXI ID is 0x403. It corresponds to the LTDC internal peripheral (LTDC NSAID=0b0011. For further information, refer to the STM32 reference manuals).
Some Linux® Kernel DRM/KMS module drivers are probably missing in the system. As there is probably a display splashscreen in U-Boot, the LTDC display internal peripheral is clocked and is running. When the user initiates the power sequence, as there is no DRM/KMS driver in the system, the display-related clocks are not switched off. The LTDC then continues to make erratic illegal accesses to the memory, that are catched by the TZC internal peripheral. OP-TEE/TZC detects this abnormal behavior and then stops the system and logs this trace.
To fix this issue, please update your Linux® Kernel configuration with all the missing drivers.

 dmesg | grep -i ltdc
[  341.85] [drm] ltdc fifo underrun: please verify display mode
[ 1045.48] [drm] ltdc fifo underrun: please verify display mode

The "LTDC fifo underrun" messages occur when the LTDC input fifo is not filled fast enough. These messages may appear occasionally (during the display initialization for instance) and are often non-blocking. However, it happens that these messages are numerous, generating display problems like visual artifacts and this can come from:

  • the system configuration: maybe some parameters are missing or are incorrect in the DDR controller, the DDR driver or the AXI configuration
  • the system dynamic performance: maybe the dynamic voltage and frequency scaling (DVFS) policy is improper for the use case
  • a too high display pixel clock frequency due to a too important display resolution for the platform
  • a too complex display configuration using several LTDC "layers" for the display composition
  • a use case that is too “heavy” for the platform, using too much of the DDR bandwidth (high cpu load, large ethernet transfer, usb, gpu, npu...) and leaving too little DDR bandwidth for LTDC
  • a combination of the above cases

To fix this problem, check your DDR & AXI system parameters, adjust the DVFS policy, decrease the display resolution, use a single LTDC layer for the display composition, monitor the system with Linux monitoring tools and the DDR usage with DDRPERFM internal peripheral, "simplify" the use case...


GPU
 
[ 45.679109] Unhandled fault: imprecise external abort (0xc06) at 0xae1a0000
[ 45.684628] pgd = d1e98000
[ 45.687334] [ae1a0000] *pgd=d1e9f835, *pte=f8000747, *ppte=f8000c37
[ 45.693842] Unhandled fault: imprecise external abort (0xc06) at 0xae1a0000
[ 45.700480] pgd = d1dc0000
[ 45.703156] [ae1a0000] *pgd=00000000

Maybe the GPU reserved memory area in the kernel device tree is not aligned with the board DDR memory size. Have a look at the "gpu_reserved" entry in the kernel device tree, and update it if necessary.

Wayland / Weston
 glmark2-es2-wayland 
[11380.091100] reserved_mem_unmap_user: vm_munmap failed
eglCreateWindowSurface failed with error: 0x3003
Error: eglCreateWindowSurface failed with error: 0x3003
Error: CanvasGeneric: Invalid EGL state
Error: main: Could not initialize canvas
 weston-simple-egl
[11380.091100] reserved_mem_unmap_user: vm_munmap failed
has EGL_EXT_buffer_age and EGL_EXT_swap_buffers_with_damage
weston-simple-egl: ../git/clients/simple-egl.c:440: create_surface: 
  Assertion `ret == EGL_TRUE' failed.
Aborted (core dumped)
 weston-simple-egl
has EGL_EXT_buffer_age and EGL_EXT_swap_buffers_with_damage
Segmentation fault (core dumped) 

Weston is using pixman software composition instead of GPU hardware composition. This may be because you have not accepted the EULA at the beginning of the build...

 cat /etc/default/weston
WESTON_USER=weston
#Autogenerated
OPTARGS=--use-pixman

Please comment the "pixman" line in the file "/etc/default/weston"

 cat /etc/default/weston
WESTON_USER=weston
#Autogenerated
#OPTARGS=--use-pixman
 systemctl stop Weston-launch
Failed to stop Weston-launch.service: Unit Weston-launch.service not loaded.
 systemctl stop Weston-graphical-session
Failed to stop Weston-graphical-session.service: Unit Weston-graphical-session.service not loaded.

Please remove the capital letter in the word Weston. The correct command is:

 systemctl restart weston-graphical-session
 weston-simple-egl
weston-simple-egl: ../weston-10.0.0/clients/simple-egl.c:852: 
main: Assertion `display.display' failed.
Aborted (core dumped)
 glmark2-es2-wayland
Error: main: Could not initialize canvas

Weston is probably started with the "weston" user. The correct commands are:

 su -l "weston" -c "weston-simple-egl"
 su -l "weston" -c "glmark2-es2-wayland"
 systemctl stop Weston@root.service
Failed to stop Weston.service: Unit Weston.service not loaded.
 systemctl stop weston
Failed to stop weston.service: Unit weston.service not loaded.
 systemctl stop weston-launch
Failed to stop weston-launch.service: Unit weston-launch.service not loaded.

Please use the full Weston service named "weston-graphical-session". The correct command is:

 systemctl stop weston-graphical-session

Note: You can list all systemctl services with the following command:

 systemctl list-units | grep -i weston 
 weston-image mypicture.bmp
mypicture.bmp: unrecognized file header 0x42 0x4d 0x1e 0x51

"weston-image" small application supports only jpeg, png and webp image files. Please convert your ".bmp" image file into one of these supported image file formats.

Note: The official source code of "weston-image" is in the file image.c and the related error message is in image-loader.c.

 su -l weston -c weston-screenshooter
weston_screenshooter@5: error 0: screenshooter failed: permission denied. Debug protocol must be enabled

The Weston debug tool weston-screenshooter works only with Weston in debug mode. Add the following line to the file named "/etc/default/weston" to enable the Weston debug mode:

OPTARGS=--debug

Find more details in How to make a screen capture in Weston article.

Note: The Weston debug mode will be taken into account after a stop/start of the Wayland Weston service, please refer to How to stop and start Weston article.


GStreamer
There may be a timestamping problem, or this computer is too slow.

This message is typically displayed when the GStreamer A/V sync drops some frames. This may be due to a decoder that is too slow, badly timestamped buffers, or a badly formed container (.ts, .3gp, .mp4, .avi, ...).
To proceed with investigations, refer to the article How to profile video framerate.

Could not create Wayland display

HDMI TV not connected, please connect it.

 gst-play-1.0 /usr/local/myvideo.webm
Press 'k' to see a list of keyboard shortcuts.
Now playing /usr/local/myvideo.webm
WARNING Could not initialise Wayland output
WARNING debug information: ../gst-plugins-bad-1.20.1/ext/wayland/gstwaylandsink.c(368):
gst_wayland_sink_find_display (): /GstWaylandSink:waylandsink0:
Failed to create GstWlDisplay: 'Failed to connect to the wayland display '(default)

Weston is probably started with the "weston" user. The correct command is:

 su -l "weston" -c "gst-play-1.0 /usr/local/myvideo.webm"
Could not load BMP file

Make sure the loader of the bmp file format, libpixbufloader-bmp.so, is present in /usr/lib/gdk-pixbuf-2.0/2.10.0/. Otherwise, remove /usr/lib/gdk-pixbuf-2.0/2.10.0/loaders.cache, copy the libpixbufloader-bmp.so file from distrib build to /usr/lib/gdk-pixbuf-2.0/2.10.0/, then run "/usr/lib/gdk-pixbuf-2.0/gdk-pixbuf-query-loaders > /usr/lib/gdk-pixbuf-2.0/2.10.0/loaders.cache" to reload the loaders.