← Back to branch summary

~ubuntu-branches/ubuntu/raring/installation-guide/raring-proposed

« back to all changes in this revision

Viewing changes to nl/using-d-i/loading-firmware.xml

  • Committer: Bazaar Package Importer
  • Author(s): Colin Watson
  • Date: 2008-11-20 19:15:23 UTC
  • Revision ID: james.westby@ubuntu.com-20081120191523-ewj4gnnj4k6skpn4
Tags: 20081113ubuntu1
* Document user-setup encrypted private directory preseeding.
* Resynchronise with Debian. Remaining changes:
  - Build only English (for now, until we figure out how to avoid trashing
    translations quite so badly with Ubuntu branding etc.).
  - Build only Ubuntu architectures (amd64, hppa, i386, ia64, lpia,
    powerpc, sparc).
  - Extensive (although possibly incomplete) Ubuntu branding, adjustments
    for our mirror layout, etc.
  - Add "Ubuntu and Debian" and "What is Ubuntu?" section, text borrowed
    from the Ubuntu web site. Disable the "What is Debian GNU/Linux?"
    section.
  - Direct installation reports to ubuntu-users for now.
  - Adjust various memory and disk space requirements. Talk about the
    default Ubuntu desktop and Ubuntu tasks rather than Debian tasks.
  - Document mounting /sys in various places.
  - Unset supports-floppy-boot for all our architectures.
  - Add a few more supports-floppy-boot and bootable-usb conditionals.
  - Document our root password and sudo arrangements.
  - Document netboot-style USB images. Still mention the hd-media images,
    but they're downplayed since many USB sticks are too small for a full
    Ubuntu ISO image.
  - Document Kickstart installations (currently only the basics, a
    reference to Red Hat's documentation, and the differences from
    Anaconda).
  - Update keyboard preseeding documentation for console-setup.
  - Update chroot-install guide for console-setup and language packs; add
    a bit more advice about installing grub.
  - Disable documentation of win32-loader.
  - Document new simplified partman preseeding.
  - Document mirror/udeb/components.
  - Document apt-setup/security_path.
  - Don't recommend passing http://archive.ubuntu.com/ubuntu to
    debootstrap.
  - Document partman/early_command.
  - Document pkgsel/update-policy.
* Bump kernelversion to 2.6.27.
* Bump GNOME version to 2.26.
* Bump release version and names for Jaunty.
* Re-enable documentation of the GTK frontend.

Show diffs side-by-side

added added

removed removed

Lines of Context:
nl/using-d-i/loading-firmware.xml
 
1
<!-- retain these comments for translator revision tracking -->
 
2
<!-- original version: 56290 untranslated -->
 
3
 
 
4
 <sect1 id="loading-firmware" arch="not-s390">
 
5
 <title>Loading Missing Firmware</title>
 
6
<para>
 
7
 
 
8
As described in <xref linkend="hardware-firmware"/>, some devices require
 
9
firmware to be loaded. In most cases the device will not work at all
 
10
if the firmware is not available; sometimes basic functionality is not
 
11
impaired if it is missing and the firmware is only needed to enable
 
12
additional features.
 
13
 
 
14
</para><para>
 
15
 
 
16
If a device driver requests firmware that is not available, &d-i; will
 
17
display a dialog offering to load the missing firmware. If this option
 
18
is selected, &d-i; will scan available devices for either loose firmware
 
19
files or packages containing firmware. If found, the firmware will be
 
20
copied to the correct location (<filename>/lib/firmware</filename>) and
 
21
the driver module will be reloaded.
 
22
 
 
23
</para>
 
24
<note><para>
 
25
 
 
26
Which devices are scanned and which file systems are supported depends on
 
27
the architecture, the installation method and the stage of the installation.
 
28
Especially during the early stages of the installation, loading the firmware
 
29
is most likely to succeed from a FAT-formatted floppy disk or USB stick.
 
30
<phrase arch="x86">On i386 and amd64 firmware can also be loaded from an
 
