インストール - Wi-Fiドライバのソースを表示

== 概要 ==
LinuxでWi-Fiデバイスを使用する場合、専用ドライバをインストールする必要がある可能性がある。<br>
<br>
ここでは、Wi-Fiデバイスの各チップにおいて、専用ドライバのインストール手順を記載する。<br>
<br><br>

== RTL8821AU ==
==== 搭載しているデバイス ====
* ALFA AWUS036ACS
* Buffalo WI-U2-433DHP
* Edimax EW-7811UTC
* Edimax EW-7811UAC
* Edimax EW-7811UCB
* ELECOM WDC-433DU2H
* GMYLE - AC450
* Netgear A6100
* Netis WF2180
* Planex GW-450S
* EDUP EP-1607
<br>
※注意1<br>
Wi-Fiデバイスを選定するための情報を探す場合は、ここをクリックして、メインメニューの項目2を参照すること。<br>
推奨デバイスの情報とリンクが表示される。<br>
<br>
※注意2<br>
上記で選定したWi-Fiデバイスを購入する場合、シングルステートかつシングルファンクションのWi-Fiデバイスを検索することを推奨する。<br>
マルチファンクションアダプタ、無線LANおよびBluetoothは、問題がある可能性がある。<br>
<br>
RTL8821AUチップセットはマルチファンクションであり、RTL8811AUチップセットはシングルファンクションである。<br>
シングルステートおよびマルチステートアダプタに関する詳細は、ここをクリックして、メインメニューの項目1を参照すること。<br>
<br>
==== ビルドに必要なライブラリのインストール ====
システムパッケージの更新とビルドに必要なライブラリのインストールする。<br>
 sudo zypper update
 sudo zypper install -t pattern devel_kernel dkms
<br>
==== ソースコードのダウンロード ====
RTL8821AUドライバのソースコードをダウンロードする。<br>
 git clone https://github.com/morrownr/8821au-20210708 RTL8821AU
<br>
==== Wi-Fiデバイスの確認 ====
Wi-FiデバイスをPCに接続して、デバイスが認識されているかどうかを確認する。<br>
 sudo hwinfo --network
<br>

==== RTL8821AUドライバのインストール (セキュアブートが無効の場合) ====
ダウンロードしたソースコードがあるディレクトリに移動して、RTL8821AUドライバをビルドする。<br>
 cd <RTL8821AUドライバのソースディレクトリ>
 make -j $(nproc)
<br>
RTL8821AUドライバをインストールする。<br>
 sudo mkdir -p /lib/modules/$(uname -r)/kernel/drivers/net/wireless/realtek/rtlwifi/rtl8821au
 sudo cp 8821au.ko /lib/modules/$(uname -r)/kernel/drivers/net/wireless/realtek/rtlwifi/rtl8821au
 
 # 任意
 cd /lib/modules/$(uname -r)/kernel/drivers/net/wireless/realtek/rtlwifi/rtl8821au
 sudo zstd --rm rtk_btusb.ko
<br>
<u>※注意</u><br>
<u>Linuxカーネルをアップデートした場合は自動的にRTL8821AUドライバが削除されるため、再度、RTL8821AUドライバをインストールする必要がある。</u>
<br>
RTL8821AUドライバをデプロイする。<br>
 sudo depmod -a $(uname -r)
<br>
RTL8821AUドライバを読み込む。<br>
 sudo modprobe -v 8821au
<br>
==== RTL8821AUドライバのインストール (セキュアブートが有効の場合) ====
ダウンロードしたソースコードがあるディレクトリに移動して、RTL8821AUドライバをビルドする。<br>
 cd <RTL8821AUドライバのソースディレクトリ>
 make -j $(nproc)
<br>
まず、署名に必要な設定ファイルを作成する。<br>
 mkdir -p ~/.MOK/RTL8821AU && cd ~/.MOK/RTL8821AU
 vi RTL8821AU.config
