From b6d1e09448678254981fad0ae37592c97d28d6ff Mon Sep 17 00:00:00 2001
From: Alexandre Abadie <alexandre.abadie@inria.fr>
Date: Wed, 1 Dec 2021 15:55:59 +0100
Subject: [PATCH] boards/stm32f746g-disco: extend documentation

---
 boards/stm32f746g-disco/doc.txt | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/boards/stm32f746g-disco/doc.txt b/boards/stm32f746g-disco/doc.txt
index e46c63d7c8..68f7618f4d 100644
--- a/boards/stm32f746g-disco/doc.txt
+++ b/boards/stm32f746g-disco/doc.txt
@@ -3,6 +3,36 @@
  * @ingroup     boards
  * @brief       Support for the STM32F746G-DISCO board.
 
+## Overview
+
+The ST [STM32F746G-DISCO](https://www.st.com/en/evaluation-tools/32f746gdiscovery.html)
+is an evaluation board supporting a ARM Cortex-M7 STM32F746NG microcontroller
+with 340KB of RAM and 1MB of ROM Flash.
+
+As main features, this board provides:
+- a 4"3 RGB 480×272 color LCD-TFT with capacitive touch screen,
+- an ethernet port
+- 2 user USB ports (FS and HS)
+- 2 user digital microphones
+- 128M-bit external Quas-SPI flash
+- 128M-bit external SDRAM
+
+Current hardware support:
+
+| Feature        | Support     |  Configuration     |
+| ------------- | :---------------------: | --------------------- |
+| UART |  X  | USART1 on PB7/PA9 (stdio) and USART6 on PC6/PC7    |
+| SPI |  X  | SPI2 on PB15/PB14/PI1    |
+| I2C |  X | I2C1 on PB8/PB9    |
+| Ethernet | X |  |
+| USB OTG FS | X |  |
+| USB OTG HS | - |  |
+| TFT LCD | - |  |
+| Capacitive touch screen | - | |
+| User microphones | - | |
+| External Quad-SPI Flash | - | |
+| External SDRAM | - | |
+
 ## Flashing the device
 
 The STM32F746G-DISCO board includes an on-board ST-LINK programmer and can be