Version: v5.2.0

SDK Installation

Current Release

SDK Release: v5.2.0
VPU Firmware: v5.2.0
Supported Versions: 3.1.1, 3.4.2, 4.1.3, 4.2.1, 4.3, 4.3.1, 4.4, 4.4.2, 5.0, 5.1.2, 6.1, 7.1

Quadra FFmpeg Installation Guide

NETINT provides a instructions for both a scripted (preferred) or manual (See Installation Guide) installation process.

Download Release Package

You can get a Quadra release package from the NETINT Docs Portal
Copy it over to your server and Unzip the release package.

info
Example release package name: Quadra_.zip
```
unzip Quadra_VX.X.X.zip
```

Scripted Installation

On your server, cd into the release package.
```
cd Quadra_VX.X.X
```
Run the quadra_quick_installer.sh script.
```
bash ./quadra_quick_installer.sh
```

Make sure that the FW and SW releases match what you're trying to install then type y to confirm.

The latest FW release package found here is: Quadra_FW_VX.X.X_XXX
The latest SW release package found here is: Quadra_SW_VX.X.X_XXX
Press [Y/y] to confirm the use of these two release packages

Installation options will be show, here is an example:

Choose an option:
1) Setup Environment variables                         7) Install FFmpeg-n3.1.1 (must install Libxcoder_quadra first)  13) Install FFmpeg-n4.4
2) Unlock CPU governor                                 8) Install FFmpeg-n3.4.2                                        14) Install FFmpeg-n5.0
3) Install OS prerequisite packages                    9) Install FFmpeg-n4.1.3                                        15) Install FFmpeg-n6.0
4) Install NVMe CLI                                   10) Install FFmpeg-n4.2.1                                        16) Install gstreamer-1.22.2
5) Install Libxcoder                                  11) Install FFmpeg-n4.3.1                                        17) Firmware Update
6) Install Libxcoder_quadra (for FFmpeg-n3.1.1 only)  12) Install FFmpeg-n4.3                                          18) Quit
#?

Install the following items by pressing the corresponding number shown in the option menu:
- Setup Environment variables
- Install OS prerequisite packages
- Install NVMe CLI
- Install Libxcoder
- Install FFmpeg (you can choose the version you want to use)
The NETINT VPU software is now complete! You can exit the script by selecting the number for the Quit option.
info
If any individual step fails during the execution of quadra_quick_installer.sh please
1. Check any printed errors, then take the necessary actions to resolve it and try again.
2. If any error persists, please contact NETINT support.
Test the installation using run_ffmpeg_quadra.sh. You can also manually verify your installation.

Firmware Upgrade

warning

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

Navigate to the Firmware Directory
```
cd Quadra_VX.X.X/Quadra_FW_VX.X.X_RCX
```
Run the script to upgrade the Firmware on Cards
```
bash ./quadra_auto_upgrade.sh
```

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]:

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

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

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.

Running ni_rsrc_mon should show the information about the VPU(s):

Number of VPU detected
Temperature and Power
Firmware and Serial Number
Utilization of the Decoder, Encoder, Scaler and AI Engine

**************************************************
1 devices retrieved from current pool at start up
Wed Mar 12 09:28:16 2025 up 00:00:00 v5206s5r2
INDEX    TEMP     POWER    FR       SN
0        38       7647mW   5106rtr4 Q1A224A11DC065-0018
Num decoders: 1
INDEX LOAD MODEL_LOAD INST MEM  SHARE_MEM P2P_MEM DEVICE
0     0    0          0    0    0         0       /dev/nvme1n1
Num encoders: 1
INDEX LOAD MODEL_LOAD INST MEM  SHARE_MEM P2P_MEM DEVICE
0     0    0          0    0    0         0       /dev/nvme1n1
Num scalers: 1
INDEX LOAD MODEL_LOAD INST MEM  SHARE_MEM P2P_MEM DEVICE
0     0    0          0    0    0         0       /dev/nvme1n1
Num AIs: 1
INDEX LOAD MODEL_LOAD INST MEM  SHARE_MEM P2P_MEM DEVICE
0     0    0          0    0    0         0       /dev/nvme1n1
**************************************************

Running ffmpeg -encoders | grep ni_quadra should show:

The FFmpeg version
All the installed NETINT Quadra encoders

ffmpeg version 6.0 Copyright (c) 2000-2023 the FFmpeg developers
...
V..... av1_ni_quadra_enc    AV1 NetInt Quadra encoder v4706r8r4 (codec av1)
V..... h264_ni_quadra_enc   H.264 NetInt Quadra encoder v4706r8r4 (codec h264)
V..... h265_ni_quadra_enc   H.265 NetInt Quadra encoder v4706r8r4 (codec hevc)
V..... jpeg_ni_quadra_enc   JPEG NetInt Quadra encoder v4706r8r4 (codec mjpeg)

tip

You can also use the -decoders, -filters flags in the same command to see more installed features.

Current Release​

Quadra FFmpeg Installation Guide​

Download Release Package​

Scripted Installation​

Firmware Upgrade​

Verify Installation​