Simplify CI around qualified runtimes

Author: seofernando25

.github/workflows/ci.yml

@@ -10,25 +10,19 @@ permissions:
 
 jobs:
   python:
-    name: Python ${{ matrix.python }}
+    name: Python 3.11
     runs-on: ubuntu-24.04
-    strategy:
-      fail-fast: false
-      matrix:
-        python: ["3.11", "3.13"]
     steps:
       - uses: actions/checkout@v4
       - uses: astral-sh/setup-uv@v5
         with:
           enable-cache: true
-      - run: uv python install ${{ matrix.python }}
-      - run: uv sync --project pi --frozen --python ${{ matrix.python }}
+      - run: uv python install 3.11
+      - run: uv sync --project pi --frozen --python 3.11
       - run: uv run --project pi --frozen ruff check pi tools stm32/scripts
       - run: uv run --project pi --frozen ruff format --check pi tools stm32/scripts
+      - run: uv run --project pi --frozen mypy pi/src/beamcontrol
       - run: uv run --project pi --frozen pytest pi/tests tools/tests --cov=beamcontrol
-      - name: Type check (Python 3.11)
-        if: matrix.python == '3.11'
-        run: uv run --project pi --frozen mypy pi/src/beamcontrol
 
   c-host-tests:
     name: Native firmware unit tests
@@ -46,12 +40,8 @@ jobs:
       - run: make protocol-check
 
   firmware:
-    name: Firmware node ${{ matrix.node }}
+    name: Firmware nodes 1-3
     runs-on: ubuntu-24.04
-    strategy:
-      fail-fast: false
-      matrix:
-        node: [1, 2, 3]
     steps:
       - uses: actions/checkout@v4
       - uses: actions/cache@v4
@@ -64,10 +54,13 @@ jobs:
         run: make toolchain libopencm3
       - name: Build libopencm3
         run: make libopencm3-build
-      - name: Build firmware
-        run: make firmware NODE=${{ matrix.node }}
-      - name: Show size
-        run: make firmware-size NODE=${{ matrix.node }}
+      - name: Build firmware images
+        run: make firmware-all
+      - name: Show image sizes
+        run: |
+          for image in build/firmware/node-*/*.elf; do
+            .tools/arm-gnu-toolchain/bin/arm-none-eabi-size "$image"
+          done
 
   deployment-bundle:
     name: Raspberry Pi 5 deployment bundle

README.md

@@ -31,6 +31,10 @@ make check          # lint + all tests + firmware for nodes 1-3
 make distclean      # remove all repository-local downloaded development state
 ```
 
+Each receiver board needs a unique compile-time CAN node ID from `1` to `30`.
+The Raspberry Pi controller is node `0`; release builds currently provide
+ready-to-flash receiver images for nodes `1`, `2`, and `3`.
+
 Run `make help` for the complete command list. Linux is supported directly;
 Windows development uses WSL2. See
 [`docs/operations/developer-setup.md`](docs/operations/developer-setup.md).

docs/operations/developer-setup.md

@@ -33,10 +33,10 @@ only in repository-local, gitignored directories:
 - `stm32/.deps/` for libopencm3; and
 - `pi/.venv/` for the Python environment.
 
-The host interpreter must be Python 3.10 or newer; `make setup` creates the
-project environment with Python 3.11. Setup does not use `sudo`, install OS
-packages, modify system Python, write to uv's normal per-user cache, or replace
-a system compiler.
+The bootstrap host interpreter must be Python 3.10 or newer. BeamControl itself
+supports Python 3.11 only, and `make setup` creates a Python 3.11 project
+environment. Setup does not use `sudo`, install OS packages, modify system
+Python, write to uv's normal per-user cache, or replace a system compiler.
 
 To remove every downloaded development tool, dependency, environment, cache,
 and build output, run:

pi/pyproject.toml

@@ -7,7 +7,7 @@ name = "beamcontrol"
 version = "0.1.0"
 description = "uORocketry BeamControl CAN controller"
 readme = "README.md"
-requires-python = ">=3.11"
+requires-python = ">=3.11,<3.12"
 dependencies = [
     "python-can>=4.4,<5",
 ]