Changes in v5:
v5 cover Changes in v5:
According to Tom's remarks
- Improve the help structure and content.
- Mark functions as static.
- Remove documentation of exported functions
- As asked, addded a kernel doc to:
ufshcd_query_desc_idn_geometry, ufshcd_query_desc_idn_config, ufshcd_query_desc_idn_device, ufshcd_query_desc_idn_unit, ufshcd_print_idn_geometry_desc, ufshcd_print_device_descriptor ufshcd_print_unit_descriptor, ufshcd_query_desc_idn_power ufshcd_print_ufs_power_params, ufshcd_query_user_flag
- Add command get_lun
- Add command clear_lun
- Add command provision
- Removed float use in the code, it breaks arm compilation.
- Add wmb. wmb is not implemented in x86, brakes the UFS compilation in x86.
- Test: ./tools/buildman/buildman mips64el arm x86_64 -a UFS -a CMD_UFS -a SCSI -a CMDLINE Passed 94 boards, but consumed too much time and could not continue.
- I stil fail to run on gitab ci, My adminitratos do not know how to
help me, i have no runners.
- github does not work as well, no runners. I do not have Azure acount.
- Link to v4: https://patch.msgid.link/[email protected]
Changes in v4:
Apply Tom's remarks.
- move exported functions from drivers/ufs/ufs.h to include/ufs.h
- document the above exported functions in kernel-doc style.
- Fix commit title: "extend the current command line..."
- rework rst file, verified the html version.
- Run pull request in CI.
- Link to v3: https://patch.msgid.link/[email protected]
Changes in v3:
- remove set_dev_desc command. DeviceDescriptor is not writable
- Beautify the rst document
- Link to v2: https://patch.msgid.link/[email protected]
ufs: Exted cmd line
The UFS command provides utilities for querying, displaying, and modifying UFS device configuration and descriptor information. It is commonly used to configure UFS logical units (LUNs) in U-Boot, allowing storage devices to be provisioned and reconfigured as needed.
Features:
* Display Device, Geometry, Unit, Configuration, and Power Descriptors
* Display LUN configuration and calculated capacities
* Modify fields in Device, Configuration, and Unit Descriptors
* Query common UFS runtime flags
* Commit configuration changes or clear all LUN configurations
* Decode and format descriptor contents for easier debugging
* Provision and configure UFS logical units
Changes in v2:
* Add HBA ID support
* Move ufs_tool.c to cmd/ufs.c
* Add myself as reviewer
* Rename patch subject to "ufs: document the UFS command"
Cc: Neil Armstrong <[email protected]> Cc: Bhupesh Sharma <[email protected]> Cc: Neha Malcom Francis <[email protected]> Cc: Tawfik Bayouk <[email protected]> Cc: Vladimir Kondratiev <[email protected]>
---
Raz Ben Yehuda (5):
MAINTAINERS: Add myself to the list of UFS maintainers
ufs: Expose selected UFS functions
ufs: document the UFS command
ufs: extend the current command-line interface
ufs: wmb is not implemented in x86.
MAINTAINERS | 3 + arch/x86/include/asm/io.h | 2 + cmd/ufs.c | 1612 ++++++++++++++++++++++++++++++++++++++++++++- doc/usage/cmd/ufs.rst | 499 ++++++++++++++ drivers/ufs/ufs-uclass.c | 18 +- drivers/ufs/ufs.h | 52 -- include/ufs.h | 421 ++++++++++++ 7 files changed, 2536 insertions(+), 71 deletions(-)
---
base-commit: 0c035ff60c1e8caee7fccd2673ce75380dee825b
change-id: 20260607-ufs_tool2-11c3493690c4
Best regards,
Signature · 1 line
Raz Ben Yehuda <[email protected]>
PATCH v5 1/5 MAINTAINERS: Add myself to the list of UFS maintainers
Adding myself to ufs.
--- MAINTAINERS | 3 +++ 1 file changed, 3 insertions(+)
MAINTAINERS +3 -0
@@ -1920,8 +1920,11 @@ UFS M: Neil Armstrong <[email protected]> M: Bhupesh Sharma <[email protected]> M: Neha Malcom Francis <[email protected]> +R: Raz Ben Yehuda <[email protected]> S: Maintained +F: cmd/ufs.c F: common/spl/spl_ufs.c +F: doc/usage/cmd/ufs.rst F: drivers/ufs/ UPL
Signature · 1 line
2.43.0
PATCH v5 2/5 ufs: Expose selected UFS functions
In reply to Raz Ben YehudaRemove the static qualifier from selected functions to allow future reuse. Add flags according to UFS 3.1.
--- drivers/ufs/ufs-uclass.c | 18 +- drivers/ufs/ufs.h | 52 ------ include/ufs.h | 421 +++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 430 insertions(+), 61 deletions(-)
drivers/ufs/ufs-uclass.c +9 -9
@@ -757,7 +757,7 @@ static inline u8 ufshcd_get_upmcrs(struct ufs_hba *hba)* * Flush cache in aligned address..address+size range. */ -static void ufshcd_cache_flush (void *addr,unsigned long size) +void ufshcd_cache_flush (void *addr,unsigned long size) {uintptr_t start_addr = (uintptr_t )addr & ~(ARCH_DMA_MINALIGN -1 );uintptr_t end_addr =ALIGN ((uintptr_t )addr + size,ARCH_DMA_MINALIGN );
@@ -1089,8 +1089,8 @@ static inline void ufshcd_init_query(struct ufs_hba *hba,/** * ufshcd_query_flag() - API function for sending flag query requests */ -static int ufshcd_query_flag (struct ufs_hba *hba,enum query_opcode opcode, -enum flag_idn idn,bool *flag_res) +int ufshcd_query_flag (struct ufs_hba *hba,enum query_opcode opcode, +enum flag_idn idn,bool *flag_res) {struct ufs_query_req *request =NULL ;struct ufs_query_res *response =NULL ;
@@ -1320,9 +1320,9 @@ out:/** * ufshcd_query_descriptor_retry - API function for sending descriptor requests */ -static int ufshcd_query_descriptor_retry (struct ufs_hba *hba,enum query_opcode opcode, -enum desc_idn idn,u8 index,u8 selector, -u8 *desc_buf,int *buf_len) +int ufshcd_query_descriptor_retry (struct ufs_hba *hba,enum query_opcode opcode, +enum desc_idn idn,u8 index,u8 selector, +u8 *desc_buf,int *buf_len) {int err;int retries;
@@ -1457,9 +1457,9 @@ static int ufshcd_map_desc_id_to_length(struct ufs_hba *hba, enum desc_idn desc_* ufshcd_read_desc_param - read the specified descriptor parameter * */ -static int ufshcd_read_desc_param (struct ufs_hba *hba,enum desc_idn desc_id, -int desc_index,u8 param_offset, -u8 *param_read_buf,u8 param_size) +int ufshcd_read_desc_param (struct ufs_hba *hba,enum desc_idn desc_id, +int desc_index,u8 param_offset, +u8 *param_read_buf,u8 param_size) {int ret;u8 *desc_buf;
drivers/ufs/ufs.h +0 -52
76 lines not on this page · raw message
include/ufs.h +421 -0
431 lines not on this page · raw message
Signature · 1 line
2.43.0
PATCH v5 3/5 ufs: document the UFS command
In reply to Raz Ben YehudaAdd documentation for the UFS command-line interface.
The document describes the available UFS subcommands and their usage, and provides a complete command-line reference for configuring and managing UFS devices.
--- doc/usage/cmd/ufs.rst | 499 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 499 insertions(+)
doc/usage/cmd/ufs.rst new file +499 -0
@@ -0,0 +1,499 @@ +.. SPDX-License-Identifier: GPL-2.0+ + +.. index:: + single: ufs (command) + +ufs command +=========== + +Synopsis +-------- + +:: + + ufs query <idn> [lun] + ufs set_cfg_desc <lun> <parameter> <value> + ufs get_cfg_desc + ufs get_flag <flag> + ufs set_hba <hbaid> + ufs init + ufs commit + ufs clearall + ufs luns + ufs set_lun <lun> <parm> <value> + ufs get_lun <lun> + ufs clear_lun + +Query Description +------------------ + +The ``ufs`` command is used to query, display and modify Universal Flash +Storage (UFS) device configuration and descriptor information. + +The ``ufs query`` command displays UFS descriptors. + +:: + + ufs query <idn> [lun] + + idn + Descriptor identifier. + + ===== ================================= + Value Descriptor + ===== ================================= + 0x00 Device Descriptor + 0x01 Configuration Descriptor + 0x02 Unit Descriptor + 0x07 Geometry Descriptor + 0x08 Power Descriptor + ===== ================================= + + + LUN Required only for Unit Descriptor (IDN 0x02). + + +Descriptor Information +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Queries for descriptors always require direct access to the controller. + + +Device Descriptor (IDN 0x00) +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +The Device Descriptor contains general information about the UFS device, +including: + +* Device identification +* Manufacturer information +* Product name and revision +* Number of logical units +* Queue depth +* Boot configuration +* WriteBooster capabilities +* Supported UFS features + ... + +Example: + +:: + + => ufs query 0 + + Name | Value | Description + --------------------------- + Length | 0x59 + DescriptorIdn | 0x0 + Device | 0x0 + DeviceClass | 0x0 + DeviceSubClass | 0x0 + protocol | 0x0 + NumberLu | 0 + NumberWLu | 4 + BootEnable | 0x1 + DescrAccessEn | 0x1 + + ... + + +Geometry Descriptor (IDN 0x07) +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +The Geometry Descriptor provides information about the physical layout +and capabilities of the device, including: + +* Total raw device capacity +* Maximum number of logical units +* Allocation unit size +* Segment size +* Supported memory types +* RPMB capabilities +* Secure removal support +* WriteBooster limits + +Example: + +:: + + => ufs query 7 + + Name | Value | Description + --------------------------------------------- + Length | 0x57 | Size of descriptor + DescriptorIdn | 0x7 | geometry Descriptor ID + MediaTechnology | 0x0 | Reserved (00h) + TotalRawDeviceCapacity | 119 GB + MaxNumberLu | 1 | Max LUs (00h: 8, 01h: 32) + SegmentSize | 8192 | Segment size (512B units) + AllocationunitSize | 1 | Alloc unit size (in segments) + ... + + +Unit Descriptor (IDN 0x02) +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +The Unit Descriptor contains information about a specific Logical Unit +(LUN), including: + +* LUN enable state +* Boot LUN assignment +* Write protection configuration +* Memory type +* Logical block size +* Provisioning type +* Data reliability settings +* WriteBooster allocation + +Example: + +:: + + => ufs query 2 3 + + --- UFS unit Descriptor (IDN: 02h) --- + Name | Value | Description + --------------------------------------------- + Length | 45 | Size of descriptor + DescriptorIdn | 0x2 | unit Descriptor ID + BunitIndex | 0x3 | Logical unit Index + luEnable | 0x0 | LU Enabled (01h) or Disabled (00h) + BootLunId | 0x0| Boot LU ID (01h: A, 02h: B + luWriteProtect | 0x0 | WP (01h: power-on, 02h: Perm) + luQueueDepth | 0x0 | Queue depth (0 if shared) + ... + + +Power Descriptor (IDN 0x08) +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Queries command of Power IDN. + +:: + + => ufs query 8 + --- UFS power Parameters Descriptor (IDN: 08h) --- + + Descriptor Length: 0x62 (98 bytes) + Descriptor IDN: 0x8 + + Level | VCC Current | VCCQ Current | VCCQ2 Current + -------------------------------------------------- + 0 | 0 n_a | 0 n_a | 0 n_a + 1 | 0 n_a | 0 n_a | 0 n_a + 2 | 0 n_a | 0 n_a | 0 n_a + 3 | 0 n_a | 0 n_a | 0 n_a + 4 | 0 n_a | 0 n_a | 0 n_a + + + +Configuration Descriptor (IDN 0x01) +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +The Configuration Descriptor defines the layout and configuration +of all Logical Units on the device. This query reads the descriptor +from the controller and caches it. The cached descriptor is used +exclusively by configuration commands, +including get_lun, clear_lun, set_cfg_desc, get_cfg_desc, +set_lun, clear_lun, get_lun, and commit. +The ufs command does not use ufs staging, because in some extreme +cases (ex. P/E consumed) staging fails. + +It contains: + +* Boot configuration +* RPMB configuration +* WriteBooster settings +* Logical Unit definitions +* Allocation unit assignments + +etc.. + +Example: + +:: + + => ufs query 1 + Config Descriptor: (0x00000008ffff6628) + Length : 0x0e6 + DescriptorIdn : 0x01 + ConfDescContinue : 0x00 + BootEnable : 0x01 + DescrAccess_en : 0x01 + InitPowerMode : 0x01 + HighPriorityLun : 0x07f + SecureRemovalType : 0x02 + InitActiveIccLevel : 0x01 + PeriodicRtcUpdate : 0x00 + Reserved_HPB : 0x00 + RpmbRegionEnable : 0x00 + RpmbRegion1Size : 0x00 + RpmbRegion2Size : 0x00 + RpmbRegion3Size : 0x00 + WriteBoosterBufferPreserveUserSpaceEN : 0x01 + WriteBoosterBufferType : 0x00 + NumSharedWriteBoosterBufferAllocUnits : 0x00 + ------------------------------------------------- + LUN 0 Capacity 16 MB + Name | Value | Description + ------------------------------------------------- + LuEnable | 0x1 | Enabled, 00h: Disabled + BootLunId | 0x1 | Boot LU A, 02h: Boot LU B + LuWriteProtect | 0x0 | power-on, 02h: Permanent + MemoryType| 0x3 | Normal, 01h: System Code + NumAllocunits | 12 | Number of Allocation units for LU + DataReliability | 0x1 | power failure protection + LogicalBlockSize | 0xc | Block size exponent (Min: 0Ch) + ProvisioningType | 0x0 | Full, 02h/03h: Thin + ... + + +Examining a LUN +---------------------- + +The command get_lun reports a lun from the Cached Configuration descriptor. + +Example: + +:: + + + => ufs get_lun 1 + + LuEnable | 0x1 | Enabled, 00h: Disabled + BootLunId | 0x2 | Boot LU A, 02h: Boot LU B + LuWriteProtect | 0x0 | power-on, 02h: Permanent + MemoryType| 0x3 | Normal, 01h: System Code + NumAllocunits | 12 | Number of Allocation units for LU + DataReliability | 0x1 | power failure protection + LogicalBlockSize | 0xc | Block size exponent (Min: 0Ch) + ProvisioningType | 0x0 | Full, 02h/03h: Thin + ContextCapabilities | 0x0 | LU Context support/multipliers + LuNumWriteBoosterBufferAllocunits| 16777220 | WB Buffer size + + +Creating a LUN +---------------------- + +The command set_lun updates a LUN configuration. It does not write the +LUN to the controller. +A Lun must be enabled for it become a scsi disk. +To write to the controller issue the command ufs commmit. + + + ufs set_lun <lun> <parameter> <value> + +Supported parameters + * lu_enable + * boot_lun_id + * lu_write_protect + * memory_type + * data_reliability + * num_allocunits + * logical_block_size + * provisioning_type + * context_capabilities + * lu_num_write_booster_buffer_allocunits + +Example: + +:: + + => ufs set_lun 0 num_allocunits 4 + + LuEnable | 0x0 | Enabled, 00h: Disabled + BootLunId | 0x1 | Boot LU A, 02h: Boot LU B + LuWriteProtect | 0x0 | power-on, 02h: Permanent + MemoryType| 0x3 | Normal, 01h: System Code + NumAllocunits | 4 | Number of Allocation units for LU + DataReliability | 0x1 | power failure protection + LogicalBlockSize | 0xc | Block size exponent (Min: 0Ch) + ProvisioningType | 0x0 | Full, 02h/03h: Thin + ContextCapabilities | 0x0 | LU Context support/multipliers + LuNumWriteBoosterBufferAllocunits| 16908291 | WB Buffer size + + +Getting A flag +------------------ +The command get_flag retrieves a flag value.. + ufs get_flag <parameter> + +Supported flags:: + * deviceinit + * permanent_wpe + * pwr_on_wpe + * bkops_en + * life_span_mode + * purge_enable + * fphy_resource_removal + * busy_rtc + * permanently_disable_fw_update + * write_booster_en + * wb_buf_flush_en + * wb_buf_flush_h8 + +Example: + +:: + + => ufs getflag bkops_en + bkops_en = 1 + + +Configuration Descriptor +----------------------------------------- + ufs set_cfg_desc [parameter] [value] + +Supported parameters:: + * length + * descriptor_idn + * conf_desc_continue + * boot_enable + * descr_access_en + * initpower_mode + * high_priority_lun + * secure_removal_type + * init_active_icc_level + * periodic_rtc_update + * reserved_HPB + * rpmb_region_enable + * rpmb_region1_size + * rpmb_region2_size + * rpmb_region3_size + * write_booster_buffer_preserve_user_space_en + * write_booster_buffer_type + * num_shared_write_booster_buffer_allocunits + +Example: + +:: + + => ufs set_cfg_desc num_shared_write_booster_buffer_allocunits 100 + + +Luns Info +----------------------------- + +The command ufs luns prints the current enabled LUNs stored in the controller. + +Example: + +:: + + => ufs luns + + + | LUN 0 | LUN 1 | LUN 2 | LUN 3 | LUN 4 | + | 3 MB | 10 MB | 1 MB | 2312 MB | 114364 MB | + + +Clear all LUNs +----------------------------- + + +The command ufs clearall, clears all LUNs, and auto-commit the zeroed LUNs +to the controller. + +Clear LUN +----------------------------- + + +The command ufs clear_lun, +set all fields to zero other than the block size. +The lun is cleared in the cached configuration descriptor. + +Delete LUN +----------------------------- + +To delete a lun use : ufs set_lun <lun> lu_enable 0 +and then ufs commit. + + +Set HBA ID +---------------------- + + + ufs set_hba [hbaid] + +Use an hba id differs from 0. + + +Init +---------------------- + + ufs init + +Initialize the HBA controller. This command is not necessary and +used for debugging. +All other commands initializes the HBA controller automatically +if required. + +Commit +---------------------- + + ufs commit + +The command ufs commit writes the current configuration descriptor +to the controller. In case the configuration is incorrect, the commit +will fail. Ufs commit is usually done after creating a lun. + +Provisioning workflow +---------------------- + +Source system +~~~~~~~~~~~~~~~ + +1. Display the Configuration Descriptor:: + + ufs query 1 + +:: + + => ufs query 1 + Config Descriptor: (0x00000008ffff6628) + ... + +The output includes the Configuration Descriptor address and size. + +2. Save the Configuration Descriptor to a file:: + + tftpput <cfg_desc_addr> <size> <filename> + + Example:: + + tftpput 0x00000008ffff6628 0xe6 luns.bin + +This exports the current UFS configuration, including LUN settings. + +Target system +^^^^^^^^^^^^^ + + +1. Load the configuration file into the Configuration Descriptor buffer + using XMODEM or TFTP: + + +:: + + loadx + ## Ready for binary (xmodem) download to 0x860000000 at 921600 bps... + + or: + + tftpget luns.bin + + +3. Overwrite + + :: + + ufs provision 0x860000000 + +To overwrite luns.bin over the Configuration descriptor. + +4. Commit the configuration to the UFS device: + +:: + + ufs commit + +The imported Configuration Descriptor is written to the device and +becomes active after the commit operation completes.
Signature · 1 line
2.43.0
PATCH v5 4/5 ufs: extend the current command-line interface
In reply to Raz Ben YehudaExtend the ufs command line. Provide techniques for querying, displaying, and modifying UFS device configuration and descriptor information.
Features:
- Query and display Device, Geometry, Unit, Configuration, and Power Descriptors
- Display LUN configuration and calculated capacities
- Modify LUN, Configuration, and Device Descriptor fields
- Query common UFS runtime flags
- Commit configuration changes or clear all LUN configurations
- Decode and format descriptor contents for easier debugging
- Clear all luns
--- cmd/ufs.c | 1612 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 1602 insertions(+), 10 deletions(-)
cmd/ufs.c +1602 -10
@@ -3,13 +3,1504 @@* ufs.c - UFS specific U-Boot commands * * Copyright (C) 2019 Texas Instruments Incorporated - https://www.ti.com -* +* Copyright (C) 2026 Mobileye Incorporated - https://www.mobileye.com */ + +#include <dm/uclass.h> +#include <dm/device.h> #include <command.h> +#include <malloc.h> +#include <linux/math64.h> #include <ufs.h> -#include <vsprintf.h> -#include <linux/string.h> +static struct ufs_config_desc g_cfg_desc; +static int hba_id; + +/** +* ufstool_probe_dev() - Get a UFS HBA instance +* @index: UFS device index +* +* Retrieves the UFS host bus adapter associated with @index. +* +* Return: Pointer to the UFS HBA on success, or NULL on failure. +*/ +static struct ufs_hba *ufstool_probe_dev (int index) +{ +struct udevice *dev; +struct ufs_hba *hba =NULL ; + +if (!uclass_get_device (UCLASS_UFS , index, &dev)) + hba =dev_get_uclass_priv (dev); + +return hba; +} + +/** +* +* ufshcd_query_desc_idn_device() - Read the UFS Device Descriptor +* @hba: UFS host bus adapter instance +* @desc: Pointer to device descriptor buffer +* +* Reads the Device Descriptor (IDN 0x00) from the attached UFS device +* and stores the contents in @desc. +* +* Return: 0 on success, negative error code on failure. +*/ +static int ufshcd_query_desc_device (struct ufs_hba *hba, +struct ufs_device_desc *desc) +{ +int param_offset =0 ; +int desc_index =0 ;/* LUNS 0-7 controlled by index 0 */ + +return ufshcd_read_desc_param (hba,QUERY_DESC_IDN_DEVICE , desc_index, + param_offset, (void *)desc, +UFS_DESC_SIZE ); +} + +/** +* ufshcd_query_desc_geometry() - Read the UFS Geometry Descriptor +* @hba: UFS host bus adapter instance +* @desc: Pointer to geometry descriptor buffer +* +* Reads the Geometry Descriptor (IDN 0x07) from the attached UFS device +* and stores the contents in @desc. +* +* Return: 0 on success, negative error code on failure. +*/ +static int ufshcd_query_desc_geometry (struct ufs_hba *hba, +struct ufs_geometry_desc *desc) +{ +int param_offset =0 ; +int desc_index =0 ; + +return ufshcd_read_desc_param (hba,QUERY_DESC_IDN_GEOMETRY , desc_index, + param_offset, (void *)desc, +QUERY_DESC_GEOMETRY_DEF_SIZE ); +} + +/** +* ufshcd_query_desc_config() - Read the UFS Configuration Descriptor +* @hba: UFS host bus adapter instance +* @cfg: Pointer to configuration descriptor buffer +* +* Reads the Configuration Descriptor (IDN 0x01) from the attached UFS +* device and stores the contents in @cfg. +* +* Return: 0 on success, negative error code on failure. +*/ +static int ufshcd_query_desc_config (struct ufs_hba *hba, +struct ufs_config_desc *cfg) +{ +int param_offset =0 ; +int desc_index =0 ; +int ret; + + ret =ufshcd_read_desc_param (hba,QUERY_DESC_IDN_CONFIGURATION , + desc_index, param_offset, + (void *)cfg, +QUERY_DESC_CONFIGURATION_DEF_SIZE ); +if (ret) +log_err ("Failed to read config\n" ); + +return ret; +} + +/** +* ufshcd_query_desc_power() - Read a UFS Power Parameters Descriptor +* @hba: UFS host bus adapter instance +* @lun: Logical unit number associated with the descriptor query +* @desc: Pointer to power parameters descriptor buffer +* +* Reads the Power Parameters Descriptor (IDN 0x08) from the attached +* UFS device and stores the contents in @desc. +* +* Return: 0 on success, negative error code on failure +*/ +static int ufshcd_query_desc_power (struct ufs_hba *hba,int lun, +struct ufs_power_param_desc *desc) +{ +int ret; + + ret =ufshcd_read_desc_param (hba,QUERY_DESC_IDN_POWER , + lun,0 , (void *)desc,QUERY_DESC_POWER_DEF_SIZE ); + +if (ret) { +log_err ("Err: UFS power Descriptor" ); +return ret; + } + +return ret; +} + +/** +* ufshcd_query_desc__unit() - Read a UFS Unit Descriptor +* @hba: UFS host bus adapter instance +* @lun: Logical unit number +* @desc: Pointer to unit descriptor buffer +* +* Reads the Unit Descriptor (IDN 0x02) associated with @lun and stores +* the contents in @desc. +* +* Return: 0 on success, negative error code on failure. +*/ +static int ufshcd_query_desc_unit (struct ufs_hba *hba,int lun, +struct ufs_unit_desc *desc) +{ +int ret; + + ret =ufshcd_read_desc_param (hba,QUERY_DESC_IDN_UNIT , lun,0 , + (void *)desc,QUERY_DESC_UNIT_DEF_SIZE ); +if (ret) { +log_err ("Err: UFS unit Descriptor" ); +return ret; + } + +return ret; +} + +/** +* ufshcd_print_device_descriptor() - Print a UFS Device Descriptor +* @desc: Device descriptor to display +* +* Prints the contents of a Device Descriptor in a human-readable format. +*/ +static void ufshcd_print_device_descriptor (struct ufs_device_desc *descriptor) +{ +u32 val = descriptor->num_shared_write_booster_buffer_allocunits; + +printf ("--- UFS Device Descriptor (IDN: 00h) ---\n" ); + +printf (" Name | Value | Description\n" ); +printf ("-----------------------------------------------------------\n" ); +/* Descriptor Header (Offset 00h – 01h) */ +printf ("Length | 0x%x\n" , descriptor->length); +printf ("DescriptorIdn | 0x%x\n" , descriptor->descriptor_idn); + +/* Device Identification & Core configuration (Offset 02h – 0Dh) */ +printf ("Device | 0x%x\n" , descriptor->device); +printf ("DeviceClass | 0x%x\n" , descriptor->device_class); +printf ("DeviceSubClass | 0x%x\n" , descriptor->device_sub_class); +printf ("protocol | 0x%x\n" , descriptor->protocol); +printf ("NumberLu | %d\n" , descriptor->number_lu); +printf ("NumberWLu | %d\n" , descriptor->number_wlu); +printf ("BootEnable | 0x%x\n" , descriptor->boot_enable); +printf ("DescrAccessEn | 0x%x\n" , descriptor->descr_access_en); +printf ("InitPowerMode | 0x%x\n" , descriptor->init_power_mode); +printf ("highPriorityLun | 0x%x\n" , + descriptor->high_priority_lun); +printf ("SecureRemovalType | 0x%x\n" , + descriptor->secure_removal_type); +printf ("SecurityLu | 0x%x\n" , descriptor->security_lu); + +/* power Management, Version & Pointers (Offset 0Eh – 2Ah) */ +printf ("b_background_ops_term_lat | 0x%x\n" , + descriptor->background_ops_term_lat); +printf ("b_init_active_icc_level | 0x%x\n" , + descriptor->init_active_icc_level); +printf ("SpecVersion | 0x%x\n" , +__builtin_bswap16 (descriptor->spec_version)); +printf ("ManufactureDate | 0x%x\n" , descriptor->manufacture_date); +printf ("ManufacturerName | 0x%x\n" , descriptor->manufacturer_name); +printf ("ProductName | 0x%x\n" , descriptor->product_name); +printf ("SerialNumber | 0x%x\n" , descriptor->serial_number); +printf ("OEMId | 0x%x\n" , descriptor->oem_id); +printf ("ManufacturerId | 0x%x\n" , descriptor->manufacturer_id); +printf ("Ud0BaseOffset | %d\n" , descriptor->ud0_base_offset); +printf ("DConfigLength | %d\n" , + descriptor->config_length); +printf ("DeviceRttCap | 0x%x\n" , descriptor->device_rtt_cap); +printf ("PeriodicRtcUpdate | 0x%x\n" , + descriptor->periodic_rtc_update); +printf ("UfsFeaturesSupport | 0x%x\n" , + descriptor->ufs_features_support); +printf ("FfuTimeout | %d\n" , descriptor->ffu_timeout); +printf ("QueueDepth | %d\n" , descriptor->queue_depth); +printf ("DeviceVersion | 0x%x\n" , descriptor->device_version); +printf ("NumSecureWpArea | 0x%x\n" , + descriptor->num_secure_wp_area); +printf ("PsaMaxDataSize | 0x%x\n" , + descriptor->psa_max_data_size); +printf ("PsaStateTimeout | 0x%x\n" , + descriptor->psa_state_timeout); +printf ("ProductRevisionLevel | 0x%x\n" , + descriptor->product_revision_level); + +/* Extended Features (Offset 4Fh – 58h) */ +printf ("ExtendedUfsFeaturesSupport " ); +printf ("| 0x%x |(includes WriteBooster/Throttling)\n" , +be32_to_cpu (descriptor->extended_ufs_features_support)); + +printf ("WriteBoosterBufferPreserveUserSpaceEn" ); +printf ("| 0x%x | Preserve User Space mode for WriteBooster Buffer\n" , + descriptor->write_booster_buffer_preserve_user_space_en); + +printf ("write booster buffer type" ); +printf ("| 0x%x | WriteBooster Buffer Type" , + descriptor->write_booster_buffer_type); +puts ("(00h: LU dedicated, 01h: shared)\n" ); + +printf ("NumSharedWriteBooster_buffer_allocunits |" ); +printf ("%d | Shared WriteBooster Buf size (in Allocation units)\n" , +be32_to_cpu (val)); +} + +/** +* +* ufshcd_print_idn_geometry_desc() - Print a UFS Geometry Descriptor +* @desc: Geometry descriptor to display +* +* Prints the contents of a Geometry Descriptor in a human-readable format. +*/ +static void ufshcd_print_idn_geometry_desc (struct ufs_geometry_desc *desc) +{ +u64 cap =be64_to_cpu (desc->total_raw_device_capacity); + + cap = ((cap <<9 ) >>30 ); + +printf ("--- UFS geometry Descriptor (IDN: 07h) ---\n" ); +printf (" Name | Value | Description\n" ); +printf ("-------------------------------------------------------\n" ); + +/* Header and Core Capacity (Offset 00h - 0Ch) */ +printf ("Length | 0x%x | Size of descriptor\n" , desc->length); +printf ("DescriptorIdn | 0x%x | geometry Descriptor ID\n" , + desc->descriptor_idn); +printf ("MediaTechnology | 0x%x | Reserved (00h)\n" , + desc->media_technology); + +printf ("TotalRawDeviceCapacity | %lld GB\n" , cap); + +printf ("MaxNumberLu | %d | Max LUs (00h: 8, 01h: 32)\n" , + desc->max_number_lu); + +/* Segment and Allocation unit constraints (Offset 0Dh - 12h) */ +printf ("SegmentSize | %d | Segment size (512B units)\n" , +be32_to_cpu (desc->segment_size)); + +printf ("AllocationunitSize | %d | Alloc unit size (in segments)\n" , + desc->allocationunit_size); + +printf ("MinAddrBlockSize | %d | Min addressable block size\n" , + desc->min_addr_block_size); + +/* Performance and Buffer parameters (Offset 13h - 17h) */ +printf ("OptimalReadBlockSize" ); +printf ("| %d | Optimal read size (512B units)\n" , + desc->optimal_read_block_size); + +printf ("OptimalWriteBlockSize " ); +printf ("| 0x%x | Optimal write size (512B units)\n" , + desc->optimal_write_block_size); + +printf ("MaxInBufferSize | 0x%x | Max Data-In buffer (512B units)\n" , + desc->max_in_buffer_size); + +printf ("MaxOutBufSize | 0x%x | Max Data-Out buffer (512B)\n" , + desc->max_out_buffer_size); + +printf ("bRPMBReadWriteSize | 0x%x | Max RPMB frames per command\n" , + desc->rpmb_read_write_size); + +/* Feature Support Bitmaps (Offset 18h - 1Fh) */ +printf ("DynamicCapacityResourcePolicy| 0x%x |" , + desc->dynamic_capacity_resource_policy); + +printf ("00h: per LU, 01h: per Memory Type\n" ); +printf ("DataOrdering | 0x%x | 01h: Out-of-order supported\n" , + desc->data_ordering); +printf ("MaxContexIdNumber | 0x%x | Max supported contexts (min 5)\n" , + desc->max_contex_id_number); + +printf ("SysDataTagUnitSize | 0x%x | System data tag granularity\n" , + desc->sys_data_tagunit_size); + +printf ("SysDataTagResSize | 0x%x | Max area for tagged system data\n" , + desc->sys_data_tag_res_size); + +printf ("SupportedSecRTypes | 0x%x | Supported secure removal types\n" , + desc->supported_sec_r_types); + +printf ("SupportedMemoryTypes | 0x%x | Bitmap of memory types\n" , +be16_to_cpu (desc->supported_memory_types)); +/* +* Memory Type Specific Capacities and Adjustment Factors +*/ +printf ("SystemCodeMaxNAlloc | 0x%x | Max Alloc units\n" , + desc->system_code_max_n_alloc_u); + +printf ("SystemCodeCapAdjFac | 0x%x | cap_adj_factor: System Code\n" , + desc->system_code_cap_adj_fac); + +printf ("NonPersistMaxNAlloc | 0x%x | Max Alloc units: Non-Persist\n" , + desc->non_persist_max_n_alloc_u); + +printf ("NonPersistCapAdjFac | 0x%x | cap_adj_factor: Non-Persist\n" , + desc->non_persist_cap_adj_fac); + +printf ("Enhanced1MaxNAlloc | %d | Max Alloc units: Enhanced 1\n" , +be32_to_cpu (desc->enhanced1_max_n_alloc_u)); + +printf ("Enhanced1CapAdjFac | %d | cap_adj_factor: Enhanced 1\n" , +be16_to_cpu (desc->enhanced1_cap_adj_fac)); + +printf ("Enhanced2MaxNAlloc_u | %d | Max Alloc units: Enhanced 2\n" , +be32_to_cpu (desc->enhanced2_max_n_alloc_u)); + +printf ("Enhanced2CapAdjFac | %d | cap_adj_factor: Enhanced 2\n" , +be16_to_cpu (desc->enhanced2_cap_adj_fac)); +printf ("Enhanced3MaxNAlloc | %d | Max Alloc units: Enhanced 3\n" , +be32_to_cpu (desc->enhanced3_max_n_alloc_u)); + +printf ("Enhanced3CapAdjFac | %d | cap_adj_factor: Enhanced 3\n" , +be32_to_cpu (desc->enhanced3_cap_adj_fac)); + +printf ("Enhanced4MaxNAlloc | %d | Max Alloc units: Enhanced 4\n" , +be32_to_cpu (desc->enhanced4_max_n_alloc_u)); + +printf ("Enhanced4CapAdjFac | %d | cap_adj_factor: Enhanced 4\n" , +be16_to_cpu (desc->enhanced4_cap_adj_fac)); + +/* Performance and WriteBooster (Offset 44h - 56h) */ +printf ("OptimalLogicalBlockSize | %d | Optimal Blk Size per type\n" , +be32_to_cpu (desc->optimal_logical_block_size)); + +printf ("WriteBoosterBufferMaxNAllocunits" ); +printf ("| %u | Max tot WB buf size\n" , +be32_to_cpu (desc->write_booster_buffer_max_alloc_units)); + +printf ("DeviceMaxWriteBoosterLus " ); +printf ("| %d | Max LUs supporting WB (MDV:1)\n" , + desc->device_max_write_booster_lus); + +printf ("WriteBoosterBufferCapAdjFac" ); +printf ("| %d | WB Capacity Adjustment Factor\n" , + desc->write_booster_buffer_capadjfac); + +printf ("SupportedwbBufferUserSpaceReductionType" ); +printf (" | 0x%x | Reduction/Preserve mode support\n" , + desc->supported_write_booster_buffer_userspace_reduction_types); + +printf ("SupportedWriteBoosterBufferTypes" ); +printf ("| 0x%x | 00h: LU based, 01h: Shared\n" , + desc->supported_write_booster_buffer_types); +} + +static void ufshcd_print_config_descriptor (const struct config_descriptor *cd) +{ +if (!cd) +return ; + +printf ("Config Descriptor: (0x%p)\n" , (void *)cd); +printf ("Length : 0x0%x\n" , cd->length); +printf ("DescriptorIdn : 0x0%x\n" , + cd->descriptor_idn); +printf ("ConfDescContinue : 0x0%x\n" , + cd->conf_desc_continue); + +printf ("BootEnable : 0x0%x\n" , + cd->boot_enable); +printf ("DescrAccess_en : 0x0%x\n" , + cd->descr_access_en); +printf ("InitPowerMode : 0x0%x\n" , + cd->initpower_mode); +printf ("HighPriorityLun : 0x0%x\n" , + cd->high_priority_lun); +printf ("SecureRemovalType : 0x0%x\n" , + cd->secure_removal_type); +printf ("InitActiveIccLevel : 0x0%x\n" , + cd->init_active_icc_level); +printf ("PeriodicRtcUpdate : 0x0%x\n" , + cd->periodic_rtc_update); +printf ("Reserved_HPB : 0x0%x\n" , + cd->reserved_HPB); + +printf ("RpmbRegionEnable : 0x0%x\n" , + cd->rpmb_region_enable); +printf ("RpmbRegion1Size : 0x0%x\n" , + cd->rpmb_region1_size); +printf ("RpmbRegion2Size : 0x0%x\n" , + cd->rpmb_region2_size); +printf ("RpmbRegion3Size : 0x0%x\n" , + cd->rpmb_region3_size); + +printf ("WriteBoosterBufferPreserveUserSpaceEN : 0x0%x\n" , + cd->write_booster_buffer_preserve_user_space_en); +printf ("WriteBoosterBufferType : 0x0%x\n" , + cd->write_booster_buffer_type); +printf ("NumSharedWriteBoosterBufferAllocUnits : %d\n" , +be32_to_cpu (cd->num_shared_write_booster_buffer_allocunits)); +} + +static void ufshcd_print_unit_param_descriptor (struct ufs_unit_cfg_parameters *unit) +{ +/* Header segment (Offset 00h - 03h) */ +printf ("LuEnable | 0x%x | Enabled, 00h: Disabled\n" , + unit->lu_enable); +printf ("BootLunId | 0x%x | Boot LU A, 02h: Boot LU B\n" , + unit->boot_lun_id); +printf ("LuWriteProtect | 0x%x | power-on, 02h: Permanent\n" , + unit->lu_write_protect); +printf ("MemoryType| 0x%x | Normal, 01h: System Code\n" , + unit->memory_type); +/* Allocation and Sizing (Offset 04h - 0Ah) */ +printf ("NumAllocunits | %d | Number of Allocation units for LU\n" , +be32_to_cpu (unit->num_allocunits)); +printf ("DataReliability | 0x%x | power failure protection\n" , + unit->data_reliability); +printf ("LogicalBlockSize | 0x%x | Block size exponent (Min: 0Ch)\n" , + unit->logical_block_size); +printf ("ProvisioningType | 0x%x | Full, 02h/03h: Thin\n" , + unit->provisioning_type); + +/* Context and HPB (Offset 0Bh - 15h) */ +puts ("ContextCapabilities" ); +printf (" | 0x%x | LU Context support/multipliers\n" , + unit->context_capabilities); +/* printf("Reserved | -- | Reserved\n"); */ +/* printf("Reserved (HPB) | -- | Reserved for HPB Extension\n"); */ +/* WriteBooster (Offset 16h) */ +printf ("LuNumWriteBoosterBufferAllocunits" ); +printf ("| %d | WB Buffer size (LUs 0-7 only)\n" , +be32_to_cpu (unit->lu_num_write_booster_buffer_allocunits)); +} + +/** +* ufshcd_clearall_luns() - Clear all LUN configuration entries +* @user_cfg: Configuration descriptor to update +* @base_offset: Offset of the first LUN configuration entry +* @config_length: Size of each LUN configuration entry +* +* Resets all configurable LUN entries to their default values. +*/ +static void ufshcd_clearall_luns (struct ufs_config_desc *user_cfg, +u32 base_offset,u32 config_length) +{ +struct ufs_unit_cfg_parameters *unit; +u8 *config = (u8 *)user_cfg; +int off; +int i; + +for (i =0 ; i <8 ; i++) { + off = base_offset + (i * config_length); + + unit = (struct ufs_unit_cfg_parameters *)&config[off]; + + unit->num_allocunits =cpu_to_be32 (0 ); + unit->memory_type =0 ; + unit->lu_enable =0 ; + unit->boot_lun_id =0 ; + unit->logical_block_size =0xC ; + unit->data_reliability =0 ; + unit->provisioning_type =0 ; + unit->context_capabilities =cpu_to_be16 (0 ); + unit->lu_num_write_booster_buffer_allocunits =cpu_to_be32 (0 ); + } +} + +/** +* calc_lun_capacity() - Calculate configured LUN capacity +* @unit: LUN configuration entry +* @geometry: Device geometry descriptor +* +* Calculates the effective LUN capacity from allocation units and +* geometry descriptor parameters. +* +* Return: Capacity in MiB. +*/ +static u32 calc_lun_capacity (struct ufs_unit_cfg_parameters *unit, +struct ufs_geometry_desc *geometry) +{ +u16 cap_adj_fac =1 ; +u64 cap_adj_facfl =1 ; +u64 lun_capacity; + +switch (unit->memory_type) { +case 0 :/* Normal */ + cap_adj_fac =1 ; +break ; +case 1 : + cap_adj_fac =be16_to_cpu (geometry->system_code_cap_adj_fac); +break ; +case 2 : + cap_adj_fac =be16_to_cpu (geometry->non_persist_cap_adj_fac); +break ; +case 3 : + cap_adj_fac =be16_to_cpu (geometry->enhanced1_cap_adj_fac); +break ; +case 4 : + cap_adj_fac =be16_to_cpu (geometry->enhanced2_cap_adj_fac); +break ; +case 5 : + cap_adj_fac =be16_to_cpu (geometry->enhanced3_cap_adj_fac); +break ; +case 6 : + cap_adj_fac =be16_to_cpu (geometry->enhanced4_cap_adj_fac); +break ; +default : +log_err ("ilegal memory type\n" ); + } + +if (unit->memory_type) { +/* See geometry Descriptor/cap_adj_fac in Jedec. */ + cap_adj_facfl = cap_adj_fac >>8 ; + } + + lun_capacity =512 * (u64 )be32_to_cpu (unit->num_allocunits) * + geometry->allocationunit_size * + (u64 )be32_to_cpu (geometry->segment_size); + lun_capacity =div_u64 (lun_capacity, cap_adj_facfl); + +return (u32)(lun_capacity >>20 ); +} + +/** +* ufs_tool_print_luns() - Display configured LUNs +* +* Prints all enabled logical units and their calculated capacities. +* +* Return: %CMD_RET_SUCCESS on success or %CMD_RET_FAILURE on failure. +*/ +static int ufs_tool_print_luns (void ) +{ +struct ufs_geometry_desc geometry; +struct ufs_device_desc device_desc; +struct ufs_hba *hba; +const int COL_WIDTH =14 ; +u8 *config; +int i; + + hba =ufstool_probe_dev (hba_id); +if (!hba) { +log_err ("ufs_tool: Failed to get hba\n" ); +return CMD_RET_FAILURE ; + } + +if (g_cfg_desc.cfg_desc.length ==0 && +ufshcd_query_desc_config (hba, &g_cfg_desc)) +return CMD_RET_FAILURE ; + +if (ufshcd_query_desc_device (hba, &device_desc)) { +log_err ("Failed to read DeviceConfig IDN\n" ); +return CMD_RET_FAILURE ; + } + +if (ufshcd_query_desc_geometry (hba, &geometry)) { +log_err ("Failed to read Geometry IDN\n" ); +return CMD_RET_FAILURE ; + } + + config = (u8 *)&g_cfg_desc; + +for (i =0 ; i <8 ; i++) { +struct ufs_unit_cfg_parameters *unit; +char buf[32 ]; +int off; + + off = device_desc.ud0_base_offset + + (i * device_desc.config_length); + + unit = (struct ufs_unit_cfg_parameters *)&config[off]; +if (unit->lu_enable !=1 ) +continue ; + +snprintf (buf,sizeof (buf),"LUN %d" , i); +printf ("| %-*s" ,COL_WIDTH -2 , buf); + } + +printf ("|\n" ); + +for (i =0 ; i <8 ; i++) { +struct ufs_unit_cfg_parameters *unit; +char size_str[32 ]; +int off; +s64 mb; + + off = device_desc.ud0_base_offset + (i * device_desc.config_length); + unit = (struct ufs_unit_cfg_parameters *)&config[off]; + +if (unit->lu_enable !=1 ) +continue ; + + mb =calc_lun_capacity (unit, &geometry); +snprintf (size_str,sizeof (size_str),"%lld MB" , mb); +printf ("| %-*s" ,COL_WIDTH -2 , size_str); + } + +printf ("|\n" ); +return CMD_RET_SUCCESS ; +} + +/** +* ufshcd_print_desc_config() - Display configuration descriptor data +* @user_cfg: Configuration descriptor to display +* @geometry: Geometry descriptor used for capacity calculations +* @base_offset: Offset of first unit configuration entry +* @config_ength: Size of each unit configuration entry +* +* Prints the configuration descriptor and all configured LUN entries. +*/ +static void ufshcd_print_desc_config (struct ufs_config_desc *user_cfg, +struct ufs_geometry_desc *geometry, +u32 base_offset,u32 config_ength) +{ +struct ufs_unit_cfg_parameters *unit; +u8 *config = (u8 *)user_cfg; +u32 mb; +int off; +int i; + +ufshcd_print_config_descriptor (&user_cfg->cfg_desc); +for (i =0 ; i <8 ; i++) { + off = base_offset + (i * config_ength); + + unit = (struct ufs_unit_cfg_parameters *)&config[off]; + mb =calc_lun_capacity (unit, geometry); +printf ("-------------------------------------------------\n" ); +printf ("LUN %d Capacity %d MB\n" , i, mb); +printf ("Name | Value | Description\n" ); +printf ("-------------------------------------------------\n" ); +ufshcd_print_unit_param_descriptor (unit); + } +} + +static void print_power_element (struct ufs_power_parameter_element desc) +{ +static const char *const units[] = {"n_a" ,"u_a" ,"m_a" ,"A" }; +u16 element = desc.upower_value; + +u8 unit_code = (element >>14 ) &0x03 ; +u16 value = element &0x03FF ; + +printf ("%d %s" , value, units[unit_code]); +} + +/** +* +* ufshcd_print_power_params() - Print a UFS Power Parms Descriptor +* @desc: ufs_power_param_desc +* +* Prints the contents of ufs_power_param_desc Descriptor in a human-readable format. +*/ +static void ufshcd_print_power_params (struct ufs_power_param_desc *desc) +{ +printf ("--- UFS power Parameters Descriptor (IDN: 08h) ---\n" ); +printf ("Descriptor Length: 0x%x (%u bytes)\n" , desc->length, desc->length); +printf ("Descriptor IDN: 0x%x\n\n" , desc->descriptor_idn); + +printf ("Level | VCC Current | VCCQ Current | VCCQ2 Current\n" ); +printf ("--------------------------------------------------\n" ); + +for (int i =0 ; i <5 ; i++) { +printf (" %x | " , i); +/* Accessing the levels for each supply (VCC, VCCQ, VCCQ2) */ +/* Values represent worst-case maximum peak current */ +print_power_element (desc->active_icc_levels_vcc[i]); +printf (" | " ); +print_power_element (desc->active_icc_levels_vccq[i]); +printf (" | " ); +print_power_element (desc->active_icc_levels_vccq2[i]); +printf ("\n" ); + } +} + +/** +* ufshcd_print_unit_descriptor() - Print a UFS Unit Descriptor +* @desc: Unit descriptor to display +* +* Prints the contents of a Unit Descriptor in a human-readable format. +* +*/ +static void ufshcd_print_unit_desc (struct ufs_unit_desc *desc) +{ +printf ("--- UFS unit Descriptor (IDN: 02h) ---\n" ); +printf (" Name | Value | Description\n" ); +printf ("---------------------------------------------\n" ); + +/* Descriptor Header */ +printf ("Length | %d | Size of descriptor\n" , desc->length); +printf ("DescriptorIdn | 0x%x | unit Descriptor ID\n" , + desc->descriptor_idn); +printf ("BunitIndex | 0x%x | Logical unit Index\n" , + desc->bunit_index); + +/* configuration Parameters */ +printf ("luEnable | 0x%x | LU Enabled (01h) or Disabled (00h)\n" , + desc->lu_enable); +printf ("BootLunId | 0x%x| Boot LU ID (01h: A, 02h: B\n" , + desc->boot_lun_id); +printf ("luWriteProtect | 0x%x | WP (01h: power-on, 02h: Perm)\n" , + desc->lu_write_protect); +printf ("luQueueDepth | 0x%x | Queue depth (0 if shared)\n" , + desc->lu_queue_depth); +printf ("psaSensitive | 0x%x | Soldering sensitivity indicator\n" , + desc->psa_sensitive); +printf ("MemoryType | 0x%x | Memory type (00h: Normal\n" , + desc->memory_type); +printf ("DataReliability | 0x%x | power failure protection enabled\n" , + desc->data_reliability); +printf ("LogicalBlockSize| 0x%x | Block size exponent (2^n)\n" , + desc->logical_block_size); + +printf ("LogicalBlockCount | %d %d | Total addressable blocks\n" , +be32_to_cpu (upper_32_bits (desc->logical_block_count)), +be32_to_cpu (lower_32_bits (desc->logical_block_count))); +printf ("EraseBlockSize | 0x%x | Optimal erase granularity\n" , + desc->erase_block_size); +printf ("ProvisioningType | 0x%x | 00h: Full, 02h/03h: Thin\n" , + desc->provisioning_type); +printf ("phyMemResourceCount| %d %d Available physical resources\n" , +lower_32_bits (desc->phy_mem_resource_count), +upper_32_bits (desc->phy_mem_resource_count)); + +printf ("ContextCapabilities | 0x%x | Context ID & LU Multiplier\n" , + desc->context_capabilities); +printf ("LargeunitGranularity_M1|" ); +printf ("0x%x | Large unit granularity minus one\n" , + desc->largeunit_granularity_M1); +puts ("luNumWriteBoosterBufferAllocunits" ); +printf (" | %d | WB Buffer size in Alloc units\n" , +be32_to_cpu (desc->lu_num_write_booster_buffer_allocunits)); +} + +static int set_param_field (struct ufs_unit_cfg_parameters *ud, +const char *name,u32 value) +{ +if (!strcmp (name,"boot_lun_id" )) + ud->boot_lun_id = (u8 )value; +else if (!strcmp (name,"lu_enable" )) + ud->lu_enable = (u8 )value; +else if (!strcmp (name,"lu_write_protect" )) + ud->lu_write_protect = (u8 )value; +else if (!strcmp (name,"memory_type" )) + ud->memory_type = (u8 )value; +else if (!strcmp (name,"data_reliability" )) + ud->data_reliability = (u8 )value; +else if (!strcmp (name,"num_allocunits" )) + ud->num_allocunits =cpu_to_be32 (value); +else if (!strcmp (name,"provisioning_type" )) + ud->provisioning_type = (u8 )value; +else if (!strcmp (name,"context_capabilities" )) + ud->context_capabilities =cpu_to_be16 (value); +else if (!strcmp (name,"lu_num_write_booster_buffer_allocunits" )) + ud->lu_num_write_booster_buffer_allocunits =cpu_to_be32 (value); +else +return CMD_RET_FAILURE ; + +return CMD_RET_SUCCESS ; +} + +/** +* ufshcd_get_lun() - Display a LUN configuration entry +* @hba: UFS host controller instance +* @lun: Logical unit number +* +* Return: Command status. +*/ +static int ufshcd_get_lun (struct ufs_hba *hba,int lun) +{ +struct ufs_unit_cfg_parameters *unit; +struct ufs_device_desc dev_desc; +u8 *config; +int off; + +// Populate descriptor +if (g_cfg_desc.cfg_desc.length ==0 && +ufshcd_query_desc_config (hba, &g_cfg_desc)) +return CMD_RET_FAILURE ; + +if (ufshcd_query_desc_device (hba, &dev_desc)) { +log_err ("Failed to read IDN DeviceDesc IDN\n" ); +return CMD_RET_FAILURE ; + } + + config = (__u8 *)&g_cfg_desc; + off = dev_desc.ud0_base_offset + (lun * dev_desc.config_length); + unit = (struct ufs_unit_cfg_parameters *)&config[off]; +ufshcd_print_unit_param_descriptor (unit); +return CMD_RET_FAILURE ; +} + +/** +* ufshcd_clear_lun() - Reset a LUN configuration entry +* @hba: UFS host controller instance +* @lun: Logical unit number +* +* Clears the specified LUN configuration. +* +* Return: Command status. +*/ +static int ufshcd_clear_lun (struct ufs_hba *hba,int lun) +{ +struct ufs_unit_cfg_parameters *unit; +struct ufs_device_desc dev_desc; +u8 *config; +int off; + +// Populate descriptor +if (g_cfg_desc.cfg_desc.length ==0 && +ufshcd_query_desc_config (hba, &g_cfg_desc)) +return CMD_RET_FAILURE ; + +if (ufshcd_query_desc_device (hba, &dev_desc)) { +log_err ("Failed to read IDN DeviceDesc IDN\n" ); +return CMD_RET_FAILURE ; + } + + config = (__u8 *)&g_cfg_desc; + off = dev_desc.ud0_base_offset + (lun * dev_desc.config_length); + unit = (struct ufs_unit_cfg_parameters *)&config[off]; +memset (unit,0x00 ,sizeof (*unit)); + unit->logical_block_size =0xC ; +return CMD_RET_SUCCESS ; +} + +/** +* ufshcd_update_lun() - Update a LUN configuration field +* @hba: UFS host controller instance +* @lun: Logical unit number +* @field: Configuration field name +* @val: New field value +* +* Return: Command status. +*/ +static int ufshcd_update_lun (struct ufs_hba *hba,int lun, +const char *field,u32 val) +{ +struct ufs_unit_cfg_parameters *unit; +struct ufs_device_desc dev_desc; +u8 *config; +int off; + +// Populate descriptor +if (g_cfg_desc.cfg_desc.length ==0 && +ufshcd_query_desc_config (hba, &g_cfg_desc)) +return CMD_RET_FAILURE ; + +if (ufshcd_query_desc_device (hba, &dev_desc)) { +log_err ("Failed to read IDN DeviceDesc IDN\n" ); +return CMD_RET_FAILURE ; + } + + config = (__u8 *)&g_cfg_desc; + off = dev_desc.ud0_base_offset + (lun * dev_desc.config_length); + unit = (struct ufs_unit_cfg_parameters *)&config[off]; +if (set_param_field (unit, field, val)) { +log_err ("Ilegal value to set %s\n" , field); +return CMD_RET_FAILURE ; + } +ufshcd_print_unit_param_descriptor (unit); +return CMD_RET_SUCCESS ; +} + +/** +* ufshcd_write_desc_param() - Write a UFS descriptor +* @hba: UFS host controller instance +* @desc_id: Descriptor identifier +* @desc_index: Descriptor index +* @param_offset: Descriptor offset +* @param_write_buf: Data to write +* @param_size: Size of data buffer +* +* Return: 0 on success or negative error code on failure. +*/ +static int ufshcd_write_desc_param (struct ufs_hba *hba,enum desc_idn desc_id, +int desc_index,unsigned char param_offset, +unsigned char *param_write_buf, +unsigned char param_size) +{ +int ret; +int buff_len; +int selector =0 ; + +if (desc_id >=QUERY_DESC_IDN_MAX || !param_size) +return -EINVAL ; + + buff_len = param_size; + ret =ufshcd_query_descriptor_retry (hba,UPIU_QUERY_OPCODE_WRITE_DESC , + desc_id, desc_index, selector, + param_write_buf, &buff_len); +if (!ret) +return 0 ; +log_err ("Err: desc_id %d desc_index %d, param_offset %d,buflen %d,ret=%d\n" , + (unsigned int )desc_id, desc_index, (unsigned int )param_offset, buff_len, ret); + +return ret; +} + +static enum flag_idn ufshcd_get_flag (const char *name) +{ +if (!strcmp (name,"deviceinit" )) +return QUERY_FLAG_IDN_FDEVICEINIT ; + +if (!strcmp (name,"permanent_wpe" )) +return QUERY_FLAG_IDN_PERMANENT_WPE ; + +if (!strcmp (name,"pwr_on_wpe" )) +return QUERY_FLAG_IDN_PWR_ON_WPE ; + +if (!strcmp (name,"bkops_en" )) +return QUERY_FLAG_IDN_BKOPS_EN ; + +if (!strcmp (name,"life_span_mode" )) +return QUERY_FLAG_IDN_LIFE_SPAN_MODE_ENABLE ; + +if (!strcmp (name,"purge_enable" )) +return QUERY_FLAG_IDN_PURGE_ENABLE ; + +if (!strcmp (name,"fphy_resource_removal" )) +return QUERY_FLAG_IDN_FPHYRESOURCEREMOVAL ; + +if (!strcmp (name,"busy_rtc" )) +return QUERY_FLAG_IDN_BUSY_RTC ; + +if (!strcmp (name,"permanently_disable_fw_update" )) +return QUERY_FLAG_IDN_PERMANENTLY_DISABLE_FW_UPDATE ; + +if (!strcmp (name,"write_booster_en" )) +return QUERY_FLAG_IDN_F_WRITE_BOOSTER_EN ; + +if (!strcmp (name,"wb_buf_flush_en" )) +return QUERY_FLAG_IDN_F_WB_BUF_FLUSH_EN ; + +if (!strcmp (name,"wb_buf_flush_h8" )) +return QUERY_FLAG_IDN_F_WB_BUF_FLUSH_HIBERN8 ; + +return -EINVAL ; +} + +/** +* ufshcd_query_user_flag() - Read a UFS flag attribute +* @hba: UFS host bus adapter instance +* @flag_name: Name of the flag to query +* +* Translates @flag_name to the corresponding UFS flag identifier, +* reads the flag value from the device and prints the result. +* +* Return: 0 on success, negative error code on failure. +*/ +static int ufshcd_query_user_flag (struct ufs_hba *hba,const char *flag_name) +{ +enum flag_idn idn; +bool flag_res; +int ret; + +if (!hba) { +log_err ("query flag: invalid hba\n" ); +return CMD_RET_FAILURE ; + } + + idn =ufshcd_get_flag (flag_name); +if ((int )idn <0 ) { +log_err ("query flag: invalid flag name\n" ); +return CMD_RET_FAILURE ; + } + ret =ufshcd_query_flag (hba,UPIU_QUERY_OPCODE_READ_FLAG , idn, &flag_res); +if (ret) { +log_err ("QueryFlag: flag %s idn query failed\n" , flag_name); +return CMD_RET_FAILURE ; + } +printf ("%s = %x\n" , flag_name, flag_res); + +return CMD_RET_SUCCESS ; +} + +static int print_query_help (void ) +{ +puts ("Supported descriptor IDNs:\n" +"\t0 - Device Descriptor\n" +"\t1 - Configuration Descriptor\n" +"\t2 - Unit Descriptor\n" +"\t7 - Geometry Descriptor\n" +"\t8 - Power Descriptor\n" ); + +return CMD_RET_FAILURE ; +} + +/** +* idn_read() - Read and display a descriptor by IDN +* @hba: UFS host controller instance +* @idn: Descriptor identifier +* @lun: Logical unit number for unit-specific descriptors +* +* Return: Command status. +*/ +static int idn_read (struct ufs_hba *hba,int idn,char *lunp) +{ +void *desc =NULL ; +int ret =CMD_RET_FAILURE ; + +switch (idn) { +case QUERY_DESC_IDN_DEVICE : + desc =malloc (sizeof (struct ufs_device_desc )); +if (!desc) { +log_err ("failed to allocate device descriptor\n" ); +return CMD_RET_FAILURE ; + } +if (!ufshcd_query_desc_device (hba, desc)) { +ufshcd_print_device_descriptor (desc); + ret =CMD_RET_SUCCESS ; + }else { +log_err ("failed to read device descriptor\n" ); + } +break ; + +case QUERY_DESC_IDN_GEOMETRY : + desc =malloc (sizeof (struct ufs_geometry_desc )); +if (!desc) { +log_err ("failed to allocate geometry descriptor\n" ); +return CMD_RET_FAILURE ; + } + +if (!ufshcd_query_desc_geometry (hba, desc)) { +ufshcd_print_idn_geometry_desc (desc); + ret =CMD_RET_SUCCESS ; + }else { +log_err ("failed to read geometry descriptor\n" ); + } +break ; + +case QUERY_DESC_IDN_UNIT : { +int lun; + +if (!lunp) +return print_query_help (); + lun =dectoul (lunp,NULL ); + desc =malloc (sizeof (struct ufs_unit_desc )); +if (!desc) { +log_err ("failed to allocate unit descriptor\n" ); +return CMD_RET_FAILURE ; + } + +if (!ufshcd_query_desc_unit (hba, lun, desc)) { +ufshcd_print_unit_desc (desc); + ret =CMD_RET_SUCCESS ; + }else { +log_err ("failed to read unit descriptor\n" ); + } + } +break ; + +case QUERY_DESC_IDN_POWER : + desc =malloc (sizeof (struct ufs_power_param_desc )); +if (!desc) { +log_err ("failed to allocate power descriptor\n" ); +return CMD_RET_FAILURE ; + } + +if (!ufshcd_query_desc_power (hba,0 , desc)) { +ufshcd_print_power_params (desc); + ret =CMD_RET_SUCCESS ; + }else { +log_err ("failed to read power descriptor\n" ); + } +break ; + +case QUERY_DESC_IDN_CONFIGURATION : { +struct ufs_device_desc *device_desc; +struct ufs_geometry_desc *geometry; + + device_desc =malloc (sizeof (*device_desc)); +if (!device_desc) { +log_err ("failed to allocate device descriptor\n" ); +return CMD_RET_FAILURE ; + } + + geometry =malloc (sizeof (*geometry)); +if (!geometry) { +log_err ("failed to allocate geometry descriptor\n" ); +free (device_desc); +return CMD_RET_FAILURE ; + } + +if (ufshcd_query_desc_device (hba, device_desc)) { +log_err ("failed to read IDN DeviceDesc\n" ); + goto cfg_out; + } + +if (ufshcd_query_desc_geometry (hba, geometry)) { +log_err ("failed to read Geometry\n" ); + goto cfg_out; + } + +if (ufshcd_query_desc_config (hba, &g_cfg_desc)) { +log_err ("failed to read Configuration Descriptor\n" ); + goto cfg_out; + } + +ufshcd_print_desc_config (&g_cfg_desc, geometry, + device_desc->ud0_base_offset, + device_desc->config_length); + + ret =CMD_RET_SUCCESS ; + +cfg_out: +free (geometry); +free (device_desc); +return ret; + } + +default : +log_err ("illegal IDN %d\n" , idn); +return CMD_RET_FAILURE ; + } + +free (desc); +return ret; +} + +/** +* ufs_tool_get_config_desc() - Display the configuration descriptor +* +* Reads dependent descriptors and prints the current configuration. +* +* Return: Command status. +*/ +static int ufs_tool_get_config_desc (void ) +{ +struct ufs_device_desc *device_desc; +struct ufs_geometry_desc *geometry; +int ret =CMD_RET_FAILURE ; + +struct ufs_hba *hba =ufstool_probe_dev (hba_id); + +if (!hba) +return CMD_RET_FAILURE ; + + device_desc =malloc (sizeof (*device_desc)); +if (!device_desc) { +log_err ("Failed to allocate device descriptor\n" ); +return CMD_RET_FAILURE ; + } + + geometry =malloc (sizeof (*geometry)); +if (!geometry) { +log_err ("Failed to allocate geometry descriptor\n" ); +free (device_desc); +return CMD_RET_FAILURE ; + } + +if (ufshcd_query_desc_device (hba, device_desc)) { +log_err ("Failed to read DeviceDesc\n" ); + goto cfg_out; + } + +if (ufshcd_query_desc_geometry (hba, geometry)) { +log_err ("Failed to read Geometry\n" ); + goto cfg_out; + } + +ufshcd_print_desc_config (&g_cfg_desc, geometry, + device_desc->ud0_base_offset, + device_desc->config_length); + + ret =CMD_RET_SUCCESS ; +cfg_out: +free (geometry); +free (device_desc); +return ret; +} + +/** +* set_config_desc_field() - Update a configuration descriptor field +* @desc: Descriptor to update +* @fieldname: Field name +* @value: New value +* +* Return: 0 on success or -EINVAL if unsupported. +*/ +static int set_config_desc_field (struct config_descriptor *desc, +const char *fieldname,u32 value) +{ +if (!strcmp (fieldname,"length" )) + desc->length = (u8 )value; +else if (!strcmp (fieldname,"descriptor_idn" )) + desc->descriptor_idn = (u8 )value; +else if (!strcmp (fieldname,"conf_desc_continue" )) + desc->conf_desc_continue = (u8 )value; +else if (!strcmp (fieldname,"boot_enable" )) + desc->boot_enable = (u8 )value; +else if (!strcmp (fieldname,"descr_access_en" )) + desc->descr_access_en = (u8 )value; +else if (!strcmp (fieldname,"initpower_mode" )) + desc->initpower_mode = (u8 )value; +else if (!strcmp (fieldname,"high_priority_lun" )) + desc->high_priority_lun = (u8 )value; +else if (!strcmp (fieldname,"secure_removal_type" )) + desc->secure_removal_type = (u8 )value; +else if (!strcmp (fieldname,"init_active_icc_level" )) + desc->init_active_icc_level = (u8 )value; +else if (!strcmp (fieldname,"periodic_rtc_update" )) + desc->periodic_rtc_update = (u16 )value; +else if (!strcmp (fieldname,"reserved_HPB" )) + desc->reserved_HPB = (u8 )value; +else if (!strcmp (fieldname,"rpmb_region_enable" )) + desc->rpmb_region_enable = (u8 )value; +else if (!strcmp (fieldname,"rpmb_region1_size" )) + desc->rpmb_region1_size = (u8 )value; +else if (!strcmp (fieldname,"rpmb_region2_size" )) + desc->rpmb_region2_size = (u8 )value; +else if (!strcmp (fieldname,"rpmb_region3_size" )) + desc->rpmb_region3_size = (u8 )value; +else if (!strcmp (fieldname,"write_booster_buffer_preserve_user_space_en" )) + desc->write_booster_buffer_preserve_user_space_en = (u8 )value; +else if (!strcmp (fieldname,"write_booster_buffer_type" )) + desc->write_booster_buffer_type = (u8 )value; +else if (!strcmp (fieldname,"num_shared_write_booster_buffer_allocunits" )) + desc->num_shared_write_booster_buffer_allocunits = +cpu_to_be32 (value); +else +return -EINVAL ; + +return 0 ; +} + +/** +* ufs_tool_set_config_desc() - Update cached configuration descriptor +* @name: Field name +* @value: New value +* +* Return: Command status. +*/ +static int ufs_tool_set_config_desc (const char *name,u32 value) +{ +struct ufs_hba *hba =ufstool_probe_dev (hba_id); + +if (g_cfg_desc.cfg_desc.length ==0 ) { +if (ufshcd_query_desc_config (hba, &g_cfg_desc)) { +log_err ("Failed to read Device Descriptor\n" ); +return CMD_RET_FAILURE ; + } + } + +if (set_config_desc_field (&g_cfg_desc.cfg_desc, name, value)) { +log_err ("Failed to set parameters %s descriptor\n" , name); +return CMD_RET_FAILURE ; + } + +ufshcd_print_config_descriptor (&g_cfg_desc.cfg_desc); + +return CMD_RET_SUCCESS ; +} + +/** +* ufs_tool_commit() - Commit configuration descriptor changes +* +* Writes the cached configuration descriptor to the device. +* +* Return: Command status. +*/ +static int ufs_tool_commit (void ) +{ +struct ufs_hba *hba =ufstool_probe_dev (hba_id); +u8 *config; +int ret; + + config = (__u8 *)&g_cfg_desc; +ufshcd_cache_flush (config,QUERY_DESC_UNIT_DEF_SIZE ); + ret =ufshcd_write_desc_param (hba, +QUERY_DESC_IDN_CONFIGURATION , +0 ,0 , config, + g_cfg_desc.cfg_desc.length); + +if (ret) { +log_err ("Failed to write Configuration\n" ); +return CMD_RET_FAILURE ; + } + +return CMD_RET_SUCCESS ; +} + +/** +* ufs_tool_clearall() - Clear all configured logical units +* +* Resets all LUN entries and writes the updated configuration. +* +* Return: Command status. +*/ +static int ufs_tool_clearall (void ) +{ +struct ufs_hba *hba =ufstool_probe_dev (hba_id); +struct ufs_device_desc device_desc; +u8 *config; +int ret; + +// Populate descriptor +if (g_cfg_desc.cfg_desc.length ==0 && +ufshcd_query_desc_config (hba, &g_cfg_desc)) { +return CMD_RET_FAILURE ; + } + config = (__u8 *)&g_cfg_desc; + +ufshcd_cache_flush (config,QUERY_DESC_UNIT_DEF_SIZE ); + ret =ufshcd_query_desc_device (hba, &device_desc); +if (ret) { +log_err ("Failed to read DeviceDesc\n" ); +return CMD_RET_FAILURE ; + } + +ufshcd_clearall_luns (&g_cfg_desc, + device_desc.ud0_base_offset, + device_desc.config_length); + + ret =ufshcd_write_desc_param (hba, +QUERY_DESC_IDN_CONFIGURATION , +0 ,0 , config, + g_cfg_desc.cfg_desc.length); + +if (ret) { +log_err ("Failed to clear Configuration\n" ); +return CMD_RET_FAILURE ; + } + +return CMD_RET_SUCCESS ; +} + +int ufs_tool_get_lun (int lun) +{ +struct ufs_hba *hba =ufstool_probe_dev (hba_id); + +if (!hba) +return -EINVAL ; +return ufshcd_get_lun (hba, lun); +} + +int ufs_tool_clear_lun (int lun) +{ +struct ufs_hba *hba =ufstool_probe_dev (hba_id); + +if (!hba) +return -EINVAL ; +return ufshcd_clear_lun (hba, lun); +} + +int ufs_tool_set_lun (int lun,const char *parm,u32 val) +{ +struct ufs_hba *hba =ufstool_probe_dev (hba_id); + +if (!hba) +return -EINVAL ; +return ufshcd_update_lun (hba, lun, parm, val); +} + +static int ufs_tool_query_flag (const char *flag) +{ +struct ufs_hba *hba =ufstool_probe_dev (hba_id); + +if (!hba) +return -EINVAL ; +return ufshcd_query_user_flag (hba, flag); +} + +static int ufs_tool_query (int idn,char *lunp) +{ +struct ufs_hba *hba; + + hba =ufstool_probe_dev (hba_id); +if (!hba) { +log_err ("ufs_tool: failed to get hba\n" ); +return CMD_RET_FAILURE ; + } + +if (idn >=0 ) +return idn_read (hba, idn, lunp); + +return CMD_RET_FAILURE ; +} + +static int ufs_tool_set_hba (int val) +{ +if (val <0 ) { +printf ("ufs_tool: invalid hba id\n" ); +return CMD_RET_FAILURE ; + } + hba_id = val; +return CMD_RET_SUCCESS ; +} + +static int ufs_tool_provision (long addr) +{ +memcpy (&g_cfg_desc, (void *)addr,sizeof (g_cfg_desc)); +return CMD_RET_SUCCESS ; +} + +static int print_provision_help (void ) +{ +puts ("<addr> - address of the loaded binary\n" ); +return CMD_RET_FAILURE ; +} + +static int print_flags_help (void ) +{ +puts ("Supported flags:\n" +"\tdeviceinit\n" +"\tpermanent_wpe\n" +"\tpwr_on_wpe\n" +"\tbkops_en\n" +"\tlife_span_mode\n" +"\tpurge_enable\n" +"\tfphy_resource_removal\n" +"\tbusy_rtc\n" +"\tpermanently_disable_fw_update\n" +"\twrite_booster_en\n" +"\twb_buf_flush_en\n" +"\twb_buf_flush_h8\n" ); + +return CMD_RET_FAILURE ; +} + +static int print_set_lun_help (void ) +{ +puts ("Supported LUN fields:\n" +"\tlu_enable\n" +"\tboot_lun_id\n" +"\tlu_write_protect\n" +"\tmemory_type\n" +"\tdata_reliability\n" +"\tnum_allocunits\n" +"\tlogical_block_size\n" +"\tprovisioning_type\n" +"\tcontext_capabilities\n" +"\tlu_num_write_booster_buffer_allocunits\n" ); + +return CMD_RET_FAILURE ; +} + +static int print_set_cfg_desc_help (void ) +{ +puts ("Supported configuration descriptor fields:\n" +"\tlength\n" +"\tdescriptor_idn\n" +"\tconf_desc_continue\n" +"\tboot_enable\n" +"\tdescr_access_en\n" +"\tinitpower_mode\n" +"\thigh_priority_lun\n" +"\tsecure_removal_type\n" +"\tinit_active_icc_level\n" +"\tperiodic_rtc_update\n" +"\treserved_HPB\n" +"\trpmb_region_enable\n" +"\trpmb_region1_size\n" +"\trpmb_region2_size\n" +"\trpmb_region3_size\n" +"\twrite_booster_buffer_preserve_user_space_en\n" +"\twrite_booster_buffer_type\n" +"\tnum_shared_write_booster_buffer_allocunits\n" ); + +return CMD_RET_FAILURE ; +} + +/** +* do_ufs() - Execute the UFS command +* @cmdtp: Command table entry +* @flag: Command flags +* @argc: Number of arguments +* @argv: Command arguments +* +* Dispatches UFS subcommands. +* +* Return: Command status. +*/ static int do_ufs (struct cmd_tbl *cmdtp,int flag,int argc,char *const argv[]) {int dev, ret;
@@ -20,19 +1511,120 @@ static int do_ufs(struct cmd_tbl *cmdtp, int flag, int argc, char *const argv[]) dev =dectoul (argv[2 ],NULL ); ret =ufs_probe_dev (dev);if (ret) -return CMD_RET_FAILURE ; +return CMD_RET_USAGE ; }else {ufs_probe (); } -return CMD_RET_SUCCESS ; } - } +if (!strcmp (argv[1 ],"query" )) { +char *lun =NULL ; +int idn; + +if (argc <=2 ) +return print_query_help (); + idn =dectoul (argv[2 ],NULL ); +if (argc ==4 ) + lun = argv[3 ]; +return ufs_tool_query (idn, lun); + } + +if (!strcmp (argv[1 ],"set_hba" )) { +int val; + +if (argc <=2 ) +return CMD_RET_USAGE ; + + val =dectoul (argv[2 ],NULL ); +return ufs_tool_set_hba (val); + } + +if (!strcmp (argv[1 ],"get_lun" )) { +int lun; + +if (argc <=2 ) +return CMD_RET_USAGE ; + + lun =dectoul (argv[2 ],NULL ); +return ufs_tool_get_lun (lun); + } + +if (!strcmp (argv[1 ],"set_lun" )) { +int lun; +u32 val; + +if (argc <=4 ) +return print_set_lun_help (); + lun =dectoul (argv[2 ],NULL ); + val =dectoul (argv[4 ],NULL ); +return ufs_tool_set_lun (lun, argv[3 ], val); + } + +if (!strcmp (argv[1 ],"clear_lun" )) { +int lun; + +if (argc <=2 ) +return CMD_RET_USAGE ; + lun =dectoul (argv[2 ],NULL ); +return ufs_tool_clear_lun (lun); + } + +if (!strcmp (argv[1 ],"set_cfg_desc" )) { +const char *name; +u32 val; + +if (argc <=3 ) +return print_set_cfg_desc_help (); + name = argv[2 ]; + val =dectoul (argv[3 ],NULL ); +return ufs_tool_set_config_desc (name, val); + } + +if (!strcmp (argv[1 ],"get_flag" )) { +if (argc <=2 ) +return print_flags_help (); +return ufs_tool_query_flag (argv[2 ]); + } + +if (!strcmp (argv[1 ],"commit" )) +return ufs_tool_commit (); + +if (!strcmp (argv[1 ],"clearall" )) +return ufs_tool_clearall (); + +if (!strcmp (argv[1 ],"luns" )) +return ufs_tool_print_luns (); + +if (!strcmp (argv[1 ],"get_cfg_desc" )) +return ufs_tool_get_config_desc (); + +if (!strcmp (argv[1 ],"provision" )) { +long addr; + +if (argc <=2 ) +return print_provision_help (); + addr =dectoul (argv[2 ],NULL ); +return ufs_tool_provision (addr); + } + }return CMD_RET_USAGE ; } -U_BOOT_CMD (ufs,3 ,1 , do_ufs, -"UFS sub-system" , -"init [dev] - init UFS subsystem\n" -); +U_BOOT_LONGHELP (ufs, +"init [dev] - init UFS subsystem\n" +"query <lun> <idn> - read and display descriptor\n" +"get_flag <flag> - read a UFS flag\n" +"commit - write configuration descriptor\n" +"provision <addr> - overwrite config descriptor\n" +"set_hba <id> - select active HBA\n" +"luns - print configured LUNs\n" +"clearall - clear all LUN configuration\n" +"get_lun <lun> - display LUN configuration\n" +"clear_lun <lun> - clear a LUN configuration\n" +"set_lun <lun> <field> <value> - update a LUN field\n" +"get_cfg_desc - display configuration descriptor\n" +"set_cfg_desc <field> <value> - update configuration descriptor\n" ); + +U_BOOT_CMD (ufs,5 ,1 , do_ufs,"UFS sub-system" , ufs_help_text); +
Signature · 1 line
2.43.0
PATCH v5 5/5 ufs: wmb is not implemented in x86.
In reply to Raz Ben Yehudasfence: All stores (writes) issued before the fence become globally visible before any store issued after the fence
memory: Compiler barrier
--- arch/x86/include/asm/io.h | 2 ++ 1 file changed, 2 insertions(+)
arch/x86/include/asm/io.h +2 -0
@@ -241,6 +241,8 @@ static inline void sync(void)*/ #define dmb () __asm__ __volatile__ ("" : : : "memory")#define mb () __asm__ __volatile__ ("mfence" : : : "memory") +#define wmb () __asm__ __volatile__ ("sfence" ::: "memory")/* store mem barrier */ +#define __iormb () dmb()#define __iowmb () dmb()
Signature · 1 line
2.43.0