Orca USB

Enable and Update Degirum repository

1. Install prerequisites:

   sudo apt install curl
   

2. 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
     

3. 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
     

4. 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.

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