31
MMC or SD card.</phrase>
 
32
 
 
33
</para></note>
 
34
<para>
 
35
 
 
36
Note that it is possible to skip loading the firmware if you know the
 
37
device will also function without it, or if the device is not needed during
 
38
the installation.
 
39
 
 
40
</para>
 
41
<warning><para>
 
42
 
 
43
Support for loading firmware is still relatively basic and is likely to
 
44
be improved in future releases of the installer. Currently &d-i; will
 
45
for example not display any warning if you choose to load missing firmware,
 
46
but the requested firmware is not found.
 
47
Please report any issues you encounter by filing an installation report
 
48
(see <xref linkend="submit-bug"/>).
 
49
 
 
50
</para></warning>
 
51
 
 
52
  <sect2><title>Preparing a medium</title>
 
53
<para>
 
54
 
 
55
Although in some cases the firmware can also be loaded from a partition on
 
56
a hard disk, the most common method to load firmware will be from some
 
57
removable medium such as a floppy disk or a USB stick.
 
58
The firmware files or packages must be placed in either the root directory
 
59
or a directory named <filename>/firmware</filename> of the file system on
 
60
the medium. The recommended file system to use is FAT as that is most
 
61
certain to be supported during the early stages of the installation.
 
62
 
 
63
</para><para>
 
64
 
 
65
Tarballs containing current packages for the most common firmware are
 
66
available from:
 
67
 
 
68
<itemizedlist>
 
69
<listitem><para>
 
70
<ulink url="&url-firmware-tarballs;"/>
 
71
</para></listitem>
 
72
</itemizedlist>
 
73
 
 
74
Just download the tarball for the correct release and unpack it to the file
 
75
system on the medium.
 
76
 
 
77
</para><para>
 
78
 
 
79
If the firmware you need is not included in the tarball, you can also
 
80
download specific firmware packages from the (non-free section of the)
 
81
archive. The following overview should list most available firmware
 
82
packages but is not guaranteed to be complete and may also contain
 
83
non-firmware packages:
 
84
 
 
85
<itemizedlist>
 
86
<listitem><para>
 
87
<ulink url="&url-firmware-packages;"/>
 
88
</para></listitem>
 
89
</itemizedlist>
 
90
 
 
91
</para><para>
 
92
 
 
93
It is also possible to copy individual firmware files to the medium. Loose
 
94
firmware could be obtained for example from an already installed system or
 
95
from a hardware vendor.
 
96
 
 
97
</para>
 
98
  </sect2>
 
99
 
 
100
  <sect2><title>Firmware and the Installed System</title>
 
101
<para>
 
102
 
 
103
Any firmware loaded during the installation will be copied automatically
 
104
to the installed system. In most cases this will ensure that the device
 
105
that requires the firmware will also work correctly after the system is
 
106
rebooted into the installed system. However, if the installed system runs
 
107
a different kernel version from the installer there is a slight chance that
 
108
the firmware cannot be loaded due to version skew.
 
109
 
 
110
</para><para>
 
111
 
 
112
If the firmware was loaded from a firmware package, &d-i; will also install
 
113
this package for the installed system and will automatically add the non-free
 
114
section of the package archive in APT's <filename>sources.list</filename>.
 
115
This has the advantage that the firmware should be updated automatically if
 
116
a new version becomes available.
 
117
 
 
118
</para><para>
 
119
 
 
120
If loading the firmware was skipped during the installation, the relevant
 
121
device will probably not work with the installed system until the firmware
 
122
(package) is installed manually.
 
123
 
 
124
</para>
 
125
<note><para>
 
126
 
 
127
If the firmware was loaded from loose firmware files, the firmware copied to
 
128
the installed system will <emphasis>not</emphasis> be automatically updated
 
129
unless the corresponding firmware package (if available) is installed after
 
130
the installation is completed.
 
131
 
 
132
</para></note>
 
133
  </sect2>
 
134
 </sect1>