mongoose/examples/stm32/nucleo-f429zi-baremetal/README.md

# Baremetal webserver on NUCLEO-F429ZI

This firmware uses MIP, an experimental TCP/IP stack of the Mongoose Network Library,
which implements the following:

- A complete [HTTP device dashboard](../../device-dashboard) with:
  - User authentication
  - Real-time device data graph
  - Coninfiguration display and update
  - MQTT communication with a remote MQTT server
- 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/rm0090-stm32f405415-stm32f407417-stm32f427437-and-stm32f429439-advanced-armbased-32bit-mcus-stmicroelectronics.pdf)
- Interrupt-driven [Ethernet driver](../../../drivers/mip_driver_stm32.c)
- Blue LED blinky, based on SysTick interrupt
- User button handler, turns off/on green LED, based on EXTI, interrupt-driven 
- HardFault handler that blinks red LED
- 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.

## 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](https://mongoose.ws/tutorials/stm32/nucleo-f746zg-baremetal/) but for the NUCLEO-F746ZG board

For more details and benchmark data on MIP, check the [F746ZG example](../nucleo-f746zg-baremetal/)
Add links to tool installation in MIP hw examples 2022-11-23 21:49:31 +08:00			`# Baremetal webserver on NUCLEO-F429ZI`
Add baremetal example on Nucleo-F429ZI 2022-08-30 02:15:48 +08:00
Add links to tool installation in MIP hw examples 2022-11-23 21:49:31 +08:00			`This firmware uses MIP, an experimental TCP/IP stack of the Mongoose Network Library,`
Add baremetal example on Nucleo-F429ZI 2022-08-30 02:15:48 +08:00			`which implements the following:`

Update README 2022-09-11 18:23:58 +08:00			`- A complete [HTTP device dashboard](../../device-dashboard) with:`
Update README 2022-09-11 18:20:53 +08:00			`- User authentication`
			`- Real-time device data graph`
			`- Coninfiguration display and update`
			`- MQTT communication with a remote MQTT server`
Add baremetal example on Nucleo-F429ZI 2022-08-30 02:15:48 +08:00			`- 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/rm0090-stm32f405415-stm32f407417-stm32f427437-and-stm32f429439-advanced-armbased-32bit-mcus-stmicroelectronics.pdf)`
Update README 2022-09-11 18:23:58 +08:00			`- Interrupt-driven [Ethernet driver](../../../drivers/mip_driver_stm32.c)`
Add baremetal example on Nucleo-F429ZI 2022-08-30 02:15:48 +08:00			`- Blue LED blinky, based on SysTick interrupt`
			`- User button handler, turns off/on green LED, based on EXTI, interrupt-driven`
			`- HardFault handler that blinks red LED`
			`- Debug log on UART3 (st-link)`

			`## Requirements`

Add links to tool installation in MIP hw examples 2022-11-23 21:49:31 +08:00			`- [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.`
Add baremetal example on Nucleo-F429ZI 2022-08-30 02:15:48 +08:00
			`## 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`
			```

Add links to tool installation in MIP hw examples 2022-11-23 21:49:31 +08:00			`There is also a [detailed tutorial on this example](https://mongoose.ws/tutorials/stm32/nucleo-f746zg-baremetal/) but for the NUCLEO-F746ZG board`

Add baremetal example on Nucleo-F429ZI 2022-08-30 02:15:48 +08:00			`For more details and benchmark data on MIP, check the [F746ZG example](../nucleo-f746zg-baremetal/)`