Module atmega_hal::clock

Core clock speed management

AVR microcontrollers support different core clock speeds. Peripheral drivers need to know about this speed to calculate timing parameters. To make this as efficient as possible, the clock speed is tracked as a compile-time constant. This means peripheral drivers can do compile-time calculation of timing parameters.

How To Use

If you are using arduino-hal, there is nothing you need to do - the core clock speed is defined in arduino-hal as arduino_hal::DefaultClock and the const-generic parameters of all peripheral drivers are preset to this value.

If you are using a MCU HAL like atmega-hal or attiny-hal, you need to take care of clock speed management manually. The best way to do this is as follows:

• Define a “constant” for your core clock speed in the crate root:

  type CoreClock = atmega_hal::clock::MHz16;

• Define aliases for peripheral driver types based on this clock:

  type Adc = atmega_hal::adc::Adc<crate::CoreClock>;
  type I2c = atmega_hal::i2c::I2c<crate::CoreClock>;

Structs

• MHz1
  1 MHz Clock
• MHz8
  8 MHz Clock
• MHz10
  10 MHz Clock
• MHz12
  12 MHz Clock
• MHz16
  16 MHz Clock
• MHz20
  20 MHz Clock
• MHz24
  24 MHz Clock

Traits

• Clock
  A clock speed