Skip to main content
Use the prebuilt platform extended SDK (eSDK) to build the robotics image. The robotics eSDK is an installer that Qualcomm Linux image generates, and provides a complete Yocto environment that allows you to synchronize, modify, compile, and install applications.

​
Prerequisites

  • An Ubuntu 24.04 host computer with at least 50 GB of free space.
  • You have downloaded the prebuilt robotics eSDK with steps in Download the prebuilt packages.

​
Install the robotics image with eSDK

  1. Install the eSDK by running the installer script.
    Note
    • For the location of eSDK, see Download the prebuilt packages.
    • The following steps use the x86_64 architecture prebuilt eSDK as an example. The operations for other architectures are similar.
    a. Run the following commands to run the installer script, example (MACHINE: iq-9075-evk):
    b. When you see the following prompt, press Enter or type a custom directory for eSDK installation.
  2. Follow the remaining console prompts to complete the installation.
  3. Ensure that the eSDK installation is successful when you see the following prompt. SDK has been successfully set up and is ready to be used.
    NoteIf the installer fails with missing Perl module errors, see eSDK installation fails due to missing Perl module dependencies.

​
Build the robotics image with eSDK

Source the environment setup script once per shell session, then build the image you need. <eSDK_install_path> defaults to ~/qcom-robotics-ros2-jazzy_sdk.
  1. Set up the eSDK and build the robotics image.
  2. To build an image, run the devtool build-image command for the recipe you need:
  3. Collect the image from the deployed directory for your machine:
NoteUse a separate workspace for each machine. Switching MACHINE inside one workspace causes a build failure. For details, see eSDK build fails after switching MACHINE in the same workspace.

​
Flash the robotics image to devices

To flash the robotics image to the device, follow the steps in Flash the robotics image, using the qcom-robotics-image or qcom-robotics-proprietary-image image generated in Build the robotics image with eSDK.

​
Develop with the eSDK

All recipes supported by the robotics eSDK are located in the meta-qcom-robotics-sdk/recipes directory. Depending on your needs, use devtool to add a new recipe or modify an existing one. For background on the workflow, see the Yocto documentation: Using devtool in your SDK workflow.
  • To modify an existing recipe:
    This command extracts the recipe’s source into a local Git repository under the eSDK workspace (workspace/sources/<recipe-name> by default), where you can make and commit your changes.
  • To add a new recipe from local source code or a Git repository:
  • After modifying or adding the source, build the recipe to verify your changes:
  • Rebuild the robotics image so that the changes take effect:
NoteTo persist your changes back to the meta-qcom-robotics-sdk layer as a permanent recipe, use devtool finish <recipe-name> <layer-path>. For details, see the Yocto documentation linked above.

​
Next steps