#!/usr/bin/env bash # SPDX-License-Identifier: MIT # Ostrý flash MeshCore uzlu přes BLE OTA, celý postup na jeden příkaz. # # Existuje proto, že samotné `ble_dfu.py` je jen přenos obrazu. Kolem něj je # pokaždé stejných šest věcí, a každá z nich už jednou něco stála: # # 1. ČISTÝ STROM. Verze ze špinavého stromu má `+` a na stožáru pak nepoznáš, # co na uzlu je. Skript odmítne pokračovat. # 2. PŘEDLETOVÁ KONTROLA prefs. Prefs v InternalFS přebíjejí build flagy a # flash je NEPŘEPÍŠE — takže se musí přečíst PŘED i PO a porovnat. # 3. TICHO u uzlu s odpojenou antenou (`--require-silence`). Vysílání do # odpojené antény poškozuje PA; build je mlčící z konstrukce, ale prefs to # přebijou, takže se ticho ověřuje na uzlu, ne v ini. # 4. UVOLNĚNÍ LINKU. Zastavit službu (most) NESTAČÍ, spojení drží BlueZ. # 5. OVĚŘENÍ VERZE proti obrazu, ne "vypadá to dobře". # 6. VRÁCENÍ SLUŽBY do provozu a kontrola, že zase teče. # # Použití: # tools/ble_flash_node.sh --env SenseCap_Solar_repeater --mac AA:BB:CC:DD:EE:10 \ # --require-silence # # tools/ble_flash_node.sh --env SenseCap_Solar_repeater \ # --mac AA:BB:CC:DD:EE:11 --via gateway-host \ # --python /opt/ble-bridge/venv/bin/python \ # --stop-service ble-bridge.service # # --check-only jen přečte stav uzlu a skončí (nic nemění, nic neflashuje) # # `--via` flashuje ze vzdáleného hostu, protože BLE má metry: mast-three je # v dosahu bridge-host, ne pracovní stanice. Nic se tam neinstaluje — použije se # python, který na hostu už je (`--python`). set -euo pipefail ENV_NAME="" MAC="" VIA="" PY="python3" STOP_SVC="" REQUIRE_SILENCE=0 CHECK_ONLY=0 REPO="$(cd "$(dirname "$(readlink -f "$0")")/.." && pwd)" while [ $# -gt 0 ]; do case "$1" in --env) ENV_NAME="$2" shift 2 ;; --mac) MAC="$2" shift 2 ;; --via) VIA="$2" shift 2 ;; --python) PY="$2" shift 2 ;; --stop-service) STOP_SVC="$2" shift 2 ;; --require-silence) REQUIRE_SILENCE=1 shift ;; --check-only) CHECK_ONLY=1 shift ;; -h | --help) sed -n '3,33p' "$0" exit 0 ;; *) echo "neznámý argument: $1" >&2 exit 2 ;; esac done [ -n "$MAC" ] || { echo "chybí --mac" >&2 exit 2 } [ -n "$ENV_NAME" ] || [ "$CHECK_ONLY" = 1 ] || { echo "chybí --env" >&2 exit 2 } PIO="${PIO:-$HOME/.platformio/penv/bin/pio}" CLI_CMDS=(ver "get name" "get repeat" "get advert.interval" "get flood.advert.interval" "get freq") # Konzole uzlu: buď lokálně, nebo na hostu z --via (tam se nahrají nástroje). # timeout: ble_cli.py sám žádný nemá. 27. 9. 2026 na mast-three visel připojený # a hluchý 35 minut, most celou dobu stál a flash se k DFU vůbec nedostal. NODE_CLI_TIMEOUT=${NODE_CLI_TIMEOUT:-180} node_cli() { if [ -n "$VIA" ]; then # shellcheck disable=SC2029 ssh "$VIA" "timeout $NODE_CLI_TIMEOUT $PY /tmp/ble_cli.py $MAC $(printf '%q ' "$@")" 2>/dev/null else timeout "$NODE_CLI_TIMEOUT" "$PY" "$REPO/tools/ble_cli.py" "$MAC" "$@" 2>/dev/null fi } pref() { grep -E "^$1[[:space:]]" <<<"$2" | cut -f2- | tr -d '\r'; } if [ -n "$VIA" ]; then scp -q -p "$REPO/tools/ble_cli.py" "$VIA:/tmp/" || { echo "scp ble_cli.py selhalo" >&2 exit 1 } fi # Uvolnit link MUSÍ být PŘED předletovou kontrolou: když linku drží most, na # konzoli se nedostaneš ani ty. A když cokoli dál selže, služba se musí vrátit # do provozu — proto trap, ne "restart na konci". SVC_STOPPED=0 restore_svc() { [ "$SVC_STOPPED" = 1 ] || return 0 echo "== vracím $STOP_SVC ==" >&2 ssh "$VIA" "systemctl start $STOP_SVC" >/dev/null 2>&1 || true SVC_STOPPED=0 } trap restore_svc EXIT if [ -n "$STOP_SVC" ] && [ "$CHECK_ONLY" = 0 ]; then echo "== uvolnění linku ($STOP_SVC) ==" # Zastavit službu NESTAČÍ — spojení drží BlueZ, další připojení pak selže. ssh "$VIA" "systemctl stop $STOP_SVC; bluetoothctl disconnect $MAC >/dev/null 2>&1 || true; sleep 3" SVC_STOPPED=1 fi echo "== stav uzlu $MAC ==" BEFORE="$(node_cli "${CLI_CMDS[@]}")" || { echo "uzel neodpovídá na BLE konzoli" >&2 exit 1 } echo "$BEFORE" | sed 's/^/ /' V_BEFORE="$(pref ver "$BEFORE")" REPEAT_BEFORE="$(pref 'get repeat' "$BEFORE")" ADV_BEFORE="$(pref 'get advert.interval' "$BEFORE")" FADV_BEFORE="$(pref 'get flood.advert.interval' "$BEFORE")" if [ "$REQUIRE_SILENCE" = 1 ]; then if [ "$ADV_BEFORE" != "0" ] || [ "$FADV_BEFORE" != "0" ] || [ "$REPEAT_BEFORE" != "off" ]; then cat >&2 <&2 echo " by pak nešlo poznat, co na něm je. Commitni, nebo stashni." >&2 exit 1 fi (cd "$REPO" && "$PIO" run -e "$ENV_NAME" >/dev/null) || { echo "build selhal" >&2 exit 1 } ZIP="$REPO/.pio/build/$ENV_NAME/firmware.zip" ELF="$REPO/.pio/build/$ENV_NAME/firmware.elf" # Bez roury schválně. `strings "$ELF" | grep -m1 ...` tady padalo na SIGPIPE # (exit 141): grep po prvním nálezu rouru zavře, `strings` ji dostane a # `set -o pipefail` z toho udělá pád celého skriptu -- uprostřed flashe, se # zastaveným mostem. Je to race, takže to roky procházelo; spuštěné hned po # `pio run` ale selhalo 3/3 (21. 9. 2026, mast-three, dvakrát v ostrém běhu). # `grep -a` čte ELF přímo, žádná roura = není co zavřít. # `|| true`, protože skript běží pod `set -e`: bez toho by neúspěšný grep # skript ukončil rovnou na tomhle přiřazení a STOP hláška o dva řádky níž by # se nikdy nevypsala — operátor by dostal holý nenulový exit uprostřed flashe, # klidně už se zastaveným mostem. V_EXPECT="$(grep -m1 -aoE 'v[0-9]+\.[0-9]+\.[0-9]+-tth[0-9a-f]*\+?' "$ELF" || true)" # `grep -m1 -o` zastaví po prvním ŘÁDKU, ale vypíše z něj VŠECHNY shody. ELF # má .rodata oddělenou nulami bez newline, takže dvakrát vražený literál verze # dá dvouřádkový V_EXPECT, porovnání s `ver` z uzlu pak nesedí a povedený OTA # se ohlásí jako chyba. Necháváme první řádek. V_EXPECT="${V_EXPECT%%$'\n'*}" [ -n "$V_EXPECT" ] || { echo "STOP: v obrazu není stampovaná verze (env bez stampingu?)" >&2 exit 1 } echo " obraz: $V_EXPECT ($(stat -c%s "$ZIP") B)" echo " na uzlu teď: $V_BEFORE" echo "== DFU ==" if [ -n "$VIA" ]; then scp -q -p "$ZIP" "$REPO/tools/ble_dfu.py" "$VIA:/tmp/" ssh "$VIA" "cd /tmp && nohup timeout 1500 $PY /tmp/ble_dfu.py /tmp/firmware.zip $MAC > /tmp/dfu_$MAC.log 2>&1 &" || true until ssh "$VIA" "grep -qE 'HOTOVO|SELHALO|Traceback' /tmp/dfu_$MAC.log" 2>/dev/null; do sleep 20; done ssh "$VIA" "tail -4 /tmp/dfu_$MAC.log" | sed 's/^/ /' ssh "$VIA" "grep -q HOTOVO /tmp/dfu_$MAC.log" || { echo "DFU SELHALO — zotavení: ble_dfu.py … phase2" >&2 exit 1 } else "$PY" "$REPO/tools/ble_dfu.py" "$ZIP" "$MAC" | tail -4 | sed 's/^/ /' fi echo "== ověření po flashi ==" for _ in $(seq 1 30); do sleep 10 AFTER="$(node_cli "${CLI_CMDS[@]}" || true)" [ -n "$(pref ver "$AFTER")" ] && break done echo "$AFTER" | sed 's/^/ /' V_AFTER="$(pref ver "$AFTER")" FAIL=0 case "$V_AFTER" in "$V_EXPECT"*) echo " verze OK" ;; *) echo " CHYBA: uzel hlásí '$V_AFTER', čekáno '$V_EXPECT'" >&2 FAIL=1 ;; esac # Prefs flash nepřepisuje, takže rozdíl = něco je špatně (nebo si je uzel resetoval). for p in repeat:REPEAT advert.interval:ADV flood.advert.interval:FADV; do key="${p%%:*}" var="${p##*:}" b_var="${var}_BEFORE" before="${!b_var}" after="$(pref "get $key" "$AFTER")" if [ "$before" != "$after" ]; then echo " CHYBA: $key se změnil: '$before' -> '$after'" >&2 FAIL=1 fi done [ "$FAIL" = 0 ] && echo " prefs beze změny" if [ "$SVC_STOPPED" = 1 ]; then echo "== vrácení služby ==" restore_svc sleep 15 ssh "$VIA" "systemctl is-active $STOP_SVC" | sed 's/^/ /' echo " a ověř DATA, ne jen službu:" echo " ssh $VIA \"journalctl -u $STOP_SVC --since -5min | grep 'full scrape'\"" fi [ "$FAIL" = 0 ] || exit 1 echo "== HOTOVO: $MAC na $V_AFTER =="