https://github.com/andyblarblar/ld06
A Rust driver for the LD06 LiDAR
https://github.com/andyblarblar/ld06
driver lidar
Last synced: 2 months ago
JSON representation
A Rust driver for the LD06 LiDAR
- Host: GitHub
- URL: https://github.com/andyblarblar/ld06
- Owner: andyblarblar
- Created: 2022-04-16T16:54:21.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2022-05-01T06:13:35.000Z (about 3 years ago)
- Last Synced: 2025-04-11T04:04:47.527Z (2 months ago)
- Topics: driver, lidar
- Language: Rust
- Homepage: https://docs.rs/ld06/latest/ld06/index.html
- Size: 1.18 MB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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.
```no_run
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.