Configure device using UFS parameters

The device tree specifies the UFS host configuration parameters such as number of gears and lanes, rate value, and timeout values. The device tree is at <workspace_root_path>/boot_images/boot/Settings/Soc/Kodiak/Core/Storage/UFS/ufs.dtsi. For Dragonwing IQ-9075, see <workspace_root_path>/boot_images/boot/Setting/soc/LeMans/Core/Storage/UFS/ufs.dtsi. The following table lists a sample UFS device tree node in UEFI.

Device tree node/key	Subnode	Device tree value	Description
`init_speed_params`	`EnableHighSpeed`	1	Enables high speed mode
`init_speed_params`	`NumGears`	4	Specifies the maximum gear to be used
`init_speed_params`	`NumLanes`	2	Number of lanes used in UFS device
`init_speed_params`	`Rate`	2	Values are: 1 = HS_RATE_A, 2 = HS_RATE_B
`perf_speed_params`	`EnableHighSpeed`	1	Enables high speed mode while in perf mode
`perf_speed_params`	`NumGears`	4	Specifies the maximum gear to be used in perf mode
`perf_speed_params`	`NumLanes`	2	Number of lanes used in UFS device in perf mode
`perf_speed_params`	`Rate`	2	Series in perf mode: 1 = HS_RATE_A, 2 = HS_RATE_B
`timeout_values`	`fDeviceInitTimeoutUs`	2500000	Denotes timeout (µs) during device init
`timeout_values`	`UTRDPollTimeoutUs`	30000000	Denotes timeout (µs) for UTRD
`BatteryThresholdMv`	–	3600	Battery threshold (in mV) to move to Gear1
`LinkStartupRetryCount`	–	5	Retry count for Link startup
`FUA_Value`	–	1	Forced unit access
`EnableLogging`	–	0	Enables DT serial debug logging in loader: 1 = Enable, 0 = Disable
`RefClock`	–	19200000	UFS device controller reference clock 19.2 MHz
`MphyInitTable`	–	–	Denotes `MphyInit` table
`MphyInitEndTable`	–	–	Denotes `MphyInitEnd` table
`MphyLaneInitTable`	–	–	Denotes `Mphy` 2-lane Init table

Compile all changes in the .dtsi to xbl_config.elf and reflash the image to the device. Qualcomm® tunes the values of the MphyInitTable, MphyInitEndTable, and MphyLaneInitTable configurations for UFS device PHY initialization. For debugging and tuning any PHY-level issue, change these configuration values only with guidance from Qualcomm. The default values are for UFS device 3.1-compliant part. For UFS device 2.x-compliant part, NumGears value should be 3. Don’t change other parameters for the UFS device 2.x part.

Introduction

Architecture

Key Documents

Technologies

System

Release Notes