<br>
 # ~/.MOK/RTL8821AU/RTL8821AU.configファイル
 
 [ req ]
 default_bits = 4096
 distinguished_name = req_distinguished_name
 prompt = no
 string_mask = utf8only
 x509_extensions = myexts
 
 [ req_distinguished_name ]
 O = SUSE Linux Products GmbH (User Add RTL8821AU)            # 任意の名前
 CN = SUSE Linux Enterprise Secure Boot (User Add RTL8821AU)  # 任意の名前
 emailAddress = suse@localhost                                # 任意のメールアドレス
 
 [ myexts ]
 basicConstraints=critical,CA:FALSE
 keyUsage=digitalSignature
 subjectKeyIdentifier=hash
 authorityKeyIdentifier=keyid
<br>
キーペアを作成する。<br>
 openssl req -x509 -new -nodes -utf8 -sha256 -days 36500 -batch -config ./RTL8821AU.config \
 -outform DER -out ./RTL8821AU.der -keyout ./RTL8821AU.priv \
 -addext "extendedKeyUsage=codeSigning"
<br>
次に、MOK(Module owned Key)にキーをインポートする。<br>
<code>--root-pw</code>オプションを付加することにより、再起動時のRealtek RTL8821AUモジュールの署名において、rootパスワードが必要となる。<br>
 sudo mokutil --import ./RTL8821AU.der --root-pw
<br>
PCを再起動して、上記のキーの署名する。<br>
 sudo systemctl reboot
<br>
RTL8821AUドライバをインストールする。<br>
 sudo mkdir -p /lib/modules/$(uname -r)/kernel/drivers/net/wireless/realtek/rtlwifi/rtl8821au
 sudo cp 8821au.ko /lib/modules/$(uname -r)/kernel/drivers/net/wireless/realtek/rtlwifi/rtl8821au
<br>
Realtek RTL8821AUドライバ(8821au.ko)を署名する。<br>
 sudo /lib/modules/$(uname -r)/build/scripts/sign-file sha256 \
 ./RTL8821AU.priv ./RTL8821AU.der \
 /lib/modules/$(uname -r)/kernel/drivers/net/wireless/realtek/rtlwifi/rtl8821au/8821au.ko
<br>
必要であれば、Realtek RTL8821AUモジュールをXZ形式またはZstandard形式に圧縮する。(任意)<br>
 # XZ形式の場合
 cd /lib/modules/$(uname -r)/kernel/drivers/net/wireless/realtek/rtlwifi/rtl8821au
 sudo xz -f 8821au.ko
 
 # Zstandard形式の場合
 cd /lib/modules/$(uname -r)/kernel/drivers/net/wireless/realtek/rtlwifi/rtl8821au
 sudo zstd --rm 8821au.ko
<br><br>
<u>※注意</u><br>
<u>Linuxカーネルをアップデートした場合は自動的にRTL8821AUドライバが削除されるため、再度、RTL8821AUドライバをインストールする必要がある。</u>
<br>
RTL8821AUドライバをデプロイする。<br>
 sudo depmod -a $(uname -r)
<br>
RTL8821AUドライバを読み込む。<br>
 sudo modprobe -v 8821au
<br>

==== RTL8821AUドライバのアンインストール ====
RTL8821AUドライバをアンインストールする。<br>
 cd <RTL8821AUドライバのソースディレクトリ>
 sudo make uninstall
<br>
RTL8821AUドライバファイルを削除する。<br>
 sudo rm /lib/modules/$(uname -r)/kernel/drivers/net/wireless/realtek/rtlwifi/rtl8821au/8821au.ko
 # または
 sudo rm /lib/modules/$(uname -r)/kernel/drivers/net/wireless/realtek/rtlwifi/rtl8821au/8821au.ko.xz
 # または
 sudo rm /lib/modules/$(uname -r)/kernel/drivers/net/wireless/realtek/rtlwifi/rtl8821au/8821au.ko.zst
<br>
ドライバ群をデプロイする。<br>
 sudo depmod -a $(uname -r)
<br><br>

__FORCETOC__
[[カテゴリ:CentOS]][[カテゴリ:SUSE]][[カテゴリ:Raspberry_Pi]][[カテゴリ:PinePhone]]