Mailing Lists: Apple Mailing Lists
 Image of Mac OS face in stamp
Re: MIDI device/entity/endpoint names
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: MIDI device/entity/endpoint names

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

References: 
 >MIDI device/entity/endpoint names (From: Doug Wyatt <email@hidden>)



Visit the Apple Store online or at retail locations.
1-800-MY-APPLE

Contact Apple | Terms of Use | Privacy Policy

Copyright © 2011 Apple Inc. All rights reserved.