# Khắc phục sự cố ## Docker - **docker: Cannot connect to the Docker daemon atunix:///var/run/docker.sock. Is the docker daemon running?** Chạy lệnh sau để khởi động Docker: sudo systemctl start docker Copy to clipboard - **Lỗi Phản hồi từ daemon: Get “https://registry-1.docker.io/v2/”: http: server gave HTTP response to HTTPS client** Thêm một bản sao Docker registry nội bộ (ví dụ: cài đặt mạng nội bộ Qualcomm). Ghi chú Không thêm bình luận có dấu # trong tệp cấu hình JSON. Việc dùng ký tự tab thay cho space và các ký tự khoảng trắng không hiển thị khác có thể làm hỏng chức năng của tệp cấu hình JSON và cũng có thể khiến `docker.service` không khởi động được. 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 Ghi chú Ngoài ra, bạn có thể thêm mục sau vào `/etc/docker/daemon.json`: `"registry-mirrors": ["https://ccr.ccs.tencentyun.com"]` Khởi động lại dịch vụ Docker để áp dụng cài đặt mới. sudo systemctl restart docker Copy to clipboard - **Không tải xuống được từ https://download.docker.com** Ghi chú Nếu bạn không thể truy cập hoặc tải xuống từ [https://download.docker.com](https://download.docker.com), hãy chạy các lệnh sau để cài đặt 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 - **Lỗi Docker do không bật Ảo hóa** Hãy bật ảo hóa từ BIOS để khắc phục lỗi này. Làm theo hướng dẫn cụ thể của nhà cung cấp hệ thống để bật ảo hóa. Ví dụ: các bước sau do nhà cung cấp hệ thống cung cấp có thể bật ảo hóa: 1. Khi hệ thống đang khởi động, hãy vào BIOS. Cửa sổ BIOS sẽ xuất hiện. 2. Chuyển sang tab Advanced. 3. Trong phần CPU Configuration, hãy đặt Virtualization Technology thành enabled. 4. Lưu và thoát. 5. Khởi động lại hệ thống. - **Quyền truy cập bị từ chối khi cố gắng kết nối đến socket của Docker daemon tại địa chỉ unix:///var/run/docker.sock** Lỗi này xảy ra khi `qsc-cli` đã được cài đặt trên máy và bạn không phải là thành viên của nhóm Docker: sudo groupadd docker sudo usermod -aG docker $USER newgrp docker Copy to clipboard Để xác nhận rằng bạn là thành viên của nhóm Docker, hãy chạy lệnh sau: 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 Đăng xuất rồi đăng nhập lại để quyền truy cập có hiệu lực. # 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 ## Đồng bộ hóa - **Lỗi repo init hoặc đồng bộ hóa với thông báo except ManifestInvalidRevisionError, e:** Bạn có thể thấy lỗi này sau khi cài đặt gói Repo: - Nếu bạn có lệnh chuyển hướng trong `/etc/gitconfig` hoặc `~/.gitconfig` đến một bản sao nội bộ. - Nếu bản sao nội bộ có thêm tiền tố ở các nhánh trong quá trình sao chép. Ví dụ: nếu `/etc/gitconfig` chuyển hướng và bản sao nội bộ nhánh `stable` từ git repo gốc được đổi thành `aosp/stable`, thì lỗi sau sẽ xuất hiện khi thực hiện lệnh `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 Sau đây là các bước khắc phục lỗi này: # Remove the older .repo folder. This will be in the directory where you ran 'repo init' command earlier rm -rf .repo # Export and run the repo commands to fix the repo issues. The REPO_REV must point to the mirrored # branch from upstream 'stable' branch of https://gerrit.googlesource.com/git-repo export REPO_REV='aosp/stable' Copy to clipboard - **Cài đặt repo “Server certificate verification failed”** Nếu bạn thấy lỗi chứng chỉ như ‘Server certificate verification failed. CAfile: none CRLfile: none’, hãy đặt cấu hình git để vô hiệu hóa xác minh chứng chỉ SSL bằng cấu hình git. Hãy thảo luận với quản trị viên CNTT của bạn để được hướng dẫn thêm. Bạn có thể sử dụng một trong các lệnh sau để vô hiệu hóa SSL: export GIT_SSL_NO_VERIFY=1 git config --global http.sslverify false Copy to clipboard Nếu khu vực của bạn đang chặn quyền truy cập vào `android.googlesource`, hãy thử cấu hình sau để tải Repo từ CodeLinaro Mirror: 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 orresource busy** Lỗi này xảy ra khi gitconfig của bạn không đặt cấu hình màu UI. Cấu hình này được đặt theo mặc định trong Git 1.8.4 và các phiên bản mới hơn. Chạy lệnh sau để bật hiển thị màu trong tài khoản của bạn: git config --global color.ui auto Copy to clipboard - **[Error]: Failed preparing build for compilation. Error: Errorsetting docker credentials. Error: “Error saving credentials: errorclosing temp file: close/usr2/<userid>/.docker/config.json3322274803: disk quotaexceeded\n”** QSC CLI chỉ sử dụng thư mục home cho một vài kilo byte (kB). Hãy xóa một vài MB khỏi thư mục home của bạn. - **[Error]: The “path” argument must be of type string. Receivedundefined** **Trích dẫn lỗi** qsc-cli 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 **Giải pháp** Lỗi này có thể xảy ra nếu QSC CLI không tương thích với Qlauncher. Qlauncher sẽ bị loại bỏ và được thay thế bằng một ứng dụng mới từ QSC. Nếu có Qlauncher trong không gian làm việc, bạn có thể chạy các lệnh sau: # 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: qpm-cli --uninstall qualcomm_launcher Copy to clipboard - **docker: Error response from daemon: error while creating mountsource path ‘/usr2/<userid>/.netrc’: mkdir /usr2/<userid>/.netrc:permission denied** **Trích dẫn lỗi** 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 **Giải pháp** Lỗi này có thể xảy ra do cách bộ phận CNTT thiết lập thư mục home của bạn. Hãy làm việc với quản trị viên CNTT của bạn để biết bất kỳ thay đổi nào khác đối với thư mục home của bạn. - **fatal: couldn’t find remote ref refs/heads/qcom-linuxSTXscarthgap** Nếu bạn thấy bất kỳ ký tự rác nào khi sao chép lệnh từ PDF, hãy xóa hoặc thay thế các ký tự rác bằng các ký hiệu thích hợp và chạy lại lệnh. Bạn cũng có thể mở hướng dẫn ở chế độ HTML và sử dụng tùy chọn lệnh sao chép. **Ví dụ** # Replace the following command repo init -u https://github.com/quic-yocto/qcom-manifest -b qcom-linuxSTXscarthgap -m qcom-6.6.65-QLI.1.4-Ver.1.1.xml # with repo init -u https://github.com/quic-yocto/qcom-manifest -b qcom-linux-scarthgap -m qcom-6.6.65-QLI.1.4-Ver.1.1.xml Copy to clipboard - **pull access denied for 032693710300.dkr.ecr.us-west-2.amazonaws.com/stormchaser/ql-tool** Lỗi này có thể xảy ra khi chạy lệnh tải xuống `qsc-cli`. **Trích dẫn lỗi** 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 **Giải pháp** rm -rf ~/.docker/config.json Copy to clipboard Hãy chạy lại lệnh `qsc-cli`. ## Biên dịch - **ERROR: linux-kernel-qcom-6.6-r0 do\_menuconfig: No valid terminalfound, unable to open devshell** Lỗi này có thể kích hoạt khi chạy lệnh `bitbake linux-kernel-qcom -c menuconfig`. **Trích dẫn lỗi** 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 **Giải pháp** sudo apt install screen sudo apt install tmux Copy to clipboard - **NOTE: No reply from server in 30s** Nếu bạn thấy lỗi này trong quá trình biên dịch khi chạy lại lệnh `qsc-cli compile` hoặc `bitbake`, bạn có thể xóa `bitbake.lock`, `bitbake.sock` và `hashserve.lock` khỏi không gian làm việc và thử biên dịch lại. Ví dụ: nếu bạn đang biên dịch bằng `qsc-cli`, thì các tệp này nằm trong `/DEV/LE.QCLINUX.1.0.r1/build-qcom-wayland`. - **do\_fetch: BitBake Fetcher Error: FetchError(‘Unable to fetch URLfrom any source’)** Đây là những lỗi tảỉ xuống không thường xuyên. Kiểm tra xem có sự cố mạng/máy chủ ở phía bạn không, nếu không, hãy kiểm tra xem máy chủ có gây ra sự cố này không. Bạn có thể tăng giá trị thiết lập `postBuffer` và `maxRequestBuffer` trong tệp `.gitconfig` nếu lỗi xảy ra trong khi truy xuất git repositories. Nếu bạn đang dùng `qsc-cli` thì các cấu hình này đã được công cụ `qsc-cli` xử lý: git config --global http.postBuffer 1048576000 git config --global http.maxRequestBuffer 1048576000 Copy to clipboard Nếu các cấu hình này không hoạt động, bạn có thể thử biên dịch lại để khắc phục các lỗi không thường xuyên này thường gặp trong lần biên dịch đầu tiên. Một số dự án git lớn có thể hiển thị lỗi này. Đối với các dự án như vậy, một lựa chọn khả thi là sao chép thủ công như sau: cd /downloads/git2/ git clone --bare --mirror https:///.git /downloads/git2/.git touch /downloads/git2/.git.done Copy to clipboard Ví dụ: khi lệnh `do_fetch` không thành công cho `qualcomm_linux-spf-1-0-le-qclinux-1-0-r1_api-linux_history_prebuilts.git`, hãy chạy lệnh sau: 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 Sau khi tạo tệp `.done`, hãy tiếp tục với lệnh `bitbake `. Sau khi hoàn tất biên dịch lần đầu, bạn nên thiết lập [thư mục tải xuống](https://docs.yoctoproject.org/4.0.16/singleindex.html#term-DL_DIR) của riêng mình. - **make[4]: /bin/sh: Argument list too long** Lỗi này xảy ra khi đường dẫn của không gian làm việc vượt quá 90 ký tự. Hãy rút gọn đường dẫn không gian làm việc để tránh lỗi này. - **kernel-source/arch/arm64/boot/dts/qcom/qcm6490-idp.dts:8:10: fatalerror: dt-bindings/iio/qcom,spmi-adc7-pmk8350.h: No such file ordirectory** Tệp được đề cập đến `qcom,spmi-adc7-pmk8350.h` là một phần trong mã nguồn của kernel `/include/dt-bindings/iio/qcom,spmi-adc7-pmk8350.h`. Kiểm tra không gian làm việc để tìm tệp này và khởi tạo môi trường để chọn tệp này. Trong khi biên dịch dtbs, hệ thống biên dịch của kernel sẽ chạy bộ tiền xử lý GCC để thay thế các macro trong tệp dts theo định nghĩa tương ứng. Đường dẫn đã đề cập là một trong những nơi có lệnh `include`. Hãy kiểm tra xem bạn đã đặt `core.symlinks` thành `false` trong cấu hình git của mình chưa. Nếu có, hãy đặt thành 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 – tiến trình không thành công với mã thoát 128, không có đầu ra** 128 là lỗi bao quát và lỗi này cần được phân loại thêm vì có thể là sự cố mạng ở phía bạn hoặc sự cố thực sự khi truy cập Qualcomm hoặc các bản sao lưu chứa mã nguồn gốc (upstream). Để khắc phục lỗi này, hãy xem [BitBake Fetcher Error](https://docs.qualcomm.com/doc/80-70018-254V/topic/troubleshoot_sync_build_and_flash.html#do-fetch-error-1). Bạn có thể phân loại thêm bằng cách làm theo các hướng dẫn sau để xuất log chi tiết trong quá trình tải xuống. Theo mặc định, tính năng log chi tiết không được bật cho lệnh git fetch trong Yocto. Để bật tính năng này cho tất cả các dự án git, hãy chỉnh sửa tệp `local.conf` rồi thay đổi giá trị `BB_GIT_VERBOSE_FETCH` thành **1**. Bạn cũng có thể bật log chi tiết cho từng recipe. Ví dụ: để bật log chi tiết và gỡ lỗi lỗi `do_fetch()` trong diag recipe, hãy thực hiện các bước sau: 1. Chỉnh sửa `layers/meta-qcom-hwe/recipes-bsp/diag/daig_15.0.bb` rồi thêm dòng `BB_GIT_VERBOSE_FETCH = "1"`. 2. Dọn dẹp cấu phần phần mềm đã tải xuống trước đó bằng cách dùng `bitbake -fc cleanall diag`. 3. Tải lại mã nguồn bằng cách dùng `bitbake -fc fetch diag`. 4. Tải xuống với log chi tiết có trong thư mục làm việc của diag recipe `build-qcom-wayland/tmp-glibc/work/qcm6490-qcom-linux/diag/15.0-r0/temp`. 5. Chia sẻ `log.do_fetch` từ đường dẫn này với nhóm hỗ trợ của Qualcomm. Ghi chú Việc bật tính năng ghi log chi tiết trong git cho tất cả các recipes có thể làm tăng đáng kể thời gian biên dịch. Bạn chỉ nên bật tính năng này trong các recipes khi cần thiết. - **Failed SP Download with error: <> Sp Download failed. ExitCode: 128 Signal: 0 with errorcode 4** **Trích dẫn lỗi** 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 **Giải pháp** Log lỗi cho biết không có dung lượng trống trên thiết bị **“fatal: write error: No space left on device”**. Hãy dọn dẹp bộ nhớ rồi kích hoạt lại. - **File “/usr/lib/python3.10/locale.py”, line 620, in setlocale return\_setlocale(category, locale)locale.Error: unsupported localesetting** Để khắc phục lỗi này, hãy chạy các lệnh sau và biên dịch lại: 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** Lỗi này xảy ra do một trong những lý do sau: - Git clone `meta-qcom-qim-product-sdk` không hoàn tất thành công. - Lớp `meta-qcom-qim-product-sdk` không được xuất sang EXTRALAYERS. **Trích dẫn lỗi** 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 **Giải pháp** - Xóa thư mục `build-qcom-wayland`. - Chạy lại các lệnh trong [Biên dịch ảnh QIMP SDK](https://docs.qualcomm.com/doc/80-70018-254V/topic/github_workflow_unregistered_users.html#build-qimp-sdk-image-unreg). - **failed: database disk image is malformed. abort()ing pseudo client by server request** Công cụ Pseudo gặp phải sự cố không khớp đường dẫn và cơ sở dữ liệu bị hỏng khi xử lý các hoạt động của hệ thống tệp. Khi Pseudo mô phỏng các hoạt động của hệ thống tệp trong dự án Yocto, có thể xảy ra sự cố khi xử lý đường dẫn tệp và quyền. Đây là lỗi đã biết trong [cộng đồng Yocto](https://wiki.yoctoproject.org/wiki/Pseudo_Abort). **Giải pháp** Chạy các lệnh sau: 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)** Việc biên dịch gây ra lỗi này. **Giải pháp** Chạy các lệnh sau: sudo su echo 1048576 > /proc/sys/fs/inotify/max_user_watches Copy to clipboard ## Flash Không có lỗi đã biết nào. Last Published: Oct 23, 2025 [Previous Topic Flash ảnh phần mềm](https://docs.qualcomm.com/bundle/publicresource/80-70018-254V/topics/flash_images.md) [Next Topic Cách thức](https://docs.qualcomm.com/bundle/publicresource/80-70018-254V/topics/how_to.md)