PlatformIO is an open source ecosystem for embedded development.
It has a built-in library manager and is Arduino compatible. It supports most operating systems; Windows, MacOS, Linux 32 and 64-bit; ARM and X86.
And best of all, MightyCore is supported!
- What is PlatformIO?
- PlatformIO IDE
- Getting started with PlatformIO IDE or PlatformIO command line interface
- Advanced functionality
- Project Examples
At the moment it is not possible to burn the bootloader or set fuses using PlatformIO. You will still have to use Arduino IDE for this.
However, PlatformIO really shows its stength when working on large projects, often with a lot of dependencies.
I've made a simple platformio.ini template you can use when creating a project for a MightyCore compatible device. The most common functionality is available through this template.
For more information about the build option, check out PlatformIO's Project Configuration File Doc page.
; PlatformIO Project Configuration File for MightyCore
; https://github.com/MCUdude/MightyCore/
;
; Build options: build flags, source filter
; Upload options: custom upload port, speed, and extra flags
; Library options: dependencies, extra library storages
; Advanced options: extra scripting
;
; Please visit documentation for the other options
; https://github.com/MCUdude/MightyCore/PlatformIO.md
; https://docs.platformio.org/page/projectconf.html
; ENVIRONMENT SETTINGS
[env:MightyCore]
platform = atmelavr
framework = arduino
; TARGET SETTINGS
; PlatformIO requires the board parameter. Must match your actual hardware
board = mightycore32
; Actual target
board_build.mcu = atmega32
; Clock frequency in [Hz]
board_build.f_cpu = 16000000L
; BUILD OPTIONS
; Current pinout
board_build.variant = mightycore_standard
; Comment out to enable LTO (this line unflags it)
build_unflags = -flto
; Extra build flags
build_flags =
; UPLOAD SETTINGS
; Upload serial port is automatically detected by default. Override by uncommenting the line below
;upload_port = /dev/cu.usbserial*
; Upload baud rate
board_upload.speed = 115200
; Upload using programmer
;upload_protocol = usbasp
; Aditional upload flags
;upload_flags = -Pusb
; SERIAL MONITOR OPTIONS
; Monitor and upload port is the same by default
;monitor_port =
; Serial monitor baud rate
monitor_speed = 9600PlatformIO requires the board parameter to be present.
The table below shows what board name should be used for each target
| Target | Board name |
|---|---|
| Atmega1284P ATmega1284 |
mightycore1284 |
| ATmega644P/PA ATmega644/A |
mightycore644 |
| ATmega324PB ATmega324PA ATmega324P ATmega324A |
mightycore324 |
| ATmega164P/PA ATmega164A |
mightycore164 |
| ATmega32 | mightycore32 |
| ATmega16 | mightycore16 |
| ATmega8535 | mightycore8535 |
Holds the actual build target.
If building for ATmega324PB for instance, use board_build.mcu = atmega324pb.
Holds the main clock frequency in [Hz].
Note that the clock frequency and upload baud rate will have to match if uploading using a serial bootloader.
Below is a table with the default clocks and baud rates for MightyCore:
| Clock speed | Oscillator | board_build.f_cpu | board_upload.speed |
|---|---|---|---|
| 20 MHz | External | 20000000L | 115200 |
| 18.432 MHz | External | 18432000L | 115200 |
| 16 MHz | External | 16000000L | 115200 |
| 12 MHz | External | 12000000L | 57600 |
| 8 MHz | External | 8000000L | 57600 |
| 8 MHz | Internal | 8000000L | 38400 |
| 1 MHz | Internal | 1000000L | 9600 |
Holds the current pinout in use. Valid pinouts is mightycore_standard, mightycore_bobuino and mightycore_sanguino.
This parameter is used to unflag. Since LTO is enabled by default in PlatformIO we may disable it by unflagging -flto.
This parameter is used to set compiler flags. This is useful if you want to for instance want to chage the serial RX or TX buffer. Here's a list of the current available core files flags:
| Flag | Default size | Description |
|---|---|---|
| -DSERIAL_RX_BUFFER_SIZE=128 | 64 bytes | Sets the serial RX buffer to 128 bytes |
| -DSERIAL_TX_BUFFER_SIZE=128 | 64 bytes | Sets the serial TX buffer to 128 bytes |
| -DTWI_BUFFER_SIZE=64 | 32 bytes | Sets the TWI (i2c) buffer to 64 bytes |
| -DTWI1_BUFFER_SIZE=64 | 32 bytes | Sets the TWI1 (i2c) buffer to 64 bytes (ATmega324PB only) |
Example:
build_flags = -DSERIAL_RX_BUFFER_SIZE=128 -DSERIAL_TX_BUFFER_SIZE=128
Holds the serial port used for uploading. PlatformIO automatically detects the serial port. However, uf you want to ovverride this you can uncomment upload_port. Use /dev/[port] on Unix compatible systems, and use COMx on Windows.
Upload baudrate. See board_build.f_cpu for more details.
Used when using a programmer rather than using a USB to serial adapter.
Supports all Avrdude compatible programmers such as usbasp, usbtiny and stk500v1.
Used to pass extra flags to Avrdude when uploading using a programmer.
Typical parameters are -PUSB, -B[clock divider] and -b[baudrate]
PlatformIO detects serial ports automatically. However, if you want to override this you can uncomment monitor_port. Use /dev/[port] on Unix compatible systems, and use COMx on Windows.
Sets the serial monitor baud rate. Defaults to 9600 if not defined.