sgi-ioc4.txt 2.1 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950
  1. ====================================
  2. SGI IOC4 PCI (multi function) device
  3. ====================================
  4. The SGI IOC4 PCI device is a bit of a strange beast, so some notes on
  5. it are in order.
  6. First, even though the IOC4 performs multiple functions, such as an
  7. IDE controller, a serial controller, a PS/2 keyboard/mouse controller,
  8. and an external interrupt mechanism, it's not implemented as a
  9. multifunction device. The consequence of this from a software
  10. standpoint is that all these functions share a single IRQ, and
  11. they can't all register to own the same PCI device ID. To make
  12. matters a bit worse, some of the register blocks (and even registers
  13. themselves) present in IOC4 are mixed-purpose between these several
  14. functions, meaning that there's no clear "owning" device driver.
  15. The solution is to organize the IOC4 driver into several independent
  16. drivers, "ioc4", "sgiioc4", and "ioc4_serial". Note that there is no
  17. PS/2 controller driver as this functionality has never been wired up
  18. on a shipping IO card.
  19. ioc4
  20. ====
  21. This is the core (or shim) driver for IOC4. It is responsible for
  22. initializing the basic functionality of the chip, and allocating
  23. the PCI resources that are shared between the IOC4 functions.
  24. This driver also provides registration functions that the other
  25. IOC4 drivers can call to make their presence known. Each driver
  26. needs to provide a probe and remove function, which are invoked
  27. by the core driver at appropriate times. The interface of these
  28. IOC4 function probe and remove operations isn't precisely the same
  29. as PCI device probe and remove operations, but is logically the
  30. same operation.
  31. sgiioc4
  32. =======
  33. This is the IDE driver for IOC4. Its name isn't very descriptive
  34. simply for historical reasons (it used to be the only IOC4 driver
  35. component). There's not much to say about it other than it hooks
  36. up to the ioc4 driver via the appropriate registration, probe, and
  37. remove functions.
  38. ioc4_serial
  39. ===========
  40. This is the serial driver for IOC4. There's not much to say about it
  41. other than it hooks up to the ioc4 driver via the appropriate registration,
  42. probe, and remove functions.