{"id":1953,"date":"2020-02-02T11:13:57","date_gmt":"2020-02-02T03:13:57","guid":{"rendered":"https:\/\/www.techcoil.com\/blog\/?p=1953"},"modified":"2020-05-12T14:14:45","modified_gmt":"2020-05-12T06:14:45","slug":"how-to-setup-micropython-webrepl-on-your-esp32-development-board","status":"publish","type":"post","link":"https:\/\/www.techcoil.com\/blog\/how-to-setup-micropython-webrepl-on-your-esp32-development-board\/","title":{"rendered":"How to setup MicroPython WebREPL on your ESP32 development board"},"content":{"rendered":"

When I wrote about setting up MicroPython on an ESP development board<\/a>, I came across the WebREPL<\/a>. <\/p>\n

If you setup MicroPython WebREPL on your ESP32 board, then you can interact with your ESP32 board wirelessly.<\/p>\n

In case you need it, this is how to setup MicroPython WebREPL on your ESP32 development board.<\/p>\n

Components of MicroPython WebREPL<\/h2>\n

Before setting up MicroPython WebREPL on our ESP32 development board, let's look at the components of MicroPython WebREPL. <\/p>\n

All in all, there is the server component<\/strong> on our ESP32 board that interacts with the hardware. When activated, this server component listens for commands coming from WebREPL clients<\/strong> through WebSocket. <\/p>\n

For example, we can use the MicroPython WebREPL client<\/a> from a computer that is connected to the same network as our ESP32 board and interact with it.
\n\"MicroPython<\/p>\n

Since the client is a web page loaded on a browser, we only need to setup the WebREPL server on our ESP32 board.<\/p>\n

Setting up MicroPython WebREPL server on our ESP32 development board<\/h2>\n

First, setup MicroPython on your ESP32 development board<\/a> if you have not done so.<\/p>\n

Once you have done so, you will be able to access MicroPython REPL over serial with a terminal emulator program. For example, you can use the following command to access MicroPython REPL over serial on macOS:<\/p>\n

\r\nscreen -port \/dev\/tty.SLAB_USBtoUART 115200\r\n<\/pre>\n
At this point in time, you will be able to enable WebREPL on your ESP32 board. In order to do so, enter the following Python codes into the REPL prompt:<\/p>\n
 \r\nimport webrepl_setup\r\n<\/pre>\n
Once you have done so, follow the instructions to enable WebREPL on your ESP32 board:
\n\"MicroPython<\/p>\n
When your ESP32 board rebooted successfully, you will find webrepl_cfg.py<\/strong> with content similar to the following:<\/p>\n
\r\nPASS = 'abcd1234'\r\n<\/pre>\n
In addition to that, boot.py<\/strong> now contains the following codes:<\/p>\n
\r\n# This file is executed on every boot (including wake-boot from deepsleep)\r\n#import esp\r\n#esp.osdebug(None)\r\nimport webrepl\r\nwebrepl.start()\r\n<\/pre>\n
Given that, whenever your ESP32 board starts MicroPython, it will start WebREPL as well.<\/p>\n
However, since there is no network connection between your computer and the ESP32 board, you cannot connect to your WebREPL server yet.<\/p>\n
Connecting your ESP32 board to your router network<\/h2>\n
Therefore, you need to connect your ESP32 board to your router's 2.4GHz network<\/strong>. Given that, terminate your terminal emulator program session. If you are using screen<\/code>, then you will press Ctrl-A+K<\/strong>.<\/p>\n
Once the serial connection is released, use rshell<\/code> to connect to your ESP32 board via serial connection:<\/p>\n
\r\nrshell -p \/dev\/tty.SLAB_USBtoUART -b 115200 --editor nano\r\n<\/pre>\n
When you do so, you will be able to edit files on the ESP32 board with the nano<\/code> editor.<\/p>\n
Once rshell starts, run the following command to edit boot.py<\/code> on your ESP32 board:<\/p>\n
\r\nedit \/pyboard\/boot.py\r\n<\/pre>\n
When your nano editor loads boot.py<\/code>, edit it to look like the following:<\/p>\n
\r\ndef do_connect(ssid, pwd):\r\n    import network\r\n    sta_if = network.WLAN(network.STA_IF)\r\n    if not sta_if.isconnected():\r\n        print('connecting to network...')\r\n        sta_if.active(True)\r\n        sta_if.connect(ssid, pwd)\r\n        while not sta_if.isconnected():\r\n            pass\r\n    print('network config:', sta_if.ifconfig())\r\n\r\n# This file is executed on every boot (including wake-boot from deepsleep)\r\n#import esp\r\n#esp.osdebug(None)\r\n\r\n# Attempt to connect to WiFi network\r\ndo_connect('your_ssid', 'your_password')\r\n\r\nimport webrepl\r\nwebrepl.start()\r\n<\/pre>\n
Change your_ssid<\/strong> and your_password<\/strong> to the credentials (SSID, WiFi password) for your 2.4GHz WiFi network. When you are done with the changes, press Ctl-X<\/strong>, Y<\/strong> and Enter<\/strong> to save the changes.<\/p>\n
After you have edited boot.py<\/strong>, enter into MicroPython REPL:<\/p>\n
\r\nrepl\r\n<\/pre>\n
Once Python REPL loads, press Ctrl-D<\/strong> to restart your ESP32 board. When your ESP32 development board had restarted, you should find some output similar to the following:<\/p>\n
\r\nMPY: soft reboot\r\nnetwork config: ('192.168.1.131', '255.255.255.0', '192.168.1.1', '192.168.1.1')\r\nWebREPL daemon started on ws:\/\/192.168.1.131:8266\r\nStarted webrepl in normal mode\r\nMicroPython v1.12-68-g3032ae115 on 2020-01-15; ESP32 module with ESP32\r\nType "help()" for more information.\r\n<\/pre>\n
In this case, I will use ws:\/\/192.168.1.131:8266<\/strong> to connect to my ESP32 development board. If your ESP32 development board had connected to your WiFi network successfully, then you should get the URL to connect to your board. <\/p>\n
Using the MicroPython WebREPL client to interact with your ESP32 development board<\/h2>\n
At this point in time, you can interact with your ESP32 development board with the MicroPython WebREPL client<\/a>. Given that, access MicroPython WebREPL client<\/a> from a browser within the same network as your ESP32 development board. When the MicroPython WebREPL client loads on your browser, enter the web socket URL into the text field on the top left corner:
\n\"MicroPython<\/p>\n
After you click Connect<\/strong>, you will be prompted to enter the password (for eg: abcd1234) that you had configured earlier. When you have done so, you can interact with the WebREPL server on your ESP32 board.
\n\"Connecting<\/p>\n
In addition to entering Python commands, you can also send files and get files with the controls on the right.<\/p>\n\n