summaryrefslogtreecommitdiff
path: root/static/freebsd/man4/siis.4 3.html
blob: 47115bd00f989cded9d83becfb12713f1d7d0e0b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
<table class="head">
  <tr>
    <td class="head-ltitle">SIIS(4)</td>
    <td class="head-vol">Device Drivers Manual</td>
    <td class="head-rtitle">SIIS(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">siis</code> &#x2014;
    <span class="Nd">SiliconImage Serial ATA Host Controller driver</span></p>
</section>
<section class="Sh">
<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
<p class="Pp">To compile this driver into the kernel, place the following lines
    in your kernel configuration file:</p>
<div class="Bd Pp Bd-indent"><code class="Cd">device pci</code>
<br/>
<code class="Cd">device scbus</code>
<br/>
<code class="Cd">device siis</code></div>
<p class="Pp">Alternatively, to load the driver as a module at boot time, place
    the following line in <a class="Xr">loader.conf(5)</a>:</p>
<div class="Bd Pp Bd-indent Li">
<pre>siis_load=&quot;YES&quot;</pre>
</div>
<p class="Pp">The following tunables are settable from the
    <a class="Xr">loader(8)</a>:</p>
<dl class="Bl-ohang">
  <dt id="hint.siis."><var class="Va">hint.siis.</var><var class="Ar">X</var><var class="Va">.msi</var></dt>
  <dd>controls Message Signaled Interrupts (MSI) usage by the specified
      controller.</dd>
  <dt id="hint.siisch."><var class="Va">hint.siisch.</var><var class="Ar">X</var><var class="Va">.pm_level</var></dt>
  <dd>controls SATA interface Power Management for the specified channel,
      allowing some power to be saved at the cost of additional command latency.
      Possible values:
    <div class="Bd-indent">
    <dl class="Bl-tag">
      <dt>0</dt>
      <dd>interface Power Management is disabled (default);</dd>
      <dt>1</dt>
      <dd>device is allowed to initiate PM state change, host is passive.</dd>
    </dl>
    </div>
    <p class="Pp">Note that interface Power Management is not compatible with
        device presence detection. A manual bus reset is needed on device
        hot-plug.</p>
  </dd>
  <dt id="hint.siisch.~2"><var class="Va">hint.siisch.</var><var class="Ar">X</var><var class="Va">.sata_rev</var></dt>
  <dd>setting to nonzero value limits maximum SATA revision (speed). Values 1, 2
      and 3 are respectively 1.5, 3 and 6Gbps.</dd>
</dl>
</section>
<section class="Sh">
<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
<p class="Pp">This driver provides the <a class="Xr">CAM(4)</a> subsystem with
    native access to the SATA ports of controller. Each SATA port is represented
    to CAM as a separate bus with 16 targets. Most of the bus-management details
    are handled by the SATA-specific transport of CAM. Connected ATA disks are
    handled by the ATA protocol disk peripheral driver <a class="Xr">ada(4)</a>.
    ATAPI devices are handled by the SCSI protocol peripheral drivers
    <a class="Xr">cd(4)</a>, <a class="Xr">da(4)</a>, <a class="Xr">sa(4)</a>,
    etc.</p>
<p class="Pp">Driver features include support for Serial ATA and ATAPI devices,
    Port Multipliers (including FIS-based switching), hardware command queues
    (31 command per port), Native Command Queuing, SATA interface Power
    Management, device hot-plug and Message Signaled Interrupts.</p>
<p class="Pp">The activity LEDs of the adapters supported by the
    <code class="Nm">siis</code> driver can be controlled via the
    <a class="Xr">led(4)</a> API for localization or status reporting
  purposes.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="HARDWARE"><a class="permalink" href="#HARDWARE">HARDWARE</a></h1>
<p class="Pp">The <code class="Nm">siis</code> driver supports the following
    controller chips:</p>
<p class="Pp"></p>
<ul class="Bl-bullet Bl-compact">
  <li>SiI3124 (PCI-X 133MHz/64bit, 4 ports)</li>
  <li>SiI3131 (PCIe 1.0 x1, 1 port)</li>
  <li>SiI3132 (PCIe 1.0 x1, 2 ports)</li>
  <li>SiI3531 (PCIe 1.0 x1, 1 port)</li>
</ul>
</section>
<section class="Sh">
<h1 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h1>
<dl class="Bl-tag">
  <dt><span class="Pa">/dev/led/siisch*</span></dt>
  <dd>identification LED device nodes</dd>
</dl>
</section>
<section class="Sh">
<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
  ALSO</a></h1>
<p class="Pp"><a class="Xr">ada(4)</a>, <a class="Xr">ata(4)</a>,
    <a class="Xr">cam(4)</a>, <a class="Xr">cd(4)</a>, <a class="Xr">da(4)</a>,
    <a class="Xr">led(4)</a>, <a class="Xr">sa(4)</a></p>
</section>
<section class="Sh">
<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
<p class="Pp">The <code class="Nm">siis</code> driver first appeared in
    <span class="Ux">FreeBSD 8.0</span>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<p class="Pp"><span class="An">Alexander Motin</span>
    &lt;<a class="Mt" href="mailto:mav@FreeBSD.org">mav@FreeBSD.org</a>&gt;</p>
</section>
</div>
<table class="foot">
  <tr>
    <td class="foot-date">March 23, 2015</td>
    <td class="foot-os">FreeBSD 15.0</td>
  </tr>
</table>