Getting started

1. Clone the custom target image repo from GitLab:

   git clone https://gitlab.com/qnx/custom-target-image-builds/raspberry-pi-4-qnx-8.0.git

2. Navigate into the project folder:

   cd raspberry-pi-4-qnx-8.0

3. Export path to the qnxsoftwarecenter_clt executable (modify according to your installation location):

   export QSC_CLT_PATH=$HOME/qnx/qnxsoftwarecenter/qnxsoftwarecenter_clt

4. Set up the QNX SDP environment to perform the build and export some environment values required for building (or point to the location of your installation if different):

   source ~/qnx800/qnxsdp-env.sh

5. Create a file called options_file and populate it with:

   -myqnx.user
   <username>
   -myqnx.password
   <password>

   Replace the placeholders with your qnx.com credentials.

   This file provides your credentials to QNX Software Center (QSC) to install required packages locally for the image build. Take care not to share this file with others or commit it to a fork of this project.

Once you've performed the steps above, run make to build the image. The first time you build takes time; roughly 30 minutes or longer depending on your internet connection speed. Some noteworthy items to be aware of:

• A separate installation of the QNX Software Development Platform (SDP) is installed within the project folder. The separate SDP installation is also used to build the open source projects integrated into the build.
• Due to the size of asset packages and projects that are downloaded from the internet, you'll likely need approximately 10 GB of free disk space.
• During the build, you'll see output from the different integration download and build steps in each of the project subfolders as the build proceeds. This is normal and expected. Some of the steps seen in the initial build are skipped in later builds, because the required artifacts have been downloaded and unpacked in previous builds.

If the build is successful, it produces an image file called rpi4.img.

If the image generation isn't successful, refer to the "Troubleshooting" section later in this chapter for more details.