OSC (Open Sound Control)

grandMA3 ユーザマニュアル » リモート入出力 » OSC (Open Sound Control)

Version 2.2

Open Sound Control, or OSC, is a client and server system that defines a message address pattern used to address elements in the receiving server. Open Sound Control allows devices of different types to control other devices via a peer-to-peer messaging protocol. OSC messages are human-readable, so they are more than just numbers and strings (unlike, for example, MIDI Show Control, or MSC).

The grandMA3 software supports OSC 1.1. For more general information about OSC, e.g. OSC Packets, see https://ccrma.stanford.edu/groups/osc/spec-1_0.html.

OSC Structure

OSC messages follow a specific pattern:

"(/prefix)/[OSC Address],[OSC Type],[Value]"

Prefix: This is optional, depending on your system setup. It can be used in a more complex OSC network to distinguish messages intended for one set of devices (e.g., lighting consoles) from others (e.g., sound consoles). If a prefix is specified, only OSC messages beginning with the specified prefix are processed, and the prefix is prepended to outgoing OSC messages.

	ヒント
	The prefix must not contain any slashes ("/").

OSC Address: This is the target you are controlling on the receiving device(s), for example /Fader201 would be the address to move the fader for executor 201 in grandMA3. Sometimes the address will be more complex, for example /Page1/Fader201 would be the address to move the fader for executor 201 on page 1 in grandMA3.

	制限
	Only OSC messages are supported when receiving or sending an OSC packet. OSC Bundle messages are currently not supported.

OSCタイプ - 送信する値の型です。例えば以下のようなものがあります。

i = integer

f = float

s = string

T = true

F = false

値: ターゲットに送信する値です。

以下は、エクゼキュータ201のフェーダを100に設定するOSCコマンドの例です。

"/Page1/Fader201,i,100"
"/gma3/Page1/Fader201,i,100" (プレフィックスで grandMA3 デバイスだけを指定)

OSC Menu

To open the OSC Menu:

Menu - In & Out - OSC.

The OSC Menu opens:

Open OSC Menu without any values. — OSC Menu

At the top of the menu, the following four options can be set:

Preferred IP: This is the preferred IP address or address range used by the OSC protocol.
Interface: Tap this button to open the Select Interface pop-up to select the desired network interface. For more information, see Interfaces and IP.
Enable Output: This toggle button must be enabled to transmit OSC. See Station Control in Network preferences for more information.
Enable Input: This toggle button must be enabled to receive OSC. See Station Control for more information.

	ヒント
	When receiving OSC messages, Enable Input will highlight its title bar in yellow. When sending OSC messages, the title bar of Enable Output will be highlighted.

The following are the specific parameters that can be set in the OSC menu:

Name: このコンフィグレーションに対する名前を設定します。
Destination IP: OSCデータを送信するためのIPアドレスを設定します。特定のIPアドレスまたはブロードキャストIPを設定できます。
Tags: Opens the Tags editor.
Mode: OSCパケットは、UDPまたはTCPで送信できます。
Port: OSCパケットの送受信に用いるネットワーク・ポートを指定します。
Prefix: 必要に応じてプレフィックスを設定できます。プレフィックスは、受信可能な範囲を制限するための基準として利用できます。例えば、/lighting は、これを持つパケットだけを受け入れ、/sound というプレフィックスを持つOSCパケットは破棄します。
Page: 受信OSCメッセージのどのOSCアドレスをページに送るかを指定します。
Fader: 受信OSCメッセージのどのOSCアドレスをフェーダに送るかを指定します。
ExecutorKnob: 受信OSCメッセージのどのOSCアドレスをミニエンコーダに送るかを指定します。
Key: 受信OSCメッセージのどのOSCアドレスをキーに送るかを指定します。
FaderRange: フェーダに対して用いられるOSC値の範囲を指定します。例えば、FaderRange 255 は、OSC 0～255 を 100%に設定します。
Receive: OSCデータ(コマンドは除く)を受信するかどうかを指定します。
Send: このOSC設定が、OSCデータ(コマンドは除く)を送信するかどうかを指定します。
Receive Command: コマンドラインのコマンドをOSCで受信するかどうかを指定します。この設定は、一般的な受信設定から独立しています。
Send Command: コマンドラインのコマンドをOSCで送信するかどうかを指定します。この設定は、一般的な Send 設定から独立しています。
EchoInput: 入力データを System Monitor に表示するかどうかを指定します。
EchoOutput: 出力データを System Monitor に表示するかどうかを指定します。
Note: Sets a note for this configuration.

With the buttons Receive All, Receive None, Send All, Send None, Receive Command All, Receive Command None,Send Command All, and Send Command None all OSC configuration lines can be modified together for the properties Receive, Send, Receive Command and Send Command.

Receive OSC

必要条件:

A network connection is established and the Interface is on both devices. For more information, see Enabling or Disabling the Network Connection.

Make sure that the network protocol (UDP, TCP), and the port are set correctly. Please note that the port configuration is used for sending and receiving OSC data.

	ヒント
	If you want to use different ports for sending and receiving, you can create multiple configuration lines.

例

Example to receive OSC packets on a grandMA3 light console:

Open the In & Out menu / OSC.
Tap Enable Input. The input is enabled.
Two-finger tap the first row below Receive in the grid. The parameter is set to Yes.

	ヒント
	When receiving OSC messages, Enable Input will highlight its title bar in yellow.

	ヒント
	Please note that in the example above, no prefix is defined.

