17 unstable releases (7 breaking)

0.8.4 Jun 24, 2022
0.7.0 Oct 22, 2021
0.5.0 Jan 13, 2021
0.3.0 Oct 18, 2020
0.1.4 Jul 4, 2020

#671 in Hardware support

MIT/Apache

79KB
1.5K SLoC

Lynxmotion Smart Servo Driver

Crates.io Docs Rust Rust-windows codecov License

This crate provides an asynchronous serial driver the the Lynxmotion smart servos.

You can read more about the servos on the official robotshop wiki

Driver

The Smart servos are controlled over a serial UART protocol.

You can read about the protocol here It's highly recommended to at least skim the protocol page before trying to use this driver.

This driver currently doesn't implement all features from the protocol.
Some missing features are modifiers and setup commands.
If there are any missing commands or features you'd like added feel free to raise a PR or an issue.

This driver uses async/await. As a result you will need to use an async runtime. The driver is based on tokio-serial so tokio would be a good choice but any should work.

Usage

This crate comes with multiple examples.
These are a good start if you want to learn how to use it.


#[tokio::main]
async fn main() {
    // Create a driver on port `COM14` or `/dev/ttyUSB0`...
    let mut driver = lss_driver::LSSDriver::new("COM14").unwrap();
    // In case there is only one servo connected
    // we can query it's ID using the broadcast ID
    let id = driver.query_id(lss_driver::BROADCAST_ID).await.unwrap();
    // move motor with ID 5 to 90.0 degrees
    driver.move_to_position(5, 90.0).await.unwrap();
    // Set color of servo with ID 5 to Magenta
    driver.set_color(5, lss_driver::LedColor::Magenta).await.unwrap();
}

Building

This package shouldn't depend on any native libraries.
Rust serialport depends on pkg-config and libudev-dev on GNU Linux but they should be disabled for this crate.
If you do run into issues with them failing it may be worth looking into their dependencies and raising an issue here.

Changelog

Version 0.5.0 - (2020-01-13)

  • Windows support

Version 0.6.1 - (2021-09-28)

  • Tokio 1.0 support (Now also on windows!)

Disclaimer

This software is not officially endorsed by Lynxmotion or Robotshop!

All product names, logos, and brands are property of their respective owners. All company, product and service names used in this website are for identification purposes only. Use of these names, logos, and brands does not imply endorsement.

Dependencies

~6–15MB
~180K SLoC