USB

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

Enable and Update DeGirum repository

1. Install prerequisites:

    sudo apt install curl 

2. Download DeGirum public key:

   • Ubuntu 20.04:

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

• Ubuntu 22.04:

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

   • Ubuntu 20.04:

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

• 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

• 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

Installation procedure for ORCA cards with USB-C interface

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.

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