RealtekのWi-Fiカードがlspciに表示されるのに、ZimaOSで「Wi-Fi Hardware: Missing」と表示される場合、PCIeデバイスは検出されていますが、Wi-Fiを利用するためのドライバーまたはファームウェアが正しく機能していません。元のスレッドのタイトルにはRTL8821CEとありますが、実際のlspci出力ではRTL8852BEの802.11axコントローラーが確認されています。
この違いが重要なのは、RTL8821CEとRTL8852BEでは上流Linuxドライバーが異なるためです。現在のZimaOS互換性ドキュメントでは、どちらのPCIeカードも動作確認済みのWi-Fiオプションとして掲載されていません。そのため、Linux Mint用のドライバーを通常のDebianパッケージのようにZimaOSへそのままインストールできるとは考えないでください。
まず正確なチップを特定する
lspci -nnk | grep -A3 -Ei 'network|ワイヤレス
dmesg | grep -Ei 'rtw|ファームウェア|Wi-Fi|wlan' | tail -100カードの製品ラベルだけでなく、PCI IDとドライバーの行を確認してください。スレッドではRTL8821CEとされていましたが、ユーザーのハードウェアはRTL8852BEとして認識されていました。
RTL8852BEには上流Linuxドライバーがある
現在のLinux RTL8852BEドライバーのリファレンスによると、RTL8852BEは最新のLinuxカーネルでrtw89_8852beモジュールを使用します。
RTL8821CEは別のドライバーファミリーを使用する
RTL8821CEはrtw89ではなく、rtw88ファミリーで動作します。この2種類のチップセットの手順を混同すると、誤ったモジュールを使用し、ファームウェアのトラブルシューティングも間違った方法で進めてしまうおそれがあります。
現在のZimaOS互換性リストでは、これらのカードは動作確認されていない
現在のZimaOS対応ネットワークアダプターの一覧にはIntel AX210と複数のEthernetアダプターが掲載されていますが、RTL8821CEやRTL8852BEのPCIe Wi-Fiは掲載されていません。
ホストに無作為なDKMSパッケージをインストールしない
ZimaOSはアプライアンス型のシステムです。UbuntuやLinux Mintで動作するドライバーパッケージでも、ZimaOSでは同じように利用できないヘッダー、DKMS、パッケージマネージャーの状態、書き込み可能なシステムパスに依存している場合があります。
モジュールが存在するか確認する
modinfo rtw89_8852be 2>/dev/null
modinfo rtw88_8821ce 2>/dev/null該当するモジュールが見つからない場合は、関係のない外部ソースからのビルドを無理に導入せず、PCI ID とドライバー名を IceWhale に報告してください。
本番サーバーには動作確認済みのアダプターを使用
今すぐ Wi-Fi が必要な場合は、未検証の Realtek PCIe カードに頼るのではなく、Intel AX210 など、現在動作確認済みのアダプターを使用してください。
ハードウェアのトラブルシューティングガイドを使うと、互換性レポートをまとめやすくなります。
ファームウェアのエラーをドライバーモジュールの問題と分けて確認
モジュールが存在していても、必要な Realtek ファームウェアのバイナリがないために動作しないことがあります。dmesg では「モジュールが見つからない」場合と「ファームウェアの読み込みに失敗した」場合を区別してください。IceWhale に依頼する修正内容が異なります。
ドライバーの要望には PCI ID を記載
投稿された RTL8852BE 1T1R カードでは、HP のスペアパーツのラベルより PCI ID のほうが重要です。ドライバーの要望にはベンダー ID とデバイス ID を含めてください。そうすれば IceWhale が適切なカーネルオプションとファームウェアパッケージを有効化できます。
常時稼働の NAS にはイーサネットを優先
Wi-Fi が使える場合でも、ストレージサーバーでは有線イーサネットのほうが一般に安定します。ローミング、無線周波数の干渉、ワイヤレスの電源管理による影響を避けられるためです。Wi-Fi は配線が難しい場合に使用し、NAS の大容量通信では標準の接続方法として使わないでください。
よくある質問
実際のカードは RTL8821CE ですか？
フォーラムのタイトルには RTL8821CE とありますが、投稿された lspci の出力では RTL8852BE と確認できます。
なぜ Linux Mint では動作するのですか？
Mint には必要なカーネルモジュールとファームウェアが含まれている可能性がありますが、ZimaOS のビルドでは同じ組み合わせが含まれていない、または有効化されていない可能性があります。
apt で Wi-Fi ドライバーをインストールできますか？
ZimaOS を通常の Ubuntu ホストとして扱わないでください。動作確認済みのアダプターを優先するか、ドライバーの統合を依頼してください。
IceWhale には何を送ればよいですか？
正確な PCI ID、lspci -nnk、関連する dmesg の出力、ZimaOS のバージョン、別の Linux ディストリビューションで動作するかどうか。
