Ross CARBONITE GVG10 User manual

Supported Commands
The switcher can be controlled from a remote device or computer via GV Grass Valley®GVG100 commands.
These commands can either be sent to the switcher over a serial or Telnet connection.
Sending GVG100 LUA Commands to the Switcher
The switcher accepts direct injection of GVG100 commands using LUA via a Telnet connection. This allows you
to perform various functions such as querying the switcher for the state of buttons, or sending commands to
the switcher, such as transitioning a key.
To Set the Switcher to Editor Mode
Tip: You can quickly turn off editor mode by pressing and holding the MENU button and pressing PERS.
1. Press MENU >Pers.
2. Use the Editor knob to select On to allow the switcher to be controlled by an external editor.
GVG100 Command Modes
The switcher supports two modes of operation, a Legacy mode for basic GVG100 commands, and a Ross mode
for additional Ross-specific extensions to the protocol.
•Legacy Mode — allows basic control over a single ME (ME 1) and the first two keyers (Key 1 and Key 2) on
that ME
•Ross Mode — allows advanced control over multiple MEs, keyers, and aux buses.
To Send GVG Commands to the Switcher
1. Create a connection to the switcher.
•Telnet — Create a Telnet connection to the switcher on port 2100. The default IP address of the switcher
is 192.168.0.123.
•Serial — Open a serial connection to the switcher editor port. Refer to the GV Grass Valley®GVG100 setup
sheet for information on connecting to an editor over a serial connection.
2. At the gvg100> prompt, enter the commands you want to run.
•injectGVG100command("") — Sends a GVG100 command to the switcher.
•print() — Prints the value of any arguments as strings, or prints "nil" if an argument is not a string.
•printhelp() — Prints detailed help on all available commands.
•printhex() — Prints the value of number arguments as hex strings. If the argument is not a number
then "nan" is printed. If the argument is not an unsigned integer (a float or a negative number) then
"notUInt" is printed.
•setGVG100legacymode() — Switches between GVG100 legacy mode (true) and Ross mode (false)
command interpretation.
Example Commands
•setGVGlegacymode(false) — sets Ross Mode.
4802DR-401--05
©2021 Ross Video Limited. Ross®, MiniME,and any related marks are trademarks or registered trademarks of Ross Video Limited. All other trademarks are the property of their respective companies. PATENTS ISSUED and PENDING. All rights reserved. No
part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, mechanical, photocopying, recording or otherwise, without the prior written permission of Ross Video. While every precaution has been
taken in the preparation of this document, Ross Video assumes no responsibility for errors or omissions. Neither is any liability assumed for damages resulting from the use of the information contained herein.
GVG100

•injectGVG100command("0501CC501405") — select BKGD and keys 2 and 3 for the Next Trans of ME 2,
with a rate of 45.
•injectGVG100command("0300FB1F") — perform fade to black.
Supported GVG100 Commands
The switcher supports a number of GVG100 commands. The exact commands and how the switcher reacts to
the commands is outlined in the following tables.
Keep the following in mind when controlling the switcher via GVG100 commands:
• When performing a memory store or recall, the bus is set using the effects address, where 00 is all buses,
and specific buses are set using the effects address as a bitfield. For example an effects address of 02 (0000
0010) is ME 2, and 13 (0001 0011) is MEs 1, 2 and MiniME™3.
• When using Legacy mode, the effects address of 1 means keyer 1 and effects address of 0 means keyer 2.
Using this interpretation, only keyers 1 and 2 of ME 1 are accessible. Only ME 1 is accessible.
• The table of supported GVG100 commands shows whether the command uses the ME bits, the ME and keyer
bits, or neither. This only applies in Ross mode.
Table 1: Carbonite Effects Addresses
Bits for Memory CommandsBits for Non-Memory Commands (Hex)Bus
0000 00010000 0000 (0x00)ME 1
0000 00100000 0001 (0x01)ME 2
0000 01000000 0010 (0x02)MiniME™1
0000 10000000 0011 (0x03)MiniME™2
0001 00000000 0100 (0x04)MiniME™3
0010 00000000 0101 (0x05)MiniME™4
0100 00000000 0110 (0x06)MultiScreen 1
1000 00000000 0111 (0x07)MultiScreen 2
--0000 0000 (0x00)Key 1
--0001 0000 (0x10)Key 2
--0010 0000 (0x20)Key 3
--0011 0000 (0x30)Key 4
--1000 0000 (0x80)Aux 1
--1000 0001 (0x81)Aux 2
--1000 0010 (0x82)Aux 3
--1000 0011 (0x83)Aux 4
--1000 0100 (0x84)Aux 5
--1000 0101 (0x85)Aux 6
--1000 0110 (0x86)Aux 7
--1000 0111 (0x87)Aux 8
2

