Automated generation of bin/hex/uf2 files for Arduino continuous integration

Our continuous integration script for Arduino, ci-arduino,  has been updated to include the ability to automatically generate and export build artifacts. This means that if you have an Arduino library with an example sketch, you can call ci-arduino from GitHub Actions to generate a binary or hex file of the sketch for easier uploading. If a platform supports the Microsoft UF2 USB Flashing Format, ci-arduino will also generate a UF2 file of the example sketch.

This workflow lets Arduino library maintainers (like Adafruit) test out pull requests on hardware by dragging + dropping a UF2 file from a pull request onto their board, or flashing a compiled .hex/.bin file. Previously, an Arduino library maintainer would test a pull request on hardware by checking out the specific pull request, opening up Arduino IDE, selecting a target platform, compiling the example, and uploading it.

It’s easy to add ci-arduino to an Arduino library. First, mark a platform (such as the Adafruit QTPy SAMD21) for generation by adding a .platformName.generate file in the same folder as the example:

https://github.com/adafruit/Adafruit_IS31FL3741/tree/main/examples/gfxdemo

Next, update the actions workflow to specify that we’ll be uploading the build artifacts to GitHub:

https://github.com/adafruit/Adafruit_IS31FL3741/blob/main/.github/workflows/githubci.yml

Subsequent pull requests will produce build artifacts after CI-Arduino has completed its run, attached each run. You can check it out here: https://github.com/adafruit/Adafruit_IS31FL3741/actions/runs/1239270699.

You may also use this script to upload compiled binaries to a tagged release. For example, our upcoming Adafruit.io WipperSnapper library uses CI-Arduino to automatically generate UF2 files for 3 different platforms (ESP32, ESP32-S2, SAMD51) and attaches them to a tagged release.

If you encounter a bug, please file a new issue on the repository – https://github.com/adafruit/ci-arduino/issues

We hope this updated tooling is useful not only for us – but also for the Arduino maintainer community!


Adafruit publishes a wide range of writing and video content, including interviews and reporting on the maker market and the wider technology world. Our standards page is intended as a guide to best practices that Adafruit uses, as well as an outline of the ethical standards Adafruit aspires to. While Adafruit is not an independent journalistic institution, Adafruit strives to be a fair, informative, and positive voice within the community – check it out here: adafruit.com/editorialstandards

Join Adafruit on Mastodon

Adafruit is on Mastodon, join in! adafruit.com/mastodon

Stop breadboarding and soldering – start making immediately! Adafruit’s Circuit Playground is jam-packed with LEDs, sensors, buttons, alligator clip pads and more. Build projects with Circuit Playground in a few minutes with the drag-and-drop MakeCode programming site, learn computer science using the CS Discoveries class on code.org, jump into CircuitPython to learn Python and hardware together, TinyGO, or even use the Arduino IDE. Circuit Playground Express is the newest and best Circuit Playground board, with support for CircuitPython, MakeCode, and Arduino. It has a powerful processor, 10 NeoPixels, mini speaker, InfraRed receive and transmit, two buttons, a switch, 14 alligator clip pads, and lots of sensors: capacitive touch, IR proximity, temperature, light, motion and sound. A whole wide world of electronics and coding is waiting for you, and it fits in the palm of your hand.

Have an amazing project to share? The Electronics Show and Tell is every Wednesday at 7:30pm ET! To join, head over to YouTube and check out the show’s live chat and our Discord!

Join us every Wednesday night at 8pm ET for Ask an Engineer!

Join over 38,000+ makers on Adafruit’s Discord channels and be part of the community! http://adafru.it/discord

CircuitPython – The easiest way to program microcontrollers – CircuitPython.org


New Products – Adafruit Industries – Makers, hackers, artists, designers and engineers! — New Products 9/4/2024 Featuring Raspberry Pi Pico 2 – RP2350! @adafruit

Python for Microcontrollers – Adafruit Daily — Python on Microcontrollers Newsletter: The latest on Raspberry Pi RP2350-E9, Bluetooth 6, 4,000 Stars and more! #CircuitPython #Python #micropython @ThePSF @Raspberry_Pi

EYE on NPI – Adafruit Daily — EYE on NPI Maxim’s Himalaya uSLIC Step-Down Power Module #EyeOnNPI @maximintegrated @digikey

Adafruit IoT Monthly — IoT Vulnerability Disclosure, Decorative Dorm Lights, and more!

Maker Business – Adafruit Daily — A look at Boeing’s supply chain and manufacturing process

Electronics – Adafruit Daily — Function Generator Outputs

Get the only spam-free daily newsletter about wearables, running a "maker business", electronic tips and more! Subscribe at AdafruitDaily.com !



No Comments

No comments yet.

Sorry, the comment form is closed at this time.