Component: USB MIDI (Comms: USB): Difference between revisions

Latest revision as of 14:37, 13 July 2026

Author	Matrix Ltd.
Version	1.3
Category	Comms: USB

USB MIDI component

Component to create and communicate using a standard MIDI connection. Compatible with simulation and USB enabled microcontroller devices. Currently only compatible with the 16-bit PIC range of devices.

Component Source Code

Please click here to download the component source project: FC_Comp_Source_USBMIDI.fcfx

Please click here to view the component source code (Beta): FC_Comp_Source_USBMIDI.fcfx

Detailed description

No detailed description exists yet for this component

Examples

No additional examples

Macro reference

Initialise

	Initialise
Starts up the USB communications and attempts to enumerate. Returns 0 for a successful startup or 255 for a enumeration timeout.
- BYTE	Return

ReadData

	ReadData
Reads a byte from the last received MIDI message
- BYTE	Idx
Byte to read 0-3
- BYTE	Return

ReceiveMIDI

	ReceiveMIDI
Waits for the time specified in the timeout parameter for an incoming MIDI message. Returns 0 to indicate a timeout, otherwise returns the first value from the MIDI message.
- BYTE	Timeout

- BYTE	Return

SendChannelPressure

	SendChannelPressure

- BYTE	Channel

- BYTE	Pressure

- VOID	Return

SendControl

	SendControl
Sends a control command using the channel, controller and value specified.
- BYTE	Channel

- BYTE	Controller

- BYTE	Value

- VOID	Return

SendMIDI

	SendMIDI
Sends a MIDI packet consisting of up to three bytes of information,
- BYTE	Status
MIDI Status Byte - Used for commands such as NoteOn, NoteOff etc.
- BYTE	Data1
MIDI Data Byte - Used as a parameter specific to the specified command
- BYTE	Data2
MIDI Data Byte - Used as a parameter specific to the specified command
- VOID	Return

SendNoteOff

	SendNoteOff
Sends a note off command using the channel, note and velocity specified.
- BYTE	Channel

- BYTE	Note

- BYTE	Velocity

- VOID	Return

SendNoteOn

	SendNoteOn
Sends a note on command using the channel, note and velocity specified.
- BYTE	Channel

- BYTE	Note

- BYTE	Velocity

- VOID	Return

SendPatch

	SendPatch

- BYTE	Channel

- BYTE	Instrument

- VOID	Return

SendPitchChange

	SendPitchChange
Sends out a pitch change command on the specified channel.
- BYTE	Channel
Channel to send the pitch change to
- UINT	Pitch_Change
New pitch value to use, Default 0x2000
- VOID	Return

SendPolyPressure

	SendPolyPressure
Sends a note press with an associated polyphonic pressure value.
- BYTE	Channel

- BYTE	Note

- BYTE	Pressure

- VOID	Return

Property reference

	Properties
	USB Properties
	Vendor ID
USB VID
	Product ID
USB PID
	Device Name
USB Device Name
	Manufacturer
USB Manufacturer
	Major Version
USB Major Version Number
	Minor Version
USB Minor Version Number
	Enumeration Timeout
Specifies if the enumeration (Initialise function) can timeout if taking too long.
	Simulation
	Label
Text displayed on the I/O flasher comms component.
	Data Source
Simulation data source used to allow the component to connect to specific MIDI hardware or the the data injector components.
	MIDI Port

@@ Line 92: / Line 92: @@
 ===Initialise===
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+{| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Initialise'''
+| width="90%" class="mtx-class-macrohead" | '''Initialise'''
 |-
 | colspan="2" | Starts up the USB communications and attempts to enumerate. Returns 0 for a successful startup or 255 for a enumeration timeout.&nbsp;
@@ Line 106: / Line 106: @@
 ===ReadData===
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+{| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ReadData'''
+| width="90%" class="mtx-class-macrohead" | '''ReadData'''
 |-
 | colspan="2" | Reads a byte from the last received MIDI message&nbsp;
@@ Line 125: / Line 125: @@
 ===ReceiveMIDI===
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+{| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ReceiveMIDI'''
+| width="90%" class="mtx-class-macrohead" | '''ReceiveMIDI'''
 |-
 | colspan="2" | Waits for the time specified in the timeout parameter for an incoming MIDI message. Returns 0 to indicate a timeout, otherwise returns the first value from the MIDI message.&nbsp;
@@ Line 144: / Line 144: @@
 ===SendChannelPressure===
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+{| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SendChannelPressure'''
+| width="90%" class="mtx-class-macrohead" | '''SendChannelPressure'''
 |-
 | colspan="2" | &nbsp;
@@ Line 168: / Line 168: @@
 ===SendControl===
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+{| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SendControl'''
+| width="90%" class="mtx-class-macrohead" | '''SendControl'''
 |-
 | colspan="2" | Sends a control command using the channel, controller and value specified.&nbsp;
@@ Line 197: / Line 197: @@
 ===SendMIDI===
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+{| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SendMIDI'''
+| width="90%" class="mtx-class-macrohead" | '''SendMIDI'''
 |-
 | colspan="2" | Sends a MIDI packet consisting of up to three bytes of information,&nbsp;
@@ Line 226: / Line 226: @@
 ===SendNoteOff===
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+{| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SendNoteOff'''
+| width="90%" class="mtx-class-macrohead" | '''SendNoteOff'''
 |-
 | colspan="2" | Sends a note off command using the channel, note and velocity specified.&nbsp;
@@ Line 255: / Line 255: @@
 ===SendNoteOn===
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+{| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SendNoteOn'''
+| width="90%" class="mtx-class-macrohead" | '''SendNoteOn'''
 |-
 | colspan="2" | Sends a note on command using the channel, note and velocity specified.&nbsp;
@@ Line 284: / Line 284: @@
 ===SendPatch===
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+{| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SendPatch'''
+| width="90%" class="mtx-class-macrohead" | '''SendPatch'''
 |-
 | colspan="2" | &nbsp;
@@ Line 308: / Line 308: @@
 ===SendPitchChange===
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+{| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SendPitchChange'''
+| width="90%" class="mtx-class-macrohead" | '''SendPitchChange'''
 |-
 | colspan="2" | Sends out a pitch change command on the specified channel.&nbsp;
@@ Line 332: / Line 332: @@
 ===SendPolyPressure===
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+{| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SendPolyPressure'''
+| width="90%" class="mtx-class-macrohead" | '''SendPolyPressure'''
 |-
 | colspan="2" | Sends a note press with an associated polyphonic pressure value.&nbsp;
@@ Line 362: / Line 362: @@
 ==Property reference==
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+{| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-prop-icon.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-prop-icon.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Properties'''
+| width="90%" class="mtx-class-macrohead" | '''Properties'''
 |-
 |-
-| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
+| width="10%" align="center" class="mtx-class-propfolder" | [[File:Fc9-conn-icon.png]]
-| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | USB Properties
+| width="90%" class="mtx-class-propfolder" | USB Properties
 |-
 |-
@@ Line 407: / Line 407: @@
 | colspan="2" | Specifies if the enumeration (Initialise function) can timeout if taking too long.&nbsp;
 |-
-| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
+| width="10%" align="center" class="mtx-class-propfolder" | [[File:Fc9-conn-icon.png]]
-| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Simulation
+| width="90%" class="mtx-class-propfolder" | Simulation
 |-
 |-

SteveT (talk | contribs)