Troubleshoot common issues

​

Compile

​

The fetch speed is slow when compiling nativesdk-glibc

1. Open the recipe file:
    vim <workspace>/layers/poky/meta/recipes-core/glibc/glibc_2.39.bb +35
   
2. Add the following line to the file:
    PREMIRRORS = ""
   
3. Save the recipe file and exit.
4. Clean and fetch nativesdk-glibc again:
   bitbake -c cleanall nativesdk-glibc
   bitbake -c do_fetch nativesdk-glibc
   
5. After the commands finish, rebuild according to the original procedure.

​

Kas reports remote HEAD refers to nonexistent ref

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

kas --version

​

eSDK build fails after switching MACHINE in the same workspace

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.

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

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):

 do_configure[network] = "1"

​

Docker

​

Docker is not installed

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

sudo apt update
sudo apt install -y docker.io 

​

Current user is not in the Docker group

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

1. 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
   
2. 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
   
3. 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

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

1. 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"]
   }
   
2. 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.