Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/madskjeldgaard/platformio-arduino-template
The ⚡ULTIMATE⚡ Arduino starter template for Platformio 🐩 (Pico, ESP32, ESP8266, Teensy, etc)
https://github.com/madskjeldgaard/platformio-arduino-template
adafruit-feather arduino esp32 esp32-arduino esp8266 esp8266-arduino platformio raspberry-pi-pico teensy teensy40 teensy41 teensylc template-repository
Last synced: 4 months ago
JSON representation
The ⚡ULTIMATE⚡ Arduino starter template for Platformio 🐩 (Pico, ESP32, ESP8266, Teensy, etc)
- Host: GitHub
- URL: https://github.com/madskjeldgaard/platformio-arduino-template
- Owner: madskjeldgaard
- License: mit
- Created: 2024-07-16T11:33:42.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2024-07-23T16:46:28.000Z (7 months ago)
- Last Synced: 2024-09-29T22:46:46.356Z (4 months ago)
- Topics: adafruit-feather, arduino, esp32, esp32-arduino, esp8266, esp8266-arduino, platformio, raspberry-pi-pico, teensy, teensy40, teensy41, teensylc, template-repository
- Language: Shell
- Homepage:
- Size: 24.4 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/madskjeldgaard/platformio-arduino-template/actions/workflows/build.yml)
# The ⚡ULTIMATE⚡ Arduino starter template for Platformio 🐩
Making electronics projects using the [arduino framework](https://www.arduino.cc/) in [platformio](https://platformio.org/) is amazingly fast, low-maintenance and wonderful. If you know how to set it up. Trying to get the right board matched with the right platform, matched with the right compiler flags to make USB work or getting the correct OSC library, etc.
This template makes it easier by providing a nice skeleton with some cool extra features and opinionated things to turbo charge your new project.
It has a lot of common things set up for some common boards used in the art/music/maker world, including a few optimizations and weird fixes.
It includes suggestions for libraries to use so you don't have to dig around too much for the common stuff. Just uncomment in the platformio.ini file and recompile.
## Features
- 🐩 Platformio-based – easy to compile and upload, gets dependencies automatically, also easy to extend with new boards
- 🐩 Includes a lot of common libraries. Just comment/uncomment in [platformio.ini](platformio.ini) to your project's liking.
- 🐩 Set up for C++17, allowing a lot of modern C++ tricks.
- 🐩 A helper script is included in [.scripts/commands.sh](.scripts/commands.sh) to make tedious processes simpler.
- 🐩 VSCode tasks are included making building easy in VSCode and in NeoVim (using the Overseer plugin)
- 🐩 A Github Action which runs every time you push code to test if your firmware still compiles.
## Supported boards
- ✅ Raspberry Pi Pico
- ✅ Raspberry Pi PicoW
- ✅ Teensy 4.1
- ✅ Teensy 4.0
- ✅ Teensy LC
- ✅ NodeMCUV2 ESP8266
- ✅ ESP32 dev boards
- ✅ Adafruit Feather ESP32
- ✅ Adafruit Feather ESP32 S2
... And it's very easy to add more boards:
### Adding new boards
The included script has a command to fuzzy search through available boards and automatically insert it into `platformio.ini` and auto update the vscode tasks as well.
Add new board using this command:
```bash
.scripts/commands.sh add_board
```
Then open `platformio.ini` and make any additional adjustments.
## Usage
To make a project based on this template, you can click on the `Use this template` button at the top of the page.
### Manually making a project based on this template
If you don't want to use github, you can clone this project manually (so you can use it on [Codeberg](https://codeberg.org/) or another git repository):
```bash
git clone [email protected]:madskjeldgaard/platformio-arduino-template.git my-pio-arduino-project
cd my-pio-arduino-project
git remote remove origin
git remote add origin
```
### Compiling and uploading
To compile and upload your sketch, simply run this command, adjusted to one of the supported boards, eg for Teensy 4.0:
```bash
.scripts/commands.sh build teensy40
```
Or to build and then upload in one command:
```bash
.scripts/commands.sh upload teensy40
```
Finally, the project includes vscode tasks, which are the recommended way of running these commands. Either using vscode as an editor, or in neovim using the [overseer.nvim](https://github.com/stevearc/overseer.nvim) for NeoVim.
### Installing dependencies
You need to have platformio installed to make use of this.
Install it on MacOS by running homebrew:
```bash
brew install platformio
```
If you want to use all the helper scripts' features for adding new boards to your project, you also need `fzf` and `jq`:
```bash
brew install fzf jq
```
### Using the helper script
Some additional features are packed into the included helper script, run it without arguments to get a list of commands:
```bash
.scripts/commands.sh
```