#!/usr/bin/env bash
# SPDX-License-Identifier: MIT OR Apache-2.0
#
# Build one demo binary for a board, make sure that board is running exactly
# that image, and capture what it says.
#
#   tools/demo-run.sh cores3 display                      # 15 s capture
#   tools/demo-run.sh fire27 onewire 30
#   tools/demo-run.sh fire27 m5go 30 --until 'button: A'
#
# Usually reached through `tools/cores3-run.sh` / `tools/fire27-run.sh`, which
# are this script with the board kind filled in.
#
# This replaces the flash-then-monitor dance that used to be retyped per run:
# no `stty`, no background `cat` racing a reset, no `sleep` before it, and no
# guessing whether the board is running the image just built. `--ensure-image`
# resets, reads the board's identity, and writes only on a mismatch.
#
# Stability: the board is NAMED, never spelled out. `cores3`/`fire27` are looked
# up in hil.toml, so a new MAC, a new port or a second rig is a config edit and
# not a change here. The only thing this file knows that the config does not is
# how to BUILD for each board — a target triple and a cargo feature — which is a
# fact about the repo rather than about a rig. Everything after the seconds
# argument is forwarded to the harness verbatim, so a new harness flag needs no
# change either.
#
#   HIL_BOARD      board name in hil.toml            (default: the board kind)
#   HIL_RIG        rig name in hil.toml              (default: its default_rig)
#   DEMO_FEATURES  cargo features for the demo build (default: the board kind)
set -euo pipefail

root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"

KIND="${1:-}"
BIN="${2:-}"
if [ -z "$KIND" ] || [ -z "$BIN" ]; then
    echo "usage: $0 <cores3|fire27> <bin> [seconds] [extra m5stack-hil flags...]" >&2
    exit 2
fi
shift 2

# How to build for each board. The one board-specific thing here, kept as a
# table so adding a third is a line rather than another copy of this file.
case "$KIND" in
    cores3) TARGET=xtensa-esp32s3-none-elf ;;
    fire27) TARGET=xtensa-esp32-none-elf ;;
    *)
        echo "$0: unknown board kind '$KIND' (expected cores3 or fire27)" >&2
        exit 2
        ;;
esac

SECS=15
if [ $# -gt 0 ] && [[ "$1" =~ ^[0-9]+$ ]]; then
    SECS="$1"
    shift
fi

BOARD="${HIL_BOARD:-$KIND}"
FEATURES="${DEMO_FEATURES:-$KIND}"

# `--no-default-features` for both boards, including the one that IS the demos
# crate's default: a build whose feature set depends on which board happens to
# be the default is a build that changes meaning when that default moves.
#
# Build chatter goes to stderr, so `$(tools/demo-run.sh …)` still captures only
# what the harness itself puts on stdout.
cargo build --release --manifest-path "$root/Cargo.toml" \
    -p demos --no-default-features --features "$FEATURES" \
    --target "$TARGET" --bin "$BIN" >&2

exec "$root/tools/hil.sh" \
    --board "$BOARD" ${HIL_RIG:+--rig "$HIL_RIG"} \
    --ensure-image "$root/target/$TARGET/release/$BIN" \
    --capture "$SECS" "$@"