Carbonite/Graphite Commands

The switcher can be controlled from a remote editor or computer via RossTalk commands. These commands can be sent to the switcher over an ethernet connection.

Sending RossTalk Commands to Carbonite

Carbonite accepts RossTalk commands over ethernet on port 7788. This allows you to perform various functions such as triggering a GPI, or sending commands to the switcher, such as transitioning a key.

Tip: Carbonite automatically accepts RossTalk commands on port 7788.

To Send RossTalk Commands to Carbonite

Note: Each command should be terminated by a carriage return and a line feed (CR/LF).

Commands can be sent directly through a telnet connection or any other application that can send ASCII commands.

  1. Create a network connection to the switcher on port 7788. The default IP address of the switcher is 192.168.0.123.
    Tip: If you are using multiple RossTalk connections, it is recommended that you increment the port number for each device.
  2. At the prompt, enter the commands you want to send.

Carbonite Supported RossTalk Commands

The switcher supports a number of RossTalk commands. The exact commands and how the switcher reacts to the commands is outlined in the following table.

Important: Carbonite, Carbonite eXtreme, Carbonite Black, Carbonite Solo, Mosaic, and UltraChromeHR number MEs as ME 1, ME 2, and ME 3 with the highest number ME being the program ME. Carbonite Ultra numbers MEs as ME 2, ME 1, ME P/P with ME P/P being the program ME. For example, KEYAUTO ME:3:4 triggers an auto transition of key 4 on ME 3 on Carbonite Black, but KEYAUTO ME:P/P:4 performs the same action on Ultra.
Note: All commands are case sensitive.

In the following commands, the ME-source is replaced with the bus source.

  • ME — use ME
  • MiniME™ — use MME
  • MultiScreen — use MSC
  • Canvas — use MSC
  • Tile — use MME
