> ## Documentation Index > Fetch the complete documentation index at: https://dragonwingdocs.qualcomm.com/llms.txt > Use this file to discover all available pages before exploring further. # 安装所需的软件包 要继续开发并在平台上成功运行 AI 和多媒体示例应用程序，请安装以下软件包。这些软件包共同提供了评估和开发 AI、视觉及多媒体用例所需的运行时库、开发工具、硬件加速支持和示例应用程序。 ## AI 和多媒体示例应用程序及框架 以下软件包使用 Qualcomm 优化的框架和硬件组件，实现 AI 推理、多媒体处理和图形加速： #### GStreamer 和 Qualcomm 多媒体示例 * gstreamer1.0-plugins-base-apps * gstreamer1.0-qcom-python-examples * gstreamer1.0-qcom-sample-apps * gstreamer1.0-tools 这些软件包提供 GStreamer 核心工具、Qualcomm 专用插件以及基于 Python 的示例应用程序，用于演示利用硬件加速的视频采集、编码/解码、AI 推理管道和多媒体串流。 #### AI 推理框架和工具 * libqnn-dev、qnn-tools * libsnpe-dev、snpe-tools * tensorflow-lite-qcom-apps 这些软件包包括 Qualcomm 神经网络（QNN）和 Snapdragon 神经处理引擎（SNPE）开发库、运行时组件和命令行工具。在 Qualcomm AI 加速器上运行和分析 AI 模型，以及执行针对平台优化的 TensorFlow Lite 模型时，均需要这些软件包。 #### 图形、视觉和计算加速 qcom-adreno1（仅适用于 Ubuntu Server）\ qcom-fastcv-binaries-dev 这些软件包启用 GPU 加速的图形渲染和基于 FastCV 的计算机视觉处理，对于高性能 AI 视觉和多媒体工作负载至关重要。 #### 多媒体和系统集成组件 * qcom-libdmabufheap-dev * qcom-video-firmware * qcom-sensors-test-apps 这些组件支持零拷贝缓冲区共享、硬件视频处理和传感器验证。高效的多媒体管道以及测试摄像头和基于传感器的 AI 用例均需要它们。 #### 显示和窗口支持 * weston-autostart（仅适用于 Ubuntu Server） * xwayland（仅适用于 Ubuntu Server） 这些软件包提供基于 Wayland 的显示管理和 X11 兼容性，使图形示例应用程序和多媒体演示能够在目标系统上正常运行。 #### 附加图形和计算支持（Ubuntu Desktop） * qcom-adreno-cl-dev * ppa:kisak/kisak-mesa * libegl-mesa0（已升级） 为支持高级 GPU 计算、图形互操作性和稳定的桌面显示管道，本设置还会额外安装上述组件。 **详情：** * 通过 qcom-adreno-cl-dev 在 Adreno 上启用基于 OpenCL 的 GPU 计算 * 通过 Kisak PPA 提供现代且稳定的 Mesa 图形栈 * 确保 Wayland/Weston、XWayland 和 GPU 加速桌面应用程序所需的 EGL 兼容性 ## 通用开发者工具和辅助实用程序 以下软件包是通用开发、调试、媒体处理和系统验证所必需的： * ffmpeg – 用于音视频测试的媒体处理和格式转换工具 * net-tools – 网络配置和调试工具 * pulseaudio-utils – 音频测试和播放工具 * python3-pip – 用于安装额外依赖项的 Python 包管理器 * selinux-utils – 用于管理和调试 SELinux 策略的工具 * unzip – 解压压缩归档文件的工具 * v4l-utils – 用于摄像头和视频设备测试的 Video4Linux 工具 * yavta - yavta 是一个简单的 V4L2 测试工具，用于在 Linux 系统上验证摄像头设备、支持的格式和帧采集 ## 安装 PPA 脚本 在主机上创建以下脚本，将其复制到目标设备，然后运行以安装上述软件包。 **注意：** 该脚本同时支持 Server 和 Desktop 构建。 ```shell theme={null} scp install_ppa_pkgs.sh ubuntu@IP_address:/home/ubuntu # Enter the device password ssh ubuntu@IP_address # Enter the device password chmod +x install_ppa_pkgs.sh ./install_ppa_pkgs.sh ``` **install\_ppa\_pkgs.sh 脚本：** ```bash theme={null} #!/bin/bash -e # Set '-x' only if the option is neither '-h' nor '--help' if [ $# -ne 1 ] || [ $# -gt 0 -a "$1" != "-h" -a "$1" != "--help" ]; then set -x fi # Configuration used by the script XDG_EXPORT="export XDG_RUNTIME_DIR=/run/user/\$(id -u ubuntu)" VERSION=0.1 [ -d $(dirname $(realpath $0))/.git ] && VERSION+=+$(git -C $(dirname $(realpath $0)) describe --always) # Common user and home dir for the ubuntu USER_NAME=ubuntu USER_HOME=$(eval echo "~$USER_NAME") # Usage function with colored output usage() { set +x printf "\033[1;37mUsage:\033[0m\n" printf " %s [options]\n" "$0" printf "\n" printf "\033[1;37mDescription:\033[0m\n" printf " Helps you quickly enable IQ9075's peripheral functions (CAM, AI, Audio, etc.)\n" printf "\n" printf "\033[1;37mOptions:\033[0m\n" printf "\033[1;37m -h, --help\033[0m Display this help message\n" } add_ppa() { sudo apt-get update } add_cam_ai_pkgs() { # CAM/AI -- QCOM PPA PKG_LIST+=( gstreamer1.0-plugins-base-apps gstreamer1.0-qcom-python-examples gstreamer1.0-qcom-sample-apps gstreamer1.0-tools libqnn-dev libsnpe-dev qcom-fastcv-binaries-dev qcom-libdmabufheap-dev qcom-sensors-test-apps qnn-tools snpe-tools tensorflow-lite-qcom-apps gstreamer1.0-plugins-qcom gstreamer1.0-libav gstreamer1.0-plugins-ugly ) } weston_xwayland_support() { if dpkg -l | grep -q '^ii ubuntu-desktop'; then echo "Desktop build detected (ubuntu-desktop)." # Desktop-specific packages PKG_LIST+=( qcom-adreno-cl-dev ) # Desktop-only: Update Mesa echo "Updating Mesa for Desktop build..." sudo add-apt-repository -y ppa:kisak/kisak-mesa sudo apt-get update sudo apt-get install --only-upgrade -y libegl-mesa0 else echo "Server build detected" # Server-specific packages PKG_LIST+=( qcom-adreno1 weston-autostart xwayland ) fi } setup_media_and_xdg() { if dpkg -l | grep -q '^ii ubuntu-desktop'; then echo "Desktop build detected (ubuntu-desktop)." else echo "Server build detected. Add following packages" sudo mkdir -p /etc/media sudo chown -R ubuntu /etc/media grep -qxF "$XDG_EXPORT" $USER_HOME/.bashrc || echo "$XDG_EXPORT" >> $USER_HOME/.bashrc sudo bash -c "grep -qxF '${XDG_EXPORT}' /root/.bashrc || echo '${XDG_EXPORT}' >> /root/.bashrc" fi } add_system_pkgs() { PKG_LIST+=( ffmpeg net-tools pulseaudio-utils python3-pip selinux-utils unzip v4l-utils yavta ) } install() { sudo apt-get install -y ${PKG_LIST[@]} sudo apt-get upgrade -y } finalize() { sync; sync; sync if [ $reboot -eq 1 ]; then echo "Setup completed. System will reboot in 10 seconds..." sleep 10 sudo reboot fi } # Main execution logic main() { echo "IQ9075 Setup Script" echo " Version $VERSION" echo "=======================" local reboot=1 # Parse arguments and execute accordingly while [ "$#" -gt 0 ]; do case "$1" in -h|--help) usage exit 0 ;; *) echo "Unknown option: $1" echo "Use --help for usage information" exit 1 ;; esac shift done add_ppa setup_media_and_xdg add_cam_ai_pkgs weston_xwayland_support add_system_pkgs install finalize echo "Script completed successfully!" } # Start the script main "$@" ``` 如果遇到软件包安装失败，请运行以下命令：'apt --fix-broken install' 成功安装上述软件包后，系统即可运行 Qualcomm 优化的 AI 推理工作负载、多媒体管道、摄像头和传感器应用程序以及图形示例演示。此安装还确保所有必需的开发者工具可用于验证、调试和持续的应用开发。 连接显示器后，将显示以下画面： **Ubuntu Server：** **Ubuntu Desktop：** **下一步：**\ 安装所需的软件包后，您可以继续前往 [**🔗AI 工作流**](../../ai-workflows/ai-workflows_overview)部分，或探索[**示例应用程序**](../../sample-applications/overview)。