Build RTSS firmware

Prerequisites and procedure for building RTSS firmware.

​

Prerequisites

1. Download the RTSS firmware by running the git clone command:
   mkdir -p <FIRMWARE_ROOT>
   cd <FIRMWARE_ROOT>
   git clone -b <firmware release tag> --depth 1 https://qpm-git.qualcomm.com/home2/git/qualcomm/qualcomm-linux-spf-2-0_ap_standard_oem_sail.git
   
   For example:
   git clone -b r2.0_00007.2 --depth 1 https://qpm-git.qualcomm.com/home2/git/qualcomm/qualcomm-linux-spf-2-0_ap_standard_oem_sail.git
   
   The git clone command clones the content into the <FIRMWARE_ROOT>/qualcomm-linux-spf-2-0_ap_standard_oem_sail.git directory. For the latest <firmware release tag>, see Release tags.
2. Download the FreeRTOS kernel.
   1. Clone the FreeRTOS kernel using the git clone command:
      git clone https://github.com/FreeRTOS/FreeRTOS-Kernel.git -b V11.0.1
      
   2. Go to the FreeRTOS kernel directory:
      cd FreeRTOS-Kernel
      
   3. Copy the croutine.c, cspell.config.yaml, event_groups.c, include manifest.yml, queue.c, stream_buffer.c, tasks.c, timers.c, and list.c files to <top_directory>/sail_proc/FreeRTOS/kernel/:
      cp -r croutine.c cspell.config.yaml event_groups.c include manifest.yml queue.c stream_buffer.c tasks.c timers.c list.c <top_directory>/sail_proc/FreeRTOS/kernel/
      
3. Download the Arm^® GNU Toolchain compiler:
   NoteInstall the Arm GNU Toolchain compiler on x86 64-bit host computer only.
   1. Download the arm-gnu-toolchain-14.3.rel1-x86_64-arm-none-eabi toolchain variant from Arm GNU Toolchain Downloads:
      wget https://developer.arm.com/-/media/Files/downloads/gnu/14.3.rel1/binrel/arm-gnu-toolchain-14.3.rel1-x86_64-arm-none-eabi.tar.xz
      
   2. Extract the downloaded arm-gnu-toolchain-14.3.rel1-x86_64-arm-none-eabi.tar.xz file:
      tar -xf arm-gnu-toolchain-14.3.rel1-x86_64-arm-none-eabi.tar.xz
      
   3. Go to the sail_proc directory:
      cd sail_proc
      
   4. Create the toolchain folder under the sail_proc directory:
      mkdir toolchain
      
   5. Copy the extracted arm-gnu-toolchain-14.3.rel1-x86_64-arm-none-eabi folder into the sail_proc/toolchain directory.
      cp -r arm-gnu-toolchain-14.3.rel1-x86_64-arm-none-eabi <FIRMWARE_ROOT>/qualcomm-linux-spf-2-0_ap_standard_oem_sail/SAIL.SI.1.2/sail_proc/toolchain
      
   6. Export the SECTOOLS variable from the top-level directory of <FIRMWARE_ROOT>/: For IQ-9075:
      export SECTOOLS= <FIRMWARE_ROOT>/qualcomm-linux-spf-2-0_ap_standard_oem_sail/QCS9100.LE.2.0/common/sectoolsv2/ext/Linux/sectools
      export SECTOOLS_DIR= <FIRMWARE_ROOT>/qualcomm-linux-spf-2-0_ap_standard_oem_sail/QCS9100.LE.2.0/common/sectoolsv2/ext/Linux
      
      For IQ-8275:
      export SECTOOLS= <FIRMWARE_ROOT>/qualcomm-linux-spf-2-0_ap_standard_oem_sail/QCS8300.LE.2.0/common/sectoolsv2/ext/Linux/sectools
      export SECTOOLS_DIR= <FIRMWARE_ROOT>/qualcomm-linux-spf-2-0_ap_standard_oem_sail/QCS8300.LE.2.0/common/sectoolsv2/ext/Linux
      
