USB Setup

This page describes how to install and troubleshoot DeGirum Orca devices with a USB-C interface.

Ubuntu Orca USB Setup

Enable and Update DeGirum repository

1

Install prerequisites:

 sudo apt install curl

2

Download DeGirum public key:

For Ubuntu 20.04:

wget -O - -q http://assets.degirum.com/apt-repo/DeGirum.gpg.key | sudo apt-key add -

For Ubuntu 22.04 and Ubuntu 24.04:

curl -fsSL http://assets.degirum.com/apt-repo/DeGirum.gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/degirum.gpg

3

Add the DeGirum software repository to your APT sources configuration file:

For Ubuntu 20.04:

echo deb [arch=amd64,arm64] https://assets.degirum.com/apt-repo ORCA main | sudo tee -a /etc/apt/sources.list

For Ubuntu 22.04:

echo deb [arch=amd64,arm64 signed-by=/usr/share/keyrings/degirum.gpg] https://assets.degirum.com/apt-repo ORCA main | sudo tee -a /etc/apt/sources.list

For Ubuntu 24.04:

echo 'Types: deb
URIs: https://assets.degirum.com/apt-repo
Suites: ORCA
Components: main
Architectures: amd64 arm64
Signed-By: /usr/share/keyrings/degirum.gpg' | sudo tee /etc/apt/sources.list.d/degirum.sources

4

Update package information from configured sources:

sudo apt update

5

Download and install DeGirum USB package:

sudo -E apt install dg-linusb

Troubleshooting

If the AI server does not operate properly, reinstall it using the steps in theAI Server Configuration guide.

1

Verify that a dg_orca group exists and that the current user belongs to it:

cat /etc/group | grep dg_orca && groups | grep dg_orca

If the group does exist but the user is not in it, add the user via:

sudo -E usermod -a -G dg_orca <username>

2

If you installed DeGirum AI Server then verify AI Server operation:

degirum sys-info --host <hostname or IP>

Check for the ORCA section in the output. If it is missing, reinstall the server following the AI Server Configuration guide.

Windows Orca USB Setup

Hosts using DeGirum Orca with a USB-C interface need a driver to enable the device. The driver is distributed as a Zip archive.

1

Download the driver: Orca Windows Driver

2

Unpack the ORCA driver .zip file using Windows File Explorer.

3

Start Device Manager. Open the Power User menu by right-clicking on the Start button (or by pressing Win+X), then click "Device Manager".

4

Find "AI Accelerator device" under "Other devices".

5

Right-click on "AI Accelerator device", then select "Update driver".

6

Choose "Browse my computer for drivers".

7

Click "Browse…", then navigate to the folder that contains the driver files unpacked in Step 1. Check "Include subfolders". Then, click "Next".