Bibliotek för kontrollkommandon

Kommandobiblioteket innehåller alla tillgängliga kommandon som skickas till enheten/enheterna. Det har delats upp i olika grupper som kan väljas när du lägger till en enhet i styrkonfigurationen. Vissa av kommandogrupperna har skapats av GoBright och kan användas generellt för ett par enheter.

Anpassa kommandon

Den verkliga fördelen med kommandogrupper är att man kan skapa anpassade kommandon för specifika enheter. Dessa kan läggas till med hjälp av "+"-knappen bredvid underrubriken Grupper eller med hjälp av "kopiera"-knappen när en grupp har valts.

Allmänt

Varje grupp har ett namn som visas i listan på vänster sida. De grupper som är fördefinierade av GoBright känns igen på GoBright på vänster sida av titeln. Dessa fördefinierade grupper kan inte ändras, men det är möjligt att kopiera dem och skapa en ny grupp med deras kommandon.

Anslutningen kan ställas in på antingen TCP eller HTTP och beror på vilken enhet som används. Kryssrutan "use checksum" avgör om kommandona behöver en checksumma för att fungera korrekt. Observera att endast ett fåtal checksummeberäkningar stöds för närvarande.

Kommandon

Under namnet och anslutningen finns en lista som visar alla kommandon inom gruppen. Nya kommandon kan läggas till genom att använda "+"-knappen eller befintliga kommandon som kan ändras genom att välja ett från listan. När kommandot redigeras konfigureras alternativen på höger sida av skärmen.

Ange ett kommando eller en serie kommandon med hjälp av "+"-knappen. När du anger flera kommandon skickas dessa i sekventiell ordning uppifrån och ned. Efter varje kommando används tecknet för slutet av meddelandet för att ange när ett svar har mottagits fullständigt.

Message delay fördröjer ett kommando med ett angivet antal millisekunder. Kommandon kan skickas upprepade gånger till enheten. Det sista alternativet är en kryssruta som kan användas för verifiering, vilket vi går djupare in på i nästa avsnitt.

Verifiering

Genom att använda verifiering är det möjligt att hämta status för en enhet och detta utgör i sin tur grunden för tvåvägskommunikation mellan GoBright och enheten. Verifieringskommandon körs var 5:e sekund för att identifiera eventuella förändringar på enheten, t.ex. en volymändring med en fjärrkontroll. Detta är till stor hjälp för att säkerställa enhetens status.

Varje kommando kan utlösa ett verifieringskommando och ett förväntat svar. Verifieringsprocessorn kontrollerar i vilken del det förväntade svaret kan hittas genom att använda JavaScript på det "resultat" som enheten kommer att skicka.

Slutligen kan kryssrutan "use verification argument extracting" (använd extrahering av verifieringsargument) markeras. Verifierad argumentutdragning är endast användbar för kommandon som kräver ett argument. För de flesta (om inte alla) enheter innebär detta endast volymnivån. Detta hämtar ett argument från det ursprungliga kommandot, som måste ha namnet 'args[0]', och använder det i verifieringsprocessen. Detta är mycket anpassningsbart men känsligt för fel när felaktiga strängar anges. Låt oss titta på ett exempel från LG TV som använder kommandot för volymkontroll.

Exempel - volymkontroll för LG TV

För att visa hur kommandon och verifiering fungerar använder vi LG TV som exempel. Nedan visas det fullständiga kommandot för volymkontroll som ändras antingen genom att använda skjutreglaget på kontrollpanelen eller genom att använda fjärrkontrollen från TV:n. Genom att använda verifiering är båda volyminställningarna ständigt synkroniserade med varandra.

Kommando för volymkontroll

Det fullständiga (RS232) kommandot för att ställa in volymkontrollen på LG TV är "kf 1 {}". Den första delen 'kf 1' är början på nästan alla kommandon som används av LG-serien. Eftersom den bara accepterar hexadecimala strängar konverterar vi nästa del med 'custom.intToHex'. Den sista delen '(args[0], 2)' ställer in volymen till ett visst värde.

Alla LG-kommandon avslutas med ett "x" som har angetts i fältet "End of message". Det finns ingen fördröjning av meddelandet och kommandot skickas bara en gång.

Verifiering

Verifieringskommandot hämtar status från enheten. I det här fallet kontrollerar kommandot "kf 1 FF" den aktuella volymen från LG TV. Det innebär att så snart kommandot skickas hämtas statusen omedelbart.

Det förväntade svaret är "OK", som är en del av resultatet när statusen hämtas. Denna del av resultatet extraheras med hjälp av funktionen '{}'. Denna läser bara strängen från det 6:e till det 8:e tecknet och kontrollerar den mot det förväntade svaret.

Den sista funktionen använder ett argument (args[0]) som ställer in det så att det kan användas inom kommandot. Det måste vara ett heltal så den första delen av funktionen 'custom.hexToInt' omvandlar den hämtade hexadecimalen till ett heltal. Den mellersta delen använder ett regex-anrop som används för att filtrera en viss del av resultatet 'custom.regex'. I den sista delen används regex för att söka efter volymhöjden som visas efter "f 01 OK"-delen och före "x".

För att sammanfatta vad som händer:

• Verifieringskommandot skickas var 5:e sekund
• Processorn utför alla strängmanipulationer som en delsträng eller en konvertering från decimal till hexadecimal
• Enhetens svar kontrolleras mot ett förväntat svar, om svaret är lika med det förväntade svaret uppdateras användargränssnittet till detta tillstånd
• Processorn kontrollerar en del av resultatet
• Argumentextraktorn extraherar argumentet och skickar det till användargränssnittet (t.ex. volymnivån skickas till användargränssnittet)