DEV Community

Cover image for Xiaomi RedmiBook: How to Fix Wi-Fi Issues on Linux (Debian distros)
Rafael Honório
Rafael Honório

Posted on

Xiaomi RedmiBook: How to Fix Wi-Fi Issues on Linux (Debian distros)

Hey folks 👋

Recently, I bought a Xiaomi RedmiBook 16 to get more mobility and separate my work environment. Everything was going great, until I booted into Linux and realized the Wi-Fi wasn’t working at all.

After some digging, I found out the issue was related to the Qualcomm Atheros QCA6174 802.11ac Wireless Network Adapter. It turns out that after installing the OS or updating the kernel, the firmware breaks. Don’t ask me why, but several logs showed the adapter crashing on boot.

If you’re facing the same issue, here’s a simple workaround that worked for me on Ubuntu. It should also help on other Debian-based distros like Kali, Mint, Deepin, Xubuntu and etc.

What’s the problem?

When the kernel loads, the adapter crashes due to incompatible or missing firmware. You’ll likely see something like this in dmesg:

ath10k_pci 0000:01:00.0: failed to fetch board data for bus=pci…
ath10k_pci 0000:01:00.0: failed to load board file…
Enter fullscreen mode Exit fullscreen mode

To fix this, you need to manually replace the firmware files on your system.

If you try searching online, you’ll find several tutorials recommending replacing the main firmware binary. The problem is, most of them point to the same source, and unfortunately, killernetworking.com has been offline for years.

Luckily, I downloaded that binary back then and saved it to a personal drive, since this issue kept happening. I figured it might disappear one day... and it did. So I created a GitHub repository with a .deb package to make things easier.

Step-by-step fix

1 - Clone this repository with this command:

git clone https://github.com/rafael-hs/qualcomm-atheros-qca6174-firmware-adapter
Enter fullscreen mode Exit fullscreen mode

2 - Enter the directory and install the .deb

sudo apt install ./surface-go-wifi_0.0.5_amd64.deb
Enter fullscreen mode Exit fullscreen mode

3 - Then reboot your system:

sudo reboot
Enter fullscreen mode Exit fullscreen mode

That's it! After these steps, your Wi-Fi should be up and running.

Did it work?

It worked perfectly on my Ubuntu install, and I’ve seen others confirm it on similar distros. If you run into any issues or have another solution, drop a comment. It might help someone else!

Thanks for reading and good luck! 🚀

AWS Q Developer image

Build your favorite retro game with Amazon Q Developer CLI in the Challenge & win a T-shirt!

Feeling nostalgic? Build Games Challenge is your chance to recreate your favorite retro arcade style game using Amazon Q Developer’s agentic coding experience in the command line interface, Q Developer CLI.

Participate Now

Top comments (0)

Warp.dev image

The best coding agent. Backed by benchmarks.

Warp outperforms every other coding agent on the market, and gives you full control over which model you use. Get started now for free, or upgrade and unlock 2.5x AI credits on Warp's paid plans.

Download Warp

👋 Kindness is contagious

Take a moment to explore this thoughtful article, beloved by the supportive DEV Community. Coders of every background are invited to share and elevate our collective know-how.

A heartfelt "thank you" can brighten someone's day—leave your appreciation below!

On DEV, sharing knowledge smooths our journey and tightens our community bonds. Enjoyed this? A quick thank you to the author is hugely appreciated.

Okay