neuroradiology / teensy3-rs

Rust on the Teensy3

Rust on Teensy3

• teensy3:
• teensy3-sys:

Documentation

This is a repo for development on the Teensy3 in Rust. This repo is bootstrapped with Teensyduino bindings, generated by servo's branch of bindgen.

Getting Started

This crate is meant to be consumed by a binary for a PJRC Teensy 3.1 or 3.2. Support for Teensy 3.0, 3.5, and 3.6 boards is planned, but not implemented.

To use this crate, please see this demo repo which can be used as a template for your project.

Package layout

• teensy3-sys - This crate contains the C/C++ code and the Rust bindings against them. All items are generally unsafe, and not idiomatic rust.
• teensy3 - This crate contains any ergonomic wrappers around teensy3-sys components, as well as any pure rust reimplementations of other components. teensy3-sys is re-exported as teensy3::bindings.

Dependencies

• A somewhat current Nightly Build of Rust (currently tested on rustc 1.13.0-nightly (4f9812a59 2016-09-21))
• Japaric's Xargo Tool - used to cross compile libcore
• A somewhat current arm-none-eabi-gcc toolchain.
  • 4.9.3 seems to work with a slight linkerfile hack
  • 6.x.x seems to work without hacks.

Thanks, Citiations

This code is nearly entirely thanks to these resources:

• PJRC's Teensyduino libraries for the Teensy3, which are used as bindings.
• Simon's teensy3-clock repo for the rust main, build scripts, bindgen knowledge, et. al.
• Servo's fork of bindgen

License

Rust contributions are licensed under the MIT License.

Please Note: ASM, C, C++, and Linker Components of the teensy3-sys crate (a dependency of the teensy3 crate) contain components licensed under the MIT License, PJRC's modified MIT License, and the LGPL v2.1. Please refer to individual components for more details.