Replicant

h1. Enabling WiFi with an USB WiFi adapter

All Replicant-supported devices need non-free firmware to be loaded to make the internal WiFi component work. See the [[Wifi|WiFi research page]] for more information. Free replacements for these non-free firmwares do not yet exist.

However, free firmware does exist for WiFi adapters with the AR9271 chipset. Such adapters can be used with a device running Replicant 6.0. A USB OTG (On-The-Go) cable is needed to connect the WiFi adapter to the phone.

h2. Supported WiFi adapters

More adapters exist that have the AR9271 chipset than are listed below. The listed adapters are the ones that are known to us.

h3. Known to work

* "Penguin Wireless N USB Adapter for GNU / Linux (TPE-N150USB)":https://www.thinkpenguin.com/gnu-linux/penguin-wireless-n-usb-adapter-gnu-linux-tpe-n150usb

* "Technoethical N150 Mini Wireless USB Adapter":https://tehnoetic.com/adapters/tehnoetic-wireless-adapter-gnu-linux-libre-tet-n150

* "Technoethical N150 High Gain Antenna Wireless USB Adapter":https://tehnoetic.com/adapters/tet-n150hga

* TP-Link TL-WN722N

h3. Should work but not tested

* "Penguin Wireless N USB Adapter /w External Antenna for GNU / Linux (TPE-N150USBL)":https://www.thinkpenguin.com/gnu-linux/penguin-wireless-n-usb-adapter-w-external-antenna-gnu-linux-tpe-n150usbl

h2. WiFi adapter usage

Using the WiFi adapter with the RepWifi app is the recommended and most convenient way.

It is not possible to configure WiFi connections through the adapter with the pull-down quicksettings or the regular WiFi menu in the settings. These are only meant work with the internal WiFi component of the device.

h3. With the RepWifi app

Replicant 6.0 ships with the RepWifi app. [[UsageNotes#Enabling-root-access|Root access for apps]] needs to be enabled to make the app work.

The app has the following capabilities:

* searching for WiFi access points

* connecting to WPA/WPA2 secured and unsecured networks

* storing network connections (including passwords)

* managing stored network connections (viewing and deleting them)

"Forum thread about the app and its development":http://redmine.replicant.us/boards/9/topics/14079?r=1410

h3. With the WiFi scripts

While the RepWifi app should be preferred, use cases might exist where the WiFi scripts yield better results. The scripts were developed before work on the RepWifi app was started. Scripts both for Replicant 6.0 and Replicant 4.2 exist.

"Forum thread about the WiFi scripts and their development":http://redmine.replicant.us/boards/9/topics/13932

h2. Known issues

high battery drain, possible battery damage or shortened lifecycle for batteries

adapter is not powered when low battery charge

Displayed battery charge level may not be accurate (likely lower because of quick drain)

which devices work best? Note 2 (big battery) -> Galaxy S 3 -> Galaxy S 2 (instabilities, battery issues, see #1791)

[[ReplicantUSBNetworking#Known-issues|Known issues for USB networking]] apply here, too (#1792).