Skip to main content
Version: v5.2.0

Quadra GStreamer Installation Guide

Example GStreamer piplines and NETINT plugin details, see APPS 610 Gstreamer Integration with libxcoder

Current Release​

SDK Release: v5.2.0
VPU Firmware: v5.2.0
Supported Versions: 1.22.2, 1.24.4

Download Release Package​

  1. You can get a Quadra release package from the NETINT Docs Portal

  2. Copy it over to your server and Unzip the release package.

    info

    Example release package name: Quadra_v5.2.0.zip

    unzip Quadra_VX.X.X.zip

GStreamer Installation​

  1. On your server, cd into the release package.

    cd Quadra_VX.X.X

  2. Install the required dependencies.

    sudo apt-get update &&  \
    sudo apt-get install -y nvme-cli yasm pkg-config git gcc make g++ uuid-runtime udev unzip python3-pip \
    flex bison libpng-dev zlib1g-dev gnutls-bin uuid-dev libglib2.0-dev libxml2 libxml2-dev \
    && python3 -m pip install meson ninja

  3. Clone GStreamer and specify the branch for the supported gstreamer versions

    git clone --depth 1 --branch x.y.z https://gitlab.freedesktop.org/gstreamer/gstreamer.git

  4. Apply the patch to the cloned gstreamer repo

    cp Quadra_SW_Vx.y.z/gstreamer-x.y.z_netint_vx.y.z.diff gstreamer
    cd gstreamer \
    patch -t -p 1 < gstreamer-*netint*.diff

  5. Build GStreamer with the supplied script

    bash ./build_gstreamer.sh --install

Firmware Upgrade​

warning
  • Do NOT interrupt the firmware update process once it has started. Any interruption may cause the device to malfunction.

  1. Navigate to the Firmware Directory

    cd Quadra_VX.X.X/Quadra_FW_VX.X.X_RCX

  2. Run the script to upgrade the Firmware on Cards

    bash ./quadra_auto_upgrade.sh

  3. The script will display all the cards detected and the current firmware along with the new firmware.

    Press 'Y' to confirm the installation

    Number of Quadra Transcoders found on nvme: 1
    FW upgrade file: /home/nvme/Quadra_V4.7.0/Quadra_FW_V4.7.0_RC4/FL_BIN/nor_flash_v4.7.0_RC4-Quadra.bin
    #   Device         Block              Serial Number        Card FW Rev File FW Rev Action
    --- -------------- ------------------ -------------------- ----------- ----------- --------------
    0   /dev/nvme1     /dev/nvme1n1       Q1A224A11DC065-0018  4606nrc2    4706r8r4    upgrade
    Do you want to upgrade ALL of the above Quadra Transcoder(s)? Press [y/n]:

  4. Verify the Firmware upgrade has completed successfully.

    /dev/nvme1 -- Last executed firmware loader version is v4.1.0
    /dev/nvme1 -- Reboot to run firmware loader version v4.4.0 (optional)
    Firmware upgrade complete!
    #   Device         Block              Serial Number        Card FW Rev Result
    --- -------------- ------------------ -------------------- ----------- ------------------------
    0   /dev/nvme1     /dev/nvme1n1       Q1A224A11DC065-0018  4706r8r4    Successful upgrade
    Cards that underwent upgrade have new FW activated but still require ni_rsrc initialization (init_rsrc).
    quadra_auto_upgrade.sh finished

  5. After the upgrade the server may need to be rebooted. If not, then re-initialize the cards

    warning
    • If a cold upgrade fails then a system reboot may resolve the issue. The firmware update process should then be repeated.
    info
    • Additional information captured during the update process can be found in the ./upgrade_log.txt file generated by the update script.

Verify Installation​

  1. Run init_rsrc to make sure that your VPU(s) are initialized.

    tip

    The cards MUST be initialized after every reboot. A custom start-up script or a systemd process are examples of what can be used to ensure the cards are initialized after a reboot.

  2. Running sudo nvme list should show all the detected cards on your system and their firmware version.

    Node             SN                   Model                                    Namespace Usage                      Format           FW Rev
    ---------------- -------------------- ---------------------------------------- --------- -------------------------- ---------------- --------
    /dev/nvme0n1     Q1A10BA11FC060-0069  QuadraT1A                                1           8.59  TB /   8.59  TB      4 KiB +  0 B   4606nrc2

  3. Running ni_rsrc_mon should show the VPU(s) and their current utilization.

    NI resource init'd already ..
    **************************************************
    1 devices retrieved from current pool at start up
    Fri Jan 19 22:27:09 2024 up 00:00:00 v4606nrc5
    Num decoders: 1
    INDEX LOAD MODEL_LOAD INST MEM  SHARE_MEM P2P_MEM DEVICE
    0     0    0          0    0    0         0       /dev/nvme0n1
    Num encoders: 1
    INDEX LOAD MODEL_LOAD INST MEM  SHARE_MEM P2P_MEM DEVICE
    0     0    0          0    0    0         0       /dev/nvme0n1
    Num scalers: 1
    INDEX LOAD MODEL_LOAD INST MEM  SHARE_MEM P2P_MEM DEVICE
    0     0    0          0    0    0         0       /dev/nvme0n1
    Num AIs: 1
    INDEX LOAD MODEL_LOAD INST MEM  SHARE_MEM P2P_MEM DEVICE
    0     0    0          0    0    0         0       /dev/nvme0n1
    **************************************************

  4. Running gstinspect | grep ni should show all the supported GStreamer plugins