Deleted Added
full compact
1$FreeBSD: head/sys/dev/firewire/00README 150789 2005-10-01 18:56:19Z glebius $
1$FreeBSD: head/sys/dev/firewire/00README 215334 2010-11-15 05:25:51Z dougb $
2
3IEEE 1394 support for FreeBSD-5.X and 4.X.
4
51. Introduction
6
7 This tarball contains IEEE1394(FireWire) driver which is first
8 written by Katsushi Kobayashi[1] <ikob@koganei.wide.ad.jp> and
9 modified by Hidetoshi Shimokawa <simokawa@freebsd.org>.
10 Please note this driver is still under development.
11 You can find latest snapshots under:
12 http://people.freebsd.org/~simokawa/
13 named firewire-2002XXXX.tar.gz
14
15 The driver consists of 6 parts:
16
17 - fwohci.c/fwohci_pci.c
18 OHCI[2] driver
19 - IEEE1394 link/phy chip control
20 - firewire.c
21 Chip independent driver
22 - CSR
23 - Transaction
24 - Character devices for userland
25 - fwmem.c
26 /dev/fwmem0: physical memory of a remote node.
27 - sbp.c
28 SBP-II[3] (a.k.a. SCSI over FireWire) driver
29
30 - if_fwe.c
31 NON-Standard implementation of Ethernet over FireWire.
32
33 - bus_mgm.c (userland)
34 Bus management function for user.
35 show topology map, change gap count, bus reset, etc.
36
372. Installation
38
39 Suppose you have kernel source at /sys.
40
41 - Extract tarball at root directory.
42 - cd /sys/dev/firewire
43 - make
44 - make install
45 - make load
46
47 For FreeBSD-4 user:
48
49 - ./MAKEDEV
50
473. SBP-II support (sbp)
48
49 - You need CAM(SCSI) support in your kernel.
50 If you are using FreeBSD-5 before 2002/03/23 or FreeBSD-4 before
51 2002/4/8, you need to apply CAM-patch in this archive
52 to handle HDD's(T_RBC or T_DIRECT which doesn't support READ_6).
53
54 - If you connect a few firewire devices only, try the following to
55 reduce gap overhead.
56
57 - ./bus_mgm -g 8
58
594. Ethernet over FireWire (if_fwe)
60
61 This is a sample driver for ethernet emulation. Please note this
62 does NOT conform to any standards like IP over FireWire(RFC2734[4]).
63 It just sends ethernet frames encapsulated in asynchronous stream
64 packets. It doesn't scale because it does something like unicast over multicast, but it's easy to be implemented and you can use any
65 facilities what ethernet can do. (ipv6, bridging, vlan etc.)
66
67 It also has DEVICE_POLLING[5] support. To enable it, edit your
68 kernel config file and Makefile.fwe then rebuild kernel and if_fwe.ko.
69
705. FireWire for Kernel Hackers
71
72 As you know, IEEE1394 is a bus and OHCI supports physical access
73 to the host memory. This means that you can access the remote
74 host over firewire without software support at the remote host.
75 In other words, you can investigate remote host's physical memory
76 whether its OS is alive or crashed or hangs up.
77
78 You need to apply KVMLIB-patch and rebuild libkvm then rebuild ps,
79 dmesg and gdb those are statically linked.
80 You may want to apply GDB-patch in this archive to get same behavior
81 as gdb with /dev/mem or want to insert savectx(&dumppcb) into panic(),
82 breakpoint() and so on to emulation crash dump.
83
84 You have to determine target node_id manually at this point.
85 (guess using bus_mgm -t or dmesg)
86 (Targets should be specified by EUI64 in the future)
87
88 # sysctl kern.firewire.fwmem_node=[node_id]
89
90 # ps -agx -M /dev/fwmem0 -N /sys/i386/compile/GENERIC/kernel
91 # dmesg -M /dev/fwmem0 -N /sys/i386/compile/GENERIC/kernel
92 # gdb -k -c /dev/fwmem0 /sys/i386/compile/GENERIC/kernel.debug
93 # dd if=/dev/fwmem0 of=vmcore bs=1m count=[phys. memory in MB]
94
95 remote gdb at 400,000,000 bps :-)
96
97
986. DV
99 I have not tested yet.
100
1017. Tested HW
102
103 OS
104 - FreeBSD-4/i386
105 - FreeBSD-4/alpha
106 - FreeBSD-5/i386
107
108 * Not tested on SMP.
109 * Not tested on big-endian machine...
110
111 OHCI
112 - Texas Instruments TSB12LV26 (PCI)
113 - Texas Instruments TSB43AA22 (PCI/Cardbus)
114
115 * There might be phy probing problem but most of the OHCI
116 chips should work.
117 * Tested with multiple firewire buses.
118
119 SBP-II
120 - HDD: Logitec USB/FireWire LHD-P30FU
121 - HDD: Yano A-dish 120GB
122 - HDD: Yano B-Max 320GB
123 The repository of cvsup2.jp.freebsd.org is on this device.
124 - HDD: Personal Storage 3000XT 160GB
125 The last sector of this drive cannot be accessed..
126 - DVD-RAM: Panasonic LF-D340JD
127 - SCSI-FireWire converter: Yano FWSCSI-01
128 We can recognize only 1 device/lun at this point
129 - HDD: iPod, PowerBook G4 (target mode)
130 Reported by ikob
131 - Scanner: Epson GT-9700F
132 Now works!!
133 Sane-backend needs a patch(SANE-patch in this archive).
134
135 if_fwe
136 - IPv4, IPv6, bridging, vlan.
137 - You need at least two FreeBSD machines with this driver to use.
138
139References:
140[1] ftp://ftp.uec.ac.jp/pub/firewire/beta/
141[2] http://developer.intel.com/technology/1394/download/ohci_11.htm
142[3] http://www.t10.org/scsi-3.htm
143[4] http://www.faqs.org/rfcs/rfc2734.html
144[5] http://info.iet.unipi.it/~luigi/polling/
145
146
147Hidetoshi Shimokawa
148simokawa@freebsd.org