panelServer sh

Staniční hlášení

Pozor: toto je pouze návrh protokolu, tento protokol zatím není implementován!

Tato stránka popisuje komunikační protokol modulu staničního hlášení, který je typický vestavěný do stanice, a hJOPserveru.

Obecné informace

Modul staničního hlášení se připojuje k Panel serveru hJOPserveru a poslouchá na příchozivší požadavky na přehrání hlášení.

Všechny příkazy staničního hlášení jsou prefixovány řetězcem oř;SH;.

Modul staničního hlášení umožňuje používat libovolné množství sad zvuků, mezi kterými lze přepínat příkazy ze serveru.

Workflow

1. Modul staničního hlášení se připojí k WiFi síti, kterou má uvedenou v konfiguraci.
2. Modul staničního hlášení vyhledá hJOPservery v lokální síti pomocí broadcastu do lokální sítě.
3. Pokud nalezne běžící hJOPserver, ke kterému se má podle konfigurace připojovat, připojí se k němu a zaregistruje staniční hlášení. Jinak poslouchá na UDP discovery portech a čeká na aktivaci serveru (a odesílá UDP požadavek každých 20 s).
4. Po připojení k hJOPserveru poslouchá na příkazy ze serveru, kontroluje existenci spojení.

Definice soupravy

Staniční hlášení definuje soupravu následujícím řetězcem:

číslo;typ;kolej;výchozí stanice;cílová stanice

Například:

608522;Os;1;Zd;Oc

Server → klient

oř;SH;PRIJEDE;{souprava}

• Požadavek na přehrání hlášení o příjezdu soupravy.

oř;SH;ODJEDE;{souprava}

• Požadavek na přehrání hlášení o odjezdu soupravy.

oř;SH;PROJEDE;{souprava}

• Požadavek na přehrání hlášení o průjezdu soupravy.

oř;SH;SPEC;???

• Požadavek na přehrání speciálního hlášení.
• TODO konkrétní hlášení

oř;SH;SYNC

• Požadavek na aktualizaci lokální databáze zvuků.

oř;SH;CHANGE-SET;sada

• Změnit aktuální sadu zvuků na sada.

oř;SH;SETS-LIST

• Požadavek na získání seznamu dostupných sad zvuků.

Klient → server

oř;SH;REGISTER;sada;verze

• Registruje staniční hlášení pro oblast řízení oř.
• Modul používá sadu sada na verzi verze.

oř;SH;REGISTER-ERR;chybová zpráva

• Staniční hlášení není možné inicializovat z důvodu chybová zpráva.

oř;SH;UNREGISTER;

• Zruší registraci staničního hlášení pro oblast řízení oř.

oř;SH;SYNC;STARTED;

• Informuje server o započaté synchronizaci zvuků.

oř;SH;SYNC;DONE;sada;verze

• Synchronizace zvuků byla dokončena, repozitář zvuků je na verzi verze.

oř;SH;SYNC;ERR;verze;chybová zpráva

• Synchronizace zvuků skončila s chybou chybová zpráva, repozitář zvuků je na verzi verze.

oř;SH;CHANGE-SET;[OK,ERR];/chybová zpráva/

• Odpověď na žádost na změnu sady hlášení.

oř;SH;SETS-LIST;{set1,set2,set3}

• Odpověď na požadavek na získání seznamu dostupných sad zvuků.