ufs: sysfs: Add WB partial flush mode support
Subsystems (2)
PATCH v3 1/1 ufs: sysfs: Add WB partial flush mode support
Expose the following JEDEC UFS 4.1 Extended WriteBooster attributes and flags to sysfs to support FIFO and Pinned partial flush modes:
- wb_partial_flush_mode
- wb_max_fifo_size
- wb_cur_fifo_size
- wb_pinned_cur_size
- wb_pinned_avail_pct
- wb_pinned_cumulative_write_size
- wb_pinned_size
- wb_non_pinned_min_size
- wb_unpin_enable
Introduce UFS_ATTRIBUTE_RW and UFS_FLAG_RW to support writable attributes and flags.
Document the new entries under Documentation/ABI/testing/sysfs-driver-ufs.
---
v3:
- Fold ufs_wb_pfm_to_string() into wb_partial_flush_mode_show().
- Propagate actual error codes for non-OCS error (ret < 0), while keeping -EINVAL for OCS errors (ret > 0).
- Clean up blank lines.
v2:
- Change wb_partial_flush_mode attribute to accept and report strings instead of numbers for better usability.
- Order local variable declarations from longest to shortest in new functions.
Documentation/ABI/testing/sysfs-driver-ufs | 85 ++++++ drivers/ufs/core/ufs-sysfs.c | 311 ++++++++++++++++----- include/ufs/ufs.h | 17 ++ 3 files changed, 350 insertions(+), 63 deletions(-)
Documentation/ABI/testing/sysfs-driver-ufs +85 -0
@@ -1791,3 +1791,88 @@ Description: will be rejected. The attribute is read/write. + +What: /sys/bus/platform/drivers/ufshcd/*/attributes/wb_partial_flush_mode +What: /sys/bus/platform/devices/*.ufs/attributes/wb_partial_flush_mode +Date: June 2026 +Contact: Daniel Lee <[email protected]> +Description: This entry controls Extended WriteBooster partial flush modes. + + ======== ============================== + "none" No partial flush + "fifo" FIFO mode + "pinned" Pinned mode + ======== ============================== + + The attribute is read-write. + +What: /sys/bus/platform/drivers/ufshcd/*/attributes/wb_max_fifo_size +What: /sys/bus/platform/devices/*.ufs/attributes/wb_max_fifo_size +Date: June 2026 +Contact: Daniel Lee <[email protected]> +Description: This entry configures the maximum size in Allocation Units reserved for the + WriteBooster FIFO Buffer size. + The attribute is read-write. + +What: /sys/bus/platform/drivers/ufshcd/*/attributes/wb_cur_fifo_size +What: /sys/bus/platform/devices/*.ufs/attributes/wb_cur_fifo_size +Date: June 2026 +Contact: Daniel Lee <[email protected]> +Description: This entry shows the current size in Allocation Units of the WriteBooster FIFO + Buffer size. + The attribute is read only. + +What: /sys/bus/platform/drivers/ufshcd/*/attributes/wb_pinned_size +What: /sys/bus/platform/devices/*.ufs/attributes/wb_pinned_size +Date: June 2026 +Contact: Daniel Lee <[email protected]> +Description: This entry configures the allocated size in Allocation Units for the UFS + Pinned WriteBooster buffer. + The attribute is read-write. + +What: /sys/bus/platform/drivers/ufshcd/*/attributes/wb_pinned_cur_size +What: /sys/bus/platform/devices/*.ufs/attributes/wb_pinned_cur_size +Date: June 2026 +Contact: Daniel Lee <[email protected]> +Description: This entry shows the current allocated size in Allocation Units for the UFS + Pinned WriteBooster buffer. + The attribute is read-only. + +What: /sys/bus/platform/drivers/ufshcd/*/attributes/wb_pinned_avail_pct +What: /sys/bus/platform/devices/*.ufs/attributes/wb_pinned_avail_pct +Date: June 2026 +Contact: Daniel Lee <[email protected]> +Description: This entry shows the percentage of available space remaining in the + Pinned WriteBooster buffer. + The attribute is read-only. + +What: /sys/bus/platform/drivers/ufshcd/*/attributes/wb_pinned_cumulative_write_size +What: /sys/bus/platform/devices/*.ufs/attributes/wb_pinned_cumulative_write_size +Date: June 2026 +Contact: Daniel Lee <[email protected]> +Description: This entry shows the total cumulative size of data written to the + Pinned WriteBooster buffer. + The attribute is read-only. + +What: /sys/bus/platform/drivers/ufshcd/*/attributes/wb_non_pinned_min_size +What: /sys/bus/platform/devices/*.ufs/attributes/wb_non_pinned_min_size +Date: June 2026 +Contact: Daniel Lee <[email protected]> +Description: This entry configures the minimum size in Allocation Units for the + Non-Pinned WriteBooster Buffer area when Pinned partial flush mode is active. + The attribute is read-write. + +What: /sys/bus/platform/drivers/ufshcd/*/flags/wb_unpin_enable +What: /sys/bus/platform/devices/*.ufs/flags/wb_unpin_enable +Date: June 2026 +Contact: Daniel Lee <[email protected]> +Description: This entry controls the Pinned WriteBooster unpin enable flag (fUnpinEn). + + ====== ============================================================== + 0 Unpin Disable: pinned data is not flushed by WriteBooster + Buffer flush operation. + 1 Unpin Enable: pinned data is flushed by WriteBooster + Buffer flush operation. + ====== ============================================================== + + The attribute is read-write.
drivers/ufs/core/ufs-sysfs.c +248 -63
375 lines not on this page · raw message
include/ufs/ufs.h +17 -0
@@ -146,6 +146,7 @@ enum flag_idn {QUERY_FLAG_IDN_WB_BUFF_FLUSH_DURING_HIBERN8 =0x10 ,QUERY_FLAG_IDN_HPB_RESET =0x11 ,QUERY_FLAG_IDN_HPB_EN =0x12 , + QUERY_FLAG_IDN_WB_UNPIN_EN = 0x13, };/* Attribute idn for Query requests */
@@ -191,6 +192,14 @@ enum attr_idn {QUERY_ATTR_IDN_WB_BUF_RESIZE_HINT =0x3C ,QUERY_ATTR_IDN_WB_BUF_RESIZE_EN =0x3D ,QUERY_ATTR_IDN_WB_BUF_RESIZE_STATUS =0x3E , +QUERY_ATTR_IDN_WB_PFM =0x3F , +QUERY_ATTR_IDN_MAX_FIFO_SIZE_WB_PFM =0x40 , +QUERY_ATTR_IDN_CURRENT_FIFO_SIZE_WB_PFM =0x41 , +QUERY_ATTR_IDN_PINNED_WB_CURRENT_SIZE =0x42 , +QUERY_ATTR_IDN_PINNED_WB_AVAIL_PERC =0x43 , +QUERY_ATTR_IDN_PINNED_WB_CUMMULATIVE_WS =0x44 , +QUERY_ATTR_IDN_PINNED_WB_SIZE =0x45 , +QUERY_ATTR_IDN_NON_PINNED_WB_MIN_SIZE =0x46 ,QUERY_ATTR_IDN_TX_EQ_GN_SETTINGS =0x47 , QUERY_ATTR_IDN_TX_EQ_GN_SETTINGS_EXT = 0x48, };
@@ -401,6 +410,14 @@ enum { UFS_DEV_WB_BUF_RESIZE = BIT(0), }; +/* Possible values for bWriteBoosterBufferPartialFlushMode */ +enum wb_partial_flush_mode { +WB_PARTIAL_FLUSH_NONE =0 , +WB_PARTIAL_FLUSH_FIFO =1 , +WB_PARTIAL_FLUSH_PINNED =2 , +NUM_WB_PARTIAL_FLUSH_MODES =3 , +}; +/* Possible values for dExtendedUFSFeaturesSupport */ enum {UFS_DEV_HIGH_TEMP_NOTIF =BIT (4 ),
Signature · 1 line
2.54.0.1136.gdb2ca164c4-goog
[email protected]
AI reviewThank you for your contribution! Sashiko AI review found 1 potential issue(s) to consider:
Thank you for your contribution! Sashiko AI review found 1 potential issue(s) to consider:
Pre-existing issues:
- [High] Unhandled pm_runtime_get_sync error leads to potential hardware access on suspended device --
commit 75ac0206b35904f19c6179a4c935e644238e4421
Author: Daniel Lee <[email protected]>
Subject: ufs: sysfs: Add WB partial flush mode support
This commit adds sysfs entries for JEDEC UFS 4.1 Extended WriteBooster attributes and flags to support FIFO and Pinned partial flush modes. It introduces UFS_ATTRIBUTE_RW and UFS_FLAG_RW macros to support writable attributes and flags.
Quoted 4 lines
drivers/ufs/core/ufs-sysfs.c +0
-0
[ ... ]
Quoted 20 lines
drivers/ufs/core/ufs-sysfs.c +14
-2@@ -1527,41 +1533,94 @@ static const struct attribute_group ufs_sysfs_string_descriptors_group = {static inline bool ufshcd_is_wb_flags (enum flag_idn idn) { -return idn >=QUERY_FLAG_IDN_WB_EN && - idn <=QUERY_FLAG_IDN_WB_BUFF_FLUSH_DURING_HIBERN8 ; +return (idn >=QUERY_FLAG_IDN_WB_EN && + idn <=QUERY_FLAG_IDN_WB_BUFF_FLUSH_DURING_HIBERN8 ) || + idn ==QUERY_FLAG_IDN_WB_UNPIN_EN ; +} + +static ssize_t ufs_sysfs_flag_show (struct device *dev, +struct device_attribute *attr,char *buf,enum flag_idn idn) +{ +struct ufs_hba *hba =dev_get_drvdata (dev); +u8 index =0 ; +bool flag; +int ret; + +down (&hba->host_sem);
drivers/ufs/core/ufs-sysfs.c static const struct attribute_group ufs_sysfs_string_descriptors_group = { · line 1559
Quoted 10 lines
drivers/ufs/core/ufs-sysfs.c +10
-0+if (!ufshcd_is_user_access_allowed (hba)) { +up (&hba->host_sem); +return -EBUSY ; + } +if (ufshcd_is_wb_flags (idn)) + index =ufshcd_wb_get_query_index (hba); +ufshcd_rpm_get_sync (hba); + ret =ufshcd_query_flag (hba,UPIU_QUERY_OPCODE_READ_FLAG , + idn, index, &flag); +ufshcd_rpm_put_sync (hba);
[Severity: High]
This isn't a bug introduced by this patch, but this newly refactored function ignores the return value of ufshcd_rpm_get_sync(). If the device W-LUN and underlying HBA fail to resume from runtime suspend (returning a negative error code), does it make sense to blindly proceed to call ufshcd_query_flag()?
Writing to or accessing MMIO registers of an unclocked or unpowered UFS controller can trigger a synchronous external abort or PCI master abort.
[ ... ]
Quoted 7 lines
drivers/ufs/core/ufs-sysfs.c +3
-0@@ -1804,6 +1916,71 @@ UFS_ATTRIBUTE(wb_avail_buf, _AVAIL_WB_BUFF_SIZE);UFS_ATTRIBUTE (wb_life_time_est, _WB_BUFF_LIFE_TIME_EST);UFS_ATTRIBUTE (wb_cur_buf, _CURR_WB_BUFF_SIZE); +static ssize_t wb_partial_flush_mode_show (struct device *dev, +struct device_attribute *attr,char *buf) +{
[ ... ]
drivers/ufs/core/ufs-sysfs.c UFS_ATTRIBUTE(wb_avail_buf, _AVAIL_WB_BUFF_SIZE); · line 1935
Quoted 10 lines
drivers/ufs/core/ufs-sysfs.c +10
-0+down (&hba->host_sem); +if (!ufshcd_is_user_access_allowed (hba)) { +up (&hba->host_sem); +return -EBUSY ; + } +ufshcd_rpm_get_sync (hba); + ret =ufshcd_query_attr (hba,UPIU_QUERY_OPCODE_READ_ATTR , +QUERY_ATTR_IDN_WB_PFM ,ufshcd_wb_get_query_index (hba),0 , &value); +ufshcd_rpm_put_sync (hba); +up (&hba->host_sem);
[Severity: High]
This is a pre-existing issue in the older sysfs macros that has been propagated here to the newly created functions. Should we check the return value of ufshcd_rpm_get_sync() here as well? The same pattern is present in wb_partial_flush_mode_store(), ufs_sysfs_attr_show(), ufs_sysfs_attr_store(), and ufs_sysfs_flag_store().
Signature · 1 line
Sashiko AI review · https://sashiko.dev/#/patchset/[email protected]?part=1