For more examples, see Advanced Examples.

Command Line Control

The entirety of the grandMA3 command line can be accessed via OSC by using the "/cmd" OSC Address and the string 's' OSC Type.

	ヒント
	To receive OSC messages for the command line, set Receive Command to Yes in the corresponding OSC configuration line.

Examples that can be sent from another console to the receiving console:

SendOSC 1 "/cmd,s,FaderMaster Page 1.201 At 50": Brings fader 201 on page 1 to 50% (same as the examples above but using gMA3 command line syntax instead).
SendOSC 1 "/cmd,s,FaderMaster Page 1.201 At 50 Fade 5": Brings fader 201 on page 1 to 50% and additionally adds a fade time of five seconds
SendOSC 1 "/cmd,s,Fixture 1 At 75": grandMA3 command line syntax is used to execute the command "Fixture 1 At 75" in the command line.
SendOSC 1 "/cmd,s,Go+ Exec 402": Triggers executor 402.
SendOSC 1 "/cmd,s,Patch Fixture 1 3.42": Patches fixture 1 to address 42 in Universe 3.

Object Playback Control

The Playback of the following pool objects are controlled through OSC:

Sequences
Masters
Groups
Presets
Sounds
Worlds
Plugins
Screen Configuration
Timers

Pool objects are addressed by their enumerated address in the grandMA3 directory structure. For more information about the grandMA3 structure, see List keyword.

Target	Addresses	Type Tags	Arguments	Results	Example
Sequence X	/13.13.1.6.X	si	<Key function>,1	Press the Key of the given Key function.	/13.13.1.6.1,si,Flash,1
-	-	si	<Key function>,0	Release the Key of the given Key function
-	-	sif	<Fader function>,3,0 … 100	Set the Fader of the given Fader function to the given value in percent.
-	-	sii	<Fader function>,0 … 3, -100 … 100	Incrementally move the Fader of the Fader function by the given value in percent.

	重要
	The address in the grandMA3 directory structure may change between software versions. Be sure to check the addresses when performing a software update.

All playback functions that can be used when assigning the object type to an Executor can also be controlled through OSC. For more information, see Assign Object to an Executor.

例

To display the argument of a playback control function in the System Monitor:

On the reciving device, press Menu - tap In & Out - tap OSC menu.
Tap Enable Input.
Set Receive to Yes in the corresponding OSC configuration Line.
Set Echo Input to Yes.
Tap to close the In & Out menu.
Open Add Window - More - System Monitor.
Execute a playback command, e.g. move Fader201 on the sending device. The argument of the playback is displayed in the System Monitor of the receiver.

System Monitor is shown. — System Monitor

To retrieve the enumerated address of an object and display it in the Command Line History:

Tap the command line.
Type Lua "Printf( ObjectList( 'Master 1' )[ 1 ]:Addr() )" and press Please ( Replace the Master 1 in the example with another object). The enumerated address is shown in the command line history.

Command Line History

For more information, see the Printf(string) Lua function.

Send OSC

	ヒント
	OSCの送信については、SendOSC キーワードを参照してください。

例1

To send OSC packets from a grandMA3 onPC station:

Open the In & Out Menu / OSC.
Tap Enable Output. The output is enabled.
Two-finger tap Destination IP in the first row of the grid. The editor opens.
Set the Destination IP of the receiving device and then press Please.
Two-finger tab the first row below Send Command. The parameter is set to Yes.
Send data to the receiving device, e.g by using the command: SendOSC 1 "/Page1/Fader201,i,50".
The title bar of Enable Output turns yellow and OSC packets are sent from grandMA3 onPC to the grandMA3 light console.

Title Bar of the Enable Output button is yellow when sending data

	ヒント
	When sending OSC messages, the title bar of Enable Output will be highlighted.

Object Playback Feedback

	ヒント
	To send OSC messages for playback action, set Send to Yes in the corresponding OSC configuration line.

Playback actions generate OSC output on the following objects, which can be used in the System Monitor when Echo Output is enabled:

Sequences
Masters
Groups
Presets
Sounds
Worlds
Plugin Components
Screen Configuration
Timers

詳しくはプラグインを参照してください。

例2

To send a command, e.g., a playback control function, to a grandMA3 console:

On the sending device, press Menu - tap In & Out - tap OSC menu.
Tap Enable Output.
Set Send to Yes in the corresponding OSC configuration line.
Set Echo Output to Yes.
Tap X to close the In & Out menu.
Open Add Window - More - System Monitor.
Execute a playback command, e.g. move Fader201. The command is send to the receiver.

例3

To send OSC data from a grandMA3 onPC workstation and receive it on a console:

必要条件:

The IP addresses are set up correctly and the network is enabled on both devices .
Some Fixtures are patched on the receiving console.

Sender:

Open the In & Out Menu / OSC.
Tap Enable Output. The output is enabled.
Set Send Command to Yes.
Tap the command line in grandMA3 onPC:
Type SendOSC 1 "/cmd,s,Fixture 1 At 75" and press Please.

Receiver:

Open the In & Out Menu / OSC.
Tap Enable Input. The input is enabled.
Set Receive Command to Yes.
If the command is received, Fixture 1 on the console is dimmed down to 75%.

例4

To send OSC data from a grandMA3 onPC workstation to a third party device, e.g., a videoserver: