Documentation / Gemini 330 series /
Linux & Arm Installation guidance

Linux & Arm Installation guidance

# Linux environment configuration

 

Download the Linux or ARM OrbbecSDK first, and then compile it according to the following steps.

 

## 1. System environment configuration

* Install the libudev Library:

Sudo apt install libudev-Dev

* Install the libusb Library:

Sudo apt install libusb-Dev

## 2. USB access permission configuration

By default, Linux requires the root permission for direct access to USB devices, which can be solved by using the rules configuration file. After the file released by OrbbecSDK is decompressed, there will be a “99-obsensor-libusb” in the Script directory.rules, configuration file and install_udev_rules.sh, installation script, run the sudo command, install_udev_rules.sh script, you can complete the installation of the rules configuration file.

The method is as follows: first, modify “install_udev_rules.sh” to install the script execution permission.

Sudo chmod + X. /Install_udev_rules.sh
Sudo. /Install_udev_rules.sh

After the installation script is successfully executed, it takes effect when the device is re-connected (the connected device needs to be re-plugged).

 

## 3. USB FS cache size configuration (optional)

By default, the USBFS cache size is 16MB. This value is not sufficient for high-resolution images or multiple streams and multiple devices. You can increase the cache size to 128MB.

### Check the USBFS cache size

cat /sys/module/usbcore/parameters/usbfs_memory_mb

### Temporarily increase the USBFS cache size

sudo sh -c 'echo 128> /sys/module/usbcore/parameters/usbfs_memory_mb'

### Permanently increase the size of the USBFS cache

To permanently increase the cache size, add the kernel parameter usbcore.usbfs_memory_mb = 128 to the boot loader configuration. How to do this depends on the boot loader on the system.

For GRUB2 (most common):

  1. Open/etc/default/grub’ and replace: ‘GRUB_CMDLINE_LINUX_DEFAULT = “quiet splash”‘ (or other contents in quotation marks, depending on your system) with: ‘GRUB_CMDLINE_LINUX_DEFAULT = “quiet splash usbcore.usbfs_memory_mb=128″`
  2. Update grub

Sudo update-Crane

  1. Restart your system

Other boot loaders: to configure additional kernel parameters for other boot loaders, see your boot loader manual.

 

## 4. Verify the device status

* Environment preparation: ubuntu18.04 x64 desktop

* Take Astra + as an example, use USB 3.0 Type-C data cable for connection with PC.

* Use the lsusb command to check whether the PC system has correctly recognized the camera.

* Use PID & VID to determine whether the camera is recognized normally.

VID:2bc5 PID:0536 (color camera)

VID:2bc5 PID:0636 (depth camera)

 

## 5. Linux Sample Compilation

Create a build directory in the OrbbecSDK directory as follows:

CD orbbecSDK
Mkdir build
CD build
CMake ..
Mak

Stay updated

Be the first to learn about our new
products and updates.