Skip to content

Latest commit

 

History

History
34 lines (29 loc) · 1.36 KB

README.md

File metadata and controls

34 lines (29 loc) · 1.36 KB

Small HTTP server for NodeMCU

This small webserver supports the following HTTP verbs/methods:

  • GET returns the contents of a file in flash
  • PUT creates a new file in flash
  • DELETE remove the file from flash
  • POST executes the given lua script (may return a function that receives the payload)
  • OPTIONS returns minimal CORS headers allowing POST from any origin

Installation

Clone the project and edit the Wi-Fi settings in init.lua. You can use the shell script up or execute the following:

$ python nodemcu-uploader/nodemcu-uploader.py upload init.lua httpserver.lua

This assumes you've cloned the nodemcu-uploader project (use --recursive) as well, which is added as a submodule:

$ git submodule init
$ git submodule update

After uploading, connect the serial console (screen /dev/ttyUSB0 9600 under most *nix flavors) and reboot the device. The device will print its IP address in the console.

Usage

Once those files have been uploaded you can manage your device with curl, for example to PUT new files on flash:

curl --upload-file example.lua http://serial.console.shows.ip/

To reboot your device (for example after uploading a new init.lua or httpserver.lua) use curl to POST anything to /:

curl --data anything http://serial.console.shows.ip/

TODO

  • Need a way to return flash contents/listing vs. index.html