Configuration of CPU peripherals for Arduino Zero board and clones. More...

Detailed Description

Configuration of CPU peripherals for Arduino Zero board and clones.

Author: Thomas Eichinger thoma.nosp@m.s.ei.nosp@m.ching.nosp@m.er@f.nosp@m.u-ber.nosp@m.lin..nosp@m.de; Hauke Petersen hauke.nosp@m..pet.nosp@m.ersen.nosp@m.@fu-.nosp@m.berli.nosp@m.n.de; Peter Kietzmann peter.nosp@m..kie.nosp@m.tzman.nosp@m.n@ha.nosp@m.w-ham.nosp@m.burg.nosp@m..de; Alexandre Abadie alexa.nosp@m.ndre.nosp@m..abad.nosp@m.ie@i.nosp@m.nria..nosp@m.fr

Definition in file periph_conf.h.

#include <stdint.h>
#include "cpu.h"
#include "periph_cpu.h"

Include dependency graph for periph_conf.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

#define	CLOCK_USE_PLL (1)
	External oscillator and clock configuration. More...

#define	CLOCK_PLL_MUL (47U) /* must be >= 31 & <= 95 */

#define	CLOCK_PLL_DIV (1U) /* adjust to your needs */

#define	CLOCK_CORECLOCK (((CLOCK_PLL_MUL + 1) * 1000000U) / CLOCK_PLL_DIV)

Timer peripheral configuration
#define	TIMER_0_MAX_VALUE 0xffff

#define	TIMER_0_ISR isr_tc3

#define	TIMER_1_ISR isr_tc4

#define	TIMER_NUMOF ARRAY_SIZE(timer_config)

static const tc32_conf_t	timer_config []

UART configuration
#define	UART_0_ISR isr_sercom5

#define	UART_1_ISR isr_sercom0

#define	UART_NUMOF ARRAY_SIZE(uart_config)

static const uart_conf_t	uart_config []

PWM configuration
#define	PWM_0_EN 1

#define	PWM_1_EN 1

#define	PWM_NUMOF ARRAY_SIZE(pwm_config)

static const pwm_conf_chan_t	pwm_chan0_config []

static const pwm_conf_chan_t	pwm_chan1_config []

static const pwm_conf_t	pwm_config []

ADC configuration
#define	ADC_PRESCALER ADC_CTRLB_PRESCALER_DIV512

#define	ADC_NEG_INPUT ADC_INPUTCTRL_MUXNEG_GND

#define	ADC_GAIN_FACTOR_DEFAULT ADC_INPUTCTRL_GAIN_1X

#define	ADC_REF_DEFAULT ADC_REFCTRL_REFSEL_INT1V

#define	ADC_NUMOF ARRAY_SIZE(adc_channels)

static const adc_conf_chan_t	adc_channels []

SPI configuration
#define	SPI_NUMOF ARRAY_SIZE(spi_config)

static const spi_conf_t	spi_config []

I2C configuration
#define	I2C_NUMOF ARRAY_SIZE(i2c_config)

static const i2c_conf_t	i2c_config []

RTT configuration
#define	RTT_FREQUENCY (32768U) /* in Hz. For changes see `rtt.c` */

USB peripheral configuration
static const sam0_common_usb_config_t	sam_usbdev_config []

Macro Definition Documentation

◆ CLOCK_USE_PLL

#define CLOCK_USE_PLL (1)

External oscillator and clock configuration.

For selection of the used CORECLOCK, we have implemented two choices:

usage of the PLL fed by the internal 8MHz oscillator divided by 8
usage of the internal 8MHz oscillator directly, divided by N if needed

The PLL option allows for the usage of a wider frequency range and a more stable clock with less jitter. This is why we use this option as default.

The target frequency is computed from the PLL multiplier and the PLL divisor. Use the following formula to compute your values:

CORECLOCK = ((PLL_MUL + 1) * 1MHz) / PLL_DIV

NOTE: The PLL circuit does not run with less than 32MHz while the maximum PLL frequency is 96MHz. So PLL_MULL must be between 31 and 95!

The internal Oscillator used directly can lead to a slightly better power efficiency to the cost of a less stable clock. Use this option when you know what you are doing! The actual core frequency is adjusted as follows:

CORECLOCK = 8MHz / DIV

NOTE: A core clock frequency below 1MHz is not recommended

Definition at line 67 of file periph_conf.h.

Variable Documentation

◆ adc_channels

const adc_conf_chan_t adc_channels[]

static

Initial value:

= {
    
    {GPIO_PIN(PA, 2), ADC_INPUTCTRL_MUXPOS_PIN0},   
    {GPIO_PIN(PB, 8), ADC_INPUTCTRL_MUXPOS_PIN2},   
    {GPIO_PIN(PB, 9), ADC_INPUTCTRL_MUXPOS_PIN3},   
    {GPIO_PIN(PA, 4), ADC_INPUTCTRL_MUXPOS_PIN4},   
    {GPIO_PIN(PA, 5), ADC_INPUTCTRL_MUXPOS_PIN5},   
    {GPIO_PIN(PB, 2), ADC_INPUTCTRL_MUXPOS_PIN10},  
}

Definition at line 215 of file periph_conf.h.

◆ i2c_config

const i2c_conf_t i2c_config[]

static

Initial value:

