Lib.rs

› Embedded development › WPILib
#frc #first #robotics #wpi-lib #roborio

sys wpilib-sys

FRC's WPILib system bindings for rust

Owned by David Vo, Josh Hejna, first-rust-competition.

5 releases (3 breaking)

Uses old Rust 2015

0.4.0 Jan 16, 2019
0.3.1 Nov 30, 2018
0.3.0 Nov 20, 2018
0.2.3 Oct 19, 2018
0.1.0 Oct 19, 2018

#2 in #wpi-lib


Used in 2 crates

MIT/Apache

5.5MB
2K SLoC

Contains (ELF lib, 1.5MB) lib/libwpiutil.so, (ELF lib, 720KB) lib/libFRC_NetworkCommunication.so, (ELF lib, 1MB) lib/libNiRioSrv.so, (ELF lib, 755KB) lib/libniriodevenum.so, (ELF lib, 435KB) lib/libRoboRIO_FRC_ChipObject.so, (ELF lib, 430KB) lib/libwpiHal.so and 4 more.

FIRST Rust Competition

Build Status Crates.io Docs.rs

A monorepo for wpilib for programming FRC robots and cargo-frc for deploying said code. Currently a pre-alpha WIP.

Getting Started

Parts of this repository are designed to be compiled for a RoboRIO, the processor used in the FIRST Robotics Competition. To cross-compile your code and run Rust on your RoboRIO, follow the instructions in WPILib's README.

Examples can be found in wpilib-examples.

To deploy code you write using wpilib, use cargo-frc.

A small project template is available in quickstart.zip.

Other Rust Projects

If you want to go further with Rust development for FRC, check out these other community projects:

  • ctre-rs for functionality found in CTRE Phoenix.
  • nt-rs for using NetworkTables.
  • navx-rs for interfacing with Kauai Labs's gyroscope.

Building

Verify you can build wpilib, (see its README) then run make all. cargo-frc should build out of the box, but you should cargo install it to use it properly.

For a full list of build requirements, see the Dockerfile used for Travis CI.

License

The contents of this repository are distributed under the terms of both the MIT license and the Apache License (Version 2.0). By contributing, you agree to license your contribution under these terms.

See LICENSE-APACHE, LICENSE-MIT, for details.

No runtime deps