Loading...
Searching...
No Matches
periph_conf.h File Reference

Configuration of CPU peripherals for the Atmel SAM D10 Xplained Mini board. More...

Detailed Description

Configuration of CPU peripherals for the Atmel SAM D10 Xplained Mini board.

Author
Benjamin Valentin benja.nosp@m.min..nosp@m.valen.nosp@m.tin@.nosp@m.ml-pa.nosp@m..com

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.

External oscillator and clock configuration

There are three choices for selection of CORECLOCK:

  • usage of the 48 MHz DFLL fed by external oscillator running at 32 kHz
  • 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 this option is 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_USE_XOSC32_DFLL   (0)
 
#define GEN2_ULP32K   (1)
 
#define CLOCK_DIV   (1U)
 
#define CLOCK_CORECLOCK   (8000000 / CLOCK_DIV)
 

Timer peripheral configuration

#define TIMER_0_MAX_VALUE   0xffffffff
 
#define TIMER_0_ISR   isr_tc1
 
#define TIMER_NUMOF   ARRAY_SIZE(timer_config)
 
static const tc32_conf_t timer_config []
 

UART configuration

#define UART_0_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_NUMOF   ARRAY_SIZE(pwm_config)
 
static const pwm_conf_t pwm_config []
 

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` */
 

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

DAC configuration

#define DAC_CLOCK   SAM0_GCLK_1MHZ
 
#define DAC_VREF   DAC_CTRLB_REFSEL_AVCC
 

Macro Definition Documentation

◆ ADC_GAIN_FACTOR_DEFAULT

#define ADC_GAIN_FACTOR_DEFAULT   ADC_INPUTCTRL_GAIN_1X

Definition at line 234 of file periph_conf.h.

◆ ADC_NEG_INPUT

#define ADC_NEG_INPUT   ADC_INPUTCTRL_MUXNEG_GND

Definition at line 233 of file periph_conf.h.

◆ ADC_NUMOF

#define ADC_NUMOF   ARRAY_SIZE(adc_channels)

Definition at line 247 of file periph_conf.h.

◆ ADC_PRESCALER

#define ADC_PRESCALER   ADC_CTRLB_PRESCALER_DIV512

Definition at line 231 of file periph_conf.h.

◆ ADC_REF_DEFAULT

#define ADC_REF_DEFAULT   ADC_REFCTRL_REFSEL_INT1V

Definition at line 235 of file periph_conf.h.

◆ CLOCK_CORECLOCK

#define CLOCK_CORECLOCK   (8000000 / CLOCK_DIV)

Definition at line 90 of file periph_conf.h.

◆ CLOCK_DIV

#define CLOCK_DIV   (1U)

Definition at line 88 of file periph_conf.h.

◆ CLOCK_USE_PLL

#define CLOCK_USE_PLL   (1)

Definition at line 64 of file periph_conf.h.

◆ CLOCK_USE_XOSC32_DFLL

#define CLOCK_USE_XOSC32_DFLL   (0)

Definition at line 65 of file periph_conf.h.

◆ DAC_CLOCK

#define DAC_CLOCK   SAM0_GCLK_1MHZ

Definition at line 254 of file periph_conf.h.

◆ DAC_VREF

#define DAC_VREF   DAC_CTRLB_REFSEL_AVCC

Definition at line 256 of file periph_conf.h.

◆ GEN2_ULP32K

#define GEN2_ULP32K   (1)

Definition at line 73 of file periph_conf.h.

◆ I2C_NUMOF

#define I2C_NUMOF   ARRAY_SIZE(i2c_config)

Definition at line 213 of file periph_conf.h.

◆ PWM_0_EN

#define PWM_0_EN   1

Definition at line 152 of file periph_conf.h.

◆ PWM_NUMOF

#define PWM_NUMOF   ARRAY_SIZE(pwm_config)

Definition at line 173 of file periph_conf.h.

◆ RTT_FREQUENCY

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

Definition at line 221 of file periph_conf.h.

◆ SPI_NUMOF

#define SPI_NUMOF   ARRAY_SIZE(spi_config)

Definition at line 195 of file periph_conf.h.

◆ TIMER_0_ISR

#define TIMER_0_ISR   isr_tc1

Definition at line 116 of file periph_conf.h.

◆ TIMER_0_MAX_VALUE

#define TIMER_0_MAX_VALUE   0xffffffff

Definition at line 113 of file periph_conf.h.

◆ TIMER_NUMOF

#define TIMER_NUMOF   ARRAY_SIZE(timer_config)

Definition at line 118 of file periph_conf.h.

◆ UART_0_ISR

#define UART_0_ISR   isr_sercom0

Definition at line 143 of file periph_conf.h.

◆ UART_NUMOF

#define UART_NUMOF   ARRAY_SIZE(uart_config)

Definition at line 145 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_PA03 },
{ .inputctrl = ADC_INPUTCTRL_MUXPOS_PA04 },
{ .inputctrl = ADC_INPUTCTRL_MUXPOS_PA05 },
{ .inputctrl = ADC_INPUTCTRL_MUXPOS_PA06 },
{ .inputctrl = ADC_INPUTCTRL_MUXPOS_PA07 },
}
#define ADC_INPUTCTRL_MUXPOS_PA05
Alias for PIN5.
Definition periph_cpu.h:124
#define ADC_INPUTCTRL_MUXPOS_PA07
Alias for PIN7.
Definition periph_cpu.h:126
#define ADC_INPUTCTRL_MUXPOS_PA04
Alias for PIN4.
Definition periph_cpu.h:123
#define ADC_INPUTCTRL_MUXPOS_PA06
Alias for PIN6.
Definition periph_cpu.h:125
#define ADC_INPUTCTRL_MUXPOS_PA02
ADC pin aliases.
Definition periph_cpu.h:119
#define ADC_INPUTCTRL_MUXPOS_PA03
Alias for PIN1.
Definition periph_cpu.h:120

Definition at line 237 of file periph_conf.h.

◆ i2c_config

const i2c_conf_t i2c_config[]
static
Initial value:
= {
{
.dev = &(SERCOM2->I2CM),
.speed = I2C_SPEED_NORMAL,
.scl_pin = GPIO_PIN(PA, 15),
.sda_pin = GPIO_PIN(PA, 14),
.mux = GPIO_MUX_D,
.gclk_src = SAM0_GCLK_MAIN,
.flags = I2C_FLAG_NONE
}
}
#define GPIO_PIN(x, y)
Define a CPU specific GPIO pin generator macro.
Definition periph_cpu.h:46
@ I2C_SPEED_NORMAL
normal mode: ~100 kbit/s
Definition periph_cpu.h:278
@ PA
port A
@ I2C_FLAG_NONE
No flags set.
@ GPIO_MUX_D
select peripheral function D
#define SAM0_GCLK_MAIN
120 MHz main clock
Definition periph_cpu.h:74

Definition at line 202 of file periph_conf.h.

◆ pwm_config

const pwm_conf_t pwm_config[]
static
Initial value:
= {
}

Definition at line 166 of file periph_conf.h.

◆ spi_config

const spi_conf_t spi_config[]
static
Initial value:
= {
{
.dev = &SERCOM1->SPI,
.miso_pin = GPIO_PIN(PA, 24),
.mosi_pin = GPIO_PIN(PA, 22),
.clk_pin = GPIO_PIN(PA, 9),
.miso_mux = GPIO_MUX_C,
.mosi_mux = GPIO_MUX_C,
.clk_mux = GPIO_MUX_C,
.miso_pad = SPI_PAD_MISO_2,
.mosi_pad = SPI_PAD_MOSI_0_SCK_3,
.gclk_src = SAM0_GCLK_MAIN,
},
}
@ SPI_PAD_MISO_2
use pad 2 for MISO line
@ GPIO_MUX_C
select peripheral function C
@ SPI_PAD_MOSI_0_SCK_3
use pad 0 for MOSI, pad 3 for SCK

Definition at line 180 of file periph_conf.h.

◆ timer_config

const tc32_conf_t timer_config[]
static
Initial value:
= {
{
.dev = TC1,
.irq = TC1_IRQn,
.pm_mask = PM_APBCMASK_TC1 | PM_APBCMASK_TC2,
.gclk_ctrl = GCLK_CLKCTRL_ID_TC1_TC2,
.gclk_src = SAM0_GCLK_MAIN,
.flags = TC_CTRLA_MODE_COUNT32,
},
}

Definition at line 98 of file periph_conf.h.

◆ uart_config

const uart_conf_t uart_config[]
static
Initial value:
= {
{
.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,
},
}
@ UART_PAD_RX_3
select pad 3
@ UART_FLAG_NONE
No flags set.
@ UART_PAD_TX_2
select pad 2

Definition at line 125 of file periph_conf.h.