This the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

MIDI

1 - MIDI Input

This connection type listens to a MIDI input device and exposes incoming MIDI messages as read-only parameters.

Each received MIDI short message is mapped by its raw status byte and first data byte. The second data byte is then published as the parameter value.

This makes it possible to react to note, controller, program change, and other MIDI messages directly in BTConnect.

Configuration

  • Device: Select the MIDI input device to listen to.

BTConnect opens the selected device when the connection starts.

Parameters

The MIDI Input connection provides a fixed set of read-only integer parameters in the form:

  • <status>/<data1> (integer, read-only) - receives the value of the second MIDI data byte (data2) for incoming messages with the specified status byte and first data byte.

The valid ranges are:

  • status: 0 to 255
  • data1: 0 to 127
  • parameter value (data2): 0 to 127

For example:

  • 144/60 receives the velocity value for a MIDI Note On message on channel 1 for note 60.
  • 176/7 receives controller values for MIDI Control Change 7 on channel 1.

Only incoming MIDI short messages are exposed as parameters.

2 - MIDI Output

This connection type sends MIDI messages to a MIDI output device.

It provides write-only parameters for MIDI short messages as well as a separate parameter for sending SysEx data.

Configuration

  • Device: Select the MIDI output device to send messages to.

BTConnect opens the selected device when the connection starts.

Parameters

The MIDI Output connection provides a fixed set of write-only integer parameters in the form:

  • <status>/<data1> (integer, write-only) - sends a MIDI short message using the specified status byte and first data byte. The parameter value is sent as the second data byte (data2).

The valid ranges are:

  • status: 0 to 255
  • data1: 0 to 127
  • parameter value (data2): 0 to 127

For example:

  • Setting 144/60 to 100 sends a MIDI Note On message on channel 1 for note 60 with velocity 100.
  • Setting 176/7 to 90 sends a MIDI Control Change 7 message on channel 1 with value 90.

In addition, the following parameter is available:

  • sysex (string, write-only) - sends a System Exclusive message. The value must be a hexadecimal byte string. Spaces are allowed and will be ignored before sending.

For example:

F0 7E 7F 09 01 F7

Only outgoing MIDI messages are handled by this connection.