Merge pull request #16287 from nandojve/avr8_xmega-a3bu_xpld

boards: Introduce atxmega-a3bu-xplained board
RIOT-OS · Apr 8, 2021 · 6ce9db6 · 6ce9db6
2 parents 93ba8be + 6149531
commit 6ce9db6
Show file tree

Hide file tree

Showing 38 changed files with 424 additions and 0 deletions.
diff --git a/boards/atxmega-a3bu-xplained/Kconfig b/boards/atxmega-a3bu-xplained/Kconfig
@@ -0,0 +1,24 @@
+# Copyright (c) 2020 HAW Hamburg
+# Copyright (c) 2021 Gerson Fernando Budle
+#
+# 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 "atxmega-a3bu-xplained" if BOARD_ATXMEGA_A3BU_XPLAINED
+
+config BOARD_ATXMEGA_A3BU_XPLAINED
+    bool
+    default y
+    select CPU_MODEL_XMEGA256A3BU
+    select HAS_PERIPH_CPUID
+    select HAS_PERIPH_GPIO
+    select HAS_PERIPH_GPIO_IRQ
+    select HAS_PERIPH_NVM
+    select HAS_PERIPH_PM
+    select HAS_PERIPH_TIMER
+    select HAS_PERIPH_TIMER_PERIODIC
+    select HAS_PERIPH_UART
+
+    select HAVE_SAUL_GPIO
diff --git a/boards/atxmega-a3bu-xplained/Makefile b/boards/atxmega-a3bu-xplained/Makefile
@@ -0,0 +1,5 @@
+MODULE = board
+
+DIRS = $(RIOTBOARD)/common/atxmega
+
+include $(RIOTBASE)/Makefile.base
diff --git a/boards/atxmega-a3bu-xplained/Makefile.dep b/boards/atxmega-a3bu-xplained/Makefile.dep
@@ -0,0 +1,5 @@
+USEMODULE += boards_common_atxmega
+
+ifneq (,$(filter saul_default,$(USEMODULE)))
+  USEMODULE += saul_gpio
+endif
diff --git a/boards/atxmega-a3bu-xplained/Makefile.features b/boards/atxmega-a3bu-xplained/Makefile.features
@@ -0,0 +1,3 @@
+CPU_MODEL = atxmega256a3bu
+
+include $(RIOTBOARD)/common/atxmega/Makefile.features
diff --git a/boards/atxmega-a3bu-xplained/Makefile.include b/boards/atxmega-a3bu-xplained/Makefile.include
@@ -0,0 +1 @@
+include $(RIOTBOARD)/common/atxmega/Makefile.include
diff --git a/boards/atxmega-a3bu-xplained/doc.txt b/boards/atxmega-a3bu-xplained/doc.txt
@@ -0,0 +1,49 @@
+/**
+@defgroup    boards_atxmega-a3bu-xplained ATxmega-A3BU Xplained board
+@ingroup     boards
+@brief       Support for the ATxmega-A3BU Xplained board
+
+The ATxmega-A3BU Xplained is a reference to develop with XMEGA's.
+
+### MCU
+| MCU           | ATxmega256A3BU                                |
+|:------------- |:--------------------------------------------- |
+| Family        | AVR/ATxmega                                   |
+| Vendor        | Microchip (previously Atmel)                  |
+| Flash         | 256KiB                                        |
+| RAM           | 16KiB                                         |
+| EEPROM        | 4KiB                                          |
+| Frequency     | up to 32MHz                                   |
+| Timers        | 7 16bit (32 bit combining 2 x 16 bit)         |
+| ACs           | 4 Analog Comparators                          |
+| ADCs          | 2 - 16 channels - 12 bit - 2msps              |
+| ADCs          | 1 - 2 channels - 12 bit - 1msps               |
+| UARTs         | 6 (can be used in SPI mode) with 1 IrDA       |
+| SPIs          | 2                                             |
+| I2Cs          | 2 (called TWI)                                |
+| USB           | 1 port                                        |
+| DMA           | 4 Channels                                    |
+| Event System  | 8 Channels                                    |
+| Ext. INT      | All GPIOs                                     |
+| Crypto        | AES/DES, CRC-16, CRC-32                       |
+| Vcc           | 1.6V - 3.6V                                   |
+| Datasheet     | [Datasheet](https://ww1.microchip.com/downloads/en/DeviceDoc/Atmel-8362-8-and-16bit-AVR-microcontroller-ATxmega256A3BU_datasheet.pdf) |
+| Xmega Manual  | [Manual](https://ww1.microchip.com/downloads/en/DeviceDoc/Atmel-8331-8-and-16-bit-AVR-Microcontroller-XMEGA-AU_Manual.pdf) |
+| Guide         | [AVR1923 PDF](http://ww1.microchip.com/downloads/en/Appnotes/doc8394.pdf) |
+| Schematic     | [AVR1923 ZIP](https://ww1.microchip.com/downloads/en/AppNotes/AVR1923.zip) |
+
+## Flashing the Device
+
+The ATxmega-A3BU Xplained needs an external programmer like atmelice.
+
+In order to flash the ATxmega256A3BU, simple run:
+
+    make BOARD=atxmega-a3bu-xplained flash
+
+## Serial Terminal
+
+This board needs a serial converter. The default STDIO is at J1 pins 2/3.
+
+    make BOARD=atxmega-a3bu-xplained term
+
+ */
diff --git a/boards/atxmega-a3bu-xplained/include/board.h b/boards/atxmega-a3bu-xplained/include/board.h
@@ -0,0 +1,118 @@
+/*
+ * Copyright (C) 2021 Gerson Fernando Budke
+ *
+ * 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_atxmega-a3bu-xplained
+ * @{
+ *
+ * @file
+ * @brief       Board specific definitions for the ATxmegaA3BU Xplained board.
+ *
+ * @author      Gerson Fernando Budke <nandojve@gmail.com>
+ */
+
+#ifndef BOARD_H
+#define BOARD_H
+
+#include "cpu.h"
+#include "macros/units.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @brief   Clock configuration
+ */
+#define CLOCK_CORECLOCK     MHZ(32)
+
+/**
+ * @name   Baudrate for STDIO terminal
+ *
+ * The standard configuration for STDIO in cpu/atxmega/periph/uart.c
+ * is to use double speed.
+ *
+ * For 32MHz F_CPU following Baudrate have good error rates
+ *  115200
+ *
+ * Matches this with BAUD in Board/Makefile.include
+ *
+ * @{
+ */
+#ifndef STDIO_UART_BAUDRATE
+#define STDIO_UART_BAUDRATE (115200U)
+#endif
+/** @} */
+
+/**
+ * @name   LED pin definitions and handlers
+ * @{
+ */
+#define LED_PORT            PORTR
+
+#define LED0_PIN            GPIO_PIN(PORT_R, 0)
+#define LED0_MODE           GPIO_OUT
+#define LED0_MASK           (PIN0_bm)
+#define LED0_ON             (LED_PORT.OUTCLR = LED0_MASK)
+#define LED0_OFF            (LED_PORT.OUTSET = LED0_MASK)
+#define LED0_TOGGLE         (LED_PORT.OUTTGL = LED0_MASK)
+
+#define LED1_PIN            GPIO_PIN(PORT_R, 1)
+#define LED1_MODE           GPIO_OUT
+#define LED1_MASK           (PIN1_bm)
+#define LED1_ON             (LED_PORT.OUTCLR = LED1_MASK)
+#define LED1_OFF            (LED_PORT.OUTSET = LED1_MASK)
+#define LED1_TOGGLE         (LED_PORT.OUTTGL = LED1_MASK)
+
+#define LED_PORT_MASK       (LED0_MASK | LED1_MASK)
+/** @} */
+
+/**
+ * @name    Button pin configuration
+ * @{
+ */
+#define BTN0_PIN            GPIO_PIN(PORT_E, 5)
+#define BTN0_MODE           (GPIO_IN | GPIO_OPC_PU | GPIO_SLEW_RATE)
+#define BTN0_INT_FLANK      (GPIO_ISC_FALLING | GPIO_LVL_LOW)
+
+#define BTN1_PIN            GPIO_PIN(PORT_F, 1)
+#define BTN1_MODE           (GPIO_IN | GPIO_OPC_PU | GPIO_SLEW_RATE)
+#define BTN1_INT_FLANK      (GPIO_ISC_FALLING | GPIO_LVL_LOW)
+
+#define BTN2_PIN            GPIO_PIN(PORT_F, 2)
+#define BTN2_MODE           (GPIO_IN | GPIO_OPC_PU | GPIO_SLEW_RATE)
+#define BTN2_INT_FLANK      (GPIO_ISC_FALLING | GPIO_LVL_LOW)
+/** @} */
+
+/**
+ * @name xtimer configuration values
+ * if XTIMER_HZ > 1MHz then (XTIMER_HZ != (1000000ul << XTIMER_SHIFT))
+ * if XTIMER_HZ < 1MHz then ((XTIMER_HZ << XTIMER_SHIFT) != 1000000ul)
+ *
+ * 32MHz Core Clock
+ * XTIMER_HZ 4000000 (clkdiv 8 )    XTIMER_SHIFT 2
+ * XTIMER_HZ 1000000 ()             XTIMER_SHIFT 0
+ * XTIMER_HZ  500000 (clkdiv 64)    XTIMER_SHIFT 1
+ * XTIMER_HZ  250000 (clkdiv 128)   XTIMER_SHIFT 2
+ * XTIMER_HZ   31250 (clkdiv 1024)  XTIMER_SHIFT 5
+ *
+ * @{
+ */
+#define XTIMER_DEV          TIMER_DEV(0)
+#define XTIMER_CHAN         (0)
+#define XTIMER_WIDTH        (16)
+#define XTIMER_HZ           KHZ(500)
+#define XTIMER_BACKOFF      (150)
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* BOARD_H */
+/** @} */
diff --git a/boards/atxmega-a3bu-xplained/include/gpio_params.h b/boards/atxmega-a3bu-xplained/include/gpio_params.h
@@ -0,0 +1,71 @@
+/*
+ * Copyright (C) 2021 Gerson Fernando Budke
+ *
+ * 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_atxmega-a3bu-xplained
+ * @{
+ *
+ * @file
+ * @brief       Configuration of SAUL mapped GPIO pins
+ *
+ * @author      Gerson Fernando Budke <nandojve@gmail.com>
+ */
+
+#ifndef GPIO_PARAMS_H
+#define GPIO_PARAMS_H
+
+#include "board.h"
+#include "saul/periph.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @brief   GPIO configuration
+ */
+static const saul_gpio_params_t saul_gpio_params[] =
+{
+    {
+        .name = "SW0",
+        .pin = BTN0_PIN,
+        .mode = BTN0_MODE,
+        .flags = SAUL_GPIO_INVERTED,
+    },
+    {
+        .name = "SW1",
+        .pin = BTN1_PIN,
+        .mode = BTN1_MODE,
+        .flags = SAUL_GPIO_INVERTED,
+    },
+    {
+        .name = "SW2",
+        .pin = BTN2_PIN,
+        .mode = BTN2_MODE,
+        .flags = SAUL_GPIO_INVERTED,
+    },
+    {
+        .name = "LED0",
+        .pin = LED0_PIN,
+        .mode = LED0_MODE,
+        .flags = SAUL_GPIO_INVERTED,
+    },
+    {
+        .name = "LED1",
+        .pin = LED1_PIN,
+        .mode = LED1_MODE,
+        .flags = SAUL_GPIO_INVERTED,
+    },
+};
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* GPIO_PARAMS_H */
+/** @} */