1.\" $NetBSD: efa.4,v 1.4 2011/10/30 14:31:05 wiz 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 October 25, 2011 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.El 64.Sh SEE ALSO 65.Xr ata 4 , 66.Xr wdc 4 67.Sh HISTORY 68The 69.Nm 70device first appeared in 71.Nx 6.0 . 72.Sh AUTHORS 73.An -nosplit 74The 75.Nm 76driver was written by 77.An Radoslaw Kujawa Aq radoslaw.kujawa@gmail.com . 78.Sh CAVEATS 79Older versions of FastATA 1200 are NOT supported: 80.Bl -tag -width "ELBOX FastATA 1200 Mk-II" -offset indent 81.It Em ELBOX FastATA 1200 Mk-I 82.It Em ELBOX FastATA 1200 Lite 83.It Em ELBOX FastATA 1200 GOLD 84.It Em ELBOX FastATA 1200 Mk-II 85.El 86.Pp 87These devices do not generate hardware interrupts and need to be driven in 88non-standard polling mode. 89Code needed to support it is present in driver but does not work correctly. 90.Pp 91Some of the above devices were also marketed under PowerFlyer and Winner brands. 92.Pp 93The onboard Gayle IDE controller can not be used when FastATA is installed and 94therefore, the 95.Nm 96driver will not coexist with 97.Xr wdc 4 98driver attached to 99.Xr mainbus 4 . 100Both 101.Nm 102and 103.Xr wdc 4 104can be enabled in the same kernel, but only one will attach (depending on the 105return value of probe function in the 106.Nm 107driver). 108.Pp 109DMA modes are not supported, this is a hardware limitation. 110.Sh BUGS 111Performance is worse than with official AmigaOS driver from ELBOX. 112.Pp 113Disks partitioned in split mode, which is specific to official AmigaOS FastATA 114driver, are not recognized in 115.Nx . 116