USB Setup

This page outlines the installation procedure and troubleshooting steps for DeGirum ORCA devices with USB-C interfaces.

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

1. Add DeGirum software repository to 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

1. Update package information from configured sources:

sudo apt update

1. Download and install DeGirum USB package:

sudo -E apt install dg-linusb

Troubleshooting

1. The driver requires permissions to be correct in order to access ORCA. Usually, these are set up automatically during the driver install process. Verify that a user group named dg_orca 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. Run the following command on any system in your local network, which has PySDK installed:

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

The <hostname or IP> is the hostname or IP address of the system running AI server. If you have PySDK installed on the same system where you run AI server, then run this command on that system and specify --host localhost. If AI server operates properly, you should see something like:

Devices:
  N2X/CPU:
  - '@Index': 0
  - '@Index': 1
  N2X/ORCA1:
  - '@Index': 0
    Device Description: ORCA_1P1[ USB#0, bus 2, port 2, dev 9 ]
    Firmware Version: 1.1.15
    IC Frequency (MHz): 250
    IC Temperature (C): 41
    Memory DRAM (MB): 1024
Software Version: 0.13.2

Check for the ORCA section. It should be present in the output.

If the AI server does not operate properly, reinstall the server following the steps described in AI Server Configuration guide.

Windows Orca USB Setup

Hosts that have DeGirum Orca with a USB-C interface installed need a driver to enable its functionality. The driver is distributed as a Zip archive.

1. Download the driver: Orca Windows Driver
2. Unpack the ORCA driver .zip file. This can be done with Windows 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”.