mirror of
https://github.com/cesanta/mongoose.git
synced 2025-01-09 22:58:09 +08:00
59 lines
2.4 KiB
Markdown
59 lines
2.4 KiB
Markdown
|
# Baremetal webserver on NUCLEO-F746ZG
|
||
|
|
|
||
|
|
This firmware uses experimental TCP/IP stack of the Mongoose Network Library,
|
||
|
|
which implements the following:
|
||
|
|
|
||
|
|
- Implements HTTP server and SNTP time synchronisation
|
||
|
|
- No dependencies: no HAL, no CMSIS, no RTOS
|
||
|
|
- Hand-written [mcu.h](mcu.h) header based on a [datasheet](https://www.st.com/resource/en/reference_manual/rm0385-stm32f75xxx-and-stm32f74xxx-advanced-armbased-32bit-mcus-stmicroelectronics.pdf)
|
||
|
|
- Interrupt-driven [mip_driver_stm32.h](../../../drivers/mip_driver_stm32.h) ethernet driver
|
||
|
|
- Blue LED blinky, based on SysTick interrupt
|
||
|
|
- User button handler, turns off/on green LED, based on EXTI, interrupt-driven
|
||
|
|
- Catch-all fault handler that blinks red LED
|
||
|
|
- Debug log on UART3 (st-link)
|
||
|
|
|
||
|
|
## Requirements
|
||
|
|
|
||
|
|
- GNU make
|
||
|
|
- [ARM GCC](https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-rm) toolchain for build
|
||
|
|
- [st-link](https://github.com/stlink-org/stlink) for flashing
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
Plugin your Nucleo board into USB, and attach an Ethernet cable.
|
||
|
|
To build and flash:
|
||
|
|
|
||
|
|
```sh
|
||
|
|
make clean flash
|
||
|
|
```
|
||
|
|
|
||
|
|
To see debug log, use any serial monitor program like `cu`:
|
||
|
|
|
||
|
|
```sh
|
||
|
|
cu -l /dev/ttyACM0 -s 115200
|
||
|
|
```
|
||
|
|
|
||
|
|
## Benchmark
|
||
|
|
|
||
|
|
A quick comparison is made with several other implementations.
|
||
|
|
Note: `IP` in the table below is the IP address printed on the console after
|
||
|
|
boot. The benchmark command is the same: `siege -c 5 -t 5s http://IP`
|
||
|
|
|
||
|
|
| | Zephyr | LWIP sockets | LWIP raw | MIP |
|
||
|
|
| ------------------- | -------- | ------------ | -------- | ---- |
|
||
|
|
| Requests per second | 3 | 16 | 286 | 1080 |
|
||
|
|
| Firmware size | 117k (*) | 160k | 114k | 28k |
|
||
|
|
|
||
|
|
- Zephyr: uses Zehypr's RTOS and TCP stack, with Mongoose library on top,
|
||
|
|
[source code](https://github.com/cesanta/mongoose/tree/master/examples/zephyr/http-server).
|
||
|
|
(*) By default, Zephyr example is TLS-enabled. To compare sizes, a TLS-disabled
|
||
|
|
build was done by disabling TLS in `prj.conf` and `CMakeLists.txt`
|
||
|
|
- LWIP sockets: uses FreeRTOS and LWIP with sockets support, with Mongoose
|
||
|
|
library on top, [source code](https://github.com/mongoose-examples/stm32-nucleo-f746z).
|
||
|
|
built with `#define MG` in `Core/main.c`
|
||
|
|
- LWIP raw: uses FreeRTOS and LWIP without sockets, LWIP's httpd server,
|
||
|
|
[source code](https://github.com/mongoose-examples/stm32-nucleo-f746z).
|
||
|
|
built with `#define MG` line commented out in `Core/main.c`
|
||
|
|
- MIP: this repository
|
||
|
|
|