SAMD Timer

High-level API for the TCC/TC peripherals found on the Microchip SAMD and SAME MCUs.

This library is usable (as in I use it), but could contain bugs. USE AT YOUR OWN RISK.

This library provides the Timer and ControlTimer types for working safely with TC and TCC peripherals respectively. Full support for waveform generation capabilities, double buffering, and capture modes.

Provides finer grain control over your timers than the abstraction used by atsamd-hal. Simply drop in the library; it works with the atsamd-hal clock system.

Usage

Add the following line to your Cargo.toml.

samd-timer = "0.2.0"

The following feature flags control which MCU variant you are targetting.

Example

use atsamd_hal::target_device::Peripherals;
use atsamd_hal::clock::GenericClockController;
use samd_timer::{TimerConfig, Timer, Prescaler, Synchronization, TimerWaveGen};

fn main() {
    let mut peri = Peripherals.take().unwrap();

    let mut clocks = GenericClockController::with_internal_32kosc(
        peri.GCLCK,
        &mut peri.MCLK,
        &mut peri.OSC32KCTRL,
        &mut peri.OSCCTRL,
        &mut peri.NVMCTRL
    );

    let timer_clock = clocks.gclk1();
    let tc_clock = clocks.tc0_tc1(&timer_clock).unwrap();

    /// Create a 8-bit width timer configuration.
    let mut config = TimerConfig::count8();
    config.prescaler(Prescaler::Div64)
        .sync(Synchronization::Prescaler)
        .wave_gen(TimerWaveGen::NPWM);

    /// Initialise the timer instance.
    let mut timer = config.tc0(&mut peri.MCLK, &tc_clock, peri.TC0);

    // Output a PWM wave with a period of 2 secs and duty cycle of 50%
    timer.set_period(999);
    timer.set_cc0(499);
    timer.enable();
}

Features

TCC

• One-Shot Operation
• Interrupt Control
• Direction changing
• Waveform Generation
• Waveform Output Inversion
• Dithering
• Dead-time Insertion Generator
• Output Matrixing
• Pattern Generation
• Fault Control
• Event Control
• Master-Slave Operation
• Double Buffering

TC

• 8-bit mode (incl. PER register)
• 16-bit mode
• 32-bit mode
• Interrupt Control
• One-Shot Operation
• Direction changing
• Waveform Generation
• Waveform Output Inversion
• Capture Channels
• Event Control
• Double Buffering (SAMx5x)
• Capture Modes (SAMx5x)
• Capture on Pin (SAMx5x)

License

samd-timer is distributed under the MIT license. See the LICENSE file for the full text of the license.