beautypg.com

Communication protocol 3000 – Kramer Electronics SV-552ALC User Manual

Page 15

background image

Communication Protocol 3000

13

BTN - Button ID according to the configuration in K-Config
RED

, GREEN, BLUE- Color intensity for each base color. Values are from 0 (No color) to 255 (Full color). Plain buttons that support only on/off light

should ignore values of these parameters (except if all set to zero – same as turning light off).

STATE :

"0" or "Off" (Color parameters can be ignored).

"1" or "On"

"2" or "Slow" for slow blink

"3" or "Fast" for fast blink

RESULT – OK if command has been executed.

“#

DEV_ID@RGB ERR 003” should be returned if any parameter exceeds its limits (for example – Button ID does not exist).

Example:
Master Device:

#03@RGB 1,0,255,0,1

CR

Result: Device Application needs to light on its button 1 and set color to Full green.
Device Application response:

~03@RGB 1,0,255,0,1 OK

CRLF

Get RGB button leds configuration #DEV_ID@RGB? BTNCR

~DEV_ID@RGB

BTN,RED,GREEN,BLUE,STATE CRLF

Device that implements lit buttons should reply this request and give its button color and state. Device can support full color buttons or just plain on/off

lights.

BTN - Button ID according to the configuration in K-Config
RED, GREEN, BLUE- Color intensity for each base color. Values are from 0 (No color) to 255 (Full color). Plain buttons that support only on/off light can

set these parameters to any value (except if all are set to zero – same as turning light off).

STATE =

"0" or "Off" (Values of color parameters doesn’t matter).

"1" or "On"

"2" or "Slow" for slow blink

"3" or "Fast" for fast blink

Example:
Master Device:

#03@RGB? 1

CR

Device Application response:

~03@RGB 1,0,255,0,1

CRLF

Write text to LCD

#

DEV_ID@LCD LCD_ID,”TEXTCR

~

DEV_ID@LCD LCD_ID,”TEXT

RESULTCRLF

Device that implements label (LCD) should react to this command and set its “LCD” (or text label).

LCD_ID – Label (LCD) ID according to the configuration in K-Config

TEXT – The text to display in the label (This parameter should be enclosed by quotation marks, character 34 in Ascii)

RESULT – OK if command has been executed.

“LCD ERR 003” should return if any parameter exceeds its limits (for example – LCD with this ID doesn’t exist).


Read text from LCD

#DEV_ID@LCD? LCD_IDCR

~DEV_ID@LCD LCD_ID,”TEXTCRLF

Device that implements label (LCD) should react to this command and set its “LCD” (or text label).

LCD_ID – Label (LCD) ID according to the configuration in K-Config
TEXT – The text to display in the label (This parameter should be enclosed by quotation marks, character 34 in Ascii)


Restore User Interface

#01@UI DEVICE_IDCR

~01@UI DEVICE_ID OKCRLF

After answering OK, the master will send to the device commands to refresh user interface elements like RGB buttons and LCD labels.

For example:
#DEV_ID@RGB 1, RED, GREEN, BLUE, STATECR
#DEV_ID@RGB 2, RED, GREEN, BLUE, STATECR

…(All RGB)


#DEV_ID@LCD 1,”
TEXT”CR
#DEV_ID@LCD
2,”TEXTCR

…(All LCD)

Use this command to get the current user interface state on program start or refreshing the GUI.

This manual is related to the following products: