tooling: Add firmware build and deploy targets.

Author: nedseb

.gitignore

@@ -7,3 +7,4 @@ __pycache__
 78e43b91-b6a2-4e0a-99c2-3f6f74828063_ExportBlock-935e0d48-7286-4b74-aa60-ccd18217ac01
 node_modules/
 CLAUDE.md
+.build/

CONTRIBUTING.md

@@ -122,6 +122,21 @@ make bump PART=minor   # minor: v1.0.1 → v1.1.0
 make bump PART=major   # major: v1.1.0 → v2.0.0
 ```
 
+## Firmware build and deploy
+
+The drivers are "frozen" into the MicroPython firmware for the STeaMi board. The Makefile automates cloning, building, and flashing:
+
+```bash
+make firmware       # Clone micropython-steami (if needed), update submodule, build
+make deploy         # Flash firmware via OpenOCD
+make run SCRIPT=lib/steami_config/examples/calibrate_magnetometer.py  # Deploy a script as main.py
+make firmware-clean # Clean firmware build artifacts
+```
+
+The firmware source is cloned into `.build/micropython-steami/` (gitignored). The submodule `lib/micropython-steami-lib` is pointed to the current HEAD of your local branch, so the firmware always includes your latest driver changes.
+
+**Requirements**: `arm-none-eabi-gcc` toolchain and OpenOCD for flashing.
+
 ## Notes
 
 * Keep implementations simple and readable

Makefile

@@ -79,6 +79,42 @@ ci: lint test test-examples ## Run all CI checks (lint + tests + examples)
 .PHONY: build
 build: lint test ## Build (lint + test)
 
+# --- Firmware ---
+
+$(MPY_DIR):
+	@echo "Cloning micropython-steami into $(MPY_DIR)..."
+	git clone --branch $(MICROPYTHON_BRANCH) $(MICROPYTHON_REPO) $(MPY_DIR)
+	cd $(MPY_DIR) && git submodule update --init --recursive
+
+.PHONY: firmware
+firmware: $(MPY_DIR) ## Build MicroPython firmware with current drivers
+	@echo "Updating submodule to current HEAD..."
+	cd $(MPY_DIR)/lib/micropython-steami-lib && \
+		git fetch origin && \
+		git checkout $$(cd $(CURDIR) && git rev-parse HEAD)
+	@echo "Building firmware for $(BOARD)..."
+	cd $(MPY_DIR)/ports/stm32 && $(MAKE) BOARD=$(BOARD)
+	@echo "Firmware ready: $(MPY_DIR)/ports/stm32/build-$(BOARD)/firmware.hex"
+
+.PHONY: deploy
+deploy: ## Flash firmware to the board via OpenOCD
+	cd $(MPY_DIR)/ports/stm32 && $(MAKE) BOARD=$(BOARD) deploy-openocd
+
+.PHONY: run
+run: ## Copy and run a script on the board (SCRIPT=path/to/file.py)
+	@if [ -z "$(SCRIPT)" ]; then \
+		echo "Error: SCRIPT is required. Usage: make run SCRIPT=lib/.../example.py"; exit 1; \
+	fi
+	mpremote connect $(PORT) cp $(SCRIPT) :main.py
+	mpremote connect $(PORT) reset
+	@echo "Script deployed as main.py and board reset."
+
+.PHONY: firmware-clean
+firmware-clean: ## Clean firmware build artifacts
+	@if [ -d "$(MPY_DIR)/ports/stm32" ]; then \
+		cd $(MPY_DIR)/ports/stm32 && $(MAKE) BOARD=$(BOARD) clean; \
+	fi
+
 # --- Hardware ---
 
 .PHONY: repl
@@ -141,8 +177,9 @@ clean: ## Remove build artifacts and caches
 	find . -type d -name .mypy_cache -exec rm -rf {} + 2>/dev/null || true
 
 .PHONY: deepclean
-deepclean: clean ## Remove everything including node_modules
+deepclean: clean ## Remove everything including node_modules and firmware
 	rm -rf node_modules
+	@if [ -d "$(BUILD_DIR)" ]; then rm -rf $(BUILD_DIR); fi
 
 .PHONY: help
 help: ## Show this help

env.mk

@@ -1,2 +1,9 @@
 export PATH := $(CURDIR)/node_modules/.bin:$(PATH)
 PORT ?= /dev/ttyACM0
+
+# Firmware build configuration
+MICROPYTHON_REPO ?= https://github.com/steamicc/micropython-steami.git
+MICROPYTHON_BRANCH ?= stm32-steami-rev1d-final
+BOARD ?= STEAM32_WB55RG
+BUILD_DIR ?= .build
+MPY_DIR ?= $(BUILD_DIR)/micropython-steami