DUO Linux Installation

Overview

This guide outlines installing DUO devices on Ubuntu Desktop. Before starting, verify that your system meets the minimum system requirements.

Step 1 - Download the Software

Download the latest DUO Software to start using your device. On Linux the DUO requires a driver configuration which is included in the package.

The file will show up on your download bar (The package contains the DUO API/SDK, Dashboard and Utilities)

Step 2 - Install the Software

Before plugging the camera you must install the device driver and required libraries. This will require the terminal and basic knowledge of using commands.

In this guide we assume you extracted your package to this path: ~/Documents/CL-DUO3D-LIN-1.1.0.30/
Open a new Terminal and navigate to the extracted package location

2.1 - Install Requirements

Get the required tools and libraries using this command:

sudo apt-get install build-essential qt5-default git cmake

2.2 - Install the Driver

You must build and load the DUO Kernel Module (duo.ko) for your version of Linux kernel. Go into the ~/Documents/CL-DUO3D-LIN-1.1.0.30/DUODriver/ folder and type:

chmod u+x duodriver.run
./duodriver.run

You can now use these commands to load, unload or install the module:

Loading the driver:

sudo insmod duo-1024.ko

Note: On some systems, since this driver tells DUO to use 1024 byte bulk packets (if DUO is connected to USB 3.0 port), this command results in USB packets being truncated by Linux kernel to 512 bytes resulting in corrupted image. If you see the packet loss in DUO Dashboard on your machine, please unload the driver and use the following:

sudo insmod duo-512.ko

Unloading the driver:

sudo rmmod -f duo

Once you determined that duo-1024 works, you can install the driver using following commands:

sudo cp duo-1024.ko /lib/modules/$(uname -r)/kernel/drivers/duo.ko
echo 'duo' | sudo tee -a /etc/modules > /dev/null
sudo depmod

Or if duo-1024 does not work, to install the driver use the following commands:

sudo cp duo-512.ko /lib/modules/$(uname -r)/kernel/drivers/duo.ko
echo 'duo' | sudo tee -a /etc/modules > /dev/null
sudo depmod

Step 3 - Connect the DUO

Only after you have successfully installed the requirements then connect the DUO to your computer with the supplied USB cable.

To verify that the device is connected to the system you can view the node duo0 appears in /dev directory on the file system.

Step 4 - Start the Dashboard

After the installation you will have new applications available on your system. Going to where you extracted the package, here is an example with the user directory at ~/Documents/CL-DUO3D-LIN-1.1.0.30/DUODashboard/.

Make sure the permissions on the file to Allow executing file as program. This can be done with Terminal with this command chmod +x DUODashboard or right clicking on the file.

Running the DUODashboard application in the folder (Located where you extracted the package)

After properly installed device and running, the dashboard should look like this:

Using the Applications

Using the Dashboard and Calibration applications will let you test if your DUO device is properly installed, tweak its parameters and view the output. Once your device is operating properly you can start reading the DUO Dashboard article to get started on the following guides.

Capturing - Outlines how to get started capturing data from the cameras and motion sensors.
Configuring - Review of the DUO Dashboard application settings and configuration parameters.
Calibrating - Guide on how to calibrate your device for use with Dense3D API.

If your devices is not recognized try resolving the issue with some of the tips in the Troubleshooting article.