Troubleshoot common issues - Qualcomm Dragonwing Documentation

Compile

The fetch speed is slow when compiling `nativesdk-glibc`

Resolution

Change the source settings as follows:

Open the recipe file:

 vim <workspace>/layers/poky/meta/recipes-core/glibc/glibc_2.39.bb +35

Add the following line to the file:
PREMIRRORS = ""
Save the recipe file and exit.

Clean and fetch nativesdk-glibc again:

bitbake -c cleanall nativesdk-glibc
bitbake -c do_fetch nativesdk-glibc

After the commands finish, rebuild according to the original procedure.

Kas reports `remote HEAD refers to nonexistent ref`

Phenomenon: When you run a kas shell command, the build fails with the following error even though the layer repository is intact:

ERROR    - warning: remote HEAD refers to nonexistent ref, unable to checkout

Resolution

This error is caused by an outdated version of kas. Check your kas version and confirm that it is 4.8 or later:

kas --version

If the version is earlier than 4.8, upgrade kas and run the command again.

eSDK installation fails due to missing Perl module dependencies

Phenomenon: When you run the eSDK installer script, the installation fails with the following error:

ERROR: OE-core's config sanity checker detected a potential misconfiguration. 
Either fix the cause of this error or at your own risk disable the checker (see sanity.conf).  
Following is the list of potential problems / advisories: 

Required perl module(s) not found: open ':std' FindBin

Resolution: This error occurs when the perl-modules package on the host is missing or incomplete. Reinstall the package, then run the installer again:

Open a new terminal. Don’t source the eSDK environment setup script in this terminal.
Find the perl-modules version that is available for your host:
sudo apt update apt search perl-modules
Reinstall the package. Replace <VERSION> with the version returned in the previous step:
sudo apt install --reinstall perl-modules-<VERSION>
Confirm that the FindBin module loads:
perl -MFindBin -e 'print "FindBin OK\n"'
The command prints FindBin OK when the module is available.

Run the eSDK installer again from the directory that contains it:

cd <decompressed_workspace>/images/<machine>/sdk
umask a+rx
sh ./qcom-robotics-ros2-jazzy-x86_64-qcom-robotics-proprietary-image-armv8-2a-iq-9075-evk-toolchain-ext-2.8.0.sh

Build the robotics image with devtool:

cd ~/qcom-robotics-ros2-jazzy_sdk
. environment-setup-armv8-2a-qcom-linux
devtool build-image qcom-robotics-proprietary-image

eSDK build fails after switching MACHINE in the same workspace

Phenomenon: When you build the eSDK with a different MACHINE in a workspace that was previously used for another MACHINE, the build fails with an error similar to the following:

ERROR: Task (<WORKSPACE>/build/tmp/work/iq_8275_evk-qcom-linux/qcom-robotics-proprietary-image/1.0/sdk-ext/im
age/tmp-renamed-sdk/layers/meta-qcom-robotics-sdk/recipes-products/packagegroups/packagegroup-robotics-opensource.bb:do_populate_lic) failed with
exit code 'setscene ignore_tasks'
NOTE: Tasks Summary: Attempted 12 tasks of which 6 didn't need to be rerun and 1 failed.

Resolution

Clean the robotics package group sstate cache, then rebuild the eSDK:

kas shell <YOUR KAS CONFIG> -c "bitbake packagegroup-robotics-proprietary packagegroup-oss-with-prop-deps packagegroup-robotics-opensource -c cleansstate"

Build failed due to network unavailability

Phenomenon: When you build the robotics image, the build fails with an error similar to the following:

ERROR: Task (<WORKSPACE>/build/meta-ros/meta-ros2-jazzy/generated-recipes/rosx-introspection/rosx-introspection_2.3.0-1.bb:do_configure) failed with exit code '1'

ERROR: Task (<WORKSPACE>/build/meta-ros/meta-ros2-jazzy/generated-recipes/foxglove-sdk/foxglove-bridge_3.2.6-1.bb:do_configure) failed with exit code '1'
CMake Error at cmake/CPM.cmake:19 (file):
  file DOWNLOAD cannot compute hash on failed download

    from url: "https://github.com/cpm-cmake/CPM.cmake/releases/download/v0.40.0/CPM.cmake"
    status: [6;"Could not resolve hostname"]
Call Stack (most recent call first):

Resolution

