diff --git a/boards/atmega1284p/Makefile b/boards/atmega1284p/Makefile new file mode 100644 index 0000000000..3134740b39 --- /dev/null +++ b/boards/atmega1284p/Makefile @@ -0,0 +1,5 @@ +MODULE = board + +DIRS = $(RIOTBOARD)/common/atmega + +include $(RIOTBASE)/Makefile.base diff --git a/boards/atmega1284p/Makefile.dep b/boards/atmega1284p/Makefile.dep new file mode 100644 index 0000000000..3d1c295b9b --- /dev/null +++ b/boards/atmega1284p/Makefile.dep @@ -0,0 +1 @@ +USEMODULE += boards_common_atmega diff --git a/boards/atmega1284p/Makefile.features b/boards/atmega1284p/Makefile.features new file mode 100644 index 0000000000..485914d1fe --- /dev/null +++ b/boards/atmega1284p/Makefile.features @@ -0,0 +1,9 @@ +CPU = atmega1284p + +FEATURES_PROVIDED += periph_adc +FEATURES_PROVIDED += periph_gpio periph_gpio_irq +FEATURES_PROVIDED += periph_i2c +FEATURES_PROVIDED += periph_pwm +FEATURES_PROVIDED += periph_spi +FEATURES_PROVIDED += periph_timer +FEATURES_PROVIDED += periph_uart diff --git a/boards/atmega1284p/Makefile.include b/boards/atmega1284p/Makefile.include new file mode 100644 index 0000000000..bcaf884853 --- /dev/null +++ b/boards/atmega1284p/Makefile.include @@ -0,0 +1,18 @@ +# configure the terminal program +PORT_LINUX ?= /dev/ttyUSB0 +PORT_DARWIN ?= $(firstword $(sort $(wildcard /dev/tty.usbmodem*))) +BAUD ?= 9600 +ATMEGA328P_CLOCK ?= +include $(RIOTMAKE)/tools/serial.inc.mk + +# Allow overwriting programmer via env variables without affecting other boards +PROGRAMMER_BOARD_ATMEGA1284P ?= dragon_isp +# ICSP programmer to use for avrdude +PROGRAMMER ?= $(PROGRAMMER_BOARD_ATMEGA1284P) + +ifneq (,$(ATMEGA1284P_CLOCK)) + CFLAGS += -DCLOCK_CORECLOCK=$(ATMEGA1284P_CLOCK) +endif + +include $(RIOTMAKE)/tools/avrdude.inc.mk +include $(RIOTBOARD)/common/atmega/Makefile.include diff --git a/boards/atmega1284p/doc.txt b/boards/atmega1284p/doc.txt new file mode 100644 index 0000000000..f9c77879b1 --- /dev/null +++ b/boards/atmega1284p/doc.txt @@ -0,0 +1,101 @@ +/** +@defgroup boards_atmega1284p Standalone ATmega1284P +@ingroup boards +@brief Support for using the ATmega1284P as standalone board + +## Overview + +As the ATmega1284P can run from the internal oscillator, placing it on a +breadboard, connecting an USB-UART adapter and power is enough to run RIOT on +it. (An ISP programmer will be needed to program it; or to program a bootloader +to subsequently allow programming via UART.) + +### MCU +| MCU | ATmega328p | +|:------------- |:-------------------------------------- | +| Family | AVR/ATmega | +| Vendor | Microchip (previously Atmel) | +| RAM | 16KiB | +| Flash | 128KiB | +| EEPROM | 4KiB | +| Frequency | 8MHz (up to 20MHz with external clock) | +| Timers | 3 (2x 8bit, 1x 16bit) | +| ADCs | 6 analog input pins | +| UARTs | 1 | +| SPIs | 1 | +| I2Cs | 1 (called TWI) | +| Vcc | 2.7V - 5.5V (when clocked at 8MHz) | +| Datasheet | [Official datasheet](http://ww1.microchip.com/downloads/en/DeviceDoc/Atmel-42719-ATmega1284P_Datasheet.pdf) | + +### Pinout + +\htmlonly\endhtmlonly +@image html "http://i.imgur.com/ayagBbM.png" "Pinout of the ATmega1284P"
+ +The pinout image was posted in the +[Arduino Forum](https://forum.arduino.cc/index.php?topic=322745.0). +All credit goes to its poster, hansibull. + +### Clock Frequency + +The ATmega1284P has two internal oscillators clocked at 8MHz and at 128kHz that +allow it to be operated without any external clock source or crystal. By default +the fuses are configured to use the internal 8MHz oscillator, but the `CKDIV8` +fuse is set, so that the clock is divided down to 1MHz. By disabling the +`CKDIV8` fuse the clock will operate at 8MHz. This is highly encouraged, and +can be done with: + +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +avrdude -c dragon_isp -p m1284p -B 32 -U lfuse:w:0xc2:m +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +(Replace `dragon_isp` with the programmer you are using. The -B 32 might be +needed for some programmers to successfully communicate with ATmegas clocked at +less than 2MHz. It will no longer be needed after disabling `CKDIV8`.) + +By setting the environment variable `ATMEGA1284P_CLOCK` to a custom frequency in +Hz (e.g. `1000000` for 1MHz), this core clock can be changed easily. Refer to +the datasheet on how to configure the ATmega1284p to use an external crystal, +an external clock source or the clock divider. + +### Relation Between Supply Voltage, Clock Frequency and Power Consumption + +A higher supply voltage results in a higher current drawn. Thus, lower power +consumption can be achieved by using a lower supply voltage. However, higher +clock frequencies require higher supply voltages for reliable operation. + +The lowest possible supply voltage at 8 MHz is 2.7V (with some safety margin). + +## Flashing the Device + +In order to flash the ATmega1284P without a bootloader, an ISP programmer is +needed. Connect the programmer as follows: + +| ISCP pin | ATmega1284P | +|:-------- |:-------------- | +| MISO | 7/PB6/MISO | +| VCC | 10/VCC | +| SCK | 8/PB7/SCK | +| MOSI | 6/PB5/MOSI | +| RESET | 9/RESET | +| Ground | 11/GND | + +The tool `avrdude` needs to be installed. When using the AVR Dragon for +programming, running + + make BOARD=atmega1284p flash + +will take care of everything. To use the programmer `` instead, run + + make BOARD=atmega1284p PROGRAMMER= flash + +## Serial Terminal + +Connect a TTL adapter with pins 14/RXD0 and 15/TXD0 an run + + make BOARD=atmega1284p term + +Please note that the supply voltage should be compatible with the logic level of +the TTL adapter. Usually everything between 3.3 V and 5 V should work. + + */ diff --git a/boards/atmega1284p/include/board.h b/boards/atmega1284p/include/board.h new file mode 100644 index 0000000000..6e32de50f0 --- /dev/null +++ b/boards/atmega1284p/include/board.h @@ -0,0 +1,66 @@ +/* + * Copyright (C) 2014 Freie Universität Berlin, Hinnerk van Bruinehsen + * 2016 Laurent Navet + * 2019 Otto-von-Guericke-Universität Magdeburg + * + * 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_atmega1284p + * @{ + * + * @file + * @brief Board specific definitions for the standalone ATmega1284P "board" + * + * @author Marian Buschsieweke + * @author Hinnerk van Bruinehsen + * @author Laurent Navet + */ + +#ifndef BOARD_H +#define BOARD_H + +#include "cpu.h" +#include "periph_conf.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/** + * @name STDIO configuration + * + * As the CPU is too slow to handle 115200 baud, we set the default + * baudrate to 9600 for this board + * @{ + */ +#define STDIO_UART_BAUDRATE (9600U) +/** @} */ + +/** + * @name xtimer configuration values + * @{ + */ +#define XTIMER_WIDTH (16) +#if CLOCK_CORECLOCK > 4000000UL +#define XTIMER_HZ (CLOCK_CORECLOCK / 64) +#else +#define XTIMER_HZ (CLOCK_CORECLOCK / 8) +#endif +#define XTIMER_BACKOFF (40) +/** @} */ + +/** + * @brief Initialize board specific hardware, including clock, LEDs and std-IO + */ +void board_init(void); + +#ifdef __cplusplus +} +#endif + +#endif /* BOARD_H */ +/** @} */ diff --git a/boards/atmega1284p/include/periph_conf.h b/boards/atmega1284p/include/periph_conf.h new file mode 100644 index 0000000000..199a442fd8 --- /dev/null +++ b/boards/atmega1284p/include/periph_conf.h @@ -0,0 +1,42 @@ +/* + * Copyright (C) 2019 Otto-von-Guericke-Universität Magdeburg + * + * 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_atmega1284p + * @{ + * + * @file + * @brief Peripheral MCU configuration for the ATmega1284p standalone "board" + * + * @author Marian Buschsieweke + */ + +#ifndef PERIPH_CONF_H +#define PERIPH_CONF_H + +#ifdef __cplusplus +extern "C" { +#endif + +/** + * @name Clock configuration + * @{ + */ +#ifndef CLOCK_CORECLOCK +/* Using 8MHz internal oscillator as default clock source */ +#define CLOCK_CORECLOCK (8000000UL) +#endif +/** @} */ + +#ifdef __cplusplus +} +#endif + +#include "periph_conf_atmega_common.h" + +#endif /* PERIPH_CONF_H */