Open-source firmware framework for amateur rocketry, targeting ESP32-S3 microcontrollers. Solaris provides reusable sensor drivers and a software architecture built around the Solaris Packet Protocol (SPP), designed so that teams without the time or resources to build their own stack can get flying faster.

You need Git to clone the repository. If you don't have it:

git clone --recurse-submodules https://github.com/Software-Solaris/solaris-software.git
cd solaris-software

--recurse-submodules is required — ESP-IDF and the SPP libraries are git submodules.

The script installs Docker and VS Code, and configures everything for the Dev Container automatically.

Linux (Ubuntu / Debian / Fedora / Arch) — run with sudo:

sudo ./scripts/install-linux.sh

After the script finishes, add your user to the docker group:

sudo usermod -aG docker $USER

Then log out and back in (or run newgrp docker) for the group change to take effect.

Windows — open PowerShell as Administrator:

Set-ExecutionPolicy Bypass -Scope Process -Force
.\scripts\install-windows.ps1

The Windows script checks for common issues (virtualisation disabled, insufficient disk space, WSL2 not enabled, missing winget) and gives step-by-step instructions for each. It is safe to run multiple times — it skips anything already installed. A reboot may be required after enabling WSL2; re-run the script afterwards.

code .

VS Code will detect the .devcontainer configuration and prompt:

"Reopen in Container" → click it.

If the prompt does not appear: Ctrl+Shift+P → Dev Containers: Reopen in Container.

Docker builds the image on the first run — this takes a few minutes. Subsequent opens are instant.

Once inside the container, open a terminal (Ctrl+ `):

cd solaris-v1
idf.py build

A successful build produces the firmware binaries under solaris-v1/build/.

Flashing and debugging require access to the remote development station via WireGuard VPN. See System Architecture for the full setup.

Contributions, ideas and improvements are welcome. Fork the repository, make your changes on a branch, and open a pull request against main.

Solaris Software License v1.0 — key points:

• Free for personal, educational and amateur rocketry use.
• Commercial use is unconditionally prohibited. No commercial licence exists or will ever be granted. Any profits generated must be paid in full to Team Solaris.
• Military use is unconditionally prohibited.
• All modifications must be published under this same licence (copyleft).
• Academic use (TFG/TFM) is allowed provided the work is public and credits this repository.

See LICENSE.md for the full terms.