2 releases

0.1.1 May 1, 2022
0.1.0 Apr 25, 2022

#168 in Robotics

MIT license

1MB
278 lines

LD06

This crate is a Rust driver for the tiny LD06 LiDAR sold under a few brands, namely Innomaker. The driver is cross-platform, but not designed for embedded use.

use std::thread::sleep;
use std::time::Duration;
use ld06::ld06_driver::LD06;

fn main() {
    println!("Connecting to a port automatically...");
    let mut ld = LD06::new_auto_port().unwrap();
    ld.listen(); //Port is released in Drop

    println!("Connected!");

    loop {
        if let Some(scan) = ld.next_scan() {
            println!("{:?}", scan);
        } else {
            sleep(Duration::from_millis(15)); //To avoid burning the CPU
        }
    }
}

Info

The driver spawns a background thread that it will listen to a LiDAR from. Once spawned, the thread will read data from the LiDAR into a buffer, which can be queried using the struct on the main thread. This buffer will not loop, so packets will be dropped if the buffer is full.

The driver aims to have a minimal memory footprint, and only contains dynamic allocation for the buffer the port reads into (and even then, this buffer should not grow under normal conditions).

If you wish to use an alternative source of LiDAR data, you can use LD06::from_reader() to provide your own source. The driver implementation makes no assumptions on the use of a serial port, however whatever reader is provided must maintain the same properties as RS232 (i.e. Little Endian). This is useful for testing from cated files.

Dependencies

~3MB
~54K SLoC