# 入门指南
以下工作流程展示了如何在 Qualcomm 设备上开始使用图形应用程序。
**图：图形应用程序的工作流**
## 基于 OpenGL ES 的应用程序
`glmark2` 是 Platform eSDK 中提供的基于 OpenGL ES 的示例应用程序。
**前提条件**
- 使用以下任一方法安装 Platform eSDK：
- [使用 Qualcomm 发布存档](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-51/install-sdk.html#download-qim-platform-esdk)
- [手动编译 Qualcomm Linux SDK](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-254/how_to.html#generate-an-esdk)
- 建立从 Linux 主机到设备的 SSH 连接。相关说明，可参见 [SSH 使用指南](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-254/how_to.html#use-ssh)。
- 确保 Weston 应用程序正在运行。否则，请通过运行以下命令启动 Weston 应用程序：
>
>
> . /etc/profile
> Copy to clipboard
>
>
> export XDG_RUNTIME_DIR=/dev/socket/weston
> Copy to clipboard
>
>
> mkdir --parents $XDG_RUNTIME_DIR
> Copy to clipboard
>
>
> chmod 0700 $XDG_RUNTIME_DIR
> Copy to clipboard
>
>
> cd /usr/bin/
> Copy to clipboard
>
>
> killall weston
> Copy to clipboard
>
>
> ./weston --tty=2 --continue-without-input
> Copy to clipboard
>
>
> 关于 Weston 应用程序的更多信息，请参阅 [Qualcomm Linux 显示指南](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-18)。
关于 Qualcomm Linux 设备上支持的 OpenGL ES 扩展信息，请参阅 [EGL 扩展](https://docs.qualcomm.com/doc/80-70017-19SC/topic/supported_extensions.html#supported-egl-client-extensions)。
**编译并运行glmark2 应用程序**
1. 要在 Linux 主机上设置 SDK 环境，请运行以下命令：
source environment-setup-armv8-2a-qcom-linux
Copy to clipboard
2. 要编译并生成二进制文件，请运行以下命令：
devtool modify glmark2
Copy to clipboard
devtool build glmark2
Copy to clipboard
如果遇到任何 umask 错误，请将 umask 设置为 022。
编译成功后，在 `/workspace/sources/glmark2/oe-workdir/image/usr/bin` 目录下生成输出文件。
3. 要将二进制文件推送到设备，请运行以下命令：
scp -r /workspace/sources/glmark2/oe-workdir/image/usr/bin/glmark2-es2-wayland root@[IP-address-of-device]:/tmp
Copy to clipboard
scp -r /workspace/sources/glmark2/oe-workdir/image/usr/share/glmark2 root@[IP-address-of-device]:/tmp
Copy to clipboard
4. 要在设备上运行应用程序，请使用设备的 IP 地址打开 SSH 终端并运行以下命令：
export XDG_RUNTIME_DIR=/dev/socket/weston export WAYLAND_DISPLAY=wayland-1
Copy to clipboard
chmod 777 /tmp/glmark2-es2-wayland
Copy to clipboard
chmod -R 777 /tmp/glmark2
Copy to clipboard
cd /tmp
Copy to clipboard
./glmark2-es2-wayland --data-path /tmp/glmark2 -b jellyfish
Copy to clipboard
Note
请使用以下命令重新挂载文件系统，以便从 UART shell 运行示例应用程序：
mount -o remount,rw /
Copy to clipboard
## 基于 OpenCL 的应用程序
Adreno OpenCL SDK 提供多个示例程序。编译和运行任何示例应用程序的步骤均相同。
Note
目前，Qualcomm Linux 支持 OpenCL v2.1。
**前提条件**
- 使用以下任一方法安装 Platform eSDK：
- [使用 Qualcomm 发布存档](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-51/install-sdk.html#download-qim-platform-esdk)
- [手动编译 Qualcomm Linux SDK](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-254/how_to.html#generate-an-esdk)
- 建立从 Linux 主机到设备的 SSH 连接。相关说明，可参见 [SSH 使用指南](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-254/how_to.html#use-ssh)。
- 下载 [Adreno OpenCL SDK](https://softwarecenter.qualcomm.com/#/catalog/item/Adreno_OpenCL_SDK)。
Note
只允许注册用户下载 Adreno OpenCL SDK。
关于 Qualcomm Linux 设备上支持的 OpenCL 扩展信息，请参阅 [OpenCL 扩展](https://docs.qualcomm.com/doc/80-70017-19SC/topic/supported_extensions.html#supported-opencl-extensions)。
**编译并运行 hello world 示例应用程序**
1. 要编译应用程序，请在 Linux 主机上运行以下命令：
cd opencl-sdk
Copy to clipboard
source /environment-setup-armv8-2a-qcom-linux
Copy to clipboard
cmake -B build -DCLSDK_OPENCL_LIBRARY=$OECORE_TARGET_SYSROOT/usr/lib/libOpenCL.so -DCLSDK_DMABUFHEAP_LIBRARY=$OECORE_TARGET_SYSROOT/usr/lib/libdmabufheap.so -DOPEN_EMBEDDED=1
Copy to clipboard
cmake --build build
Copy to clipboard
编译成功后，在 `/build` 目录下生成二进制文件。
2. 要运行应用程序，请使用设备的 IP 地址打开 SSH 终端并运行以下命令：
mkdir -p /opt/data
Copy to clipboard
mkdir -p /opt/data/opencl
Copy to clipboard
Note
如果您想从 UART shell 运行示例应用程序，请使用以下命令重新挂载文件系统：
mount -o remount,rw /
Copy to clipboard
3. 要将二进制文件推送到设备，请运行以下命令：
scp -r /build/* root@[IP-address-of-the device]:/opt/data/opencl/
Copy to clipboard
scp -r /example_images/* root@[IP-address-of-the device]:/opt/data/opencl/
Copy to clipboard
4. 请使用 SSH 终端在设备上运行以下命令，以便启动应用程序：
cd /opt/data/opencl/
Copy to clipboard
mkdir out
Copy to clipboard
chmod 777 ./*
Copy to clipboard
echo "run hello world 2.0 opencl sdk" > hello_world_input.txt
Copy to clipboard
touch out/hello_world_output.txt
Copy to clipboard
cat out/hello_world_output.txt
Copy to clipboard
./cl_sdk_hello_world hello_world_input.txt out/hello_world_output.txt
Copy to clipboard
cat out/hello_world_output.txt
Copy to clipboard
## 基于 Vulkan 的应用程序
Adreno SDK 中提供了多个 Vulkan 示例程序。编译和运行任何示例应用程序的步骤均相同。本指南以运行 Sascha Willems 和 Khronos Vulkan 示例程序的步骤为例进行了说明。
**前提条件**
- 使用以下任一方法安装 Platform eSDK：
- [使用 Qualcomm 发布存档](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-51/install-sdk.html#download-qim-platform-esdk)
- [手动编译 Qualcomm Linux SDK](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-254/how_to.html#generate-an-esdk)
- 建立从 Linux 主机到设备的 SSH 连接。相关说明，可参见 [SSH 使用指南](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-254/how_to.html#use-ssh)。
关于 Qualcomm Linux 设备上支持的 Vulkan 扩展的信息，请参阅 [Vulkan 扩展](https://docs.qualcomm.com/doc/80-70017-19SC/topic/supported_extensions.html#supported-vulkan-extensions)。
### 基于 Vulkan 的 Sascha Willems 应用程序
Sascha Willems Vulkan 示例程序位于 [https://github.com/SaschaWillems/Vulkan.git](https://github.com/SaschaWillems/Vulkan.git)。 编译和运行任何 Sascha Willems Vulkan 应用程序的步骤均相同。
**编译并运行三角形 bin 示例应用程序**
1. 要编译应用程序，请在 Linux 主机上运行以下命令：
git clone --recurse-submodules https://github.com/SaschaWillems/Vulkan.git
Copy to clipboard
cd Vulkan
Copy to clipboard
source /environment-setup-armv8-2a-qcom-linux
Copy to clipboard
cmake -G "Unix Makefiles" -Bbuild/linux -DUSE_WAYLAND_WSI=ON -DRESOURCE_INSTALL_DIR="/tmp/"
Copy to clipboard
cmake --build build/linux --config Release -j$(nproc)
Copy to clipboard
编译成功后，在 `build/linux/bin` 目录下生成二进制文件。
2. 要将二进制文件推送到设备，请运行以下命令：
cd Vulkan
Copy to clipboard
scp -r assets root@[IP-address-of-device]:/tmp/
Copy to clipboard
scp -r shaders root@[IP-address-of-device]:/tmp/
Copy to clipboard
scp -r build/linux/bin/triangle root@[IP-address-of-device]:/tmp/
Copy to clipboard
3. 要运行应用程序，请使用设备的 IP 地址打开 SSH 终端并运行以下命令：
cd /tmp
Copy to clipboard
chmod -R 777 assets/
Copy to clipboard
chmod -R 777 shaders/
Copy to clipboard
chmod 777 triangle
Copy to clipboard
export XDG_RUNTIME_DIR=/dev/socket/weston export WAYLAND_DISPLAY=wayland-1
Copy to clipboard
./triangle
Copy to clipboard
### 基于 Khronos Vulkan 的应用程序
Khronos Vulkan 示例程序位于 [https://github.com/KhronosGroup/Vulkan-Samples.git](https://github.com/KhronosGroup/Vulkan-Samples.git)。编译和运行任何 Khronos Vulkan 应用程序的步骤均相同。
**编译并运行 vulkan\_samples 应用程序**
1. 要编译应用程序，请在 Linux 主机上运行以下命令：
sudo apt-get install -y libwayland-dev
Copy to clipboard
git clone --recurse-submodules https://github.com/KhronosGroup/Vulkan-Samples.git
Copy to clipboard
cd Vulkan-Samples/
Copy to clipboard
source /environment-setup-armv8-2a-qcom-linux
Copy to clipboard
cmake -G "Unix Makefiles" -Bbuild/linux -DCMAKE_BUILD_TYPE=Release -DVKB_WSI_SELECTION=WAYLAND -DGLFW_BUILD_X11=OFF
Copy to clipboard
如果编译失败，则执行以下操作：
a.打开 `Vulkan-Samples/build/linux/CmakeCache.txt` 文件。
b.将 `GLFW_BUILD_X11` 更改为 `OFF`。
2. 要生成二进制文件，请运行以下命令：
cmake --build build/linux --config Release --target vulkan_samples -j$(nproc)
Copy to clipboard
编译成功后，在 `Vulkan-Samples/build/linux/app/bin/Release/aarch64` 目录下生成二进制文件。
3. 要将二进制文件推送到设备，请运行以下命令：
cd Vulkan-Samples
Copy to clipboard
scp -r assets root@[IP-address-of-device]:/tmp/
Copy to clipboard
scp -r shaders root@[IP-address-of-device]:/tmp/
Copy to clipboard
scp -r build/linux/app/bin/Release/aarch64/vulkan_samples root@[IP-address-of-device]:/tmp/
Copy to clipboard
4. 要运行应用程序，请使用设备的 IP 地址打开 SSH 终端并运行以下命令：
cd /tmp
Copy to clipboard
chmod -R 777 assets/
Copy to clipboard
chmod -R 777 shaders/
Copy to clipboard
chmod 777 vulkan_samples
Copy to clipboard
export XDG_RUNTIME_DIR=/dev/socket/weston export WAYLAND_DISPLAY=wayland-1
Copy to clipboard
./vulkan_samples sample swapchain_images
Copy to clipboard
Note
如果由于存储问题而无法从 `/tmp` 目录运行这些示例应用程序，请尝试其他目录，例如 `/etc`。
Last Published: Jan 23, 2025
[Previous Topic
概述](https://docs.qualcomm.com/bundle/publicresource/80-70017-19SC/topics/graphics-overview.md) [Next Topic
工具](https://docs.qualcomm.com/bundle/publicresource/80-70017-19SC/topics/graphics_developer_tools.md)