<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 |
.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.