Internal - LIPS Developer Documentation
  • WELCOME
    • LIPS® Developer Documentation
  • INSTALLATION & SETUP
    • LIPSedge™ AE400 / AE450
      • SDK Release
        • Firmware
        • SDK
        • User Guide
      • Installation
        • Linux
        • Windows
        • ROS Wrapper
        • NVIDIA ISAAC Wrapper
    • LIPSedge™ AE430 / AE470
      • Installation
        • Linux
        • Windows
    • LIPSedge™ DL & M3 Series
      • SDK Release
      • Installation
        • Ubuntu
        • Windows
    • LIPSFace™ HW110/115 On-Device 3D Facial Recognition
      • User Guide & SDK Download
    • LIPSFace™ HW120/125 On-Device 3D Facial Recognition
    • LIPSMetric™ HA110 Handheld Dimensioner
      • User Guide
    • LIPSMetric™ ST115 Static Dimensioner
      • User Manual
  • SDK CODE SAMPLES AND LANGUAGES WRAPPERS
    • LIPSedge™ SDK
      • Sample Applications & Viewer & Utilities
      • C++
        • ni-hello
        • ni-simple-read
      • Python
        • ni-hello
        • ni-simple-read
      • Java
        • ni-hello
      • C#
      • OpenCV
      • ROS
    • LIPSFace™ SDK
      • LIPSFace™ SDK Overview
      • LIPSFace™ SDK Developer Guide
Powered by GitBook
On this page
  • Method 1: Docker
  • Method 2: Install Manually
  1. INSTALLATION & SETUP
  2. LIPSedge™ DL & M3 Series
  3. Installation

Ubuntu

PreviousInstallationNextWindows

Last updated 2 years ago

Method 1: Docker

Pull the latest

$ docker pull hedgehao/lips-openni2-sdk

Run with following command to bridge USB and GUI between docker and host.

$ docker run -it --privileged -v /dev/bus/usb/:/dev/bus/usb --device=/dev/dri --group-add video -v /tmp/.X11-unix/:/tmp/.X11-unix -e "DISPLAY=$DISPLAY" hedgehao/lips-openni2-sdk

Method 2: Install Manually

1. Download LIPSedge OpenNI2 SDK from the release page

2. Extract files from the downloaded SDK file.

3. Install dependencies

$ sudo apt-get install libopenni2-0 libopenni2-dev

4. Build OpenCV3.4 by executing opencv3.4.1_installation_in_linux.sh in the SDK folder.

$ sudo ./LIPS-Linux-x64-OpenNI2.2/opencv3.4.1_installation_in_linux.sh

5. Execute install.sh in SDK folder.

$ sudo ./LIPS-Linux-x64-OpenNI2.2/install.sh

6. Accessing camera video stream through NiViewer. NiViewer provide video streaming and some basic configuration. Right click in NiViewer to open configuration menu.

./LIPS-Linux-x64-OpenNI2.2/Tools/NiViewer

7. LIPSedge provide much more specific configuration. We will discuss about it in laster articles.

8. There are some handy tools to test your camera.

  • Ni2CameraMatrix: Access camera's parameters.

  • Ni2PointCloud: Camera point cloud view.

  • Ni2PowerTest: LIPS SDK supports a Standby Mode (Low Power Mode) for which users can stop live streaming temporarily and resume live streaming at any time by sending a status code through Ni2PowerTest.

docker image