1.\" Copyright (c) 1998,1999,2000 Katsushi Kobayashi and Hidetoshi Shimokawa 2.\" All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. 9.\" 2. Redistributions in binary form must reproduce the above copyright 10.\" notice, this list of conditions and the following disclaimer in the 11.\" documentation and/or other materials provided with the distribution. 12.\" 3. All advertising materials mentioning features or use of this software 13.\" must display the acknowledgement as below: 14.\" 15.\" This product includes software developed by K. Kobayashi and H. Shimokawa 16.\" 17.\" 4. The name of the author may not be used to endorse or promote products 18.\" derived from this software without specific prior written permission. 19.\" 20.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 21.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 22.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 23.\" DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, 24.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 25.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 26.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 28.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN 29.\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 30.\" POSSIBILITY OF SUCH DAMAGE. 31.\" 32.\" 33.Dd December 24, 2020 34.Dt FWOHCI 4 35.Os 36.Sh NAME 37.Nm fwohci 38.Nd OHCI FireWire chipset device driver 39.Sh SYNOPSIS 40To compile this driver into the kernel, 41place the following line in your 42kernel configuration file: 43.Bd -ragged -offset indent 44.Cd "device firewire" 45.Ed 46.Pp 47Alternatively, to load the driver as a 48module at boot time, place the following line in 49.Xr loader.conf 5 : 50.Bd -literal -offset indent 51firewire_load="YES" 52.Ed 53.Pp 54To disable physical access (see 55.Sx BUGS 56section for detail), put the following line in 57.Xr loader.conf 5 : 58.Bd -literal -offset indent 59hw.firewire.phydma_enable=0 60.Ed 61.Sh HARDWARE 62The 63.Nm 64driver provides support for PCI/CardBus FireWire interface cards. 65The driver supports the following IEEE 1394 OHCI chipsets: 66.Pp 67.Bl -bullet -compact 68.It 69Adaptec AHA-894x/AIC-5800 70.It 71Apple Pangea 72.It 73Apple UniNorth 74.It 75Intel 82372FB 76.It 77IOGEAR GUF320 78.It 79Lucent / Agere FW322/323 80.It 81NEC uPD72861 82.It 83NEC uPD72870 84.It 85NEC uPD72871/2 86.It 87NEC uPD72873 88.It 89NEC uPD72874 90.It 91National Semiconductor CS4210 92.It 93Ricoh R5C551 94.It 95Ricoh R5C552 96.It 97Sony CX3022 98.It 99Sony i.LINK (CXD3222) 100.It 101Texas Instruments PCI4410A 102.It 103Texas Instruments PCI4450 104.It 105Texas Instruments PCI4451 106.It 107Texas Instruments TSB12LV22 108.It 109Texas Instruments TSB12LV23 110.It 111Texas Instruments TSB12LV26 112.It 113Texas Instruments TSB43AA22 114.It 115Texas Instruments TSB43AB21/A/AI/A-EP 116.It 117Texas Instruments TSB43AB22/A 118.It 119Texas Instruments TSB43AB23 120.It 121Texas Instruments TSB82AA2 122.It 123VIA Fire II (VT6306) 124.El 125.Sh SEE ALSO 126.Xr firewire 4 , 127.Xr fwe 4 , 128.Xr fwip 4 , 129.Xr sbp 4 , 130.Xr fwcontrol 8 , 131.Xr kldload 8 132.Sh HISTORY 133The 134.Nm 135device driver first appeared in 136.Fx 5.0 . 137.Sh AUTHORS 138.An -nosplit 139The 140.Nm 141device driver was written by 142.An Katsushi Kobayashi 143and 144.An Hidetoshi Shimokawa . 145.Sh BUGS 146The driver allows physical access from any nodes on the bus by default. 147This means that any devices on the bus can read and modify any memory space 148which can be accessed by an IEEE 1394 OHCI chip. 149It is allowed mostly for 150.Xr sbp 4 151devices. 152This should be changed to allow it only for specific devices. 153Anyway, FireWire is a bus and not expected to be connected with 154un-trustable devices because a node can monitor all the traffic. 155