# USB Setup

## Ubuntu Orca USB Setup

### Enable and Update DeGirum repository

{% stepper %}
{% step %}
Install prerequisites:

{% code overflow="wrap" %}

```bash
 sudo apt install curl
```

{% endcode %}
{% endstep %}

{% step %}
Download DeGirum public key:

For Ubuntu 20.04:

{% code overflow="wrap" %}

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

{% endcode %}

For Ubuntu 22.04 and Ubuntu 24.04:

{% code overflow="wrap" %}

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

{% endcode %}
{% endstep %}

{% step %}
Add the DeGirum software repository to your APT sources configuration file:

For Ubuntu 20.04:

{% code overflow="wrap" %}

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

{% endcode %}

For Ubuntu 22.04:

{% code overflow="wrap" %}

```bash
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
```

{% endcode %}

For Ubuntu 24.04:

{% code overflow="wrap" %}

```bash
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
```

{% endcode %}
{% endstep %}

{% step %}
Update package information from configured sources:

{% code overflow="wrap" %}

```bash
sudo apt update
```

{% endcode %}
{% endstep %}

{% step %}
Download and install DeGirum USB package:

{% code overflow="wrap" %}

```bash
sudo -E apt install dg-linusb
```

{% endcode %}
{% endstep %}
{% endstepper %}

### Troubleshooting

If the AI server does not operate properly, reinstall it using the steps in the [AI Server Configuration guide](https://docs.degirum.com/pysdk/user-guide-pysdk/setting-up-an-ai-server).

{% stepper %}
{% step %}
Verify that a `dg_orca` group exists and that the current user belongs to it:

{% code overflow="wrap" %}

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

{% endcode %}

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

{% code overflow="wrap" %}

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

{% endcode %}
{% endstep %}

{% step %}
If you installed DeGirum AI Server then verify AI Server operation:

{% code overflow="wrap" %}

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

{% endcode %}

Check for the `ORCA` section in the output. If it is missing, reinstall the server following [AI Server Configuration guide](https://docs.degirum.com/pysdk/user-guide-pysdk/setting-up-an-ai-server).
{% endstep %}
{% endstepper %}

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

{% stepper %}
{% step %}
Download the driver: [Orca Windows Driver](https://assets.degirum.com/usborca-amd64.zip)
{% endstep %}

{% step %}
Unpack the ORCA driver .zip file using Windows File Explorer.
{% endstep %}

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

{% step %}
Find "AI Accelerator device" under "Other devices".
{% endstep %}

{% step %}
Right-click on "AI Accelerator device", then select "Update driver".
{% endstep %}

{% step %}
Choose "Browse my computer for drivers".
{% endstep %}

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.degirum.com/orca/usb.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.