QNX Technical Articles

Date of this edition: July 21, 2020

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

Board Support Packages (BSP) are available for various hardware platforms on QNX SDP 7.1. This is a release note for the NXP SABRE Platform for Smart Devices BSP.

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

• Revision history
• Supported hardware
• Known issues
• Getting started with this BSP
• Technical support

Revision history

The following is a summary of the updates made to this BSP.

BuildID 433 (0.0.2.00433T202006241147E)

• Initial release that supports the following drivers:
  • Startup
  • Audio
  • Inter-integrated circuit (I2C)
  • MMC/SD driver
  • Network
  • PCI Server
  • QNX initial program loader (IPL)
  • Real-time clock
  • Serial
  • SATA
  • SPI
  • SPI NOR Flash
  • USB device controller driver
  • USB host controller driver
  • Thermal
  • Watchdog
  • For graphics driver support, this release has been built and tested with the Screen Board Support i.MX6x package, version 7.1 BuildID 201. For more information, see the QNX SDP 7.1 Screen Board Support i.MX6x: Release Notes from the QNX Software Center.
• This BSP provides full support for the boards listed in the Supported hardware section. This BSP release has been validated on the following versions of the boards:
  • NXP i.MX6Q SABRE Platform for Smart Devices board (Green, SCH-27516 REV C4)
  • NXP i.MX6QP SABRE Platform for Smart Devices board (Red, SCH-28857 REV B1)

Supported hardware

Our BSP supports the following boards:

• NXP i.MX6Q SABRE Platform for Smart Devices. The revisions that we've tested are:
  • Green, SCH-27516 REV C3
  • Green, SCH-27516 REV C4
• NXP i.MX6QP SABRE Platform for Smart Devices. The revisions that we've tested are:
  • Blue, SCH-28857 REV A2
  • Red, SCH-28857 REV B1

Known issues

For common QNX Software Development Platform issues that may impact this BSP, see the QNX Software Development Platform 7.1: Release Notes.

• On boards that contain the i.MX6 SABRE QuadPlus SoC, there's a known issue when accessing the PCI controller registers may cause the system to hang.

  Therefore, the PCI server isn't available for use on those boards. The non-QuadPlus variants of the i.MX6 SABRE Platform boards don't have this issue. (Ref# J1651146)

  Workaround: None.

• When you build your BSP with QNX SDP 7.1.0, you might see the following issues with the rebuilt image on your target

  1. The SD/MMC driver (devb-sdmmc-mx6) may crash and might be unable to access media devices (e.g., Unable to access "/dev/sd30").
  2. The Umass driver (devb-umass) might be unable to access media devices.
  3. The SATA driver (devb-ahci) might be unable to access media devices (e.g., Unable to access "/dev/hd0").
  (Ref# J1451405 )

  Workaround: Rebuild the BSP and ensure that you have done the following steps based on the issue you're seeing:

  • For the first issue, modify the buildfile and run your SD/MMC driver with the cam nopriv option set to off. In your buildfile, modify all lines that start the devb-sdmmc-mx6 driver. For example, the following changes fix the access issues for /dev/sd20, /dev/sd30, and /dev/emmc0 in the smart-devices.build file. Look for these lines:

    devb-sdmmc-mx6 cam pnp,verbose blk rw,cache=2M sdio addr=0x02198000,irq=56,bs=cd_base=0x020a0000:cd_pin=0:wp_base=0x020a0000:wp_pin=1:cd_irq=192 disk name=sd3
    devb-sdmmc-mx6 cam quiet blk rw,cache=2M sdio addr=0x0219c000,irq=57,bs=nocd disk name=emmc
    devb-sdmmc-mx6 cam pnp,verbose blk rw,cache=2M sdio addr=0x02194000,irq=55,bs=cd_base=0x020a0000:cd_pin=2:wp_base=0x020a0000:wp_pin=3:cd_irq=194 disk name=sd2
    

    and change them as follows:

    devb-sdmmc-mx6 cam  nopriv,pnp,verbose blk rw,cache=2M sdio addr=0x02198000,irq=56,bs=cd_base=0x020a0000:cd_pin=0:wp_base=0x020a0000:wp_pin=1:cd_irq=192 disk name=sd3
    devb-sdmmc-mx6 cam  nopriv,quiet blk rw,cache=2M sdio addr=0x0219c000,irq=57,bs=nocd disk name=emmc
    devb-sdmmc-mx6 cam  nopriv,pnp,verbose blk rw,cache=2M sdio addr=0x02194000,irq=55,bs=cd_base=0x020a0000:cd_pin=2:wp_base=0x020a0000:wp_pin=3:cd_irq=194 disk name=sd2
    

  • For the second issue described, add the "cam nopriv" command-line option for devb-umass.

    devb-umass cam nopriv,pnp &

  • For the third issue described, add the "cam nopriv" command-line option for devb-ahci.

    devb-ahci cam nopriv ahci ioport=0x02200000,irq=71

  If you see other issues in your rebuilt image after updating your QNX SDP, see the Troubleshooting Board Support Packages guide on the QNX website to see if there's an available solution.

Getting started with this BSP

Each BSP has a user's guide that describes what's in the BSP and how to install and work with it. In a browser, after you log in with your myQNX account, you can download the latest revision of the user's guide from the QNX SDP 7.1 Board Support Documentation page.

We recommend that you read the Building Embedded Systems guide, which contains common information about working with all BSPs from QNX Software Systems. This guide is available on the QNX Software Development Platform 7.1 documentation website.

---

To ensure that you pick up the same components from your development environment, we recommend that you rebuild the IFS image on your host system. Included in this BSP are prebuilt IFS images that are provided as convenience for you to quickly get QNX Neutrino running on your board, however these prebuilt images might not have the same components from your development environment.

---

Technical support

To obtain technical support for any QNX product, visit the Support area on our website (www.qnx.com). You'll find a wide range of support options, including community forums.