TP-LINK TL-WN725N v2 working on Raspberry Pi (Raspbian)

August 16th, 2013  Posted at   Linux, Raspberry Pi, Raspbian

When I bought my Raspberry Pi I also ordered this tiny usb wifi adapter (TP-LINK TL-WN725N) in order to play with my raspi everywhere. I got this adapter because  I read it worked out of the box, it was cheaper than others and it supported WiFi-N. As you may guess I am writing this post because the first advantage, the out of the box one, did not work for me.

Raspi with TP-LINK WN725N

I read some forums and it seemed that I had purchased a newer version of this adapter, the TL-WN725N v2. It needs a different driver, the Realtek 8188eu, which is not included by default in the Raspbian distributed by the official web site of Raspberry Pi. So, to sum up, I was able to find the driver source code and now I have a wireless raspi. If you have the same problem with this adapter, read the following lines to obtain directly the .ko object and you will be done. If you want you can download the driver source code (link at the end), compile and install it on your own.

To make it work just download the kernel object (.ko) file which is the compiled module driver for the kernel. I will be updating this section for different kernel versions.

For raspbian image: 2013-07-26-wheezy-raspbian.img
8188eu.ko (Compiled in 2013-08) (Working in kernel Linux raspberrypi 3.6.11+ #474 PREEMPT)

For raspbian image: 2013-09-25-wheezy-raspbian.img
8188eu.ko (Compiled in 2013-10) (Working in kernel Linux raspberrypi 3.6.11+ #538 PREEMPT)

For raspbian image: 2013-12-20-wheezy-raspbian.img & 2014-01-07-wheezy-raspbian.img
8188eu.ko & firmware (Compiled in 2014-01) (Working in kernel Linux raspberrypi 3.10.24+ #614 PREEMPT & 3.10.25+ #622 PREEMPT)

For raspbian image: 2014-06-20-wheezy-raspbian.img
8188eu.ko & firmware (Compiled in 2014-06) (Working in kernel Linux raspberrypi 3.12.22+ #691 PREEMPT)

For raspbian image: 2014-09-09-wheezy-raspbian.img
8188eu.ko & firmware (Compiled in 2014-09) (Working in kernel Linux raspberrypi 3.12.28+ #709 PREEMPT)

For raspbian image: 2014-12-24-wheezy-raspbian.img
8188eu.ko & firmware (Compiled in 2014-12) (Working in kernel Linux raspberrypi 3.12.35+ #730 PREEMPT)

Place the .ko object in the following path:


In my case it is the following path:


Last version of the rtl8188eu driver includes a firmware file called rtl8188eufw.bin you have to place this file under:


Now execute the following commands

depmod -a

modprobe 8188eu

We are done. You should see now the new interface (wlan0 normally) when the device is connected.

Driver source code:



182 Responses to “TP-LINK TL-WN725N v2 working on Raspberry Pi (Raspbian)”

  1. Srihari HS says:

    Unable to install drivers on pi for my TP-LINK – WN725N.
    My Raspberry pi version is Linux raspberrypi 4.4.11-v7+ #888 SMP Mon May 23 20:10:33 BST 2016 armv7l GNU/Linux

    Please help!

    Thanks in advance

  2. […] benötigt einen zusätzlichen Treiber. Ich habe es mit ein Paar Anleitungen Versucht, jedoch war dies hier die […]

  3. GuilhasSpeedy says:

    Hi Samuel,

    Do you know if I can use the TL-WN725N on 2.6.15-sigma?

    AZBox[host]$ uname -a
    Linux AZBox 2.6.15-sigma #138 PREEMPT Thu Jan 22 21:35:07 KST 2009 mips unknown


  4. PeterH says:

    Hi Samuel,

    Would it be possible for you to update the driver to kernel version 3.18.11+ or 3.18.11-v7+ ?

  5. DaniloMedeiros says:

    Dear Samuel, I’m getting the following error: “ERROR: could not insert ‘8188eu’: Exec format error” when trying to modprobe 8188eu”.

    uname -a

    Linux rubus 3.18.7+ #755 PREEMPT Thu Feb 12 17:14:31 GMT 2015 armv6l GNU/Linux

    (rubus is a hardened version of raspbian)

    Do I need updated drivers? Thank you

  6. […] vez que contamos con la versión, nos dirigimos al siguiente post donde podremos descargar de acuerdo a la versión el paquete correcto del […]

  7. Guille says:

    Hello Samuel!!

    Have you plans to make a driver for the last build?

    Or, the last one will work?

    Thank You!!

  8. Kiran Reddy says:

    Nice one, worked a treat. Thank you.

  9. Gwynne says:

    I am so confused!
    I am new to all this and haven’t a clue about programming … which is why I have bought the raspberry so I can start slowly.

    Got a B+ last Friday. Linked all up downloaded the latest NOOBS and installed Raspian.

    All good so far.

    Bought a TP-Link WiFi dongle (TL-WN725N) from Maplin. Assured by them that it works – which it doesn’t!

    Followed this post so far as a I can. I have downoaded the driver:

    8188eu.ko & firmware (Compiled in 2014-12) (Working in kernel Linux raspberrypi 3.12.35+ #730 PREEMPT)

    and placed it on my micro sd card.

    This tutorial is good until it says:

    Place the .ko object in the following path:


    Then I’m lost! Sorry to be a numpty!

    I have gone into terminal and am now in the root using the super user (LOL) commands and now what?

    how do I do the next steps? how do I put the .ko file into that path? How do I find the path?

    Novice numpty going mad here!


  10. heartbleed says:

    I cannot get it running on #730. #709 worked fine. It would light up for about a second and turn off. iwlist scan says no results and iwlist scan wlan0 gives results and if iwlist scan is run again it would return results. I cannot run it on #709 as well now. lsmod shows 8188eu loaded but no users for that. so interface seems okay for both builds. I do the following
    -copy the zip to /boot from card reader
    -cp /boot/*.zip .
    unzip *.zip
    cp *.bin /lib/firmware/rtlwifi
    install -p -m 644 /lib/*/*/*/*/net/wireless/
    insmod /*/*/*/*/*/*/net/witeless/*.ko
    depmod -a
    for the first time it will blink many times on reboot
    after that everytime on booting up one second blink and problem explained in the beginning

    Please let me know if any of my steps are incorrect. I copy the zip to card from ubuntu via card reader

    • Samuel says:

      Hi heartbleed, try the following:

      * Install a fresh image –> 2014-12-24-wheezy-raspbian.img and check that is running #730 kernel.
      * Copy the zip (8188eu.ko & firmware (Compiled in 2014-12)) to card as you did.
      * unzip
      * copy the .ko object to /lib/modules/3.12.35+/kernel/drivers/net/wireless
      * copy the .bin file to /lib/firmware/rtlwifi
      * depmod -a
      * modprobe 8188eu

      • heartbleed says:

        It works now ,this time I used cp v/s install , the perms where 644 anyways, I did not use insmod but used mod probe as ou said. on all previous builds 614&709 I followed old way, I don’t know anything about kernel dev still wondering what could have been the prob . One clue it that it will light up for a second instead of blinking . and iwlist scan will not return anything unless root runs it . weird

        Thank you :)

  11. Patlabor says:

    Very handy and helpful! Thanks a million!

  12. Len says:

    Thanks for the kernel object – much appreciated. This has saved a load of time !

  13. NickG says:


    Thank you for your instructions. I followed them all the way through but executing modprobe at the end failed. I suspect it is because of the different kernel versions. I am running 3.12.35+ #730 PREEMPT from the most recent version of Raspbian. I’ve tried a lot of different things today trying the get it working so it is possible i’ve upgraded something beyond the most recent build. Any suggestions on how to get it to work? Thank you in advance.

  14. […] I have tp link wn725n usb Wifi. After sometime it gets disconnected from wifi. The driver i am using is 8188eu after following the tutorial at […]

  15. FedeX says:

    Hi, Samuel
    I have a Raspberry B+ with 3.12.28+ #709 Kernel,i follow all the steps that you wrote.
    When i connect the dongle (TP-Link WN-725n V2) the led starts to flash and then keeps on a few seconds later appears a kernel panic message.

    i dont know what to do. i appreciate any help

  16. Mark says:

    Hi Samuel thank you for the post,
    As you suggested in one of the comment I copied the files 8188eu.ko and the bin file to sd card(do we have to copy the file in a particular directory?I just copied directly to the sd card),now when when I execute the command ls /boot the .ko and .bin file doesn’t exist but acc to the post it should exist a strange problem?Im newbie in the world of raspberry pi so im sorry if you find this question annoying

    • Samuel says:

      Hi Mark, don’t worry for asking.
      If you have copied the files to the sdcard you should see them under the /boot path in your Raspi. It does not make sense if you can see them. You could try to copy the files to an USB pendrive and then connect it to the Raspi and move the files.

  17. Blue says:

    Hola Samuel, ayer estuve 6 horas tratando de configurar el bendito dongle y como una bendición llegue a tu pagina, solo para comentarte que el kernel ya esta en el 3.12.33 y por lo tanto no podía hacer funcionar el driver, tuve que formatear y volver al sistema anterior. Ojalá puedas ayudarnos para saber como se compila el driver para este nuevo driver.
    Por lo demás tu pagina tiene un lugar preferente en mi barra de favoritos, sigue así!!

    • Samuel says:

      Hola Blue, el driver se compila como cualquier otro en Linux, lo único es que hay que tener especial cuidado con el fichero Module.symvers. Este fichero se tiene en cuenta cuando compilamos el driver y debe coincidir exactamente con la versión del kernel donde se quiera ejecutar (hay que buscar el apropiado dentro del proyecto Cuando esto no se cumple, aparece el típico mensaje ERROR: could not insert ‘8188eu’… al instalar el driver. Por eso yo compilo únicamente para las versiones que vienen de serie cuando descargas las distintas versiones de Raspbian, si no tendría que tener muchísimas versiones del driver. En cuanto tenga algo de tiempo intentaré escribir un post acerca de compilar este driver para cada versión. Mientras tanto si aparece una nueva versión de Raspbian aquí intento siempre tener el driver compilado para el núcleo que viene de serie.

      Muchas gracias por tu apoyo :).

      • Blue says:

        Genial, hoy probaré lo que me indicas, la verdad no quede satisfecho teniendo que formatear pero al menos me liberé de tener que estar amarrado a un cable de red.
        De nuevo muchas gracias, eres un crack!, te debo una jarra de cerveza.

        Saludos desde Lima.

  18. Anders says:

    When I try to extract the files to the respective directories I get a message that I’m not allowed that operation. Also I cannot copy paste the files manually, “Permission denied”
    What to do?

    • Samuel says:

      Hi Anders, every step from the post must be done as root user. You can prepend the ‘sudo’ word to every command to obtain the required permission when your are logged as the ‘pi’ user.

  19. Guille says:

    Hello I’m installed the last compilation 9-2014, and all was ok, but some time after working, I lost the reach to the RPI, If I plug the Ethernet cable , and make a dmesg command I got this:

    [33703.303757] R8188EU: ERROR indicate disassoc
    [87957.424663] ERROR::dwc_otg_hcd_urb_enqueue:505: Not connected
    [87957.474644] usb 1-1: USB disconnect, device number 2
    [87957.474679] usb 1-1.1: USB disconnect, device number 3
    [87957.474943] smsc95xx 1-1.1:1.0 eth0: unregister ‘smsc95xx’ usb-bcm2708_usb-1. 1, smsc95xx USB 2.0 Ethernet
    [87957.475008] smsc95xx 1-1.1:1.0 eth0: hardware isn’t capable of remote wakeup
    [87957.525332] usb 1-1.3: USB disconnect, device number 4
    [87957.525691] R8188EU: ERROR indicate disassoc
    [87957.744693] Indeed it is in host mode hprt0 = 00021501
    [87958.074963] usb 1-1: new high-speed USB device number 5 using dwc_otg
    [87958.075150] Indeed it is in host mode hprt0 = 00001101
    [87958.384874] usb 1-1: New USB device found, idVendor=0424, idProduct=9512
    [87958.384927] usb 1-1: New USB device strings: Mfr=0, Product=0, SerialNumber=0
    [87958.396388] hub 1-1:1.0: USB hub found
    [87958.396561] hub 1-1:1.0: 3 ports detected
    [87958.674606] usb 1-1.1: new high-speed USB device number 6 using dwc_otg
    [87958.774845] usb 1-1.1: New USB device found, idVendor=0424, idProduct=ec00
    [87958.774880] usb 1-1.1: New USB device strings: Mfr=0, Product=0, SerialNumber =0
    [87958.777983] smsc95xx v1.0.4
    [87958.845824] smsc95xx 1-1.1:1.0 eth0: register ‘smsc95xx’ at usb-bcm2708_usb-1 .1, smsc95xx USB 2.0 Ethernet, b8:27:eb:b7:ac:4e
    [87958.924758] usb 1-1.3: new high-speed USB device number 7 using dwc_otg
    [87959.026547] usb 1-1.3: New USB device found, idVendor=0bda, idProduct=8179
    [87959.026583] usb 1-1.3: New USB device strings: Mfr=1, Product=2, SerialNumber =3
    [87959.026599] usb 1-1.3: Product: 802.11n NIC
    [87959.026613] usb 1-1.3: Manufacturer: Realtek
    [87959.026629] usb 1-1.3: SerialNumber: 00E04C0001
    [87959.028738] Chip Version Info: CHIP_8188E_Normal_Chip_TSMC_A_CUT_1T1R_RomVer( 0)
    [87959.047432] smsc95xx 1-1.1:1.0 eth0: hardware isn’t capable of remote wakeup
    [87959.824940] MAC Address = 64:66:b3:1d:24:21
    [87960.637631] smsc95xx 1-1.1:1.0 eth0: link up, 100Mbps, full-duplex, lpa 0x45E

    Abd the Dongle started to work again..

    Can you help me?

    Thank you!!!

    • Samuel says:

      Hi Guille, I’ve seen this behavior before when the dongle is too far from the access point or if the power supply is not enough. What kernel version are you using?

      • Guille says:

        Hello Samuel!

        My Kernel is 3.28.12+

        The RPi it’s about 50cm from the router, maybe to close?

        I Started to think about power, and I measured 4.88V at TP1.

        The PSU its a Samsung with a 5Vcc 2A output I’m wondering if the PolySwitch its dropping the voltage…
        I Not measured befor the Polyswitch to check yet…

        What do you think?
        Thank you!!

  20. Luigi says:

    Hi Samuel,
    I’m struggling in finding a way to switch off the led on my wifi usb. Any way to do that? As a minimum I’d like to get it fix.
    Thanks a lot!

    Bus 001 Device 004: ID 0bda:8176 Realtek Semiconductor Corp. RTL8188CUS 802.11n WLAN Adapter

    • Samuel says:

      Hi Luigi, your question is quite interesting. We would have to dive into the driver source code from above. I’ll check it when I find some time and I’ll tell you my findings :).

      • Luigi says:

        Thanks Samuel. I’ve seen that in the old drivers source there was an option specific in autoconf.h but I cannot see it in the new driver.

        diff -aur rtl8192cu-flashingLED/include/autoconf.h rtl8192cu/include/autoconf.h
        — rtl8192cu-flashingLED/include/autoconf.h 2013-06-05 17:27:32.725842096 +0100
        +++ rtl8192cu/include/autoconf.h 2013-06-05 17:25:09.405027367 +0100
        @@ -117,7 +117,7 @@

        #define CONFIG_SKB_COPY 1//for amsdu

        -#define CONFIG_LED
        +//#define CONFIG_LED
        #ifdef CONFIG_LED
        #define CONFIG_SW_LED
        #ifdef CONFIG_SW_LED

        Last but not least, it would be great if this option would selectable and not just builtin in the driver.

  21. Marco Sartore says:

    many thanks for this how-to. I have setup and run my TP-LINK wireless WN725N on RPI in a while !

  22. fran says:

    I’m not sure why… but when I execute the last command

    modprobe 8188eu

    I obtain the follwing error

    FATAL: Module 8188eu not found.

    Any idea why? thanks!

    PS: My kernel version is 3.12.28+

    • Samuel says:

      Please check that the .ko file is at /lib/modules/3.12.28+/kernel/drivers/net/wireless. Do an ‘ls’ to be sure. Then remember executing ‘depmod -a’.

  23. martin h says:

    thank you so much for this. trying to build it from source but always endup find error that i couldnt solve. this page save me a lot of hours! thanks again for sharing. (Raspbery Pi B+ & raspbian & D-Link DWA-123).

  24. […] En navigant pas mal, j’ai fini par trouver la solution sur un site qui propose différentes versions compilées du driver. Donc si ce site a pu me servir je tiens à partager sa très bonne initiative de mettre à disposition ces drivers compilés : TP-LINK TL-WN725N v2 working on Raspberry Pi (Raspbian) […]

  25. Okiseb says:

    Thxxxx !!!!

  26. […] En navigant pas mal, j’ai fini par trouver la solution sur un site qui propose différentes versions compilés du driver. Donc si ce site a pu me servir je tiens à partager sa très bonne initiative de mettre à disposition ces drivers compilés : TP-LINK TL-WN725N v2 working on Raspberry Pi (Raspbian) […]

  27. Tomas says:

    This totally made my night! I was up and running in 5 minutes :)

    And thanks for keeping it up to date, just got my Raspberry Pi today so.. Cheers!

  28. Timmaahh says:


  29. Sudo says:

    May the force be with you, always.

  30. MH2538 says:

    Thank you man. You saved my compile time .

  31. Howard says:

    Hi Samuel,

    I’m new in raspberry, so sorry for asking so stupid but where i must paste that .ko file? (on SD card, in pc?) Or is it command ?
    Can you explain it for dumber users like me ?

    Thank you for answer…

    • Samuel says:

      Hi Howard and don’t apologize for asking when you don’t know something.

      There are two files you have to copy to your Raspbian system. The .ko and the firmware file.

      In order to move the files you can, for example, copy them using your Windows PC to a USB pendrive and then connect it to the Raspi. Another way is to insert your SD card in your Windows PC and copy the files there. Then in Raspbian you can find those files in the /boot path.

      Raspbian is a Linux based system so in order to copy the files to the locations I mention in the post you have to use the ‘cp’ command in the console. For example if you copied the files to the SD card you can type ‘ls /boot’ to list all the files under the /boot/ path. You must see the .ko and the firmware there.

      Now in order to copy the .ko file you would type ‘cp /boot/8188eu.ko /lib/modules/(your-kernel-version)/kernel/drivers/net/wireless’ but because the target location is write-protected to users you will have to add the ‘sudo’ command and type your password before.

      So the command will be ‘sudo cp /boot/8188eu.ko /lib/modules/(your-kernel-version)/kernel/drivers/net/wireless’. The same operation for the firmware file ‘sudo cp /boot/rtl8188eufw.bin /lib/firmware/rtlwifi/’.

      The last step is to execute the commands, also with sudo, from the post above ‘sudo depmod -a’ and ‘sudo modprobe 8188eu’.

      Before all of that be sure that you know your Kernel version by typing ‘uname -a’ and click the appropriate download for your Kernel from the post above.

      • Howard says:

        Thank you for reply. Ok, ewerythink is good but when i type “sudo modprobe 8188eu” it says “ERROR: could not insert 8188eu : Exec format error”, my kernel is 3.12.26+ if it somehow help, im using pitft26r-140909 raspbian witch helps me use pitft display as fast as i plug it in.

        • Samuel says:

          Hi Howard, if you looked above, I have no drivers for your kernel version. You will have to download a Raspbian image that matches one of the kernels I mention. For example you can download the latest Raspbian version at present (2014-09-09) and use the last driver I uploaded.

      • mmike says:

        YES!!!! Thank u sooooo much! u are great! i followed yor instructions above (copy to cd card-> type commands sudocp…) and it worked! It worked as a charm!

  32. Tarun says:

    Sorry for off topic. I want to run my pi as a print server but could not find drivers for Epson L210. Please could any one help me get the drivers?
    I have installes cups but it is not showing driver for my printer on cups printer driver page.


  33. Nejm says:


  34. raajan says:

    Hi, I am using EDUP EP-8508N USB Adapter with rtl8188ETV chipset. My raspberry version is 3.12.28+ and I have tried everything but I am unable to install its driver on my raspberry. I am new to Linux. Can somebody Help.


    • Samuel says:

      Hi Raajan,

      It seems that the chipset for your device is Realtek8188CUS, you should look for a suitable driver for that model. The version you mentioned is the Linux Kernel version not the Raspi version. Type ‘uname -a’ in your console to view the exact Kernel version, something like ‘Linux raspberrypi 3.12.28+ #709 PREEMPT’. You will need that to find a proper driver.

      • raajan says:

        Hi Samuel,
        I will get back.. right now in office


      • raajan says:

        Hi samuel,
        uname -a gives following

        Linux raspberrypi 3.12.28+ #709 PREEMPT

        lsusb gives following
        RTL8188ETV Wirless LAN 802.11 Network Adapter.

        Can you please help me now how can i install its driver .. Would be of great help.


        • Samuel says:

          Hi Raajan,

          I don’t have your device and it’s hard for me to investigate further. Besides this post talks about another driver. However, as I said, it seems that the driver suitable for you is 8188CUS. You can download the driver and read the documentation about it from the official website here. I’m sorry but I can’t help you more.

  35. Pedro says:

    If only I had found this page a few hours earlier, it would save me precious sleeping time :)
    Thank you so much for sharing, Samuel !

  36. Sriram Kannan says:

    Thanks a lot man! The updated file which you uploaded today (21st September 2014) made it work for me! What a coincidence, I’m trying to get it work today and you uploaded just few minutes ago! Thanks again!

  37. Chris Krz says:

    I got my Pi working with the most recent driver available at your site. Now, I foolishly upgraded the Firmware to 3.12.28+ #710 PREEMPT Wed Sep 10 15:23:42 BST 2014 with the effect that this silly TP-Link dongle stopped working again. Do you think you can provide a more current version or point me to a source from where I can download it?
    Thanks and kind regards

    • Samuel says:

      Hi Chris,

      I have just compiled and uploaded the driver for the “Linux raspberrypi 3.12.28+ #709 PREEMPT” kernel which is the one you get when you download the latest raspbian image “2014-09-09-wheezy-raspbian.img”. You can try this version for your current kernel and see if it works. Besides you have the link for the driver source code in the post if you want to compile it yourself.

  38. Tarun says:

    I have a comfast wifi adapter this and I am running NOOBS
    Offline and network install
    Release date:2014-09-12

    when I follow your instructions my wifi detects but my raspberry pi do not boot up next time, please could you help me?

    • Samuel says:

      Hi Tarun,

      I’m downloading NOOBS to try what you say. I’ll let know you when I’m done.

      • Tarun says:

        Thanks for your help Samuel!!

        • Samuel says:

          Hi Tarun, after installing Raspbian from NOOBS you can check your version by typing “uname -a” in the console. You can see “Linux raspberrypi 3.12.28+ #709 PREEMPT”. I did not have a driver for that version until now, I’ve just compiled and uploaded it and you can download it from the link above in the post. It works perfectly.

  39. […] on getting the TP-LINK TL-WN725N v2 to work on Raspberry Pi (Raspbian): Here we are just going to show the main steps (make sure you have the dongle inserted in one of […]

  40. aaron says:

    Thanks for the help! Worked like a charm for my v2.

  41. Brian92127 says:

    I get the point where it says:
    Now execute the following commands
    depmod -a

    I get:
    ERROR: could not open directory /lib/modules/3.10.25+: No such file or directory.

    Which, in my case is true because my kernel version is 3.12.22+.

    So, do I need to modify the path for depmod? If so, how? Or, is there something else I am missing?


    • Samuel says:

      Hello Brian,

      I recommend you to download and burn the latest Raspbian image and repeat the steps. It should work with no trouble.

  42. HEIMDAL13 says:

    Hi again. Trying to solve my problems with disconnection issues, I tried to install the last version of raspbian and install your new drivers. Unfortunately the problem persists. wlan0 disconnects after some time.

    I’m able to restore the connection whit this command: “sudo ifup –force wlan0” But the connection falls again after some time.

    I have read somewhere that this problem may be related to power saving. When my connection drops, the adapter starts to blink slow and regular (when connected it blinks fast and irregular).

    I attach here a pic of the interfaces file and the wlan configuration to see if you can identify the problem.


    • Samuel says:

      Hi HEIMDAL13,
      It’s a shame you still have connection problems. In fact the latest Raspbian and the latest driver work much better than in previous versions. By your pictures the only thing I can see is that your link quality seems very poor. Can you get closer to your access point?

      You could try the following things and see if you get the same behaviour:

      * Try to connect to a different network (AP) if you can.
      * Try to change the security of your network, e.g. WEP or OPEN.
      * Try to connect your TP-Link through a powered USB Hub to your Raspi.

      If during some test you see your TP-Link doesn’t disconnect, as you mentioned, you can get some idea of the problem.

      • HEIMDAL13 says:

        I moved it to a place near the access point, now the raspberry pi doesn’t get disconnection issues! Now I will try to see if using a powered USB Hub I can reach longer distances

        Thanks a lot!

  43. Mickael says:

    Hello !

    I have an error : ERROR: could not insert ‘8188eu’: Exec format error, any idea ?
    I’m using kernel 3.12.20+


    • Samuel says:

      Hello Mickael,

      I’ve just uploaded the drivers for the latest Raspbian version (2014-06-20-wheezy-raspbian.img) which is using the kernel 3.12.22+. You can try if this driver works for you and, if not, I recommend you to download this latest Raspbian and the mentioned driver.

  44. Juan says:

    Hey Samuel,

    I have the same adapter as you and a raspbian version 3.10.25+ #622. I followed the instructions that you indicated above but for some reason it won’t let me copy the .bin file into /lib/firmware/rtlwifi, despite using the same command that works for the .ko file.

    This is the command I introduced:

    sudo cp rtl8188eufw.bin /lib/firmware/rtlwifi

    but i get:

    cp: cannot stat ‘rtl8188eufw.bin’ : No such file or directory.

    I am a complete beginner on raspberry pi so I apologize in advance if this a stupid question :). How could I get over this issue?

    Gracias de antemano


    • Juan says:

      Don’t worry Samuel.. I finally got it working! :D

      I re-installed the raspbian into my card to start with a new version, as I had been installing lots of folders here and there and by following your simple instructions got it detected straight away.

      Thank you very much


      • Samuel says:

        Hi Juan,

        I’m glad you got it working. You don’t have to apologize for asking if you have doubts, everyone has been a beginner sometime. By the way, the error you were getting means that the file you are trying to copy (rtl8188eufw.bin) doesn’t exist in your current folder. You can list the files in your current folder using the “ls” command. You’ll see that you will get the same error if you make some file up and try to copy it somewhere, e.g., “cp doesntexist.txt /usr/src”

        Thank you for your comment.

  45. leuk_he says:

    thx.’ you saved me cable. now someone needs to include this files into raspian

  46. MemphiZ says:

    Could you please compile this driver for kernel 3.13? I would need this for kali on raspberry pi!

    • MemphiZ says:


      • Samuel says:

        Hello MemphiZ, I’ll try to take a look at it this weekend. To be honest I haven’t played very much with Kali on Raspi. I’ll write a post about Kali & TL-WN725N. I just need some free time though.

        • Samuel says:

          Hello again MemphiZ, I’ve looking into this but it’s going to take some time because it’s not easy to find the exact headers or kernel source that has been used in Kali in order to compile the driver. Stay tuned..

  47. Mike says:

    You are the BEST, I have spent hours looking for the proper way to do this…
    Thank you!

  48. Simone says:

    Hi, I followed the guide, but something doesn’t works.
    tp-link have blinked (green) for a while after installation.
    But now, at boot time, “configuring network interfaces” doesn’t succed, and since this booting step also keyboard goes down.

    I’ve a photo but is not possible tu upload here.

    • Samuel says:

      Hello Simone,
      I will need more information in order to help you out. Are you using the latest version of Raspbian? You can upload some pictures or logs elsewhere and copy here the links.

      • Simone says:

        Hi Samuel,
        thanks for your support.
        In this time I changed the device, buying another one.
        It was very strange in many situations.

        But for now I confirm that I downloaded latest version.

        Now I try with the new, I hope there will not be problems.

  49. Mohamed Ibrahim K says:

    Thank U So much..

    It worked…


  50. Alan Haverty says:

    Brilliant stuff, thanks man!

  51. Darren says:


    Thanks so much for your instructions.
    It saved me. I tried a few others that I had found but youra worked first go.

    Thankyou thankyou

  52. larry says:

    muchisimas gracias!! tu tutorial me a funcionado!!

  53. Julia Freeman says:

    hello Samuel,

    Thank you for this post which gives me some hope after spending the whole weekend trying to get the wifi adapter to work. However..
    I am using kernel:
    Linux mpi 3.10.25+ #622 PREEMPT Fri Jan 3 18:41:00 GMT 2014 armv6l GNU/Linux
    I tried the last version of your driver, but I get the following error when executing modprobe 8188eu:
    ERROR: could not insert ‘8188eu’: Exec format error

    the last line of dmesg says:
    [12259.552786] 8188eu: disagrees about version of symbol module_layout

    Can you help me?

    Thanks in advance


    • Samuel says:

      Hello Julia and thank you for your comment.

      I see “Linux mpi” at the beginning of your kernel information line instead of “Linux raspberrypi”. What distro are you using?

  54. McLarenX says:

    Ok, I try it in english.

    Hi Samuel, I used your .ko for my 2014-01-07-wheezy-raspbian with kernel 10.03.25 + and after trying several different settings in the /etc/netwok/interfaces I got was connected to the router.

    So far perfect, but something strange happens, every 5 minutes or so WiFi disconnects and I do “ifup wlan0” to be reconnected. Did you happen something similar? I think it happens specially when transmitting data constantly during those 5 minutes, for example downloading something, playing a movie for streaming or connect via ssh.

    Thank you very much for your effort and I hope that you can help me because otherwise I’ll have to buy another USB WiFi adapter.

  55. Ben says:

    Thanks a lot !
    Worked perfectly.. except for the zip file which I had to extract on windows first… dunno why…
    However it works !

    • Samuel says:

      You are welcome. Next time you want to decompress a zip file in Linux, just open a console and type


  56. McLarenX says:

    Hola Samuel, creo que me entenderás en español. Utilicé tu .ko para mi 2014-01-07-wheezy-raspbian con kernel 3.10.25+ y tras probar varias configuraciones diferente en el /etc/netwok/interfaces conseguí que se conectara al router.

    Hasta aquí perfecto, pero me pasa algo muy raro, cada 5 minutos más o menos se me desconecta y tengo que hacer ifup wlan0 para que se vuelva a conectar. ¿Te ha pasado algo similar? Creo que pasa sobre todo cuando transmite datos constantemente durante esos 5 minutos, por ejemplo descargando algo o reproduciendo una película por streaming.

    Muchas gracias por tu esfuerzo y espero que puedas ayudarme porque sino voy a tener que comprarme otro adaptador WiFi USB.

    • Samuel says:

      Hola McLarenx, gracias por tu comentario. No te he respondido antes porque ando un poco liado estos días y no he podido dedicarme demasiado al blog, nada que ver con la pregunta en castellano, faltaría más :). El comportamiento que me comentas es algo que ha aparecido en esta última versión y que les está ocurriendo a algunos usuarios, no todos. Esto es lo raro. Yo creo que se manifiesta con algunos puntos de acceso y tipos de encriptación. Estoy investigando, en cuanto tengo algo de tiempo, la causa de esto y si se soluciona con versiones posteriores del kernel de Raspberry. Espero poder publicar algo al respecto esta semana. Si me quieres echar una mano puedes comprobar si esto te sigue ocurriendo si cambias de WPA a WEP por ejemplo, o quitando la encriptación y me cuentas.

  57. Barry says:

    hi , i am trying to save the files as follows, using FileZilia , but i get a open write permission denied message , i have tried to change the file/folder attributes but i still get a denied message. How can i fix this issue?

    Place the .ko object in the following path:


    In my case it is the following path:


    Last version of the rtl8188eu driver includes a firmware file called rtl8188eufw.bin you have to place this file under:


    Now execute the following commands

    • Samuel says:

      Hello Barry, to copy files to those directories you need to be root or a user that has been given write permission by root in that path. I assume you are connecting to your Raspi using the SFTP connection (SSH & SFTP service is active by default) using the pi user, which is not allowed to copy files there. You first need to be capable of login as root in your Raspi.

      To achieve this you have to have access to a Raspbian console (Shell). You can do this by connecting a keyboard and a monitor to your Raspi or you can connect using the SSH service, using for example PuTTY (Windows) or ssh command from Linux. Once in the console you have to type the following:
      sudo passwd
      you will have to set a password for the root user.
      After this step you can login as the root user. To check that try the following command:
      su root
      and type the password you set. Now the prompt has changed and you can check you are root by typing:
      Done. Now connect to the Raspi using FileZilla as you did but using root credentials and you will be able to copy the files.

  58. gujunpu says:

    I can’t begin to describe how excited I am, I already took a long time on it.I,m tired!
    I don’t belong to the English speaking countries, but I have to look for information from BBS which belongs foreign countries.
    Thanks! Sincere thanks to you !

  59. Camillo says:

    Hi, I did everything like You say, downloaded Your drivers & FW, kernel is 25+, fresh install, i can see the module in lsusb and lsmod, but the command “iwlist scan” gives me “No scan results”; do You think it can be due to low power given to the RPi?
    Thank you!

    • Samuel says:

      Hi Camillo, it’s weird you get no scan results if you did all the steps I wrote. To check if it’s something related to power try to plug a good wire directly connected to a wall socket. Another check you can do is to place the Raspi very close to a wireless network, for example you can quickly create a wireless network if you have a smartphone. Try to put the wireless in a worldwide compatible channel, from 1 to 11. See if you can get any results, using iwlist or wpa_gui from the Raspbian Desktop (Wifi Config icon).

  60. styxsailor says:

    Cristobal Colon, endlich I have found a working solution for this after two days of pain! Thanks a tonne!

    I forgot the firmware file,,,

  61. Kurtis says:

    Thank you for publishing this tutorial; it was very useful. I plugged in my Raspberry Pi for the first time today and was on the Internet in less than an hour because of your help. Most of that time was spent figuring out how to copy the above files to the correct folders. As someone with absolute zero Linux experience (coming from Windows) it took me a while to search google and find the right commands needed to give me the permissions to copy these files and run the two commands. I may be giving poor advice here but I wanted to share with your readers what I did: I opened up LXTerminal and ran the command “sudo pcmanfm” which opened up an instance of the file manager with the required permissions needed to copy files to the correct directories (from a USB flash drive in my case). Next, I ran the command “sudo su” from the same terminal which give me the permissions needed to run the “depmode” and “modprobe” commands. For those of us new to Linux even copying a file or running a simple command can be difficult. Hope this saves someone an hour of frustration. Feel free to edit or clarify what I wrote or explain a better way of doing what I did (granting the necessary permissions to copy files and run commands).

    • Samuel says:

      Thank you for your comment Kurtis I’m glad you find this post useful. It’s not always easy to write a post taking in account the different experiences of possible readers but I try to keep that in mind. Nevertheless I think the effort you made surfing the Internet to find a solution is a great way of learning about Linux, and I’m sure you won’t forget the things you’ve learnt that way easily.

  62. HEIMDAL13 says:

    Hi, I followed all the steps and wlan0 is always now always displaying when ifconfig. But After few minutes I lose the internet connection and I can only recover it unplugging and plugging the adaptor. What can be the problem? My kernel is 3.10.25+.

    • Samuel says:

      Hi HEIMDAL13, did you make a clean install? Some people commented that they had problems playing around with various drivers and then, after a clean install of Raspbian, using the drivers from above it worked. If this is not your case, can you provide some log messages when you lose your internet connection? Use dmesg to see if, for example, wpa_supplicant is complaining about something else.

      • HEIMDAL13 says:

        Thanks for the reply!, When the internet connection is lost, I don’t recive any error log. Just the internet stops working. The last internet crash was about an hour after using it, downloading files and web browsing. I have seen that after losing the internet connection, the Wi-Fi adapter interface can’t find any adapter.
        I have made a demsg, I attach you some photos of the results to see if you can’t find some unusual thing.


        • Samuel says:

          Hi HEIMDAL13, I can see what you mean in the third picture. Maybe it’s something related to software. I understand you are using the Wifi Config icon from the Raspbian desktop to connect right? What do you do to recover the connection when is lost? Do you have to restart?

          • HEIMDAL13 says:

            To recover the connection I usually unplug and plug the raspberry to the power again. Because sometimes restarting the raspberry using the command shutdown -r now didn’t recover the connection.

  63. Crypto says:

    I would like to get this driver to work with SMOS linux, which is a distro I would like to use for mining.

    Do I need to compile the driver for SMOS or can I use the compiled version in your post?

    How can I compile it?

    And what folder do I install it into?

    • Samuel says:

      Hello Crypto, the drivers are compiled for a specific version of the Linux kernel so you will need to compile them for the kernel you are using in your distro.

  64. smyq says:

    Hi, I have kernel ver. 3.10.25+ and I managed to install the driver, but it acts strangely. When I scan for new networks using wicd the signal strength is “-1%” and it can’t connect to any network.

    But most importantly – I can’t use it in ad-hoc mode. It’s not working at all. When I set the interface up it is not visible by others.

    I have even installed new copy of Raspian, nothing works. Do you have any suggestions?

    • Samuel says:

      Hello smyq, can you provide some log information using dmesg when trying to connect to a network or putting the card in ad-hoc mode? Also is useful to check what the “iwlist wlan0 scan” outputs.

  65. Base 02 says:

    Initially it did not work I think because some files were corrupted from previous attempts but then I installed a fresh new 2014 raspbian image and now it’s working, thanks a lot :)

  66. Nick says:

    wlan0 now shows up in ifconfig, but WiFi Config shows no connections, nor does scan show any. Any help would be appreciated!


    • Samuel says:

      Hello Nick, could you give me more information? what kernel are you using? what driver did you download? does dmesg output something weird about wlan0? what does iwconfig output?

      • Nick says:

        Kernel 3.10.25+
        Downloaded the driver for raspbian images 2013-12-20-wheezy-raspbian.img & 2014-01-07-wheezy-raspbian.img (2014-1 download)
        dmesg outputs a long list of stuff, but it doesn’t seem to print anything about wlan0 specifically
        Here’s a link to what iwconfig output for wlan0:

        Thanks for the help Samuel :) I may just reinstall Raspbian just because and install the driver properly the first time. I think I may have messed it up, and I also found a download for one that was compiled for 3.10.26+ (so I may have to find the new kernel version as well; not too sure how to do that…)

        • Samuel says:

          If you have 3.10.25+ try this:

          modprobe -r 8188eu
          rm /lib/modules/3.10.25+/kernel/drivers/net/wireless/8188eu.ko

          Download & unzip “8188eu.ko & firmware (Compiled in 2014-01)” from above.

          Copy the downloaded 8188eu.ko in /lib/modules/3.10.25+/kernel/drivers/net/wireless/
          Copy rtl8188eufw.bin in /lib/firmware/rtlwifi/

          depmod -a

          modprobe 8188eu

          • Nick says:

            Unfortunately I still don’t get any scan results from Wifi Config. Going to reinstall and see if that fixes the problem.

            • Samuel says:

              Test this command:

              iwlist wlan0 scan

              • Nick says:

                Reinstalled and Wifi now works :) I think I may have removed other wireless drivers on my first attempt at copying the new one over D: Thanks again for all the help Samuel :)

  67. Manuel says:

    Nice post, Samuel! Totally worked for me!
    I wasted an entire afternoon searching and trying until I found this method.

    Only a suggestion: it may be difficult to unzip the .ko and the firmware directly on the raspi, for newbies like me. I finally unzipped them on the PC, then uploaded both files to Google drive and at last downloaded’em on the pi.

    Again, thank you so much!

    • Samuel says:

      Thank you for your comment Manuel.

      Next time you have to deal with a compressed file in linux just type the following commands: –> unzip
      file.tar.gz –> tar xvfz file.tar.gz
      file.tar.bz2 –> tar xvfj file.tar.bz2
      file.rar –> unrar file.rar

  68. John says:


    Thanks for the driver. It got an issue with the 2013-12-20 version. After some time, it disconnects from the network, and I don’t see the reason. Could this be a power problem ?

    • Samuel says:

      Hello John,

      Sorry for the delay. I have experienced disconnections with the version you mentioned but then I upgraded 2014-01-07 with the 3.10.25+ kernel from raspberry team and it works fine again. So I don’t think it’s a power problem. You can use the same driver in this new version and it works perfectly.

  69. Lute says:

    Thanks , really. I spent one entire day working this . really thank you.

  70. Oleg says:

    The same error as in previous comment:
    modprobe 8188eu gives error: Exec format error.

    $ uname -a
    Linux pi 3.10.24+ #614 PREEMPT Thu Dec 19 20:38:42 GMT 2013 armv6l GNU/Linux

    • Oleg says:

      Maybe, you will post instruction how can I build driver from source by myself. Now when I try run “make” I’m getting error
      make: *** /lib/modules/3.10.24+/build: No such file or directory. Stop.

      • Samuel says:

        You can find many tutorials about how to compile modules for a Linux kernel on the Internet. The problem with the raspi is that it’s a little bit tricky to find the right kernel source or kernel headers in order to compile a compatible module in order not to get the message “Exec format error” when inserting. Maybe someday I’ll try to write a post about the methods I use. Thank you for your suggestion.

    • Samuel says:

      I have compiled the latest version of the driver for the 3.10.24+ #614 kernel. You can now download it from the new link above. Follow the instructions I wrote in the post and you will get it working.

      • Oleg says:

        Thank you so much!
        I compiled it yesterday as well as you :) But I had no luck to configure the wifi. Then I installed raspbmc and the dongle works out of the box. Strange…

  71. Cliffy says:

    modprobe 8188eu gives error: Exec format error here too, the only difference after a day of googling is that i note i am working this issue 3 months in the future i.e. December 2013 on Wheezy 3.10.25+

    I can see the device via USB:
    Bus 001 Device 004: ID 0bda:8179 Realtek Semiconductor Corp.

    is it possible the 8111eu.ko file is well out dated? i am suprised all the googling i do only shows fixes for AUG and OCT this year…

    • Samuel says:

      Hello Cliffy,

      You were right, the 8188eu.ko is out dated because Raspbian is now using a different kernel. I’ve just compiled the latest version of the driver for the kernel 3.10.24+ #614 which is the one that comes in the latest image you can download from (2013-12-20-wheezy-raspbian.img). However I see you’re using a newer kernel than this and I don’t know if the one I just uploaded will work for you. As soon as I get some free time I’ll try to check this and release a new version.

  72. Roberto says:

    You are the best, man! A whole bunch of tutorial around the web say you have to mess around with recompiling the driver, but my issue (which by the way might be everybody else’s) was I had a #538 kernel. Spread this knowledge all over the world!!

  73. Zuco says:

    Thanks! You saved me compilation time! I had compilation issues with other sources. I just got your module and it worked. Now my Pi is living in the air :)
    By the way if I plug the TL-WN725N the system reboots. It has nothing to do with the driver because it did it before installing the driver as well. I think it’s an energy issue. I’m feeding the Pi with an iPhone adapter that can provide until 1A. I wonder if you experienced the same issue. I just have to plug the TL-WN725N before booting and it’s fine.

    • Samuel says:

      Hello Zuco and thank you for your comment. I’m glad I could help out.

      You’re right about the energy issue, it has nothing to do with the driver. It’s something that happens with this device, I have others (much bigger in size) that you can connect and disconnect and the Raspi doesn’t reboot. One way you can achieve this with the TL-WN725N is using a powered USB hub.

  74. Vittorio says:

    BTW, I’m running Berryboot and the result of uname -v is #1 PREEMPT Sat Sep 7 23:10:27 CEST 2013


    • Samuel says:

      Hello Vittorio,

      I wrote this post in order to get this device working on Raspbian. As you already know, Berryboot is a small distribution that lets you install other “real” distros (including Raspbian). It allows you to have many “at the same time” and choose one in boot time. I suppose you want to use the TP-LINK adapter when running Berryboot to download distros from its repository. I will try to write another post as soon as possible explaining how to achieve this. Meanwhile if you download the Raspbian distribution directly instead of using Berryboot and follow the instructions from above you will get your TL-WN725N working.

      Thank you for your comment.

  75. Vittorio says:


    I’m new to raspberry and I’m trying to use this nano wireless with it.
    My kernel is 3.6.11-rpi-aufs and I always get this error:
    ERROR: could not insert ‘8188eu’: Exec format error

    What can I do for it?


  76. isleofmandan says:

    Thanks. Making the kernel objects available has saved me a lot of time compiling! :)

    Working perfectly.

  77. JuanD says:

    modprobe 8188eu giives error:
    pi@raspberrypi ~ $ sudo modprobe 8188eu
    ERROR: could not insert ‘8188eu’: Exec format error

    kernel: Linux raspberrypi 3.6.11+ #545 PREEMPT Fri Sep 20 23:57:55 BST 2013 armv6l GNU/Linux

    Bus 001 Device 004: ID 0bda:8179 Realtek Semiconductor Corp.

    • Samuel says:

      Hi JuanD,
      I had a very busy week and I could not answer you faster. You were right, I downloaded the latest image from raspberry repositories (2013-09-25-wheezy-raspbian.img) and the driver did not work anymore. So I recompiled it for this new kernel and now you can download it from the post above. It is totally working for me at this moment. I hope this will help you and others to finally use the TL-WN725N V2 device on a raspi.

  78. Alexis says:

    This driver doesn’t work anymore since the last linux updates… It gives an error (exec format error).
    You have to take the last raspbian distribution and NOT do any apt-get update/upgrade…

    I’m looking for a smarter solution for several days.

    • Samuel says:

      Hi Alexis,
      I just downloaded again the latest version from the raspberry’s repositories (, I burned it on a different sdcard. I downloaded the 8188eu.ko compiled module from the link above and copied it in a pendrive. I turned on my raspi with the new sdcard, the pendrive and a keyboard connected. I followed the above instructions and turned off the raspi. I switched the pendrive for the TP-LINK TL-WN725N V2 and then turned on the raspi. It worked perfectly.

  79. Josh Pritt says:

    modprobe 8188eu gives error: Exec format error. Now what?

    • Samuel says:

      Hi Josh,

      Are you using Raspbian? What version? What kernel are you using now?

      Maybe I can help you out with more information.

Leave a Reply

Time limit is exhausted. Please reload CAPTCHA.