sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget#/translations/zh_CN/driver-api/eisamodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/zh_TW/driver-api/eisamodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/it_IT/driver-api/eisamodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/ja_JP/driver-api/eisamodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/ko_KR/driver-api/eisamodnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/pt_BR/driver-api/eisamodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/sp_SP/driver-api/eisamodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhcomment)}(h SPDX-License-Identifier: GPL-2.0h]h SPDX-License-Identifier: GPL-2.0}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhh=/var/lib/git/docbuild/linux/Documentation/driver-api/eisa.rsthKubhsection)}(hhh](htitle)}(hEISA bus supporth]hEISA bus support}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh field_list)}(hhh]hfield)}(hhh](h field_name)}(hAuthorh]hAuthor}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhKubh field_body)}(h'Marc Zyngier h]h paragraph)}(h&Marc Zyngier h](hMarc Zyngier <}(hhhhhNhNubh reference)}(hmaz@wild-wind.fr.eu.orgh]hmaz@wild-wind.fr.eu.org}(hj hhhNhNubah}(h]h ]h"]h$]h&]refurimailto:maz@wild-wind.fr.eu.orguh1jhhubh>}(hhhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhhubah}(h]h ]h"]h$]h&]uh1hhhubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh)}(hWThis document groups random notes about porting EISA drivers to the new EISA/sysfs API.h]hWThis document groups random notes about porting EISA drivers to the new EISA/sysfs API.}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh)}(hStarting from version 2.5.59, the EISA bus is almost given the same status as other much more mainstream buses such as PCI or USB. This has been possible through sysfs, which defines a nice enough set of abstractions to manage buses, devices and drivers.h]hStarting from version 2.5.59, the EISA bus is almost given the same status as other much more mainstream buses such as PCI or USB. This has been possible through sysfs, which defines a nice enough set of abstractions to manage buses, devices and drivers.}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh)}(hXCAlthough the new API is quite simple to use, converting existing drivers to the new infrastructure is not an easy task (mostly because detection code is generally also used to probe ISA cards). Moreover, most EISA drivers are among the oldest Linux drivers so, as you can imagine, some dust has settled here over the years.h]hXCAlthough the new API is quite simple to use, converting existing drivers to the new infrastructure is not an easy task (mostly because detection code is generally also used to probe ISA cards). Moreover, most EISA drivers are among the oldest Linux drivers so, as you can imagine, some dust has settled here over the years.}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(h2The EISA infrastructure is made up of three parts:h]h2The EISA infrastructure is made up of three parts:}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh block_quote)}(hX- The bus code implements most of the generic code. It is shared among all the architectures that the EISA code runs on. It implements bus probing (detecting EISA cards available on the bus), allocates I/O resources, allows fancy naming through sysfs, and offers interfaces for driver to register. - The bus root driver implements the glue between the bus hardware and the generic bus code. It is responsible for discovering the device implementing the bus, and setting it up to be latter probed by the bus code. This can go from something as simple as reserving an I/O region on x86, to the rather more complex, like the hppa EISA code. This is the part to implement in order to have EISA running on an "new" platform. - The driver offers the bus a list of devices that it manages, and implements the necessary callbacks to probe and release devices whenever told to. h]h bullet_list)}(hhh](h list_item)}(hX(The bus code implements most of the generic code. It is shared among all the architectures that the EISA code runs on. It implements bus probing (detecting EISA cards available on the bus), allocates I/O resources, allows fancy naming through sysfs, and offers interfaces for driver to register. h]h)}(hX'The bus code implements most of the generic code. It is shared among all the architectures that the EISA code runs on. It implements bus probing (detecting EISA cards available on the bus), allocates I/O resources, allows fancy naming through sysfs, and offers interfaces for driver to register.h]hX'The bus code implements most of the generic code. It is shared among all the architectures that the EISA code runs on. It implements bus probing (detecting EISA cards available on the bus), allocates I/O resources, allows fancy naming through sysfs, and offers interfaces for driver to register.}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjzubah}(h]h ]h"]h$]h&]uh1jxhjuubjy)}(hXThe bus root driver implements the glue between the bus hardware and the generic bus code. It is responsible for discovering the device implementing the bus, and setting it up to be latter probed by the bus code. This can go from something as simple as reserving an I/O region on x86, to the rather more complex, like the hppa EISA code. This is the part to implement in order to have EISA running on an "new" platform. h]h)}(hXThe bus root driver implements the glue between the bus hardware and the generic bus code. It is responsible for discovering the device implementing the bus, and setting it up to be latter probed by the bus code. This can go from something as simple as reserving an I/O region on x86, to the rather more complex, like the hppa EISA code. This is the part to implement in order to have EISA running on an "new" platform.h]hXThe bus root driver implements the glue between the bus hardware and the generic bus code. It is responsible for discovering the device implementing the bus, and setting it up to be latter probed by the bus code. This can go from something as simple as reserving an I/O region on x86, to the rather more complex, like the hppa EISA code. This is the part to implement in order to have EISA running on an “new” platform.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jxhjuubjy)}(hThe driver offers the bus a list of devices that it manages, and implements the necessary callbacks to probe and release devices whenever told to. h]h)}(hThe driver offers the bus a list of devices that it manages, and implements the necessary callbacks to probe and release devices whenever told to.h]hThe driver offers the bus a list of devices that it manages, and implements the necessary callbacks to probe and release devices whenever told to.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK'hjubah}(h]h ]h"]h$]h&]uh1jxhjuubeh}(h]h ]h"]h$]h&]bullet-uh1jshhhKhjoubah}(h]h ]h"]h$]h&]uh1jmhhhKhhhhubh)}(hbEvery function/structure below lives in , which depends heavily on .h]hbEvery function/structure below lives in , which depends heavily on .}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK+hhhhubh)}(hhh](h)}(hBus root driverh]hBus root driver}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK/ubh literal_block)}(h7int eisa_root_register (struct eisa_root_device *root);h]h7int eisa_root_register (struct eisa_root_device *root);}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhK3hjhhubh)}(hThe eisa_root_register function is used to declare a device as the root of an EISA bus. The eisa_root_device structure holds a reference to this device, as well as some parameters for probing purposes::h]hThe eisa_root_register function is used to declare a device as the root of an EISA bus. The eisa_root_device structure holds a reference to this device, as well as some parameters for probing purposes:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK5hjhhubj)}(hXstruct eisa_root_device { struct device *dev; /* Pointer to bridge device */ struct resource *res; unsigned long bus_base_addr; int slots; /* Max slot number */ int force_probe; /* Probe even when no slot 0 */ u64 dma_mask; /* from bridge device */ int bus_nr; /* Set by eisa_root_register */ struct resource eisa_root_res; /* ditto */ };h]hXstruct eisa_root_device { struct device *dev; /* Pointer to bridge device */ struct resource *res; unsigned long bus_base_addr; int slots; /* Max slot number */ int force_probe; /* Probe even when no slot 0 */ u64 dma_mask; /* from bridge device */ int bus_nr; /* Set by eisa_root_register */ struct resource eisa_root_res; /* ditto */ };}hj sbah}(h]h ]h"]h$]h&]hhuh1jhhhK9hjhhubhtable)}(hhh]htgroup)}(hhh](hcolspec)}(hhh]h}(h]h ]h"]h$]h&]colwidthK uh1j%hj"ubj&)}(hhh]h}(h]h ]h"]h$]h&]colwidthK6uh1j%hj"ubhtbody)}(hhh](hrow)}(hhh](hentry)}(hhh]h)}(hnodeh]hnode}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKEhjGubah}(h]h ]h"]h$]h&]uh1jEhjBubjF)}(hhh]h)}(h,used for eisa_root_register internal purposeh]h,used for eisa_root_register internal purpose}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKEhj^ubah}(h]h ]h"]h$]h&]uh1jEhjBubeh}(h]h ]h"]h$]h&]uh1j@hj=ubjA)}(hhh](jF)}(hhh]h)}(hdevh]hdev}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKFhj~ubah}(h]h ]h"]h$]h&]uh1jEhj{ubjF)}(hhh]h)}(hpointer to the root deviceh]hpointer to the root device}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKFhjubah}(h]h ]h"]h$]h&]uh1jEhj{ubeh}(h]h ]h"]h$]h&]uh1j@hj=ubjA)}(hhh](jF)}(hhh]h)}(hresh]hres}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKGhjubah}(h]h ]h"]h$]h&]uh1jEhjubjF)}(hhh]h)}(hroot device I/O resourceh]hroot device I/O resource}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKGhjubah}(h]h ]h"]h$]h&]uh1jEhjubeh}(h]h ]h"]h$]h&]uh1j@hj=ubjA)}(hhh](jF)}(hhh]h)}(h bus_base_addrh]h bus_base_addr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKHhjubah}(h]h ]h"]h$]h&]uh1jEhjubjF)}(hhh]h)}(hslot 0 address on this bush]hslot 0 address on this bus}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKHhjubah}(h]h ]h"]h$]h&]uh1jEhjubeh}(h]h ]h"]h$]h&]uh1j@hj=ubjA)}(hhh](jF)}(hhh]h)}(hslotsh]hslots}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKIhj#ubah}(h]h ]h"]h$]h&]uh1jEhj ubjF)}(hhh]h)}(hmax slot number to probeh]hmax slot number to probe}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKIhj:ubah}(h]h ]h"]h$]h&]uh1jEhj ubeh}(h]h ]h"]h$]h&]uh1j@hj=ubjA)}(hhh](jF)}(hhh]h)}(h force_probeh]h force_probe}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKJhjZubah}(h]h ]h"]h$]h&]uh1jEhjWubjF)}(hhh]h)}(h3Probe even when slot 0 is empty (no EISA mainboard)h]h3Probe even when slot 0 is empty (no EISA mainboard)}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKJhjqubah}(h]h ]h"]h$]h&]uh1jEhjWubeh}(h]h ]h"]h$]h&]uh1j@hj=ubjA)}(hhh](jF)}(hhh]h)}(hdma_maskh]hdma_mask}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKKhjubah}(h]h ]h"]h$]h&]uh1jEhjubjF)}(hhh]h)}(h5Default DMA mask. Usually the bridge device dma_mask.h]h5Default DMA mask. Usually the bridge device dma_mask.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKKhjubah}(h]h ]h"]h$]h&]uh1jEhjubeh}(h]h ]h"]h$]h&]uh1j@hj=ubjA)}(hhh](jF)}(hhh]h)}(hbus_nrh]hbus_nr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKLhjubah}(h]h ]h"]h$]h&]uh1jEhjubjF)}(hhh]h)}(h(unique bus id, set by eisa_root_registerh]h(unique bus id, set by eisa_root_register}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKLhjubah}(h]h ]h"]h$]h&]uh1jEhjubeh}(h]h ]h"]h$]h&]uh1j@hj=ubeh}(h]h ]h"]h$]h&]uh1j;hj"ubeh}(h]h ]h"]h$]h&]colsKuh1j hjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubeh}(h]bus-root-driverah ]h"]bus root driverah$]h&]uh1hhhhhhhhK/ubh)}(hhh](h)}(hDriverh]hDriver}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKPubj)}(hlint eisa_driver_register (struct eisa_driver *edrv); void eisa_driver_unregister (struct eisa_driver *edrv);h]hlint eisa_driver_register (struct eisa_driver *edrv); void eisa_driver_unregister (struct eisa_driver *edrv);}hj(sbah}(h]h ]h"]h$]h&]hhuh1jhhhKThjhhubh)}(hClear enough ?h]hClear enough ?}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKWhjhhubj)}(hstruct eisa_device_id { char sig[EISA_SIG_LEN]; unsigned long driver_data; }; struct eisa_driver { const struct eisa_device_id *id_table; struct device_driver driver; };h]hstruct eisa_device_id { char sig[EISA_SIG_LEN]; unsigned long driver_data; }; struct eisa_driver { const struct eisa_device_id *id_table; struct device_driver driver; };}hjDsbah}(h]h ]h"]h$]h&]hhuh1jhhhK[hjhhubj)}(hhh]j!)}(hhh](j&)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j%hjUubj&)}(hhh]h}(h]h ]h"]h$]h&]colwidthK=uh1j%hjUubj<)}(hhh](jA)}(hhh](jF)}(hhh]h)}(hid_tableh]hid_table}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKfhjrubah}(h]h ]h"]h$]h&]uh1jEhjoubjF)}(hhh]h)}(han array of NULL terminated EISA id strings, followed by an empty string. Each string can optionally be paired with a driver-dependent value (driver_data).h]han array of NULL terminated EISA id strings, followed by an empty string. Each string can optionally be paired with a driver-dependent value (driver_data).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKfhjubah}(h]h ]h"]h$]h&]uh1jEhjoubeh}(h]h ]h"]h$]h&]uh1j@hjlubjA)}(hhh](jF)}(hhh]h)}(hdriverh]hdriver}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKkhjubah}(h]h ]h"]h$]h&]uh1jEhjubjF)}(hhh]h)}(ha generic driver, such as described in Documentation/driver-api/driver-model/driver.rst. Only .name, .probe and .remove members are mandatory.h]ha generic driver, such as described in Documentation/driver-api/driver-model/driver.rst. Only .name, .probe and .remove members are mandatory.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKkhjubah}(h]h ]h"]h$]h&]uh1jEhjubeh}(h]h ]h"]h$]h&]uh1j@hjlubeh}(h]h ]h"]h$]h&]uh1j;hjUubeh}(h]h ]h"]h$]h&]colsKuh1j hjRubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubh)}(h An example is the 3c59x driver::h]hAn example is the 3c59x driver:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKphjhhubj)}(hXstatic struct eisa_device_id vortex_eisa_ids[] = { { "TCM5920", EISA_3C592_OFFSET }, { "TCM5970", EISA_3C597_OFFSET }, { "" } }; static struct eisa_driver vortex_eisa_driver = { .id_table = vortex_eisa_ids, .driver = { .name = "3c59x", .probe = vortex_eisa_probe, .remove = vortex_eisa_remove } };h]hXstatic struct eisa_device_id vortex_eisa_ids[] = { { "TCM5920", EISA_3C592_OFFSET }, { "TCM5970", EISA_3C597_OFFSET }, { "" } }; static struct eisa_driver vortex_eisa_driver = { .id_table = vortex_eisa_ids, .driver = { .name = "3c59x", .probe = vortex_eisa_probe, .remove = vortex_eisa_remove } };}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKrhjhhubeh}(h]driverah ]h"]driverah$]h&]uh1hhhhhhhhKPubh)}(hhh](h)}(hDeviceh]hDevice}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hThe sysfs framework calls .probe and .remove functions upon device discovery and removal (note that the .remove function is only called when driver is built as a module).h]hThe sysfs framework calls .probe and .remove functions upon device discovery and removal (note that the .remove function is only called when driver is built as a module).}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hBoth functions are passed a pointer to a 'struct device', which is encapsulated in a 'struct eisa_device' described as follows::h]hBoth functions are passed a pointer to a ‘struct device’, which is encapsulated in a ‘struct eisa_device’ described as follows:}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(hXBstruct eisa_device { struct eisa_device_id id; int slot; int state; unsigned long base_addr; struct resource res[EISA_MAX_RESOURCES]; u64 dma_mask; struct device dev; /* generic device */ };h]hXBstruct eisa_device { struct eisa_device_id id; int slot; int state; unsigned long base_addr; struct resource res[EISA_MAX_RESOURCES]; u64 dma_mask; struct device dev; /* generic device */ };}hjAsbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjhhubj)}(hhh]j!)}(hhh](j&)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j%hjRubj&)}(hhh]h}(h]h ]h"]h$]h&]colwidthKEuh1j%hjRubj<)}(hhh](jA)}(hhh](jF)}(hhh]h)}(hidh]hid}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjoubah}(h]h ]h"]h$]h&]uh1jEhjlubjF)}(hhh]h)}(hUEISA id, as read from device. id.driver_data is set from the matching driver EISA id.h]hUEISA id, as read from device. id.driver_data is set from the matching driver EISA id.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jEhjlubeh}(h]h ]h"]h$]h&]uh1j@hjiubjA)}(hhh](jF)}(hhh]h)}(hsloth]hslot}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jEhjubjF)}(hhh]h)}(h,slot number which the device was detected onh]h,slot number which the device was detected on}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jEhjubeh}(h]h ]h"]h$]h&]uh1j@hjiubjA)}(hhh](jF)}(hhh]h)}(hstateh]hstate}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jEhjubjF)}(hhh]h)}(hnset of flags indicating the state of the device. Current flags are EISA_CONFIG_ENABLED and EISA_CONFIG_FORCED.h]hnset of flags indicating the state of the device. Current flags are EISA_CONFIG_ENABLED and EISA_CONFIG_FORCED.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jEhjubeh}(h]h ]h"]h$]h&]uh1j@hjiubjA)}(hhh](jF)}(hhh]h)}(hresh]hres}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jEhjubjF)}(hhh]h)}(h:set of four 256 bytes I/O regions allocated to this deviceh]h:set of four 256 bytes I/O regions allocated to this device}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj+ubah}(h]h ]h"]h$]h&]uh1jEhjubeh}(h]h ]h"]h$]h&]uh1j@hjiubjA)}(hhh](jF)}(hhh]h)}(hdma_maskh]hdma_mask}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjKubah}(h]h ]h"]h$]h&]uh1jEhjHubjF)}(hhh]h)}(h$DMA mask set from the parent device.h]h$DMA mask set from the parent device.}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjbubah}(h]h ]h"]h$]h&]uh1jEhjHubeh}(h]h ]h"]h$]h&]uh1j@hjiubjA)}(hhh](jF)}(hhh]h)}(hdevh]hdev}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jEhjubjF)}(hhh]h)}(hEgeneric device (see Documentation/driver-api/driver-model/device.rst)h]hEgeneric device (see Documentation/driver-api/driver-model/device.rst)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jEhjubeh}(h]h ]h"]h$]h&]uh1j@hjiubeh}(h]h ]h"]h$]h&]uh1j;hjRubeh}(h]h ]h"]h$]h&]colsKuh1j hjOubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubh)}(h[You can get the 'struct eisa_device' from 'struct device' using the 'to_eisa_device' macro.h]hgYou can get the ‘struct eisa_device’ from ‘struct device’ using the ‘to_eisa_device’ macro.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]deviceah ]h"]deviceah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h Misc stuffh]h Misc stuff}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubj)}(h=void eisa_set_drvdata (struct eisa_device *edev, void *data);h]h=void eisa_set_drvdata (struct eisa_device *edev, void *data);}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjhhubh)}(h/Stores data into the device's driver_data area.h]h1Stores data into the device’s driver_data area.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(h2void *eisa_get_drvdata (struct eisa_device *edev):h]h2void *eisa_get_drvdata (struct eisa_device *edev):}hj sbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjhhubh)}(hFGets the pointer previously stored into the device's driver_data area.h]hHGets the pointer previously stored into the device’s driver_data area.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(h'int eisa_get_region_index (void *addr);h]h'int eisa_get_region_index (void *addr);}hj(sbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjhhubh)}(hKReturns the region number (0 <= x < EISA_MAX_RESOURCES) of a given address.h]hKReturns the region number (0 <= x < EISA_MAX_RESOURCES) of a given address.}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h] misc-stuffah ]h"] misc stuffah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hKernel parametersh]hKernel parameters}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjLhhhhhKubhdefinition_list)}(hhh](hdefinition_list_item)}(heisa_bus.enable_dev A comma-separated list of slots to be enabled, even if the firmware set the card as disabled. The driver must be able to properly initialize the device in such conditions. h](hterm)}(heisa_bus.enable_devh]heisa_bus.enable_dev}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhhKhjdubh definition)}(hhh]h)}(hA comma-separated list of slots to be enabled, even if the firmware set the card as disabled. The driver must be able to properly initialize the device in such conditions.h]hA comma-separated list of slots to be enabled, even if the firmware set the card as disabled. The driver must be able to properly initialize the device in such conditions.}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjzubah}(h]h ]h"]h$]h&]uh1jxhjdubeh}(h]h ]h"]h$]h&]uh1jbhhhKhj_ubjc)}(heisa_bus.disable_dev A comma-separated list of slots to be disabled, even if the firmware set the card as enabled. The driver won't be called to handle this device. h](ji)}(heisa_bus.disable_devh]heisa_bus.disable_dev}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhhKhjubjy)}(hhh]h)}(hA comma-separated list of slots to be disabled, even if the firmware set the card as enabled. The driver won't be called to handle this device.h]hA comma-separated list of slots to be disabled, even if the firmware set the card as enabled. The driver won’t be called to handle this device.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jxhjubeh}(h]h ]h"]h$]h&]uh1jbhhhKhj_hhubjc)}(hvirtual_root.force_probe Force the probing code to probe EISA slots even when it cannot find an EISA compliant mainboard (nothing appears on slot 0). Defaults to 0 (don't force), and set to 1 (force probing) when CONFIG_EISA_VLB_PRIMING is set. h](ji)}(hvirtual_root.force_probeh]hvirtual_root.force_probe}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhhKhjubjy)}(hhh]h)}(hForce the probing code to probe EISA slots even when it cannot find an EISA compliant mainboard (nothing appears on slot 0). Defaults to 0 (don't force), and set to 1 (force probing) when CONFIG_EISA_VLB_PRIMING is set.h]hForce the probing code to probe EISA slots even when it cannot find an EISA compliant mainboard (nothing appears on slot 0). Defaults to 0 (don’t force), and set to 1 (force probing) when CONFIG_EISA_VLB_PRIMING is set.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jxhjubeh}(h]h ]h"]h$]h&]uh1jbhhhKhj_hhubeh}(h]h ]h"]h$]h&]uh1j]hjLhhhhhNubeh}(h]kernel-parametersah ]h"]kernel parametersah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h Random notesh]h Random notes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hX;Converting an EISA driver to the new API mostly involves *deleting* code (since probing is now in the core EISA code). Unfortunately, most drivers share their probing routine between ISA, and EISA. Special care must be taken when ripping out the EISA code, so other buses won't suffer from these surgical strikes...h](h9Converting an EISA driver to the new API mostly involves }(hjhhhNhNubhemphasis)}(h *deleting*h]hdeleting}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh code (since probing is now in the core EISA code). Unfortunately, most drivers share their probing routine between ISA, and EISA. Special care must be taken when ripping out the EISA code, so other buses won’t suffer from these surgical strikes...}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hXYou *must not* expect any EISA device to be detected when returning from eisa_driver_register, since the chances are that the bus has not yet been probed. In fact, that's what happens most of the time (the bus root driver usually kicks in rather late in the boot process). Unfortunately, most drivers are doing the probing by themselves, and expect to have explored the whole machine when they exit their probe routine.h](hYou }(hj6hhhNhNubj)}(h *must not*h]hmust not}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubhX expect any EISA device to be detected when returning from eisa_driver_register, since the chances are that the bus has not yet been probed. In fact, that’s what happens most of the time (the bus root driver usually kicks in rather late in the boot process). Unfortunately, most drivers are doing the probing by themselves, and expect to have explored the whole machine when they exit their probe routine.}(hj6hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hdFor example, switching your favorite EISA SCSI card to the "hotplug" model is "the right thing"(tm).h]hlFor example, switching your favorite EISA SCSI card to the “hotplug” model is “the right thing”(tm).}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h] random-notesah ]h"] random notesah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hThanksh]hThanks}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1hhjlhhhhhKubh)}(h6I'd like to thank the following people for their help:h]h8I’d like to thank the following people for their help:}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjlhhubjt)}(hhh](jy)}(h7Xavier Benigni for lending me a wonderful Alpha Jensen,h]h)}(hjh]h7Xavier Benigni for lending me a wonderful Alpha Jensen,}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jxhjhhhhhNubjy)}(hDJames Bottomley, Jeff Garzik for getting this stuff into the kernel,h]h)}(hjh]hDJames Bottomley, Jeff Garzik for getting this stuff into the kernel,}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jxhjhhhhhNubjy)}(h3Andries Brouwer for contributing numerous EISA ids,h]h)}(hjh]h3Andries Brouwer for contributing numerous EISA ids,}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jxhjhhhhhNubjy)}(h;Catrin Jones for coping with far too many machines at home.h]h)}(hjh]h;Catrin Jones for coping with far too many machines at home.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jxhjhhhhhNubeh}(h]h ]h"]h$]h&]jjuh1jshhhKhjlhhubeh}(h]thanksah ]h"]thanksah$]h&]uh1hhhhhhhhKubeh}(h]eisa-bus-supportah ]h"]eisa bus supportah$]h&]uh1hhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksjEfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerj" error_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourcehnj _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}nameids}(jjjjjjjjjIjFjjjijfjju nametypes}(jjjjjIjjijuh}(jhjjjjjjjFjjjLjfjjjlu footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}Rparse_messages]transform_messages] transformerN include_log] decorationNhhub.