# 入门指南
Source: [https://docs.qualcomm.com/doc/80-70015-19SC/topic/graphics-getting-started.html](https://docs.qualcomm.com/doc/80-70015-19SC/topic/graphics-getting-started.html)
以下工作流显示了如何在 Qualcomm 设备上开始使用图形应用程序。
Figure : 图形应用程序的工作流
## 运行 OpenGL ES 示例程序
Source: [https://docs.qualcomm.com/doc/80-70015-19SC/topic/graphics-getting-started.html](https://docs.qualcomm.com/doc/80-70015-19SC/topic/graphics-getting-started.html)
### About this task
**前提条件**
- 通过以下方式之一安装平台 eSDK：
- [使用 Qualcomm 发布存档](https://docs.qualcomm.com/bundle/publicresource/topics/80-70015-51/install-sdk.html#download-qim-platform-esdk)
- [手动编译 Qualcomm Linux SDK](https://docs.qualcomm.com/bundle/publicresource/topics/80-70015-254/how_to.html#generate-an-esdk)
- 启用 SSH 以安全地访问主机设备。相关说明，可参见[使用 SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70015-254/how_to.html#use-ssh)。
有关 Qualcomm Linux 设备上支持的 OpenGL ES 扩展的信息，参见 [EGL 扩展](https://docs.qualcomm.com/doc/80-70015-19SC/topic/supported_extensions.html#supported-egl-client-extensions)。
**编译并运行 glmark2 应用程序**
`glmark2` 是平台 eSDK 提供的基于 OpenGL ES 的示例程序。
### Procedure
1. 要设置 SDK 环境以运行 Linux 终端，可运行以下命令：
source environment-setup-armv8-2a-qcom-linuxCopy to clipboard
2. 要编译和生成二进制文件，可运行以下命令：
devtool modify glmark2Copy to clipboard
devtool build glmark2Copy to clipboard
如有任何 umask 错误，将 umask 设置为 022。
编译成功后，将在 <path-to-installed-eSDK>/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]:/tmpCopy to clipboard
scp -r /workspace/sources/glmark2/oe-workdir/image/usr/share/glmark2 root@[IP-address-of-device]:/tmpCopy to clipboard
4. 要使用 SSH 在设备上运行该应用程序，可使用设备的 IP 地址打开 SSH 终端，并运行以下命令：
export XDG_RUNTIME_DIR=/dev/socket/weston export WAYLAND_DISPLAY=wayland-1Copy to clipboard
chmod 777 /tmp/glmark2-es2-waylandCopy to clipboard
chmod -R 777 /tmp/glmark2Copy to clipboard
cd /tmpCopy to clipboard
./glmark2-es2-wayland --data-path /tmp/glmark2 -b jellyfishCopy to clipboard
Note:
- 要从 UART shell 运行示例程序，可使用以下命令重新挂载文件系统：
mount -o remount,rw /Copy to clipboard
- 在运行该应用程序之前，确保 Weston 应用程序正在运行。如果 Weston 应用程序未运行，可通过运行以下命令启动 Weston 应用程序：
. /etc/profileCopy to clipboard
export XDG_RUNTIME_DIR=/dev/socket/westonCopy to clipboard
mkdir --parents $XDG_RUNTIME_DIRCopy to clipboard
chmod 0700 $XDG_RUNTIME_DIRCopy to clipboard
cd /usr/bin/Copy to clipboard
killall westonCopy to clipboard
weston --tty=2 --idle-time=0 --log=/tmp/weston.log --config=/etc/xdg/weston/weston.ini --continue-without-inputCopy to clipboard
有关 Weston 应用程序的更多信息，参见 [Qualcomm Linux 显示指南](https://docs.qualcomm.com/bundle/publicresource/topics/80-70015-18)。
## 运行 OpenCL 示例程序
Source: [https://docs.qualcomm.com/doc/80-70015-19SC/topic/graphics-getting-started.html](https://docs.qualcomm.com/doc/80-70015-19SC/topic/graphics-getting-started.html)
### About this task
**前提条件**
- 通过以下方式之一安装平台 eSDK：
- [使用 Qualcomm 发布存档](https://docs.qualcomm.com/bundle/publicresource/topics/80-70015-51/install-sdk.html#download-qim-platform-esdk)
- [手动编译 Qualcomm Linux SDK](https://docs.qualcomm.com/bundle/publicresource/topics/80-70015-254/how_to.html#generate-an-esdk)
- 启用 SSH 以安全地访问主机设备。相关说明，可参见[使用 SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70015-254/how_to.html#use-ssh)。
- 下载 Adreno OpenCL [SDK 2.0](https://qpm.qualcomm.com/#/main/tools/details/Adreno_OpenCL_SDK)。
Note: 只允许注册用户下载 Adreno OpenCL SDK。
有关 Qualcomm Linux 设备上支持的 OpenCL 扩展的信息，参见 [OpenCL 扩展](https://docs.qualcomm.com/doc/80-70015-19SC/topic/supported_extensions.html#supported-opencl-extensions)。
**编译并运行 hello world 示例程序**
Adreno OpenCL SDK 提供多个示例程序。任一示例程序的编译和运行步骤都相同。
### Procedure
1. 要在主机上编译应用程序，可运行以下命令：
cd opencl-sdkCopy to clipboard
source /environment-setup-armv8-2a-qcom-linuxCopy 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=1Copy to clipboard
cmake --build buildCopy to clipboard
编译成功后，将在 /build 下生成二进制文件。
2. 要运行该应用程序，可使用设备的 IP 地址打开 SSH 终端，然后使用 SSH 终端在设备上运行以下命令：
mkdir -p /opt/dataCopy to clipboard
mkdir -p /opt/data/openclCopy 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 outCopy to clipboard
chmod 777 ./*Copy to clipboard
echo "run hello world 2.0 opencl sdk" > hello_world_input.txtCopy to clipboard
touch out/hello_world_output.txtCopy to clipboard
cat out/hello_world_output.txtCopy to clipboard
./cl_sdk_hello_world hello_world_input.txt out/hello_world_output.txtCopy to clipboard
cat out/hello_world_output.txtCopy to clipboard
## 运行 Vulkan 示例程序
Source: [https://docs.qualcomm.com/doc/80-70015-19SC/topic/graphics-getting-started.html](https://docs.qualcomm.com/doc/80-70015-19SC/topic/graphics-getting-started.html)
### About this task
**前提条件**
- 通过以下方式之一生成平台 eSDK：
- [使用 Qualcomm 发布存档](https://docs.qualcomm.com/bundle/publicresource/topics/80-70015-51/install-sdk.html#download-qim-platform-esdk)
- [手动编译 Qualcomm Linux SDK](https://docs.qualcomm.com/bundle/publicresource/topics/80-70015-254/how_to.html#generate-an-esdk)
- 启用 SSH 以安全地访问主机设备。相关说明，可参见[使用 SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70015-254/how_to.html#use-ssh)。
有关 Qualcomm Linux 设备上支持的 Vulkan 扩展的信息，参见 [Vulkan 扩展](https://docs.qualcomm.com/doc/80-70015-19SC/topic/supported_extensions.html#supported-vulkan-extensions)。
Adreno SDK 中提供了多个 Vulkan 示例程序。任一示例程序的编译和运行步骤都相同。本指南以运行 Sascha Willems 和 Khronos Vulkan 示例程序的步骤为例进行了说明。
### Sascha Willems Vulkan 示例程序
Source: [https://docs.qualcomm.com/doc/80-70015-19SC/topic/graphics-getting-started.html](https://docs.qualcomm.com/doc/80-70015-19SC/topic/graphics-getting-started.html)
### About this task
Sascha Willems Vulkan 示例程序位于 [https://github.com/SaschaWillems/Vulkan.git](https://github.com/SaschaWillems/Vulkan.git)。编译和运行任何 Sascha Willems Vulkan 应用程序的步骤均相同。
**编译并运行 triangle bin 应用程序**
### Procedure
1. 要编译应用程序，可在主机上运行以下命令：
git clone --recurse-submodules https://github.com/SaschaWillems/Vulkan.gitCopy to clipboard
cd VulkanCopy to clipboard
source /environment-setup-armv8-2a-qcom-linuxCopy 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 VulkanCopy 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 /tmpCopy to clipboard
chmod -R 777 assetsCopy to clipboard
chmod -R 777 shadersCopy to clipboard
chmod 777 triangleCopy to clipboard
. /etc/profileCopy to clipboard
export XDG_RUNTIME_DIR=/dev/socket/westonCopy to clipboard
mkdir --parents $XDG_RUNTIME_DIRCopy to clipboard
chmod 0700 $XDG_RUNTIME_DIRCopy to clipboard
export WAYLAND_DISPLAY=wayland-1Copy to clipboard
./triangleCopy to clipboard
### Khronos Vulkan 示例程序
Source: [https://docs.qualcomm.com/doc/80-70015-19SC/topic/graphics-getting-started.html](https://docs.qualcomm.com/doc/80-70015-19SC/topic/graphics-getting-started.html)
### About this task
Khronos Vulkan 示例程序位于 [https://github.com/KhronosGroup/Vulkan-Samples.git](https://github.com/KhronosGroup/Vulkan-Samples.git)。编译和运行任何 Khronos Vulkan 应用程序的步骤均相同。
**编译并运行 vulkan\_samples 应用程序**
### Procedure
1. 要编译应用程序，可在主机上运行以下命令：
sudo apt-get install -y libwayland-devCopy to clipboard
git clone --recurse-submodules https://github.com/KhronosGroup/Vulkan-Samples.gitCopy to clipboard
cd Vulkan-Samples/Copy to clipboard
source /environment-setup-armv8-2a-qcom-linuxCopy to clipboard
cmake -G "Unix Makefiles" -Bbuild/linux -DCMAKE_BUILD_TYPE=Release -DVKB_WSI_SELECTION=WAYLAND -DGLFW_BUILD_X11=OFFCopy to clipboard
如果编译失败，则执行以下操作：
1. 打开 Vulkan-Samples/build/linux/CmakeCache.txt 文件。
2. 将 `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-SamplesCopy 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 /tmpCopy to clipboard
chmod -R 777 assetsCopy to clipboard
chmod -R 777 shadersCopy to clipboard
chmod 777 vulkan_samplesCopy to clipboard
. /etc/profileCopy to clipboard
export XDG_RUNTIME_DIR=/dev/socket/westonCopy to clipboard
mkdir --parents $XDG_RUNTIME_DIRCopy to clipboard
chmod 0700 $XDG_RUNTIME_DIRCopy to clipboard
export WAYLAND_DISPLAY=wayland-1Copy to clipboard
./vulkan_samples sample swapchain_imagesCopy to clipboard
Note: 如因存储问题无法从 `/tmp` 目录运行这些示例程序，可尝试从 `/etc` 等目录运行。
Last Published: Dec 02, 2024
[Previous Topic
概述](https://docs.qualcomm.com/bundle/publicresource/80-70015-19SC/topics/graphics-overview.md) [Next Topic
功能](https://docs.qualcomm.com/bundle/publicresource/80-70015-19SC/topics/graphics_features.md)