periph_cpu.h
Go to the documentation of this file.
1 /*
2  * SPDX-FileCopyrightText: 2015-2016 Freie Universität Berlin
3  * SPDX-License-Identifier: LGPL-2.1-only
4  */
5 
6 #pragma once
7 
19 #include "periph_cpu_common.h"
20 
21 #ifdef __cplusplus
22 extern "C" {
23 #endif
24 
28 #define CPU_BACKUP_RAM_NOT_RETAINED (1)
29 
34 #define PM_NUM_MODES (3)
35 #define SAML21_PM_MODE_BACKUP (0)
36 #define SAML21_PM_MODE_STANDBY (1)
37 #define SAML21_PM_MODE_IDLE (2)
44 #define SAM0_GPIO_PM_BLOCK SAML21_PM_MODE_BACKUP
45 #define SAM0_RTCRTT_PM_BLOCK SAML21_PM_MODE_BACKUP
46 #define SAM0_SPI_PM_BLOCK SAML21_PM_MODE_STANDBY
47 #define SAM0_TIMER_PM_BLOCK SAML21_PM_MODE_STANDBY
48 #define SAM0_UART_PM_BLOCK SAML21_PM_MODE_STANDBY
49 #define SAM0_USB_IDLE_PM_BLOCK SAML21_PM_MODE_BACKUP
50 #define SAM0_USB_ACTIVE_PM_BLOCK SAML21_PM_MODE_STANDBY
57 #ifndef PM_BLOCKER_INITIAL
58 #define PM_BLOCKER_INITIAL { 0, 0, 0 }
59 #endif
60 
65 enum {
70 };
76 static const gpio_t sam0_adc_pins[1][20] = {
77  {
78  GPIO_PIN(PA, 2), GPIO_PIN(PA, 3), GPIO_PIN(PB, 8), GPIO_PIN(PB, 9),
79  GPIO_PIN(PA, 4), GPIO_PIN(PA, 5), GPIO_PIN(PA, 6), GPIO_PIN(PA, 7),
80  GPIO_PIN(PB, 0), GPIO_PIN(PB, 1), GPIO_PIN(PB, 2), GPIO_PIN(PB, 3),
81  GPIO_PIN(PB, 4), GPIO_PIN(PB, 5), GPIO_PIN(PB, 6), GPIO_PIN(PB, 7),
82  GPIO_PIN(PA, 8), GPIO_PIN(PA, 9), GPIO_PIN(PA, 10), GPIO_PIN(PA, 11),
83  }
84 };
85 
90 #define ADC_INPUTCTRL_MUXPOS_PA02 ADC_INPUTCTRL_MUXPOS_AIN0
91 #define ADC_INPUTCTRL_MUXPOS_PA03 ADC_INPUTCTRL_MUXPOS_AIN1
92 #define ADC_INPUTCTRL_MUXPOS_PB08 ADC_INPUTCTRL_MUXPOS_AIN2
93 #define ADC_INPUTCTRL_MUXPOS_PB09 ADC_INPUTCTRL_MUXPOS_AIN3
94 #define ADC_INPUTCTRL_MUXPOS_PA04 ADC_INPUTCTRL_MUXPOS_AIN4
95 #define ADC_INPUTCTRL_MUXPOS_PA05 ADC_INPUTCTRL_MUXPOS_AIN5
96 #define ADC_INPUTCTRL_MUXPOS_PA06 ADC_INPUTCTRL_MUXPOS_AIN6
97 #define ADC_INPUTCTRL_MUXPOS_PA07 ADC_INPUTCTRL_MUXPOS_AIN7
98 #define ADC_INPUTCTRL_MUXPOS_PB00 ADC_INPUTCTRL_MUXPOS_AIN8
99 #define ADC_INPUTCTRL_MUXPOS_PB01 ADC_INPUTCTRL_MUXPOS_AIN9
100 #define ADC_INPUTCTRL_MUXPOS_PB02 ADC_INPUTCTRL_MUXPOS_AIN10
101 #define ADC_INPUTCTRL_MUXPOS_PB03 ADC_INPUTCTRL_MUXPOS_AIN11
102 #define ADC_INPUTCTRL_MUXPOS_PB04 ADC_INPUTCTRL_MUXPOS_AIN12
103 #define ADC_INPUTCTRL_MUXPOS_PB05 ADC_INPUTCTRL_MUXPOS_AIN13
104 #define ADC_INPUTCTRL_MUXPOS_PB06 ADC_INPUTCTRL_MUXPOS_AIN14
105 #define ADC_INPUTCTRL_MUXPOS_PB07 ADC_INPUTCTRL_MUXPOS_AIN15
106 #define ADC_INPUTCTRL_MUXPOS_PA08 ADC_INPUTCTRL_MUXPOS_AIN16
107 #define ADC_INPUTCTRL_MUXPOS_PA09 ADC_INPUTCTRL_MUXPOS_AIN17
108 #define ADC_INPUTCTRL_MUXPOS_PA10 ADC_INPUTCTRL_MUXPOS_AIN18
109 #define ADC_INPUTCTRL_MUXPOS_PA11 ADC_INPUTCTRL_MUXPOS_AIN19
111 #define ADC_INPUTCTRL_MUXNEG_PA02 ADC_INPUTCTRL_MUXPOS_AIN0
112 #define ADC_INPUTCTRL_MUXNEG_PA03 ADC_INPUTCTRL_MUXPOS_AIN1
113 #define ADC_INPUTCTRL_MUXNEG_PB08 ADC_INPUTCTRL_MUXPOS_AIN2
114 #define ADC_INPUTCTRL_MUXNEG_PB09 ADC_INPUTCTRL_MUXPOS_AIN3
115 #define ADC_INPUTCTRL_MUXNEG_PA04 ADC_INPUTCTRL_MUXPOS_AIN4
116 #define ADC_INPUTCTRL_MUXNEG_PA05 ADC_INPUTCTRL_MUXPOS_AIN5
117 #define ADC_INPUTCTRL_MUXNEG_PA06 ADC_INPUTCTRL_MUXPOS_AIN6
118 #define ADC_INPUTCTRL_MUXNEG_PA07 ADC_INPUTCTRL_MUXPOS_AIN7
124 #define DAC_RES_BITS (12)
125 
129 #define DAC_NUMOF (2)
130 
135 #define RTT_MAX_VALUE (0xffffffff)
136 #define RTT_CLOCK_FREQUENCY (32768U) /* in Hz */
137 #define RTT_MIN_FREQUENCY (RTT_CLOCK_FREQUENCY / 512U) /* in Hz */
138 #define RTT_MAX_FREQUENCY (RTT_CLOCK_FREQUENCY) /* in Hz */
139 /* determined by tests/sys/ztimer_underflow */
140 #define RTT_MIN_OFFSET (8U)
148 struct sam0_aux_cfg_mapping {
149  uint64_t bootloader_size : 3;
150  uint64_t reserved_0 : 1;
151  uint64_t eeprom_size : 3;
152  uint64_t reserved_1 : 1;
153  uint64_t bod33_level : 6;
154  uint64_t bod33_enable : 1;
155  uint64_t bod33_action : 2;
156  uint64_t reserved_2 : 9;
157  uint64_t wdt_enable : 1;
158  uint64_t wdt_always_on : 1;
159  uint64_t wdt_period : 4;
160  uint64_t wdt_window : 4;
161  uint64_t wdt_ewoffset : 4;
162  uint64_t wdt_window_enable : 1;
163  uint64_t bod33_hysteresis : 1;
164  uint64_t reserved_3 : 6;
165  uint64_t nvm_locks : 16;
166 };
169 #ifdef __cplusplus
170 }
171 #endif
172 
#define GPIO_PIN(x, y)
Define a CPU specific GPIO pin generator macro.
Definition: periph_cpu.h:42
@ PB
port B
@ PA
port A
@ SAM0_GCLK_MAIN
48 MHz main clock
Definition: periph_cpu.h:71
@ SAM0_GCLK_32KHZ
32 kHz clock
Definition: periph_cpu.h:73
@ SAM0_GCLK_TIMER
4/8MHz clock for timers
Definition: periph_cpu.h:67
@ SAM0_GCLK_48MHZ
48MHz clock
Definition: periph_cpu.h:69
static const gpio_t sam0_adc_pins[1][20]
Pins that can be used for ADC input.
Definition: periph_cpu.h:76
NVM User Row Mapping - Dedicated Entries Config values will be applied at power-on.
Definition: periph_cpu.h:173
uint64_t bod33_level
BOD33 threshold level at power-on.
Definition: periph_cpu.h:178
uint64_t wdt_window
WDT Window at power-on.
Definition: periph_cpu.h:185
uint64_t wdt_window_enable
WDT Window mode enabled on power-on
Definition: periph_cpu.h:187
uint64_t nvm_locks
NVM Region Lock Bits.
Definition: periph_cpu.h:191
uint64_t bod33_hysteresis
BOD33 Hysteresis configuration
Definition: periph_cpu.h:188
uint64_t bod33_action
BOD33 Action at power-on.
Definition: periph_cpu.h:180
uint64_t bod33_enable
BOD33 Enable at power-on.
Definition: periph_cpu.h:179
uint64_t wdt_period
WDT Period at power-on.
Definition: periph_cpu.h:184
uint64_t reserved_2
Factory settings - do not change.
Definition: periph_cpu.h:181
uint64_t bootloader_size
BOOTPROT: Bootloader Size
Definition: periph_cpu.h:174
uint64_t wdt_ewoffset
WDT Early Warning Interrupt Offset
Definition: periph_cpu.h:186
uint64_t eeprom_size
one of eight different EEPROM sizes
Definition: periph_cpu.h:176
uint64_t reserved_0
Factory settings - do not change.
Definition: periph_cpu.h:175
uint64_t reserved_1
Factory settings - do not change.
Definition: periph_cpu.h:177
uint64_t wdt_always_on
WDT Always-On at power-on.
Definition: periph_cpu.h:183
uint64_t reserved_3
Factory settings - do not change.
Definition: periph_cpu.h:190
uint64_t wdt_enable
WDT Enable at power-on.
Definition: periph_cpu.h:182