コミュニティソリューション

ZimaOSのMediaTek Wi-Fi:MT7921/MT7925ドライバーの沿革、1.5.4での結果、現在のサポート制限

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.

このソーススレッドでは、実際のドライバー対応の進展が示されていますが、すべてのMediaTek Wi-Fiアダプターが現在のすべてのZimaOSビルドで動作するという一律の保証ではありません。最初のMT7921ユーザーは、ファームウェアだけでは不十分で、mt7921eカーネルモジュール自体が不足していることを確認しました。Zima-Jerryは、次のリリースで追加すると述べました。

その後、IceWhaleはMT7925関連ドライバーの対応も約束し、あるMT7925 PCIeユーザーは、ZimaOS 1.5.4でカードが動作し始めたと明確に報告しました。一方、USB MT7925ユーザーは、アダプターが数日間しか動作せず、再起動するまで認識されなくなったと報告しています。そのため、「検出された」ことと「長期的に安定している」ことは同義ではありません。

最初のMT7921の問題はカーネルモジュールの不足だった

ユーザーがmodprobe mt7921eを実行したところ、ZimaOS 1.5.3は実行中のカーネルにそのモジュールが存在しないと報告しました。Zima-Jerryは、追加すると返信しました。

IceWhaleはMT7925ドライバーの対応追加にも同意した

別のユーザーがMT7925 PCIeへの対応を要望し、その後のユーザーがWi-Fi 7アダプターで使われるUSB版を要望しました。Zima-Jerryは、これらのドライバーを新バージョンで追加する予定だと述べました。

MT7925ユーザーがZimaOS 1.5.4での動作成功を確認した

2026年2月4日、esahinは再度投稿し、MediaTek MT7925カードがZimaOS 1.5.4で動作し始めたと述べました。これは、そのハードウェア構成についてソース上で確認できるユーザー検証です。

その後、USB MT7925アダプターで安定性の問題が発生した

NetgearのMT7925 USBアダプターのユーザーは、ドライバー追加後にデバイスが認識されたものの、数日後に動作しなくなり、再起動してからnmtuiで再設定する必要があったと述べました。スレッドには最終的な解決策は投稿されていません。

MT7922は別のケースだった

Zima-Jerryは、MT7922ドライバーはすでに含まれていると述べました。しかし、1.5.3のユーザーはWi-Fi項目が表示されず、モジュールも不足していると報告しました。これは、正確なチップセット、バスの種類、デバイスID、カーネルモジュールを確認する必要があることを示しています。

MediaTek Wi-Fiのトラブルシューティング中に、ネットワークアドレスが表示されないサードパーティ製MSIマザーボード上のZimaOSコンソール
ソースのシステムはZimaOSを起動できましたが、未対応のワイヤレス経路からネットワークに接続できませんでした。

現在の公式Wi-Fi案内ではIntel AX210への対応が最も明確

IceWhaleの現在のハードウェアドキュメントには、ZimaOS向けAX210専用ガイドと対応アダプターの一覧があります。このスレッドに登場するMediaTek製品は、すべてが現在の対応アダプターとして保証付きで列挙されているわけではありません。

新しいハードウェアを購入する際は、現在のZimaOS対応ネットワークアダプター一覧を利用してください。

現在のビルドで正確なデバイスとモジュールを確認する

lspci -nn
lsusb
uname -r
modinfo mt7921e
ip link

その後、カーネルが使用可能なワイヤレスインターフェースを公開していることを確認してから、nmtuiを使用してください。

ファームウェアファイルとカーネルモジュールは別の依存関係

最初のMT7921ユーザーはすでにファームウェアをコピーしていましたが、modprobe mt7921eは、カーネルモジュール自体が存在しなかったため失敗しました。実行中のカーネルにドライバーが組み込まれていない、または提供されていない場合、ファームウェアで補うことはできません。

トラブルシューティングでは、ファームウェアファイルを何度も入れ替える前に、デバイスIDと対応するモジュールが存在するかの両方を確認してください。

MediaTekのPCIeアダプターとUSBアダプターでは必要なドライバー経路が異なる

似たMT7925という製品名で販売されている2つのアダプターでも、異なるバスやカーネルモジュールを使用する場合があります。PCIeでの成功報告は、USBドングルの動作を自動的に保証しません。実際、ソースでは後に断続的に故障するUSBデバイスによって、その違いが明確に示されました。

Wi-Fiをテストする間は有線の復旧経路を確保する

ZimaOSが唯一のネットワーク接続を実験的なワイヤレスアダプターに依存している場合、ドライバーのクラッシュによってWebUIとSSHの両方にアクセスできなくなる可能性があります。セットアップ中はEthernetを接続したままにするか、Wi-Fiが切断された後にログを収集できるよう、ローカルコンソールへのアクセスを確保してください。

検出は互換性テストの第一段階にすぎない

有効なWi-Fi検証には、再起動後も接続が維持されるか、数日間の連続稼働、アクセスポイント再起動後の再接続、継続的なデータ転送、使用している場合はスリープや電源状態の遷移からの復帰を含めるべきです。ソースのUSB MT7925のケースでは最初は動作したものの、数日後に故障しました。そのため、1回のスキャン成功だけでは不十分です。

本番用NASには、現在の対応リストに掲載されたアダプターを優先する

コミュニティによるドライバー追加は実験に役立ちますが、バックアップやリモートアクセスを提供するNASには、IceWhaleが積極的にドキュメント化しているチップセットの方が適しています。Wi-Fiが必須でない場合は、有線Ethernetの方がシンプルで予測しやすいサーバー接続手段です。

MediaTek Wi-Fiに関するFAQ

MT7925は、少なくとも1人のソースユーザーによって1.5.4で動作確認されていますか?

はい。

すべてのMT7925アダプターは安定して動作し続けましたか?

いいえ。あるUSBアダプターのユーザーは、数日後に再起動するまでアダプターが消えたと報告しています。

このソースは、すべてのMT7921、MT7922、MT7925デバイスが現在のZimaOSで動作することを証明していますか?

いいえ。正確なデバイスID、バスの種類、モジュール、現在のリリースを引き続き確認する必要があります。