feat: Aufsetz- und Ausliefer-Skripte der Recovery-Station
setup_pi.sh ist idempotent und laesst eine vorhandene Konfiguration in Ruhe; deploy.sh prueft jedes Image mit nl_mkimage --verify, bevor es etwas uebertraegt. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Michael Sauer
co-authored by
Claude Sonnet 5
Claude Sonnet 5
parent
df8e796f1e
commit
fda732d6c4
@@ -0,0 +1,42 @@
|
|||||||
|
# ninlight-Recovery-Station
|
||||||
|
|
||||||
|
Ein Raspberry Pi spannt den Zugangspunkt `ninlight-recovery` auf und liefert unter
|
||||||
|
`http://192.168.8.1/ninlight_<target>_ota.img` Firmware-Images aus.
|
||||||
|
|
||||||
|
Jede ninlight-Lampe sucht beim Booten bis zu drei Sekunden nach dieser Station. Findet sie
|
||||||
|
sie, lädt sie das Image für ihren Gerätetyp und flasht es — ohne dass die Lampe im WLAN
|
||||||
|
erreichbar sein muss. Das ist der Rettungsweg für Lampen, an die man sonst nur noch mit dem
|
||||||
|
Lötkolben käme.
|
||||||
|
|
||||||
|
Trägt das angebotene Image dieselbe Version, die bereits läuft, lehnt die Lampe es ab und
|
||||||
|
bootet normal weiter. Eine angelassene Station flasht also nicht in einer Endlosschleife.
|
||||||
|
|
||||||
|
## Bedienung
|
||||||
|
|
||||||
|
tools/station/setup_pi.sh <pi-host> einmalig einrichten
|
||||||
|
tools/station/deploy.sh <pi-host> [target] Images ausliefern
|
||||||
|
ssh <pi-host> ninlight-station on einschalten
|
||||||
|
ssh <pi-host> ninlight-station status Zustand und letzte Auslieferungen
|
||||||
|
ssh <pi-host> ninlight-station off ausschalten
|
||||||
|
|
||||||
|
SSID und Passwort stehen in `/etc/ninlight-station.conf` auf dem Pi und müssen zu den
|
||||||
|
Build-Parametern `NINLIGHT_RECOVERY_SSID` und `NINLIGHT_RECOVERY_PASSWORD` aus
|
||||||
|
`config.local.cmake` passen. Weicht eines ab, findet die Lampe die Station nicht.
|
||||||
|
|
||||||
|
## Vertrauensgrenze
|
||||||
|
|
||||||
|
Der Trailer eines Images prüft Gerätetyp und SHA256. Er ist **keine** kryptografische
|
||||||
|
Signatur, und der Download läuft über `http://` ohne TLS. Die Station schützt allein ein
|
||||||
|
WPA2-Passwort, dessen Default im Repo steht. Wer in Funkreichweite ist und es kennt, kann
|
||||||
|
jeder Lampe beim nächsten Boot beliebige Firmware unterschieben.
|
||||||
|
|
||||||
|
Das ist gewollt: Die Signaturprüfung der alten Firmware auszuhebeln ist der Zweck dieses
|
||||||
|
Projekts. Daraus folgen zwei Regeln.
|
||||||
|
|
||||||
|
**Setz ein eigenes Passwort.** In `config.local.cmake` und in
|
||||||
|
`/etc/ninlight-station.conf` — an beiden Stellen denselben Wert.
|
||||||
|
|
||||||
|
**Lass die Station nur an, solange du sie brauchst.** Nicht nur wegen des Fremdzugriffs:
|
||||||
|
Die Firmware löscht den Power-Cycle-Zähler, bevor sie einen Recovery-Versuch startet.
|
||||||
|
Solange eine Station in Reichweite ist, funktioniert der Werksreset per fünf Stromzyklen
|
||||||
|
bei **keiner** Lampe in Reichweite mehr.
|
||||||
Executable
+55
@@ -0,0 +1,55 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
# Liefert Firmware-Images und den Stationscode an den Pi aus.
|
||||||
|
#
|
||||||
|
# Aufruf: tools/station/deploy.sh <pi-host> [target ...]
|
||||||
|
# Ohne target-Argumente werden alle in build/*/ gefundenen _ota.img uebertragen.
|
||||||
|
set -euo pipefail
|
||||||
|
HOST=${1:?Aufruf: tools/station/deploy.sh <pi-host> [target ...]}
|
||||||
|
shift || true
|
||||||
|
HERE=$(cd "$(dirname "$0")" && pwd)
|
||||||
|
ROOT=$(cd "$HERE/../.." && pwd)
|
||||||
|
MKIMAGE="$ROOT/tools/mkimage/nl_mkimage.py"
|
||||||
|
|
||||||
|
declare -a FILES=()
|
||||||
|
if [ $# -gt 0 ]; then
|
||||||
|
for t in "$@"; do
|
||||||
|
f="$ROOT/build/$t/ninlight_${t}_ota.img"
|
||||||
|
[ -f "$f" ] || { echo "Fehler: $f fehlt - erst bauen" >&2; exit 1; }
|
||||||
|
FILES+=("$f")
|
||||||
|
done
|
||||||
|
else
|
||||||
|
while IFS= read -r f; do FILES+=("$f"); done < <(find "$ROOT/build" -maxdepth 2 -name 'ninlight_*_ota.img' | sort)
|
||||||
|
[ ${#FILES[@]} -gt 0 ] || { echo "Fehler: keine Images unter $ROOT/build gefunden" >&2; exit 1; }
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo "== Images pruefen =="
|
||||||
|
STAGE=$(mktemp -d)
|
||||||
|
trap 'rm -rf "$STAGE"' EXIT
|
||||||
|
printf '%-26s %-10s %s\n' GERAET VERSION BYTES
|
||||||
|
for f in "${FILES[@]}"; do
|
||||||
|
base=$(basename "$f")
|
||||||
|
target=${base#ninlight_}; target=${target%_ota.img}
|
||||||
|
# Ein Image, das die Pruefung nicht besteht, wuerde jede Lampe ablehnen -
|
||||||
|
# das faellt sonst erst am Geraet auf.
|
||||||
|
out=$(python3 "$MKIMAGE" --verify "$f" --expect-device "$target") || {
|
||||||
|
echo "Fehler: $base besteht die Trailer-Pruefung nicht, nichts uebertragen" >&2; exit 1; }
|
||||||
|
# shellcheck disable=SC2086
|
||||||
|
set -- $out
|
||||||
|
printf '%-26s %-10s %s\n' "$1" "$2" "$3"
|
||||||
|
cp "$f" "$STAGE/$base"
|
||||||
|
done
|
||||||
|
|
||||||
|
echo "== uebertragen =="
|
||||||
|
rsync -a --delete "$STAGE/" "$HOST:/tmp/ninlight-images/"
|
||||||
|
rsync -a "$HERE/server.py" "$HERE/ninlight-station" "$HERE/ninlight-station.service" "$HOST:/tmp/"
|
||||||
|
ssh "$HOST" 'set -e
|
||||||
|
sudo install -d -m 0755 /opt/ninlight-station/images
|
||||||
|
sudo rsync -a --delete /tmp/ninlight-images/ /opt/ninlight-station/images/
|
||||||
|
sudo install -m 0755 /tmp/server.py /opt/ninlight-station/server.py
|
||||||
|
sudo install -m 0755 /tmp/ninlight-station /usr/local/bin/ninlight-station
|
||||||
|
sudo install -m 0644 /tmp/ninlight-station.service /etc/systemd/system/ninlight-station.service
|
||||||
|
rm -rf /tmp/ninlight-images /tmp/server.py /tmp/ninlight-station /tmp/ninlight-station.service
|
||||||
|
sudo systemctl daemon-reload
|
||||||
|
systemctl is-active --quiet ninlight-station && { sudo systemctl restart ninlight-station; echo " Dienst neu gestartet"; } || echo " Dienst laeuft nicht (Station ist aus)"'
|
||||||
|
|
||||||
|
echo "fertig."
|
||||||
Executable
+66
@@ -0,0 +1,66 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
# Richtet einen Raspberry Pi als ninlight-Recovery-Station ein. Idempotent:
|
||||||
|
# mehrfaches Ausfuehren aendert nichts und schadet nicht.
|
||||||
|
#
|
||||||
|
# Aufruf: tools/station/setup_pi.sh <pi-host>
|
||||||
|
set -euo pipefail
|
||||||
|
HOST=${1:?Aufruf: tools/station/setup_pi.sh <pi-host>}
|
||||||
|
HERE=$(cd "$(dirname "$0")" && pwd)
|
||||||
|
|
||||||
|
echo "== Voraussetzungen auf $HOST pruefen =="
|
||||||
|
ssh "$HOST" 'set -e
|
||||||
|
systemctl is-active --quiet NetworkManager || { echo "NetworkManager laeuft nicht - dieser Plan setzt ihn voraus" >&2; exit 1; }
|
||||||
|
nmcli -t -f DEVICE,STATE device | grep -q "^wlan0:" || { echo "wlan0 wird nicht von NetworkManager verwaltet" >&2; exit 1; }
|
||||||
|
python3 -c "import sys; sys.exit(0 if sys.version_info >= (3,11) else 1)" || { echo "Python 3.11+ noetig" >&2; exit 1; }
|
||||||
|
echo " ok"'
|
||||||
|
|
||||||
|
echo "== Konfiguration =="
|
||||||
|
scp -q "$HERE/station.conf.example" "$HOST:/tmp/ninlight-station.conf.example"
|
||||||
|
ssh "$HOST" 'set -e
|
||||||
|
if [ -f /etc/ninlight-station.conf ]; then
|
||||||
|
echo " /etc/ninlight-station.conf existiert bereits, bleibt unveraendert"
|
||||||
|
else
|
||||||
|
sudo install -m 0600 /tmp/ninlight-station.conf.example /etc/ninlight-station.conf
|
||||||
|
echo " /etc/ninlight-station.conf aus der Vorlage angelegt"
|
||||||
|
fi
|
||||||
|
rm -f /tmp/ninlight-station.conf.example'
|
||||||
|
|
||||||
|
echo "== Server, CLI und Unit installieren =="
|
||||||
|
scp -q "$HERE/server.py" "$HERE/ninlight-station" "$HERE/ninlight-station.service" "$HOST:/tmp/"
|
||||||
|
ssh "$HOST" 'set -e
|
||||||
|
sudo install -d -m 0755 /opt/ninlight-station /opt/ninlight-station/images
|
||||||
|
sudo install -m 0755 /tmp/server.py /opt/ninlight-station/server.py
|
||||||
|
sudo install -m 0755 /tmp/ninlight-station /usr/local/bin/ninlight-station
|
||||||
|
sudo install -m 0644 /tmp/ninlight-station.service /etc/systemd/system/ninlight-station.service
|
||||||
|
rm -f /tmp/server.py /tmp/ninlight-station /tmp/ninlight-station.service
|
||||||
|
sudo systemctl daemon-reload
|
||||||
|
echo " installiert"'
|
||||||
|
|
||||||
|
echo "== NetworkManager-Profil =="
|
||||||
|
ssh "$HOST" 'set -e
|
||||||
|
. /etc/ninlight-station.conf
|
||||||
|
if nmcli -t -f NAME con show | grep -qx "$AP_CONNECTION"; then
|
||||||
|
sudo nmcli con mod "$AP_CONNECTION" \
|
||||||
|
802-11-wireless.ssid "$SSID" wifi-sec.psk "$PSK" \
|
||||||
|
ipv4.addresses 192.168.8.1/24 ipv4.method shared \
|
||||||
|
connection.autoconnect no
|
||||||
|
echo " Profil $AP_CONNECTION aktualisiert"
|
||||||
|
else
|
||||||
|
sudo nmcli con add type wifi ifname wlan0 con-name "$AP_CONNECTION" ssid "$SSID" \
|
||||||
|
802-11-wireless.mode ap 802-11-wireless.band bg 802-11-wireless.channel 6 \
|
||||||
|
wifi-sec.key-mgmt wpa-psk wifi-sec.proto rsn wifi-sec.pairwise ccmp wifi-sec.group ccmp \
|
||||||
|
wifi-sec.psk "$PSK" \
|
||||||
|
ipv4.method shared ipv4.addresses 192.168.8.1/24 ipv6.method disabled \
|
||||||
|
connection.autoconnect no >/dev/null
|
||||||
|
echo " Profil $AP_CONNECTION angelegt"
|
||||||
|
fi'
|
||||||
|
|
||||||
|
cat <<'EOF'
|
||||||
|
|
||||||
|
Fertig. Die Station ist absichtlich noch AUS.
|
||||||
|
|
||||||
|
Naechste Schritte:
|
||||||
|
tools/station/deploy.sh <pi-host> Images ausliefern
|
||||||
|
ssh <pi-host> ninlight-station on Station einschalten
|
||||||
|
ssh <pi-host> ninlight-station off wieder ausschalten (nicht vergessen)
|
||||||
|
EOF
|
||||||
Reference in New Issue
Block a user