mirror of
https://github.com/espressif/esp-idf.git
synced 2026-04-27 19:13:21 +00:00
Shen Mengjing
35 lines
2.6 KiB
ReStructuredText
35 lines
2.6 KiB
ReStructuredText
存储
|
||
====
|
||
|
||
:link_to_translation:`en:[English]`
|
||
|
||
重大变更
|
||
--------
|
||
|
||
已被弃用的 API ``esp_vfs_fat_sdmmc_unmount`` 现已移除，请使用 ``esp_vfs_fat_sdcard_unmount`` 代替。
|
||
|
||
``esp_vfs_fat_register`` 的函数原型已修改为与 ``esp_vfs_fat_register_cfg`` 函数保持一致。``esp_vfs_fat_register_cfg`` 现已弃用。
|
||
|
||
|
||
VFS
|
||
---
|
||
|
||
- 位于 ``vfs`` 组件中已弃用的 UART-VFS 函数 ``esp_vfs_dev_uart_*`` 现已删除，请改用 UART 驱动中的 API：``uart_vfs_dev_*``。
|
||
- 位于 ``vfs`` 组件中已弃用的 USB-Serial-JTAG-VFS 函数 ``esp_vfs_dev_usb_serial_jtag_*`` 现已删除，请改用 USB-Serial-JTAG 驱动中的 API：``usb_serial_jtag_vfs_*``。
|
||
- ``esp_vfs_register_fd_range`` 现被视为私有接口，其函数签名已调整为匹配新的 VFS API 风格。仍依赖此内部辅助函数的项目需包含 ``esp_private/socket.h`` 头文件，并请注意该 API 可能在不另行通知的情况下发生变更。
|
||
- 基于 ``esp_vfs_t`` 而非 ``esp_vfs_fs_ops_t`` 的传统 VFS API（如 ``esp_vfs_register``）已弃用，并将在下一个主版本中移除。请迁移至基于 ``esp_vfs_fs_ops_t`` 的新 API。
|
||
- TERMIOS 支持现已默认禁用。若应用程序需调用 POSIX ``termios`` API（例如用于 UART 配置的 ``tcsetattr``/``tcgetattr`` 接口），请在 menuconfig 中重新启用 :ref:`CONFIG_VFS_SUPPORT_TERMIOS` 选项。
|
||
- 不带上下文的 VFS 函数指针已弃用。请切换到带上下文感知的 ``*_p`` 系列回调函数，并使用 ``ESP_VFS_FLAG_CONTEXT_PTR`` 标志注册 VFS。如果驱动不需要每个实例各自的状态，则将上下文指针传入 ``NULL`` 即可。此项变更简化了 API 接口，并减少了 VFS 调用路径中的运行时开销。
|
||
|
||
``esp_vfs_console``
|
||
--------------------
|
||
|
||
``esp_vfs_console`` 组件已更名为 ``esp_stdio``。该组件没有任何公共函数，因此在一般情况下，无需对代码进行任何更新。如果你曾经因为某些原因在项目中声明了对此组件的依赖，现在可以将其删除，因为新的 ``esp_stdio`` 是一个通用组件，默认会被添加到所有组件中。
|
||
|
||
|
||
FATFS
|
||
-----
|
||
|
||
- 动态缓冲区 (:ref:`CONFIG_FATFS_USE_DYN_BUFFERS`) 现已默认启用，以在挂载多个卷时减少静态内存占用；如果倾向于静态分配，可在 menuconfig 中关闭此选项。
|
||
- 长文件名支持现已默认使用基于堆的缓冲区 (``CONFIG_FATFS_LFN_HEAP=y``)，因此长于 8.3 格式的文件名可直接使用；若需节省堆内存，可在 menuconfig 中禁用长文件名功能(:ref:`CONFIG_FATFS_LONG_FILENAMES`)。
|