periph_conf_common.h File Reference

Common configuration for clock, timer, pwm, adc, rtc and rtt peripherals for Arduino MKR boards. More...

Detailed Description

Common configuration for clock, timer, pwm, adc, rtc and rtt peripherals for Arduino MKR boards.

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

Bumsik kim kbums.nosp@m.ik@g.nosp@m.mail..nosp@m.com

Definition in file periph_conf_common.h.

#include "periph_cpu.h"

Include dependency graph for periph_conf_common.h:

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

Go to the source code of this file.

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
#define	CLOCK_USE_PLL   (1)
#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 []

PWM configuration
#define	PWM_0_EN   1
#define	PWM_NUMOF   ARRAY_SIZE(pwm_config)
static const pwm_conf_chan_t	pwm_chan0_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 []

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 []

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, 2), ADC_INPUTCTRL_MUXPOS_PIN10},    
    {GPIO_PIN(PB, 3), ADC_INPUTCTRL_MUXPOS_PIN11},    
    {GPIO_PIN(PA, 4), ADC_INPUTCTRL_MUXPOS_PIN4},     
    {GPIO_PIN(PA, 5), ADC_INPUTCTRL_MUXPOS_PIN5},     
    {GPIO_PIN(PA, 6), ADC_INPUTCTRL_MUXPOS_PIN6},     
    {GPIO_PIN(PA, 7), ADC_INPUTCTRL_MUXPOS_PIN7},     
}

Definition at line 160 of file periph_conf_common.h.

i2c_config

const i2c_conf_t i2c_config[]

static

Initial value:

= {
    {
        .dev      = &(SERCOM0->I2CM),
        .speed    = I2C_SPEED_NORMAL,
        .scl_pin  = GPIO_PIN(PA, 9),
        .sda_pin  = GPIO_PIN(PA, 8),
        .mux      = GPIO_MUX_C,
        .gclk_src = SAM0_GCLK_MAIN,
        .flags    = I2C_FLAG_NONE
     }
}

Definition at line 178 of file periph_conf_common.h.

pwm_chan0_config

const pwm_conf_chan_t pwm_chan0_config[]

static

Initial value:

= {
    
    { GPIO_PIN(PA, 10), GPIO_MUX_F, 2 },    
    { GPIO_PIN(PA, 11), GPIO_MUX_F, 3 },    
}

Definition at line 130 of file periph_conf_common.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},
 
}

Definition at line 138 of file periph_conf_common.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 205 of file periph_conf_common.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 86 of file periph_conf_common.h.