1.\" $NetBSD: empb.4,v 1.13 2017/02/17 22:24:45 christos Exp $ 2.\" 3.\" Copyright (c) 2012 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 February 17, 2017 31.Dt EMPB 4 amiga 32.Os 33.Sh NAME 34.Nm empb 35.Nd ELBOX Mediator 1200 PCI bridge driver 36.Sh SYNOPSIS 37.Cd "empb0 at zbus0" 38.Cd "emmem0 at zbus0" 39.Cd "empm0 at zbus0" 40.Cd "pci* at empb0" 41.Cd "options PCI_NETBSD_CONFIGURE" 42.Sh DESCRIPTION 43The 44.Nm 45driver provides support for the PCI bus present on Mediator 1200 bridge for 46Amiga 1200. 47.Sh HARDWARE 48The 49.Nm 50driver supports the following hardware: 51.Bl -tag -offset indent 52.It ELBOX Mediator PCI 1200 53.It ELBOX Mediator PCI 1200 LT2 54.It ELBOX Mediator PCI 1200 LT4 55.It ELBOX Mediator PCI 1200 SX 56.It ELBOX Mediator PCI 1200 TX 57.El 58.Sh DIAGNOSTICS 59.Bl -diag 60.It empb: linear space mapping might not work 61The PCI card driver is trying map memory space with the 62.Dv BUS_SPACE_MAP_LINEAR 63flag. 64Due to the windowed design of Mediator, it is expected to fail miserably if 65normal memory space access methods (e.g., pointer dereference) are used 66instead of 67.Xr bus_space 9 68methods. 69.It empb%d: couldn't find memory space, check your WINDOW jumper 70PCI memory space access is disabled on a hardware level. 71The 72.Nm 73driver will work anyway, but only PCI I/O space will be accessible. 74To enable memory space set the WINDOW jumper to 4MB or 8MB. 75.El 76.Sh SEE ALSO 77.Xr amiga/em4k 4 , 78.Xr amiga/mppb 4 , 79.Xr amiga/p5pb 4 , 80.Xr pci 4 81.Sh HISTORY 82The 83.Nm 84device first appeared in 85.Nx 7.0 . 86.Sh AUTHORS 87.An -nosplit 88The 89.Nm 90driver was written by 91.An Radoslaw Kujawa Aq Mt radoslaw.kujawa@gmail.com . 92It was developed using information obtained through reverse engineering 93by 94.An Frank Wille 95and 96.An Radoslaw Kujawa . 97The authors have no access to official 98documentation (which is only available under NDA). 99.Sh CAVEATS 100Mediator ZIV might work but is untested. 101.Sh BUGS 102DMA to host memory is not supported. 103This is a hardware limitation. 104It is possible to implement DMA through bounce buffers in graphics card memory, 105but this needs further research. 106