Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add a doc page about wifi #629

Merged
merged 2 commits into from
Apr 20, 2024
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions modules/ROOT/nav.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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]
Expand Down
66 changes: 66 additions & 0 deletions modules/ROOT/pages/wifi.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change

== 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
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The styling convention for asciidoc is one sentence per line.

This reduces the amount of diff while keeping things readable.

See: https://asciidoctor.org/docs/asciidoc-recommended-practices/#one-sentence-per-line

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.

jbtrystram marked this conversation as resolved.
Show resolved Hide resolved
If you know what wifi firmware your system needs then request that package specifically.
The available wifi firmware packages are:
---
atheros-firmware - Firmware for Qualcomm Atheros WiFi/Bluetooth adapters
b43-fwcutter - Firmware extraction tool for Broadcom wireless driver
b43-openfwwf - Open firmware for some Broadcom 43xx series WLAN chips
brcmfmac-firmware - Firmware for Broadcom/Cypress brcmfmac WiFi/Bluetooth adapters
iwlegacy-firmware - Firmware for Intel(R) Wireless WiFi Link 3945(A)BG and 4965AGN adapters
iwlwifi-dvm-firmware - DVM Firmware for Intel(R) Wireless WiFi adapters
iwlwifi-mvm-firmware - MVM Firmware for Intel(R) Wireless WiFi adapters
libertas-firmware - Firmware for Marvell Libertas SD/USB WiFi Network Adapters
mt7xxx-firmware - Firmware for Mediatek 7600/7900 series WiFi/Bluetooth adapters
nxpwireless-firmware - Firmware for NXP WiFi/Bluetooth/UWB adapters
realtek-firmware - Firmware for Realtek WiFi/Bluetooth adapters
tiwilink-firmware - Firmware for Texas Instruments WiFi/Bluetooth adapters
atmel-firmware - Firmware for Atmel at76c50x wireless network chips
zd1211-firmware - Firmware for wireless devices based on zd1211 chipset
---

.Request the required firmware for your hardware:
[source, text]
----
$ sudo rpm-ostree install -y iwlwifi-dvm-firmware --allow-inactive
----

If you don't know what firmware to request you can request
all the wireless firmware available in Fedora.
Please note this approach is sub-optimal as it will add a lot
of uneeded packages on your system.
.Request all available wifi firmware
----
$ sudo rpm-ostree install -y --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 \
zd1211-firmware
----

You can now disable the warning with:
[source, text]
----
sudo systemctl disable coreos-check-wireless-firmwares.service
----

Then reboot the system.
Loading