Kramer Electronics SV-552ALC - Manual (Page 14)

KRAMER: SIMPLE CREATIVE TECHNOLOGY
Communication Protocol 3000
12
4.3 Commands Entering
If a terminal software is used to connect over serial \ ethernet \ USB port, it is possible to directly
enter all commands characters ( will be entered by Enter key, that key sends also , but this
char will be ignored by commands parser).
Sending commands from 3
rd party controllers requires the coding of some characters in a special
form (such as \X##). With most 3 rd party units there is a way to enter all ASCII characters so it is
possible to send all the commands also from the controller.
4.4 Commands Forms
Some commands have a short name syntax beside the full name to allow faster typing, response is
always in long syntax.
4.5 Input String Max Length
64 characters.
General Commands
Command Syntax Response
Protocol Handshaking
#DEV_ID@ ~ DEV_ID@ OK
Parameters:
DEV_ID – Each device has its own K-Net ID that matches to a specific device in K-Config configuration tree.
K-Net Auxiliary Device must react only to commands which are preceded by its own ID.
Example:
WebAccess: #03@
Device Application: ~03@ OK
Note:
Every device (or application that emulates a device) should reply to this request if preceded by its K-Net ID.
Room controllers commands
Emulate button action
#01@BTN BTN,[KEYPAD_ID,[ACTION ]]CR ~01@BTN BTN,KEYPAD_ID,ACTION
RESULTCRLF
Device needs to send this command to the master device when it wants to emulate button action
BTN – Button ID according to the configuration in K-Config
KEYPAD_ID – The KNET ID of the device that the emulated button belongs to according to the configuration in K-Config
ACTION - P=Button Pressing / H= Button Holding / R=Button Release.
Valid button operations sequence will be P->H(->H…)->R or P->R or only R.
Pressing and Holding will activate “Activate while pressed” trigger if defined in K-Config, Releasing will activate “Activate on Release” and “Toggle”
triggers.
RESULT – OK
User can supply 1, 2 or 3 arguments.
The default arguments are :
KEYPAD_ID - the first ID on the list (in the file portdef.ini)
ACTION – P=Button Pressing / R=Button Release.
Example (device application emulate releasing of button 1 in keypad 3):
Device Application:
#01@BTN 1,3,R CR
Master response: ~01@BTN 1,3,R OK CRLF
Note: Master response may be followed by other commands or replies according to the Action list for the button trigger from configuration in K-Config.
Config RGB button leds
# DEV_ID@RGB BTN, RED, GREEN, BLUE, STATECR ~DEV_ID@RGB BTN, RED, GREEN, BLUE,
STATE RESULT CRLF
Device that implements lit buttons should react to this command and set its button.
Device can support full color buttons or just plain on/off lights.