1
0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2024-12-29 04:50:03 +01:00

boards/samd10-xmini: add SAM D10 Xplained Mini

This commit is contained in:
Benjamin Valentin 2020-10-02 20:41:55 +02:00
parent b6642a8cb7
commit b66b59a411
11 changed files with 558 additions and 0 deletions

View File

@ -0,0 +1,22 @@
# Copyright (c) ML!PA Consulting GmbH
#
# This file is subject to the terms and conditions of the GNU Lesser
# General Public License v2.1. See the file LICENSE in the top level
# directory for more details.
config BOARD
default "samd10-xmini" if BOARD_SAMD10_XMINI
config BOARD_SAMD10_XMINI
bool
default y
select CPU_MODEL_SAMD10D14AU
select HAS_PERIPH_ADC
select HAS_PERIPH_DAC
select HAS_PERIPH_I2C
select HAS_PERIPH_PWM
select HAS_PERIPH_RTC
select HAS_PERIPH_RTT
select HAS_PERIPH_SPI
select HAS_PERIPH_TIMER
select HAS_PERIPH_UART

View File

@ -0,0 +1,3 @@
MODULE = board
include $(RIOTBASE)/Makefile.base

View File

@ -0,0 +1,7 @@
ifneq (,$(filter saul_default,$(USEMODULE)))
USEMODULE += saul_gpio
endif
# Use Picolibc to reduce ROM usage
FEATURES_REQUIRED += picolibc
USEMODULE += picolibc

View File

@ -0,0 +1,13 @@
CPU = samd21
CPU_MODEL = samd10d14au
# Put defined MCU peripherals here (in alphabetical order)
FEATURES_PROVIDED += periph_adc
FEATURES_PROVIDED += periph_dac
FEATURES_PROVIDED += periph_i2c
FEATURES_PROVIDED += periph_pwm
FEATURES_PROVIDED += periph_rtc
FEATURES_PROVIDED += periph_rtt
FEATURES_PROVIDED += periph_spi
FEATURES_PROVIDED += periph_timer
FEATURES_PROVIDED += periph_uart

View File

@ -0,0 +1,4 @@
# mEDBG does not support faster baudrates
BAUD ?= 57600
include $(RIOTMAKE)/boards/sam0.inc.mk

View File

@ -0,0 +1,41 @@
/*
* Copyright (C) 2020 ML!PA Consulting GmbH
*
* This file is subject to the terms and conditions of the GNU Lesser
* General Public License v2.1. See the file LICENSE in the top level
* directory for more details.
*/
/**
* @ingroup boards_samd10-xmini
* @{
*
* @file
* @brief Board specific implementations for the Atmel SAM D10 Xplained
* Mini board
*
* @author Benjamin Valentin <benjamin.valentin@ml-pa.com>
* @}
*/
#include "board.h"
#include "periph/gpio.h"
void board_init(void)
{
/* initialize the on-board LED */
gpio_init(LED0_PIN, GPIO_OUT);
/* initialize the on-board button */
gpio_init(BTN0_PIN, BTN0_MODE);
/* If the PA24 and PA25 pins are not connected, it is recommended
* to enable a pull-up on PA24 and PA25 through input GPIO mode.
* (those have external pull-ups on the board that would leak current)
*/
gpio_init(GPIO_PIN(PA, 24), GPIO_IN_PU);
gpio_init(GPIO_PIN(PA, 25), GPIO_IN_PU);
/* initialize the CPU */
cpu_init();
}

2
boards/samd10-xmini/dist/openocd.cfg vendored Normal file
View File

@ -0,0 +1,2 @@
source [find target/at91samdXX.cfg]
$_TARGETNAME configure -rtos auto

View File

