This is a template repository for developing applications for the MSP430FR2355 using Rust, it contains everything you need to start developing an application.
This repository contains an empty main.rs project, and a few exmaples using the msp430fr2355 Peripheral Access Crate (PAC) as a low-level interface. A higher-level interface can be provided through the msp430fr2x5x-hal Hardware Abstraction Layer (HAL).
HAL examples can be found in the msp430fr2x5x-hal repository
To build the binary msp430-gcc should be available on your PATH.
To flash the binary mspdebug should be available on your PATH.
Compile the empty project in src/main.rs using cargo build, or one of the examples with cargo build --example <example_name_here>.
To flash the program to your device use cargo run or cargo run --example <example_name_here>.
To debug using gdb first start the debug server with ./debug.sh, then in a separate terminal run msp430-elf-gdb ./target/msp430-none-elf/debug/msp430fr2355-quickstart (or wherever your binary is)
msp430
- Provides low-level access to MSP430 devices, such as access to CPU registers, enabling and disabling interrupts, and friendly wrappers around common assembly instructions like
nop.
msp430-rt
- Manages the runtime and memory layout for an MSP430-based Rust project. Includes features like
#[entry]to mark a function as the entry point of the program, and#[interrupt]to mark a function as an interrupt handler.
msp430fr2355
- The Peripheral Access Crate (PAC) for the MSP430FR2355. This provides a low-level register-level interface similar to what might be found in a typical embedded C program.
msp430fr2x5x-hal
- A high-level Hardware Abstraction Layer (HAL) designed to make working with the MSP430 hardware easier. Slightly higher-level and more opinionated than something like
MSP430 DriverLib.
panic-msp430
- Provides a simple panic handler implementation that disables interrupts and loops infinitely.
msp430-atomic
- Provides wrappers for variable types that can be written to atomically. This makes them safe to use in a global context, like in interrupt handlers.
critical-section
- A generic 'critical section' trait that
msp430implements. Contains wrappers likeMutex(not to be confused withstd::Mutex) for using non-atomic types in global contexts.
Licensed under either of
-
Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
-
MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.