# 未登録ユーザー向けのGitHubを使用したビルド

以下のセクションでは、GitHubを使用して、ビルド済みの独自バイナリ/イメージを使用してビルドを作成する方法について説明します。

このビルド方法でサポートされるハードウェア SoC については、[リリースノート](https://docs.qualcomm.com/bundle/publicresource/topics/RNO-250630224842/) の *同期とビルド方法* の表を参照してください。

## ホスト・コンピューターの要件

- 構成

    - x86マシン
    - クアッドコアCPU、例：Intel i7-2600 3.4GHz（同等以上）
    - 300GBのディスク空き容量（スワップパーティション32GB超）
    - 16GB RAM
    - Ubuntu 22.04
- ツール

    - Git 1.8.3.1以降のバージョン
    - Tar 1.28以降のバージョン
    - Python 3.10.2以降のバージョン
    - GCC 8.0以降のバージョン
    - GNU Make 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-254J/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-254J/topic/how_to.html#image-recipes-github-workflow) を参照してください。

bitbake <image recipe>
        # Example, bitbake qcom-multimedia-image
        Copy to clipboard
4. ビルドに成功したら、`<workspace_path>/build-qcom-wayland/tmp-glibc/deploy/images/qcs6490-rb3gen2-vision-kit/qcom-multimedia-image` ディレクトリに `system.img` ファイルがあることを確認します。

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® Intelligent Multimedia SDK（IM SDK）は、Qualcomm IM SDK、Qualcomm® Neural Processing SDK、Qualcomm® AI Engine direct SDK、Lite Runtime（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 ビルドのものと同じです。BSP ビルドの上に Qualcomm 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. ビルドに成功したら、`<workspace_path>/build-qcom-wayland/tmp-glibc/deploy/images/qcs6490-rb3gen2-vision-kit/qcom-multimedia-image` ディレクトリに `system.img` ファイルがあることを確認します。

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® Intelligent Robotics（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` によって、プリエンプションが完全に有効になった状態で実行されます。このレイヤーは、サポート対象のマシン用の `linux-kernel-qcom-rt` レシピをサポートしており、Qualcomm Linuxカーネルをフェッチしてビルドします。このレイヤーは、カーネル・バージョンに基づいてカーネルとアップストリーム `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. ビルドに成功したら、`<workspace_path>/build-qcom-wayland/tmp-glibc/deploy/images/qcs6490-rb3gen2-vision-kit/qcom-multimedia-image` ディレクトリに `system.img` ファイルがあることを確認します。

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-254J/topic/flash_images.html#flash-images) を参照してください。

## 関連トピック

- [UARTシェルに接続](https://docs.qualcomm.com/doc/80-70020-254J/topic/how_to.html#connect-uart)
- [ネットワークに接続](https://docs.qualcomm.com/doc/80-70020-254J/topic/how_to.html#connect-to-network)
- [SSHを使ってログインする](https://docs.qualcomm.com/doc/80-70020-254J/topic/how_to.html#use-ssh)
- [同期、ビルド、フラッシュの問題のトラブルシューティング](https://docs.qualcomm.com/doc/80-70020-254J/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-254J/topics/build_frm_source_qsc_cli.md) [Next Topic
登録ユーザー向けのGitHubを使用したビルド](https://docs.qualcomm.com/bundle/publicresource/80-70020-254J/topics/build_from_source_github_intro.md)