HomeCloudSoftwareHardware
Platform
RAE

ON THIS PAGE

  • USB deployment guide
  • Installing requirements
  • Connecting the USB device
  • Initial Connection
  • Debugging
  • Powering OAK cameras
  • Runtime
  • Debugging

USB deployment guide

USB OAK cameras use USB-C cable for both power and data. They support either USB2 or USB3 (up to 10gbps) communication. OAK cameras are connected to a host computer.
1

Installing requirements

Follow instructions below to install DepthAI and its dependencies/requirements with an installer.
macOS
Windows
Linux
If you would like to avoid using installer and would prefer manually installing dependencies, requirements and DepthAI, see Manual DepthAI installation.
2

Connecting the USB device

You should use USB3 USB-C cable, as it suports higher bandwidth. Sometimes, you can power the device from the host computer, but it is recommended to use an external power supply.USB3 cable is colored blue in the inside of the USB-A connector of the USB-C cable. If it's not blue, it might be USB2 USB-C charging cable.
3

Initial Connection

DepthAI library will look for all available devices that are connected via USB. Once the device is found, it will send over the firmware, pipeline, and assets (like NN models), and start the pipeline.The best way to test the connection is by running the DepthAI Viewer. If it finds the device and starts streaming frames, then the connection is working properly.

Debugging

If you are getting an error like RuntimeError: No available devices, it means that DepthAI couldn't find any connected device. Make sure that the camera is powered and connected to your computer via USB3 cable. See the tabs below for debugging steps.We recommend using the latest depthai version before any kind of troubleshooting.
lsusb
Powering OAK cameras
Linux udev rules
Using USB2
4

Runtime

After successfully connecting to the device and uploading the pipeline, the connection should be stable, there should be minimal latency (below 0.5sec), and the bandwidth should be about 2.5Gbps downlink (when using USB3).

Debugging

See the debugging tabs below in case the application stops working or if the communication is slow.
Connection drop
Low speed / High latency