stm32/boards: Add STM32H747I-DISCO with TinyUSB support.

Adds board definition for STM32H747I-DISCO with TinyUSB stack enabled.
Board features USB HS via ULPI PHY (USB3320C) running at High-Speed
(480 Mbps).

Working:
- USB CDC (serial console)
- USB MSC (mass storage)
- All peripherals (I2C, SPI, UART, ADC, SD card)
- Both ST-LINK UART and USB CDC consoles

Board configuration:
- Dual-core STM32H747XI (M7 @ 400MHz, M4 @ 240MHz)
- 2MB Flash, 1MB RAM, 32MB SDRAM
- USB HS with ULPI PHY
- 8-bit SDMMC SD card interface
- Ethernet (requires hardware modification - see board README)

Test suite in tests/ directory verifies peripheral functionality.

Signed-off-by: Andrew Leech <[email protected]>

Author: pi-anl

ports/stm32/boards/STM32H747I_DISCO/README.md

@@ -0,0 +1,102 @@
+# STM32H747I-DISCO Board
+
+STMicroelectronics STM32H747I-DISCO development board with STM32H747XI dual-core MCU.
+
+## Features
+
+- STM32H747XIH6 microcontroller
+  - Arm Cortex-M7 @ 480 MHz + Cortex-M4 @ 240 MHz
+  - 2 MB Flash, 1 MB RAM
+  - 32 MB external SDRAM
+- Connectivity
+  - USB High-Speed via ULPI PHY (USB3320)
+  - USB Full-Speed
+  - Ethernet RMII (LAN8742A PHY) - **requires hardware modification**
+  - microSD card slot (8-bit SDMMC1)
+- Display
+  - 4" capacitive touchscreen LCD (480×272)
+- Audio
+  - WM8994 codec with line in/out, headphone, speaker, microphone
+  - 2x digital MEMS microphones
+- Other peripherals
+  - 2× user LEDs
+  - 1× user button + reset button
+  - Arduino Uno V3 expansion connector
+  - PMOD connector
+  - Onboard ST-LINK/V3
+
+## Pin Configuration
+
+Default pin assignments:
+
+- UART1: PA9 (TX), PA10 (RX) - Connected to ST-LINK VCP
+- USB_HS: ULPI interface on PA3, PA5, PB0, PB1, PB5, PB10-13, PC0, PH4, PI11
+- I2C4: PD12 (SCL), PD13 (SDA) - WM8994 audio codec
+- SPI5: PF7 (SCK), PF8 (MISO), PF9 (MOSI), PF6 (CS)
+- UART8: PJ8 (TX), PJ9 (RX)
+- SD Card: 8-bit SDMMC1 interface on PC6-12, PB8-9, PD2
+
+## Ethernet Hardware Limitation
+
+**Important:** The Ethernet interface is not functional with the default board configuration due to a pin conflict between ETH_MDC (PC1) and SAI4_D1 (digital MEMS microphone). A hardware modification is required to disconnect the MEMS microphone from PC1 to enable Ethernet functionality. Refer to the STM32H747I-DISCO user manual (UM2411) for details on the required modification.
+
+## Building Firmware
+
+```bash
+cd ports/stm32
+make BOARD=STM32H747I_DISCO
+```
+
+## Flashing Firmware
+
+Using STM32CubeProgrammer (recommended):
+```bash
+STM32_Programmer_CLI -c port=SWD mode=UR -w build-STM32H747I_DISCO/firmware.elf -v -rst
+```
+
+Using st-flash:
+```bash
+st-flash write build-STM32H747I_DISCO/firmware.bin 0x08000000
+```
+
+## Console Access
+
+The board provides two independent console options:
+
+1. **ST-LINK V3 UART** (recommended):
+   - Device: /dev/ttyACM* (Linux), COM* (Windows)
+   - Baudrate: 115200
+   - Always available regardless of USB state
+
+2. **USB CDC serial**:
+   - Requires USB cable connected
+   - Provides MicroPython REPL
+
+Using mpremote:
+```bash
+mpremote connect /dev/ttyACM5  # Adjust device as needed
+```
+
+## Testing
+
+The board includes a test suite for verifying hardware functionality:
+
+```python
+# Run automated tests
+import run_all_tests
+run_all_tests.run_automated()
+
+# Run manual tests (requires user interaction)
+run_all_tests.run_manual()
+```
+
+Test coverage:
+- I2C (WM8994 codec)
+- ADC (3 channels)
+- SPI
+- UART
+- SD card
+- Ethernet (requires hardware modification)
+- DAC
+- PWM/Timers
+- LEDs and buttons

