[Driver] Asix AX88772 kernel module (USB Ethernet)

Hello, this is my first dev posting, so let me know if there is anything missing...

I have a Samsung Galaxy SIII S3 SGH-I747M (Bell) with Jelly Bean 4.1.1 kernel 3.0.31 (stock rooted, root66_BMC_I747MVLDLK4.7z). I also have an Asix USB LAN adapter (from monoprice) + USB OTG cable which did not work out of the box... but i am a software engineer... so I made it work. The process below should work for other carriers / modules if you find the proper kernel source. Compiling latest drivers directly from Asix is the best method... Read that part first!

Read the README that comes with your kernel source, you may need a different compiler! https://github.com/AdiPat/Android_Toolchains is where I got mine...

Details about the Asix AX88772 USB lan RJ45 adapter chipset can be found here:
http://www.asix.com.tw/products.php?...emID=86;71;101

You can skip to "Usage instructions" section and download pre-compiled modules, if you have identicalkernel + phone

built from SGH-I747M_BMC_JB_Opensource.zip (I747MVLDLK4, my phone) + latest Asix driver, works great!!!
https://www.dropbox.com/sh/3lrhwdf2vxe5z90/Hr3-nYX4Ff

built from SGH-I747M_BMC_JB_Opensource.zip (I747MVLDLK4, my phone) stock kernel driver, 'insmod's, but 'ping' is flaky?
https://www.dropbox.com/sh/u068760ytpsn0k1/3di6Wg44ja

built from GT-I930_JB_Opensource_Update7.zip (I9300XXELLA, requested by gingerneil), stock kernel driver, works great!!!
https://www.dropbox.com/sh/5emvafthv061fp6/BKcakiOie8

built from GT-I930_JB_Opensource_Update8.zip (EMR2, requested by gingerneil), stock kernel driver, untested
https://www.dropbox.com/sh/rmc1n4yxckg01zy/a2V5hvIp20

built from Cyanogenmod 10 for i9300, git commit 43aaedbcde478c8e032771d62a1956133b29b1d4, untested
https://www.dropbox.com/sh/n1tdiap4pi2vzm8/TKAj_lChXA

built from Android 4.1.1 for Galaxy Tab 2 (GT-P5110) kernel 3.0.31-523998, contact 'patelkes' if you have questions.
https://www.dropbox.com/sh/r0zkg5do2n3lyg3/fWWyhsz2qy

built from Android 4.? for Xperia Tablet Z ROM (10.3.1.C.0.136), contact 'kristouf666' if you have questions.
https://www.dropbox.com/sh/nxqo1ipkbojakls/eDLHXJzl5s

built from Cyanogenmod 10.1.3 for SGH-i747m, git commit ?
Work in progress

Build environment setup:

-Get root access on a Ubuntu Natty (11.04) or similar linux build machine / virtual machine
-Install standard unix compiler tools

apt-get install build-essential

-Install library for menuconfig

apt-get install libncurses5-dev

-Install lzop (android compression util)

apt-get install lzop

-Install git

apt-get install git

-Download Android toolchains using git

cd /root
git clone https://github.com/AdiPat/Android_Toolchains.git

-Download samsung kernel SGH-I747M_BMC_JB_Opensource.zip (international model, etc, also available)... Or download your 3rd party Cyanogenmod,etc kernel SOURCE instead.
-Extract to /root/kernel

mkdir /root/kernel
cd /root/kernel
unzip SGH-I747M_BMC_JB_Opensource.zip

-Set path so Android compiler can be found

export CROSS_COMPILE=/root/Android_Toolchains/arm-eabi-4.4.3/bin/arm-eabi-

**EDIT: newer kernels, such as Cyanogenmod 10.2.1, use this

export CROSS_COMPILE=/root/Android_Toolchains/arm-eabi-4.6/bin/arm-eabi-

Compiling built-in kernel modules: (left for documentation sake, the better method is "Compiling latest drivers directly from Asix")

