Name		Name	Last commit message	Last commit date
Latest commit History 1,832 Commits
.github/workflows		.github/workflows
bootloaders		bootloaders
cores/arduino		cores/arduino
drivers		drivers
extras		extras
libraries		libraries
patches		patches
variants		variants
.gitignore		.gitignore
.mbedignore		.mbedignore
README.md		README.md
bfg_nano33ble.sh		bfg_nano33ble.sh
boards.txt		boards.txt
edge.variables		edge.variables
giga.variables		giga.variables
mbed-os-to-arduino		mbed-os-to-arduino
mbed_lib.json		mbed_lib.json
nano.variables		nano.variables
nicla.variables		nicla.variables
opta.variables		opta.variables
package.sh		package.sh
package_full.sh		package_full.sh
platform.txt		platform.txt
portenta.variables		portenta.variables
post_install.bat		post_install.bat
post_install.sh		post_install.sh
programmers.txt		programmers.txt
rp2040.variables		rp2040.variables

Repository files navigation

Arduino Core for mbed enabled devices

The repository contains the Arduino APIs and IDE integration files targeting a generic mbed-enabled board

FAQ

Source-Code Level Debugging

Question: "I want to debug my ArduinoCore-mbed based sketch using traditional debugging tools, i.e. gdb via SWD interface. However, the debugger is unable to locate the sources for all files, particular the mbed-os files."

Answer: This is due to the fact that we pre-compile the mbed-os code into a static library libmbed.a. Information on how to recompile libmbed.a for source code debugging can be found here. The Arduino Documentation also contains articles explaining how to debug via Segger J-Link and Lauterbach TRACE32.

Installation

Clone the repository in `$sketchbook/hardware/arduino-git`

mkdir -p $sketchbook/hardware/arduino-git
cd $sketchbook/hardware/arduino-git
git clone git@github.com:arduino/ArduinoCore-mbed mbed

Clone https://github.com/arduino/ArduinoCore-API into a directory of your choice.

git clone git@github.com:arduino/ArduinoCore-API

Update the `api` symlink

Create a symlink to ArduinoCore-API/api in $sketchbook/hardware/arduino-git/mbed/cores/arduino.

Test things out

Open the Arduino IDE.

You should now see three new targets under the MBED boards label.

This procedure does not automatically install the required ARM compiler toolchain.

If the toolchain is missing, you'll see errors like this when you try to build for an mbed-os enabled board.:

fork/exec /bin/arm-none-eabi-g++: no such file or directory

To install ARM build tools, use the Boards Manager option in the Arduino IDE to add the Arduino mbed-enabled Boards package.

mbed-os-to-arduino script

The backbone of the packaging process is the https://github.com/arduino/ArduinoCore-mbed/blob/master/mbed-os-to-arduino script. It basically compiles a blank Mbed OS project for any supported target board, recovering the files that will be needed at compile time and copying them to the right location.

It can be used for a variety of tasks including:

Recompiling libmbed with source level debug support

cd $sketchbook/hardware/arduino-git/mbed
./mbed-os-to-arduino -a -g PORTENTA_H7_M7:PORTENTA_H7_M7

In this case -a applies all the patches from patches folder into a mainline mbed-os tree, and -g restores the debug info.

Selecting a different optimization profile

cd $sketchbook/hardware/arduino-git/mbed
PROFILE=release ./mbed-os-to-arduino -a NANO_RP2040_CONNECT:NANO_RP2040_CONNECT

The PROFILE environment variable tunes the compilation profiles (defaults to DEVELOP). Other available profiles are DEBUG and RELEASE.

Selecting a different Mbed OS tree

cd $sketchbook/hardware/arduino-git/mbed
./mbed-os-to-arduino -r /path/to/my/mbed-os-fork NICLA_VISION:NICLA_VISION

-r flag allows using a custom mbed-os fork in place of the mainline one; useful during new target development.

Adding a new target (core variant)

Adding a target is a mostly automatic procedure.

For boards already supported by Mbed OS, the bare minimum is:

cd $sketchbook/hardware/arduino-git/mbed
mkdir -p variants/$ALREADY_SUPPORTED_BOARD_NAME/{libs,conf}
./mbed-os-to-arduino $ALREADY_SUPPORTED_BOARD_NAME:$ALREADY_SUPPORTED_BOARD_NAME
# for example, to create a core for LPC546XX
# mkdir -p variants/LPC546XX/{libs,conf}
# ./mbed-os-to-arduino LPC546XX:LPC546XX

This will produce almost all the files needed. To complete the port, add the board specifications to boards.txt (giving it a unique ID) and provide pins_arduino.h and variants.cpp in variants/$ALREADY_SUPPORTED_BOARD_NAME folder. Feel free to take inspirations from the existing variants :)

For boards not supported by mainline Mbed OS, the same applies but you should provide the path of your Mbed OS fork

cd $sketchbook/hardware/arduino-git/mbed
mkdir -p variants/$BRAND_NEW_BOARD_NAME/{libs,conf}
./mbed-os-to-arduino -r /path/to/mbed-os/fork/that/supports/new/board $BRAND_NEW_BOARD_NAME:$BRAND_NEW_BOARD_NAME

Customizing Mbed OS build without modifying the code

Most Mbed OS defines can be tuned using a project file called mbed_app.json . In case you need to tune a build you can add that file to your variant's conf folder. One example is https://github.com/arduino/ArduinoCore-mbed/blob/master/variants/PORTENTA_H7_M7/conf/mbed_app.json . Providing an invalid json or replacing a non-existing property will make the build fail silently, so it's always better to validate that file with a standard Mbed OS project.

Using this core as an mbed library

You can use this core as a standard mbed library; all APIs are under arduino namespace (so they must be called like arduino::digitalWrite() )

The opposite is working as well; from any sketch you can call mbed APIs by prepending mbed:: namespace.

About

No description, website, or topics provided.

Readme

Activity

0 stars

0 watching

0 forks

Report repository

Releases

25 tags

Packages

No packages published

Languages

C 89.7%
C++ 10.2%
Logos 0.1%
Go 0.0%
Assembly 0.0%
Shell 0.0%

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Arduino Core for mbed enabled devices

FAQ

Source-Code Level Debugging

Installation

Clone the repository in `$sketchbook/hardware/arduino-git`

Clone https://github.com/arduino/ArduinoCore-API into a directory of your choice.

Update the `api` symlink

Test things out

mbed-os-to-arduino script

Recompiling libmbed with source level debug support

Selecting a different optimization profile

Selecting a different Mbed OS tree

Adding a new target (core variant)

Customizing Mbed OS build without modifying the code

Using this core as an mbed library

About

Releases

Packages

Languages

seaxwi/ArduinoCore-mbed

Folders and files

Latest commit

History

Repository files navigation

Arduino Core for mbed enabled devices

FAQ

Source-Code Level Debugging

Installation

Clone the repository in $sketchbook/hardware/arduino-git

Clone https://github.com/arduino/ArduinoCore-API into a directory of your choice.

Update the api symlink

Test things out

mbed-os-to-arduino script

Recompiling libmbed with source level debug support

Selecting a different optimization profile

Selecting a different Mbed OS tree

Adding a new target (core variant)

Customizing Mbed OS build without modifying the code

Using this core as an mbed library

About

Resources

Stars

Watchers

Forks

Releases

Packages 0

Languages

Clone the repository in `$sketchbook/hardware/arduino-git`

Update the `api` symlink

Packages