summaryrefslogtreecommitdiff
path: root/static/freebsd/man4/man4.i386/smapi.4 3.html
diff options
context:
space:
mode:
Diffstat (limited to 'static/freebsd/man4/man4.i386/smapi.4 3.html')
-rw-r--r--static/freebsd/man4/man4.i386/smapi.4 3.html92
1 files changed, 92 insertions, 0 deletions
diff --git a/static/freebsd/man4/man4.i386/smapi.4 3.html b/static/freebsd/man4/man4.i386/smapi.4 3.html
new file mode 100644
index 00000000..f7a17564
--- /dev/null
+++ b/static/freebsd/man4/man4.i386/smapi.4 3.html
@@ -0,0 +1,92 @@
+<table class="head">
+ <tr>
+ <td class="head-ltitle">SMAPI(4)</td>
+ <td class="head-vol">Device Drivers Manual (i386)</td>
+ <td class="head-rtitle">SMAPI(4)</td>
+ </tr>
+</table>
+<div class="manual-text">
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<p class="Pp"><code class="Nm">smapi</code> &#x2014; <span class="Nd">System
+ Management Application Program Interface driver</span></p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+<p class="Pp">Many IBM Thinkpad laptops utilize a special software interface
+ known as SMAPI (System Management Application Program Interface). This
+ interface controls various aspects of the system including:</p>
+<ul class="Bl-bullet">
+ <li>System Interface (the BIOS can store system information such as the system
+ identifier),</li>
+ <li>System Configuration (where devices such as the display can be
+ configured),</li>
+ <li>Power Management (software can interact with the SMAPI BIOS for Power
+ Management control).</li>
+</ul>
+<p class="Pp">Client software must locate a &#x201C;header image&#x201D; stored
+ in the <code class="Li">F000</code> segment in the Thinkpad ROM (read-only
+ memory), which resides at the 16-byte boundary. This is considered the
+ &#x201C;Entry Point&#x201D; for the service.</p>
+<p class="Pp">The &#x201C;header image&#x201D; stores information like:</p>
+<ul class="Bl-bullet">
+ <li>signature,</li>
+ <li>SMAPI version (major and minor),</li>
+ <li>header image length,</li>
+ <li>checksum information (which verifies the image),</li>
+ <li>an Information Word (used to identify the BIOS service level),</li>
+ <li>Real Mode Entry Point (where clients using the Real/V86 mode for the
+ far-call value),</li>
+ <li>and finally a 16-bit/32-bit Protected Mode Entry Point: base code address
+ which specifies the BIOS physical address. The client must prepare a 64
+ kilobyte selector for this BIOS).</li>
+</ul>
+<p class="Pp">To invoke the SMAPI BIOS, a far-call must be used on the entry
+ point specified in the header file. All other information should be stored
+ in the client data area. The client is required to prepare both an input and
+ output parameter in a data area of its own. This area can be
+ &#x201C;informed&#x201D; by pushing those pointers into its stack before the
+ far-calls.</p>
+<p class="Pp">The SMAPI BIOS uses the stack and data areas with the selector
+ during a BIOS invocation, thus the caller must define the same privilege
+ area as the BIOS.</p>
+<p class="Pp">The parameter structure will be made up by using the input and
+ output fields prepared by the caller. The input field will specify the
+ function request to the BIOS. The BIOS will then drop a return value into
+ the output field. These fields are made up of three parts. The first holds
+ parameters, function numbers, and return codes. The next will contain an
+ offset in hexadecimal. Finally a length field which is comprised of Byte,
+ Word, or Double Word.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
+<p class="Pp"><cite class="Rs"><i class="RsB">IBM Thinkpad 560/560E Technical
+ Reference</i>, <span class="RsO">06J0536 S76H-7587-01</span>.</cite></p>
+<p class="Pp"><cite class="Rs"><i class="RsB">IBM Thinkpad 560Z Technical
+ Reference</i>, <span class="RsO">xxxxxxx xxxx-xxxx-xx</span>.</cite></p>
+<p class="Pp"><cite class="Rs"><i class="RsB">IBM Thinkpad 600 Technical
+ Reference</i>, <span class="RsO">xxxxxxx xxxx-xxxx-xx</span>.</cite></p>
+<p class="Pp"><cite class="Rs"><i class="RsB">IBM Thinkpad 760XD/760XL/765D/765L
+ Technical Reference</i>, <span class="RsO">06J0537
+ S30H-2433-02</span>.</cite></p>
+<p class="Pp"><cite class="Rs"><i class="RsB">IBM Thinkpad 770 Technical
+ Reference</i>, <span class="RsO">05L1739 S05L-1739-00</span>.</cite></p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
+<p class="Pp">The <code class="Nm">smapi</code> driver was written by
+ <span class="An">Matthew N. Dodd</span>
+ &lt;<a class="Mt" href="mailto:mdodd@FreeBSD.org">mdodd@FreeBSD.org</a>&gt;.
+ This manual page was written by <span class="An">Tom Rhodes</span>
+ &lt;<a class="Mt" href="mailto:trhodes@FreeBSD.org">trhodes@FreeBSD.org</a>&gt;
+ and <span class="An">Matthew N. Dodd</span>
+ &lt;<a class="Mt" href="mailto:mdodd@FreeBSD.org">mdodd@FreeBSD.org</a>&gt;.</p>
+</section>
+</div>
+<table class="foot">
+ <tr>
+ <td class="foot-date">April 1, 2003</td>
+ <td class="foot-os">FreeBSD 15.0</td>
+ </tr>
+</table>