xref: /netbsd-src/share/man/man4/man4.amiga/efa.4 (revision 6cb10275d08f045e872662c371fe2f2724f2f6e6)
1.\" $NetBSD: efa.4,v 1.8 2014/03/18 18:20:39 riastradh Exp $
2.\"
3.\" Copyright (c) 2011 The NetBSD Foundation, Inc.
4.\" All rights reserved.
5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Radoslaw Kujawa.
8.\"
9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions
11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright
13.\"    notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright
15.\"    notice, this list of conditions and the following disclaimer in the
16.\"    documentation and/or other materials provided with the distribution.
17.\"
18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
21.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28.\" POSSIBILITY OF SUCH DAMAGE.
29.\"
30.Dd April 13, 2012
31.Dt EFA 4 amiga
32.Os
33.Sh NAME
34.Nm efa
35.Nd ELBOX FastATA 1200 IDE disk controller driver
36.Sh SYNOPSIS
37.Cd "efa0 at mainbus0"
38.\".Cd "options EFA_32BIT_IO"
39.\".Cd "options EFA_NO_INTR"
40.Sh DESCRIPTION
41The
42.Nm
43driver provides support for the FastATA 1200 family of IDE controllers and
44provides the interface with the hardware for the
45.Xr ata 4
46driver.
47PIO modes 0, 3, 4 and 5 are supported.
48.\".Pp
49.\"The following kernel configuration options are available:
50.\".Bl -ohang
51.\".It Cd options EFA_32BIT_IO
52.\"Use 32-bit data port.
53.\".It Cd options EFA_NO_INTR
54.\"Disable hardware interrupt support.
55.\".El
56.Sh HARDWARE
57The
58.Nm
59driver supports the following hardware:
60.Bl -tag -width "ELBOX FastATA 1200 Mk-IV" -offset indent
61.It Em ELBOX FastATA 1200 Mk-III
62.It Em ELBOX FastATA 1200 Mk-IV
63.It Em ELBOX FastATA 1200 Mk-IV CF/SATA
64.El
65.Sh SEE ALSO
66.Xr ata 4 ,
67.Xr wdc 4
68.Sh HISTORY
69The
70.Nm
71device first appeared in
72.Nx 6.0 .
73.Sh AUTHORS
74.An -nosplit
75The
76.Nm
77driver was written by
78.An Radoslaw Kujawa Aq Mt radoslaw.kujawa@gmail.com .
79.Sh CAVEATS
80Older versions of FastATA 1200 are NOT supported:
81.Bl -tag -width "ELBOX FastATA 1200 Mk-II" -offset indent
82.It Em ELBOX FastATA 1200 Mk-I
83.It Em ELBOX FastATA 1200 Lite
84.It Em ELBOX FastATA 1200 GOLD
85.It Em ELBOX FastATA 1200 Mk-II
86.El
87.Pp
88These devices do not generate hardware interrupts and need to be driven in
89non-standard polling mode.
90Code needed to support it is present in driver but does not work correctly.
91.Pp
92Some of the above devices were also marketed under PowerFlyer and Winner brands.
93.Pp
94The onboard Gayle IDE controller can not be used when FastATA is installed and
95therefore, the
96.Nm
97driver will not coexist with
98.Xr wdc 4
99driver attached to
100.Xr mainbus 4 .
101Both
102.Nm
103and
104.Xr wdc 4
105can be enabled in the same kernel, but only one will attach (depending on the
106return value of probe function in the
107.Nm
108driver).
109.Pp
110DMA modes are not supported, this is a hardware limitation.
111.Sh BUGS
112Performance is worse than with official AmigaOS driver from ELBOX.
113.Pp
114Disks partitioned in split mode, which is specific to official AmigaOS FastATA
115driver, are not recognized in
116.Nx .
117