feat: add lab-rv32i-freertos-sw-timer card

scripts/check_abi.sh

@@ -0,0 +1,17 @@
+#!/usr/bin/env sh
+set -eu
+nm=${RISCV_NM:-riscv64-unknown-elf-nm}
+readelf=${RISCV_READELF:-riscv64-unknown-elf-readelf}
+elf=build/task01_sw_timer/prog.elf
+if "$nm" -C -u "$elf" | grep -Eq '__cxa_|_Unwind_|std::|libstdc\+\+'; then echo "hosted C++ runtime dependency" >&2; exit 1; fi
+if "$nm" -C --defined-only "$elf" | grep -Eq 'vtable for|typeinfo for|typeinfo name for'; then echo "virtual/RTTI metadata" >&2; exit 1; fi
+if "$readelf" -S "$elf" | grep -Eq '\.init_array|\.eh_frame|\.gcc_except_table'; then echo "initializer/exception/unwind section" >&2; exit 1; fi
+for symbol in software_timer_debug_checkpoint g_start_commands_accepted g_one_shot_tick g_periodic_ticks g_timer_pass; do
+  if ! "$nm" --defined-only "$elf" | grep -Fq "$symbol"; then echo "missing evidence: $symbol" >&2; exit 1; fi
+done
+for symbol in g_one_shot_storage g_periodic_storage g_verifier_tcb g_verifier_stack; do
+  if ! "$nm" -C --defined-only "$elf" | grep -E "[[:space:]][bB][[:space:]].*$symbol" >/dev/null; then
+    echo "static storage is not in .bss: $symbol" >&2; exit 1
+  fi
+done
+echo "PASS ABI: timer/task control storage in .bss; wrapper has no C++ runtime"

scripts/render_pdf.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env sh
+set -eu
+script_dir=$(CDPATH= cd "$(dirname "$0")" && pwd); repo_root=$(CDPATH= cd "$script_dir/.." && pwd); tex_path="$repo_root/doc/main.tex"
+read_tex_command() { sed -n "s/^\\\\newcommand{\\\\$1}{\\([^}]*\\)}$/\\1/p" "$tex_path" | head -n 1; }
+publisher=$(read_tex_command PublisherDomain); area=$(read_tex_command CardArea); series=$(read_tex_command CardSeries); number=$(read_tex_command CardNumber); slug=$(read_tex_command CardSlug); version=$(read_tex_command CardVersion); uuid=$(read_tex_command DocumentUUID)
+if [ -z "$publisher" ] || [ -z "$area" ] || [ -z "$series" ] || [ -z "$number" ] || [ -z "$slug" ] || [ -z "$version" ] || [ -z "$uuid" ]; then echo "missing card metadata in $tex_path" >&2; exit 1; fi
+commit=${GITEA_SHA:-${GITHUB_SHA:-}}; if [ -z "$commit" ]; then commit=$(git -C "$repo_root" rev-parse HEAD 2>/dev/null || printf '%s' uncommitted); fi
+meta="$repo_root/doc/build-meta.tex"; trap 'rm -f "$meta"' EXIT HUP INT TERM; printf '\\newcommand{\\BuildCommit}{%s}\n' "$(printf '%s' "$commit" | cut -c1-12)" > "$meta"
+out="$repo_root/doc/pdf"; mkdir -p "$out"; ( cd "$repo_root/doc" && latexmk -pdf -interaction=nonstopmode -halt-on-error -outdir="$out" main.tex )
+target="$out/$publisher-$area-$series-$number-$slug-$version-$uuid.pdf"; mv "$out/main.pdf" "$target"
+find "$out" -maxdepth 1 -type f \( -name '*.aux' -o -name '*.log' -o -name '*.out' -o -name '*.fls' -o -name '*.fdb_latexmk' \) -delete
+printf '%s\n' "$target"

scripts/run_sim.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env sh
+set -eu
+tb=${1:?usage: run_sim.sh /path/to/tb [build-dir]}
+build_dir=${2:-build}
+echo "== task01_sw_timer =="
+"$tb" --bin "$build_dir/task01_sw_timer/prog.bin" --cycles 1000000 --cpuret

scripts/test_host.sh

@@ -0,0 +1,11 @@
+#!/usr/bin/env sh
+set -eu
+cxx=${CXX_HOST:-c++}
+build_dir=${1:-host-build}
+mkdir -p "$build_dir"
+$cxx -std=c++17 -Wall -Wextra -Werror -pedantic \
+  -fsanitize=address,undefined -fno-omit-frame-pointer \
+  -Itests/host-shim -Iinclude tests/software_timer_host.cpp \
+  -o "$build_dir/software_timer_host"
+ASAN_OPTIONS=detect_leaks=1 "$build_dir/software_timer_host"
+echo "PASS host: non-copy timer policy, explicit commands and typed callback context"