This is a pure transparent bridge between Wifi and serial using any ESP8266 device. It's very useful for debugging or talking to remote serial device that have no network connection.
I'm using it on WeMos target, you can find more information on WeMos on their site, it's really well documented. I now use WeMos boards instead of NodeMCU's one because they're just smaller, features remains the same, but I also suspect WeMos regulator far better quality than the one used on NodeMCU that are just fake of originals AMS117 3V3.
This project is mainly based on excellent @me-no-dev ESPAsyncWebServer library and great JQuery Terminal done by Jakub Jankiewicz.
Once uploaded SPIFFS data (web page) you can connect with a browser to http://ip_of_esp8266 and start playing with it.
The main index.htm
web page include a full javascript terminal so you can type command and receive response.
The main web page can also be hosted anywhere and it's not mandatory to have it on the device (except if device and your computer have no access on Internet). I've published the fully fonctionnal WEB page from github so you can access it from here and then connect to your device on wich you flashed the firmware.
Some commands will be interpreted by the target (ESP8266) and not passed to serial, so you can interact with ESP8266 doing some variable stuff.
You need to have nodejs and some dependencies installed.
webdev folder is the development folder to test and validate web pages. It's used to avoid flashing the device on each modification.
All source files are located in this folder the ESP8266 data
folder (containing web pages) is filled by a nodejs script launched from webdev folder. This repo contain in data lasted files so if you don't change any file, you can upload to SPIFFS as is.
To test web pages, go to a command line, go into webdev folder and issue a:
node web_server.js
then connect your browser to htpp://localhost:8080 you can them modidy and test source files such index.htm
Once all is okay issue a:
node create_spiffs.js
this will gzip file and put them into data folder, after that you can upload from Arduino IDE to device SPIFFS
See comments in both create_spiffs.js and web_server.js files, it's also indicated dependencies needed by nodejs.
- connect : connect do target device
- help : show help
!close
or CTRL-D : close connectionswap
swap ESP8266 UART pin between GPIO1/GPIO3 with GPIO15/GPIO13ping
typing ping on terminal and ESP8266 will send back pong?
orhelp
show helpheap
show ESP8266 free RAMwhoami
show WebSocket client # we arewho
show all WebSocket clients connectedfw
show firmware date/timebaud n
set ESP8266 serial baud rate to n (to be compatble with device driven)reset p
reset gpio pin number pls
list SPIFFS filesread file
execute SPIFFS file command
Every command in file startup.ini
are executed in setup() you can chain with other files.
I'm using this sketch to drive Microchip RN2483 Lora module to test LoraWan, see the boards I used.
For example my startup.ini
file contains command to read microchip RN2483 config file named rn2483.txt
startup.ini
# Startup config file executed once in setup()
# commands prefixed by ! are executed by ESP
# all others passed to serial module
# Chain with Microchip Lora rn2483 configuration
!read /rn2483.txt
rn2483 configuration file for my WeMos shield rn2483.txt
# Startup config file for Microchip RN2483
# commands prefixed by ! are executed by ESP all others passed to serial module
# !delay is not executed when connected via browser web terminal (websocket)
# See schematics here https://github.com/hallard/WeMos-RN2483
# Set ESP Module serial speed (RN2483 is 57600)
!baud 57600
!delay 100
# reset RN2483 module (reset pin connected to ESP GPIO15)
!reset 15
!delay 1000
# Light on the LED on GPIO0
sys set pindig GPIO0 1
!delay 250
# Light on the LED on GPIO10
sys set pindig GPIO10 1
!delay 250
By the way I integrated the excellent @me-no-dev SPIFFS Web editor so you can direct edit configuration files of SPIFFS going to
http://ESP_IP/edit
Your computer need to be connected to Internet (so may be your ESP8266 device) and authenticated for this feature, default login/pass are in the sketch (admin/admin)
See all in action
http://cdn.rawgit.com/hallard/WebSocketToSerial/master/webdev/index.htm
- More configuration features
- Configuration file for SSID/PASSWORD and login/pass for http admin access
- Arduino ESP8266
- @me-no-dev ESPAsyncWebServer library
- @me-no-dev ESPAsyncTCP library
- nodejs for web pages development test
See news and other projects on my blog