Replicant USB Networking¶

This page explains how to connect your Replicant device to the Internet via an USB connection to a computer connected to the Internet.

Using reverse_tether.sh¶

The reverse_tether.sh script is part of AOSP and can be downloaded from: reverse_tether.sh
In order to start basic NAT networking between the host and the device, make sure to have installed ADB and to have the host daemon running as root. Then, use reverse_tether.sh the following way:

./reverse_tether.sh rndis
./reverse_tether.sh nat

Using the Replicant USB Networking scripts¶

Replicant USB Networking requires two scripts: attachment:replicant_usb_networking_device.sh attachment:replicant_usb_networking_host.sh
However, you can avoid the host part if your network manager can manage a shared connection.

Make sure to have installed ADB and to have the host daemon running as root.

Push the device part on the device and make it executable:

adb push replicant_usb_networking_device.sh /data/
adb shell chmod a+x /data/replicant_usb_networking_device.sh

Using a network manager shared connection¶

1. On your Linux PC, in the network manager applet (where you normally set up wired or wireless network connections), create a new "Shared" "Wired" connection, with default settings (connection type = Shared). (This is independent of the device, and only needs to be created once.)
2. Disconnect any other network connections (Wifi, 3G data) on the device.
3. Run the first part of the device-side script:

adb shell /data/replicant_usb_networking_device.sh start1 dhcp

4. The device should appear in the host's network manager applet as a new "wired" network connection. Connect this to the "Shared" connection that you created above (it should be in the list of choices given by the applet).
5. Now run the second part of the script on the device:

adb shell /data/replicant_usb_networking_device.sh start2 dhcp

The connection should now work. To disconnect the device, run:

adb shell /data/replicant_usb_networking_device.sh stop

Using the host script¶

1. Disconnect any other network connections (Wifi, 3G data) on the device.
2. Run the first part of the device-side script:

adb shell /data/replicant_usb_networking_device.sh start1 static

3. Wait for the interface to show up
4. Configure the device interface:

adb shell /data/replicant_usb_networking_device.sh start2 static

5. Configure the host interface:

sudo ./replicant_usb_networking_host.sh start

The connection should now work. To disconnect the device, run:

adb shell /data/replicant_usb_networking_device.sh stop

Cleanup the host:

sudo ./replicant_usb_networking_host.sh stop