rust_rpi_4wd_car
Table Of Contents
Getting Started
You will need to have a recent version of Rust installed. Any version of Rust that supports version 0.12.0 or later of rppal should work but version 1.51.0 of Rust have been used during initial development on both the release channel. Earlier versions might work as well but have not been tested.
Development can be done on any OS that Rust supports but the only expected output target is a Raspberry Pi running a Linux OS. All initial development has been done with a combination of a laptop running Windows 10 and a 4GB Raspberry Pi 4 running the Raspberry Pi OS (Raspbian).
Using The Crate
To use the crate in your own project all you need to do is include it in
[dependencies] of you project like you would any other crate.
If you have cargo-edit install then on the command line you can use:
cargo add rust_rpi_4wd_car
Which should add something like this in your Cargo.toml:
[]
= "0.0.10"
Examples
You will find examples in the examples directory. The all_examples
example was used for testing during initial development on a RPi 4.
To build the all_examples example start by clone this project somewhere on
your Raspberry Pi:
git clone https://github.com/Oxidized-Robots/rust_rpi_4wd_car
Next execute the follow to build the example:
cargo build --example all_examples
And finally execute:
sudo ./target/debug/examples/all_examples
You should see the series of tests being run which demo most of the aspects from the crate.
You can find the latest version by go to rust_rpi_4wd_car on the crates.io website.
Contributing
Contributors are welcome. Please note that this project has a Contributor Covenant Code of Conduct. By participating in this project you agree to abide by its terms.
All intentionally contributed code will be considered to also be contributed under a dual licensing of APACHE and MIT without any additional terms or conditions. Please include your information in a comment on all code files for the copyright etc.
All intentionally contributed documentation or non-code text like this README etc. will be considered to be contributed under the same CC-BY-SA license without any additional terms or conditions.
Pull requests are always welcome. For major changes, please open an issue first to discuss what you would like to change. Please make sure to update or add tests as appropriate.
Licenses
All code is licensed under either of the
at your option.
You can find copies of the licenses in the LICENSE-APACHE and the LICENSE-MIT files. All documentation like this README is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License (CC-BY-SA). You can find a copy of the CC-BY-SA license in the LICENSE-CC-BY-SA file.