Install and Configure Third-Party Adapters

This topic explains how to install third-party adapters from Blackmagic Design and from Atto

Install and Configure Blackmagic Design Cards

Blackmagic Design cards are supported in Flame, Flame Assist, and Flare from version 2020.2 and later.

The following cards have been tested:

UltraStudio 4K Extreme (using PCI Express Cable Kit)
DeckLink 4K Extreme

Note: Other UltraStudio and DeckLink card models might work but were not tested. Thunderbolt and USB3 cards are not supported.

Installation:

Install the PCIe BMD UltraStudio or DeckLink card on your workstation following the Blackmagic Design documentation.
Install the following dependencies before installing the Desktop Video package:
```
yum install epel-release
yum install dkms 
```
Refer to Optional Certified Hardware Devices for Flame Family workstations to find the version of Blackmagic Design Desktop Video currently certified for Flame Family. Download this version from Blackmagic Design Support Center. Make sure to download the Linux one!
Install the Desktop Video .rpm according to the Desktop Video documentation.
- Mandatory. The driver and firmware update tool: yum install --nogpgcheck desktopvideo-[0-9]*.rpm
- Optional but useful. The control panel GUI: yum install --nogpgcheck desktopvideo-gui*.rpm
- Optional. Simple playback tool: yum install --nogpgcheck mediaexpress*.rpm

Once installed, Desktop Video applications can be found in the OS menus in Applications/Multimedia.

Once the Desktop Video package is installed, configure Flame, Flare, or Flame Assist to use the Blackmagic Design card.

Start the Flame Setup software.
In the General tab, set Video Device and Audio Device to BMD.
Select a Preview timing in the Preview tab.
Once done, click Apply and exit Flame Setup.
Start Flame/Flare/Flame Assist.

Limitations:

No Headroom option
No Sample Interleave (SI) option. But based on the card capabilities, UHDTV/4K is sent as Sample Interleave (if card is set to 4K Dual Link) or Quadrants (if set to 4K Quad Link)
No 3G Level A
VTR Input/Output, VTR archiving, and real-time deliverable capabilities are not available.
You cannot have a system configured with both an AJA card and a Blackmagic Design card.

Note: Two applications cannot run at the same time and both require the use the Blackmagic Design card. Either quit one of the running applications, or disable the Blackmagic Design card in the one launched in second.

Install the Atto FastFrame N352 or N412 card

If you are using an ATTO N352 or N412 Gigabit Ethernet adapter, take note that the driver is not part of the DKU. You will need to download it directly from the manufacturer and manually install it on your workstation. The packages from ATTO are called "ATTO Ethernet Suites" and include both the driver an a tool called ATTO360 that allow configuration and monitoring of the network adapter.

Installing the ATTO driver and ATTO360 Tool

Download the ATTO FastFrame adapters from the ATTO Linux download page.
Scroll down to the "ATTO Ethernet Suite" section and select the Linux ATTO 360 download that matches your Linux OS version.
Open a shell on your Flame linux workstation.
Decompress the content of the archive downloaded. Below is an example for Rocky Linux 8.5, adapt the command line to match the downloaded file.
```
tar -xvf lnx_app_atto360_4000f1_rl8.5.tgz
```

install the driver by typing the command:

DEPENDENCY_SKIP_INSTALL=Yes OFED_SKIP_INSTALL=Yes OFED_INSTALLER_ARGS= BATCH=1 INSTALL_MODE=app ./install_atto360_4000f1_rl8.5.sh

Notes about ATTO360 Tool

You can use this tool by invoking:
```
gtk-launch atto360
```

This tool is totally independent from Flame and absolutely optional to use. Refer to ATTO for documentation and use of this tool.

Important : Do not alter the settings in the Performance tab of the tool. These settings can affect the optimized settings that were put in place by the DKU installation.

Uninstalling the ATTO driver and ATTO360 Tool

To uninstall the ATTO 360 application, run:
```
/opt/atto360/uninstall_atto360.sh
```
To uninstall the OFED FastFrame driver driver, type:
```
/usr/sbin/ofed_uninstall.sh --force
```