TP-Link wifi USB ドングルのドライバのインストール時のメモ

概要

TP-Link製のwifi usbドングル(TL-WN725N Ver3.0)をRaspberry-pi 3 Model B V1.2へ設定するため、ドライバをインストールしたときに収集した情報をまとめておく。(2021年11月現在の情報。)

公式
- TP-Linkの公式サイトのドライバは古く、メンテされていない
- Linux環境の場合、自分でソースからビルドする必要あり
簡単インストール
- 有志の方がメンテしているドライバのインストーラ(インターネット接続環境でスクリプト一つを実行するのみ)
- 今回実施したのはこの方法
手動インストール
- 上記簡単インストールができない場合(直接インターネットに接続できない環境の場合)、必要なドライバのパッケージを別途ダウンロードし、コピーして、インストールする
- 手順の概要をまとめておく

作業環境

OS環境 : Linux raspberrypi 4.19.75-v7+ #1270

wifiアダプタ製品名 : TL-WN725N Ver3.0

uname -a
#Linux raspberrypi 4.19.75-v7+ #1270 SMP Tue Sep 24 18:45:11 BST 2019 armv7l GNU/Linux

 lsusb
#Bus 001 Device 004: ID 0bda:8179 Realtek Semiconductor Corp. RTL8188EUS 802.11n Wireless Network Adapter
# 以下略

詳細

TP-Link公式の情報

公式サイトで確認すると、2018年以来更新されていない

正式版はLinux kernel 2.6.18 ~ 3.19.3
ベータ版はLinux kernel 2.6.18 ~ 4.4.3

(https://www.tp-link.com/jp/support/download/tl-wn725n/より)

ベータ版ダウンロード

試しにベータ版をダウンロード

ls
#TL-WN725N_V3_Linux.zip
unzip TL-WN725N_V3_Linux.zip -d tmp
#Archive:  TL-WN725N_V3_Linux.zip
#  inflating: tmp/Installation Guide for Linux.pdf  
#  inflating: tmp/rtl8188EUS_linux_v5.2.2.4_25483.20171222.zip  
#  inflating: tmp/readme_beta.txt

Installation Guide(pdf)が含まれていたため手順を確認

(TP-Link Installation Guide for Linuxより)

コンパイル手順が書かれていた

Raspberry Piのフォーラム情報

Raspberry Piのフォーラムに"(UPDATE) Drivers for TL-WN725N V2 - 3.6.11+ -> 4.xx.xx+"というスレッドを見つける。

MrEngmanさんという方が2013年以来メンテしてくれているTL-WN725N用のドライバとそのインストーラの情報らしい。

対応するLinux kernel: 3.18, 4.0, 4.1, 4.4, 4.8/9, 4.14, 4.19
対応するUSB ID:

ID 2001:3310
ID 2001:330F
ID 07B8:8179
ID 0BDA:0179
ID 0BDA:8179

3.12.28+ 以降の場合、以下も追加：
ID 056E:4008
ID 2001:3311
ID 0DF6:0076

簡単インストール

インターネット接続している環境の場合

# インストーラのダウンロード
sudo wget http://downloads.fars-robotics.net/wifi-drivers/install-wifi -O /usr/bin/install-wifi

# 実行権をつける
sudo chmod +x /usr/bin/install-wifi

# ヘルプ表示
sudo install-wifi -h

# 自動的に環境にあったバージョンのドライバをインストールする
sudo install-wifi

手動インストール

今回は実施していない。概要メモのみ。

Linuxカーネルのバージョン確認し、ダウンロードすべきファイル名を特定する。

uname -a
# Linux raspberrypi 4.4.8-v7+ #881 SMP Sat Apr 30 12:16:50 BST 2016 armv7l GNU/Linux
#
# ここでは、"4.4.8-v7+ #881"の部分を確認する

lsusb
#Bus 001 Device 004: ID 0bda:8179 Realtek Semiconductor Corp. RTL8188EUS 802.11n Wireless Network Adapter
# 以下略
#
# - USB ID = 0BDA:8179はサポートされていること
# - アダプタの製品名はRTL8188EUS
# (厳密にRTL8188EUSとRTL8188EUで何が異なるのかは確認できなかったが、互換性があるものという認識で作業を進める)
# を確認

ダウンロードするドライバのファイル名は<製品名>-<カーネルバージョン>.tar.gzという構成なので、この場合、8188eu-4.4.8-v7-881.tar.gz をダウンロードする。

インターネット接続環境で、http://downloads.fars-robotics.netから必要なドライバのパッケージをダウンロードする。
- 上記の例では、http://downloads.fars-robotics.net/wifi-drivers/8188eu-drivers/8188eu-4.4.8-v7-881.tar.gz
- ダウンロードサイトのディレクトリ構造は"Directory structure is"以下に記述あり。

ダウンロードしたファイルをRaspberry-pi へコピーし、インストールする

# アーカイブを展開
tar xzf 8188eu-4.4.8-v7-881.tar.gz
# インストール
./install.sh

参照