Table 2: Carbonite Video Source Mapping
SourceMap-To
Black0
Input BNC 1-241-24
Matte100
Media-Store channels 1-4110-113
Program150
Preview151
Clean Feed152
ME 1 Program155
ME 1 Preview156
ME 1 Clean Feed157
ME 2 Program160
ME 2 Preview161
ME 2 Clean Feed162
MiniME™1210
MiniME™2211
MiniME™3212
MiniME™4213
Table 3: CrossOver®12 Video Source Mapping
SourceMap-To
Black0
Input BNC 1-81-8
Matte10
Input BNC 9-1211-14
Media-Store channels 1-217-18
Program (Aux only)19
Preview (Aux only)20
Clean Feed (Aux only)21
Chroma Key Alpha (Aux only)22
Table 4: CrossOver®6 Video Source Mapping
SourceMap-To
Black0
3

SourceMap-To
Input BNC 1-41-4
--5
Matte6
Input BNC 5-67-8
Media-Store channels 1-29-10
Program (Aux only)11
Preview (Aux only)12
Clean Feed (Aux only)13
Chroma Key Alpha (Aux only)14
Note: For the following table, ME can be an ME, a MiniME™, a MultiScreen, or an Aux bus.
Table 5: Supported GVG100 Commands
Data / NotesByte CodeLengthME / KeyerName
--412MERead ME Program Bus
--422MERead ME Preset Bus
--43 / 442KeyerRead Keyer Bus
An invalid xpt request returns a
protocol error.
<xpt>C13MEWrite ME Program Bus
An invalid xpt request returns a
protocol error.
<xpt>C23MEWrite ME Preset Bus
An invalid xpt request returns a
protocol error.
<xpt>C3 / C43KeyerWrite Keyer Bus
<control>453--Read Analog
<control> <lsb> <msb>C55--Write Analog
--46 / 473ME / KeyerRead Light On / Off
<lamp>C6 / C73ME / KeyerWrite Lights On / Off
--482MERead Wipe Pattern
Valid wipes are 0-9, as per the
wipe pattern buttons. An invalid
wipe number returns a protocol
error.
<wipe>C83MEWrite Wipe Pattern
--4A2MERead Transition Mode
Last 5 bits used; bit 0:key 2, bit
1:key 1, bit 2:BKGD, bit 3:key 3, bit
4:key 4.
<mode>CA3MEWrite Transition Mode
--4C2MERead ME Auto Transition Rate
4D2KeyerRead Keyer Mix Rate
4

Data / NotesByte CodeLengthME / KeyerName
*Currently ME Specific.
--7D2ME*Read Fade to Black Rate
**CC5MEWrite ME Auto Transition Rate
**CD5KeyerWrite Keyer Mix Rate
*Currently not Supported. Fade
to Black = Transition Rate
**FD5--*Write Fade to Black Rate
Supports memories 0-255. All
buses are selected with 00 for the
effects address.
<mem#>DA3MELearn Into Memory
Supports memories 0-255. All
buses are selected with 00 for the
effects address.
<mem#>DB3MERecall From Memory
--6C2--Read Software Version
Field Mark Only.
--6D2--Read Field Mode
Field Mark Only.0 or 1ED3--Write Field Mode
*Data byte is unused.D0*F23--All Stop
0783--Read Lamp Status
Included for GVG100 spec
completeness only.
--F813--Write Lamp Status
<button>FB3AnyWrite Button Press
Table 6: **Transition Rates
NotesBitData Byte
0=select elements, 1=select elements and perform transition71
4=select key 1, 5=select key 2, 6=select BKGD4-6
binary coded decimal (meaning valid values are b0-b1001, or 0-9)0-3
unused
6-72
4=select key 3, 5=select key 44-5
binary coded decimal (meaning valid values are b0-b1001, or 0-9)0-3
unused
4-73
binary coded decimal (meaning valid values are b0-b1001, or 0-9)0-3
Table 7: Supported Lamps
NotesBytesME / KeyerName
Trying to turn off results in a protocol error.0x00-0x09MEProgram Bus 0-9
Trying to turn off results in a protocol error.0x0AMEProgram Bus On-Air
0x0BMEAuto Trans
5

