/swift-embedded-examples

A collection of example projects using Embedded Swift

Primary LanguageSwiftApache License 2.0Apache-2.0

Embedded Swift Example Projects

This repository is a set of demonstration projects of Embedded Swift. Embedded Swift is a compilation and language mode that enables development of baremetal, embedded and standalone software in Swift. To learn more, see:

Warning

Embedded Swift is experimental. Some information on this page might be out of date with latest development.

Building the examples

Each example in this repository contains build and deployment instructions, however there are a couple common steps needed for many of the examples included below:

  1. Install the latest downloadable 'main' Development Snapshot from swift.org to use Embedded Swift. Public releases of Swift do not yet support Embedded Swift.

You can follow the tutorial here for instructions on installing and using nighly Swift toolchains.

  1. Install the Python3 dependencies listed in requirements.txt.
$ cd swift-embedded-examples
$ python3 -m venv .venv
$ source .venv/bin/activate
$ python3 -m pip install -r Tools/requirements.txt

Catalog of Examples

Name Platform SDK Description Photo
stm32-blink STM32F746G-DISCO None Blink an LED repeatedly.
stm32-lcd-logo STM32F746G-DISCO None Animate the Swift Logo on the built-in LCD.
stm32-neopixel STM32F746G-DISCO None Control NeoPixel LEDs using SPI.
stm32-uart-echo STM32F746G-DISCO None Echo user input using UART.
pico-blink Raspberry Pi Pico None Blink an LED repeatedly.
pico-blink-sdk Raspberry Pi Pico, Pico 2 Pico SDK Blink an LED repeatedly with Swift & the Pico SDK.
pico-w-blink-sdk Raspberry Pi Pico W Pico SDK Blink an LED to signal 'SOS' in Morse code repeatedly with Swift & the Pico SDK.
pico2-neopixel Raspberry Pi Pico 2 None Control Neopixel LEDs using the RP2350 PIO.
nrfx-blink-sdk nRF52840-DK Zephyr SDK Blink an LED repeatedly with Swift & Zephyr.
esp32-led-strip-sdk ESP32-C6-DevKitC-1 ESP-IDF SDK Control NeoPixel LEDs with Swift & the ESP-IDF.
esp32-led-blink-sdk ESP32-C6-Bug ESP-IDF SDK Blink an LED repeatedly with Swift & the ESP-IDF.

Note that the SDK integration examples (Pico SDK, Zephyr SDK, etc.) are not recommendations or endorsement, the same is true for build system choice (Make, CMake, SwiftPM, shell scripts). Embedded Swift aims to be versatile and to allow for integration into more existing SDKs and build systems, and the example projects are merely showing the possibilities.

Community Examples

Warning

Community projects linked here are not officially supported by our team. They may not always be compatible with the latest nightly Swift toolchain builds.

Name Platform Description
swift-matter-examples ESP32 An Embedded Swift Matter application running on ESP32-C6.
swift-flipperzero-hello Flipper Zero A demonstration of running Swift apps on the Flipper Zero.
swift-picosystem-example PicoSystem An Embedded Swift demo running on the Pimoroni PicoSystem
PlaydateKit Playdate A full featured framework for building Playdate games using Embedded Swift.
swift-playdate-examples Playdate An Embedded Swift game running on Playdate by Panic.
swift-for-wasm-examples Web A "Swift Audio Workstation" example built with Swift for WebAssembly running in the browser using Embedded Swift.

Please note that the presence of community repositories and devices in this list does not constitute a recommendation or endorsement. If there's a project you'd like to see included here, please submit an issue with the details.

Contributing to this repository

This repository contains code that is not continuously developed, instead it's presented "as is" for educational and demonstrational purposes. Making major improvements to existing examples is discouraged, but additions of new examples is welcome.

Code of Conduct

Like all Swift.org projects, we would like these Embedded Swift example projects to foster a diverse and friendly community. We expect contributors to adhere to the Swift.org Code of Conduct.

Contact information

The current code owners of this repository are Kuba Mracek (@kubamracek) and Rauhul Varma (@rauhul). You can contact them on the Swift forums via the handles @kubamracek and @rauhul.

In case of moderation issues, you can also directly contact a member of the Swift Core Team.