If you need to use your own Software Control program from a PC or WORKSTATION with an RS-232 or LAN port, the device allows communication
through an ASCII code protocol.
The device treats any character that it receives on the RS-232 or LAN as a possible command but only accepts legal commands.
There is no starting/ending code needed in a command string.
A command can be a single character typed on a keyboard and does not require any special character before or after it.
(It is not necessary to press "ENTER" on the keyboard). A command can be preceded by a value (See chapter A-2).
When the device receives a valid command, it will execute the command. Then it will send back the status of the parameters that have changed due
to this command.
If the command cannot be executed (value out of range, no signal on the selected input),etc. The device will just sends back the current status of
the corresponding parameters.
If the command is invalid, an error response will be returned to the control device. All responses returned to the control device end with
a carriage return <CR> and a line feed <LF> signaling the end of the response character string (see chapter A-3).
A2: Commands structure
The above listed devices share the same code structure.
Commands are made of numerical values for arguments followed by the command characters (one or Two case-sensitive alphabetical letters). Usually the same
characters (letters) are used for the [read Command] as well as the [write command].
The indexes are defined numbers indicating the how the arguments for the command apply. For example a layer number, an input number, a preset number, etc.
They are separated with a comma.
There are commands without index and others with up to 3 indexes. Each index is followed by a comma character. The final argument, also refered to as the “value”
does not have a comma between it and the command.
2
Page 3
A [write command] is made of indexes followed by the numerical value followed by the command characters.
Write command = [[index,] ...] + Value + Character (s) code (s)
For example: “1,2,0IN” or “4YB”
A [read command] is made of indexes followed immediately by the command characters. (no numerical value)
Read command = [[index,] ...] Character (s) code (s)
For example: “1,2,IN” or “YB”
A3: Examples
Document notation:
1) Command with 1 index : OFORMAT
Command to set the Main output format to XGA: 0,12OF
Answer: OF0,12<CR><LF> which mean that the main output format is now 1024x768
2) Command with 2 indexes : PE_INPUTNUM
Command to set the input 4 displayed in background layer of Next Preset: 1,2,4IN
Answer: IN1,1,4<CR><LF> which mean that the background layer of the next preset will display the input 4 signal
3) Read command without index : TAKEAVA
Read command to know if the TAKE command is available: TA
Answer: TA1<CR><LF> which mean that the device is ready to accept the TAKE command.
4) Read command with 2 indexes : SET_ASPECT_RATIO_OUT
Read command to know how is displayed a signal plugged on the input 4: 3,so
Answer: so3,2<CR><LF> which mean that the input 4 is displayed cropped
3
Page 4
A4: Error codes
Answer: E10<CR><LF> which mean invalid command
Answer: E11<CR><LF> which mean index value error (index value out of range)
Answer: E12<CR><LF> which mean index number error (too or few indexes)
Some commands are only available as [Read command], they are status and are colored in blue as this line.
Some commands are colored in yellow as this line to indicate they were added or modified in this version.
A5 COMMUNICATION PORTS
4
Page 5
Read /
Min
Max
Default
Apply factory settings to the
Auto reset
Auto reset
AXION
AUTO_LOCK
AUTO_TAKE
Automatic Take after an input change
AUTO_STEPBACK
Automatic preset toggle after a TAKE
Group Name CmdRespDescription
DIESE # # Request the retrieval of all the variables Rd/Wr 0 1 0
SYSTEM
CONTROLS
READY * * Ready Device Flag Rd 0 1 0
DEV ? DEV MMS device type Rd 92 92 92 92 = SMX-100
UPDATER yU yU Device reboot for update Rd/Wr 0 255 0 1 then 254 => Reboot
FACTORYRESET YR YR
POSMEMORYRESET YE YE Erase stored image settings Rd/Wr 0 1 0
CSTORE YS YS
COPKIND CK CK Kind of slow in-progress operation Rd 0 6 0
COPPROGRESS CP CP Progress percent of the slow operation Rd 0 100 0 Percent : 0 to 100%
PRESET_MATRIX_MGMT CR CR
yA yA Device is driven by Orchestra Rd/Wr 0 1 0
YL YL Forbide the use of a signal-less input Rd/Wr 0 1 1
YT YT
Ys Ys
FREEZE_MODE Ym Ym Input freeze mode Rd/Wr 0 1 0
device( except image settings )
FLASH memory writing in progess. Do
not power off
Preset management in matrix mode
from the front panel
Write
Value
value
Rd/Wr 0 1 0
Rd 0 1 0
Rd/Wr 0 3 0
Rd/Wr 0 1 0
Rd/Wr 0 1 0
Values Index #1 Index #2
value
0= Initialization in progress
1 = Ready
0 = Free
1 = Flash writing in progress
0 = No lock
1 = Locked menu
2 = Locked front panel
0 = None
1 = Auto centering
2 = Auto setting
3 = StandBy
4 = Picture recording
5 = Reset to default factory setting
6 = Reset User settings
0 = Preset management for both
outputs
1 = Preset management for current
output
2 = Preset management for output 1
3 = Preset management for output 2
0 = Device is not driven by ORC-50
1 = Device is driven by Orc-50
0 = Signal less input can be selected
1 = Signal less input can not be
selected
0 = AUTO-TAKE Disable
1 = AUTO-TAKE Enable
0 = AUTO- PRESET-TOGGLE Disable
1 = AUTO- PRESET-TOGGLE Enable
0 = Freeze by input
1 = Freeze all inputs
5
Page 6
Read /
Min
Max
Default
wS wS
wQ wQ
wN wN
wF wF
wR wR
wC wC
Group Name CmdRespDescription
Back-up input when an input loose its
signal
Disable the the black fiilng of the
bakgrounfd live layer
Fill PIP with black depending on the
aspect ratio
Disable Frame and Ids on the preview
output
Standby mode Rd/Wr 0 1 0
Request for standby or wake up Rd/Wr 0 1 0
Message to wake-up an output display
device ( 50 characters)
Message to send an output display
device to sleep ( 50 characters)
Output display device UART speed Rd/Wr 0 3 2
Rd/Wr 0 4 0
STANDBY
VERSION
FRAME_ALERT Yf Yf
TRANSPARENT_BACKGROUND Yt Yt
BLACK_FILL bF bF
DISABLE_ID bI bI
STDBYSTATUS
STDBYREQUEST
STDBYPROJ_ON
STDBYPROJ_OFF
STDBYPROJ_RATE
STDBYPROJ_CTRL
VERI1 xi xi Byte 0 and 1 of the device ID Rd 0 655350 ex : AAAA
VERI2 xj xj Byte 2 and 3 of the device ID Rd 0 655350 ex : AAAA
VERI3 xk xk Byte 4 and 5 of the device ID Rd 0 655350 ex : AAAA
VERI4 xl xl Byte 6 and 7 of the device ID Rd 0 655350 ex : AAAA
Write
Value
value
Rd/Wr 0 12 0
Rd/Wr 0 1 1
Rd/Wr 0 1 0
Rd/Wr 0 1 0
Rd/Wr 0 255 0 min = 0 max = 49
Rd/Wr 0 255 0 min = 0 max = 49
Values Index #1 Index #2
value
0 = No input
1 = Input1
2 = Input2
3 = Input3
4 = Input4
5 = Input5
6 = Input6
9 = Input9
10 = Input10
11 = Input11
12 = Input12
0 = use BLACK_FILL
1 = Disable black filling only for
background
0 = Disable black filling
1 = Enable black filling
0 = Normal mode
1 = Standby mode
0 = Wake up
1 = Standby
0 = 1200bauds
1 = 2400bauds
2 = 9600bauds
3 = 19200bauds
0 = No request
1 = Wake up request
2 = Standby request
3 = Clear Wake up message
4 = Clear standby message
6
Page 7
Read /
Min
Max
Default
Auto
Auto
Group Name CmdRespDescription
Checksum/version of the
programmable components
-setting request for all the inputs Rd/Wr 0 1 0
-setting request for the specified
input
INPUT
VERK xK xK
VERV xV xV Variable set version Rd 0 6553542
VERUPD xU xU Updater version Rd 0 655350
OPT yo yo Detected options Rd 0 655350
REV xR xR Moher board revision Rd 0 255 0
IN_AUTOSET_ALL Ia Ia
IN_AUTOSET Ii Ii
Write
Value
value
value
Rd/Wr 0 655350
Rd/Wr 0 1 0
Values Index #1 Index #2
0 = Number of
programmables
components
1 = Main micro-
bit 0 = Lan Module
bit 1 = SDI In 1 board (SDI 1 and 2)
bit 2 = Recording board
bit 3 = CF Caecina
bit 4 = CF Fannia
bit 5 = CF Thrasea
bit 6 = SDI In 2 board (SDI 3 and 4)
bit 7 = Audio Evolution
bit 8 = HDCP DVI In Evolution
IN_SD_STD iS iS Decoded video standard Rd/Wr 0 7 0
IN_SD_STA iV iV Video Signal stability Rd/Wr 0 1 1
IN_SYNCHRONIZED iY iY VIS Synchronisation group Rd/Wr 0 3 0
IN_HDCP_ENABLE iH iH
IN_HDCP_CABLE_LEN iC iC Lenght of an DVI input cable Rd/Wr 0 2 0
KEYING IN_KEYING_TYPE KT KT Keying type Rd/Wr 0 4 0
Enable/disable the HDCP support of a
DVI input
Write
Value
value
Rd/Wr 0 1 1
Values Index #1 Index #2
value
0 = Auto
1 = NTSC (M,J)
2 = PAL (BDGHIN)
3 = PAL (M)
4 = PAL (N-Combination)
5 = NTSC 4.43
6 = SECAM
7 = PAL 60
0 = Stable Source ( DVD )
1 = VCR Source ( Video cassette
recorder )
0 = Does not belong to any VIS Group
1 = Groupe VIS 1 group for analog
input
2 = Groupe VIS 2 group for analog
input
3 = Groupe VIS 3 group for analog
input
0 = Less than 10 meter cable length
1 = 5 to 20 meters cable length
2 = More than 15 meters cable length
IN_KEYING_LUMA_HIGH_LEVEL KM KM Maximum luma level Rd/Wr 0 255 255
IN_KEYING_DSK_ALPHA KA KA Brightness of DSK background Rd/Wr 0 255 64
IN_KEYING_INVERT KI KI Invert keying area Rd/Wr 0 1 0
IN_KEYING_GRAB_ENABLE Kg Kg
IN_KEYING_GRAB_GET Kc Kc
IN_KEYING_GRAB_H Kh Kh Horizontal position of the grabber Rd/Wr 0 6553532768 Precent of OSCREEN_UTIL_V
IN_KEYING_GRAB_V Kv Kv Vertical position of the grabber Rd/Wr 0 6553532768
mode
Capture the coolor selected by the
grabber and apply the settings
SET_ASPECT_RATIO_IN si si Input image aspect ratio Rd/Wr 0 4 0
SET_ASPECT_RATIO_OUT so so Output image aspect ratio Rd/Wr 0 3 1
SET_OVER_SCAN sO sO input image Overscan/Underscan Rd/Wr 0 1 1
SET_FORCE_4_3 SF SF
Force the aspect ratio of PAL/NTSC
input to 4/3
Write
Value
value
Rd/Wr 0 1 1 1 = forced
Values Index #1 Index #2
value
0 = 4/3 Fullscreen
1 = 4/3 with 16/9 content + black
stripes
2 = 4/3 with 2.35 content + black
stripes
3 = 4/3 with 16/9 content without black
stripes
4 = 19/9 with 4/3 content + black
stripes
0 = Distorted, input aspect ratio not
preserved
1 = Not distorted, black bands added
2 = Not distorted, no black bands
added
3 = Not distorted and no scaling
OBACKCOLORHUE OG OG Output background hue Rd/Wr 0 240 160
OBACKCOLORSAT OJ OJ Output background saturation Rd/Wr 0 240 0
OBACKCOLORLUMA OI OI Output background brightness Rd/Wr 0 240 0
Write
Value
value
Values Index #1 Index #2
value
0 = Black
1 = Navy blue
2 = Blue
3 = Green Blue
4 = Water Blue
5 = Turquoise blue
6 = Dark green
7 = Green
8 = Lime
9 = Light green
10 = Dark red
11 = Red
12 = Tomato red
13 = Bordeaux
14 = Brown
15 = Chocolate
16 = Orange
17 = Gold
18 = Yellow
19 = Indigo blue
20 = Purple
21 = Light red
22 = Fuchsia
23 = Salmon
24 = Rose
25 = Olive reen
26 = Grey
27 = Silver
28 = Lavender blue
29 = Beige
30 = Azur
31 = White
32 = Custom
0 = Main output
1 = Preview output
0 = Main output
1 = Preview output
0 = Main output
1 = Preview output
0 = Main output
1 = Preview output
37
Page 38
Read /
Min
Max
Default
Xr Xr
Group Name CmdRespDescription
OPATTERN OP OP Output test pattern Rd/Wr 0 8 0
OBLACK OB OB Output black control Rd/Wr 0 1 0
OUTIL_H OH OH Output H size Rd 0 655351600 Unit = pixels
OUTIL_V OV OV Output V size Rd 0 655351200 Unit = pixels
OFIELDRATE OT OT Output frame frequency Rd 100 100006000 Unit = 1/100Hz
OIMAGE_OVERSCAN OO OO Image Overscan / Underscan Rd/Wr 0 1 0
OSETDETECTHDCP Oh Oh
OISHDCP On On Output HDCP status Rd 0 1 0
OSYNCOUTPUT Om Om
REFERENCEREFREQUEST
Enable/disable the Output HDCP
detection
Output 2 copies the format and rate of
output 1
Framelock source requested by user Rd/Wr 0 15 0
Write
Value
value
Rd/Wr 0 4 1
Rd/Wr 0 1 0
Values Index #1 Index #2
value
0 = No pattern
1 = Vertical Grey Scale
2 = Horizontal Grey Scale
3 = Vertical Color Bar
4 = Horizontal Color Bar
5 = Grid
6 = SMPTE
7 = Burst
8 = Centering
0 = Normal output
1 = Black output
0 = Analog input 1 as reference
1 = Analog input 2 as reference
2 = Analog input 3 as reference
3 = Analog input 4 as reference
4 = Analog input 5 as reference
5 = Analog input 6 as reference
8 = DVI 1 input as reference
9 = DVI 2 input as reference
10 = SDI 1 input as reference
11 = SDI 2 input as reference
14 = Back End 1 as reference
15 = Back End 2 as reference
0 = Main output
1 = Preview output
0 = Main output
1 = Preview output
0 = Main output
1 = Preview output
0 = Main output
1 = Preview output
0 = Main output
1 = Preview output
0 = Main output
1 = Preview output
0 = Main output
1 = Preview output
0 = Main output
1 = Preview output
0 = Main output
1 = Preview output
38
Page 39
Read /
Min
Max
Default
Xe Xe
Xm Xm
Xc Xc
Xt Xt
Xl Xl
Auto reset
Auto reset
1 = IP address mid
2 = IP address mid
3 = IP address low
Group Name CmdRespDescription
LAN
REFCURRENTREQUEST
REFMODE
REFCURRENTMODE
REFFREQ
REFLOCKSTATUS
LANENABLE ne ne LAN enable Rd/Wr 0 1 0
LANRESET nr nr LAN factory parameters reset Rd/Wr 0 1 0
LANSTORE ns ns LAN parameters update Rd/Wr 0 1 0
LANIP nw nw LAN devices addresses Rd/Wr 0 255 192 IP : 0 to 255
Current Frame Lock source Rd/Wr 0 15 0
Follow mode requested by user Rd/Wr 0 5 0
Current follow mode Rd/Wr 0 5 0
Frame rate of the reference signal Rd 0 655350 Unit = 1/100Hz
Framelock locked status Rd 0 1 0 1 = locked
Write
Value
value
Values Index #1 Index #2
value
0 = Analog input 1 as reference
1 = Analog input 2 as reference
2 = Analog input 3 as reference
3 = Analog input 4 as reference
4 = Analog input 5 as reference
5 = Analog input 6 as reference
8 = DVI 1 input as reference
9 = DVI 2 input as reference
10 = SDI 1 input as reference
11 = SDI 2 input as reference
14 = Back End 1 as reference
15 = Back End 2 as reference
0 = Internal
1 = Follow x1/2
2 = Follow x1
3 = Follow x2
4 = Follow x3
5 = Asynchronous Follow
0 = Internal
1 = Follow x1/2
2 = Follow x1
3 = Follow x2
4 = Follow x3
5 = Asynchronous Follow
0 = Enable RS232 ( disable LAN )
1 = Enable LAN ( disable RS232 )
0 = Main output
1 = Preview output
0 = Main output
1 = Preview output
0 = Main output
1 = Preview output
0 = Main output
1 = Preview output
0 = Main output
1 = Preview output
0 = Device
1 = Remote
2 = Gateway
0 = IP address
high byte
high byte
low high byte
LANPORT np np LAN port numbers Rd/Wr 0 6553510500
LANNETMASK nk nk LAN netmask Rd/Wr 0 24 8 Number of 0bits from the right
39
Local port : 10000 à 10999
Remote port : 0 à 65500
0 = Device
1 = Remote
2 = Gateway
byte
Page 40
Read /
Min
Max
Default
AUDIO
AUDIO_INPUT_MODE
Af Af Audio mode
Group Name CmdRespDescription
LANPROTOCOL nt nt LAN protocol Rd/Wr 0 1 1
EDID_FORMAT EF EF EDID preferred format Rd/Wr 0 21 0
EDID
EDID_RATE ER ER EDID preferred frame frequency Rd/Wr 0 5 0
EDID_REQUEST ES ES Request for an EDID Rd/Wr 0 2 0
0 = Main output
1 = Preview output
0 = Main output
1 = Preview output
0 = Main output
1 = Preview output
0 = Main output
1 = Preview output
41
Page 42
Read /
Min
Max
Default
AUDIO_SDI_CHAN_LEFT
Ac Ac
AUDIO_SDI_CHAN_RIGHT
AC AC
AUDIO_DESEMB
As As
Group Name CmdRespDescription
END_LOCKED
ID of the Sdi channel to desembed for
left channel
ID of the Sdi channel to desembed for
right channel
Information of audio channel presence
for SDI inputs
Write
Value
value
Rd/Wr 0 15 0
Rd/Wr 0 15 1
Rd 0 1 1 1 : Locked
Values Index #1 Index #2
value
0 = Group A – Channel 1
1 = Group A – Channel 2
2 = Group A – Channel 3
3 = Group A – Channel 4
4 = Group B – Channel 1
5 = Group B – Channel 2
6 = Group B – Channel 3
7 = Group B – Channel 4
8 = Group C – Channel 1
9 = Group C – Channel 2
10 = Group C – Channel 3
11 = Group C – Channel 4
12 = Group D – Channel 1
13 = Group D – Channel 2
14 = Group D – Channel 3
15 = Group D – Channel 4
0 = Group A – Channel 1
1 = Group A – Channel 2
2 = Group A – Channel 3
3 = Group A – Channel 4
4 = Group B – Channel 1
5 = Group B – Channel 2
6 = Group B – Channel 3
7 = Group B – Channel 4
8 = Group C – Channel 1
9 = Group C – Channel 2
10 = Group C – Channel 3
11 = Group C – Channel 4
12 = Group D – Channel 1
13 = Group D – Channel 2
14 = Group D – Channel 3
15 = Group D – Channel 4