Inherits from MIKMIDISystemMessageCommand : MIKMIDICommand : NSObject
Declared in MIKMIDISystemExclusiveCommand.h

Overview

A MIDI System Exclusive (SysEx) message. System exclusive messages are messages defined by individual manufacturers of MIDI devices. They can contain arbitrary data and can be used to support commands and responses not explicitly supported by the standard portion of MIDI spec. There are also some “Universal Exclusive Mesages”, which while a type of SysEx message, are not manufacturer/device specific.

Tasks

  • + identityRequestCommand

    Convenience method for creating a SysEx identity request command. For most MIDI devices, sending this command to them will result in a response including the device’s manufacturer ID along with data to identify the specific family, model number, and version number of the device.

  •   manufacturerID

    The manufacturer ID for the command. This is used by devices to determine if the message is one they support. If it is not, the message is ignored. Manufacturer IDs are assigned by the MIDI Manufacturer’s Association, and a list can be found here: http://www.midi.org/techspecs/manid.php

    property
  •   sysexChannel

    The channel of the message. Only valid for universal exclusive messages, will always be 0 for nonuniversal messages.

    property
  •   sysexData

    The system exclusive data for the message.

    property
  •   universal

    Whether or not the command is a universal exclusive message.

    property

Properties

manufacturerID

@property (nonatomic, readonly) UInt32 manufacturerID
Discussion

The manufacturer ID for the command. This is used by devices to determine if the message is one they support. If it is not, the message is ignored. Manufacturer IDs are assigned by the MIDI Manufacturer’s Association, and a list can be found here: http://www.midi.org/techspecs/manid.php

The manufacturer ID can be either 1 byte or 3 bytes.

Values 0x7E (kMIKMIDISysexNonRealtimeManufacturerID) and 0x7F (kMIKMIDISysexRealtimeManufacturerID) mean that the message is a universal exclusive message.

Declared In

MIKMIDISystemExclusiveCommand.h

sysexChannel

@property (nonatomic, readonly) UInt8 sysexChannel
Discussion

The channel of the message. Only valid for universal exclusive messages, will always be 0 for nonuniversal messages.

Declared In

MIKMIDISystemExclusiveCommand.h

sysexData

@property (nonatomic, strong, readonly) NSData *sysexData
Discussion

The system exclusive data for the message.

For universal messages subID’s are included in sysexData, for nonuniversal messages, any device specific information (such as modelID, versionID or whatever manufactures decide to include) will be included in sysexData.

Declared In

MIKMIDISystemExclusiveCommand.h

universal

@property (nonatomic, readonly, getter=isUniversal) BOOL universal
Discussion

Whether or not the command is a universal exclusive message.

Declared In

MIKMIDISystemExclusiveCommand.h

Class Methods

identityRequestCommand

+ (instancetype)identityRequestCommand
Discussion

Convenience method for creating a SysEx identity request command. For most MIDI devices, sending this command to them will result in a response including the device’s manufacturer ID along with data to identify the specific family, model number, and version number of the device.

Return Value

An identity request command object.

Declared In

MIKMIDISystemExclusiveCommand.h