NotesBytesME / KeyerName
0x0CKeyer/MEKey Auto
0x0DKeyer/MEKey Cut
0x0EMEWipe (transition)
0x0FMEDissolve (transition)
Trying to turn off results in a protocol error.0x10-0x19MEPreset Bus 0-9
Trying to turn off results in a protocol error.0x1AMEPreset Bus On-Air
Always on; trying to turn off results in a
protocol error.
0x1BMEAspect On
Always on; trying to turn off results in a
protocol error.
0x1CMEPositioner On
0x1DMEReverse Wipe
Always true; we don't have DSKs – all our
keyers show on preview. Trying to turn off
results in a protocol error.
0x1EKeyerDSK Preview
0x1F--Fade to Black
Trying to turn off results in a protocol error.0x20-0x29Keyer/MEKey Bus 0-9
Trying to turn off results in a protocol error.0x2AKeyerKey Bus On-Air
Always true; trying to turn off results in a
protocol error.
0x2FKeyerKey Video Fill
Trying to turn off results in a protocol error.0x30-0x39MEWipe Type
DSKs; Trying to turn off results in a protocol
error.
0x40Keyer/MEKey Invert
DSKs; Trying to turn off results in a protocol
error.
0x41KeyerKey Mask
DSKs; Trying to turn off results in a protocol
error.
0x42KeyerKey AutoKey
DSKs; Trying to turn off results in a protocol
error.
0x43KeyerKey SelfKey
Trying to turn off results in a protocol error.0x44KeyerKey Invert
Trying to turn off results in a protocol error.0x45KeyerKey Mask
Toggles between memory mode and pattern
mode (are we changing patterns, or saving /
loading memories?).
0x47--Memory Mode Toggle
Trying to turn off results in a protocol error.0x48--Next Trans is Background
Trying to turn off results in a protocol error.0x49--Next Trans is Key 1
Trying to turn off results in a protocol error.0x4AMECut
Trying to turn off results in a protocol error.0x4CKeyer/MEKey Self Key
Trying to turn off results in a protocol error.0x4DKeyer/MEKey Auto Key
6

NotesBytesME / KeyerName
Trying to turn off results in a protocol error.0x4EKeyer/MEKey Chroma Key
Editor control is always enabled; Trying to
turn off results in a protocol error.
0x4F--Editor Enable
0x52Keyer/MEKey Active
Table 8: Supported Buttons
NotesBytesME / KeyerName
Trying to turn off results in a protocol error.0x00-0x09MEProgram Bus 0-9
0x0BMEAuto Trans
DSKs0x0CKeyerKey Auto
DSKs0x0DKeyerKey Cut
0x0EMEWipe (transition)
0x0FMEDissolve (transition)
0x10-0x19MEPreset Bus 0-9
Always on; button press has no effect.0x1BMEAspect On
Always on; button press has no effect.0x1CMEPositioner On
Doubles as “ memory store / recall toggle ”
when in memory mode.
0x1DMEReverse Wipe
Always true; we don't have DSKs – all our
keyers show on preview.
0x1EKeyerDSK Preview
0x1F--Fade to Black
0x20-0x29KeyerKey Bus 0-9
Always true.0x2FKeyerKey Video Fill
0x30-0x39MEWipe Type
DSKs0x40KeyerKey Invert
DSKs0x41KeyerKey Mask
DSKs0x42KeyerKey AutoKey
DSKs0x43KeyerKey SelfKey
0x44KeyerKey Invert
0x45KeyerKey Mask
Toggles between memory mode and pattern
mode (are we changing patterns, or saving /
loading memories?).
0x47--Memory Mode Toggle
0x48--Next Trans is Background
0x49--Next Trans is Key 1
0x4AMECut
7

NotesBytesME / KeyerName
0x4CKeyerKey Self Key
0x4DKeyerKey Auto Key
0x4EKeyerKey Chroma Key
Editor control is always enabled.0x4F--Editor Enable
8