Meshtastic OTA Studio — lokalni agent

Potreban je Python 3.10 ili noviji. Prvo pokretanje automatski stvara privatni
Python okoliš i instalira službenu Meshtastic Python biblioteku za čitanje
modela i firmware verzije uređaja.

Windows: dvoklik na start-windows.bat, pa zalijepite URL Pages stranice.
Linux/macOS: pokrenite ./start-linux-macos.sh https://vas-projekt.pages.dev

Ostavite prozor agenta otvoren tijekom ažuriranja. Zadano sluša samo na
127.0.0.1:8765. Za identifikaciju uređaja agent se povezuje na Meshtastic TCP
port 4403; taj port mora biti dostupan s računala agenta.

Računalo agenta i Meshtastic nod moraju biti na istoj mreži. Za Wi-Fi OTA nod
mora biti u OTA načinu, a vatrozid računala mora dopustiti nodu povratnu TCP
vezu.

Agent na drugom računalu ili serveru
-------------------------------------
Remote binding zahtijeva HTTPS certifikat, ključ i pristupni token. Na serveru,
nakon prvog pokretanja i dependency setupa, pokreni:

  .venv/bin/python meshtastic_agent.py --origin https://meshtastic-ota-updater.pages.dev --bind 0.0.0.0 --token 'DUGI-TAJNI-TOKEN-OD-NAJMANJE-24-ZNAKA' --certfile /putanja/agent.crt --keyfile /putanja/agent.key

Na Windowsu koristi .venv\Scripts\python.exe. U pregledniku unesi HTTPS URL
servera i isti token. Certifikat mora biti valjan i preglednik ga mora
vjerovati; dopusti LAN pristup u pregledniku i otvori port 8765 samo na
pouzdanom LAN-u. Ne prosljeđuj port na internet. Token se ne sprema u
localStorage, ali ostaje u polju do zatvaranja stranice.

Postavke uređaja
----------------
U web sučelju se mogu očitati, usporediti i kopirati postavke preko mrežnog
TCP-a, USB/Serial veze ili Bluetooth LE-a. USB i Bluetooth uređaji moraju
biti fizički dostupni računalu na kojem radi agent. Na Linuxu Bluetooth
zahtijeva ispravan BlueZ adapter i dozvole korisnika. Službena Meshtastic
Python biblioteka upravlja prijenosom; aplikacija radi jedan uređaj po jedan.

JSON profili spremaju se lokalno u preglednik ili ih korisnik ručno preuzima.
Ne uključuju sigurnosnu konfiguraciju ni fiksnu lokaciju. Odabrani kanali
uključuju PSK ključeve, a ostale postavke mogu sadržavati Wi-Fi/MQTT lozinke;
izvezene profile čuvajte privatno. Prije grupne primjene provjerite LoRa
regiju i frekvencijske postavke za sve uređaje.

Ovaj agent trenutno nadograđuje firmware samo preko Wi-Fi OTA. Firmware
flashanje preko USB-a ili Bluetootha nije omogućeno.