4. After you receive the startup object files from the Qualcomm Support team, do the following:
   1. Extract the aarch32_startup.zip file.
      unzip aarch32_startup.zip
      
   2. Create the startup folder under the sail_proc/BSP directory.
      cd <FIRMWARE_ROOT>/qualcomm-linux-spf-1-0_ap_standard_oem_sail/SAIL.SI.1.2/sail_proc/BSP
      
      mkdir startup
      
   3. Copy the extracted aarch32 folder into the startup folder.
      cp -r <path to aarch32 folder>/aarch32 <FIRMWARE_ROOT>/qualcomm-linux-spf-1-0_ap_standard_oem_sail/SAIL.SI.1.2/sail_proc/BSP/startup
      

​

Procedure

1. Enter bash:
   bash
   
2. Go to the main directory of RTSS:
   cd <FIRMWARE_ROOT>/qualcomm-linux-spf-2-0_ap_standard_oem_sail/SAIL.SI.1.2`
   
3. Set up the build environment on the device:
   source sail_proc/build/ms/setupenv.sh
   
   Note

   1. Before running the command, ensure that the toolchain and RTOS code/binaries are copied to the build to avoid compilation issues.
4. Build the image:
   make TARGET=<target name>
   
   For IQ-9075:
   make TARGET=lemans
   
   For IQ-8275:
   make TARGET=monaco
   
   After successful execution of the RTSS build, sailhyp.elf and sailsw1.elf are generated at: For IQ-9075:

   qualcomm-linux-spf-2-0_ap_standard_oem_sail/SAIL.SI.1.2/sail_proc/build/ms/bin/SAIL_RTOS/DEBUG/lemans/signed For IQ-8275: qualcomm-linux-spf-2-0_ap_standard_oem_sail/SAIL.SI.1.2/sail_proc/build/ms/bin/SAIL_RTOS/DEBUG/monaco/signed

5. Copy the generated RTSS files into the <workspace_path>/build-<DISTRO>/tmp-glibc/deploy/images/<MACHINE>/<IMAGE>/sail_nor folder to program on the NOR flash. Example: <workspace_path>/build-qcom-wayland/tmp-glibc/deploy/images/qcs9075-iq-9075-evk/qcom-multimedia-image/sail_nor Parameters:

   • <DISTRO>: qcom-wayland
   • <MACHINE>: qcs9075-iq-9075-evk
   • <IMAGE>: qcom-multimedia-image

   NoteFor information about <MACHINE>, see the Software Release Notes.
6. (Optional) To refresh the build, clean the build:
   make clean TARGET=<target name>
   
   For IQ-9075:
   make clean TARGET=lemans
   
   For IQ-8275:
   make clean TARGET=monaco
   
   After running the make clean TARGET=<target name> command, perform the following steps to rebuild the image using the make TARGET=<target name> command:

   1. Copy the extracted aarch32 folder into the startup folder.
      cp -r <path to aarch32 folder>/aarch32 <FIRMWARE_ROOT>/qualcomm-linux-spf-1-0_ap_standard_oem_sail/SAIL.SI.1.2/sail_proc/BSP/startup
      
   2. Go to the main directory of RTSS:
      cd <FIRMWARE_ROOT>/qualcomm-linux-spf-1-0_ap_standard_oem_sail/SAIL.SI.1.2`
      
   3. Set up the build environment on the device:
      source sail_proc/build/ms/setupenv.sh
      
   4. Rebuild the image:
      make TARGET=<target name>
      
      For IQ-9075:
      make TARGET=lemans
      
      For IQ-8275:
      make TARGET=monaco
      

7. For instructions about flashing RTSS, see Flash SAIL.

​

Next steps

• Debug RTSS
• RTSS test commands
• Add partitions to SPINOR flash memory