QNX SDP 8.0 Raspberry Pi Screen Board Support: Release Notes

Screen support packages contain the display and GPU libraries and drivers needed to extend the general base screen package for a particular board support package (BSP). For compatibility, all the board, base, screen, and extended screen support packages, should be based on the QNX Software Development Platform 8.0 (SDP 8.0).

QNX SDP 8.0 is a cross-compiling and debugging environment, including an IDE and command-line tools, for building binary images and programs for ARM v8 and x86_64 targets running the QNX OS 8.0.

Throughout this document, you may see reference numbers associated with particular issues or changes. When corresponding with our Technical Support staff about an issue, use the relevant reference number. You might also find the reference numbers useful for tracking issues as they become fixed.

Notes, updates, and user guides can be found for any package through the QNX Software Center under Properties. BSP information is also available online at the QNX SDP 8.0 BSP Documentation site (https://www.qnx.com/developers/docs/BSP8.0/com.qnx.doc.bsp.nav/topic/about.html). This includes user guides, release notes, guides such as BSP Graphics Basics.

Package version

The Raspberry Pi screen support build retrieves required support packages from the downloaded distribution package as dependencies, including the following:

To see the exact contents of the package, right-click it in the QNX Software Center, choose Properties, then click Package Contents in the Properties window.

Board support

The Screen Board Support package was validated on the Raspberry Pi 5 with the following QNX SDP 8.0 base screen support package:

The following platform is supported in this release:

Known issues

These are the known issues for this release:

BSP Integration

To add base graphics capabilities to your BSP (without input or video capture):

1. Add the following libraries to the BSP buildfile:

   #########################################################################
   # Screen files to add
   #########################################################################
   /lib/dll/screen-debug.so=screen-debug.so/lib/dll/screen-gles2blt.so=screen-gles2blt.so
   /lib/dll/screen-stdbuf.so=screen-stdbuf.so
   /lib/dll/screen-sw.so=screen-sw.so
   /lib/libmemobj.so=libmemobj.so
   /lib/libscrmem.so=libscrmem.so
   /sbin/screen=screen/usr/lib/libdrm.so.2=libdrm.so.2
   
   #########################################################################
   # Screen applications to add
   #########################################################################
   /usr/bin/gles2-gears=gles2-gears
   /usr/bin/sw-vsync=sw-vsync
   /usr/bin/gles2-teapot=gles2-teapot
   /usr/bin/gles3-gears=gles3-gears
   
   /usr/lib/libdrm2.so=libdrm2.so
   #########################################################################
   # Board Specific graphics files for RPI5 target
   #########################################################################
   /sbin/drm-rpi5=drm-rpi5
   /usr/lib/graphics/drm-rpi5/EGL-mesa.so=graphics/drm-rpi5/EGL-mesa.so
   /usr/lib/graphics/drm-rpi5/GLESv2-mesa.so=graphics/drm-rpi5/GLESv2-mesa.so
   /usr/lib/graphics/drm-rpi5/broadcom_icd.json=graphics/drm-rpi5/broadcom_icd.json
   /usr/lib/graphics/drm-rpi5/glapi-mesa.so=graphics/drm-rpi5/glapi-mesa.so
   /usr/lib/graphics/drm-rpi5/gpu_rpi5.so=graphics/drm-rpi5/gpu_rpi5.so
   /usr/lib/graphics/drm-rpi5/graphics-rpi5-2xhdmi.conf=graphics/drm-rpi5/graphics-rpi5-2xhdmi.conf
   /usr/lib/graphics/drm-rpi5/graphics-rpi5-hdmi1.conf=graphics/drm-rpi5/graphics-rpi5-hdmi1.conf
   /usr/lib/graphics/drm-rpi5/graphics-rpi5-hdmi2.conf=graphics/drm-rpi5/graphics-rpi5-hdmi2.conf
   /usr/lib/graphics/drm-rpi5/graphics-rpi5-virtual.conf=graphics/drm-rpi5/graphics-rpi5-virtual.conf
   /usr/lib/graphics/drm-rpi5/libWFDrpi5.so=graphics/drm-rpi5/libWFDrpi5.so
   /usr/lib/graphics/drm-rpi5/libwfdcfg-rpi5.so=graphics/drm-rpi5/libwfdcfg-rpi5.so
   /usr/lib/graphics/drm-rpi5/screen-alloc-rpi5.so=graphics/drm-rpi5/screen-alloc-rpi5.so
   /usr/lib/graphics/drm-rpi5/v3d_dri.so=graphics/drm-rpi5/v3d_dri.so
   /usr/lib/graphics/drm-rpi5/vulkan_broadcom.so=graphics/drm-rpi5/vulkan_broadcom.so"
                       

2. Add the following binaries and configuration files to the BSP buildfile:

   $BUILDFILE_BINS_CONFIGS
   #######################################################################
   ## Start the screen graphics
   #######################################################################
   [perms=0755] /scripts/graphics_start.sh = {
       #!/bin/sh
       LD_LIBRARY_PATH=/lib:/usr/lib:/lib/dll:/lib/dll/pci:/proc/boot:/usr/lib/graphics/drm-rpi5
       PATH=/sbin:/bin:/usr/sbin:/usr/bin:/opt/sbin:/opt/bin:/proc/boot
       
       echo "Starting screen"
       sleep 6
       screen -c /usr/lib/graphics/drm-rpi5/graphics-rpi5-2xhdmi.conf
       waitfor /dev/screen
   }
                       

3. At the beginning of the buildfile in the .bootstrap. section, update the LD_LIBRARY_PATH to include the /usr/lib/graphics/drm-rpi5 location, by inserting the bolded text from the following code example.

   [+keeplinked] PATH=/proc/boot:/bin:/usr/bin:/sbin:/usr/sbin: LD_LIBRARY_PATH=/proc/boot:/lib:/usr/lib:/lib/dll:/usr/lib/graphics/drm-rpi5 procnto-smp-instr -v
                       

Technical support

To obtain technical support for any QNX product, visit the Support area on our website: https://blackberry.qnx.com/en/support. You'll find a range of support options.

For product experience and roadmap information, please contact QNX Product Management.