Table 1. RossTalk Commands
Command Description
CC bcc Executes custom control (cc) on bank (b). For example, CC 1:05 triggers custom control 5 on bank 1.
CKINIT chromakey-number Initialize chroma key engine (chromakey-number). For example, CKINIT 2 initializes chroma key engine 2.
CLIPEJECT Ejects the current clip from the clip player.
CLIPLOAD clip-name Loads the clip (clip-name) into the clip player. For example, CLIPLOAD trees loads the clip named trees into the clip player.
CLIPLOOPOFF Turns looping off for the clip player.
CLIPLOOPON Turns looping on for the clip player.
CLIPPAUSE Pauses the current clip in the clip player.
CLIPPLAY Plays the current clip loaded in the clip player.
DOWN sequencer Moves the selection of the next item to be run down one event in the sequence loaded in Sequencer (sequencer). For example, DOWN 4 moves the green highlight down an event on the sequence loaded into Sequencer 3.
FOCUS sequencer:event Move the selection of the next item to be run to event number (event) loaded in Sequencer (sequencer). For example, FOCUS 3:2 moves the green highlight to event number 2 on the sequence loaded into Sequencer 3.
FTB Performs a fade-to-black transition.
GPI xx Performs the action assigned to the GPI input xx. If the GPI is assigned as an output, no action is performed. For example, GPI 04 triggers GPI input 4.
HELP Prints a list of the supported commands.
KEYAUTO ME-source:ME-number:keyer:ON/OFF Performs an auto transition of keyer number (keyer) on ME (ME-source) of number (ME-number) on-air (ON), off-air (OFF), or toggle (omit :ON/OFF). For example, KEYAUTO ME:1:4 triggers an auto transition of key 4 on ME 1; and KEYAUTO ME:2:1:OFF triggers an auto transition of key 1 on ME 2 only if the key is on-air.
KEYAUTOOFF ME-source:ME-number:keyer Performs an auto transition of keyer number (keyer) on ME (ME-source) of number (ME-number) to transition the key off-air. For example, if key 4 is on-air, KEYAUTOOFF ME:1:4 triggers an auto transition of key 4 on ME 1. If the key is already off-air, no transition is performed.
KEYAUTOON ME-source:ME-number:keyer Performs an auto transition of keyer number (keyer) on ME (ME-source) of number (ME-number) to transition the key on-air. For example, if key 4 is off-air, KEYAUTOON ME:1:4 triggers an auto transition of key 4 on ME 1. If the key is already on-air, no transition is performed.
KEYCUT ME-source:ME-number:keyer:ON/OFF Performs a cut of keyer number (keyer) on ME (ME-source) of number (ME-number) on-air (ON), off-air (OFF), or toggle (omit :ON/OFF). For example, KEYCUT MME:2:1 triggers a cut of key 1 on MiniME™ output 2; and KEYCUT ME:1:3:ON triggers an cut of key 3 on ME 1 only if the key is off-air.
KEYCUTOFF ME-source:ME-number:keyer Performs a cut of keyer number (keyer) on ME (ME-source) of number (ME-number) to transition the key off-air. For example, if key 1 is on-air, KEYCUTOFF MME:2:1 triggers a cut of key 1 on MiniME™ output 2. If the key is already off-air, no transition is performed.
KEYCUTON ME-source:ME-number:keyer Performs a cut of keyer number (keyer) on ME (ME-source) of number (ME-number) to transition the key on-air. For example, if key 1 is off-air, KEYCUTON MME:2:1 triggers a cut of key 1 on MiniME™ output 2. If the key is already on-air, no transition is performed.
KEYMODE ME-source:ME-number:keyer:mode Sets the key mode (mode) to NORMAL, ADDITIVE, or FULL on ME (ME-source) of number (ME-number). For example, KEYMODE ME:2:1:NORMAL uses the shaped/unshaped setting from the key setup for key 1 on ME output 2.
LOADSET name Performs a recall of a set by name (name). For example, LOADSET set1 loads set1 onto the switcher from the USB. Unlike saving or loading a set from the control panel, RossTalk does not support saving or loading of panel personality settings with the setup. Settings such as color schemes or user button assignments are not included with the set.
MEAUTO ME-source:ME-number Performs an auto transition on ME (ME-source) of number (ME-number). The elements included with the transition are set in the next transition area of the switcher. For example, MEAUTO MSC:2 triggers an auto transition on MultiScreen channel 2.
MECUT ME-source:ME-number Performs a cut on ME (ME-source) of number (ME-number). The elements included with the transition are set in the next transition area of the switcher. For example, MECUT ME:1 triggers a cut on ME 1.
MEM bm:ME-source :ME-number Performs a recall of memory (m) on bank (b) on ME (ME-source) of number (ME-number). For example, MEM 19:ME:2:MME:1 recalls memory 9 on bank 1 of ME 2 and MiniME™ output 1.
MEMSAVE bm:ME-source :ME-number Performs a store of memory (m) on bank (b) on ME (ME-source) of number (ME-number). For example, MEMSAVE 19:ME:2:MME:1 stores memory 9 on bank 1 of ME 2 and MiniME™ output 1.
MNEM source:new-name Sets a new mnemonic name (new-name) for a video source (source). For example, MNEM IN:6:CAM 1 sets the mnemonic name for input 6 to CAM 1.
MS channel:location:media-ID Loads a still of animation of ID number (media-ID) from the USB (1) or internal (0) cache (location) into Media​-Store channel number (channel). For example, MS 1:0:002 loads the AnnaCK still (002) from the internal cache (0) to Media​-Store channel 1. If you are using a Mosaic, channels are numbered 101-136.
MVBOX VP|OP:MultiViewer:box:source Selects a video source (source) in a box of number (box) for the Video Processor MultiViewer (VP) or I/O MultiViewer (OP) number MultiViewer. For example, MVBOX VP:1:5:IN:6 selects input 6 in box 5 of Video Processor MultiViewer channel 1. Aux buses can also be selected as sources.
NEXT sequencer Runs the currently selected item in the sequence loaded into Sequencer (sequencer) and advance the current selection to the next item in the sequence. For example, NEXT 2 runs the selected command in Sequencer 3.
SAVESET name Performs a store of a set by name (name). For example, SAVESET set1 stores the current switcher settings to set1 on the USB. Unlike saving or loading a set from the control panel, RossTalk does not support saving or loading of panel personality settings with the setup. Settings such as color schemes or user button assignments are not included with the set.
SEQI sequencer:seq Loads the sequence (seq) into Sequencer (sequencer). For example, SEQI 3:15 loads sequence 15 into Sequencer 3.
SEQO sequencer Unloads the sequence from Sequencer (sequencer). For example, SEQO 1 unloads any sequence from Sequencer 1.
TRANSINCL ME-source:ME-number:incl:incl:incl Sets the next transition area on ME (ME-source) of number (ME-number), to include the background (B) and/or keys (incl). For example, TRANSINCL ME:2:B:2:3 configures the next transition area for ME 2 with BKGD, KEY 2, and KEY 3 selected. Note that any existing selections are lost.
TRANSRATE ME-source:ME-number:rate Sets the transition rate (rate), in frames, on ME (ME-source) of number (ME-number). For example, TRANSRATE ME:1:15 sets the ME transition rate for ME 1 to 15 frames.
TRANSTYPE ME-source:ME-number:type Sets the transition type (type), see below, on ME (ME-source) of number (ME-number). For example, TRANSTYPE MSC:2:DISS sets the transition type for MultiScreen channel 2 to DISS.
  • Dissolve — DISS
  • DVE — DVE
  • Media Wipe — MEDIA
  • Wipe — WIPE