To resolve the build failure, add the following code to enable network access for the do_configure task in the rosx-introspection_2.3.0-1.bb and foxglove-bridge_3.2.6-1.bb recipes:

rosx-introspection_2.3.0-1.bb | foxglove-bridge_3.2.6-1.bb

 do_configure[network] = "1"

Docker

Docker is not installed

Phenomenon: Docker is not installed

./scripts/docker_build.sh: line 10: docker: command not found

Resolution

Install Docker with the following commands:

sudo apt update
sudo apt install -y docker.io 

Current user is not in the Docker group

Phenomenon: The current user doesn’t have permission to access the Docker socket:

permission denied while trying to connect to the docker API at unix:///var/run/docker.sock

Resolution

Add to the Docker group:

sudo usermod -aG docker $USER
newgrp docker
# Add your current user to the 'docker' group, so you can run Docker commands without needing sudo

Confirm that you are part of the Docker group:

sudo grep /etc/group -e "docker"
# This command shows a list of users who are part of the Docker group; must include your user ID

Sign out and sign in again for the access to take effect:

# You can run the following command to check if you are part of the Docker group
id -a
# This command returns an output string which should include 'docker'

Docker fails to pull images due to network or proxy issues

Phenomenon: Docker cannot reach the remote registry. This is typically due to network restrictions or a missing proxy/mirror configuration:

failed to resolve reference "docker.io/library/ros:jazzy-ros-base-noble": failed to do request: Head "https://registry-1.docker.io/v2/library/ros/manifests/jazzy-ros-base-noble": http: server gave HTTP response to HTTPS client

Resolution

Configure a Docker registry mirror that is accessible from your network environment. The following json configuration uses an example Qualcomm registry mirror; replace the URL with a mirror that is appropriate for your network.

Warning

Don’t include # comments in the JSON configuration file.
Using a tab instead of space and other invisible whitespace characters may break the functionality of JSON configuration files and can also lead to docker.service failing to start.

Open or create the Docker daemon configuration file and add a registry-mirrors entry:

sudo vim /etc/docker/daemon.json

daemon.json

{
  "registry-mirrors": ["https://<your-registry-mirror>"]
}

Following is an example:

daemon.json example

{
   "registry-mirrors": ["https://docker-registry.qualcomm.com"]
}

Restart the Docker service to apply the new settings.
sudo systemctl restart docker
NoteFor users in China, use an appropriate Docker registry mirror when pulling Docker images.

Overlay

Overlay repository metadata fails to download with SSL certificate error

Phenomenon: Runing dnf to access the Qualcomm overlay repository, the metadata download fails with an SSL certificate error similar to the following:

Qualcomm Overlay Repository (armv8_2a)                                                                                                 0.0  B/s |   0  B     00:04
Errors during downloading metadata for repository 'overlay-armv8_2a':
  - Curl error (60): SSL peer certificate or SSH remote key was not OK for https://artifacts.codelinaro.org/artifactory/qli-yocto-rpm-signed/qli-2.1.1/rpm/armv8_2a/repodata/repomd.xml [SSL certificate OpenSSL verify result: certificate is not yet valid (9)]
Error: Failed to download metadata for repo 'overlay-armv8_2a': Cannot download repomd.xml: Cannot download repodata/repomd.xml: All mirrors were tried

The device system time is earlier than the validity start time of the server certificate, so the certificate is considered “not yet valid”.

Resolution

On the device, check the current system time:
date

If the time is incorrect, manually set it to the current time, and then retry the command that failed. Replace the date and time in the following example with the current time:

# Set the system time (format: "YYYY-MM-DD HH:MM:SS")
date -s "<Current Time with YYYY-MM-DD HH:MM:SS format"

# Write the system time to the hardware clock so that it persists after a reboot
hwclock -w

# Verify the time
date

Robotics SDK(Linux)

Compile

The fetch speed is slow when compiling nativesdk-glibc

Kas reports remote HEAD refers to nonexistent ref

eSDK installation fails due to missing Perl module dependencies

eSDK build fails after switching MACHINE in the same workspace

Build failed due to network unavailability

Docker

Docker is not installed

Current user is not in the Docker group

Docker fails to pull images due to network or proxy issues

Overlay

Overlay repository metadata fails to download with SSL certificate error

The fetch speed is slow when compiling `nativesdk-glibc`

Kas reports `remote HEAD refers to nonexistent ref`