# Getting started
The following workflow shows how to get started with a graphics application on a Qualcomm device.
**Figure : Workflow of graphics applications**
## OpenGL ES-based applications
`glmark2` is an OpenGL ES-based sample application provided in the Platform eSDK.
**Prerequisites**
- Install the Platform eSDK using either of the following methods:
- [Using Qualcomm release archive](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-51/install-sdk.html#download-qim-platform-esdk)
- [Manually compile the Qualcomm Linux SDK](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-254/how_to.html#generate-an-esdk)
- Establish an SSH connection from the Linux host to the device. For instructions, see [Use SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-254/how_to.html#use-ssh).
- Ensure that the Weston application is running. If not, start the Weston application by running the following commands:
>
>
> . /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
>
>
> For more information on the Weston application, see [Qualcomm Linux Display Guide](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-18).
For information on the OpenGL ES extensions supported on Qualcomm Linux devices, see [EGL extensions](https://docs.qualcomm.com/doc/80-70017-19/topic/supported_extensions.html#supported-egl-client-extensions).
**Compile and run glmark2 application**
1. To set the SDK environment on the Linux host, run the following command:
source environment-setup-armv8-2a-qcom-linux
Copy to clipboard
2. To compile and generate a binary, run the following commands:
devtool modify glmark2
Copy to clipboard
devtool build glmark2
Copy to clipboard
If you encounter any umask error, set the umask to 022.
After successful compilation, the output files are generated in the `/workspace/sources/glmark2/oe-workdir/image/usr/bin` directory.
3. To push the binary to the device, run the following commands:
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. To run the application on the device, open the SSH terminal using the IP address of the device and run the following commands:
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
To run the sample application from the UART shell, remount the file system using the following command:
mount -o remount,rw /
Copy to clipboard
## OpenCL-based applications
Multiple sample applications are provided in the Adreno OpenCL SDK. The steps to compile and run any sample application are the same.
Note
Currently, Qualcomm Linux supports OpenCL v2.1.
**Prerequisites**
- Install the Platform eSDK using either of the following methods:
- [Using Qualcomm release archive](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-51/install-sdk.html#download-qim-platform-esdk)
- [Manually compile the Qualcomm Linux SDK](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-254/how_to.html#generate-an-esdk)
- Establish an SSH connection from the Linux host to the device. For instructions, see [Use SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-254/how_to.html#use-ssh).
- Download the [Adreno OpenCL SDK](https://softwarecenter.qualcomm.com/#/catalog/item/Adreno_OpenCL_SDK).
Note
You must be a registered user to download the Adreno OpenCL SDK.
For information on the OpenCL extensions supported on Qualcomm Linux devices, see [OpenCL extensions](https://docs.qualcomm.com/doc/80-70017-19/topic/supported_extensions.html#supported-opencl-extensions).
**Compile and run the hello world sample application**
1. To compile the application, run the following commands on the Linux host:
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
After successful compilation, binary files are generated in the `/build` directory.
2. To run the application, open the SSH terminal using the IP address of the device and run the following commands:
mkdir -p /opt/data
Copy to clipboard
mkdir -p /opt/data/opencl
Copy to clipboard
Note
If you want to run a sample application from the UART shell, remount the file system using the following command:
mount -o remount,rw /
Copy to clipboard
3. To push the binary to the device, run the following commands:
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. To start the application, run the following commands on the device using the SSH terminal:
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-based applications
Multiple sample applications are provided in the Adreno SDK for Vulkan. The steps to compile and run any sample application are the same. As an example, the steps to run a Sascha Willems and Khronos Vulkan sample applications are described here.
**Prerequisites**
- Install the Platform eSDK using either of the following methods:
- [Using Qualcomm release archive](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-51/install-sdk.html#download-qim-platform-esdk)
- [Manually compile the Qualcomm Linux SDK](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-254/how_to.html#generate-an-esdk)
- Establish an SSH connection from the Linux host to the device. For instructions, see [Use SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-254/how_to.html#use-ssh).
For information on the Vulkan extensions supported on Qualcomm Linux devices, see [Vulkan extensions](https://docs.qualcomm.com/doc/80-70017-19/topic/supported_extensions.html#supported-vulkan-extensions).
### Sascha Willems Vulkan-based applications
The Sascha Willems Vulkan sample applications are available at [https://github.com/SaschaWillems/Vulkan.git](https://github.com/SaschaWillems/Vulkan.git). The steps to compile and run any Sascha Willems Vulkan application are the same.
**Compile and run the triangle bin sample application**
1. To compile the application, run the following commands on the Linux host:
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
After successful compilation, binary files are generated in the `build/linux/bin` directory.
2. To push the binary to the device, run the following commands:
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. To run the application, open the SSH terminal using the IP address of the device and run the following commands:
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-based applications
The Khronos Vulkan sample applications are available at [https://github.com/KhronosGroup/Vulkan-Samples.git](https://github.com/KhronosGroup/Vulkan-Samples.git). The steps to compile and run any Khronos Vulkan application are the same.
**Compile and run the vulkan\_samples application**
1. To compile the application, run the following commands on the Linux host:
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
If the compilation fails, do the following:
1. Open the `Vulkan-Samples/build/linux/CmakeCache.txt` file.
2. Change `GLFW_BUILD_X11` to `OFF`.
2. To generate the binary files, run the following command:
cmake --build build/linux --config Release --target vulkan_samples -j$(nproc)
Copy to clipboard
After successful compilation, the binary files are generated in the `Vulkan-Samples/build/linux/app/bin/Release/aarch64` directory.
3. To push the binary to the device, run the following commands:
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. To run the application, open the SSH terminal using the IP address of the device and run the following commands:
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
If you are unable to run these sample applications from the `/tmp` directory due to storage issues, try alternative directories such as `/etc`.
Last Published: Dec 27, 2024
[Previous Topic
Overview](https://docs.qualcomm.com/bundle/publicresource/80-70017-19/topics/graphics-overview.md) [Next Topic
Tools](https://docs.qualcomm.com/bundle/publicresource/80-70017-19/topics/graphics_developer_tools.md)