New USB Devices


Report a new USB Device

In order to keep our list of supported and unsupported USB devices up to date, we need your help. When reporting a new device, we recommend the use of !USBinfo to extract the information from the device. Furthermore you should mark clearly whether the device is currently being supported by the USB software on your RISC OS computer. Please complete the form below and press Send this form when ready. If you need any help, please read the remarks at the bottom of this page.

New USB Device
Vendor ID	e.g.: 0e9f
Product ID	e.g.: 0003
Vendor name	e.g.: Xerox (from the red lines)
Product name	e.g.: Laser Printer (from the red lines)
Class	e.g.: 8_6_80
Brand name	e.g.: Olympus
Model	e.g.: Camedia C-730 Ultra Zoom
Description	e.g.: 3.2 Megapixel digital camera
Memory	e.g.: 64MB (only if applicable)
Comments
	Works well with Castle USB (Iyonix & Castle Podule)

Optional information
Name	Please enter your name here
E-mail	Your e-mail address (just in case we want to contact you)


How to fill in the form

In the above form you need to enter some information about your USB device. It is important to supply the correct information and to complete the entire form.

There are several ways to extract the neccessary information from the USB subsystem. The best way to do this is to use our USB application !USBinfo. If you don't have this application, or if you're using a rather old version, please download it now. Start !USBinfo and open the Topology window. This window looks like the image on the right.

Select the required device by clicking on its icon. It will be highlighted. Open the menu and select Device -> Vendor. The

The Vendor window shows all information about the manufacturer and the device's identification codes.

The vendor_id and product_id are shown in the top right corner of the window (in this example: 0c0b and 27cb. The lowest two lines (red) represent the text string inside the device.

Another important piece of information is the USB class, which is given in the Interface window. (Menu: Device -> Interface).

The three numbers we need are Class, SubClass and Protocol. The numbers in the example will be represented as 8_6_80.

The above information can also be extracted from the command line. Press F12 to leave the desktop, or Ctrl-F12 to open a task window. First type USBDevices Enter
A list will be displayed, showing all currently connected USB Devices, like this:

     No. Bus Dev Class Description
       1   1   1  9/ 0 NEC OHCI root hub
       2   1   2  0/ 0 Logitech USB Receiver
       3   2   1  9/ 0 NEC OHCI root hub
       4   2   2  0/ 0 Microsoft Microsoft IntelliMouse� Optical
       5   2   3  0/ 0                          MultiFlash

Find your device in the above list (the device in our example has no 5) and type USBDevInfo 5 (the 5 should be replaced by the number of your device). A list will now appear showing information about the device, like this:

     USB release     : 0110
     Device class    : 00
     Device subclass : 00
     Device protocol : 00
     Max packet size : 08
     Vendor ID       : 0C0B
     Product ID      : 27CB
     Device ID       : 0100
     Manufacturer    : '                        '
     Product         : 'MultiFlash'
     Serial number   : '1E2B1D021051'
     # of configs    : 1

From this list we'll be using the lines Vendor ID, Product ID, Manufacturer and Product. Don't use the class numbers from this list.

Now type USBConfInfo 5 (the 5 should be replaced by the number of your device). A list will now appear showing information about the device's configuration, like this:

     Current config  : 1
     
     # of interfaces : 1
     Config value    : 1
     Name            : ''
     Attributes      : Bus powered
     Maximum power   : 500mA
     
     Interface 0.0 class 8.6:80 ''
      1 IN  Bulk 64 bytes 255 frames
      2 OUT Bulk 64 bytes 255 frames
      3 IN  Interrupt 2 bytes 1 frames

From this list we use the class number, in this case 8_6_80.

Any links shown in red are currently unavailable. � X-Ample Technology BV.
Last changed: Friday, 27 February 2004 - 03:02 CET.