Mongoose: More Than An Embedded Web Server

DZone 's Guide to

Mongoose: More Than An Embedded Web Server

Mongoose is a surprisingly small, easy to embed, and powerful open source server project. Now with the rise of IoT nearly everything wants to be a server. And why not, it's easy!

· IoT Zone ·
Free Resource

ESP8266 is all the rage these days. A very affordable single chip WiFi solution, with a fairly capable CPU core on board. It came onto the scene in 2014 and made a pretty big splash, especially in DIY circles. It is one of the primary platforms supported by Smart.js, our IoT solution, but what if you want just Mongoose Embedded Web Server? The answer is — of course. We prepared a simple example to help you get off the ground quickly. We’ll show you how to use Mongoose to create a simple webserver running on ESP8266.

First, a quick refresher on setting up ESP8266 build environment. This is not specific to Mongoose, feel free to skip if you have everything ready.

You will need:

  • One of the ESP8266 modules (we presume you already have that)
  • A Linux machine running Ubuntu (a VM will do)
  • The RTOS-based SDK — clone this repo
  • GCC compiler toolchain

Once you have the toolchain installed (xtensa-lx106-elf-gcc and make commands should work), clone the latest Mongoose repository and go to the examples/ESP8266_RTOS subdirectory.

Once there, and assuming the toolchain has been installed correctly, you should be able to build it with the following commands:

$ export SDK_PATH=/opt/ESP8266_RTOS_SDK  # change this to your SDK location$ export BIN_PATH=./bin; mkdir ./bin$ make clean; make BOOT=none APP=0 SPI_SPEED=40 SPI_MODE=qio SPI_SIZE_MAP=0[...]!!!SDK_PATH:/cesanta/ESP8266_RTOS_SDKBIN_PATH: ./binNo boot needed. Generate eagle.flash.bin and eagle.irom0text.bin successully in BIN_PATHeagle.flash.bin-------->0x00000eagle.irom0text.bin---->0x20000!!!

With firmware built, it is now ready for flashing. We recommend you use esptool for this, but any other flashing tool will do. For esptool, the command line will look like this:

$ esptool.py --port /dev/ttyUSB0 --baud 230400 \    write_flash --flash_mode=qio --flash_size=4m \    0x00000 ${BIN_PATH}/eagle.flash.bin \    0x20000 ${BIN_PATH}/eagle.irom0text.bin \    0x7e000 ${SDK_PATH}/bin/esp_init_data_default.binConnecting...Erasing flash...Took 0.58s to erase flash blockWrote 35840 bytes at 0x00000000 in 1.8 seconds (157.5 kbit/s)...Erasing flash...Took 2.02s to erase flash blockWrote 301056 bytes at 0x00020000 in 15.4 seconds (156.7 kbit/s)...Erasing flash...Took 0.11s to erase flash blockWrote 1024 bytes at 0x0007e000 in 0.1 seconds (163.5 kbit/s)...Leaving...

After this, you should see a “Mongoose” WiFi network appear - example sets up an AP. Use password “Mongoose” to connect and navigate to, you should see a “Hello, world” greeting page — served by the event handler defined in user_main.c.

And that is all for today. This example only demonstrates a web server, but you have all the power of the Mongoose multi-protocol networking library at your disposal (except file serving, because ESP does not have a filesystem by default).

Happy hacking!

embedded development, mongoose, server

Published at DZone with permission of Deomid Ryabkov , DZone MVB. See the original article here.

Opinions expressed by DZone contributors are their own.

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}