# 등록되지 않은 사용자의 GitHub를 통한 빌드

다음 섹션에서는 GitHub를 사용하고 사전 빌드된 독점 바이너리/이미지를 사용하여 빌드를 생성하는 방법을 설명합니다.

이 빌드 방법에서 지원되는 하드웨어 SoC에 대한 자세한 내용은 [릴리스 노트](https://docs.qualcomm.com/bundle/publicresource/topics/RNO-250630224842/) 에서 *동기화 및 빌드 방법* 표를 참조하세요.

## 호스트 컴퓨터 요구사항

- 구성

    - x86 컴퓨터
    - 쿼드 코어 CPU(예: 3.4GHz의 Intel i7-2600 동급 또는 상위 제품)
    - 디스크 여유 공간 300GB 이상(스왑 파티션 > 32GB)
    - 16GB RAM
    - Ubuntu 22.04
- 도구

    - Git 1.8.3.1 이후 버전
    - Tar 1.28 이후 버전
    - Python 3.10.2 이후 버전
    - GCC 8.0 이후 버전
    - GNU 4.0 이후 버전
- 권한

    - 몇 가지 명령어는 실행하려면 `sudo` 권한이 필요합니다.

참고

VM에서 코드 컴파일을 수행하면 처리 속도가 느려 몇 시간이 걸릴 수 있습니다. 퀄컴은 Ubuntu 호스트 컴퓨터를 이용하여 컴파일할 것을 권장합니다. Microsoft^®^ Windows^®^ 또는 Apple^®^ macOS^®^ 에서 Ubuntu 22.04를 실행하는 가상 머신(VM)을 설정하려면 [Qualcomm Linux 가상 머신 설정 가이드](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-41/) 를 참조하세요.

## 독립 실행형 명령어로 빌드

### Ubuntu 호스트 컴퓨터 설정

Ubuntu 호스트 컴퓨터에서 필요한 소프트웨어 도구를 설치하고 구성합니다.

1. 다음 패키지를 설치하여 Yocto 빌드를 위한 호스트 환경을 준비합니다.

sudo apt update
        sudo apt install repo gawk wget git diffstat unzip texinfo gcc build-essential chrpath socat cpio python3 python3-pip python3-pexpect xz-utils debianutils iputils-ping python3-git python3-jinja2 libegl1-mesa libsdl1.2-dev pylint xterm python3-subunit mesa-common-dev zstd liblz4-tool locales tar python-is-python3 file libxml-opml-simplegen-perl vim whiptail g++ libacl1
        Copy to clipboard
2. 로케일을 설정합니다(아직 설정되지 않은 경우).

sudo locale-gen en_US.UTF-8
        sudo update-locale LC_ALL=en_US.UTF-8 LANG=en_US.UTF-8
        export LC_ALL=en_US.UTF-8
        export LANG=en_US.UTF-8
        Copy to clipboard
3. git 구성을 업데이트합니다.

# Check if your identity is configured in .gitconfig
        git config --get user.email
        git config --get user.name
        
        # Run the following commands if you don't have your account identity set in .gitconfig
        git config --global user.email <Your email ID>
        git config --global user.name <"Your Name">
        
        # Add the following UI color option for output of console (optional)
        git config --global color.ui auto
        
        # Add the following git configurations to fetch large size repositories and to avoid unreliable connections
        git config --global http.postBuffer 1048576000
        git config --global http.maxRequestBuffer 1048576000
        git config --global http.lowSpeedLimit 0
        git config --global http.lowSpeedTime 999999
        Copy to clipboard

### 동기화

이 섹션에서는 [Ubuntu 호스트 설정](https://docs.qualcomm.com/doc/80-70020-254K/topic/github_workflow_unregistered_users.html#ubuntu-host-setup-github-unreg) 에서 설치된 Repo 도구를 사용하여 [Qualcomm 매니페스트](https://github.com/quic-yocto/qcom-manifest) 에서 git 저장소 및 기타 속성을 다운로드합니다. Repo 도구는 `repo init` 명령어를 사용하여 매니페스트를 다운로드합니다.

다음 표에서는 Yocto 계층을 매니페스트 릴리스 태그에 매핑하는 예시를 보여줍니다. 이 매핑은 Qualcomm Linux를 다운로드하고 빌드하는 데 사용됩니다.

매니페스트 릴리스 태그에 Yocto 계층 매핑

| Yocto 계층 | 매니페스트 릴리스 태그 | 참조 배포판(`DISTRO` ) |
| --- | --- | --- |
| <ul class="simple"><br><li><p><code class="docutils literal notranslate"><span class="pre">meta-qcom</span></code></p></li><br><li><p><code class="docutils literal notranslate"><span class="pre">meta-qcom-hwe</span></code></p></li><br><li><p><code class="docutils literal notranslate"><span class="pre">meta-qcom-distro</span></code></p></li><br></ul> | BSP 빌드: 상위 수준 OS 및 사전 빌드된 펌웨어(GPS만 해당)<br><br><br>`qcom-6.6.90-QLI.1.5-Ver.1.1.xml` | `qcom-wayland` |
| <ul class="simple"><br><li><p><code class="docutils literal notranslate"><span class="pre">meta-qcom</span></code></p></li><br><li><p><code class="docutils literal notranslate"><span class="pre">meta-qcom-hwe</span></code></p></li><br><li><p><code class="docutils literal notranslate"><span class="pre">meta-qcom-distro</span></code></p></li><br><li><p><code class="docutils literal notranslate"><span class="pre">meta-qcom-qim-product-sdk</span></code></p></li><br></ul> | BSP 빌드 + Qualcomm IM SDK 빌드:<br><br><br>`qcom-6.6.90-QLI.1.5-Ver.1.1_qim-product-sdk-2.0.1.xml` | `qcom-wayland` |
| <ul class="simple"><br><li><p><code class="docutils literal notranslate"><span class="pre">meta-qcom</span></code></p></li><br><li><p><code class="docutils literal notranslate"><span class="pre">meta-qcom-hwe</span></code></p></li><br><li><p><code class="docutils literal notranslate"><span class="pre">meta-qcom-distro</span></code></p></li><br><li><p><code class="docutils literal notranslate"><span class="pre">meta-qcom-realtime</span></code></p></li><br></ul> | BSP 빌드 + 실시간 커널 빌드:<br><br><br>`qcom-6.6.90-QLI.1.5-Ver.1.1_realtime-linux-1.1.xml` | `qcom-wayland` |
| <ul class="simple"><br><li><p><code class="docutils literal notranslate"><span class="pre">meta-qcom</span></code></p></li><br><li><p><code class="docutils literal notranslate"><span class="pre">meta-qcom-hwe</span></code></p></li><br><li><p><code class="docutils literal notranslate"><span class="pre">meta-qcom-distro</span></code></p></li><br><li><p><code class="docutils literal notranslate"><span class="pre">meta-ros</span></code></p></li><br><li><p><code class="docutils literal notranslate"><span class="pre">meta-qcom-robotics</span></code></p></li><br><li><p><code class="docutils literal notranslate"><span class="pre">meta-qcom-robotics-distro</span></code></p></li><br><li><p><code class="docutils literal notranslate"><span class="pre">meta-qcom-robotics-sdk</span></code></p></li><br><li><p><code class="docutils literal notranslate"><span class="pre">meta-qcom-qim-product-sdk</span></code></p></li><br></ul> | BSP 빌드 + QIR SDK 빌드:<br><br><br>`qcom-6.6.90-QLI.1.5-Ver.1.1_robotics-product-sdk-1.1.xml` | `qcom-robotics-ros2-humble` |

릴리스 태그 구문은 다음과 같습니다.

- 매니페스트 릴리스 태그:

    `qcom-<Linux LTS Kernel Version>-QLI.<version>-Ver.<release>.xml`

    예를 들어 매니페스트 릴리스 태그 `qcom-6.6.90-QLI.1.5-Ver.1.1.xml` 은 다음을 나타냅니다.

    - 6.6.90: Qualcomm Linux 커널
    - QLI.1.5: Qualcomm Linux v1.5
    - 1.1: 마일스톤 릴리스
- 추가 제품화 매니페스트 릴리스 태그:

    `qcom-<Linux LTS Kernel version>-QLI.<version>-Ver.<milestone release>_<product/customization>-<patch release>.xml`

    예를 들어 추가 제품화 매니페스트 릴리스 태그 `qcom-6.6.90-QLI.1.5-Ver.1.1_qim-product-sdk-2.0.1.xml` 은 다음을 나타냅니다.

    - 6.6.90: Qualcomm Linux 커널
    - QLI.1.5: Qualcomm Linux v1.5
    - qim-product-sdk-2.0.1: QLI.1.5 기반의 Qualcomm IM SDK 릴리스

        기타 제품/사용자 지정 예시:

        - *realtime-linux-1.0*
        - *robotics-product-sdk-1.1*
    - 1.1: 마일스톤 릴리스
    - 2.0.1: 마일스톤 릴리스와 연결된 패치 릴리스

Yocto 계층에 대한 자세한 내용은 [Qualcomm Linux 메타데이터 계층](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-27/qualcomm_bsp_metadata_layers.html) 을 참조하세요.

### BSP 이미지 빌드

보드 지원 패키지(BSP) 이미지 빌드에는 Qualcomm 기기 지원을 위한 소프트웨어 구성 요소와 Qualcomm SoC에 적용할 수 있는 소프트웨어 기능이 포함되어 있습니다. 이 빌드에는 Qualcomm 개발 키트의 참조 배포판 구성도 포함됩니다. 자세한 내용은 [Qualcomm Linux 메타데이터 계층](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-27/qualcomm_bsp_metadata_layers.html) 을 참조하세요.

1. Qualcomm Yocto 및 지원되는 계층을 다운로드합니다. 최신 `<manifest release tag>` 는 [릴리스 노트](https://docs.qualcomm.com/bundle/publicresource/topics/RNO-250630224842/) 의 *빌드 필수 릴리스 태그* 섹션을 참조하세요.

# cd to directory where you have 300 GB of free storage space to create your workspaces
        mkdir <WORKSPACE_DIR>
        cd <WORKSPACE_DIR>
        repo init -u https://github.com/quic-yocto/qcom-manifest -b qcom-linux-scarthgap -m <manifest release tag>
        # Example, <manifest release tag> is qcom-6.6.90-QLI.1.5-Ver.1.1.xml
        repo sync
        Copy to clipboard
2. 빌드 환경을 설정합니다.

MACHINE=<machine> DISTRO=qcom-wayland QCOM_SELECTED_BSP=<override> source setup-environment
        # Example, MACHINE=qcs6490-rb3gen2-vision-kit DISTRO=qcom-wayland QCOM_SELECTED_BSP=custom source setup-environment
        # source setup-environment: Sets the environment, creates the build directory build-qcom-wayland,
        # and enters into build-qcom-wayland directory.
        Copy to clipboard

    다양한 `<machine>` 및 `<override>` 조합은 [릴리스 노트](https://docs.qualcomm.com/bundle/publicresource/topics/RNO-250630224842/) 를 참조하세요.
3. 소프트웨어 이미지를 빌드합니다. 지원되는 이미지 레시피는 [GitHub 워크플로우에서 지원되는 이미지 레시피](https://docs.qualcomm.com/doc/80-70020-254K/topic/how_to.html#image-recipes-github-workflow) 를 참조하세요.

bitbake <image recipe>
        # Example, bitbake qcom-multimedia-image
        Copy to clipboard
4. 빌드가 성공적으로 완료되면 `system.img` 파일이 `<workspace_path>/build-qcom-wayland/tmp-glibc/deploy/images/qcs6490-rb3gen2-vision-kit/qcom-multimedia-image` 디렉토리에 있는지 확인하세요.

cd <workspace_path>/build-qcom-wayland/tmp-glibc/deploy/images/qcs6490-rb3gen2-vision-kit/qcom-multimedia-image
        ls -al system.img
        Copy to clipboard

### Qualcomm IM SDK 이미지 빌드

Qualcomm® 지능형 멀티미디어 SDK(IM SDK)는 Qualcomm IM SDK, Qualcomm® 신경망 처리 SDK, Qualcomm® AI 엔진 다이렉트 SDK, 라이트 런타임(LiteRT)이라는 4가지 독립 실행형 기능 SDK로 구성된 컬렉션입니다. 이 SDK에는 사용 사례를 개발하는 데 사용할 수 있는 참조 애플리케이션도 포함됩니다. 자세한 내용은 [Qualcomm IM SDK 빠른 시작 가이드](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-51) 를 참조하세요.

1. Qualcomm Yocto 및 지원되는 계층을 다운로드합니다. Qualcomm IM SDK 빌드의 `<manifest release tag>` 는 BSP 빌드와 동일합니다. Qualcomm BSP 빌드 위에 IM SDK 계층을 복제합니다. 최신 `<manifest release tag>` 는 [릴리스 노트](https://docs.qualcomm.com/bundle/publicresource/topics/RNO-250630224842/) 의 *빌드 필수 릴리스 태그* 섹션을 참조하세요.

# cd to directory where you have 300 GB of free storage space to create your workspaces
        mkdir <WORKSPACE_DIR>
        cd <WORKSPACE_DIR>
        repo init -u https://github.com/quic-yocto/qcom-manifest -b qcom-linux-scarthgap -m <manifest release tag>
        # Example, <manifest release tag> is qcom-6.6.90-QLI.1.5-Ver.1.1.xml
        repo sync
        Copy to clipboard
2. 작업 영역에 Qualcomm IM SDK 계층을 복제합니다.

git clone https://github.com/quic-yocto/meta-qcom-qim-product-sdk -b <meta-qcom-qim-product-sdk release tag> layers/meta-qcom-qim-product-sdk
        # Example, <meta-qcom-qim-product-sdk release tag> is qcom-6.6.90-QLI.1.5-Ver.1.1_qim-product-sdk-2.0.1
        Copy to clipboard
3. Qualcomm IM SDK 계층 내보내기:

export EXTRALAYERS="meta-qcom-qim-product-sdk"
        Copy to clipboard
4. 빌드 환경을 설정합니다.

MACHINE=<machine> DISTRO=qcom-wayland QCOM_SELECTED_BSP=custom source setup-environment
        # Example, MACHINE=qcs6490-rb3gen2-vision-kit DISTRO=qcom-wayland QCOM_SELECTED_BSP=custom source setup-environment
        # source setup-environment: Sets the environment, creates the build directory build-qcom-wayland,
        # and enters into build-qcom-wayland directory.
        Copy to clipboard

    `MACHINE` 매개변수 값을 알아보려면 [릴리스 노트](https://docs.qualcomm.com/bundle/publicresource/topics/RNO-250630224842/) 를 참조하세요.
5. 소프트웨어 이미지를 빌드합니다.

bitbake qcom-multimedia-image
        # Build SDK image
        bitbake qcom-qim-product-sdk
        Copy to clipboard
6. 빌드가 성공적으로 완료되면 `system.img` 파일이 `<workspace_path>/build-qcom-wayland/tmp-glibc/deploy/images/qcs6490-rb3gen2-vision-kit/qcom-multimedia-image` 디렉토리에 있는지 확인하세요.

cd <workspace_path>/build-qcom-wayland/tmp-glibc/deploy/images/qcs6490-rb3gen2-vision-kit/qcom-multimedia-image
        ls -al system.img
        Copy to clipboard

### QIR SDK 이미지 빌드

Qualcomm® 지능형 로봇 공학 제품(QIR) SDK 2.0은 Qualcomm 플랫폼에서 로봇 공학 기능의 개발을 지원하는 구성 요소 컬렉션입니다. 이 SDK는 Qualcomm Linux 릴리스에 적용됩니다. 자세한 내용은 [QIR SDK 2.0 사용자 가이드](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-265) 를 참조하세요.

1. Qualcomm Yocto 및 지원되는 계층을 다운로드합니다. QIR SDK 빌드의 `<manifest release tag>` 는 BSP 빌드와 동일합니다. BSP 빌드 위에 QIR SDK 계층을 복제합니다. 최신 `<manifest release tag>` 는 [릴리스 노트](https://docs.qualcomm.com/bundle/publicresource/topics/RNO-250630224842/) 의 *빌드 필수 릴리스 태그* 섹션을 참조하세요.

# cd to directory where you have 300 GB of free storage space to create your workspaces
        mkdir <WORKSPACE_DIR>
        cd <WORKSPACE_DIR>
        repo init -u https://github.com/quic-yocto/qcom-manifest -b qcom-linux-scarthgap -m <manifest release tag>
        # Example, <manifest release tag> is qcom-6.6.90-QLI.1.5-Ver.1.1.xml
        repo sync
        Copy to clipboard
2. QIR SDK 계층을 BSP 빌드 `<WORKSPACE DIR>` 디렉토리에 다운로드합니다.

git clone https://github.com/ros/meta-ros -b scarthgap layers/meta-ros && cd layers/meta-ros && git checkout c560699e810e60a9526f4226c2c23f8d877280c8 && cd ../../
        git clone https://github.com/quic-yocto/meta-qcom-robotics.git -b qcom-6.6.90-QLI.1.5-Ver.1.1_robotics-product-sdk-1.1 layers/meta-qcom-robotics
        git clone https://github.com/quic-yocto/meta-qcom-robotics-distro.git -b qcom-6.6.90-QLI.1.5-Ver.1.1_robotics-product-sdk-1.1 layers/meta-qcom-robotics-distro
        git clone https://github.com/quic-yocto/meta-qcom-robotics-sdk.git -b qcom-6.6.90-QLI.1.5-Ver.1.1_robotics-product-sdk-1.1 layers/meta-qcom-robotics-sdk
        git clone https://github.com/quic-yocto/meta-qcom-qim-product-sdk -b qcom-6.6.90-QLI.1.5-Ver.1.1_qim-product-sdk-2.0.1 layers/meta-qcom-qim-product-sdk
        Copy to clipboard
3. 빌드 환경을 설정합니다.

ln -s layers/meta-qcom-robotics-distro/set_bb_env.sh ./setup-robotics-environment
        ln -s layers/meta-qcom-robotics-sdk/scripts/qirp-build ./qirp-build
        MACHINE=<machine> DISTRO=qcom-robotics-ros2-humble QCOM_SELECTED_BSP=<override> source setup-robotics-environment
        # Example, MACHINE=qcs6490-rb3gen2-vision-kit DISTRO=qcom-robotics-ros2-humble QCOM_SELECTED_BSP=custom source setup-robotics-environment
        # source setup-robotics-environment: Sets the environment, creates the build directory build-qcom-robotics-ros2-humble,
        # and enters into build-qcom-robotics-ros2-humble directory.
        Copy to clipboard

    다양한 `<machine>` 및 `<override>` 조합은 [릴리스 노트](https://docs.qualcomm.com/bundle/publicresource/topics/RNO-250630224842/) 를 참조하세요.
4. 로봇 공학 이미지 및 QIR SDK 아티팩트를 빌드합니다.

../qirp-build qcom-robotics-full-image
        Copy to clipboard
5. 빌드가 성공적으로 완료되면 QIR SDK 빌드 아티팩트가 다음 경로에 있는지 확인하세요.

QIR SDK artifacts: <WORKSPACE DIR>/build-qcom-robotics-ros2-humble/tmp-glibc/deploy/qirpsdk_artifacts/qirp-sdk_<version>.tar.gz
        # system.img is present in the following path
        Robotics image: <WORKSPACE DIR>/build-qcom-robotics-ros2-humble/tmp-glibc/deploy/images/qcs6490-rb3gen2-vision-kit/qcom-robotics-full-image
        Copy to clipboard

### 실시간 Linux 이미지 빌드

실시간 계층은 Qualcomm Linux 커널을 실시간 커널로 실행하는 데 필요한 레시피 및 구성을 제공합니다. 실시간 커널은 `CONFIG_PREEMPT_RT=y` 구성을 통해 선점 기능이 완전히 활성화된 상태로 실행됩니다. 이 계층은 지원되는 컴퓨터에 대해 Qualcomm Linux 커널을 페치하고 빌드하는 `linux-kernel-qcom-rt` 레시피를 지원합니다. 이 계층은 커널 버전에 따라 커널과 업스트림 `PREEMPT_RT` 패치에 추가되고 실시간 구성을 활성화합니다. 자세한 내용은 [실시간 커널](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-3/real_time_kernel_overview.html) 을 참조하세요.

1. Qualcomm Yocto 및 지원되는 계층을 다운로드합니다. 실시간 Linux 이미지의 `<manifest release tag>` 는 BSP 빌드와 동일합니다. BSP 빌드 위에 실시간 Linux를 복제합니다. 최신 `<manifest release tag>` 는 [릴리스 노트](https://docs.qualcomm.com/bundle/publicresource/topics/RNO-250630224842/) 의 *빌드 필수 릴리스 태그* 섹션을 참조하세요.

# cd to directory where you have 300 GB of free storage space to create your workspaces
        mkdir <WORKSPACE_DIR>
        cd <WORKSPACE_DIR>
        repo init -u https://github.com/quic-yocto/qcom-manifest -b qcom-linux-scarthgap -m <manifest release tag>
        # Example, <manifest release tag> is qcom-6.6.90-QLI.1.5-Ver.1.1.xml
        repo sync
        Copy to clipboard
2. 작업 영역에 실시간 Linux 계층을 복제합니다.

git clone https://github.com/quic-yocto/meta-qcom-realtime -b <meta-qcom-realtime release tag> layers/meta-qcom-realtime
        # Example, <meta-qcom-realtime release tag> is qcom-6.6.90-QLI.1.5-Ver.1.1_realtime-linux-1.1
        Copy to clipboard
3. 실시간 계층을 빌드합니다.

export EXTRALAYERS="meta-qcom-realtime"
        Copy to clipboard
4. 빌드 환경을 설정합니다.

MACHINE=<machine> DISTRO=qcom-wayland QCOM_SELECTED_BSP=<override> source setup-environment
        # Example, MACHINE=qcs6490-rb3gen2-vision-kit DISTRO=qcom-wayland QCOM_SELECTED_BSP=custom source setup-environment
        # source setup-environment: Sets the environment, creates the build directory build-qcom-wayland,
        # and enters into build-qcom-wayland directory.
        Copy to clipboard

    다양한 `<machine>` 및 `<override>` 조합은 [릴리스 노트](https://docs.qualcomm.com/bundle/publicresource/topics/RNO-250630224842/) 를 참조하세요.
5. 소프트웨어 이미지를 빌드합니다.

bitbake qcom-multimedia-image
        Copy to clipboard
6. 빌드가 성공적으로 완료되면 `system.img` 파일이 `<workspace_path>/build-qcom-wayland/tmp-glibc/deploy/images/qcs6490-rb3gen2-vision-kit/qcom-multimedia-image` 디렉토리에 있는지 확인하세요.

cd <workspace_path>/build-qcom-wayland/tmp-glibc/deploy/images/qcs6490-rb3gen2-vision-kit/qcom-multimedia-image
        ls -al system.img
        Copy to clipboard

### 플래시

소프트웨어 이미지를 기기에 플래시하려면 [소프트웨어 이미지 플래시](https://docs.qualcomm.com/doc/80-70020-254K/topic/flash_images.html#flash-images) 를 참조하세요.

## 관련 주제

- [UART 셸에 연결](https://docs.qualcomm.com/doc/80-70020-254K/topic/how_to.html#connect-uart)
- [네트워크에 연결](https://docs.qualcomm.com/doc/80-70020-254K/topic/how_to.html#connect-to-network)
- [SSH를 사용하여 로그인](https://docs.qualcomm.com/doc/80-70020-254K/topic/how_to.html#use-ssh)
- [동기화, 빌드, 플래시 문제 해결](https://docs.qualcomm.com/doc/80-70020-254K/topic/troubleshoot_sync_build_and_flash.html#troubleshoot-sync-build-and-flash)

Last Published: Dec 23, 2025

[Previous Topic
QSC CLI로 빌드](https://docs.qualcomm.com/bundle/publicresource/80-70020-254K/topics/build_frm_source_qsc_cli.md) [Next Topic
등록된 사용자의 GitHub를 통한 빌드](https://docs.qualcomm.com/bundle/publicresource/80-70020-254K/topics/build_from_source_github_intro.md)