Skip to content

hku-mars/LIV_handhold_2

Repository files navigation

LIV-eye logo

LIV-Eye: A Low-Cost LiDAR-Inertial-Visual Fusion 3D Sensor for Robotics and Embodied AI [中文]

Software License HW License Docs License


Table of Contents


Highlights

One sentence summary: A ~¥5000 (≈ $700) fully open-source hardware/software LiDAR-Inertial-Visual fusion perception kit. ⚙️ Easy assembly, no soldering, one-click reproducibility. 🐳 Supports ROS1/ROS2 and Docker, 🧭 full calibration workflow (intrinsic/extrinsic/time sync), 🧰 compatible with FAST-LIVO2 algorithms, and delivers colored point cloud and odometry results in just 5 minutes.


Repository Structure

├── FAST-LIVO2-Mid360-Config - The configuration and launch files of FAST-LIVO2 for the Mid-360 LiDAR
├── liv_eye_cad - Solidworks files for LIV-Eye
├── livox_ros_driver2 - Livox LiDAR ROS driver
├── mvs_ros_driver - Hikvision Camera ROS driver
└── README.md - Project homepage
└── ...

Bill of Materials (BOM)

Target total cost: ≈ ¥5,000 (≈ $700, subject to actual purchase)

Category Model/Name Reference Price Image
LiDAR Livox Mid-360 ¥3999 (≈ $560) MID-360
Camera Hikvision MV-CU013-A0UC ¥700 (≈ $100) Camera
Lens Hikvision MVL-HF0628M-6MPE ¥150 (≈ $20) Lens
Wire LiDAR-Camera Hardware Synchronizer ¥500 (≈ $70) Sync
Battery 12V DC Battery ¥99 (≈ $15) Battery

Assembly

Solidworks CAD files are provided in liv_eye_cad.
You can download and use them for 3D printing and assembly:

Solidworks Device


Wiring

The diagram below shows the complete wiring of LIV-Eye, in just six steps:

Wiring diagram

Note
If you do not need to use the LiDAR-Camera hardware synchronizer, please refer to the connection method and STM32 hardware synchronization solution in LIV_handhold.


Driver Installation and Run

  1. Download and install MVS and Livox-SDK2. Set the camera to trigger mode in MVS.

  2. Install the camera ROS driver mvs_ros_driver and launch in trigger mode:

roslaunch mvs_ros_driver mvs_camera_trigger.launch 
  1. Install and launch the LiDAR ROS driver livox_ros_driver2:
roslaunch livox_ros_driver2 msg_MID360.launch
  1. Record sensor data:
rosbag record /livox/lidar /livox/imu /left_camera/image

Note
The mvs_ros_driver and livox_ros_driver2 are the same as those in LIV_handhold, and include modifications to support millisecond-level hardware synchronization.


LiDAR-Camera Joint Calibration

  1. Calibrate camera intrinsics. e.g. matlab.
  2. Use FAST-Calib for LiDAR–camera extrinsic calibration.

camera calibration fast calib


Running FAST-LIVO2

Install FAST-LIVO2. The configuration and launch files for the Mid-360 are provided in FAST-LIVO2-Mid360-Config. Update the intrinsic and extrinsic parameters to match your device, then run:

roslaunch fast_livo mapping_mid360.launch

This demo corresponds to the example LIV-Eye rosbag, which can be downloaded here.

livo2 results


Platform Adaptability

LIV-Eye is compact yet versatile! With its small form factor, standardized wiring, and open-source software, it can be seamlessly integrated into a wide range of robotic platforms to enable perception, navigation, and embodied AI research.

LIV-Eye on wheeled robot fast calib

Acknowledgements

This project is based on the following open-source projects:


License

The source code is released under the GPLv2 license.

If you use this codebase in academic research, please cite any of the following papers:

[1] Zheng, Chunran, et al. "FAST-LIVO2: Fast, Direct LiDAR-Inertial-Visual Odometry." 
[2] Zheng, Chunran, et al. "FAST-LIVO: Fast and Tightly-coupled Sparse-Direct LiDAR-Inertial-Visual Odometry." 
[3] Zheng, Chunran, et al. "FAST-Calib: LiDAR-Camera Extrinsic Calibration in One Second." 
[4] Ziming, Wang, et al. "USTC FLICAR: A sensors fusion dataset of LiDAR-inertial-camera for heavy-duty autonomous aerial work robots."