Kramer Electronics revision1 manual

Kramer El ectron ics, Ltd. Kra mer Control Systems Virtual Device Build Guidelines Revision 1 Inten ded f or Kramer Tech nical Pe rsonn el or extern al Sy stem Integ rators . T o check th at you h ave th e latest v ersion, go to th e DOWNLOA DS sec tion of our W eb site at : http://www.kramerelectr onics.com/support/downloads.asp[...]

Contents i Contents 1 Intro duction 1 1.1 D efinitions ( within the con text of this docum ent) 1 2 The Communication Layer 1 3 The Vi rtual Devi ce – an Appl ication Example 2 3.1 S ystem O verview 2 3.2 H ard war e S etup 3 3.3 Imple menta t ion 3 3.3.1 A Setup Example 4 3.4 F unctionalit ies 5 3.4.1 Establishing a Connection to the Master RC 5[...]

Introduction 1 1 Introduction Kramer El ectroni cs offe rs a wi de variet y of cont rol pr oducts t hat meet numerous different AV requirem ents . These solu tions make up the Kramer control sy stem and offer seamless compatibilit y with Kr amer si gnal mana gement an d scalin g prod ucts , as well as inte rfacing with display dev ices and other th[...]

KRA MER: SIMPLE CREATIVE TECHNOLOGY The V irtua l Dev ice – an Application Ex ample 2 3 The Virt ual D evi ce – an Application Exa mple The following sections define t he gener al guidel ines f or build ing a Virt ual Dev ice. 3.1 Sy stem Overv ie w Sources • Satellite TV set top box (video and audio on an HDMI output) • DVD player (video o[...]

The V irtua l Dev ice – an Application Ex ample 3 3.2 Hard ware Setup UDP 1 Both the Master RC and the Mobile Device should use the same net/sub- net ran ge. The Mast er RC ( SV -552 in this e xample) will use wired c onnection to the releva nt IT network while the mobile device wi ll be conn ected to the s ame network wire lessl y, so a wirel es[...]

KRA MER: SIMPLE CREATIVE TECHNOLOGY The V irtua l Dev ice – an Application Ex ample 4 3.3.1 A Setup Example The example illustrated in Figu re 3 , show s an appli cation t hat inclu des thre e screens : • A MAIN MENU scre en • A SETTINGS scre en • A VIRTUA L DEV ICE (source s witchi ng) scre en The first two scr eens are used to set and ent[...]

The V irtua l Dev ice – an Application Ex ample 5 T he VIRT UAL DEVI CE Screen The Virtual Device screen includes three buttons that trigger the switching of a switcher , scaler or a similar dev ice in the room 1 Fi gu re 4 as well as a “Select So urce” tex t label , see . Th is screen is duplicated as the Virtual Dev ice in the K- Con fig Vi[...]

KRA MER: SIMPLE CREATIVE TECHNOLOGY The V irtua l Dev ice – an A pplication Exam ple 6 The Virtual Device application then waits for a response from the Master RC for a predefi ned time period, as illustrated in Figu re 5 : Figure 5 : C onnect ing the Vi rt ual Devi ce to the Room C ontroll er[...]

The V irtua l Dev ice – an Application Ex ample 7 Once an "OK" r esponse is received from the Mast er RC, the conne ction is establishe d, s ee Fi gur e 6 Figure 6 : C onnect ing Flow Chart[...]

KRA MER: SIMPLE CREATIVE TECHNOLOGY The V irtua l Dev ice – an Application Ex ample 8 3.4.2 Sending and recei ving Data to/from Master RC The Master RC broadcasts its outgoing Protocol 3000 messages on the K- NET bus. A ll its data messages are sent to all t he K - NET d evices that are co nnected to it. Each K - NET Au xil iary Device should exe[...]

The V irtua l Dev ice – an Application Ex ample 9 The number of buttons on the Virtual Device and their functionalities are defined using th e K-Config softwar e in K- Config Vir tual Device triggers laye r . Pressing a "button" on a Virtual Device application will send a corresponding command to the Master R C. In the following example[...]

KRA MER: SIMPLE CREATIVE TECHNOLOGY The V irtua l Dev ice – an Application Ex ample 10 Figure 8 : Se ndin g and Rece ivi ng Commands Important – The Master RC can send mostly button status/lighting and text field com mands to its K - Net Aux devices. How ever, the competent developer can easily use a co mbination of virtual buttons defined as a[...]

Comm unication Protocol 3000 11 4 Communication P rotocol 3000 = Carriag e return (ASC II 13 = 0x 0D) = Line feed (ASCII 10 = 0x0A) = Space (ASCII 32 = 0x20) 4.1 Host message format start Addres s (opti o nal) body delimiter # Destina tion_id @ message 4.1.1 Simple command (C ommands string with onl y one command without addressing): start body del[...]

KRA MER: SIMPLE CREATIVE TECHNOLOGY Comm unication Protocol 3000 12 4.3 Commands Enter ing If a terminal software is used to connect over ser ial ethern et USB port, it is possible to directly enter all commands char acters ( will be entered by Enter key, that key sends als o , but this char will be ignored by commands parser ). Sending command[...]

Comm unication Protocol 3000 13 BTN - Butt on ID acc ording t o the configu rati on in K - Config RED , GREEN , BL UE - Color int ensit y for each b ase col or. Valu es are fro m 0 (No color ) to 255 (Full col or). Plain b uttons that su pport o nly on/of f light should i gnore v alues of these p arameters (exce pt if all set to zero – same as tu[...]

KRA MER: SIMPLE CREATIVE TECHNOLOGY Comm unication Protocol 3000 14 Result co des (errors) S yn t a x No error. Comm and running s uccee ded ~ DEV_ID @ CO MMA ND PARAM ETERS OK CRLF Protocol Erro rs Syntax E rror (Fo r exam ple: Not enough param eters) ~ DEV_ID @ CO MMA ND ERR001 CRLF Comm and not avail able f or this d evi ce ~ DEV_ID @ ERR002 CRL[...]