14 releases

new 0.3.10 Apr 15, 2024
0.3.7 Jan 26, 2024
0.3.6 Dec 15, 2023
0.3.5 Sep 20, 2023
0.1.3 Dec 17, 2022

#5 in Robotics

Download history 6/week @ 2023-12-23 51/week @ 2023-12-30 174/week @ 2024-01-06 108/week @ 2024-01-13 87/week @ 2024-01-20 79/week @ 2024-01-27 175/week @ 2024-02-03 102/week @ 2024-02-10 99/week @ 2024-02-17 133/week @ 2024-02-24 150/week @ 2024-03-02 333/week @ 2024-03-09 334/week @ 2024-03-16 234/week @ 2024-03-23 206/week @ 2024-03-30 567/week @ 2024-04-06

1,357 downloads per month

Custom license

7.5MB
180K SLoC

safe_drive: Formally Specified Rust Bindings for ROS2

safe_drive is a Rust bindings for ROS2. This library provides formal specifications and tested the specifications by using a model checker. Therefore, you can clearly understand how the scheduler work and the safeness of it.

Specifications

Some algorithms we adopted are formally specified and tested the safeness by using TLA+. Original ROS2's executor (rclcpp) suffers from starvation. In contrast, the starvation freedom of our executor has been validated by not only dynamic analysis but also formal verification.

See specifications.

We specified and tested as follows.

  • Single Threaded Callback Execution
    • Deadlock freedom
    • Starvation freedom
  • Scheduling Core Algorithm
    • Validate the insertion algorithm
    • Termination
  • Initialize Once
    • Deadlock freedom
    • Termination
    • Initialization is performed just once

Documents

Supporting ROS2

  • Humble
  • Galactic (EOL)

Supporting DDS

  • CycloneDDS
  • FastDDS

Progress

  • Zero copy
  • Custom memory allocator
  • Topic (Pub/Sub)
  • Service (Client/Server)
  • Asynchronous programming (async/await)
  • Callback based programming
  • Logging
  • Signal handling
  • Parameter
  • Timer
  • Action (service + topic)
  • Rust code generation from .msg and .srv files
  • Formal Specification
    • Single threaded callback based executer
    • Scheduling Core Algorithm
    • Initializer performed just once

Dependencies

~3–11MB
~97K SLoC