UP sequencer Moves the selection of the next item to be run up one event in the sequence loaded in Sequencer (sequencer). For example, UP 1 moves the green highlight up an event on the sequence loaded into Sequencer 1.
XPT vid-dest:vid-source Selects the video source (vid-source) on the bus (vid-dest). For example, XPT ME:2:PGM:IN:6 selects input 6 on the Program bus of ME 2; XPT ME:3:KEY:2:IN:20 selects input 20 on Key 2 of ME3; XPT AUX:2:ME:1:CLN selects the ME 1 clean feed on Aux bus 2. Refer to the information after this table for a list of sources and destinations.

Possible video destinations (vid-dest):

  • Aux Bus — AUX:aux-number
  • Key — ME:ME-number:KEY:key-number
  • MiniME™ — MME:ME-number
  • Preset — ME:ME-number:PST
  • Program — ME:ME-number:PGM

Possible video sources (vid-source):

  • Aux Bus — AUX:aux-number
  • Black — BK (vid-source only)
  • Chroma Key Alpha — CKA:chroma key number (UltraChromeHR, Carbonite Black v14.0 or higher only, or Carbonite Ultra)
  • Chroma Key Video — CK:chroma key number (UltraChromeHR, Carbonite Black v14.0 or higher only, or Carbonite Ultra)
  • Clean Feed — CLN
  • Clip Player — CLIP
  • Input Source — IN:input-number
    Tip: On Graphite and the CBF-113 (Carbonite Solo 13) the HDMI™ input is IN:13 and on the CBF-109 (Carbonite Solo) the HDMI™ inputs are IN:7, IN:8, and IN:9 for HDMI™ inputs 1-3 respectively.
  • Matte Color — BG (vid-source only)
  • ME Background — ME:ME-number:BKGD
  • ME Clean — ME:ME-number:CLN (vid-source only)
  • Media​-Store — MS:channel-number
  • ME Key Alpha — ME:ME-number:KEY:key-number:A
  • ME Key Video — ME:ME-number:KEY:key-number:V
  • ME MediaWipe Alpha — ME:ME-number:MWA
  • ME MediaWipe — ME:ME-number:MW
  • ME Preset — ME:ME-number:PST
  • ME Preview — ME:ME-number:PV
  • ME Program — ME:ME-number:PGM
  • MiniME™ Background — MME:ME-number:BKGD
  • MiniME™ Combined Key — MME:ME-number:CMB
  • MiniME™ Key Alpha — MME:ME-number:KEY:key-number:A
  • MiniME™ Key Video — MME:ME-number:KEY:key-number:V
  • MiniME™ Preset — MME:ME-number:PST
  • MiniME™ Preview — MME:ME-number:PV
  • MiniME™ Program — MME:ME-number:PGM
  • Preview — PV
  • Program — PGM
  • XPression (alpha) — XP:channel-number:A (Graphite only)
  • XPression (video) — XP:channel-number:V (Graphite only)