File: ift-extract.texi

package info (click to toggle)
isight-firmware-tools 1.6-4.2
  • links: PTS, VCS
  • area: contrib
  • in suites: trixie
  • size: 1,140 kB
  • sloc: sh: 1,283; ansic: 645; makefile: 52
file content (95 lines) | stat: -rw-r--r-- 2,365 bytes parent folder | download | duplicates (7)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
\input texinfo
@setfilename ift-extract.info
@settitle    Built-in iSight firmware extractor and patcher
@dircategory General Commands

@direntry
* ift-extract: (ift-extract).   Built-in iSight firmware extractor.
@end direntry


@copying
Copyright @copyright{} 2007 Étienne Bersac <bersace@@gmail.com>
@end copying

@titlepage
@title Built-in iSight firmware extractor and patcher

This file documents the `ift-extract` firmware extractor.

@page
@vskip 0pt plus 1filll
@insertcopying
@end titlepage

@contents

@ifnottex
@node top
@top Built-in iSight firmware extractor and patcher
@end ifnottex

ift-extract extract the Built-in iSight firmware from Apple driver and
patch it to avoid some bugs in it. The firmware is then ready to get
loaded into the chip using ift-load.

@menu
* Driver::      Finding the Apple driver
* Options::     Command line options
* Copying::
@end menu


@node Driver 
@chapter Finding the Apple driver

ift-extract extract Built-in iSight firmware from Apple iSight
driver. This driver is located at
/System/Library/Extensions/IOUSBFamily.kext/Contents/PlugIns/AppleUSBVideoSupport.kext/Contents/MacOS/AppleUSBVideoSupport
on your Mac OS X root partition.

There is several version of this driver depending on driver version or
host architecture (PowerPC or x86). Thus, ift-extract must determine
know the variant of the driver in order to properly extract the
firmware.

Any AppleUSBVideoSupport file starting with those shipped with iMac G5
iSight must work. If not, @b{please report unknown
AppleUSBVideoSupport} at bugreport mail address with machine type and
OS X version.

@node Options
@chapter Command line options

@table @samp
@item -a
@itemx --apple-driver
Apple driver filename where to extract the firmware.

@item -d
@itemx --output-directory
The directory where to output the firmware. Defaults to /lib/firmware.

@item -f
@itemx --output-filename
The output firmware name. Defaults to isight.fw

@item -?
@itemx --help
Shows option help and quit.
@end table

Since ift-extract defaults to output the firmware to
/lib/firmware/isight.fw, ensure you have the right to do so.

@node Copying
@chapter Copying

isight-firmware-tools is a project developped by Étienne Bersac based
on the work of Ronald S. Bultje, Johannes Berg and Ivan N. Zlatev.

This manual has been written by Étienne Bersac.

@insertcopying

@bye