Re: MIDI device/entity/endpoint names
Re: MIDI device/entity/endpoint names
- Subject: Re: MIDI device/entity/endpoint names
- From: Kurt Revis <email@hidden>
- Date: Tue, 20 Nov 2001 06:27:02 -0800
On Tuesday, November 13, 2001, at 04:49 PM, Doug Wyatt wrote:
In looking at some MIDI apps and drivers that are starting to appear,
I've realized that there's a convention I'd like to see used, but
hasn't been documented beyond its use in sample code (if even there).
Driver writers should name things like this:
Manufacturer: MyGreatHardware
Model: MyBox
Device: MyBox #1 (i.e. append some sort of unique identifier if
there are multiple instances)
Entity: Port 1
Endpoints will inherit "Port 1" as their name -- so you don't have to
bother to name the endpoints, unless there are more than one of each,
which is usually not as good an idea as having one pair of endpoints
per entity.
Then, application writers can make a choice:
If the endpoint name "Port 1" is unique, as it will be in a
single-device studio, you can choose to display just that, and it's
nice and short.
Or, if you always want to be precise, you can concatenate the device
and endpoint names, and even prepend the manufacturer name if you like.
For what it's worth, I just pushed out a new version of my MIDI
monitoring/test app, MIDI Monitor, which implements the above scheme.
(It gets all the endpoint names, and if they're unique, just displays
them as-is. If the names aren't unique, they're displayed as "<device
name> <endpoint name>". It is up to the drivers to produce unique device
names.)
You can get it here:
http://www.snoize.com/MIDIMonitor/
I know some of you have already found this app and are using it, but I
thought I'd do a little promotion. Also, I'd like to know if my code
actually works, since I currently only have one device to try it with!
If you see results which seem wrong, please let me know.
--
Kurt Revis
email@hidden