ATSAME54P

ATSAME54P是一个针对Microchip(原Atmel)ATSAME54P芯片的外设访问库，用于Rust嵌入式项目。

文档

这个源代码是通过svd2rust自动生成的，使用form分割成更小的部分，并通过rustfmt进行格式化。

许可证

采用以下任一种许可证：

• Apache License, Version 2.0
• MIT license

贡献

除非您明确声明，否则任何有意提交的贡献都将按照上述双重许可证授权，不附加任何额外条款或条件。

示例代码

以下是一个使用atsame54p库进行ATSAME54P微控制器开发的基本示例：

#![no_std]
#![no_main]

use atsame54p as pac;
use panic_halt as _;

#[cortex_m_rt::entry]
fn main() -> ! {
    // 获取设备外设访问实例
    let dp = pac::Peripherals::take().unwrap();
    
    // 配置时钟
    let _clocks = atsame54p_hal::clock::GenericClockController::with_external_32kosc(
        dp.GCLK,
        &mut dp.MCLK,
        &mut dp.OSC32KCTRL,
        &mut dp.OSCCTRL,
        &mut dp.NVMCTRL,
    );
    
    // 配置引脚
    let pins = atsame54p_hal::Pins::new(dp.PORT);
    
    // 配置LED引脚为输出
    let mut led = pins.pa15.into_push_pull_output();
    
    loop {
        // 切换LED状态
        led.toggle();
        
        // 简单延时
        cortex_m::asm::delay(8_000_000);
    }
}

更完整的示例 - 使用串口通信

#![no_std]
#![no_main]

use atsame54p as pac;
use atsame54p_hal as hal;
use panic_halt as _;

use core::fmt::Write;
use hal::clock::GenericClockController;
use hal::delay::Delay;
use hal::prelude::*;
use hal::serial::{self, Serial};

#[cortex_m_rt::entry]
fn main() -> ! {
    // 获取设备外设
    let mut peripherals = pac::Peripherals::take().unwrap();
    let mut core = pac::CorePeripherals::take().unwrap();
    
    // 配置时钟
    let mut clocks = GenericClockController::with_external_32kosc(
        peripherals.GCLK,
        &mut peripherals.MCLK,
        &mut peripherals.OSC32KCTRL,
        &mut peripherals.OSCCTRL,
        &mut peripherals.NVMCTRL,
    );
    
    // 初始化延时
    let mut delay = Delay::new(core.SYST, &mut clocks);
    
    // 配置引脚
    let pins = hal::Pins::new(peripherals.PORT);
    
    // 配置串口通信
    let tx = pins.pa04.into_function_c();
    let rx = pins.pa05.into_function_c();
    
    let mut uart = Serial::sercom0(
        peripherals.SERCOM0,
        (tx, rx),
        &mut peripherals.MCLK,
        115200.hz(),
        serial::Mode::Async,
        &mut clocks,
    );
    
    // 发送欢迎消息
    writeln!(uart, "ATSAME54P UART Example\r").unwrap();
    
    loop {
        // 发送计数消息
        writeln!(uart, "Counter: {}\r", 42).unwrap();
        
        // 延时1秒
        delay.delay_ms(1000u16);
    }
}

以上示例展示了ATSAME54P库的基本使用方法，包括：

1. 时钟配置
2. GPIO控制
3. 串口通信
4. 延时功能

可以根据具体需求扩展这些基础功能，如添加中断处理、使用其他外设等。

完整示例 - PWM控制LED亮度

#![no_std]
#![no_main]

use atsame54p as pac;
use atsame54p_hal as hal;
use panic_halt as _;

use hal::clock::GenericClockController;
use hal::pwm::Pwm0;
use hal::time::U32Ext;

#[cortex_m_rt::entry]
fn main() -> ! {
    // 获取设备外设
    let mut peripherals = pac::Peripherals::take().unwrap();
    let mut core = pac::CorePeripherals::take().unwrap();
    
    // 配置时钟
    let mut clocks = GenericClockController::with_external_32kosc(
        peripherals.GCLK,
        &mut peripherals.MCLK,
        &mut peripherals.OSC32KCTRL,
        &mut peripherals.OSCCTRL,
        &mut peripherals.NVMCTRL,
    );
    
    // 配置引脚
    let pins = hal::Pins::new(peripherals.PORT);
    
    // 配置PWM引脚
    let pwm_pin = pins.pa05.into_function_c();
    
    // 创建PWM实例
    let mut pwm = Pwm0::new(
        peripherals.TCC0,
        &mut peripherals.MCLK,
        &mut clocks,
        1.khz(),
        pwm_pin,
    );
    
    let max_duty = pwm.get_max_duty();
    
    // 呼吸灯效果
    loop {
        // 渐亮
        for i in 0..max_duty {
            pwm.set_duty(i);
            cortex_m::asm::delay(10_000);
        }
        
        // 渐暗
        for i in (0..max_duty).rev() {
            pwm.set_duty(i);
            cortex_m::asm::delay(10_000);
        }
    }
}

这个完整示例展示了如何使用ATSAME54P库实现PWM控制LED亮度，创建呼吸灯效果。主要功能包括：

1. 初始化PWM外设
2. 配置PWM频率
3. 动态调整占空比
4. 实现平滑的亮度变化效果