build: add directory-oriented make workflows

firmware/Makefile

@@ -0,0 +1,73 @@
+override SHELL := /bin/sh
+override MAKEFLAGS += --no-print-directory
+
+.DEFAULT_GOAL := help
+.DELETE_ON_ERROR:
+
+override CARGO := cargo
+override PYTHON := python3
+override CARGO_FLAGS := --locked --offline
+
+override BOARDS := geprc-f722-v2 kakute-f7-mini-v3
+override BOARD_PACKAGES := $(addprefix kaptan-,$(BOARDS))
+override BOARD_PACKAGE_ARGS := $(addprefix -p ,$(BOARD_PACKAGES))
+override HOST_EXCLUDES := $(addprefix --exclude ,$(BOARD_PACKAGES))
+
+override PRIMARY_GOAL := $(firstword $(MAKECMDGOALS))
+
+run:
+	@exec python3 ../scripts/make-argv.py exec run $(CARGO)
+
+ifeq ($(PRIMARY_GOAL),run)
+
+.PHONY: run
+
+# Application arguments may also look like Make goals. The run recipe recovers
+# their exact boundaries from the original invocation.
+.DEFAULT:
+	@:
+
+else
+
+.PHONY: help run fmt clippy test docs pre-commit check clean
+
+help:
+	@printf '%s\n' 'Usage: make firmware -- <cargo arguments...>' '' \
+		'Example: make firmware -- test --workspace --locked --offline' '' \
+		'Workspace targets:' \
+		'  fmt     Check Rust formatting' \
+		'  clippy  Run host and embedded Clippy checks' \
+		'  test    Run Rust and firmware script tests' \
+		'  docs    Build Rust API documentation with warnings denied' \
+		'  pre-commit  Run fmt, clippy, test, and docs' \
+		'  check   Alias for pre-commit' \
+		'  clean   Remove Cargo build artifacts'
+
+fmt:
+	$(CARGO) fmt --all --check
+
+clippy:
+	$(CARGO) clippy --workspace --all-targets $(HOST_EXCLUDES) \
+		$(CARGO_FLAGS) -- -D warnings
+	$(CARGO) clippy -p platform-stm32f7 --all-targets \
+		$(CARGO_FLAGS) -- -D warnings
+	$(CARGO) clippy $(BOARD_PACKAGE_ARGS) --target thumbv7em-none-eabihf \
+		$(CARGO_FLAGS) -- -D warnings
+
+test:
+	$(CARGO) test --workspace $(CARGO_FLAGS)
+	$(PYTHON) -m unittest \
+		scripts/test-analyze-fw.py scripts/test-summarize-test-coverage.py
+
+docs:
+	RUSTDOCFLAGS='-D warnings' $(CARGO) doc --workspace --no-deps \
+		$(HOST_EXCLUDES) $(CARGO_FLAGS)
+
+pre-commit: fmt clippy test docs
+
+check: pre-commit
+
+clean:
+	$(CARGO) clean
+
+endif