From aa49ebdb45dba3bc6a3c00a30c089ea598d77a37 Mon Sep 17 00:00:00 2001
From: jbtrystram <jbtrystram@redhat.com>
Date: Mon, 15 Apr 2024 11:57:07 +0200
Subject: [PATCH] Add a page for wifi to document firmwares removal

Some wifi-firmwares will be split into sub-packages in fedora 40
We will keep them in until fedora 41, but display a warning message
in the console. This messages links to this FAQ entry.

See  https://github.com/coreos/fedora-coreos-config/pull/2963
See  https://github.com/coreos/fedora-coreos-tracker/issues/1575
---
 modules/ROOT/nav.adoc        |  1 +
 modules/ROOT/pages/wifi.adoc | 48 ++++++++++++++++++++++++++++++++++++
 2 files changed, 49 insertions(+)
 create mode 100644 modules/ROOT/pages/wifi.adoc

diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc
index f3f56899..324d9f4f 100644
--- a/modules/ROOT/nav.adoc
+++ b/modules/ROOT/nav.adoc
@@ -43,6 +43,7 @@
 ** xref:time-zone.adoc[Configuring Time Zone]
 ** xref:grub-password.adoc[Setting a GRUB password]
 ** xref:audit.adoc[Managing the audit daemon]
+** xref:wifi.adoc[Wi-Fi Network configuration]
 * OS updates
 ** xref:update-streams.adoc[Update Streams]
 ** xref:auto-updates.adoc[Auto-Updates]
diff --git a/modules/ROOT/pages/wifi.adoc b/modules/ROOT/pages/wifi.adoc
new file mode 100644
index 00000000..97b1e3e6
--- /dev/null
+++ b/modules/ROOT/pages/wifi.adoc
@@ -0,0 +1,48 @@
+
+== How do I add the missing wifi-firmwares?
+
+Some wifi-firmwares will be split into sub-packages in Fedora 39 and Fedora 40.
+Fedora Cores OS will keep them in until Fedora 41, but display a
+warning message in the console if NetworkManager-wifi is layered without
+any other wifi firmware packages having a layering request.
+
+If NetworkManager-wifi is a requested layered package, a warning is
+displayed to encourage users to also add a wifi-firmware.
+
+.Install thre required firmware for your hardware:
+[source, text]
+----
+$ sudo rpm-ostree install iwlwifi-dvm-firmware --allow-inactive
+----
+
+If you don't know what firmware to install you can install
+all the wireless firmwares available in Fedora.
+Please note this approach is un-optimal as it will add a lot
+of uneeded packages on your system.
+.Install all the wifi firmwares
+----
+$ sudo rpm-ostree install --allow-inactive \
+atheros-firmware \
+b43-fwcutter \
+b43-openfwwf \
+brcmfmac-firmware \
+iwlegacy-firmware \
+iwlwifi-dvm-firmware \
+iwlwifi-mvm-firmware \
+libertas-firmware \
+mt7xxx-firmware \
+nxpwireless-firmware \
+realtek-firmware \
+tiwilink-firmware \
+atmel-firmware \
+bcm283x-firmware \
+zd1211-firmware
+----
+
+You can now disable the warning with:
+[source, text]
+----
+sudo systemctl disable coreos-check-wireless-firmwares.service
+----
+
+Then reboot the system.