-Generate '.config' file in kernel folder (replace 'm2_att_defconfig' with name of file in 'arch\arm\configs\')

make arch=arm m2_att_defconfig

-Modify kernel config to include Asix module and usbnet module

make menuconfig
[Navigate using arrow keys and enter]
Device Drivers ->
Network device support ->
USB Network Adapters ->
Multi-Purpose USB Networking Framework ->
[PRESS SPACEBAR until an M appears on the left]
[M] Multi-purpose USB Networking Framework
[M] ASIX AX88xxx Based USB 2.0 Ethernet Adapters

For reference here is the help info for the 2 options that are now set to 'M'

-Compile modules, where 2 is the number of CPU cores you have (speeds it up)

make -j2 && make -j2 modules

-Once finished, grab your modules

/root/kernel/drivers/net/usb/usbnet.ko
/root/kernel/drivers/net/usb/asix.ko

Usage instructions:

-Use a root explorer such as ES File manager

Mount /system as rw in ES File manager root settings
copy asix.ko and usbnet.ko to /system/lib/modules/

-Use a terminal emulator / adb shell to load modules (asix depends on usbnet, so load usbnet first)

su
cd /system/lib/modules
insmod usbnet.ko
insmod asix.ko

-If there are errors, run 'dmesg' and see section called "Insmod errors"
-If there are no errors, you should see 'eth0' in 'netcfg'
-'lsmod' lists modules loaded
-Connect your USB ethernet adapter to an ethernet network
-netcfg should show eth0 as connected
-Setup ethernet settings, if you want static address, for typical internet router at 192.168.1.1

ifconfig eth0 192.168.1.100 netmask 255.255.255.0
route add default gw 192.168.1.1 dev eth0
setprop net.dns1 192.168.1.1
ip addr show
ip route show

-Setup ethernet settings, if you want automatic dhcp address

dhcpcd eth0

-If you want one-click enable of your USB, see section "usbnet widget"

Insmod errors:

exec format error : wrong compiler / wrong kernel source / wrong phone
init_module failed usbnet.ko (file exists) : module already loaded or built into kernel
no such file or directory : run dmesg immediately after attempt... you are missing module dependency
can't open usbnet.ko : are you root?

usbnet widget

Install Smanager
Download my usbnet script http://pastebin.com/zQRQ6Kdj
Use a quality notepad editor such as notepad ++ to edit, ensure line endings are "Unix"
Place in /system/lib/modules/usbnet *cannot be on sdcard, as sdcard is a windows filesystem*
In terminal emulator / adb: "chmod 777 /system/lib/modules/usbnet"
Open Smanager
-Menu -> Scripts
-Menu -> Browser -> /system/lib/modules/usbnet
-Ensure "Fav", "SU" and "is executable" are checked and give it a name 'usbnet', press save.
On homescreen, add widget, Smanager, pick your script 'usbnet'
You now have 1 click access to loading the modules, setting IP address, and testing connectivity to your router.

GT-9300 differences (thanks gingerneil)
Kernel source

GT-I930_JB_Opensource_Update7.zip

While building the kernel, the make config step is different

make arch=arm m0_00_defconfig

There is a third module built,

/root/kernel/drivers/net/mii.ko

Usage instructions, new order of operations

insmod mii.ko
insmod usbnet.ko
insmod asix.ko

/system/lib/modules is not persistent on this phone, instead store modules + usbnet script

/system/media

Compiling latest drivers directly from Asix

For some reason on my phone the stock kernel asix module did not work 100%.
I could insmod both modules, and using Wireshark, I verified my computer was receiving 'ping' packets, but the phone wasn't getting any 'ping reply' packets. This latest Asix driver works perfectly for me. 

UPDATE:: http://www.asix.com.tw/FrootAttach/d...Source.tar.bz2 is available, but I have not tried it!

Follow "Environment setup" above

Code:

cd kernel_src_folder

Generate kernel '.config' file (replace 'm2_att_defconfig' with name of file in 'arch\arm\configs\')

Code:

make arch=arm m2_att_defconfig

Code:

mkdir /root/asix && cd /root/asix

Code:

wget http://www.asix.com.tw/FrootAttach/driver/AX88772B_772A_760_772_178_LINUX_Driver_v4.4.1_Source.zip

Code:

unzip AX88772B_772A_760_772_178_LINUX_Driver_v4.4.1_Source.zip

Code:

rm -rf Makefile

# we are replacing the Makefile with a new one.... if you edit, ensure indents = TABS

Code:

wget http://pastebin.com/raw.php?i=4xLxksX3 -O Makefile

Code:

CROSS_COMPILE=/root/Android_Toolchains/arm-eabi-4.4.3/bin/arm-eabi- make

**EDIT: newer kernels, such as Cyanogenmod 10.2.1, use this

Code:

CROSS_COMPILE=/root/Android_Toolchains/arm-eabi-4.6/bin/arm-eabi- make

Follow the "usage instructions" above, but since this is an "all-in-one" module, remove references to 'usbnet' 

Other informational Links

Thanks to viulian for his inspirational post here in regards to compiling external module.

If you want to compare your phone's kernel configuration to the one in the download source from Samsung, read this post: 

To see the list of loadable and built-in modules, see this.

More information about compiling kernel modules / asix / other usb chipsets / other devices 

Did you know that Asix now manages Moschip products? Looking for MCS7830 drivers? 

Thanks to zhlvf for pointing this , there is a way to hack android to think Wifi is connected when an USB ethernet is plugged in... (solves issues in some apps, like google play / market, which ignore USB ethernet as a valid connection).

Make errors documentation

Model number and version code explanation (how to tell which samsung.opensource.com zip file to download)

https://www.kernel.org/doc/Documenta...ld/modules.txt

To get the active .config from a Cyanogen mod android,

Code:

adb pull /proc/config.gz