| 117 |
pfowler |
1 |
Version 2009-08-22
|
|
|
2 |
|
|
|
3 |
===========================
|
|
|
4 |
FREE USB-IDs FOR SHARED USE
|
|
|
5 |
===========================
|
|
|
6 |
|
|
|
7 |
Objective Development has reserved a set of USB Product-IDs for use according
|
|
|
8 |
to the guidelines outlined below. For more information about the concept of
|
|
|
9 |
USB IDs please see the file USB-ID-FAQ.txt. Objective Development guarantees
|
|
|
10 |
that the IDs listed below are not used by any USB compliant devices.
|
|
|
11 |
|
|
|
12 |
|
|
|
13 |
====================
|
|
|
14 |
MECHANISM OF SHARING
|
|
|
15 |
====================
|
|
|
16 |
|
|
|
17 |
From a technical point of view, two different devices can share the same USB
|
|
|
18 |
Vendor- and Product-ID if they require the same driver on operating system
|
|
|
19 |
level. We make use of this fact by assigning separate IDs for various device
|
|
|
20 |
classes. On application layer, devices must be distinguished by their textual
|
|
|
21 |
name or serial number. We offer separate sets of IDs for discrimination by
|
|
|
22 |
textual name and for serial number.
|
|
|
23 |
|
|
|
24 |
Examples for shared use of USB IDs are included with V-USB in the "examples"
|
|
|
25 |
subdirectory.
|
|
|
26 |
|
|
|
27 |
|
|
|
28 |
======================================
|
|
|
29 |
IDs FOR DISCRIMINATION BY TEXTUAL NAME
|
|
|
30 |
======================================
|
|
|
31 |
|
|
|
32 |
If you use one of the IDs listed below, your device and host-side software
|
|
|
33 |
must conform to these rules:
|
|
|
34 |
|
|
|
35 |
(1) The USB device MUST provide a textual representation of the manufacturer
|
|
|
36 |
and product identification. The manufacturer identification MUST be available
|
|
|
37 |
at least in USB language 0x0409 (English/US).
|
|
|
38 |
|
|
|
39 |
(2) The textual manufacturer identification MUST contain either an Internet
|
|
|
40 |
domain name (e.g. "mycompany.com") registered and owned by you, or an e-mail
|
|
|
41 |
address under your control (e.g. "myname@gmx.net"). You can embed the domain
|
|
|
42 |
name or e-mail address in any string you like, e.g. "Objective Development
|
|
|
43 |
http://www.obdev.at/vusb/".
|
|
|
44 |
|
|
|
45 |
(3) You are responsible for retaining ownership of the domain or e-mail
|
|
|
46 |
address for as long as any of your products are in use.
|
|
|
47 |
|
|
|
48 |
(4) You may choose any string for the textual product identification, as long
|
|
|
49 |
as this string is unique within the scope of your textual manufacturer
|
|
|
50 |
identification.
|
|
|
51 |
|
|
|
52 |
(5) Application side device look-up MUST be based on the textual manufacturer
|
|
|
53 |
and product identification in addition to VID/PID matching. The driver
|
|
|
54 |
matching MUST be a comparison of the entire strings, NOT a sub-string match.
|
|
|
55 |
|
|
|
56 |
(6) For devices which implement a particular USB device class (e.g. HID), the
|
|
|
57 |
operating system's default class driver MUST be used. If an operating system
|
|
|
58 |
driver for Vendor Class devices is needed, this driver must be libusb or
|
|
|
59 |
libusb-win32 (see http://libusb.org/ and
|
|
|
60 |
http://libusb-win32.sourceforge.net/).
|
|
|
61 |
|
|
|
62 |
Table if IDs for discrimination by textual name:
|
|
|
63 |
|
|
|
64 |
PID dec (hex) | VID dec (hex) | Description of use
|
|
|
65 |
==============+===============+============================================
|
|
|
66 |
1500 (0x05dc) | 5824 (0x16c0) | For Vendor Class devices with libusb
|
|
|
67 |
--------------+---------------+--------------------------------------------
|
|
|
68 |
1503 (0x05df) | 5824 (0x16c0) | For generic HID class devices (which are
|
|
|
69 |
| | NOT mice, keyboards or joysticks)
|
|
|
70 |
--------------+---------------+--------------------------------------------
|
|
|
71 |
1505 (0x05e1) | 5824 (0x16c0) | For CDC-ACM class devices (modems)
|
|
|
72 |
--------------+---------------+--------------------------------------------
|
|
|
73 |
1508 (0x05e4) | 5824 (0x16c0) | For MIDI class devices
|
|
|
74 |
--------------+---------------+--------------------------------------------
|
|
|
75 |
|
|
|
76 |
Note that Windows caches the textual product- and vendor-description for
|
|
|
77 |
mice, keyboards and joysticks. Name-bsed discrimination is therefore not
|
|
|
78 |
recommended for these device classes.
|
|
|
79 |
|
|
|
80 |
|
|
|
81 |
=======================================
|
|
|
82 |
IDs FOR DISCRIMINATION BY SERIAL NUMBER
|
|
|
83 |
=======================================
|
|
|
84 |
|
|
|
85 |
If you use one of the IDs listed below, your device and host-side software
|
|
|
86 |
must conform to these rules:
|
|
|
87 |
|
|
|
88 |
(1) The USB device MUST provide a textual representation of the serial
|
|
|
89 |
number, unless ONLY the operating system's default class driver is used.
|
|
|
90 |
The serial number string MUST be available at least in USB language 0x0409
|
|
|
91 |
(English/US).
|
|
|
92 |
|
|
|
93 |
(2) The serial number MUST start with either an Internet domain name (e.g.
|
|
|
94 |
"mycompany.com") registered and owned by you, or an e-mail address under your
|
|
|
95 |
control (e.g. "myname@gmx.net"), both terminated with a colon (":") character.
|
|
|
96 |
You MAY append any string you like for further discrimination of your devices.
|
|
|
97 |
|
|
|
98 |
(3) You are responsible for retaining ownership of the domain or e-mail
|
|
|
99 |
address for as long as any of your products are in use.
|
|
|
100 |
|
|
|
101 |
(5) Application side device look-up MUST be based on the serial number string
|
|
|
102 |
in addition to VID/PID matching. The matching must start at the first
|
|
|
103 |
character of the serial number string and include the colon character
|
|
|
104 |
terminating your domain or e-mail address. It MAY stop anywhere after that.
|
|
|
105 |
|
|
|
106 |
(6) For devices which implement a particular USB device class (e.g. HID), the
|
|
|
107 |
operating system's default class driver MUST be used. If an operating system
|
|
|
108 |
driver for Vendor Class devices is needed, this driver must be libusb or
|
|
|
109 |
libusb-win32 (see http://libusb.org/ and
|
|
|
110 |
http://libusb-win32.sourceforge.net/).
|
|
|
111 |
|
|
|
112 |
(7) If ONLY the operating system's default class driver is used, e.g. for
|
|
|
113 |
mice, keyboards, joysticks, CDC or MIDI devices and no discrimination by an
|
|
|
114 |
application is needed, the serial number may be omitted.
|
|
|
115 |
|
|
|
116 |
|
|
|
117 |
Table if IDs for discrimination by serial number string:
|
|
|
118 |
|
|
|
119 |
PID dec (hex) | VID dec (hex) | Description of use
|
|
|
120 |
===============+===============+===========================================
|
|
|
121 |
10200 (0x27d8) | 5824 (0x16c0) | For Vendor Class devices with libusb
|
|
|
122 |
---------------+---------------+-------------------------------------------
|
|
|
123 |
10201 (0x27d9) | 5824 (0x16c0) | For generic HID class devices (which are
|
|
|
124 |
| | NOT mice, keyboards or joysticks)
|
|
|
125 |
---------------+---------------+-------------------------------------------
|
|
|
126 |
10202 (0x27da) | 5824 (0x16c0) | For USB Mice
|
|
|
127 |
---------------+---------------+-------------------------------------------
|
|
|
128 |
10203 (0x27db) | 5824 (0x16c0) | For USB Keyboards
|
|
|
129 |
---------------+---------------+-------------------------------------------
|
|
|
130 |
10204 (0x27dc) | 5824 (0x16c0) | For USB Joysticks
|
|
|
131 |
---------------+---------------+-------------------------------------------
|
|
|
132 |
10205 (0x27dd) | 5824 (0x16c0) | For CDC-ACM class devices (modems)
|
|
|
133 |
---------------+---------------+-------------------------------------------
|
|
|
134 |
10206 (0x27de) | 5824 (0x16c0) | For MIDI class devices
|
|
|
135 |
---------------+---------------+-------------------------------------------
|
|
|
136 |
|
|
|
137 |
|
|
|
138 |
=================
|
|
|
139 |
ORIGIN OF USB-IDs
|
|
|
140 |
=================
|
|
|
141 |
|
|
|
142 |
OBJECTIVE DEVELOPMENT Software GmbH has obtained all VID/PID pairs listed
|
|
|
143 |
here from Wouter van Ooijen (see www.voti.nl) for exclusive disposition.
|
|
|
144 |
Wouter van Ooijen has obtained the VID from the USB Implementers Forum, Inc.
|
|
|
145 |
(see www.usb.org). The VID is registered for the company name "Van Ooijen
|
|
|
146 |
Technische Informatica".
|
|
|
147 |
|
|
|
148 |
|
|
|
149 |
==========
|
|
|
150 |
DISCLAIMER
|
|
|
151 |
==========
|
|
|
152 |
|
|
|
153 |
OBJECTIVE DEVELOPMENT Software GmbH disclaims all liability for any
|
|
|
154 |
problems which are caused by the shared use of these VID/PID pairs.
|