ports/stm32/boards/STM32H747I_DISCO/bdev.c

@@ -3,7 +3,7 @@
  *
  * The MIT License (MIT)
  *
- * Copyright (c) 2025 Andrew Leech
+ * Copyright (c) 2025
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal

ports/stm32/boards/STM32H747I_DISCO/board.json

@@ -4,17 +4,13 @@
     ],
     "docs": "",
     "features": [
-        "DAC",
         "Dual-core",
         "Ethernet",
         "External Flash",
         "External RAM",
-        "microSD",
         "USB"
     ],
-    "images": [
-        "stm32h747i_disco.jpg"
-    ],
+    "images": [],
     "mcu": "stm32h7",
     "product": "Discovery Kit H747I",
     "thumbnail": "",

ports/stm32/boards/STM32H747I_DISCO/board_init.c

@@ -3,7 +3,7 @@
  *
  * The MIT License (MIT)
  *
- * Copyright (c) 2025 Andrew Leech
+ * Copyright (c) 2025
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -28,9 +28,18 @@
 #include "py/mphal.h"
 #include "storage.h"
 #include "sdram.h"
+#include "qspi.h"
 
 void DISCO_board_early_init(void) {
     HAL_InitTick(0);
+
+    // SDRAM initialization is handled by main.c
+    // sdram_init();
+
+    #if MICROPY_HW_ENABLE_INTERNAL_FLASH_STORAGE == 0
+    // QSPI initialization might fail - comment out for now
+    // qspi_memory_map();
+    #endif
 }
 
 void DISCO_board_low_power(int mode) {

ports/stm32/boards/STM32H747I_DISCO/mbedtls_config_board.h

@@ -0,0 +1,8 @@
+#ifndef MICROPY_INCLUDED_MBEDTLS_CONFIG_BOARD_H
+#define MICROPY_INCLUDED_MBEDTLS_CONFIG_BOARD_H
+
+#define MBEDTLS_ECP_NIST_OPTIM
+
+#include "ports/stm32/mbedtls/mbedtls_config_port.h"
+
+#endif /* MICROPY_INCLUDED_MBEDTLS_CONFIG_BOARD_H */

ports/stm32/boards/STM32H747I_DISCO/mpconfigboard.h

@@ -21,6 +21,7 @@ typedef unsigned int mp_uint_t;     // must be pointer size
 #define MICROPY_HW_ENABLE_ADC       (1)
 #define MICROPY_HW_ENABLE_DAC       (1)
 #define MICROPY_HW_ENABLE_USB       (1)
+#define MICROPY_HW_TINYUSB_STACK    (1)
 #define MICROPY_HW_HAS_SWITCH       (1)
 #define MICROPY_HW_HAS_FLASH        (1)
 #define MICROPY_HW_ENABLE_SERVO     (1)
@@ -88,7 +89,7 @@ void DISCO_board_low_power(int mode);
 // Peripheral clock sources
 #define MICROPY_HW_RCC_HSI48_STATE      (RCC_HSI48_ON)
 #define MICROPY_HW_RCC_USB_CLKSOURCE    (RCC_USBCLKSOURCE_PLL3)
-#define MICROPY_HW_RCC_RTC_CLKSOURCE    (RCC_RTCCLKSOURCE_LSE)
+#define MICROPY_HW_RCC_RTC_CLKSOURCE    (RCC_RTCCLKSOURCE_LSI)
 #define MICROPY_HW_RCC_FMC_CLKSOURCE    (RCC_FMCCLKSOURCE_PLL2)
 #define MICROPY_HW_RCC_RNG_CLKSOURCE    (RCC_RNGCLKSOURCE_HSI48)
 #define MICROPY_HW_RCC_ADC_CLKSOURCE    (RCC_ADCCLKSOURCE_PLL3)
@@ -105,8 +106,9 @@ void DISCO_board_low_power(int mode);
 #define MICROPY_HW_ANALOG_SWITCH_PC2    (SYSCFG_SWITCH_PC2_OPEN)
 #define MICROPY_HW_ANALOG_SWITCH_PC3    (SYSCFG_SWITCH_PC3_OPEN)
 
-// Using LSE for RTC (32.768kHz crystal on PC14/PC15)
-#define MICROPY_HW_RTC_USE_LSE      (1)
+// Using LSI for RTC (LSE may not be populated or starting)
+// LSI is approximately 32kHz but varies, so use default prediv values
+#define MICROPY_HW_RTC_USE_LSE      (0)
 #define MICROPY_HW_RTC_USE_US       (1)
 #define MICROPY_HW_RTC_USE_CALOUT   (1)
 
@@ -302,3 +304,25 @@ extern struct _spi_bdev_t spi_bdev;
 #define MICROPY_HW_FMC_D29          (pin_I7)
 #define MICROPY_HW_FMC_D30          (pin_I9)
 #define MICROPY_HW_FMC_D31          (pin_I10)
+
+#define MICROPY_HW_USB_VID                      0x0483
+#define MICROPY_HW_USB_PID                      0x5740
+#define MICROPY_HW_USB_PID_CDC_MSC              (MICROPY_HW_USB_PID)
+#define MICROPY_HW_USB_PID_CDC_HID              (MICROPY_HW_USB_PID)
+#define MICROPY_HW_USB_PID_CDC                  (MICROPY_HW_USB_PID)
+#define MICROPY_HW_USB_PID_MSC                  (MICROPY_HW_USB_PID)
+#define MICROPY_HW_USB_PID_CDC2_MSC             (MICROPY_HW_USB_PID)
+#define MICROPY_HW_USB_PID_CDC2                 (MICROPY_HW_USB_PID)
+#define MICROPY_HW_USB_PID_CDC3                 (MICROPY_HW_USB_PID)
+#define MICROPY_HW_USB_PID_CDC3_MSC             (MICROPY_HW_USB_PID)
+#define MICROPY_HW_USB_PID_CDC_MSC_HID          (MICROPY_HW_USB_PID)
+#define MICROPY_HW_USB_PID_CDC2_MSC_HID         (MICROPY_HW_USB_PID)
+#define MICROPY_HW_USB_PID_CDC3_MSC_HID         (MICROPY_HW_USB_PID)
+#define MICROPY_HW_USB_LANGID_STRING            0x409
+#define MICROPY_HW_USB_MANUFACTURER_STRING      "STMicroelectronics"
+#define MICROPY_HW_USB_PRODUCT_FS_STRING        "STM32H747I-DISCO"
+#define MICROPY_HW_USB_PRODUCT_HS_STRING        "STM32H747I-DISCO"
+#define MICROPY_HW_USB_INTERFACE_FS_STRING      "STM32H747I-DISCO"
+#define MICROPY_HW_USB_INTERFACE_HS_STRING      "STM32H747I-DISCO"
+#define MICROPY_HW_USB_CONFIGURATION_FS_STRING  "STM32H747I-DISCO Config"
+#define MICROPY_HW_USB_CONFIGURATION_HS_STRING  "STM32H747I-DISCO Config"

ports/stm32/boards/STM32H747I_DISCO/mpconfigboard.mk

@@ -19,3 +19,4 @@ MICROPY_PY_OPENAMP = 1
 MICROPY_PY_OPENAMP_REMOTEPROC = 1
 
 FROZEN_MANIFEST = $(BOARD_DIR)/manifest.py
+MBEDTLS_CONFIG_FILE = '"$(BOARD_DIR)/mbedtls_config_board.h"'