Repository files navigation

This repository hosts the hardware independent layer of Arduino core.

All Arduino official cores are being ported to the new structure so they take advantage of this single repo.

Including this repo in your existing Arduino core will allow the language to grow and include new features.For backwards compatibility, every revision of this repo will increaseARDUINO_API_VERSION define.

Some cores have been ported to the new structure, for example:

• megaAVR (https://github.com/arduino/ArduinoCore-megaAVR)
• nRF52-mbedos (https://github.com/arduino/ArduinoCore-nRF528x-mbedos)
• classic AVR (https://github.com/arduino/ArduinoCore-avr/tree/api)
• SAMD (https://github.com/arduino/ArduinoCore-samd/tree/api)

These repositoriesdon't contain the neededapi subfolder; to "complete" the core you need to copy or symlink theapi folder from this repo to the target'scores/arduino folder.

In the future, core apis will be updated independently from the core, so all the compatible cores will seamlessly adopt new features.This requires support from all the IDEs, so in the meantime we suggest to release the core by copying a snapshot of thisapi folder.

The most elegant and effective solution is to develop the core withapi symlinked and produce the distributable archive by tellingtar to follow symlinks.Example command:

tar --exclude='*.git*' -cjhvf $yourcore-$version.tar.bz2 $yourcore/