From d2f7fd6a0ee6d8a6abb08036b2e6eb5018ed4d85 Mon Sep 17 00:00:00 2001
From: Gunar Schorcht <gunar@schorcht.net>
Date: Sun, 2 Oct 2022 10:37:16 +0200
Subject: [PATCH] boards/common/stm32: rename cfg_usb_otg_hs_fs.h to clarify
 the usage

The `fs` in the file name means that on-chip FS PHY is configured for USB OTG HS. The file is renamed to `cfg_usb_otg_hs_phy_fs.h`
- to clarify that USB OTG HS is just configured with PHY FS and not HS and FS,
- to allow a configuration of USB OTG FS and HS in one file called `cfg_usb_otg_hs_fs.h` or whatever, and
- to allow a configuration of USB OTG HS with ULPI PHY in a file called `cfg_usb_otg_hs_phy_ulpi.h`.
f
---
 .../{cfg_usb_otg_hs_fs.h => cfg_usb_otg_hs_phy_fs.h} | 12 ++++++++----
 boards/stm32f429i-disc1/include/periph_conf.h        |  2 +-
 2 files changed, 9 insertions(+), 5 deletions(-)
 rename boards/common/stm32/include/{cfg_usb_otg_hs_fs.h => cfg_usb_otg_hs_phy_fs.h} (80%)

diff --git a/boards/common/stm32/include/cfg_usb_otg_hs_fs.h b/boards/common/stm32/include/cfg_usb_otg_hs_phy_fs.h
similarity index 80%
rename from boards/common/stm32/include/cfg_usb_otg_hs_fs.h
rename to boards/common/stm32/include/cfg_usb_otg_hs_phy_fs.h
index c861f5e466..aa3e77cfeb 100644
--- a/boards/common/stm32/include/cfg_usb_otg_hs_fs.h
+++ b/boards/common/stm32/include/cfg_usb_otg_hs_phy_fs.h
@@ -11,13 +11,17 @@
  * @{
  *
  * @file
- * @brief       Common configuration for STM32 OTG HS peripheral with FS phy
+ * @brief       Common configuration for STM32 OTG HS peripheral with on-chip FS PHY
+ *
+ * All STM32 boards which use the on-chip FS PHY for the USB OTG HS peripheral
+ * use the same configuration. Therefore a common configuration file can be
+ * used for these boards.
  *
  * @author      Koen Zandberg <koen@bergzand.net>
  */
 
-#ifndef CFG_USB_OTG_HS_FS_H
-#define CFG_USB_OTG_HS_FS_H
+#ifndef CFG_USB_OTG_HS_PHY_FS_H
+#define CFG_USB_OTG_HS_PHY_FS_H
 
 #include "periph_cpu.h"
 #include "usbdev_synopsys_dwc2.h"
@@ -57,5 +61,5 @@ static const dwc2_usb_otg_fshs_config_t dwc2_usb_otg_fshs_config[] = {
 }
 #endif
 
-#endif /* CFG_USB_OTG_HS_FS_H */
+#endif /* CFG_USB_OTG_HS_PHY_FS_H */
 /** @} */
diff --git a/boards/stm32f429i-disc1/include/periph_conf.h b/boards/stm32f429i-disc1/include/periph_conf.h
index 0e40a84a47..24cb9581e7 100644
--- a/boards/stm32f429i-disc1/include/periph_conf.h
+++ b/boards/stm32f429i-disc1/include/periph_conf.h
@@ -32,7 +32,7 @@
 #include "periph_cpu.h"
 #include "clk_conf.h"
 #include "cfg_timer_tim5.h"
-#include "cfg_usb_otg_hs_fs.h"
+#include "cfg_usb_otg_hs_phy_fs.h"
 
 #ifdef __cplusplus
 extern "C" {