Bibliotek med kontrolkommandoer

Kommandobiblioteket indeholder alle tilgængelige kommandoer, der sendes til enheden/enhederne. Det er delt op i forskellige grupper, som kan vælges, når man tilføjer en enhed til kontrolkonfigurationen. Nogle af kommandogrupperne er oprettet af GoBright og kan bruges generelt til et par enheder.

Tilpas kommandoer

Den virkelige fordel ved kommandogrupper er, at man kan oprette brugerdefinerede kommandoer til bestemte enheder. Disse kan tilføjes ved at bruge knappen "+" ved siden af underoverskriften Grupper eller ved at bruge knappen "kopier", når en gruppe er valgt.

Generelt

Hver gruppe har et navn, som vises på listen i venstre side. De grupper, der er foruddefineret af GoBright , kan genkendes på GoBright i venstre side af titlen. Disse foruddefinerede grupper kan ikke ændres, men det er muligt at kopiere dem og oprette en ny gruppe med deres kommandoer.

Forbindelsen kan indstilles til enten TCP eller HTTP og afhænger af den enhed, der bruges. Afkrydsningsfeltet "Brug checksum" bestemmer, om kommandoer har brug for en checksum for at kunne fungere korrekt. Bemærk, at kun nogle få checksum-beregninger understøttes i øjeblikket.

Kommandoer

Under navnet og forbindelsen er der en liste, som viser alle kommandoer i gruppen. Nye kommandoer kan tilføjes ved hjælp af '+'-knappen, eller eksisterende kommandoer kan ændres ved at vælge en fra listen. Når kommandoen redigeres, konfigureres indstillingerne i højre side af skærmen.

Indtast en kommando eller en række kommandoer ved at bruge '+'-knappen. Når du indtaster flere kommandoer, vil de blive sendt i rækkefølge fra top til bund. Efter hver kommando bruges tegnet for slutningen af meddelelsen til at identificere, hvornår der er modtaget et fuldt svar.

Meddelelsesforsinkelse forsinker en kommando med et indtastet antal millisekunder. Kommandoer kan sendes gentagne gange til enheden. Den sidste mulighed er et afkrydsningsfelt, der kan bruges til verifikation, som vi kommer nærmere ind på i næste afsnit.

Bekræftelse

Ved at bruge verifikation er det muligt at hente en enheds status, og det danner igen grundlag for tovejskommunikation mellem GoBright og enheden. Verifikationskommandoer udføres hvert 5. sekund for at identificere eventuelle ændringer på enheden, f.eks. en volumenændring ved hjælp af en fjernbetjening. Dette er nyttigt for at sikre, hvad enhedens tilstand er.

Hver kommando kan udløse en verifikationskommando og et forventet svar. Verifikationsprocessoren kontrollerer, i hvilken del det forventede svar kan findes ved at bruge JavaScript på det 'resultat', som enheden sender.

Til sidst kan man markere afkrydsningsfeltet "Brug verifikationsargumentudtrækning". Udtræk af verifikationsargumenter er kun nyttigt for kommandoer, der kræver et argument. For de fleste (hvis ikke alle) enheder betyder det kun lydstyrkeniveauet. Dette henter et argument fra den oprindelige kommando, som skal hedde 'args[0]', og bruger det i verifikationsprocessen. Dette kan i høj grad tilpasses, men er følsomt over for fejl, når de forkerte strenge indtastes. Lad os se på et eksempel fra LG TV, der bruger kommandoen til lydstyrkekontrol.

Eksempel - LG TV volumenkontrol

For at demonstrere, hvordan kommandoer og verifikation fungerer, bruger vi LG-tv'et som eksempel. Nedenfor ses den fulde kommando for Volume Control, som ændres enten ved at bruge skyderen på kontrolpanelet eller ved at bruge fjernbetjeningen fra tv'et. Ved at bruge verifikation er begge lydstyrkeindstillinger konstant synkroniseret med hinanden.

Kommando til lydstyrkekontrol

Den fulde (RS232) kommando til at indstille volumenkontrollen på LG TV er 'kf 1 {}'. Den første del 'kf 1' er begyndelsen på næsten alle kommandoer, der bruges af LG-serien. Da den kun accepterer hexadecimale strenge, konverterer vi den næste del med 'custom.intToHex'. Den sidste del '(args[0], 2)' indstiller lydstyrken til en bestemt værdi.

Alle LG-kommandoer slutter med et 'x', som er indstillet i feltet 'End of message'. Der er ingen forsinkelse i beskeden, og kommandoen bliver kun sendt én gang.

Bekræftelse

Verifikationskommandoen henter status fra enheden. I dette tilfælde kontrollerer kommandoen 'kf 1 FF' den aktuelle lydstyrke fra LG TV'et. Det betyder, at så snart kommandoen er sendt, henter den straks status.

Det forventede svar er 'OK', som er en del af resultatet, når status hentes. Denne del af resultatet udtrækkes ved hjælp af funktionen '{}'. Den læser kun strengen fra det 6. til det 8. tegn og kontrollerer den med det forventede svar.

Den sidste funktion bruger et argument (args[0]), der indstiller det, så det kan bruges i kommandoen. Det skal være et heltal, så den første del af funktionen 'custom.hexToInt' konverterer det hentede hexadecimale tal til et heltal. Den midterste del bruger et regex-kald, som bruges til at filtrere en bestemt del af resultatet 'custom.regex'. Den sidste del bruger regex til at søge efter volumenhøjden, som vises efter 'f 01 OK'-delen og før 'x'.

For at opsummere, hvad der sker:

• Bekræftelseskommandoen sendes hvert 5. sekund
• Processoren udfører alle strengmanipulationer som en understreng eller en decimal til hexadecimal konvertering
• Enhedens svar kontrolleres i forhold til et forventet svar, og hvis svaret svarer til det forventede svar, opdateres brugergrænsefladen til denne tilstand.
• Processoren kontrollerer en del af resultatet
• Argumentudtrækkeren udtrækker argumentet og sender det til brugergrænsefladen (f.eks. lydstyrkeniveauet sendes til brugergrænsefladen).