= {
    {
        .dev      = &(SERCOM3->I2CM),
        .speed    = I2C_SPEED_FAST,
        .scl_pin  = GPIO_PIN(PA, 23),
        .sda_pin  = GPIO_PIN(PA, 22),
        .mux      = GPIO_MUX_C,
        .gclk_src = SAM0_GCLK_MAIN,
        .flags    = I2C_FLAG_NONE
    }
}

Definition at line 255 of file periph_conf.h.

◆ pwm_chan0_config

const pwm_conf_chan_t pwm_chan0_config[]

static

Initial value:

= {
    
    { GPIO_PIN(PA, 8), GPIO_MUX_E,  0 },
    { GPIO_PIN(PA, 9), GPIO_MUX_E,  1 },
}

Definition at line 174 of file periph_conf.h.

◆ pwm_chan1_config

const pwm_conf_chan_t pwm_chan1_config[]

static

Initial value:

= {
    
    { GPIO_PIN(PA, 6), GPIO_MUX_E, 0 },
    { GPIO_PIN(PA, 7), GPIO_MUX_E, 1 },
}

Definition at line 182 of file periph_conf.h.

◆ pwm_config

const pwm_conf_t pwm_config[]

static

Initial value:

= {
 
    {TCC_CONFIG(TCC0), pwm_chan0_config, ARRAY_SIZE(pwm_chan0_config), SAM0_GCLK_MAIN},
 
    {TCC_CONFIG(TCC1), pwm_chan1_config, ARRAY_SIZE(pwm_chan1_config), SAM0_GCLK_MAIN},
 
}

Definition at line 190 of file periph_conf.h.

◆ sam_usbdev_config

const sam0_common_usb_config_t sam_usbdev_config[]

static

Initial value:

= {
    {
        .dm     = GPIO_PIN(PA, 24),
        .dp     = GPIO_PIN(PA, 25),
        .d_mux  = GPIO_MUX_G,
        .device = &USB->DEVICE,
        .gclk_src = SAM0_GCLK_MAIN,
    }
}

Definition at line 283 of file periph_conf.h.

◆ spi_config

const spi_conf_t spi_config[]

static

Initial value:

= {
    {
        .dev      = &SERCOM4->SPI,
        .miso_pin = GPIO_PIN(PA, 12),
        .mosi_pin = GPIO_PIN(PB, 10),
        .clk_pin  = GPIO_PIN(PB, 11),
        .miso_mux = GPIO_MUX_D,
        .mosi_mux = GPIO_MUX_D,
        .clk_mux  = GPIO_MUX_D,
        .miso_pad = SPI_PAD_MISO_0,
        .mosi_pad = SPI_PAD_MOSI_2_SCK_3,
        .gclk_src = SAM0_GCLK_MAIN,
    }
}

Definition at line 232 of file periph_conf.h.

◆ timer_config

const tc32_conf_t timer_config[]

static

Initial value:

= {
    {   
        .dev            = TC3,
        .irq            = TC3_IRQn,
        .pm_mask        = PM_APBCMASK_TC3,
        .gclk_ctrl      = GCLK_CLKCTRL_ID_TCC2_TC3,
 
        .gclk_src       = SAM0_GCLK_1MHZ,
 
 
 
        .flags          = TC_CTRLA_MODE_COUNT16,
    },
    {   
        .dev            = TC4,
        .irq            = TC4_IRQn,
        .pm_mask        = PM_APBCMASK_TC4 | PM_APBCMASK_TC5,
        .gclk_ctrl      = GCLK_CLKCTRL_ID_TC4_TC5,
 
        .gclk_src       = SAM0_GCLK_1MHZ,
 
 
 
        .flags          = TC_CTRLA_MODE_COUNT32,
    }
}

Definition at line 87 of file periph_conf.h.

◆ uart_config

const uart_conf_t uart_config[]

static

Initial value:

= {
    {
        .dev      = &SERCOM5->USART,
        .rx_pin   = GPIO_PIN(PB,23),
        .tx_pin   = GPIO_PIN(PB,22),
 
 
 
 
        .mux      = GPIO_MUX_D,
        .rx_pad   = UART_PAD_RX_3,
        .tx_pad   = UART_PAD_TX_2,
        .flags    = UART_FLAG_NONE,
        .gclk_src = SAM0_GCLK_MAIN,
    },
    {
        .dev      = &SERCOM0->USART,
        .rx_pin   = GPIO_PIN(PA,11),
        .tx_pin   = GPIO_PIN(PA,10),
 
 
 
 
        .mux      = GPIO_MUX_C,
        .rx_pad   = UART_PAD_RX_3,
        .tx_pad   = UART_PAD_TX_2,
        .flags    = UART_FLAG_NONE,
        .gclk_src = SAM0_GCLK_MAIN,
    }
}

Definition at line 127 of file periph_conf.h.

Detailed Description

Timer peripheral configuration

UART configuration

PWM configuration

ADC configuration

SPI configuration

I2C configuration

RTT configuration

USB peripheral configuration

Macro Definition Documentation

◆ CLOCK_USE_PLL

Variable Documentation

◆ adc_channels

◆ i2c_config

◆ pwm_chan0_config

◆ pwm_chan1_config

◆ pwm_config

◆ sam_usbdev_config

◆ spi_config

◆ timer_config

◆ uart_config