Loading...
Searching...
No Matches
periph_conf.h File Reference
Boards » Arduino Nano 33 IoT

Configuration of CPU peripherals for Arduino Nano 33 IoT. More...

Detailed Description

Configuration of CPU peripherals for Arduino Nano 33 IoT.

Author
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 "periph_cpu.h"
+ Include dependency graph for periph_conf.h:

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

I2C configuration

#define I2C_NUMOF   ARRAY_SIZE(i2c_config)
 
static const i2c_conf_t i2c_config []
 

SPI configuration

#define SPI_NUMOF   ARRAY_SIZE(spi_config)
 
static const spi_conf_t spi_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

◆ ADC_GAIN_FACTOR_DEFAULT

#define ADC_GAIN_FACTOR_DEFAULT   ADC_INPUTCTRL_GAIN_1X

Definition at line 190 of file periph_conf.h.

◆ ADC_NEG_INPUT

#define ADC_NEG_INPUT   ADC_INPUTCTRL_MUXNEG_GND

Definition at line 189 of file periph_conf.h.

◆ ADC_NUMOF

#define ADC_NUMOF   ARRAY_SIZE(adc_channels)

Definition at line 205 of file periph_conf.h.

◆ ADC_PRESCALER

#define ADC_PRESCALER   ADC_CTRLB_PRESCALER_DIV512

Definition at line 187 of file periph_conf.h.

◆ ADC_REF_DEFAULT

#define ADC_REF_DEFAULT   ADC_REFCTRL_REFSEL_INT1V

Definition at line 191 of file periph_conf.h.

◆ CLOCK_CORECLOCK

#define CLOCK_CORECLOCK   (8000000 / CLOCK_DIV)

Definition at line 71 of file periph_conf.h.

◆ CLOCK_DIV

#define CLOCK_DIV   (1U)

Definition at line 69 of file periph_conf.h.

◆ CLOCK_USE_PLL

#define CLOCK_USE_PLL   (1)

Definition at line 59 of file periph_conf.h.

◆ I2C_NUMOF

#define I2C_NUMOF   ARRAY_SIZE(i2c_config)

Definition at line 223 of file periph_conf.h.

◆ PWM_0_EN

#define PWM_0_EN   1

Definition at line 146 of file periph_conf.h.

◆ PWM_1_EN

#define PWM_1_EN   1

Definition at line 147 of file periph_conf.h.

◆ PWM_NUMOF

#define PWM_NUMOF   ARRAY_SIZE(pwm_config)

Definition at line 178 of file periph_conf.h.

◆ RTT_FREQUENCY

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

Definition at line 265 of file periph_conf.h.

◆ SPI_NUMOF

#define SPI_NUMOF   ARRAY_SIZE(spi_config)

Definition at line 257 of file periph_conf.h.

◆ TIMER_0_ISR

#define TIMER_0_ISR   isr_tc3

Definition at line 109 of file periph_conf.h.

◆ TIMER_0_MAX_VALUE

#define TIMER_0_MAX_VALUE   0xffff

Definition at line 106 of file periph_conf.h.

◆ TIMER_1_ISR

#define TIMER_1_ISR   isr_tc4

Definition at line 110 of file periph_conf.h.

◆ TIMER_NUMOF

#define TIMER_NUMOF   ARRAY_SIZE(timer_config)

Definition at line 112 of file periph_conf.h.

◆ UART_0_ISR

#define UART_0_ISR   isr_sercom5

Definition at line 137 of file periph_conf.h.

◆ UART_NUMOF

#define UART_NUMOF   ARRAY_SIZE(uart_config)

