boards/nucleo*: Cleanup and Enhance the Documentation

boards/common/nucleo144/doc.md

@@ -0,0 +1,17 @@
+@defgroup    boards_common_nucleo144 STM32 Nucleo-144
+@ingroup     boards
+@brief       Support for STM32 Nucleo-144 boards
+
+## Flashing the Board
+
+A detailed description about the flashing process can be found on the
+[guides page](https://guide.riot-os.org/board_specific/stm32/).
+
+## Accessing the RIOT shell
+
+The default RIOT OS shell access utilizes the ST-Link VCP (Virtual COM Port)
+that is featured on every Nucleo board. The USART used for this connection
+varies between the different Nucleo variants, so you have to consult the
+`nucleo-xxxxx/include/periph_conf.h` header file for more information.
+
+The default baud rate is 115200, 8N1.

boards/common/nucleo144/include/board.h

@@ -8,9 +8,7 @@
 #pragma once
 
 /**
- * @defgroup    boards_common_nucleo144 STM32 Nucleo-144
- * @ingroup     boards
- * @brief       Support for STM32 Nucleo-144 boards
+ * @ingroup     boards_common_nucleo144
  * @{
  *
  * @file

boards/common/nucleo32/doc.md

@@ -0,0 +1,17 @@
+@defgroup    boards_common_nucleo32 STM32 Nucleo-32
+@ingroup     boards
+@brief       Support for STM32 Nucleo-32 boards
+
+## Flashing the Board
+
+A detailed description about the flashing process can be found on the
+[guides page](https://guide.riot-os.org/board_specific/stm32/).
+
+## Accessing the RIOT shell
+
+The default RIOT OS shell access utilizes the ST-Link VCP (Virtual COM Port)
+that is featured on every Nucleo board. The USART used for this connection
+varies between the different Nucleo variants, so you have to consult the
+`nucleo-xxxxx/include/periph_conf.h` header file for more information.
+
+The default baud rate is 115200, 8N1.

boards/common/nucleo32/include/board.h

@@ -6,9 +6,7 @@
 #pragma once
 
 /**
- * @defgroup    boards_common_nucleo32 STM32 Nucleo-32
- * @ingroup     boards
- * @brief       Support for STM32 Nucleo-32 boards
+ * @ingroup     boards_common_nucleo32
  * @{
  *
  * @file

boards/common/nucleo64/doc.md

@@ -0,0 +1,26 @@
+@defgroup boards_common_nucleo64 STM32 Nucleo-64
+@ingroup boards
+@brief Support for STM32 Nucleo-64 Boards
+
+## Using LED0 and SPI at once
+
+Due to a pin conflict on Nucleo64 boards, you can not use
+the SPI peripheral and LED0 at the same time.
+A warning will be shown during compile time:
+```
+Warning: Using periph_spi on Nucleo64 boards will disable LED0 due to pin conflicts.
+```
+
+## Flashing the Board
+
+A detailed description about the flashing process can be found on the
+[guides page](https://guide.riot-os.org/board_specific/stm32/).
+
+## Accessing the RIOT shell
+
+The default RIOT OS shell access utilizes the ST-Link VCP (Virtual COM Port)
+that is featured on every Nucleo board. The USART used for this connection
+varies between the different Nucleo variants, so you have to consult the
+`nucleo-xxxxx/include/periph_conf.h` header file for more information.
+
+The default baud rate is 115200, 8N1.

boards/common/nucleo64/include/board.h

@@ -6,9 +6,7 @@
 #pragma once
 
 /**
- * @defgroup    boards_common_nucleo64 STM32 Nucleo-64
- * @ingroup     boards
- * @brief       Support for STM32 Nucleo-64 boards
+ * @ingroup     boards_common_nucleo64
  * @{
  *
  * @file

boards/nucleo-c031c6/doc.md

@@ -7,6 +7,9 @@
 The Nucleo-C031C6 is a board from ST's Nucleo family supporting a ARM
 Cortex-M0+ STM32C031C6 microcontroller with 12KiB of RAM and 32KiB of Flash.
 
+You can find general information about the Nucleo64 boards on the
+@ref boards_common_nucleo64 page.
+
 ## Pinout
 
 @image html pinouts/nucleo-c031c6.svg "Pinout for the Nucleo-C031C6 (from STM user manual UM2953, https://www.st.com/resource/en/user_manual/um2953-stm32-nucleo64-board-mb1717-stmicroelectronics.pdf, page 19)" width=50%
@@ -33,17 +36,8 @@ Cortex-M0+ STM32C031C6 microcontroller with 12KiB of RAM and 32KiB of Flash.
 | Programming Manual | [Programming Manual](https://www.st.com/resource/en/programming_manual/pm0223-stm32-cortexm0-mcus-programming-manual-stmicroelectronics.pdf) |
 | Board Manual   | [Board Manual](https://www.st.com/resource/en/user_manual/um2953-stm32-nucleo64-board-mb1717-stmicroelectronics.pdf) |
 
-## Flashing the Board Using ST-LINK Removable Media
-
-On-board ST-LINK programmer provides via composite USB device removable media.
-Copying the HEX file causes reprogramming of the board. This task
-could be performed manually; however, the cpy2remed (copy to removable
-media) PROGRAMMER script does this automatically. To program board in
-this manner, use the command:
-
-```
-make BOARD=nucleo-c031c6 PROGRAMMER=cpy2remed flash
-```
+## Flashing the Board
 
-@note This PROGRAMMER was tested using ST-LINK firmware 2.37.26. Firmware updates
-could be found on [this STM webpage](https://www.st.com/en/development-tools/stsw-link007.html).
+A detailed description about the flashing process can be found on the
+[guides page](https://guide.riot-os.org/board_specific/stm32/).
+The board name for the Nucleo-C031C6 is `nucleo-c031c6`.

boards/nucleo-c071rb/doc.md

@@ -7,6 +7,9 @@
 The Nucleo-C071RB is a board from ST's Nucleo family supporting a ARM
 Cortex-M0+ STM32C071RB microcontroller with 24KiB of RAM and 128KiB of Flash.
 
+You can find general information about the Nucleo64 boards on the
+@ref boards_common_nucleo64 page.
+
 ## Pinout
 
 See Board Manual referenced below, section 7 pages 19-21.

boards/nucleo-f030r8/doc.md

@@ -7,6 +7,9 @@
 The Nucleo-F030R8 is a board from ST's Nucleo family supporting a ARM Cortex-M0
 STM32F030R8 microcontroller with 8KiB of RAM and 64KiB of Flash.
 
+You can find general information about the Nucleo64 boards on the
+@ref boards_common_nucleo64 page.
+
 ## Hardware
 
 ![Nucleo64 F030R8](http://www.open-electronics.org/wp-content/uploads/2015/08/Figura2-500x467.png)
@@ -52,37 +55,8 @@ STM32F030R8 microcontroller with 8KiB of RAM and 64KiB of Flash.
 |        | Timer     | 3 16 bit timers       | |
 
 
-## Flashing the device
-
-### Flashing the Board Using OpenOCD
-
-The ST Nucleo-F030R8 board includes an on-board ST-LINK V2 programmer. The
-easiest way to program the board is to use OpenOCD. Once you have installed
-OpenOCD (look [here](https://github.com/RIOT-OS/RIOT/wiki/OpenOCD) for
-installation instructions), you can flash the board simply by typing
-
-```
-make BOARD=nucleo-f030r8 flash
-```
-and debug via GDB by simply typing
-```
-make BOARD=nucleo-f030r8 debug
-```
-
-### Flashing the Board Using ST-LINK Removable Media
-
-On-board ST-LINK programmer provides via composite USB device removable media.
-Copying the HEX file causes reprogramming of the board. This task
-could be performed manually; however, the cpy2remed (copy to removable
-media) PROGRAMMER script does this automatically. To program board in
-this manner, use the command:
-```
-make BOARD=nucleo-f030r8 PROGRAMMER=cpy2remed flash
-```
-@note This PROGRAMMER was tested using ST-LINK firmware 2.37.26. Firmware updates
-could be found on [this STM webpage](https://www.st.com/en/development-tools/stsw-link007.html).
+## Flashing the Board
 
-## Supported Toolchains
-For using the ST Nucleo-F030R8 board we strongly recommend the usage of the
-[GNU Tools for ARM Embedded Processors](https://launchpad.net/gcc-arm-embedded)
-toolchain.
+A detailed description about the flashing process can be found on the
+[guides page](https://guide.riot-os.org/board_specific/stm32/).
+The board name for the Nucleo-F030R8 is `nucleo-f030r8`.

boards/nucleo-f031k6/doc.md

@@ -7,6 +7,9 @@
 The Nucleo-F031K6 is a board from ST's Nucleo family supporting ARM Cortex-M0
 STM32F031K6 microcontroller with 4KiB of RAM and 32KiB of Flash.
 
+You can find general information about the Nucleo32 boards on the
+@ref boards_common_nucleo32 page.
+
 ## Pinout
 
 @image html pinouts/nucleo-f031k6-and-more.svg "Pinout for the Nucleo-F031K6 (from ST User Manual, UM1956, https://www.st.com/resource/en/user_manual/um1956-stm32-nucleo32-boards-mb1180-stmicroelectronics.pdf, page 31)" width=25%
@@ -34,15 +37,8 @@ STM32F031K6 microcontroller with 4KiB of RAM and 32KiB of Flash.
 | Programming Manual | [Programming Manual](https://www.st.com/resource/en/programming_manual/pm0215-stm32f0-series-cortexm0-programming-manual-stmicroelectronics.pdf) |
 | Board Manual | [Board Manual](https://www.st.com/resource/en/user_manual/um1956-stm32-nucleo32-boards-mb1180-stmicroelectronics.pdf) |
 
-## Flashing the Board Using ST-LINK Removable Media
-
-On-board ST-LINK programmer provides via composite USB device removable media.
-Copying the HEX file causes reprogramming of the board. This task
-could be performed manually; however, the cpy2remed (copy to removable
-media) PROGRAMMER script does this automatically. To program board in
-this manner, use the command:
-```
-make BOARD=nucleo-f031k6 PROGRAMMER=cpy2remed flash
-```
-@note This PROGRAMMER was tested using ST-LINK firmware 2.37.26. Firmware updates
-      can be found on [this STM webpage](https://www.st.com/en/development-tools/stsw-link007.html).
+## Flashing the Board
+
+A detailed description about the flashing process can be found on the
+[guides page](https://guide.riot-os.org/board_specific/stm32/).
+The board name for the Nucleo-F031K6 is `nucleo-f031k6`.

boards/nucleo-f042k6/doc.md

@@ -7,6 +7,9 @@
 The Nucleo-F042K6 is a board from ST's Nucleo family supporting ARM Cortex-M0
 STM32F042K6 microcontroller with 6KiB of RAM and 32KiB of Flash.
 
+You can find general information about the Nucleo32 boards on the
+@ref boards_common_nucleo32 page.
+
 ## Pinout
 
 @image html pinouts/nucleo-f031k6-and-more.svg "Pinout for the Nucleo-F042K6 (from ST User Manual, UM1956, https://www.st.com/resource/en/user_manual/um1956-stm32-nucleo32-boards-mb1180-stmicroelectronics.pdf, page 31)" width=25%
@@ -34,15 +37,8 @@ STM32F042K6 microcontroller with 6KiB of RAM and 32KiB of Flash.
 | Programming Manual | [Programming Manual](https://www.st.com/resource/en/programming_manual/pm0215-stm32f0-series-cortexm0-programming-manual-stmicroelectronics.pdf) |
 | Board Manual | [Board Manual](https://www.st.com/resource/en/user_manual/um1956-stm32-nucleo32-boards-mb1180-stmicroelectronics.pdf) |
 
-## Flashing the Board Using ST-LINK Removable Media
-
-On-board ST-LINK programmer provides via composite USB device removable media.
-Copying the HEX file causes reprogramming of the board. This task
-could be performed manually; however, the cpy2remed (copy to removable
-media) PROGRAMMER script does this automatically. To program board in
-this manner, use the command:
-```
-make BOARD=nucleo-f042k6 PROGRAMMER=cpy2remed flash
-```
-@note This PROGRAMMER was tested using ST-LINK firmware 2.37.26. Firmware updates
-      can be found on [this STM webpage](https://www.st.com/en/development-tools/stsw-link007.html).
+## Flashing the Board
+
+A detailed description about the flashing process can be found on the
+[guides page](https://guide.riot-os.org/board_specific/stm32/).
+The board name for the Nucleo-F042K6 is `nucleo-f042k6`.

boards/nucleo-f070rb/doc.md

@@ -7,6 +7,9 @@
 The Nucleo-F070RB is a board from ST's Nucleo family supporting a ARM Cortex-M0
 STM32F070RB microcontroller with 16KiB of RAM and 128KiB of Flash.
 
+You can find general information about the Nucleo64 boards on the
+@ref boards_common_nucleo64 page.
+
 ## Hardware
 
 ![Nucleo64 F070RB](http://www.open-electronics.org/wp-content/uploads/2015/08/Figura2-500x467.png)
@@ -53,37 +56,8 @@ STM32F070RB microcontroller with 16KiB of RAM and 128KiB of Flash.
 |        | Timer     | 3 16 bit timers       | |
 
 
-## Flashing the device
-
-### Flashing the Board Using OpenOCD
-
-The ST Nucleo-F070RB board includes an on-board ST-LINK V2 programmer. The
-easiest way to program the board is to use OpenOCD. Once you have installed
-OpenOCD (look [here](https://github.com/RIOT-OS/RIOT/wiki/OpenOCD) for
-installation instructions), you can flash the board simply by typing
-
-```
-make BOARD=nucleo-f070rb flash
-```
-and debug via GDB by simply typing
-```
-make BOARD=nucleo-f070rb debug
-```
-
-### Flashing the Board Using ST-LINK Removable Media
-
-On-board ST-LINK programmer provides via composite USB device removable media.
-Copying the HEX file causes reprogramming of the board. This task
-could be performed manually; however, the cpy2remed (copy to removable
-media) PROGRAMMER script does this automatically. To program board in
-this manner, use the command:
-```
-make BOARD=nucleo-f070rb PROGRAMMER=cpy2remed flash
-```
-@note This PROGRAMMER was tested using ST-LINK firmware 2.37.26. Firmware updates
-could be found on [this STM webpage](https://www.st.com/en/development-tools/stsw-link007.html).
+## Flashing the Board
 
-## Supported Toolchains
-For using the ST Nucleo-F070RB board we strongly recommend the usage of the
-[GNU Tools for ARM Embedded Processors](https://launchpad.net/gcc-arm-embedded)
-toolchain.
+A detailed description about the flashing process can be found on the
+[guides page](https://guide.riot-os.org/board_specific/stm32/).
+The board name for the Nucleo-F070RB is `nucleo-f070rb`.

boards/nucleo-f072rb/doc.md

@@ -7,6 +7,9 @@
 The Nucleo-F072RB is a board from ST's Nucleo family supporting a ARM Cortex-M0
 STM32F072RB microcontroller with 16KiB of RAM and 128KiB of Flash.
 
+You can find general information about the Nucleo64 boards on the
+@ref boards_common_nucleo64 page.
+
 ## Hardware
 
 ![Nucleo64 F072RB](http://www.open-electronics.org/wp-content/uploads/2015/08/Figura2-500x467.png)
@@ -55,37 +58,8 @@ STM32F072RB microcontroller with 16KiB of RAM and 128KiB of Flash.
 |        | Timer     | 1 32 bit timers (TIM1)        | |
 
 
-## Flashing the device
-
-### Flashing the Board Using OpenOCD
-
-The ST Nucleo-F072RB board includes an on-board ST-LINK V2 programmer. The
-easiest way to program the board is to use OpenOCD. Once you have installed
-OpenOCD (look [here](https://github.com/RIOT-OS/RIOT/wiki/OpenOCD) for
-installation instructions), you can flash the board simply by typing
-
-```
-make BOARD=nucleo-f072rb flash
-```
-and debug via GDB by simply typing
-```
-make BOARD=nucleo-f072rb debug
-```
-
-### Flashing the Board Using ST-LINK Removable Media
-
-On-board ST-LINK programmer provides via composite USB device removable media.
-Copying the HEX file causes reprogramming of the board. This task
-could be performed manually; however, the cpy2remed (copy to removable
-media) PROGRAMMER script does this automatically. To program board in
-this manner, use the command:
-```
-make BOARD=nucleo-f072rb PROGRAMMER=cpy2remed flash
-```
-@note This PROGRAMMER was tested using ST-LINK firmware 2.37.26. Firmware updates
-could be found on [this STM webpage](https://www.st.com/en/development-tools/stsw-link007.html).
+## Flashing the Board
 
-## Supported Toolchains
-For using the ST Nucleo-F072RB board we strongly recommend the usage of the
-[GNU Tools for ARM Embedded Processors](https://launchpad.net/gcc-arm-embedded)
-toolchain.
+A detailed description about the flashing process can be found on the
+[guides page](https://guide.riot-os.org/board_specific/stm32/).
+The board name for the Nucleo-F072RB is `nucleo-f072rb`.