GSoC 2022 Project

Arduino Core API module for zephyr

Arduino Core API module for zephyr leverages the power of Zephyr under an Arduino-C++ style abtraction layer thus helping zephyr new-comers to start using it without worrying about learning about new APIs and libraries. Visit this project's official blog for documentation.

Adding Arduino Core API to Zephyr

• Pre requisites: It is assumed that you have zephyrproject configured and installed on your system as per the official Get Started Guide. The recommended path to install is ~/zephyrproject as specified in the guide. If you have zephyr installed in a custom path you may need to make changes to the CMakeLists.txt file in the sample code directory when building these samples.

• Add following entry to west.yml file in manifest/projects subtree of Zephyr:

# Arduino API repository.
- name: Arduino-Core-Zephyr
  path: modules/lib/Arduino-Zephyr-API
  revision: dev
  url: https://github.com/zephyrproject-rtos/gsoc-2022-arduino-core

• Then, clone the repository by running

west update

• To "complete" the core you need to copy or symlink the api folder from the ArduinoCore-API repo to the target's cores/arduino folder:

$ git clone git@github.com:arduino/ArduinoCore-API # Any location
$ ln -s /<your>/<location>/ArduinoCore-API/api cores/arduino/.

The cores folder can be found at ~/zephyrproject/modules/lib/Arduino-Zephyr-API/cores.

Known Bug(s):

• While compiling with the ArduinoCore-API WCharacter.h produces many errors. The include of that file needs to be deleted from cores/arduino/api/ArduinoAPI.h (it is unused in this port.) We are looking into resolving the issue.

Maintainers:

• szczys
• beriberikix
• alvarowolfx

Contributor: DhruvaG2000

License

Please note that the current license is Apache 2. Previously it was LGPL 2.1 but after careful review it was determined that no LGPL code or derivates was used and the more permissive license was chosen.