framework-arduinoteensy-cxx20

A fork of the PlatformIO ArduinoTeensy framework compatible with GCC 10 & C++20.

Usage

Prerequisites

In order to build with this framework, you'll need to clone a few repos.

Clone framework and dependencies

First, clone this repository:

git clone https://github.com/thevisus/framework-arduinoteensy-cxx20.git

This framework is compatible with the GNU ARM Embedded Toolchain v10.2.1. A corresponding PlatformIO toolchain is therefore necessary:

git clone https://github.com/thevisus/toolchain-gcc-arm-embedded.git

Finally, a PlatformIO "platform" is needed to drive the build:

git clone https://github.com/thevisus/teensy-gcc10.git

Each of these needs to be installed locally via PlatformIO. The pio command or similar management software should be able to do this. The simplest method, on Linux/macOS is to symlink the projects into the PlatformIO user directory:

ln -s /path/to/framework-arduinoteensy-cxx20 $HOME/.platformio/packages
ln -s /path/to/toolchain-gcc-arm-embedded $HOME/.platformio/packages
ln -s /path/to/teensy-gcc10 $HOME/.platformio/platforms

You may check the full platform's availability using pio:

pio platform show teensy-gcc10

Configuring a project

In your project's platform.ini, adjust your environment settings similar to the following:

[platformio]
default_envs = teensy41

[env:teensy41]
platform = teensy-gcc10
platform_packages = toolchain-gcc-arm-embedded
board = teensy41
framework = arduino

Building a project

If everything is setup correctly, you may build your project per usual.

# compile
pio run
# upload
pio run --target upload

Example Makefile

Driving the pio process via make can be accomplished with a simple Makefile. (NB: this version assumes make will be invoked from within vim; if that's not the case, remove the -c vim portions.)

all:
	pio -c vim run

upload:
	pio -c vim run --target upload

clean:
	pio -c vim run --target clean

program:
	pio -c vim run --target program

uploadfs:
	pio -c vim run --target uploadfs

update:
	pio -c vim update

Upstream

The code in cores is up-to-date as of late 2020 from the original https://github.com/PaulStoffregen/cores repo, combined with the libraries and tools found in PlatformIO's original framework-arduinoteensy. It's a bit of a mish-mash, but is fairly up-to-date and functional (tested and run in live systems for several months now).

However, due to the amalgamation of repos and a variety of other reasons, the cores code will only be minimally updated for critical fixes, if at all. Instead, a leaner version of the 4.1 core, intended to be built with the dds toolchain is actively maintained at my personal Gitea: https://git.thevis.us/visus/teensy-core-4.1

License

Teensyduino Core Library
http://www.pjrc.com/teensy/
Copyright (c) 2017 PJRC.COM, LLC.

Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:

1. The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

2. If the Software is incorporated into a build system that allows
selection among a list of target devices, hen similar target
devices manufactured by PJRC.COM must be included in the list of
target devices and selectable in the same manner.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.