Difference between revisions of "Component: USB MIDI (Comms: USB)"
From Flowcode Help
Jump to navigationJump to search| Line 15: | Line 15: | ||
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 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 | + | ==Component Source Code== |
| − | + | Please click here for the component source code: [https://www.flowcode.co.uk/wikicopy/componentsource/FC_Comp_Source_USBMIDI.fcfx FC_Comp_Source_USBMIDI.fcfx] | |
==Detailed description== | ==Detailed description== | ||
| + | |||
| + | |||
| Line 34: | Line 36: | ||
==Examples== | ==Examples== | ||
| + | |||
| + | |||
| Line 317: | Line 321: | ||
| width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-prop-icon.png]] | | width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-prop-icon.png]] | ||
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Properties''' | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Properties''' | ||
| + | |- | ||
| + | |- | ||
| + | | width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]] | ||
| + | | width="90%" style="background-color:#EAE1EA; color:#4B008D;" | USB Properties | ||
|- | |- | ||
|- | |- | ||
| Line 354: | Line 362: | ||
| colspan="2" | Specifies if the enumeration (Initialise function) can timeout if taking too long. | | colspan="2" | Specifies if the enumeration (Initialise function) can timeout if taking too long. | ||
|- | |- | ||
| − | | width="10%" align="center" style="background-color:# | + | | width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]] |
| − | | width="90%" style="background-color:# | + | | width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Simulation |
| − | |||
| − | |||
| − | |||
| − | |||
|- | |- | ||
|- | |- | ||
Revision as of 17:52, 9 November 2022
| Author | Matrix Ltd. |
| Version | 1.3 |
| Category | Comms: USB |
Contents
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 for the component source code: FC_Comp_Source_USBMIDI.fcfx
Detailed description
No detailed description exists yet for this component
Examples
No additional examples
Downloadable macro reference
|
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 |
|
|
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 |
|
|
SendNoteOff |
| Sends a note off command using the channel, note and velocity specified. | |
| - BYTE
|
Channel |
| - BYTE
|
Note |
| - BYTE
|
Velocity |
| - VOID
|
Return |
|
|
SendControl |
| Sends a control command using the channel, controller and value specified. | |
| - BYTE
|
Channel |
| - BYTE
|
Controller |
| - BYTE
|
Value |
| - VOID
|
Return |
|
|
SendNoteOn |
| Sends a note on command using the channel, note and velocity specified. | |
| - BYTE
|
Channel |
| - BYTE
|
Note |
| - BYTE
|
Velocity |
| - VOID
|
Return |
|
|
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 |
|
|
SendPolyPressure |
| Sends a note press with an associated polyphonic pressure value. | |
| - BYTE
|
Channel |
| - BYTE
|
Note |
| - BYTE
|
Pressure |
| - VOID
|
Return |
|
|
ReadData |
| Reads a byte from the last received MIDI message | |
| - BYTE
|
Idx |
| Byte to read 0-3 | |
| - BYTE
|
Return |
|
|
SendPatch |
| - BYTE
|
Channel |
| - BYTE
|
Instrument |
| - VOID
|
Return |
|
|
SendChannelPressure |
| - BYTE
|
Channel |
| - BYTE
|
Pressure |
| - VOID
|
Return |
|
|
Initialise |
| Starts up the USB communications and attempts to enumerate. Returns 0 for a successful startup or 255 for a enumeration timeout. | |
| - BYTE
|
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 |
