Orca USB Driver Installation and Troubleshooting Guide

Documentation Installation
1

Enable and Update Degirum Repository

  1. Install prerequisites:
sudo apt install curl
  1. Download DeGirum public key:
  • Ubuntu 20.04:
wget -O - -q http://docs.degirum.com/apt-repo/DeGirum.gpg.key | sudo apt-key add -
  • Ubuntu 22.04:
  • Ubuntu 24.04:
curl -fsSL http://docs.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://docs.degirum.com/apt-repo ORCA main | sudo tee -a /etc/apt/sources.list
  • Ubuntu 22.04:
  • Ubuntu 24.04:
echo deb [arch=amd64,arm64 signed-by=/usr/share/keyrings/degirum.gpg] https://docs.degirum.com/apt-repo ORCA main | sudo tee -a /etc/apt/sources.list
  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>
  1. 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.