2016-06-28 23:53:10 +08:00
|
|
|
# Mongoose - Embedded Web Server / Embedded Networking Library
|
2012-08-26 05:48:14 +08:00
|
|
|
|
2015-09-08 19:49:03 +08:00
|
|
|
![](https://img.shields.io/badge/license-GPL_2-green.svg "License")
|
2014-04-10 01:10:49 +08:00
|
|
|
|
2015-12-21 19:13:48 +08:00
|
|
|
Mongoose is ideal for embedded environments. It has been designed
|
2016-04-12 23:06:29 +08:00
|
|
|
for connecting devices and bringing them online. On the market since 2004,
|
|
|
|
used by vast number of open source and
|
2016-10-19 22:33:08 +08:00
|
|
|
commercial products - it even runs on the International Space station!
|
2016-04-12 23:06:29 +08:00
|
|
|
Mongoose makes embedded network programming fast, robust, and easy.
|
2014-04-10 01:10:49 +08:00
|
|
|
|
2016-10-19 22:33:08 +08:00
|
|
|
- [Download Mongoose Source Code here](https://www.cesanta.com)
|
2015-08-20 15:56:14 +08:00
|
|
|
|
2016-10-19 22:33:08 +08:00
|
|
|
Looking for a complete IoT solution with firmware and cloud components?
|
|
|
|
Check out [Mongoose IoT Firmware and Cloud](https://mongoose-iot.com).
|
2016-10-18 19:35:47 +08:00
|
|
|
|
|
|
|
# Support
|
2016-10-19 22:33:08 +08:00
|
|
|
- [Study mongoose example code](https://github.com/cesanta/mongoose/tree/master/examples)
|
|
|
|
- [Read User Guide and API reference](https://docs.cesanta.com/mongoose)
|
|
|
|
- [Support Forum - ask your technical questions here] (http://forum.cesanta.com/index.php?p=/categories/mongoose)
|
|
|
|
- [Chat - visit www.cesanta.com for our live chat] (http://www.cesanta.com)
|
|
|
|
- [Commercial licensing and support available] (https://www.cesanta.com/services-support)
|
|
|
|
- [Check our latest releases] (https://github.com/cesanta/mongoose/releases)
|
2013-01-02 07:05:09 +08:00
|
|
|
|
2015-09-08 19:49:03 +08:00
|
|
|
# Features
|
|
|
|
|
2015-12-22 15:46:05 +08:00
|
|
|
* Cross-platform: works on Linux/UNIX, MacOS, QNX, eCos, Windows, Android,
|
2015-12-22 15:40:55 +08:00
|
|
|
iPhone, FreeRTOS (TI CC3200, ESP8266), etc
|
2016-10-19 22:33:08 +08:00
|
|
|
* Supported hardware platforms: TI CC3200, TI MSP432, NRF52, STM32, PIC32, ESP8266, ESP32 and more
|
2015-09-08 19:49:03 +08:00
|
|
|
* Builtin protocols:
|
|
|
|
- plain TCP, plain UDP, SSL/TLS (over TCP, one-way or two-way)
|
|
|
|
- HTTP client, HTTP server
|
2016-03-04 23:08:19 +08:00
|
|
|
- WebSocket client, WebSocket server
|
2015-09-08 19:49:03 +08:00
|
|
|
- MQTT client, MQTT broker
|
|
|
|
- CoAP client, CoAP server
|
|
|
|
- DNS client, DNS server, async DNS resolver
|
2016-10-19 22:33:08 +08:00
|
|
|
* Single-threaded, asynchronous, non-blocking core with simple event-based API
|
|
|
|
* Native support for [PicoTCP embedded TCP/IP stack](http://www.picotcp.com),
|
|
|
|
[LWIP embedded TCP/IP stack](https://en.wikipedia.org/wiki/LwIP)
|
2015-09-08 19:49:03 +08:00
|
|
|
* Tiny static and run-time footprint
|
|
|
|
* Source code is both ISO C and ISO C++ compliant
|
|
|
|
* Very easy to integrate: just copy
|
|
|
|
[mongoose.c](https://raw.githubusercontent.com/cesanta/mongoose/master/mongoose.c) and
|
|
|
|
[mongoose.h](https://raw.githubusercontent.com/cesanta/mongoose/master/mongoose.h)
|
|
|
|
files to your build tree
|
2016-03-04 23:08:19 +08:00
|
|
|
|
|
|
|
# Licensing
|
|
|
|
|
2016-10-19 22:33:08 +08:00
|
|
|
Mongoose is released under Commercial and [GNU GPL v.2](http://www.gnu.org/licenses/old-licenses/gpl-2.0.html) open source licenses.
|
2016-03-04 23:08:19 +08:00
|
|
|
|
2016-10-19 22:33:08 +08:00
|
|
|
Commercial Projects: [Contact us for commercial license.] (https://www.cesanta.com/contact)
|
2015-09-08 19:49:03 +08:00
|
|
|
|
2015-08-18 16:50:00 +08:00
|
|
|
# Dashboard Example
|
2014-03-12 00:59:17 +08:00
|
|
|
|
2015-09-21 22:16:16 +08:00
|
|
|
Mongoose is often used to implement device dashboards and real-time
|
|
|
|
data exchange over Websocket. Here is a dashboard example that illustrates
|
|
|
|
the functionality:
|
|
|
|
|
2015-08-18 16:50:00 +08:00
|
|
|
![](http://www.cesanta.com/hubfs/www.cesanta.com/diagrams/dash_mongoose_diagram.png)
|
2014-03-12 00:59:17 +08:00
|
|
|
|
2016-10-19 22:33:08 +08:00
|
|
|
[Developing a new product? Contact us today to discuss how Mongoose can help.
|
2016-04-01 15:48:31 +08:00
|
|
|
](https://www.cesanta.com/contact)
|
2014-03-12 00:59:17 +08:00
|
|
|
|
2016-03-01 18:41:24 +08:00
|
|
|
# Contributions
|
|
|
|
|
2016-06-10 20:28:57 +08:00
|
|
|
To submit contributions, sign
|
|
|
|
[Cesanta CLA](https://docs.cesanta.com/contributors_la.shtml)
|
|
|
|
and send GitHub pull request. You retain the copyright on your contributions.
|
2016-03-01 18:41:24 +08:00
|
|
|
|
2016-10-19 22:33:08 +08:00
|
|
|
# Looking for a pre-compiled Mongoose web server Windows or Mac binary?
|
|
|
|
- [Download pre-compiled Mongoose web server binary.](https://www.cesanta.com/products/binary)
|
2016-09-27 23:29:13 +08:00
|
|
|
|
2016-02-19 19:55:42 +08:00
|
|
|
[![Analytics](https://ga-beacon.appspot.com/UA-42732794-5/project-page)](https://github.com/cesanta/mongoose)
|