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.

#define	CLOCK_DIV (1U)

#define	CLOCK_CORECLOCK (8000000 / CLOCK_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_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` */

#define	RTT_MIN_OFFSET (10U)

USB peripheral configuration
static const sam0_common_usb_config_t	sam_usbdev_config []

Macro Definition Documentation

◆ ADC_GAIN_FACTOR_DEFAULT

#define ADC_GAIN_FACTOR_DEFAULT ADC_INPUTCTRL_GAIN_1X

Definition at line 208 of file periph_conf.h.

◆ ADC_NEG_INPUT

#define ADC_NEG_INPUT ADC_INPUTCTRL_MUXNEG_GND

Definition at line 207 of file periph_conf.h.

◆ ADC_NUMOF

#define ADC_NUMOF ARRAY_SIZE(adc_channels)

Definition at line 221 of file periph_conf.h.

◆ ADC_PRESCALER

#define ADC_PRESCALER ADC_CTRLB_PRESCALER_DIV512

Definition at line 205 of file periph_conf.h.

◆ ADC_REF_DEFAULT

#define ADC_REF_DEFAULT ADC_REFCTRL_REFSEL_INT1V

Definition at line 209 of file periph_conf.h.

◆ CLOCK_CORECLOCK

#define CLOCK_CORECLOCK (8000000 / CLOCK_DIV)

Definition at line 75 of file periph_conf.h.

◆ CLOCK_DIV

#define CLOCK_DIV (1U)

Definition at line 73 of file periph_conf.h.

◆ 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 63 of file periph_conf.h.

◆ I2C_NUMOF

#define I2C_NUMOF ARRAY_SIZE(i2c_config)

Definition at line 275 of file periph_conf.h.

◆ PWM_0_EN

#define PWM_0_EN 1

Definition at line 165 of file periph_conf.h.

◆ PWM_1_EN

#define PWM_1_EN 1

Definition at line 166 of file periph_conf.h.

◆ PWM_NUMOF

#define PWM_NUMOF ARRAY_SIZE(pwm_config)

Definition at line 196 of file periph_conf.h.

◆ RTT_FREQUENCY

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

Definition at line 283 of file periph_conf.h.

◆ RTT_MIN_OFFSET

#define RTT_MIN_OFFSET (10U)

Definition at line 285 of file periph_conf.h.

◆ SPI_NUMOF

#define SPI_NUMOF ARRAY_SIZE(spi_config)

Definition at line 255 of file periph_conf.h.

◆ TIMER_0_ISR

#define TIMER_0_ISR isr_tc3

Definition at line 113 of file periph_conf.h.

◆ TIMER_0_MAX_VALUE

#define TIMER_0_MAX_VALUE 0xffff

Definition at line 110 of file periph_conf.h.

◆ TIMER_1_ISR

#define TIMER_1_ISR isr_tc4

Definition at line 114 of file periph_conf.h.

◆ TIMER_NUMOF

#define TIMER_NUMOF ARRAY_SIZE(timer_config)

Definition at line 116 of file periph_conf.h.

◆ UART_0_ISR

#define UART_0_ISR isr_sercom5

Definition at line 155 of file periph_conf.h.

◆ UART_1_ISR

#define UART_1_ISR isr_sercom0

Definition at line 156 of file periph_conf.h.

◆ UART_NUMOF

#define UART_NUMOF ARRAY_SIZE(uart_config)

Definition at line 158 of file periph_conf.h.

Variable Documentation

◆ adc_channels

const adc_conf_chan_t adc_channels[]

static

Initial value:

= {
    
    { .inputctrl = ADC_INPUTCTRL_MUXPOS_PA02 },   
    { .inputctrl = ADC_INPUTCTRL_MUXPOS_PB08 },   
    { .inputctrl = ADC_INPUTCTRL_MUXPOS_PB09 },   
    { .inputctrl = ADC_INPUTCTRL_MUXPOS_PA04 },   
    { .inputctrl = ADC_INPUTCTRL_MUXPOS_PA05 },   
    { .inputctrl = ADC_INPUTCTRL_MUXPOS_PB02 },  
}

Definition at line 211 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 263 of file periph_conf.h.

◆ pwm_config

const pwm_conf_t pwm_config[]

static

Initial value:

= {
 
}

Definition at line 186 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 292 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,
    },
    {
        .dev      = &SERCOM1->SPI,
        .miso_pin = GPIO_PIN(PA, 19),
        .mosi_pin = GPIO_PIN(PA, 16),
        .clk_pin  = GPIO_PIN(PA, 17),
        .miso_mux = GPIO_MUX_C,
        .mosi_mux = GPIO_MUX_C,
        .clk_mux  = GPIO_MUX_C,
        .miso_pad = SPI_PAD_MISO_3,
        .mosi_pad = SPI_PAD_MOSI_0_SCK_1,
        .gclk_src = SAM0_GCLK_MAIN,
    }
}

Definition at line 228 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_MAIN,
 
        .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_MAIN,
 
        .flags          = TC_CTRLA_MODE_COUNT32,
    }
}

Definition at line 83 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 123 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

◆ ADC_GAIN_FACTOR_DEFAULT

◆ ADC_NEG_INPUT

◆ ADC_NUMOF

◆ ADC_PRESCALER

◆ ADC_REF_DEFAULT

◆ CLOCK_CORECLOCK

◆ CLOCK_DIV

◆ CLOCK_USE_PLL

◆ I2C_NUMOF

◆ PWM_0_EN

◆ PWM_1_EN

◆ PWM_NUMOF

◆ RTT_FREQUENCY

◆ RTT_MIN_OFFSET

◆ SPI_NUMOF

◆ TIMER_0_ISR

◆ TIMER_0_MAX_VALUE

◆ TIMER_1_ISR

◆ TIMER_NUMOF

◆ UART_0_ISR

◆ UART_1_ISR

◆ UART_NUMOF

Variable Documentation

◆ adc_channels

◆ i2c_config

◆ pwm_config

◆ sam_usbdev_config

◆ spi_config

◆ timer_config

◆ uart_config