2 releases
0.1.1 | May 1, 2022 |
---|---|
0.1.0 | Apr 25, 2022 |
#168 in Robotics
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 cat
ed files.
Dependencies
~3MB
~54K SLoC