Merge branch 'refactor/flash_refactor' into 'master'

spi_flash: split driver and os driver into `spi_flash` and `esp_mspi` components

Closes IDF-15210

See merge request espressif/esp-idf!45409

docs/en/migration-guides/release-6.x/6.1/peripherals.rst

@@ -9,6 +9,16 @@ LCD
 - The :cpp:member:`esp_lcd_dpi_panel_event_callbacks_t::on_refresh_done` callback has been deprecated. Please use :cpp:member:`esp_lcd_dpi_panel_event_callbacks_t::on_frame_buf_complete` to know when a frame buffer can be safely reused.
 - The VSYNC timing event for the MIPI DSI DPI panel is now reported by :cpp:member:`esp_lcd_dpi_panel_event_callbacks_t::on_vsync`.
 
+SPI Flash
+---------
+
+- ``bootloader_flash_priv.h`` header file is deprecated. Its contents have been split into two headers:
+
+  - ``bootloader_flash_override.h`` for the utility APIs intended for custom flash chip support, such as ``bootloader_execute_flash_command``, ``bootloader_flash_read_sfdp``, and the status register read/write helpers. This header is not considered a stable API, but it remains available to applications and custom bootloader components.
+  - ``esp_private/bootloader_flash_internal.h`` for the APIs that are internal to ESP-IDF, such as ``bootloader_mmap``, ``bootloader_munmap``, and ``bootloader_flash_read``. These may change without notice.
+
+  The deprecated ``bootloader_flash_priv.h`` still includes both headers, so existing code keeps compiling until the header is removed.
+
 UART
 -----
 

docs/zh_CN/migration-guides/release-6.x/6.1/peripherals.rst

@@ -9,6 +9,16 @@ LCD
 - :cpp:member:`esp_lcd_dpi_panel_event_callbacks_t::on_refresh_done` 回调已废弃。请使用 :cpp:member:`esp_lcd_dpi_panel_event_callbacks_t::on_frame_buf_complete` 判断帧缓冲区何时可以被安全复用。
 - MIPI DSI DPI 面板的 VSYNC 时序事件现在通过 :cpp:member:`esp_lcd_dpi_panel_event_callbacks_t::on_vsync` 回调上报。
 
+SPI Flash
+---------
+
+- ``bootloader_flash_priv.h`` 头文件已废弃，其内容已拆分到两个头文件中：
+
+  - ``bootloader_flash_override.h``：面向自定义 flash 芯片支持的工具类 API，例如 ``bootloader_execute_flash_command``、``bootloader_flash_read_sfdp`` 以及状态寄存器读写辅助函数。该头文件不被视为稳定 API，但应用程序和自定义 bootloader 组件仍可使用。
+  - ``esp_private/bootloader_flash_internal.h``：ESP-IDF 内部使用的 API，例如 ``bootloader_mmap``、``bootloader_munmap`` 和 ``bootloader_flash_read``，这些 API 可能在不另行通知的情况下发生变更。
+
+  已废弃的 ``bootloader_flash_priv.h`` 仍会包含上述两个头文件，因此在该头文件被移除之前，现有代码可以继续正常编译。
+
 UART
 ------