Add a CD FAQ question about firmware, and links for the fw images

1 files changed, 45 insertions, 0 deletions

diff --git a/english/CD/faq/index.wml b/english/CD/faq/index.wml
index fd79d3bb330..ad1c2c2cd17 100644
--- a/english/CD/faq/index.wml
+++ b/english/CD/faq/index.wml
@@ -61,6 +61,51 @@ drive</a>.</p>
 
 # ============================================================
 
+# This text is basically the same as what's in the Debian wiki at
+# https://wiki.debian.org/Firmware
+
+<toc-add-entry name="firmware">Debian installer tells me my hardware
+needs extra firmware to work. Where do I get that?</toc-add-entry>
+
+<p>Many devices require firmware to operate. Historically, firmware
+would be built into the device's ROM or Flash memory, but more and
+more often, a firmware image has to be loaded into the device by a
+device driver during device initialiaation.</p>
+
+<p>Some firmware images are free and open-source, and some of them are
+non-free, which means that you would need to add the non-free and
+contrib components to your APT sources.</p>
+
+<p>In some cases the installer detects the need for non-free firmware
+and prompts the user to make the firmware available to the installer
+to complete the installation. This can happen, for example, with
+wireless network cards which often require non-free firmware to
+function (see ipw2200 for an example).</p>
+
+<p>There are two ways to proceed here:</p>
+
+<ul>
+
+  <li>An easy method is to use an installer image that includes all
+    non-free firmware packages directly. See
+    <a href="https://cdimage.debian.org/cdimage/unofficial/non-free/cd-including-firmware/">https://cdimage.debian.org/cdimage/unofficial/non-free/cd-including-firmware/</a>
+    for those.</li>
+
+  <li>You can also download a firmware archive for your platform and
+    unpack it into a directory named <q>firmware</q> in the root of a
+    removable storage device (USB/CD drive). You can find firmware
+    downloads for your Debian version at
+    <a href="https://cdimage.debian.org/cdimage/unofficial/non-free/firmware/">https://cdimage.debian.org/cdimage/unofficial/non-free/firmware/</a>. When
+    the installer starts, it will automatically find the firmware
+    files in the directory on the removable storage and, if needed,
+    install the required firmware. This is documented in
+    the <a href="https://d-i.debian.org/doc/installation-guide/en.amd64/ch06s04.html">Debian
+    installer manual</a>.</li>
+
+</ul>
+
+# ============================================================
+
 <toc-add-entry name="mailing-list">My question is not answered by this
 FAQ!</toc-add-entry>