Rozwiązanie społecznościowe

MediaTek Wi-Fi w ZimaOS: historia sterowników MT7921/MT7925, wyniki wersji 1.5.4 i obecne ograniczenia obsługi

A December 2025-April 2026 driver-request thread where MT7921 failed because mt7921e was missing, IceWhale promised to add MediaTek modules, and one MT7925 user later confirmed their card started working on ZimaOS 1.5.4. Other MediaTek variants remained mixed or unverified.

Ten wątek źródłowy pokazuje rzeczywisty postęp w zakresie sterowników, ale nie stanowi ogólnej obietnicy, że każdy adapter Wi-Fi firmy MediaTek działa w każdej aktualnej kompilacji ZimaOS. Pierwszy użytkownik MT7921 odkrył, że samo oprogramowanie układowe nie wystarczyło, ponieważ brakowało samego modułu jądra mt7921e. Zima-Jerry powiedział, że IceWhale doda go w następnej wersji.

Później firma IceWhale zobowiązała się również do dodania sterowników związanych z MT7925, a jeden z użytkowników MT7925 PCIe wyraźnie zgłosił, że karta zaczęła działać w ZimaOS 1.5.4. Następnie użytkownik USB MT7925 poinformował, że adapter działał tylko przez kilka dni, po czym znikał aż do ponownego uruchomienia, więc „wykryty” i „stabilny w długim okresie” nie oznaczały tego samego.

Pierwotny problem z MT7921 wynikał z braku modułu jądra

Użytkownik uruchomił modprobe mt7921e, a ZimaOS 1.5.3 zgłosił, że moduł nie istnieje w używanym jądrze. Zima-Jerry odpowiedział, że go doda.

IceWhale zgodziło się również dodać obsługę sterownika MT7925

Inny użytkownik poprosił o obsługę MT7925 PCIe, a kolejny później poprosił o warianty USB używane przez adaptery Wi-Fi 7. Zima-Jerry powiedział, że te sterowniki powinny zostać dodane w nowej wersji.

Użytkownik MT7925 potwierdził powodzenie w ZimaOS 1.5.4

4 lutego 2026 roku esahin powrócił i poinformował, że jego karta MediaTek MT7925 zaczęła działać w ZimaOS 1.5.4. Jest to potwierdzenie działania tego wariantu sprzętowego przez użytkownika, bezpośrednio wynikające ze źródła.

Adapter USB MT7925 później wykazał problemy ze stabilnością

Użytkownik adaptera USB Netgear MT7925 poinformował, że urządzenie zostało wykryte po dodaniu sterownika, ale po kilku dniach przestało działać i wymagało ponownego uruchomienia oraz ponownej konfiguracji za pomocą nmtui. Wątek nie zawiera ostatecznego rozwiązania.

MT7922 był innym przypadkiem

Zima-Jerry powiedział, że sterownik MT7922 był już dołączony. Użytkownik korzystający z wersji 1.5.3 nadal zgłaszał brak sieci Wi-Fi i brakujący moduł, co pokazuje, że należy sprawdzić dokładny układ, typ magistrali, identyfikator urządzenia oraz moduł jądra.

Konsola ZimaOS na płycie głównej MSI innej firmy, pokazująca brak adresu sieciowego podczas rozwiązywania problemów z Wi-Fi MediaTek
System źródłowy uruchomił ZimaOS, ale nie mógł uzyskać dostępu do sieci za pośrednictwem nieobsługiwanej ścieżki bezprzewodowej.

Aktualne oficjalne zalecenia dotyczące Wi-Fi są najsilniejsze w przypadku Intel AX210

Aktualna dokumentacja sprzętowa firmy IceWhale zawiera osobny przewodnik dotyczący AX210 w ZimaOS oraz listę zgodnych adapterów. Warianty MediaTek omawiane w tym wątku nie są tam wszystkie wymienione jako obecnie gwarantowane adaptery.

Przed zakupem nowego sprzętu skorzystaj z aktualnej listy zgodnych adapterów sieciowych ZimaOS.

Sprawdź dokładne urządzenie i moduł w aktualnej kompilacji

lspci -nn
lsusb
uname -r
modinfo mt7921e
ip link

Użyj następnie nmtui dopiero wtedy, gdy jądro udostępni działający interfejs bezprzewodowy.

Pliki oprogramowania układowego i moduły jądra to różne zależności

Pierwszy użytkownik MT7921 skopiował już oprogramowanie układowe, ale polecenie modprobe mt7921e nadal kończyło się niepowodzeniem, ponieważ samego modułu jądra nie było. Oprogramowanie układowe nie zastąpi sterownika, który nie został wbudowany w używane jądro ani dla niego dostarczony.

Podczas rozwiązywania problemów sprawdź zarówno identyfikator urządzenia, jak i to, czy istnieje odpowiedni moduł, zanim zaczniesz wielokrotnie wymieniać pliki oprogramowania układowego.

Adaptery MediaTek PCIe i USB wymagają różnych ścieżek sterowników

Dwa adaptery sprzedawane pod podobną nazwą marketingową MT7925 mogą korzystać z różnych magistral i modułów jądra. Informacja o powodzeniu w przypadku PCIe nie potwierdza automatycznie działania klucza USB, a źródło później dokładnie pokazało tę różnicę na przykładzie okresowo zawodzącego urządzenia USB.

Podczas testowania Wi-Fi zachowaj przewodową ścieżkę awaryjną

Jeśli ZimaOS korzysta z eksperymentalnego adaptera bezprzewodowego jako jedynego połączenia sieciowego, awaria sterownika może spowodować utratę zarówno dostępu do WebUI, jak i SSH. Podczas konfiguracji pozostaw podłączony Ethernet lub zapewnij lokalny dostęp do konsoli, aby można było zebrać logi po zniknięciu Wi-Fi.

Wykrycie to dopiero pierwszy test zgodności

Rzetelna weryfikacja Wi-Fi powinna obejmować zachowanie po ponownym uruchomieniu, kilka dni nieprzerwanej pracy, ponowne połączenie po restarcie punktu dostępowego, ciągły transfer oraz powrót do działania po przejściach uśpienia i stanów zasilania, jeśli są używane. W przypadku źródłowego adaptera USB MT7925 urządzenie początkowo działało, ale po kilku dniach przestało, dlatego pojedyncze udane skanowanie nie wystarczy.

W przypadku produkcyjnego serwera NAS wybierz adapter z aktualnej listy zgodności

Dodawanie sterowników przez społeczność jest cenne podczas eksperymentów, ale serwer NAS przeznaczony do tworzenia kopii zapasowych lub zapewniania zdalnego dostępu zyskuje na użyciu układu, który IceWhale aktywnie dokumentuje. Jeśli Wi-Fi jest opcjonalne, przewodowy Ethernet pozostaje prostszą i bardziej przewidywalną ścieżką dla serwera.

Często zadawane pytania dotyczące Wi-Fi MediaTek

Czy MT7925 działał u co najmniej jednego użytkownika źródłowego w wersji 1.5.4?

Tak.

Czy każdy adapter MT7925 pozostał stabilny?

Nie. Użytkownik adaptera USB zgłosił, że po kilku dniach urządzenie znikało i pojawiało się dopiero po ponownym uruchomieniu.

Czy źródło dowodzi, że każde urządzenie MT7921/MT7922/MT7925 działa w aktualnym ZimaOS?

Nie. Nadal trzeba zweryfikować dokładny identyfikator urządzenia, typ magistrali, moduł oraz aktualne wydanie.