Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

Documentation/: update FireWire debugging documentation

The old firewire stack is long dead now and a new version firescope has
been released with support for current kernels.

Signed-off-by: Lubomir Rintel <lkundrak@v3.sk>
Cc: Rob Landley <rob@landley.net>
Cc: Justin P. Mattock <justinmattock@gmail.com>
Cc: Bernhard Kaindl <bk@suse.de>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
Signed-off-by: Stefan Richter <stefanr@s5r6.in-berlin.de>

authored by

Lubomir Rintel and committed by
Stefan Richter
a9954ce7 7e22e911

+10 -16
+9 -15
Documentation/debugging-via-ohci1394.txt
··· 36 36 Drivers 37 37 ------- 38 38 39 - The ohci1394 driver in drivers/ieee1394 initializes the OHCI-1394 controllers 40 - to a working state and enables physical DMA by default for all remote nodes. 41 - This can be turned off by ohci1394's module parameter phys_dma=0. 42 - 43 - The alternative firewire-ohci driver in drivers/firewire uses filtered physical 39 + The firewire-ohci driver in drivers/firewire uses filtered physical 44 40 DMA by default, which is more secure but not suitable for remote debugging. 45 41 Compile the driver with CONFIG_FIREWIRE_OHCI_REMOTE_DMA (Kernel hacking menu: 46 42 Remote debugging over FireWire with firewire-ohci) to get unfiltered physical 47 43 DMA. 48 44 49 - Because ohci1394 and firewire-ohci depend on the PCI enumeration to be 45 + Because the firewire-ohci driver depends on the PCI enumeration to be 50 46 completed, an initialization routine which runs pretty early has been 51 47 implemented for x86. This routine runs long before console_init() can be 52 48 called, i.e. before the printk buffer appears on the console. ··· 60 64 61 65 Bernhard Kaindl enhanced firescope to support accessing 64-bit machines 62 66 from 32-bit firescope and vice versa: 63 - - http://halobates.de/firewire/firescope-0.2.2.tar.bz2 67 + - http://v3.sk/~lkundrak/firescope/ 64 68 65 69 and he implemented fast system dump (alpha version - read README.txt): 66 70 - http://halobates.de/firewire/firedump-0.1.tar.bz2 ··· 88 92 89 93 1) Verify that your hardware is supported: 90 94 91 - Load the ohci1394 or the fw-ohci module and check your kernel logs. 95 + Load the firewire-ohci module and check your kernel logs. 92 96 You should see a line similar to 93 97 94 - ohci1394: fw-host0: OHCI-1394 1.1 (PCI): IRQ=[18] MMIO=[fe9ff800-fe9fffff] 95 - ... Max Packet=[2048] IR/IT contexts=[4/8] 98 + firewire_ohci 0000:15:00.1: added OHCI v1.0 device as card 2, 4 IR + 4 IT 99 + ... contexts, quirks 0x11 96 100 97 101 when loading the driver. If you have no supported controller, many PCI, 98 102 CardBus and even some Express cards which are fully compliant to OHCI-1394 ··· 109 113 110 114 If an driver is running on both machines you should see a line like 111 115 112 - ieee1394: Node added: ID:BUS[0-01:1023] GUID[0090270001b84bba] 116 + firewire_core 0000:15:00.1: created device fw1: GUID 00061b0020105917, S400 113 117 114 118 on both machines in the kernel log when the cable is plugged in 115 119 and connects the two machines. 116 120 117 121 3) Test physical DMA using firescope: 118 122 119 - On the debug host, 120 - - load the raw1394 module, 121 - - make sure that /dev/raw1394 is accessible, 123 + On the debug host, make sure that /dev/fw* is accessible, 122 124 then start firescope: 123 125 124 126 $ firescope 125 - Port 0 (ohci1394) opened, 2 nodes detected 127 + Port 0 (/dev/fw1) opened, 2 nodes detected 126 128 127 129 FireScope 128 130 ---------
+1 -1
Documentation/power/basic-pm-debugging.txt
··· 172 172 kernel messages using the serial console. This may provide you with some 173 173 information about the reasons of the suspend (resume) failure. Alternatively, 174 174 it may be possible to use a FireWire port for debugging with firescope 175 - (ftp://ftp.firstfloor.org/pub/ak/firescope/). On x86 it is also possible to 175 + (http://v3.sk/~lkundrak/firescope/). On x86 it is also possible to 176 176 use the PM_TRACE mechanism documented in Documentation/power/s2ram.txt . 177 177 178 178 2. Testing suspend to RAM (STR)