msp430fr2355-quickstart

July 2, 2025 ยท View on GitHub

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

Dependencies

To build the binary msp430-gcc should be available on your PATH.

To flash the binary mspdebug should be available on your PATH.

Usage

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)

An aside - What are all these crates?

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 msp430 implements. Contains wrappers like Mutex (not to be confused with std::Mutex) for using non-atomic types in global contexts.

License

Licensed under either of

at your option.

Contribution

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.