This guide helps you set up a command line flashing environment for embedded systems supported by platformio for linux based systems (unfortunately not WSL).

The idea for this development setup is, that you have the platformio IDE running on your system for editing the source code and having the docker container of this repo active, while executing the flash command of this repository in a terminal console as described later in this readme file.

The necessity for this approach is routed in the circumstance, that the Platform.io-IDE is not working properly on NixOS.

The following walkthrough helps patching the /dev folder into the docker container, so it is available with root access.

For further usage, we use the platformio CLI within the container. This wraps the toolchain in a consistant and safe environment.

Restrictions

This project runs on Linux systems only. (no WSL)

Prerequisites

The docker engine must be running on your linux system. For installing the docker engine, look at the installations guide (ubuntu). Other installation guides must be looked up on the internet.

First we need to create the docker image.

When starting the work of your project, you must assure, that the controller is attached to your usb port and powered up.

Ensure that the controller is available in the /dev folder. Usually this is /dev/ttyUSB0, but can be different, depending on circumstances on your OS.

The presense of this device ensures the proper patching into the docker container. If you try to spin up the container before the USB device is attached to the computer, it won't be availabe in the container despite you attached your device at a later point in time. (This is a common mistake, so be warned.)