# Getting started

The following workflow outlines the prerequisites, setup instructions, and the commands to run, when getting started with the video functionality.

![../../_images/Getting-started-workflow.png](data:image/png;base64,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)

**Figure : Getting started workflow for video**

## Prerequisites

- Set up your infrastructure as described in the [Qualcomm Linux Build Guide](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-254/introduction.html).
- Set up the SSH connection:

    1. To enable SSH, follow the steps described in [Use SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-254/how_to.html#use-ssh).
    2. Connect to the device by running the following command:

ssh root@<device_IP_address>
            Copy to clipboard

        **Example command:**

ssh root@10.92.160.222
            Copy to clipboard

Note

When prompted for a password, enter `oelinux123`.

## Setup

The setup procedure helps you to render the video content on the display, and transfer the video content to the device. Do the following from an SSH terminal:

1. To enable rendering on the display, run the following commands:

mount -o rw,remount /
        Copy to clipboard

export XDG_RUNTIME_DIR=/dev/socket/weston
        Copy to clipboard

export WAYLAND_DISPLAY=wayland-1
        Copy to clipboard
2. For video playback, push a prerecorded H.264 video onto the device. To push the files onto the device, run the following command:

scp -r <file_name> root@[DEVICE IP-ADDR]:/opt
        Copy to clipboard

Note

When you are prompted for a password, enter `oelinux123`.

## Run

You can run a set of commands on the device terminal to validate the video playback and recording functionality.

**Validate video playback functionality**

1. To validate the video playback functionality, run the following command on the device terminal:

gst-launch-1.0 -e filesrc location=/opt/<h264_file>.mp4 ! qtdemux ! queue ! h264parse ! v4l2h264dec capture-io-mode=5 output-io-mode=5 ! waylandsink enable-last-sample=false fullscreen=true
        Copy to clipboard
2. To stop validating the use case, press **CTRL + C**.

**Validate video recording functionality**

1. To validate the video recording functionality, run the following command on the device terminal:

gst-launch-1.0 -e qtiqmmfsrc ! video/x-raw\(memory:GBM\),format=NV12,width=1280,height=720,framerate=30/1,compression=ubwc,interlace-mode=progressive,colorimetry=bt601 ! queue ! v4l2h264enc capture-io-mode=5 output-io-mode=5 extra-controls="controls,video_bitrate=1000000,video_gop_size=29;" ! queue ! h264parse ! muxer. pulsesrc do-timestamp=true provide-clock=false volume=10 ! audio/x-raw,format=S16LE,channels=1,rate=48000 ! audioconvert ! queue ! lamemp3enc ! mp4mux name=muxer ! queue ! filesink location=/opt/720p_AVC_MP3.mp4
        Copy to clipboard
2. To stop validating the use case, press **CTRL + C**.
3. Pull the recorded content out from the device using the following SCP command:

scp -r root@[DEVICE IP-ADDR]:/opt/720p_AVC_MP3.mp4 user1@[HOST IP-ADDR]:/workspace
        Copy to clipboard
4. Play the content on the Linux host.

Last Published: Dec 30, 2024

[Previous Topic
Overview](https://docs.qualcomm.com/bundle/publicresource/80-70017-20/topics/overview.md) [Next Topic
Architecture and features](https://docs.qualcomm.com/bundle/publicresource/80-70017-20/topics/architecture.md)