Arduino hardware package for ATmega8, ATmega48, ATmega88, ATmega168, ATmega328 and ATmega328PB
Arduino hardware package for ATmega8, ATmega48, ATmega88, ATmega168, ATmega328 and ATmega328PB
An Arduino core for the ATmega328, ATmega168, ATmega88, ATmega48 and ATmega8, all running the Urboot bootloader.
Arduino IDE v1.8 and v2.x supported!
From version 3.1.0 onwards, debugging in the Arduino IDE 2 is supported. You can use any of Microchip's EDBG-based hardware debuggers or the DIY debugger dw-link. For documentation, see https://pyavrocd.io.
From MiniCore version 3 and onwards, the Optiboot bootloader has been replaced by the superior Urboot bootloader. It's smaller, faster, and has automatic baud rate detection, and can read and write to EEPROM. Other cool features the bootloader provides but are not utilized by MiniCore are user program metadata stored in flash (that can easily be viewed by Avrdude -xshowall) and chip-erase functionality. If you already have Optiboot installed and don't want to replace it with Urboot, you can still upload programs without any compatibility issues. However, if you're burning a bootloader to a new chip, Urboot is the way to go.
ATmega8
ATmega48
ATmega88
ATmega168
ATmega328
All variants (A, P, PA, and PB)
| ATmega328 | ATmega168 | ATmega88 | ATmega48 | ATmega8 | |
|---|---|---|---|---|---|
| Flash | 32kB | 16kB | 8kB | 4kB | 8kB |
| RAM | 2kB | 1kB | 1kB | 512B | 1kB |
| EEPROM | 1kB | 512B | 512B | 256B | 512B |
| PWM pins | 6/9* | 6 | 6 | 6 | 3 |
MiniCore supports a variety of different clock frequencies. Select the microcontroller in the boards menu, then select the clock frequency. You will have to hit "Burn bootloader" in order to set the correct fuses and upload the correct bootloader. This also has to be done if you want to change any of the fuse settings (BOD and EEPROM settings), regardless of whether a bootloader is installed or not.
Make sure you connect an ISP programmer, and select the correct one in the "Programmers" menu. For time-critical operations, an external crystal/oscillator is recommended. The Urboot bootloader has automatic baud rate detection, so UART uploads should work fine even though the oscillator is a little too fast or too slow.
| Frequency | Oscillator type | Comment |
|---|---|---|
| 16 MHz | External crystal/oscillator | Default clock on most AVR-based Arduino boards and MiniCore |
| 20 MHz | External crystal/oscillator | |
| 18.4320 MHz | External crystal/oscillator | Great clock for UART communication with no error |
| 14.7456 MHz | External crystal/oscillator | Great clock for UART communication with no error |
| 12 MHz | External crystal/oscillator | |
| 11.0592 MHz | External crystal/oscillator | Great clock for UART communication with no error |
| 9.216 MHz | External crystal/oscillator | Great clock for UART communication with no error |
| 8 MHz | External crystal/oscillator | Common clock when working with 3.3V |
| 7.3728 MHz | External crystal/oscillator | Great clock for UART communication with no error |
| 6 MHz | External crystal/oscillator | |
| 4 MHz | External crystal/oscillator | |
| 3.6864 MHz | External crystal/oscillator | Great clock for UART communication with no error |
| 2 MHz | External crystal/oscillator | |
| 1.8432 MHz | External crystal/oscillator | Great clock for UART communication with no error |
| 1 MHz | External crystal/oscillator | |
| 8 MHz | Internal oscillator | |
| 4 MHz | Internal oscillator | Derived from the 8 MHz internal oscillator |
| 2 MHz | Internal oscillator | Derived from the 8 MHz internal oscillator |
| 1 MHz | Internal oscillator | Derived from the 8 MHz internal oscillator |
MiniCore lets you select which serial port you want to use for uploading. UART0 is the default port for all targets, but ATmega328PB can also use UART1. If your application doesn't need or require a bootloader for uploading, you can also choose to disable it by selecting No bootloader. This frees 384 bytes of flash memory on ATmega8/88/168/328 and 320 bytes on the ATmega48.
Note that you need to connect a programmer and hit Burn bootloader if you want to change any of the Bootloader settings.
Since Urboot has automatic baud rate detection, the upload baud rate can be changed without having to re-flash the bootloader. The default baud rate setting will pick a suited baud rate that also works with the legacy Optiboot bootloader used in earlier MiniCore versions. The other baud rate options may or may not work, depending on the clock frequency and accuracy of the clock source. A rule of thumb is that "non-round" baud rates like 230400 work best with "non-round" clock speeds like 18.4320 MHz, while "round" ones like 16 MHz work best with "round" baud rates like 250000.
Brown-out detection, or BOD for short, lets the microcontroller sense the input voltage and shut down if the voltage goes below the brown-out setting. To change the BOD settings, you'll have to connect an ISP programmer and hit "Burn bootloader". Below is a table that shows the available BOD options:
| ATmega328 | ATmega168 | ATmega88 | ATmega48 | ATmega8 |
|---|---|---|---|---|
| 4.3V | 4.3V | 4.3V | 4.3V | 4.0V |
| 2.7V | 2.7V | 2.7V | 2.7V | 2.7V |
| 1.8V | 1.8V | 1.8V | 1.8V | - |
| Disabled | Disabled | Disabled | Disabled | Disabled |
If you want the EEPROM to be erased every time you burn the bootloader or upload using a programmer, you can turn off this option. You'll have to connect an ISP programmer and hit "Burn bootloader" to enable or disable EEPROM retain. Note that when uploading using a bootloader, the EEPROM will always be retained.
Note that if you're using an ISP programmer or have the Urboot bootloader installed, data specified in the user program using the EEMEM attribute will be uploaded to EEPROM when you upload your program in Arduino IDE. This feature is not available when using the older Optiboot bootloader.
#include
volatile const char ee_data EEMEM = {"Data that's loaded straight into EEPROM\n"};
void setup() {
}
void loop() {
}Link time optimization (LTO for short) optimizes the code at link time, usually making the code significantly smaller without affecting performance. You don't need to hit "Burn Bootloader" in order to enable or disable LTO. Simply choose your preferred option in the "Tools" menu, and your code is ready for compilation. If you want to read more about LTO and GCC flags in general, head over to the GNU GCC website!
Unlike the official Arduino cores, MiniCore has printf support out of the box. If you're not familiar with printf you should probably read this first. It's added to the Print class and will work with all libraries that inherit Print. Printf is a standard C function that lets you format text much easier than using Arduino's built-in print and println. Note that this implementation of printf will NOT print floats or doubles. This is disabled by default to save space, but can be enabled using a build flag if using PlatformIO.
If you're using a serial port, simply use Serial.printf("Milliseconds since start: %ld\n", millis());. You can also use the F() macro if you need to store the string in flash. Other libraries that inherit the Print class (and thus support printf) are the LiquidCrystal LCD library and the U8G2 graphical LCD library.
Note that you don't have to use the digital pin numbers to refer to the pins. You can also use some predefined macros that maps "Arduino pins" to the port and port number:
// Use PIN_PB5 macro to refer to pin PB5 (Arduino pin 13)
digitalWrite(PIN_PB5, HIGH);
// Results in the exact same compiled code
digitalWrite(13, HIGH);
MiniCore uses the excellent Urboot bootloader, written by Stefan Rueger. Urboot supports flash writing within the running application, meaning that content from e.g. a sensor can be stored in the flash memory directly without needing external memory. Flash memory is much faster than EEPROM, and can handle at least 10,000 write cycles before wear becomes an issue. For more information on how it works and how you can use this in your own application, check out the Serial_read_write for a simple proof-of-concept demo, and Flash_put_get + Flash_iterate for useful examples on how you can store strings, structs, and variables to flash and retrieve them afterward.
Select your microcontroller in the boards menu, then select the clock frequency. You'll have to hit "Burn bootloader" in order to set the correct fuses and upload the correct bootloader.
Make sure you connect an ISP programmer, and select the correct one in the "Programmers" menu. For time-critical operations, an external oscillator is recommended.
This installation method requires Arduino IDE version 1.8.0 or greater.
Open the Arduino IDE.
Open the File > Preferences menu item.
Enter the following URL in Additional Boards Manager URLs:
https://mcudude.github.io/MiniCore/package_MCUdude_MiniCore_index.jsonOpen the Tools > Board > Boards Manager... menu item.
Wait for the platform indexes to finish downloading.
Scr
No open issues yet, or sync has not completed.