mongoose/README.md

3.8 KiB

Mongoose - Embedded Web Server / Embedded Networking Library

License: GPLv2 Build Status Code Coverage

Mongoose is a networking library for C/C++. It implements event-driven non-blocking APIs for TCP, UDP, HTTP, WebSocket, MQTT. It has been designed for connecting devices and bringing them online. On the market since 2004, used by vast number of open source and commercial products - it even runs on the International Space Station! Mongoose makes embedded network programming fast, robust, and easy.

Connectivity is vital for software and embedded devices, but there are many pitfalls to consider when embedding a web server. This white paper breaks down on the top 9 things to avoid when embedding a web server.

Looking for a complete IoT solution? Check out

  • VCON - Arduino compatible MCU modules with built-in firmware OTA updates
  • Mongoose OS - open source embedded operating system for low-power connected microcontrollers. Secure, designed for commercial Internet of Things products

Support

Features

  • Cross-platform: works on Linux/UNIX, MacOS, QNX, eCos, Windows, Android, iPhone, FreeRTOS, etc
  • Supported hardware platforms: TI CC3200, TI MSP432, NRF52, STM32, PIC32, ESP8266, ESP32 and more
  • Builtin protocols:
    • plain TCP, plain UDP, SSL/TLS (over TCP, one-way or two-way)
    • HTTP client, HTTP server
    • WebSocket client, WebSocket server
    • MQTT client
    • DNS client, async DNS resolver
  • Single-threaded, asynchronous, non-blocking core with simple event-based API
  • Native support for LWIP embedded TCP/IP stack
  • Tiny static and run-time footprint
  • Source code is both ISO C and ISO C++ compliant
  • Very easy to integrate: just copy mongoose.c and mongoose.h files to your build tree

Licensing

Mongoose is released under Commercial and GNU GPL v.2 open source licenses.

Commercial Projects: Contact us for commercial license.

Dashboard Example

Mongoose is often used to implement device dashboards and real-time data exchange over Websocket. Here is a dashboard example that illustrates the functionality:

Developing a new product? Contact us today to discuss how Mongoose can help.

Contributions

Contributions are welcome! Please follow the guidelines below:

  • Sign Cesanta CLA and send GitHub pull request
  • When making pull requests, please make sure that it has only one commit, and imlements/fixes only one piece of functionality

Looking for a pre-compiled Mongoose web server Windows or Mac binary?