@ -0,0 +1,76 @@
/**
@defgroup boards_samd10-xmini Atmel SAM D10 Xplained Mini
@ingroup boards
@brief Support for the Atmel SAM D10 Xplained Mini board.
## Overview
The `SAMD10 Xplained Mini` is an ultra-low cost evaluation board by Atmel
featuring an SoC. The SoC includes a SAMD10 ARM Cortex-M0+ micro-
controller. For programming the MCU comes with 4Kb of RAM and 16Kb of flash
memory.
The samd10-xmini is available from various hardware vendors for ~8€ (as of
2020 October).
## Hardware
![samd10-xmini image](https://www.microchip.com/_ImagedCopy/ATSAMD10-XMINI.jpg)
### MCU
| MCU | ATSAMD10D14AU |
|:-----------|:--------------------- |
| Family | ARM Cortex-M0+ |
| Vendor | Atmel |
| RAM | 4 kiB |
| Flash | 16 kiB |
| Frequency | up to 48 MHz |
| FPU | no |
| Timers | 3 (2 x 16-bit, 1 x 24-bit) |
| ADCs | 1x 10-bit (10 channels) |
| DACs | 1x 10-bit (1 channel) |
| UARTs | max 3 (shared with SPI and I2C) |
| SPIs | max 3 (see UART) |
| I2Cs | max 3 (see UART) |
| Vcc | 1.62V - 3.63V |
| Datasheet | [Datasheet](http://ww1.microchip.com/downloads/en/DeviceDoc/Atmel-42242-SAM-D10_Datasheet.pdf) |
| Board Manual | [Board Manual](http://ww1.microchip.com/downloads/en/DeviceDoc/Atmel-42387-ATSAMD10-Xplain-Mini_User-Guide.pdf) |
### User Interface
1 User button and 1 LED:
| Device | PIN |
|:------ |:---- |
| LED0 | PA09 |
| SW0 | PA25 |
## Flashing the device
Connect the device to your Micro-USB cable using the port labeled as *DEBUG
USB*.
The standard method for flashing RIOT to the samd10-xmini is using EDBG.
On Linux you will have to add a **udev** rule for hidraw, like
```
echo 'KERNEL=="hidraw*", SUBSYSTEM=="hidraw", MODE="0664", GROUP="plugdev"' \
| sudo tee -a /etc/udev/rules.d/99-usb.rules
sudo service udev restart
```
Then you can flash the device as usual
```
make BOARD=samd10-xmini flash
```
## Known Issues / Problems
### I2C
The I2C pins on the board do not have any pull-ups connected to them.
That means that running e.g. `i2c_scan` without any I2C slaves connected
will run into timeouts.
*/

View File

@ -0,0 +1,74 @@
/*
* Copyright (C) 2020 ML!PA Consulting GmbH
*
* This file is subject to the terms and conditions of the GNU Lesser
* General Public License v2.1. See the file LICENSE in the top level
* directory for more details.
*/
/**
* @ingroup boards_samd10-xmini
* @{
*
* @file
* @brief Board specific definitions for the Atmel SAM D10 Xplained
* Mini board
*
* @author Benjamin Valentin <benjamin.valentin@ml-pa.com>
*/
#ifndef BOARD_H
#define BOARD_H
#include "cpu.h"
#include "periph_conf.h"
#include "periph_cpu.h"
#ifdef __cplusplus
extern "C" {
#endif
/**
* @name Default Baudrate for stdio
* mEDBG does not support 115200 baud.
* @{
*/
#ifndef STDIO_UART_BAUDRATE
#define STDIO_UART_BAUDRATE (57600)
#endif
/** @} */
/**
* @name LED pin definitions and handlers
* @{
*/
#define LED0_PIN GPIO_PIN(PA, 9)
#define LED_PORT PORT->Group[PA]
#define LED0_MASK (1 << 9)
#define LED0_ON (LED_PORT.OUTSET.reg = LED0_MASK)
#define LED0_OFF (LED_PORT.OUTCLR.reg = LED0_MASK)
#define LED0_TOGGLE (LED_PORT.OUTTGL.reg = LED0_MASK)
/** @} */
/**
* @name SW0 (Button) pin definitions
* @{
*/
#define BTN0_PORT PORT->Group[PA]
#define BTN0_PIN GPIO_PIN(PA, 25)
#define BTN0_MODE GPIO_IN_PU
/** @} */
/**
* @brief Initialize board specific hardware, including clock, LEDs and std-IO
*/
void board_init(void);
#ifdef __cplusplus
}
#endif
#endif /* BOARD_H */
/** @} */

