# Enable local control on MIDI devices

``

    midi_local_control_on

Sends a MIDI local control on message to all connected devices on all channels. Use the `port:` and `channel:` opts to restrict which MIDI ports and channels are used.

All devices on a given channel will respond both to data received over MIDI and played data, etc. See `midi_local_control_off` to disable local control.

MIDI 1.0 Specification - Channel Mode Messages - Local Control On

Introduced in v3.0

## Options

channel: | Channel to send the local control on message to
port: | MIDI port to send to
on: | If specified and false/nil/0 will stop the midi local control on message from being sent out. (Ensures all opts are evaluated in this call to `midi_local_control_on` regardless of value).

## Examples

# Example 1
``
    midi_local_control_on
| ``
    #=> Enable local control on MIDI devices on all channels (and ports)
# Example 2
``
    midi_local_control_on channel: 2
| ``
    #=> Enable local control on MIDI devices on channel 2