xref: /dragonfly/share/man/man4/sili.4 (revision 71990c18)
1.\"	$OpenBSD: sili.4,v 1.3 2007/05/31 19:19:52 jmc Exp $
2.\"
3.\" Copyright (c) 2007 David Gwynne <dlg@openbsd.org>
4.\"
5.\" Permission to use, copy, modify, and distribute this software for any
6.\" purpose with or without fee is hereby granted, provided that the above
7.\" copyright notice and this permission notice appear in all copies.
8.\"
9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14.\" TORTIOUS ACTION, ARISING OUT OF
15.\" PERFORMANCE OF THIS SOFTWARE.
16.\"
17.Dd December 4, 2013
18.Dt SILI 4
19.Os
20.Sh NAME
21.Nm sili
22.Nd Silicon Image 3124/3132 SATA controller
23.Sh SYNOPSIS
24To compile this driver into the kernel,
25place the following line in your
26kernel configuration file:
27.Bd -ragged -offset indent
28.Cd "device sili"
29.Ed
30.Pp
31Alternatively, to load the driver as a
32module at boot time, place the following line in
33.Xr loader.conf 5 :
34.Bd -literal -offset indent
35sili_load="YES"
36.Ed
37.Sh DESCRIPTION
38The
39.Nm
40driver provides support for SATA controllers using the Silicon Image
413124/3132 SATALink chipsets. Both 3124-1 (1.5 Gbps) and 3124-2 (3 Gbps)
42versions of the 3124 chip are supported.
43.Pp
44Although
45.Nm
46controllers are actual ATA controllers, the driver emulates SCSI via a
47translation layer.
48.Sh LOADER TUNABLES
49The following hints may be set in
50.Xr loader.conf 5
51to control the
52.Nm
53driver's behavior.
54Note that the hint need only exist, so removing it requires commenting it out.
55.Pp
56Usually both the
57.Xr nata 4
58and the
59.Nm
60drivers are loaded.
61The
62.Xr nata 4
63driver will pick up any ata-like devices which the
64.Nm
65driver misses.
66If the
67.Nm
68driver is disabled the
69.Xr nata 4
70driver will typically pick up the
71.Nm
72devices, albeit under the
73.Pa ad
74disk name rather than the
75.Pa da
76disk name.
77.Bd -literal -offset indent
78hint.sili.disabled=1
79.Ed
80.Pp
81The
82.Nm
83driver can be told to force a lower-speed 1.5Gb link speed
84if necessary, and can also be told to refrain from attempting to send
85certain higher-level ATA commands to initialize ATA features which
86some devices might not properly implement.
87.Bd -literal -offset indent
88hint.sili.force150=1
89hint.sili.nofeatures=1
90.Ed
91.Pp
92The
93.Nm
94driver supports MSI but support is turned off by default.
95It can be enabled by setting the
96.Va hw.sili.msi.enable
97tunable to 1.
98.Sh SEE ALSO
99.Xr ahci 4 ,
100.Xr intro 4 ,
101.Xr nata 4 ,
102.Xr nvme 4 ,
103.Xr pci 4 ,
104.Xr scsi 4 ,
105.Xr loader.conf 5
106.Sh HISTORY
107The
108.Nm
109driver first appeared in
110.Dx 2.3 .
111.Sh AUTHORS
112.An -nosplit
113The
114.Nm
115driver was originally written by
116.An David Gwynne Aq Mt dlg@openbsd.org
117and
118.An Christopher Pascoe Aq Mt pascoe@openbsd.org
119for
120.Ox .
121.Pp
122It was ported to
123.Dx
124by
125.An Matt Dillon Aq Mt dillon@apollo.backplane.com ,
126who added new features such as hot-plug and port multiplier support.
127