Lib.rs

MSPM0L1306编程设置指南

1. 简介

本文档的目的是提供一个基本概述和指南，用于在Visual Studio Code中为MSPM0L1306准备编程环境。最终结果是创建一个可以控制设备外设并将代码和调试数据通过OpenOCD闪存到设备上的项目模板。

2. Rust安装

要开始设置Rust环境以用于MSPM0L1306的编程，请从rust-lang.org/tools/install安装Rust。安装完成后，建议重新启动计算机，以便命令提示符能够识别计算机上的路径目录。

3. 所需工具安装

现在，Rust已经安装，下一步是安装一些依赖项，以便使用rustup和cargo install创建和闪存Rust项目，这些工具可以用于安装Rust的插件。

// This will allow for the basic project template to be copied from Git Hub to be further configured.
cargo install cargo-generate
//This adds the ability to target M0 devices such as the MSPM0L1306
rustup target add thumbv6m-none-eabi
//cargo embed is a tool used to flash code onto microcontrollers using the cargo embed command 
cargo install cargo-embed

4. 配置基本项目

创建基本项目模板的第一步是运行以下命令，以创建一个新项目文件，该文件包含在Rust中使MSPM0L1306编程基本功能的要求。

//This creates and renames the project at the specified GitHub to the current directory
cargo generate --git https://github.com/WKNick/MSPM0L1306-BASIC-RUST-CONFIG --name myproject 

需要配置的主要文件是Cargo.toml中的[package]和[dependencies]部分。目前不需要依赖项，但需要基于它们指定新版本的Crates并启用访问其他Crates。软件包部分需要更改，以便包含正确的作者名称、Rust版本和名称。如果项目是一个软件包而不是要闪存到板上的项目，还需要一个版本号和仓库。还需要稍作修改另一个文件，即位于.vscode文件夹中的launch.json文件。

“"executable":"./target/thumbv6m-none-eabi/debug/,”

此行需要以在Cargo.toml文件中指定的项目名称结尾，以便使用OpenOCD进行调试。

5. 设备闪存

如果配置文件都配置正确，向设备闪存是一个简单的过程。GitHub中的默认main文件将仅打开板上的红色LED。每次对板上的代码进行更改时，都需要进行闪存操作，以便设备接收新代码。

//This is how to flash code onto the board it compiles main and anything else main 
references into binary and flashes it to the board
cargo embed 

6. 使用MSPM0L PAC和HAL，有两种方式控制板上的外设。第一种是通过名为MSPM0L1306-HAL的HAL Crate，第二种是通过名为mspm0l130x的PAC Crate。要使用PAC，需要对微控制器有深入的了解，知道如何使用它。以下是一个创建启用gpio外设功能的函数的示例。

pub fn enable(){
    unsafe{
        let peripherals = pac::Peripherals::steal();
        let gpioa = peripherals.GPIOA;
        gpioa.rstctl.write(|w|w.bits(0xb1000003));// reset gpio info
        gpioa.pwren.write(|w|w.bits(0x26000001));// enable gpio with reset key
        }
}

另一种方法是使用HAL，它已经包含了外设的功能函数，因此不需要深入了解设备寄存器。在之前的步骤中设置的基项目中包含一个示例文件夹，概述了如何使用HAL来处理一些外设。

7. OpenOCD调试

首先，要使用OpenOCD，必须从您首选的来源下载适用于您的设备的应用程序。

一旦将程序烧录到板上，使用OpenOCD就相当简单，因为launch.json文件已经配置好。需要做的只是在Visual Studio Code中的第4个选项卡“运行和调试”中点击“运行并调试”旁边的绿色按钮。在此选项卡中，点击运行时选择与OpenOCD一起调试的按钮，将启动程序。这将提供播放/暂停按钮以及用于进入/跳过代码的箭头，并允许在程序暂停时在左下角的窗口中读取和写入寄存器值。