linux-3.3/Documentation/pnp.txt

4 ---------------------------------------------------------------------------------------
9 --------
12 services to compatible drivers.
17 ------------------
18 	The Linux Plug and Play user interface provides a means to activate PnP devices
22 In addition to the standard sysfs file the following are created in each
24 id - displays a list of support EISA IDs
25 options - displays possible resource configurations
26 resources - displays currently allocated resources and allows resource changes
28 -activating a device
32 this will invoke the automatic resource config system to activate the device
34 -manually activating a device
37 <depnum> - the configuration number
38 <mode> - static or dynamic
42 -disabling a device
49 Suppose you need to activate the floppy disk controller.
50 1.) change to the proper directory, in my case it is
60 - Notice the string "DISABLED".  This means the device is not active.
64 Dependent: 01 - Priority acceptable
65     port 0x3f0-0x3f0, align 0x7, size 0x6, 16-bit address decoding
66     port 0x3f7-0x3f7, align 0x0, size 0x1, 16-bit address decoding
68     dma 2 8-bit compatible
69 Dependent: 02 - Priority acceptable
70     port 0x370-0x370, align 0x7, size 0x6, 16-bit address decoding
71     port 0x377-0x377, align 0x0, size 0x1, 16-bit address decoding
73     dma 2 8-bit compatible
75 4.) now activate the device
80 io 0x3f0-0x3f5
81 io 0x3f7-0x3f7
94 -------------------------------
98 forwards commands to the proper protocol.  This makes writing PnP drivers
104 - increments the number of uses by one
107 - deincrements the number of uses by one
110 - use this to register a new PnP protocol
113 - use this function to remove a PnP protocol from the Plug and Play Layer
116 - adds a PnP driver to the Plug and Play Layer
117 - this includes driver model integration
118 - returns zero for success or a negative error number for failure; count
119   calls to the .add() method if you need to know how many devices bind to
123 - removes a PnP driver from the Plug and Play Layer
128 -----------------------
132 - PNPBIOS: used for system devices such as serial and parallel ports.
133 - ISAPNP: provides PnP support for the ISA bus
134 - ACPI: among its many uses, ACPI provides information about system level
136 It is meant to replace the PNPBIOS.  It is not currently supported by Linux
137 Plug and Play but it is planned to be in the near future.
143 - the ability to set resources is optional but preferred.
148 - use this function to add a PnP device to the PnP layer
149 - only call this function when all wanted values are set in the pnp_dev
153 - call this to initialize the PnP structure
156 - call this to remove a device from the Plug and Play Layer.
157 - it will fail if the device is still in use.
158 - automatically will free mem used by the device and related structures
161 - adds an EISA ID to the list of supported IDs for the specified device
169 ---------------------------
197 2.) Optionally define probe and remove functions.  It may make sense not to
238 A series of compatibility functions have been created to make it easy to convert