Definition at line 139 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_PB02 },
{ .inputctrl = ADC_INPUTCTRL_MUXPOS_PA11 },
{ .inputctrl = ADC_INPUTCTRL_MUXPOS_PA10 },
{ .inputctrl = ADC_INPUTCTRL_MUXPOS_PB08 },
{ .inputctrl = ADC_INPUTCTRL_MUXPOS_PB09 },
{ .inputctrl = ADC_INPUTCTRL_MUXPOS_PA09 },
{ .inputctrl = ADC_INPUTCTRL_MUXPOS_PB03 },
}
ADC_INPUTCTRL_MUXPOS_PB08
#define ADC_INPUTCTRL_MUXPOS_PB08
Alias for PIN2.
Definition periph_cpu.h:121
ADC_INPUTCTRL_MUXPOS_PB02
#define ADC_INPUTCTRL_MUXPOS_PB02
Alias for PIN10.
Definition periph_cpu.h:129
ADC_INPUTCTRL_MUXPOS_PA10
#define ADC_INPUTCTRL_MUXPOS_PA10
Alias for PIN18.
Definition periph_cpu.h:137
ADC_INPUTCTRL_MUXPOS_PA11
#define ADC_INPUTCTRL_MUXPOS_PA11
Alias for PIN19.
Definition periph_cpu.h:138
ADC_INPUTCTRL_MUXPOS_PB09
#define ADC_INPUTCTRL_MUXPOS_PB09
Alias for PIN3.
Definition periph_cpu.h:122
ADC_INPUTCTRL_MUXPOS_PA09
#define ADC_INPUTCTRL_MUXPOS_PA09
Alias for PIN17.
Definition periph_cpu.h:136
ADC_INPUTCTRL_MUXPOS_PB03
#define ADC_INPUTCTRL_MUXPOS_PB03
Alias for PIN11.
Definition periph_cpu.h:130
ADC_INPUTCTRL_MUXPOS_PA02
#define ADC_INPUTCTRL_MUXPOS_PA02
ADC pin aliases.
Definition periph_cpu.h:119

Definition at line 193 of file periph_conf.h.

◆ i2c_config

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

Definition at line 212 of file periph_conf.h.

◆ pwm_config

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

Definition at line 167 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,
}
}
PA
@ PA
port A
Definition periph_cpu_common.h:99
GPIO_MUX_G
@ GPIO_MUX_G
select peripheral function G
Definition periph_cpu_common.h:250

Definition at line 273 of file periph_conf.h.

◆ spi_config

const spi_conf_t spi_config[]
static
Initial value:
= {
{
.dev = &SERCOM2->SPI,
.miso_pin = GPIO_PIN(PA, 13),
.mosi_pin = GPIO_PIN(PA, 12),
.clk_pin = GPIO_PIN(PA, 15),
.miso_mux = GPIO_MUX_C,
.mosi_mux = GPIO_MUX_C,
.clk_mux = GPIO_MUX_C,
.miso_pad = SPI_PAD_MISO_1,
.mosi_pad = SPI_PAD_MOSI_0_SCK_3,
.gclk_src = SAM0_GCLK_MAIN,
},
{
.dev = &SERCOM3->SPI,
.miso_pin = GPIO_PIN(PA, 19),
.mosi_pin = GPIO_PIN(PA, 16),
.clk_pin = GPIO_PIN(PA, 17),
.miso_mux = GPIO_MUX_D,
.mosi_mux = GPIO_MUX_D,
.clk_mux = GPIO_MUX_D,
.miso_pad = SPI_PAD_MISO_3,
.mosi_pad = SPI_PAD_MOSI_0_SCK_1,
.gclk_src = SAM0_GCLK_MAIN,
},
}
SPI_PAD_MISO_1
@ SPI_PAD_MISO_1
use pad 1 for MISO line
Definition periph_cpu_common.h:441
SPI_PAD_MISO_3
@ SPI_PAD_MISO_3
use pad 3 for MISO line
Definition periph_cpu_common.h:443
GPIO_MUX_C
@ GPIO_MUX_C
select peripheral function C
Definition periph_cpu_common.h:246
SPI_PAD_MOSI_0_SCK_3
@ SPI_PAD_MOSI_0_SCK_3
use pad 0 for MOSI, pad 3 for SCK
Definition periph_cpu_common.h:453
SPI_PAD_MOSI_0_SCK_1
@ SPI_PAD_MOSI_0_SCK_1
use pad 0 for MOSI, pad 1 for SCK
Definition periph_cpu_common.h:450

Definition at line 230 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 79 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,
}
}
UART_PAD_RX_3
@ UART_PAD_RX_3
select pad 3
Definition periph_cpu_common.h:269
UART_FLAG_NONE
@ UART_FLAG_NONE
No flags set.
Definition periph_cpu_common.h:286
UART_PAD_TX_2
@ UART_PAD_TX_2
select pad 2
Definition periph_cpu_common.h:277

Definition at line 119 of file periph_conf.h.