ds sw.htm

What is this ``device driver stuff anyway? Here s a very short introduction to the concept.

The bus is present but not yet configured.
</td>
</tr>
<tr>
<td align="left" valign="top">
<tt>ALV_NOCNFG</tt>
</td>
<td align="left" valign="top">
The bus is not to be configured.
</td>
</tr>
<tr>
<td align="left" valign="top">
<tt>ALV_LOADABLE</tt>
</td>
<td align="left" valign="top">
The bus is present and resolved as loadable.
</td>
</tr>
<tr>
<td align="left" valign="top">
<tt>ALV_NOSIZER</tt>
</td>
<td align="left" valign="top">
The
<tt>sizer</tt>
program should ignore these
<tt>bus</tt>
structures.
This bit is set for dynamically configured drivers.
It indicates that this
<tt>bus</tt>
structure is not part of the static configuration.
</td>
</tr>
</tbody></table></p><p>
<a name="framework"></a>
</p><p></p><hr><p align="center">
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/Digital_UNIX_Bookshelf.html"><img src="DS%20sw_files/BOOKSHELF.GIF" alt="[Return to Library]" border="0"></a>
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/AA-PUBVD-TE_html/TOC.html"><img src="DS%20sw_files/TOC.GIF" alt="[Contents]" border="0"></a>
<a href="#DeviceAutoconfig"><img src="DS%20sw_files/REW.GIF" alt="[Previous Chapter]" border="0"></a>
<a href="#alive"><img src="DS%20sw_files/PREV.GIF" alt="[Previous Section]" border="0"></a>
<a href="#bus_bridge_dma"><img src="DS%20sw_files/NEXT.GIF" alt="[Next Section]" border="0"></a>
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/AA-PUBVD-TE_html/drivertut25.html"><img src="DS%20sw_files/FF.GIF" alt="[Next Chapter]" border="0"></a>
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/AA-PUBVD-TE_html/INDEX.html"><img src="DS%20sw_files/INDEX.GIF" alt="[Index]" border="0"></a>
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/HELP.html"><img src="DS%20sw_files/HELP.GIF" alt="[Help]" border="0"></a>
</p><p></p><hr><p>
</p><h3>
17.1.10&nbsp;&nbsp;&nbsp;&nbsp;The framework and driver_name Members
</h3>
<p>
<a name="nx_id_732"></a>
The
<tt>framework</tt>
member specifies
a pointer to the
<tt>bus_framework</tt>
structure.
This structure contains pointers to bus interfaces for dynamically
configured device drivers.
These interfaces provide dynamic extensions to bus functionality.
They are used in the autoconfiguration of dynamically configured
drivers to perform
bus-specific tasks, such as the registration of interrupt handlers.
The
<tt>framework</tt>
member is initialized by the bus adapter driver.
</p><p>
Device driver writers seldom need to reference this member in
their device drivers.
However, bus adapter driver writers might reference this member in
their bus adapter code.
</p><p>
The
<tt>driver_name</tt>
member specifies
the name of the controlling device driver.
<a name="nx_id_733"></a>
</p><p>
The autoconfiguration software sets the
<tt>driver_name</tt>
members to
<tt><var>xx</var>driver</tt>,
where
<tt><var>xx</var></tt>
is the driver name as specified by the device driver entry in the
<tt>sysconfigtab</tt>
file fragment.
The following example shows one such entry:
</p><p>
</p><pre><br>.<br>.<br>.<br>
none:
<br>.<br>.<br>.<br>
</pre>
<p>
</p><p>
Device driver writers seldom need to reference this member in
their device drivers.
However, bus adapter driver writers might reference this member in
their bus adapter code.
</p><p>
<a name="bus_bridge_dma"></a>
</p><p></p><hr><p align="center">
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/Digital_UNIX_Bookshelf.html"><img src="DS%20sw_files/BOOKSHELF.GIF" alt="[Return to Library]" border="0"></a>
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/AA-PUBVD-TE_html/TOC.html"><img src="DS%20sw_files/TOC.GIF" alt="[Contents]" border="0"></a>
<a href="#DeviceAutoconfig"><img src="DS%20sw_files/REW.GIF" alt="[Previous Chapter]" border="0"></a>
<a href="#framework"><img src="DS%20sw_files/PREV.GIF" alt="[Previous Section]" border="0"></a>
<a href="#private"><img src="DS%20sw_files/NEXT.GIF" alt="[Next Section]" border="0"></a>
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/AA-PUBVD-TE_html/drivertut25.html"><img src="DS%20sw_files/FF.GIF" alt="[Next Chapter]" border="0"></a>
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/AA-PUBVD-TE_html/INDEX.html"><img src="DS%20sw_files/INDEX.GIF" alt="[Index]" border="0"></a>
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/HELP.html"><img src="DS%20sw_files/HELP.GIF" alt="[Help]" border="0"></a>
</p><p></p><hr><p>
</p><h3>
17.1.11&nbsp;&nbsp;&nbsp;&nbsp;The bus_bridge_dma Member
</h3>
<p>
<a name="nx_id_734"></a>
The
<tt>bus_bridge_dma</tt>
member specifies
that the bus adapter has direct memory access (DMA) mapping support.
The
<tt>bus_bridge_dma</tt>
member is initialized by the bus adapter driver.
</p><p>
Device driver writers seldom need to reference this member in
their device drivers.
However, bus adapter driver writers might reference this member in
their bus adapter code.
<a name="private"></a>
</p><p></p><hr><p align="center">
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/Digital_UNIX_Bookshelf.html"><img src="DS%20sw_files/BOOKSHELF.GIF" alt="[Return to Library]" border="0"></a>
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/AA-PUBVD-TE_html/TOC.html"><img src="DS%20sw_files/TOC.GIF" alt="[Contents]" border="0"></a>
<a href="#DeviceAutoconfig"><img src="DS%20sw_files/REW.GIF" alt="[Previous Chapter]" border="0"></a>
<a href="#bus_bridge_dma"><img src="DS%20sw_files/PREV.GIF" alt="[Previous Section]" border="0"></a>
<a href="#ControlStruct"><img src="DS%20sw_files/NEXT.GIF" alt="[Next Section]" border="0"></a>
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/AA-PUBVD-TE_html/drivertut25.html"><img src="DS%20sw_files/FF.GIF" alt="[Next Chapter]" border="0"></a>
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/AA-PUBVD-TE_html/INDEX.html"><img src="DS%20sw_files/INDEX.GIF" alt="[Index]" border="0"></a>
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/HELP.html"><img src="DS%20sw_files/HELP.GIF" alt="[Help]" border="0"></a>
</p><p></p><hr><p>
</p><h3>
17.1.12&nbsp;&nbsp;&nbsp;&nbsp;The private, conn_priv, and rsvd Members
</h3>
<p>
<a name="nx_id_735"></a>
<a name="nx_id_736"></a>
<a name="nx_id_737"></a>
The
<tt>private</tt>
member specifies
private storage for use by this bus or bus class.
The
<tt>conn_priv</tt>
member specifies
private storage for use by the bus that this bus is connected
to.
The
<tt>rsvd</tt>
member is reserved for future expansion of the data structure.
<a name="ControlStruct"></a>
</p><p></p><hr><p align="center">
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/Digital_UNIX_Bookshelf.html"><img src="DS%20sw_files/BOOKSHELF.GIF" alt="[Return to Library]" border="0"></a>
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/AA-PUBVD-TE_html/TOC.html"><img src="DS%20sw_files/TOC.GIF" alt="[Contents]" border="0"></a>
<a href="#DeviceAutoconfig"><img src="DS%20sw_files/REW.GIF" alt="[Previous Chapter]" border="0"></a>
<a href="#private"><img src="DS%20sw_files/PREV.GIF" alt="[Previous Section]" border="0"></a>
<a href="#ctlrmbox"><img src="DS%20sw_files/NEXT.GIF" alt="[Next Section]" border="0"></a>
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/AA-PUBVD-TE_html/drivertut25.html"><img src="DS%20sw_files/FF.GIF" alt="[Next Chapter]" border="0"></a>
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/AA-PUBVD-TE_html/INDEX.html"><img src="DS%20sw_files/INDEX.GIF" alt="[Index]" border="0"></a>
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/HELP.html"><img src="DS%20sw_files/HELP.GIF" alt="[Help]" border="0"></a>
</p><p></p><hr><p>
</p><h2>
17.2&nbsp;&nbsp;&nbsp;&nbsp;The controller Structure
</h2>
<p>
The
<tt>controller</tt>
structure represents an instance of a controller entity, one that
connects logically to a bus.
A controller can control devices that are directly connected or can
perform some other controlling operation, such as a network interface or
terminal controller operation.
<a name="nx_id_738"></a>
</p><p>
Device driver writers create
<tt>controller</tt>
structures by calling the
<tt>create_controller_struct</tt>
interface and passing to it a filled-in
<tt>controller_config</tt>
structure.
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/AA-PUBVD-TE_html/drivertut10.html#controller_configDataStruct">Section 6.6.4.1</a>
discusses the
<tt>controller_config</tt>
structure and
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/AA-PUBVD-TE_html/drivertut10.html#UsingCreRtnstoRegContrlDevInfo">Section 6.6.4.3</a>
discusses how to call the
<tt>create_controller_struct</tt>
interface.
</p><p>
<a href="http://h30097.www3.hp.com/docs/base_doc/DOCUMENTATION/HTML/AA-PUBVD-TE_html/drivertut24.html#TblControllerStructMembers">Table 17-2</a>
lists the members of the
<tt>controller</tt>
structure, along with their associated data types.
</p><p>
<a name="TblControllerStructMembers"></a>
</p><h3>
Table 17-2: Members of the controller Structure
</h3>
<a name="nx_id_739"></a>
<table border="4" cellpadding="4">
<tbody><tr>
<td align="left" valign="top">
<strong>
Member Name
</strong>
</td>
<td align="left" valign="top">
<strong>
Data Type
</strong>
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
ctlr_mbox
</tt></strong>
</td>
<td align="left" valign="top">
<strong><tt>
u_long *
</tt></strong>
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
bus_hd
</tt></strong>
</td>
<td align="left" valign="top">
<strong><tt>
struct bus *
</tt></strong>
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
nxt_ctlr
</tt></strong>
</td>
<td align="left" valign="top">
<strong><tt>
struct controller *
</tt></strong>
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
dev_list
</tt></strong>
</td>
<td align="left" valign="top">
<strong><tt>
struct device *
</tt></strong>
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
driver
</tt></strong>
</td>
<td align="left" valign="top">
<strong><tt>
struct driver *
</tt></strong>
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
ctlr_type
</tt></strong>
</td>
<td align="left" valign="top">
<strong><tt>
int
</tt></strong>
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
ctlr_name
</tt></strong>
</td>
<td align="left" valign="top">
<strong><tt>
char *
</tt></strong>
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
ctlr_num
</tt></strong>
</td>
<td align="left" valign="top">
<strong><tt>
int
</tt></strong>
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
bus_name
</tt></strong>
</td>
<td align="left" valign="top">
<strong><tt>
char *
</tt></strong>
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
bus_num
</tt></strong>
</td>
<td align="left" valign="top">
<strong><tt>
int
</tt></strong>
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
rctlr
</tt></strong>
</td>
<td align="left" valign="top">
<strong><tt>
int
</tt></strong>
</td>
</tr>
<tr>
<td align="left" valign="top">
<strong><tt>
slot
</tt></strong>