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 95: / Line 95: @@
 |-
 | 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 109: / Line 109: @@
 |-
 | 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 128: / Line 128: @@
 |-
 | 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 147: / Line 147: @@
 |-
 | 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 171: / Line 171: @@
 |-
 | 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 200: / Line 200: @@
 |-
 | 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 229: / Line 229: @@
 |-
 | 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 258: / Line 258: @@
 |-
 | 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 287: / Line 287: @@
 |-
 | 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 311: / Line 311: @@
 |-
 | 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 335: / Line 335: @@
 |-
 | 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 364: / Line 364: @@
 {| 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)