View File

@ -0,0 +1,52 @@
/*
* Copyright (C) 2020 ML!PA Consulting GmbH
*
* This file is subject to the terms and conditions of the GNU Lesser
* General Public License v2.1. See the file LICENSE in the top level
* directory for more details.
*/
/**
* @ingroup boards_samd10-xmini
* @{
*
* @file
* @brief Board specific configuration of direct mapped GPIOs
*
* @author Benjamin Valentin <benjamin.valentin@ml-pa.com>
*/
#ifndef GPIO_PARAMS_H
#define GPIO_PARAMS_H
#include "board.h"
#include "saul/periph.h"
#ifdef __cplusplus
extern "C" {
#endif
/**
* @brief GPIO pin configuration
*/
static const saul_gpio_params_t saul_gpio_params[] =
{
{
.name = "LED(orange)",
.pin = LED0_PIN,
.mode = GPIO_OUT
},
{
.name = "Button(SW0)",
.pin = BTN0_PIN,
.mode = BTN0_MODE,
.flags= SAUL_GPIO_INVERTED,
},
};
#ifdef __cplusplus
}
#endif
#endif /* GPIO_PARAMS_H */
/** @} */

View File

@ -0,0 +1,264 @@
/*
* Copyright (C) 2020 ML!PA Consulting GmbH
*
* This file is subject to the terms and conditions of the GNU Lesser
* General Public License v2.1. See the file LICENSE in the top level
* directory for more details.
*/
/**
* @ingroup boards_samd10-xmini
* @{
*
* @file
* @brief Configuration of CPU peripherals for the Atmel SAM D10 Xplained
* Mini board
*
* @author Benjamin Valentin <benjamin.valentin@ml-pa.com>
*/
#ifndef PERIPH_CONF_H
#define PERIPH_CONF_H
#include <stdint.h>
#include "cpu.h"
#include "periph_cpu.h"
#ifdef __cplusplus
extern "C" {
#endif
/**
* @name 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)
/*
* 0: use XOSC32K (always 32.768kHz) to clock GCLK2
* 1: use OSCULP32K factory calibrated (~32.768kHz) to clock GCLK2
*
* OSCULP32K is factory calibrated to be around 32.768kHz but this values can
* be of by a couple off % points, so prefer XOSC32K as default configuration.
*/
#define GEN2_ULP32K (1)
#if CLOCK_USE_PLL
/* edit these values to adjust the PLL output frequency */
#define CLOCK_PLL_MUL (47U) /* must be >= 31 & <= 95 */
#define CLOCK_PLL_DIV (1U) /* adjust to your needs */
/* generate the actual used core clock frequency */
#define CLOCK_CORECLOCK (((CLOCK_PLL_MUL + 1) * 1000000U) / CLOCK_PLL_DIV)
#elif CLOCK_USE_XOSC32_DFLL
/* Settings for 32 kHz external oscillator and 48 MHz DFLL */
#define CLOCK_CORECLOCK (48000000U)
#define CLOCK_XOSC32K (32768UL)
#define CLOCK_8MHZ (1)
#else
/* edit this value to your needs */
#define CLOCK_DIV (1U)
/* generate the actual core clock frequency */
#define CLOCK_CORECLOCK (8000000 / CLOCK_DIV)
#endif
/** @} */
/**
* @name Timer peripheral configuration
* @{
*/
static const tc32_conf_t timer_config[] = {
{ /* Timer 0 - System Clock */
.dev = TC1,
.irq = TC1_IRQn,
.pm_mask = PM_APBCMASK_TC1 | PM_APBCMASK_TC2,
.gclk_ctrl = GCLK_CLKCTRL_ID_TC1_TC2,
#if CLOCK_USE_PLL || CLOCK_USE_XOSC32_DFLL
.gclk_src = SAM0_GCLK_1MHZ,
#else
.gclk_src = SAM0_GCLK_MAIN,
#endif
.flags = TC_CTRLA_MODE_COUNT32,
},
};
#define TIMER_0_MAX_VALUE 0xffffffff
/* interrupt function name mapping */
#define TIMER_0_ISR isr_tc1
#define TIMER_NUMOF ARRAY_SIZE(timer_config)
/** @} */
/**
* @name UART configuration
* @{
*/
static const uart_conf_t uart_config[] = {
{ /* Virtual COM Port */
.dev = &SERCOM0->USART,
.rx_pin = GPIO_PIN(PA, 11),
.tx_pin = GPIO_PIN(PA, 10),
#ifdef MODULE_PERIPH_UART_HW_FC
.rts_pin = GPIO_UNDEF,
.cts_pin = GPIO_UNDEF,
#endif
.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,
},
};
/* interrupt function name mapping */
#define UART_0_ISR isr_sercom0
#define UART_NUMOF ARRAY_SIZE(uart_config)
/** @} */
/**
* @name PWM configuration
* @{
*/
#define PWM_0_EN 1
#if PWM_0_EN
/* PWM0 channels */
static const pwm_conf_chan_t pwm_chan0_config[] = {
/* GPIO pin, MUX value, TCC channel */
{ GPIO_PIN(PA, 17), GPIO_MUX_F, 7 },
{ GPIO_PIN(PA, 22), GPIO_MUX_F, 4 },
{ GPIO_PIN(PA, 23), GPIO_MUX_F, 5 },
{ GPIO_PIN(PA, 24), GPIO_MUX_E, 2 },
};
#endif
/* PWM device configuration */
static const pwm_conf_t pwm_config[] = {
#if PWM_0_EN
{TCC_CONFIG(TCC0), pwm_chan0_config, ARRAY_SIZE(pwm_chan0_config), SAM0_GCLK_MAIN},
#endif
};
/* number of devices that are actually defined */
#define PWM_NUMOF ARRAY_SIZE(pwm_config)
/** @} */
/**
* @name SPI configuration
* @{
*/
static const spi_conf_t spi_config[] = {
{ /* SPI header */
.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,
},
};
#define SPI_NUMOF ARRAY_SIZE(spi_config)
/** @} */
/**
* @name I2C configuration
* @{
*/
static const i2c_conf_t i2c_config[] = {
{
.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 I2C_NUMOF ARRAY_SIZE(i2c_config)
/** @} */
/**
* @name RTT configuration
* @{
*/
#ifndef RTT_FREQUENCY
#define RTT_FREQUENCY (32768U) /* in Hz. For changes see `rtt.c` */
#endif
/** @} */
/**
* @name ADC Configuration
* @{
*/
/* ADC Default values */
#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
static const adc_conf_chan_t adc_channels[] = {
/* port, pin, muxpos */
{GPIO_PIN(PA, 2), ADC_INPUTCTRL_MUXPOS_PIN0},
{GPIO_PIN(PA, 3), ADC_INPUTCTRL_MUXPOS_PIN1},
{GPIO_PIN(PA, 4), ADC_INPUTCTRL_MUXPOS_PIN2},
{GPIO_PIN(PA, 5), ADC_INPUTCTRL_MUXPOS_PIN3},
{GPIO_PIN(PA, 6), ADC_INPUTCTRL_MUXPOS_PIN4},
{GPIO_PIN(PA, 7), ADC_INPUTCTRL_MUXPOS_PIN5},
};
#define ADC_NUMOF ARRAY_SIZE(adc_channels)
/** @} */
/**
* @name DAC configuration
* @{
*/
#define DAC_CLOCK SAM0_GCLK_1MHZ
/* use Vcc as reference voltage */
#define DAC_VREF DAC_CTRLB_REFSEL_AVCC
/** @} */
#ifdef __cplusplus
}
#endif
#endif /* PERIPH_CONF_H */
/** @} */