WiFi telemetry for Cleanflight with EZ-GUI and ESP8266

Some time ago I have written a tutorial how to setup Bluetooth based telemetry link between Cleanflight and PC or smartphone. It’s simple and it works. But it has some disadvantages. For example, connection is very very slow and has a limited range: up to 10 meters. While it is enough to change PIDs before flight or plan a mission with EZ-GUI, it is not enough to have a real, usable and reliable, telemetry link.

ESP8266 ESP-01 Version 2

Luckily, Bluetooth is not the only cheap radio protocol we can use for purposes like this. Why not to use WiFi? Since market saw ESP8266 some time ago, cheap programmable WiFi modules became a reality. There are cheap, they are simple to use and can be programmed to do much more than just act as Access Point or network client. There are many alternative firmwares. For example ones that provides transparent bridges via TCP to allow pass serial ports over WiFi. Almost like serial over Bluetooth, but using WiFi instead. In theory that gives more range, higher speed and lower delay. Why not to use it to connect Android smartphone to drone flight controller and have nice an cheap telemetry solution? Exactly, why not. In this example how to do it with Android EZ-GUI and Flip32 running Cleanflight 1.12, but exactly the same trick can be used for Betaflight, SPracingF3, iNav, Baseflight, Naze32, APM, Pixhawx, MultiWii. If anything is using UART, it can also use ESP8266 as serial bridge over WiFi.

Things we need

  • Flight controller with free UART serial port. It can be hardware or Software Serial. In this example it will be Flip32 running Cleanfligh 1.12 via MSP protocol, but it will work for MAVLink too
  • ESP8266 with flashing device
  • 3.3V voltage regulator, for example LM7833 with 100uF capacitor
  • 1kOhm resistor
  • Some cables
  • In case of 5V flight controllers, logic level converter will be required between FC and ESP8266. Flip32 and Naze32 has 3.3V output on UART2, so it is not needed. Check flight controllers hardware documentation, if not sure, use multimeter to check the voltage on UARTs TX pin
  • EZ-GUI software. In case of different controllers different software have to be used. If you want to use a laptop instead of Android phone, virtual COM port has to be created. This highly depends on operating system and will not be covered here

Ready, steady, go

  1. Download and flash ESP8266-transparent-bridge using this tutorial. At the moment of writing this tutorial, command to flash it is python esptool.py -p {COM_PORT_GOES_HERE} write_flash 0x00000 0x00000.bin 0x40000 0x40000.bin. In case of Windows it will one of COMs (usually COM3-COM5). In case of Mac and Linux /dev/tty.* , for example /dev/tty.usbserial-A50285BI
  2. Power down, disconnect USB to serial converter, do not pull GPIO0 to GND any more (exit flash mode) and power WiFi up
  3. Connect to ESP8266 with a laptop or PC. There should be WiFi AP called ESP_xxxxx. By default, AP has IP address, PC will have
  4. Telnet into module with telnet or use Putty, or any different telnet software. It will take at least few seconds to establish working telnet connection, so be patient
  5. Now, we have to configure ESP8266 with AT commands. For example:
    1. +++AT AP DroneWiFi mypassword 2 set AP name and password
    2. +++AT BAUD 115200 set UART speed
  6. Build a 3.3V power supply for ESP8266 for your UAV. I’m using LM7833 voltage regulatorESP8266 Cleanflight WiFi bridge
  7. Connect ESP8266 to flight controller’s UART port (in this case UART2). Remember to check voltage. It has to be 3.3V of FC side. If it is 5V, use a logic level converter. My Flip32 has 3.3V on UART2, so I had no problems
  8. Open Cleanflight Configurator and enable MSP protocol of serial port you want to use. UART1, UART2 and UART3 (for F3 targets) can be used. SoftSerial ports will also work, but then speed has to be lowered to 19200 bps
  9. Power up flight controller and ESP8266. WiFi network you configured in step 5 should be visible. Connect to it with Android device
  10. Open EZ-GUI and in Settings choose:
    1. Connection type: WiFi
    2. Server address:
    3. Port: 23
      WiFi settings on EZ-GUI
  11. Save setting and hit Connect buttonEZ-GUI
  12. Congratulations, from now on you can access and configure your flight controller with a smartphone over WiFi networkEZ-GUI connected over WiFi


I have tested this setup last weekend, and honestly, I was disappointed. Yes, it works, yes, it is much faster than Bluetooth bridge, but:

  1. Range did not improved. ESP-01 has tiny PCB antenna and it just can not work well. Practical range was about 10m, more less the same that Bluetooth gives
  2. EZ-GUI was not stable in this mode
  3. Smartphone looses intenet connection, since WiFi it is connected to does not supply internet

6 thoughts to “WiFi telemetry for Cleanflight with EZ-GUI and ESP8266”

  1. This is a very cool tutorial! I’d be ok with losing smartphone internet, if we gained extra range and the UI was stable. I’ve got spare phones I could use this with!

    I’m very interested in reading if you find solutions to issue 1 and 2.

    1. There are esp8266 modules that have external antenna connectors. So that should help. I’m waiting for different hardware that should give range of few hundret meters

    2. But unfortunatelly if you lost connection internet on your smartphone , so you can’t see your map on the ez gui ground station. And off course esp8266 is useless for way point navigation. Is that correct dziku.?

  2. I tried this on my setup. I have it connect to my home WIFI AP, or make its own AP with the same name/pass, and also have my phone with an AP handy, same settings. I get pretty good range with it, and thinking of trying a u.fl version. All in all, wifi is pretty easy to extend.

  3. Man i tried a few times … dropped this f*** esp .. now buy new one because i dont have a capacitator now i have and i dont get telnet it .. not with putty not with telnet windows …

    IDK what to do … on other bridges and firmwares telnet work … whats my fail ?

Leave a Reply

Your email address will not be published.

This site uses Akismet to reduce spam. Learn how your comment data is processed.