# トラブルシューティング ## Docker - "Docker： Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?" Docker を起動します。 sudo systemctl start docker Copy to clipboard - "Error response from daemon: Get “[https://registry-1.docker.io/v2/](https://registry-1.docker.io/v2/)”: http: server gave HTTP response to HTTPS client" 1. Docker レジストリの内部ミラーを追加します（Qualcomm ネットワークの内部設定）。JSONコンフィギュレーション・ファイルには#コメントを含めないでください。スペースや目に見えない空白文字の代わりにタブを使用すると、JSONコンフィギュレーションファイルの機能が壊れ、`docker.service` の起動に失敗する可能性があります。 sudo vim /etc/docker/daemon.json # Add an entry similar to the following in /etc/docker/daemon.json: { "registry-mirrors": ["https://docker-registry.qualcomm.com"] } Copy to clipboard 注釈 別の方法として、`/etc/docker/daemon.json` に次のエントリを追加できます。 `"registry-mirrors": ["https://ccr.ccs.tencentyun.com"]` 2. Dockerサービスを再起動し、新しい設定を反映させます。 sudo systemctl restart docker Copy to clipboard - "Failed to download from [https://download.docker.com](https://download.docker.com)" > > > [https://download.docker.com](https://download.docker.com) にアクセスできない、またはダウンロードできない場合、以下のコマンドを実行してDockerをインストールしてください。 > > > > > > > > > sudo apt update > > sudo apt install apt-transport-https ca-certificates curl gnupg lsb-release > > curl -fsSL http://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo apt-key add – > > sudo add-apt-repository "deb [arch=amd64] http://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable" > > Copy to clipboard - "Docker failure due to Virtualization not enabled" このエラーは、BIOSから仮想化を有効にすることで解決できます。仮想化を有効にするには、システム・プロバイダーからの具体的な指示に従います。たとえば、以下の手順で。システム・プロバイダーが提供する仮想化を有効にできます。 1. システムが起動したら、BIOSに入ります。BIOS ウィンドウが表示されます。 2. Advanced タブに切り替えます。 3. CPU Configuration セクションで、Virtualization Technology を有効に設定します。 4. 保存して終了します。 5. システムを再起動します。 - "Permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock" これは、`qsc-cli` がすでにマシンにインストールされている状態で、ユーザーが Docker グループに属していない場合に発生します。 1. Docker グループに次のように追加します。 sudo groupadd docker sudo usermod -aG docker $USER newgrp docker Copy to clipboard 2. 自分が Docker グループにいることを確認します。 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 Copy to clipboard 3. アクセス権限を有効にするには、一旦サインアウトし、再度サインインします。 # 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' Copy to clipboard ## 同期 - "repo init or sync failure with except ManifestInvalidRevisionError, e:" Repo パッケージをインストールすると、この問題が発生する可能性があります。 - `/etc/gitconfig` または `~/.gitconfig` で内部ミラーへのリダイレクションがある場合。 - ミラーリング時、内部ミラーにブランチのプレフィックスがある場合。たとえば、`/etc/gitconfig` がリダイレクトし、内部ミラーで、`aosp/stable` としてミラーリングされているアップストリームgitからのstableブランチを使用している場合、`repo init` を実行中、次のエラーが表示されます。 [url "ssh://:/tools/repo"] insteadOf = https://android.googlesource.com/tools/repo insteadOf = https://gerrit.googlesource.com/git-repo Copy to clipboard File "/local/mnt/workspace//test_repo/.repo/repo/main.py", line 126 except ManifestInvalidRevisionError, e: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ SyntaxError: multiple exception types must be parenthesized Copy to clipboard このエラーを解決する手順を以下に示します。 1. 古い `.repo` フォルダーを削除します。このフォルダーは、前に `repo init` コマンドを実行したディレクトリにあります。 rm -rf .repo Copy to clipboard 2. エクスポートして、repo コマンドを実行し、レポの問題を修正します。REPO\_REV は、[https://gerrit.googlesource.com/git-repo](https://gerrit.googlesource.com/git-repo) のアップストリーム 'stable' ブランチからミラーリングされたブランチを指す必要があります。 export REPO_REV='aosp/stable' Copy to clipboard - "Install repo “Server certificate verification failed”" - "Server certificate verification failed.CAfile: none CRLfile: none" のような証明書エラーが表示された場合は、git 構成で SSL 証明書認証が無効になるように git を構成します。詳細については IT 管理者に問い合わせてください。SSL を無効にするには、以下のいずれかのコマンドを使用します。 export GIT_SSL_NO_VERIFY=1 git config --global http.sslverify false Copy to clipboard - リージョンで `android.googlesource` へのアクセスがブロックされている場合、以下の設定を使用して、CodeLinaro MirrorからRepoを取得してください。 git config --global url.https://git.codelinaro.org/clo/la/tools/repo.insteadOf https://android.googlesource.com/tools/repo Copy to clipboard - "error.GitError: git config (‘–replace-all’, ‘color.ui’, ‘auto’): error: could not write config file /home/$USER/.gitconfig: Device or resource busy" このエラーは、gitconfigでUIのカラー構成が設定されていない場合に発生します。この構成は、Git 1.8.4 以降のバージョンではデフォルトで設定されています。次のコマンドを実行して、アカウントでカラー表示を有効にします。 git config --global color.ui auto Copy to clipboard - "[Error]: Failed preparing build for compilation. Error: Error setting docker credentials. Error: “Error saving credentials: error closing temp file: close /usr2/<userid>/.docker/config.json3322274803: disk quota exceeded\n”" QSC CLI はホームディレクトリで数キロバイトのみを使用します。ホームディレクトリから数キロバイトをクリアしてください。 - "[Error]: The “path” argument must be of type string. Received undefined" **エラーの抜粋** qsc-cli chip-software download --workspace-path '/local/mnt/workspace//K2L/QSC_CLI_BUILD/build' --product 'QCM6490.LE.1.0' --release 'r00270.1' --distribution 'Qualcomm_Linux.SPF.1.0|TEST|DEVICE|PUBLIC' [Info]: Starting qsc-cli version 0.0.0.7 (node:2924765) ExperimentalWarning: The Fetch API is an experimental feature. This feature could change at any time (Use `qsc-cli --trace-warnings ...` to show where the warning was created) [Info]: Checking if Workspace already exists [Info]: Saved updated Workspace info [Info]: Workspace Setup Completed [Error]: The "path" argument must be of type string. Received undefined Copy to clipboard **解決策** このエラーは QSC CLI が Qlauncher と互換性がない場合に発生します。Qlauncherは非推奨となり、QSCの新しいアプリケーションに置き換えられる予定です。ワークスペースにQlauncherがある場合は、以下のコマンドを実行してください。 # Find your workspace within the Qlauncher UI # Take a backup of the following metadata file if you want to preserve the older workspace created with Qlauncher. # These will work only with Qlauncher app. You can reinstall the app at a later time again to access. If you don't # need the workspaces, you can delete this file using: mv /var/lib/qcom/data/qualcomm_launcher/workspaces2.json /var/lib/qcom/data/qualcomm_launcher/workspaces2.json.bak # Uninstall Qlauncher with the following command: qsc-cli tool uninstall qualcomm_launcher Copy to clipboard - "Docker： Error response from daemon: error while creating mount source path ‘/usr2/<userid>/.netrc’: mkdir /usr2/<userid>/.netrc: permission denied" **エラーの抜粋** Updating files: 100% (64/64), done. 2024-02-29T07:58:00: Sync Command Completed 2024-02-29T07:58:01: Finished setup. [Info]: Setting Docker Credential 2024-02-29T07:58:03: Authorization successful 2024-02-29T07:58:03: Sync Command Starting 2024-02-29T07:58:03: Running Sync Command for SyncOpenSourceCode - DownloadOpenSource docker: Error response from daemon: error while creating mount source path '/usr2/ramevelp/.netrc': mkdir /usr2/ramevelp/.netrc: permission denied. 2024-02-29T07:58:04: Sync Command Failed [Error]: Failed SP Download with error: 2024-02-29T07:58:04: Sp Download failed. ExitCode: 126 Signal: 0 with errorcode 4 [Error]: 2024-02-29T07:58:04: Sp Download failed. ExitCode: 126 Signal: 0 Copy to clipboard **解決策** IT 部門によるホームディレクトリのセットアップ内容によっては、このエラーが発生することがあります。ホームディレクトリに他に変更がないか IT 管理者に問い合わせてください。 - "fatal: couldn’t find remote ref refs/heads/qcom-linuxSTXscarthgap" PDF からコマンドをコピーすると文字化けが起きる場合は、その文字化けを削除するか、適切な記号に置き換えてから、コマンドを再実行してください。 **例** # Replace the following command repo init -u https://github.com/quic-yocto/qcom-manifest -b qcom-linuxSTXscarthgap -m qcom-6.6.90-QLI.1.5-Ver.1.1.xml # with repo init -u https://github.com/quic-yocto/qcom-manifest -b qcom-linux-scarthgap -m qcom-6.6.90-QLI.1.5-Ver.1.1.xml Copy to clipboard - "pull access denied for 032693710300.dkr.ecr.us-west-2.amazonaws.com/stormchaser/ql-tool" このエラーは、`qsc-cli` ダウンロードコマンドの実行中に発生する可能性があります。 **エラーの抜粋** Unable to find image '032693710300.dkr.ecr.us-west-2.amazonaws.com/stormchaser/ql-tool:20.04.20231220102843864.9' locally docker: Error response from daemon: pull access denied for 032693710300.dkr.ecr.us-west-2.amazonaws.com/stormchaser/ql-tool, repository doesn't exist or may require 'docker login': denied: Your authorization token has expired. Reauthenticate and try again. Copy to clipboard **解決策** rm -rf ~/.docker/config.json Copy to clipboard `qsc-cli` コマンドを再実行します。 ## ビルド - "ERROR: linux-kernel-qcom-6.6-r0 do\_menuconfig: No valid terminal found, unable to open devshell" このエラーは `bitbake linux-kernel-qcom -c menuconfig` コマンドの実行中に発生する可能性があります。 **エラーの抜粋** ERROR: linux-kernel-qcom-6.6-r0 do_menuconfig: No valid terminal found, unable to open devshell. Tried the following commands: tmux split-window -c "{cwd}" "do_terminal" tmux new-window -c "{cwd}" -n "linux-kernel-qcom Configuration" "do_terminal" xfce4-terminal -T "linux-kernel-qcom Configuration" -e "do_terminal" terminology -T="linux-kernel-qcom Configuration" -e do_terminal Copy to clipboard **解決策** sudo apt install screen sudo apt install tmux Copy to clipboard - "NOTE: No reply from server in 30s" `qsc-cli chip-software compile` コマンドまたは `bitbake` コマンドの再実行でのビルド中にこのエラーが表示される場合、部分的にビルドされたワークスペースから `bitbake.lock` 、 `bitbake.sock` 、 `hashserve.lock` を削除してからビルドを再試行してください。たとえば、`qsc-cli` でビルドを行う場合、これらのファイルは `/DEV/LE.QCLINUX.1.0.r1/build-qcom-wayland` の下にあります。 - "do\_fetch: BitBake Fetcher Error: FetchError(‘Unable to fetch URL from any source’)" これは断続的なフェッチ・エラーです。お客様側のネットワークやホストに問題がないか、または問題を引き起こしているサーバーがないか確認してください。gitリポジトリのフェッチ中にエラーが発生する場合は、`postBuffer` ファイルの `maxRequestBuffer` および `.gitconfig` の設定値を増やすことができます。`qsc-cli` を使用している場合、これらの設定はすでに `qsc-cli` ツールによって処理されています。 git config --global http.postBuffer 1048576000 git config --global http.maxRequestBuffer 1048576000 Copy to clipboard これらの構成が機能していない場合、コンパイルを再試行することで、このような断続的なエラーに対処することができます。 一部の大規模な git プロジェクトでは、このエラーが発生することがあります。このような場合は、プロジェクトを手動でクローンします。 cd /downloads/git2/ git clone --bare --mirror https:///.git /downloads/git2/.git touch /downloads/git2/.git.done Copy to clipboard たとえば、`qualcomm_linux-spf-1-0-le-qclinux-1-0-r1_api-linux_history_prebuilts.git` の `do_fetch` に失敗した場合、次のコマンドを実行します。 git clone --bare --mirror https://qpm-git.qualcomm.com/home2/git/revision-history/qualcomm_linux-spf-1-0-le-qclinux-1-0-r1_api-linux_history_prebuilts.git /downloads/git2/qpm-git.qualcomm.com.home2.git.revision-history.qualcomm_linux-spf-1-0-le-qclinux-1-0-r1_api-linux_history_prebuilts.git touch /downloads/git2/qpm-git.qualcomm.com.home2.git.revision-history.qualcomm_linux-spf-1-0-le-qclinux-1-0-r1_api-linux_history_prebuilts.git.done Copy to clipboard `.done` ファイルを作成したら、`bitbake ` コマンドを実行します。初期ビルドが完了したら、自身の [ダウンロード・ディレクトリ](https://docs.yoctoproject.org/4.0.16/singleindex.html#term-DL_DIR) をセットアップすることをお勧めします。 - "make[4]: /bin/sh: Argument list too long" これは、ワークスペースのパスが 90 文字を超えると発生します。このエラーを回避するには、ワークスペースのパスを短くしてください。 - "kernel-source/arch/arm64/boot/dts/qcom/qcm6490-idp.dts:8:10: fatal error: dt-bindings/iio/qcom,spmi-adc7-pmk8350.h: No such file or directory" `qcom,spmi-adc7-pmk8350.h` ファイルは、カーネルソース `/include/dt-bindings/iio/qcom,spmi-adc7-pmk8350.h` に含まれています。 1. このファイルのワークスペースをチェックし、このファイルを選ぶように環境が適切に初期化されていることを確認します。dtbsのコンパイル時、カーネル・ビルド・システムはGCCプリプロセッサーを実行し、dtsファイルの定義を使用してそのマクロを置き換えます。前述のパスは、複数の `includes` が存在する場所の1つです。 2. git の設定で `core.symlinks` が `false` に設定されているか確認します。もしそうなら、true に設定します。 git config --global core.symlinks true Copy to clipboard - "qpm-git.qualcomm.com.home2.git.revision-history.qualcomm\_linux-spf-1-0-le-qclinux-1-0-r1\_api-linux\_history\_prebuilts.git –progress failed with exit code 128, no output" 128はマスキング・エラーであり、このエラーは、お客様側のネットワークの問題であるか、Qualcommまたはアップストリーム・ミラーへのアクセスに関する純粋な問題である可能性があるため、さらなるトリアージが必要です。このエラーの回避策については、[BitBake Fetcherエラー](https://docs.qualcomm.com/doc/80-70020-254J/topic/troubleshoot_sync_build_and_flash.html#do-fetch-error-1) を参照してください。フェッチ中に次の手順に従って詳細ログをダンプすることで、さらにトリアージすることができます。 デフォルトでは、Yoctoのgit fetchでは詳細ログは有効になっていません。すべてのレシピでgit詳細ログを有効にすると、ビルド時間が大幅に増加します。必要に応じて、必要なレシピでのみ有効化することをお勧めします。すべてのgitプロジェクトで同じように有効化するには、`local.conf` ファイルを編集して、`BB_GIT_VERBOSE_FETCH` の値を **1** に変更します。また、詳細ログは、レシピごとに有効化することもできます。たとえば、diagレシピの `do_fetch()` エラーの詳細ログおよびデバッグを有効化するには、次の手順を実行します。 1. `layers/meta-qcom-hwe/recipes-bsp/diag/daig_15.0.bb` を編集して行 `BB_GIT_VERBOSE_FETCH = "1"` を追加します。 2. `bitbake -fc cleanall diag` を使用して、以前にダウンロードしたアーティファクトをクリーンします。 3. `bitbake -fc fetch diag` を使用してソースを再度取得します。 4. diagレシピの作業ディレクトリ `build-qcom-wayland/tmp-glibc/work/qcm6490-qcom-linux/diag/15.0-r0/temp` で利用可能な詳細ログを含むログを取得します。 5. このパスの `log.do_fetch` をクアルコムのサポートチームと共有します。 - "Failed SP Download with error: <> Sp Download failed. ExitCode: 128 Signal: 0 with errorcode 4" **エラーの抜粋** warning: redirecting to https://git-na-ssl.chipcode.qti.qualcomm.com/57f0ec058e47f7a82b2de7b95111c74a/qualcomm/qualcomm-linux-spf-1-0_ap_standard_oem_nomodem.git/ remote: Counting objects: 129803, done. remote: Compressing objects: 100% (114948/114948), done. fatal: write error: No space left on device5 GiB | 1.63 MiB/s fatal: fetch-pack: invalid index-pack output 2024-03-02T14:32:18: Sync Command Failed [Error]: Failed SP Download with error: 2024-03-02T14:32:18: Sp Download failed. ExitCode: 128 Signal: 0 with errorcode 4 [Error]: 2024-03-02T14:32:18: Sp Download failed. ExitCode: 128 Signal: 0 Copy to clipboard **解決策** エラーログの "fatal: write error: No space left on device" は、デバイスに空き容量がないことを示しています。 容量をクリーンアップして、再実行してください。 - "File “/usr/lib/python3.10/locale.py”, line 620, in setlocale return \_setlocale(category, locale)locale.Error: unsupported locale setting" このエラーを解決するには、以下のコマンドを実行し、再コンパイルします。 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 - "layer directories do not exist build-qcom-wayland/conf/../../layers/meta-qcom-qim-product-sdk" このエラーは以下のいずれかの理由で発生します。 - `meta-qcom-qim-product-sdk` のGit cloneが正常に完了しなかった。 - `meta-qcom-qim-product-sdk` レイヤーがEXTRALAYERSにエクスポートされていない。 **エラーの抜粋** xxxx@xxxx:~/github_un/build-qcom-wayland$ bitbake qcom-multimedia-image ERROR: The following layer directories do not exist: ERROR: /build-qcom-wayland/conf/../../layers/meta-qcom-qim-product-sdk ERROR: Please check BBLAYERS in /build-qcom-wayland/conf/bblayers.conf Copy to clipboard **解決策** 1. `build-qcom-wayland` ディレクトリを削除します。 2. [Qualcomm IM SDK イメージのビルド](https://docs.qualcomm.com/doc/80-70020-254J/topic/github_workflow_unregistered_users.html#build-qimp-sdk-image-unreg) で、コマンドを再実行してください。 - "failed: database disk image is malformed. abort()ing pseudo client by server request" Pseudoツールは、ファイル・システム操作を処理する際に、パスの不一致やデータベースの破損の問題に遭遇します。PseudoがYoctoプロジェクトのファイル・システム操作をシミュレートする際、ファイルパスや権限を処理する過程で問題が発生する場合があります。 これは [Yoctoコミュニティ](https://wiki.yoctoproject.org/wiki/Pseudo_Abort) では既知の問題です。 **解決策** 以下のコマンドを実行します。 rm -rf /build-qcom-robotics-ros2-humble/tmp-glibc bitbake -c cleanall pseudo-native & bitbake pseudo-native ../qirp-build qcom-robotics-full-image Copy to clipboard - "pyinotify.WatchManagerError: No space left on device (ENOSPC)" このエラーはコンパイル時に発生します。 **解決策** 以下のコマンドを実行します。 sudo su echo 1048576 > /proc/sys/fs/inotify/max_user_watches Copy to clipboard ## フラッシュ 既知のエラーはありません。 Last Published: Dec 23, 2025 [Previous Topic ソフトウェアイメージのフラッシュ](https://docs.qualcomm.com/bundle/publicresource/80-70020-254J/topics/flash_images.md) [Next Topic 方法](https://docs.qualcomm.com/bundle/publicresource/80-70020-254J/topics/how_to.md)