OAK USB deployment guide
1
Installing requirements
Follow instructions below to install dependencies:
Linux
macOS & Windows
2
Connecting the USB device
Use a USB3 USB-C cable for maximum bandwidth. The host can power the device, but an external supply is recommended. See
Powering OAK Devices here.USB3 cables are usually blue inside the USB-A connector. If it is not blue, it may be a USB2 charging cable.
Connecting via a long (>2m) USB cable might cause issues with the connection. If you need to use a longer cable, make sure it's an active USB3 cable.
3
Initial Connection
DepthAI scans USB devices, uploads firmware/pipeline/assets, and starts the pipeline.The fastest test is OAK Viewer. If it finds the device and streams frames, the connection is working.
If you see
Debugging
RuntimeError: No available devices, DepthAI did not find a device. Confirm power and a USB3 connection, then use the tabs below.We recommend using the latest depthai version before any kind of troubleshooting.lsusb
Powering OAK cameras
Linux udev rules
Using USB2
Stuck in USB2 mode
Only the booted device enumerates as USB3. If it stays at USB2 speed after the app starts, the most common cause is the host-side USB port or cable. Try a different USB3 port, a shorter cable, or a powered USB3 hub.
4
Runtime
After connecting and uploading the pipeline, the connection should be stable, latency should be low (under 0.5 sec), and USB3 downlink should be about 2.5 Gbps.See the debugging tabs below in case the application stops working or if the communication is slow.
Debugging
Connection drop
Low speed / High latency
5
Next Steps
After successfully deploying the device, you can use the following resources to learn more about the software ecosystem: