ESP8266 painlessMesh Topology Visualizer in Python

A few months ago I have been experimenting with the ESP8266 painlessMesh network. The library provides a JSON string of the formed mesh topology, for example it looks like this:

        "nodeId" : 2147321731,
        "subs" : [
                "nodeId" : 2147319552,
                "subs" : [
        "nodeId" : 2142436483,
        "subs" : [
                "nodeId" : 2787708644,
                "subs" : [
        "nodeId" : 2142436495,
        "subs" : [
                "nodeId" : 2787708676,
                "subs" : [
                        "nodeId" : 2142436497,
                        "subs" : [
                        "nodeId" : 2787708620,
                        "subs" : [

At some points I think it would be very nice if I can immediately see how the mesh topology looks like. So I decide to write a simple GUI application that can visualize the mesh topology. For a rapid development I go for Python. I have not much prior experience in Python programming, and would like to use a nice and free IDE. I found one and really enjoyed using it. It is called PyCharm (v. 2017.2.3). It has editor, project viewer, debugger, runner, version control, etc. So it is quite a comprehensive IDE.

These videos demonstrate how the visualizer works:

Basically, the visualizer receives MeshTopology strings sent by a ESP8266 on serial port. The visualizer then parse the strings, build NetworkX graph, and draw the graph.  Graph drawing is based on the NetworkX (v.2.0) library. However, to make it work in this application, a little modification is made on the file networkx/drawing/ has a function called draw(). By default, draw() returns nothing. But to make it work in this application, I modify the draw() function to return cf (figure reference), node_collection.

return cf, node_collection

Higher version of NetworkX most likely will not work because the drawing function is discarded. NetworkX drawing functions depend on Qt5 library. So you need to install PyQt library as well.

Before running the codes, ensure the correct serial port number is provided matching to your setup. The line is in file, function setupUi(self, MainWindow):

# init and open serial port
# SET COMxx to the corresponding serial port number used by the ESP
comPortNum ='COM31'<span data-mce-type="bookmark" id="mce_SELREST_start" data-mce-style="overflow:hidden;line-height:0" style="overflow:hidden;line-height:0;">&#65279;</span>

As you can see from the videos above, some of the application features are:

  • Visualize mesh topology. The figure is updated whenever the topology has changed. The draw() function distributes the node position based on some sort of random statistical formula, which results in most likely different node position every time the graph is updated
  • A click on node ‘Me’ will pop up ‘broadcast’ dialog box. Through this dialog, we can set parameters all of nodes.
  • A click on nodes other than ‘Me’ will pop up ‘single’ dialog box. We can set and read parameters on that particular node

On the ESP8266 side, the library painlessMesh v.1.0.1 is used. The ESP8266 regularly sends the MeshTopology to serial port. It can interpret commands from the visualizer application, such as:

  • Reading the node available heap memory
  • Forwarding messages to a single node
  • Forwarding messages to all nodes
  • Set and read parameters (i.e. ‘timer’ and ‘brightness’)

The Python mesh visualizer source codes are available at:

The app is started from It then loads a window from The orchestrates all other functions, such as Serial thread, parsing MeshTopology, drawing graphs, etc.

And the Arduino ESP8266 painlessMesh codes can be found at:

The following video shows a demo  of 10-node ESP8266 painlessMesh network:


Programming ESP8266 using Visual Studio Code with Arduino Extension

So now I have used the official Arduino IDE for some time to program the ESP8266. It is a convenient and quick-to-get-started method (check here). But recently I plan to write an application that I feel it would be uncomfortable to write codes using the limited features of Arduino IDE. I find particularly two feature-rich IDEs out there, which are free and highly recommended by communities, namely Atom and Visual Studio Code. With Atom, we need to add the PlatformIO extension for programming embedded systems, including the ESP8266. While with VS Code, we need to install either PlatformIO or Arduino extension.

I had difficulties to get both Atom-PlatformIO and VS Code-PlatformIO working. Somehow the PlatformIO installation was not able to complete. I suspected it was caused by my office internet proxy. I spent quite some time to solve it but did not succeed, so I abandoned it and tried the Arduino extension.

Getting the VS Code with Arduino extension working was not that straight forward either. If you search for the Arduino extension, you will find two choices, either developed by Microsoft or Steve Yin. Initially I chose the one developed by Microsoft. Well, Arduino extension is just an extension that allows users to tell the VS Code where the tools for compiling and uploading code reside. So we must have the official Arduino IDE installed because its tools for compiling and uploading will be used by the VS Code. Then we need to specify the Arduino IDE path in the VS Code ‘User Settings’. Btw, my OS was Windows 8, and I installed the official Arduino IDE version 1.8.2. For unknown reasons compiling sketch using VS Code was always fail with a message saying ‘[Error] Exit with code=undefined’. Actually, I also had an Ubuntu machine, and I managed to get the Arduino extension working. I could compile and upload codes to the ESP8266. But for some reasons, I still preferred to work on my Windows 8 machine.

So, then I gave the Steve Yin’s Arduino extension a try on my Win 8. The compile and upload options in User Settings were more complicated than those of Microsoft one.  But happily I succeeded to compile and write bits of codes to the ESP8266 flash memory. The easiest way to specify the compile and upload options is by adapting them from the command list spat out from the Arduino IDE console output. Again, you can follow this instruction to program ESP8266 using Arduino IDE.

arduino ide compile - for vs code arduino ext

Here is my VS Code ‘User Settings’:

"arduino.uploader" : "C:\\Users\\User-pc\\AppData\\Local\\Arduino15\\packages\\esp8266\\tools\\esptool\\0.4.9\\esptool.exe",
"arduino.uploadOptions": "-vv -cd nodemcu -cb 921600 -cp COM12 -ca 0x00000 -cf $TARGET.bin",
"arduino.compileOptions": "-compile -logger=machine -hardware D:/Master/arduino-1.8.2/hardware -hardware C:/Users/User-pc/AppData/Local/Arduino15/packages -tools D:/Master/arduino-1.8.2/tools-builder -tools D:/Master/arduino-1.8.2/hardware/tools/avr -tools C:/Users/User-pc/AppData/Local/Arduino15/packages -built-in-libraries D:/Master/arduino-1.8.2/libraries -libraries C:/Users/User-pc/Documents/Arduino/libraries -fqbn=esp8266:esp8266:nodemcuv2:CpuFrequency=80,UploadSpeed=115200,FlashSize=4M3M -vid-pid=0X2341_0X0043 -ide-version=10802 -warnings=none -prefs=build.warn_data_percentage=75 -verbose",
In the “arduino.compileOptions” I omitted the built-path and built-cache options since they caused compiling to fail. The Arduino extension had its own built-cache which worked fine. I had not looked further for the meaning of the other options. They might be fine to be deleted. However they seems didn’t do any harm, by now I just leave it there.
In the “arduino.uploadOptions” we could set the COM port and upload speed. By default, the upload speed is 115200, which was quite slow. I found it somewhere that says we can increase the speed by a factor of 8, so it becomes 921600. It was indeed much faster. But the reference I read also says that this high speed can sometimes be unstable. So, bear this in mind. I did try other higher baud rates: 1500000, 1843200, 2000000. However the uploading time took longer than that of 921600.
vs code arduino ext compile
Initially I thought installing these tools for programming ESP8266 would be just some clicks away. But in fact I had spent a lot of time to get it done properly. I hope you have a nice and smooth installation. In case you face the same problem, hope my experience would help.
Happy coding!

Pengalaman menggunakan Modul WiFi NodeMcu ESP8266

Ceritanya saya mau membuat sebuah prototipe lampu yang bisa dikendalikan secara wireless menggunakan handphone atau laptop. Rencananya akan ada kurang lebih 10 titik/node lampu. Masing-masing node berjarak +/- 20 meter sehingga membentuk garis lurus sepanjang 200 meter. Antar node tidak ada line of sight karena ada halangan berupa logam. Teknologi wireless yang digunakan haruslah secure, setidaknya mendukung otentikasi password. Dan yang paling penting, saya ingin membentuk jaringan wireless tersebut dalam topologi mesh network, yaitu tiap node berfungsi sebagai repeater yang meneruskan data ke node tetangga terdekatnya. Kenapa tidak gunakan saja sebuah transmitter daya besar yang bisa mennjangkau hingga node terjauh (200 meter)? Tidak, karena ada batasan daya transmisi yang diizinkan regulasi, dan hampir pasti (belum menemukan referensi) jangkauan sejauh itu membutuhkan daya yang melebihi limit, atau membutuhkan izin khusus.

Beberapa solusi wireless saya coba bandingkan, yaitu Zigbee, Bluetooh Low Energy (BLE) dan Bluetooh. Dari segi jangkauan, Zigbee memang mumpuni. Tapi dari kunjungan ke toko-toko online saya dapati bahwa modul Zigbee sangat mahal dan tidak banyak tersedia. Sedangkan, modul BLE dan Bluetooth jauh lebih murah harganya dan lebih mudah didapatkan. Tapi kemampuan jangkauannya di ambang batas spesifikasi yang saya tentukan di awal. Beberapa sumber mengatakan jangkauan Bluetooth hanya 10 meter, sedangkan sumber lainnya menyebutkan jarak 20 m bukanlah masalah. Memang soal jangkauan sangat tergantung dari kondisi lingkungan, apakah banyak halangan atau tidak, apakah halangan nya berupa logam, tembok beton, dsb. Dan memang dalam datasheet modul wireless kita biasanya tidak menemukan pernyataan bahwa jangkauan nya adalah sekian meter *. Parameter terukur yang bisa didapatkan dalam datasheet di antaranya adalah daya transmisi dan sensitivitas receiver. Salah satu pilihan saya awalnya jatuh pada modul Bluetooth nRF51. Modul ini memiliki daya transmisi 4 dBm. Untuk mengetahui apakah modul tersebut bisa menjangkau 20 meter, saya putuskan untuk mencobanya. Namun sesaat sebelum saya memesan modul ini di toko online, saya sempat chatting dengan Bondan Suwandi. Singkat cerita dia menyarankan untuk menggunakan modul WiFi ESP8266.

Tidak perlu waktu lama untuk googling, ternyata modul ESP8266 ini begitu menawan dan langsung mengubah keputusan saya :). Kenapa? Karena modul WiFi ini ternyata lebih murah daripada Bluetooth. Selain itu daya transmisi nya bisa mencapai 20 dBm (kalau tidak salah ini batas maksimal yang diizinkan regulasi di Indonesia), bandingkan dengan modul Bluetooth nRF51 yang hanya 4 dBm. Di Youtube, ada yang pernah mencoba jarak jangkauan ESP8266 ini di area terbuka dengan adanya line of sight. Hasilnya mengejutkan, bisa mencapai 500-1000 meter. Karena modul WiFi beroperasi pada frekuensi UHF 2.4 Ghz, tentu saja jika dalam ruangan yang dibatasi tembok atau terlindung logam, jangkauan nya akan menurun jauh. Selain itu, saya mendapati bahwa komunitas pengguna ESP8266 ini cukup banyak dan akif. Dan ternyata ada yang sudah mengimplementasikan mesh network di ESP8266. Persis seperti yang saya inginkan. Saya coba rangkumkan fitur-fitur ESP8266 yang tertulis dalam datasheet nya di sini:

  • Mendukung protocol WiFi IEEE 802.11 b/g/n, dengan otentikasi password WPA/WPA2
  • Terintegrasi low power 32-bit MCU (Tensilica)
  • Terintegrasi 10-bit ADC
  • Terintegrasi TCP/IP protocol stack
  • Terintegrasi TR switch, balun, LNA, power amplifier and matching network
  • Terintegrasi PLL, regulators, and power management units
  • SDIO 2.0, (H) SPI, UART, I2C, I2S, IR Remote Control, PWM, GPIO
  • Deep sleep power <10uA, Power down leakage current < 5uA
  • Konsumsi daya standby < 1.0mW
  • Daya transmisi +20 dBm dalam mode 802.11b
  • Mendukung mode Station (STA), Access Point (AP), dan STA+AP
  • Tersertifikasi FCC, CE, TELEC, WiFi Alliance, dan SRRC

block diagram ESP8266

ESP8266 mendukung mode STA+AP, yaitu berfungsi sebagai Station dan Access Point sekaligus. Fitur ini memungkinkan ESP8266 diprogram membentuk mesh network. Sebuah node bisa berfungsi sebagai Station yang terkoneksi ke node Access Point, dan sekaligus berfungsi sebagai Access Point bagi node Station lainnya. Namun perlu diperhatikan bahwa mode STA dan AP menggunakan jalur hardware yang sama sehingga ada beberapa kasus yang bisa membuat koneksi menjadi putus, seperti yang dijelaskan di sini:

Kasus 1:

  1. Station ESP8266 terkoneksi ke sebuah router (misalnya channel 6)
  2. Kemudian setting parameter AP ESP8266 melalui fungsi wifi_softap_set_config(), misalnya set ke channel 3
  3. Fungsi tersebut mungkin akan return true, tapi sebenarnya channel tetap di 6, karena hanya ada satu jalur hardware yang sudah diset di langkah 1

Kasus 2:

  1. Setting channel AP ESP8266 x, misal channel 5, melalui fungsi wifi_softap_set_config()
  2. Kemudian ada beberapa Station yang terkoneksi ke AP ESP8266 x tersebut
  3. Kemudian Station ESP8266 x mencoba melakukan koneksi ke router yang memiliki channel yang berbeda (misal channel 6)
  4. AP ESP8266 x harus mengubah channel nya menjadi sama dengan Station ESP8266 x, yaitu channel 6
  5. Akibatnya station-station yang terkoneksi ke AP ESP8266 x pada langkah 2 akan disconnected karena telah terjadi perubahan channel

Kasus 3:

  1. Beberapa station terkoneksi ke AP ESP8266 x
  2. Jika kemudian Station ESP8266 x mencoba melakukan scanning channel untuk mencari router,  station-station yang terkoneksi pada langkah 1 mungkin akan disconnected. Sebabnya, Station ESP8266 x yang terus mengubah channel mengakibatkan channel AP ESP8266 x ikut berubah.


Ada banyak varian modul ESP8266 yang beredar saat ini, yaitu:

  • Tanpa USB to serial converter: ESP01, ESP02, hingga ESP14 (lebih detail lihat di sini)
  • Dengan USB to serial converter: NodeMCU, ESPToy


Sumber Gambar: sini.

Saya sudah mencoba ESP01 dan NodeMCU. Untuk memprogram ESP01 dari port USB kita perlu menambahkan USB to Serial converter. Kita bisa gunakan FTDI, CH340, atau board Arduino Uno. Tapi entah kenapa modul ESP-01 ini susah sekali diprogram, sering kali gagal nge-flash. Padahal saya sudah coba beberapa saran seperti menambahkan resistor pada pin-pin tertentu (lupa persisnya) dan menggunakan power supply external yang mampu supply arus hingga 1 ampere. Tetap saja, flashing-nya sering gagal. Adakah yang punya pengalaman yang sama? Bagaimana cara mengatasinya?

Modul NodeMCU merupakan modul ESP-12 yang sudah dilengkapi dengaan CH340 USB to Serial Converter. Pengalaman saya menggunakan modul NodeMcu berjalan mulus, tidak ada masalah dalam flashing. Ada beberapa cara untuk menggunakan ESP8266, yaitu:

  1. Lua. Merupakan bahasa scripting yang kecil dan ringan untuk aplikasi embedded systems. Tentu saja untuk menggunakan Lua, ESP8266 harus diprogram firmware interpreter Lua. Panduannya bisa dilihat di sini. Metode ini cukup mudah digunakan.
  2. AT command. Untuk menggunakan AT command, install firmware AT command seperti dalam tutorial ini. Metode ini juga mudah digunakan. Namun tidak semua kemampuan ESP8266 bisa dieksplor
  3. C++ dengan Arduino IDE. Metode ini menggunakan Arduino IDE yang sudah cukup familiar bagi pegiat elektronika. Yang perlu dilakukan adalah mengunduh library ESP8266, seperti dalam panduan ini. Ada cukup banyak contoh-contoh aplikasi yang disertakan dalam library tersebut. Metode ini memiliki tingkat kesulitan lebih tinggi daripada AT command, tapi kita punya kebebasan untuk customize operasi dan fungsi ESP8266. Dan metode ini yang saya gunakan untuk membuat prototipe kendali lampu secara wireless dalam mesh network.
  4. SDK ESP8266. Metode ini memiliki tingkat kesulitan paling tinggi, tapi kita punya kebebasan seluas-luasnya untuk memprogram ESP8266. Salah satu panduan untuk memulai menggunakan SDK ESP8266 bisa dilihat di sini.
  5. PlatformIO. Ini juga menggunakan bahasa C dan library seperti pada Arduino IDE, namun dengan IDE (editor, code completion, library management) yang lebih baik. Saya sedang mencoba install tool ini.


Awalnya saya coba implementasi mesh network menggunakan library easyMesh. Saya mulai dengan contoh program examples/demoToy. Program ini memasang easyMesh, webserver dan websocket dalam ESP8266 sedemikian hingga tiap node akan langsung gabung dalam mesh network yang terjangkau. Selain itu, websocket memungkinkan laptop atau HP kita sebagai Station yang terkoneksi ke AP ESP8266, dan melakukan komunikasi secara kontinyu.  Namun dari pengalaman saya koneksi ke AP ESP8266 tidak handal dan sering kali disconnect. Penyebabnya mungkin karena implementasi easyMesh yang secara rutin melakukan scanning mencari network, sehingga koneksi yang sudah ada menjadi terputus. Library easyMesh ini juga sudah cukup lama tidak ada update, terakhir update 25 Agustus 2016.

Kemudian saya menemukan library painlessMesh yang dibangun berdasarkan easyMesh, namun telah mengalami perbaikan-perbaikan. Jadi saya coba pakai library painlessMesh, webserver, dan websocket ke modul ESP8266. Hasilnya adalah seperti dalam video demo di bawah ini **. Sekedar informasi tidak penting, lampu yang saya gunakan tersebut adalah lampu depan motor saya yang sudah rusak salah satu filamen nya. Dalam sebuah lampu depan motor itu ternyata ada dua filamen, satu untuk menerangi jauh ke depan, dan satu lagi menerangi jarak dekat. Begitu juga dengan lampu belakang, satu filamen untuk lampu malam dan satu filamen lainnya untuk rem. Saya baru tahu ini waktu mengganti lampu motor saya :). Kembali ke video, rangkaian dalam demo ini sangat sederhana. Lampu tersebut di drive  menggunakan transistor NPN Darlington TIP122, dan diberi supply 12 volt. Output PWM dari pin D1 ESP8266 yang berfungsi mengatur tingkat kecerahan lampu dihubungkan seri dengan resistor 10 kOhm dan kaki basis TIP122. Modul NodeMcu tersebut digunakan secara standalone, yaitu berfungsi menghandle protokol WiFi dan sekaligus berinteraksi dengan dunia luar (dalam hal ini mengendalikan lampu) melalui pin input/output nya. Jadi kita tidak perlu menggunakan mikrokontroler tambahan.

Dari hasil observasi, dapat saya laporkan bahwa koneksi websocket antara laptop ke node ESP8266 kadang-kadang mengalami gangguan dan terputus. Masih perlu ditelusuri lagi apa penyebabnya. Sedangkan koneksi antar node terlihat lebih reliable, dengan sesekali mengalami disonnected. Namun tidak sesering saat menggunakan library easyMesh.

Dalam demo ini hanya digunakan dua buah node. Tugas ke depannya adalah mencoba menambahkan lebih banyak node lagi, dan mengevaluasi seberapa reliable koneksi nya dan  seberapa jauh jangkauan mesh network ini.

Bagi yang membutuhkan modul WiFi NodeMcu ESP8266, bisa ke sini:


*: Tanggal 12 September 2017 lalu saya mengikuti seminar Microchip / Atmel. Di situ saya baru tahu tentang teknologi LoRa, yang memiliki ciri long range, low data rate, dan low energy. Teknologi LoRa mengklaim bisa menjangkau hingga jarak 15 km dengan adanya line of sight. Saya tidak  tahu seperti apa performa nya dalam lingkungan indoor.