trAvis - MANAGER

Edit File: IODC.txt

Some notes on IODC, its general brokenness, and how to work around it. Short Version IODC is HP's pre-PCI standard for device identification (a la PCI vendor, device IDs), detection, configuration, initialization and so on. It also can provide firmware function to do the actual IO, which are slow, not really defined for runtime usage and generally not desirable. (There are other firmware standards, such as STI, to do real IO). Usually, there are two parts to IODC. The actual ROMs, which are laid out, detected aso in a bus-specific manner (IO_DC_ADDRESS / IO_DC_DATA on GSC/Runway, PCI spec - compliant ROMs for PCI, God-only-knows how on EISA), and the slightly cooked data read by PDC_IODC. The ROM layout is generally icky (only one byte out of every 4-byte-word might be valid, and many devices don't implement required options), so using PDC_IODC is highly recommended. (In fact, you should use the device lists set up by the kernel proper instead of calling PDC_IODC yourself). Now, let's have a look at what the cooked ROM looks like (see iodc.pdf for the details, this is the simplified version). Basically, the first 8 bytes of IODC contain two 32-bit ids called HVERSION and SVERSION. Those are further split up into bit fields, and unfortunately just ignoring this split up isn't an option. SVERSION consists of a 4-bit revision field, a 20-bit model field and a 8-bit opt field. Now, forget the revision and opt fields exist. Basically, the model field is equivalent to a PCI device id (there is no vendor id. this is proprietary hardware we're talking about). That is, all your driver cares for, in 90 % of the cases, is to find all devices that match the model field. The rev field is - you guessed it - roughly equivalent to the revision byte for PCI, with the exception that higher revisions should be strict supersets of lower revisions. The last byte of HVERSION, "type", and the last byte of SVERSION, "opt", belong together; type gives a very rough indication of what the device is supposed to do, and opt contains some type-specific information. (For example, the "bus converter" (ie bus bridge) type encodes the kind of bus behind the bridge in the opt field. The rest of HVERSION contains, in most cases, a number identifying the machine the chip was used in, or a revision indicator that just fixed bugs and didn't add any features (or was done in a shrinked process or whatever). So, here's the interface you actually should use to find your devices: /* Find a device, matching the model field of sversion only (from=NULL * for the first call */ struct iodc_dev *iodc_find_device(u32 sversion, struct iodc_dev *from); Here's a function you should use if you have special requirements, such as finding devices by type rather than by model. Generally, if you're using this, you should be me). /* Find a device, masking out bits as specified */ struct iodc_dev *iodc_find_device_mask(u32 hversion, u32 sversion, u32 hversion_mask, u32 sversion_mask, struct iodc_dev *from); Philipp Rumpf <prumpf@tux.org>