mirror of
https://github.com/cesanta/mongoose.git
synced 2024-12-16 10:29:22 +08:00
43 lines
2.2 KiB
Markdown
43 lines
2.2 KiB
Markdown
# MIP webserver over FreeRTOS on NUCLEO-F746ZG
|
|
|
|
This firmware uses MIP, an experimental TCP/IP stack of the Mongoose Network Library, running as a FreeRTOS task.
|
|
It implements the following:
|
|
|
|
- Minimal elementary web server, as simple as possible
|
|
- No dependencies: no HAL, no CMSIS
|
|
- Hand-written [mcu.h](mcu.h) header based on the [datasheet](https://www.st.com/resource/en/reference_manual/rm0385-stm32f75xxx-and-stm32f74xxx-advanced-armbased-32bit-mcus-stmicroelectronics.pdf)
|
|
- Interrupt-driven [Ethernet driver](../../../drivers/mip_driver_stm32.c)
|
|
- Blue LED blinky, based on another FreeRTOS task
|
|
- Debug log on UART3 (st-link)
|
|
|
|
## Requirements
|
|
|
|
- [GNU make](http://mongoose.ws/tutorials/tools/#gnu-make)
|
|
- [ARM GCC](http://mongoose.ws/tutorials/tools/#arm-gcc)
|
|
- [stlink](http://mongoose.ws/tutorials/tools/#stlink) for flashing
|
|
|
|
The Makefile defaults to using Docker for the compiler, so you don't actually need to install it if you are using a Linux/Mac workstation. If you are not, or you want to run your local ARM compiler, just append `DOCKER=` to the make commands depicted below to call the compiler directly; it must be in your executable path.
|
|
|
|
In any case, the links above will send you to tutorials on how to install each of those tools in your workstation for Linux, Mac, and Windows.
|
|
|
|
You'll also need _git_ so the Makefile can clone the FreeRTOS-Kernel repository. We assume you have it since you got to get this repository somehow. If you don't, and don't want to install it, just get the proper [FreeRTOS-Kernel](https://github.com/FreeRTOS/FreeRTOS-Kernel) version (see the Makefile) from its repository, as you did with the Mongoose repository.
|
|
|
|
## 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 `picocom` at 115200 bps and configure it to insert carriage returns after line feeds:
|
|
|
|
```sh
|
|
$ picocom /dev/ttyACM0 -i -b 115200 --imap=lfcrlf
|
|
```
|
|
|
|
There is also a [detailed tutorial on this example](http://mongoose.ws/tutorials/stm32/nucleo-f746zg-freertos-mip/)
|
|
|
|
For more details and benchmark data on MIP, check the [baremetal example](../nucleo-f746zg-baremetal/)
|