Kontrollkommandobibliotek

Kommandobiblioteket inneholder alle tilgjengelige kommandoer som sendes til enheten(e). Den er delt opp i forskjellige grupper som kan velges når du legger til en enhet i kontrollkonfigurasjonen. Noen av kommandogruppene er opprettet av GoBright og kan brukes generelt for et par enheter.

Tilpass kommandoer

Den virkelige fordelen med kommandogrupper er å kunne lage tilpassede kommandoer for spesifikke enheter. Disse kan legges til ved å bruke '+'-knappen ved siden av underoverskriften for grupper eller ved å bruke 'kopier'-knappen når en gruppe er valgt.

General

Hver gruppe har et navn som vises i listen på venstre side. Gruppene som er forhåndsdefinert av GoBright kan gjenkjennes av GoBright Logo på venstre side av tittelen. Disse forhåndsdefinerte gruppene kan ikke endres, men det er mulig å kopiere dem og opprette en ny gruppe med deres kommandoer.

Tilkoblingen kan settes på enten TCP eller HTTP og avhenger av enheten som brukes. Avmerkingsboksen 'bruk sjekksum' avgjør om kommandoer trenger en sjekksum for å kunne fungere skikkelig. Vær oppmerksom på at bare noen få sjekksumberegninger støttes for øyeblikket.

Kommandoer

Under navnet og tilkoblingen er en liste som viser alle kommandoene i gruppen. Nye kommandoer kan legges til ved å bruke '+'-knappen eller eksisterende kommandoer som kan endres ved å velge en fra listen. Når kommandoen redigeres, konfigureres alternativene på høyre side av skjermen.

Skriv inn en kommando eller serie med kommandoer ved å bruke '+'-knappen. Når du legger inn flere kommandoer, vil disse bli sendt i sekvensiell rekkefølge fra topp til bunn. Etter hver kommando brukes slutten av meldingen til å identifisere når et svar er fullstendig mottatt.

Meldingsforsinkelse vil forsinke en kommando med et angitt antall millisekunder. Kommandoer kan sendes gjentatte ganger mot enheten. Det siste alternativet er en avkrysningsboks som kan brukes for verifisering som vil gå dypere inn i neste avsnitt.

Bekreftelse

Ved å bruke verifisering er det mulig å hente statusen til en enhet, og dette danner igjen grunnlaget for toveiskommunikasjon mellom GoBright plattformen og enheten. Verifikasjonskommandoer vil utføres hvert 5. sekund for å identifisere eventuelle endringer på enheten, f.eks. volumendring ved hjelp av en fjernkontroll. Dette er nyttig for å kontrollere tilstanden til enheten.

Hver kommando kan utløse én verifiseringskommando og forventet et svar. Verifikasjonsprosessoren sjekker i hvilken del det forventede svaret kan finnes ved å bruke JavaScript på "resultatet" enheten vil sende.

Til slutt kan avmerkingsboksen 'bruk verifikasjonsargumentutvinning' merkes av. Verifikasjonsargumentutvinning er bare nyttig for kommandoer som krever et argument. For de fleste (om ikke alle) enheter betyr dette bare volumnivået. Dette henter et argument fra den opprinnelige kommandoen, som må hete 'args[0]', og bruker det i verifiseringsprosessen. Dette er svært tilpassbart, men sensitivt for feil når feil strenger legges inn. La oss se på et eksempel fra LG TV som bruker volumkontrollkommandoen.

Eksempel – Volumkontroll for LG TV

For å demonstrere hvordan kommandoer og verifisering fungerer, bruker vi LG TV som eksempel. Nedenfor er den fullstendige kommandoen for volumkontroll som endres enten ved å bruke glidebryteren på kontrollpanelet eller ved å bruke fjernkontrollen fra TV-en. Ved å bruke verifisering er begge voluminnstillingene konstant synkronisert med hverandre.

Volumkontrollkommando

Den fulle (RS232) kommandoen for å stille inn volumkontrollen på LG TV er 'kf 1 {}'. Den første delen 'kf 1' er begynnelsen på nesten hver kommando som brukes av LG-serien. Fordi den bare aksepterer heksadesimale strenger, konverterer vi neste del med 'custom.intToHex'. Den siste delen '(args[0], 2)' setter volumet til en viss verdi.

Alle LG-kommandoer slutter med en «x» som er satt i «Slutt på melding»-feltet. Det er ingen meldingsforsinkelse og kommandoen sendes bare én gang.

Bekreftelse

Bekreftelseskommandoen henter statusen fra enheten. I dette tilfellet kontrollerer kommandoen 'kf 1 FF' gjeldende volumet fra LG TV. Det betyr at så snart kommandoen er sendt, henter den umiddelbart statusen.

Forventet respons er 'OK' som er en del av resultatet når statusen er hentet. Denne delen av resultatet trekkes ut ved å bruke '{}'-funksjonen. Dette leser bare strengen fra 6. til 8. tegn og sjekker den med forventet respons.

Den siste funksjonen bruker et argument (args[0]) som setter den slik at den kan brukes i kommandoen. Det må være et heltall, så den første delen av funksjonen 'custom.hexToInt' konverterer den hentede heksadesimalen til et heltall. Midtdelen bruker et regex-kall som brukes til å filtrere en viss del av resultatet 'custom.regex'. Den siste delen bruker regex for å søke etter volumhøyden som vises etter "f 01 OK"-delen og før "x".

For å oppsummere hva som skjer:

• Bekreftelseskommandoen sendes hvert 5. sekund
• Prosessoren utfører alle strengmanipulasjoner som en delstreng eller en desimal til heksadesimal konvertering
• Svaret til enheten sjekkes mot et forventet svar, hvis svaret tilsvarer forventet svar, vil brukergrensesnittet oppdateres til denne tilstanden
• Prosessoren sjekker en del av resultatet
• Argumentuttrekkeren trekker ut argumentet og sender det til brukergrensesnittet ( f.eks. sendes volumnivået til brukergrensesnittet )