--- title: "またWiFiがつながらなくなったLinuxユーザーの日常: RTL8723BSとLinux 7.0" description: Linux 7.0系カーネルへ更新したあと、Realtek RTL8723BSのWiFiクライアント接続が失敗するようになった件について、症状、原因候補、結末を整理する。 image: rtl8723bs-linux-7-wifi/cover.jpg date: 2026-05-11 19:50:00 --- Linuxカーネルやファームウェア[^1]を最新のものに更新するとWiFiがつながらなくなることがよくある。よかれと思って加えられた修正が実際のチップの動作に影響を与えるケースだ。逆にLinuxカーネルが古いとつながらないWiFiチップもあるので、ユーザーは枯れた(=長く使われており安定している)カーネルと最新カーネルの間のスイートスポットに浮かんで生きてゆかなければならない[^2]。 [^1]: ファームウェアはドライバと別に提供されるもので、ドライバがOSにロードされた時にデバイス自身にロードされる。WiFi関連はドライバがバグることもよくあるがファームウェアもよくバグる。 [^2]: もっとも、一般ユーザーが利用するようなディストリビューションでは自動アップデートで突然カーネルのメジャーバージョンが上がるようなことはないので、ここでいうユーザーとは自分でカーネルを差し替えるようなどこかおかしいユーザーのことである。 今回の対象は Realtek RTL8723BS。SDIO[^3]接続の古めの WiFi/Bluetooth チップで、タブレットや小型端末などで見かけることがある。Linux 7.0系カーネルへ更新したあと、この RTL8723BS 搭載機で WiFi のクライアント接続ができなくなった。 [^3]: SDカード用の接続規格を拡張して周辺機器も接続できるようにした仕組み。小型機の内部接続によく使われている。 結論から言うと Linux 6.18系カーネルに戻せばいいだけだったが、あるある話のひとつとして記録しておく。 ## 今回の端末: マウスコンピューター NH1 今回手元でWiFiに接続できなかったのはマウスコンピューターのスティック型PC「NH1」。 ![マウスコンピューター NH1の外観](rtl8723bs-linux-7-wifi/mouse-nh1.webp) 販売元のFAQでは [MS-NH1 / MS-NH1-64G 製品仕様（Windows8.1）](https://www2.mouse-jp.co.jp/ssl/user_support2/sc_faq_documents.asp?FaqID=17629) として掲載されている機種で、文書の更新日は2015年7月23日になっている。初期搭載OSは Windows 8.1 世代で、Windows 11へアップグレードして使い続けるような機種ではない[^4]。 [^4]: Windows11にアップグレードできるかどうかは各種条件により決まるのだが、条件をすべてクリアできるのは比較的新しい機種だけとなる。 ただ、中古市場では数千円程度で流通していることがあり、HDMIに直接挿せる小型PCとしてはまだ使い道がある。当社ではこうした古いスティック型PCに [genpack](/genpack/) で作った専用Linuxイメージを上書きして、監視、表示、簡易な常時稼働端末などに使っている。 genpackで固めた環境にしておくと、端末ごとに手作業で設定を積み上げるのではなく、「この用途の端末はこのOSイメージ」という形で再現できる。壊れたら別の中古端末に同じイメージを書き込んで差し替えられるので、安価な機材を業務用途の小さなアプライアンスとして扱いやすい。 ・・・のだが、こういう古いマイナーマシンのマイナーなチップはどうしてもテストする人が少ないため、最新カーネルで動かなくなるというのがまことによくある。 ## 症状 問題が出た環境では、黒い画面に次のようなログが繰り返し出ていた。 ![RTL8723BSでcoalesce failed with error -22が繰り返し出ているLinux起動画面](rtl8723bs-linux-7-wifi/connection-error.webp) ```text rtl8723bs mmc0:0001:1 wlan0: xmit_xmitframes: coalesce failed with error -22 ``` ## rtl8723bsはまだstagingのドライバ `rtl8723bs` ドライバは、Realtekの古いベンダードライバ由来のコードを Linux 向けに取り込んだものだ。2017年に staging 領域へ入り、現在もクリーンアップが続いている。 staging は、Linuxカーネル本体のツリーには入っているが、品質や設計の面でまだ整理中のドライバが置かれる場所だ。つまり「使えることは使えるが、内部実装はまだ手入れ中」という位置づけになる。そしてこのrtl8723bsを含む多くのドライバが万年stagingだ。 ## 原因候補 どうも Linux 7.0のマージウィンドウでは、この `rtl8723bs` ドライバに[多くのクリーンアップが入った](https://lore.kernel.org/lkml/aZR7MAE8Cm-Viw5w@kroah.com/)ようで、[Phoronix の記事](https://www.phoronix.com/news/Linux-7.0-Staging)では staging まわりの変更としてそのことを紹介している。 「コードをきれいにする」という行為は「何らかの理由でやむを得なく汚かったコード」まできれいにして動かなくしてしまうことがよくあるので、今回の問題がこれに関係しているであろうことが想像できる。 ## 試したが効かなかったもの Linuxの WiFi トラブルをフォーラムに相談すると、まず真っ先に返ってくる返事は「省電力設定を切れ」だ。例えば `rtw_power_mgnt=0` のような引数をモジュールに与えることで改善するケースもある。 今回の問題を調べた時もそういったワークアラウンドに関する情報がヒットしたが、それでは改善しなかった。やはり前述のように掃除してはいけないものを掃除してしまったのだろう。 ## genpackでの回避 というわけで、カーネルを 6.18へ戻すことで解決した。[genpack.json5](/genpack/json5.md) のpackages節でカーネル指定を次のように変更。 ```diff - "sys-kernel/gentoo-kernel-bin": null, + "