1 What: /sys/bus/*/drivers/ufshcd/*/au 1 What: /sys/bus/*/drivers/ufshcd/*/auto_hibern8
2 Date: March 2018 2 Date: March 2018
3 Contact: linux-scsi@vger.kernel.org 3 Contact: linux-scsi@vger.kernel.org
4 Description: 4 Description:
5 This file contains the auto-hi 5 This file contains the auto-hibernate idle timer setting of a
6 UFS host controller. A value o 6 UFS host controller. A value of '0' means auto-hibernate is not
7 enabled. Otherwise the value i 7 enabled. Otherwise the value is the number of microseconds of
8 idle time before the UFS host 8 idle time before the UFS host controller will autonomously put
9 the link into hibernate state. 9 the link into hibernate state. That will save power at the
10 expense of increased latency. 10 expense of increased latency. Note that the hardware supports
11 10-bit values with a power-of- 11 10-bit values with a power-of-ten multiplier which allows a
12 maximum value of 102300000. Re 12 maximum value of 102300000. Refer to the UFS Host Controller
13 Interface specification for mo 13 Interface specification for more details.
14 14
15 What: /sys/bus/platform/drivers/ufsh 15 What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/device_type
16 What: /sys/bus/platform/devices/*.uf 16 What: /sys/bus/platform/devices/*.ufs/device_descriptor/device_type
17 Date: February 2018 17 Date: February 2018
18 Contact: Stanislav Nijnikov <stanislav.n 18 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
19 Description: This file shows the device typ 19 Description: This file shows the device type. This is one of the UFS
20 device descriptor parameters. 20 device descriptor parameters. The full information about
21 the descriptor could be found 21 the descriptor could be found at UFS specifications 2.1.
22 22
23 The file is read only. 23 The file is read only.
24 24
25 What: /sys/bus/platform/drivers/ufsh 25 What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/device_class
26 What: /sys/bus/platform/devices/*.uf 26 What: /sys/bus/platform/devices/*.ufs/device_descriptor/device_class
27 Date: February 2018 27 Date: February 2018
28 Contact: Stanislav Nijnikov <stanislav.n 28 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
29 Description: This file shows the device cla 29 Description: This file shows the device class. This is one of the UFS
30 device descriptor parameters. 30 device descriptor parameters. The full information about
31 the descriptor could be found 31 the descriptor could be found at UFS specifications 2.1.
32 32
33 The file is read only. 33 The file is read only.
34 34
35 What: /sys/bus/platform/drivers/ufsh 35 What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/device_sub_class
36 What: /sys/bus/platform/devices/*.uf 36 What: /sys/bus/platform/devices/*.ufs/device_descriptor/device_sub_class
37 Date: February 2018 37 Date: February 2018
38 Contact: Stanislav Nijnikov <stanislav.n 38 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
39 Description: This file shows the UFS storag 39 Description: This file shows the UFS storage subclass. This is one of
40 the UFS device descriptor para 40 the UFS device descriptor parameters. The full information
41 about the descriptor could be 41 about the descriptor could be found at UFS specifications 2.1.
42 42
43 The file is read only. 43 The file is read only.
44 44
45 What: /sys/bus/platform/drivers/ufsh 45 What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/protocol
46 What: /sys/bus/platform/devices/*.uf 46 What: /sys/bus/platform/devices/*.ufs/device_descriptor/protocol
47 Date: February 2018 47 Date: February 2018
48 Contact: Stanislav Nijnikov <stanislav.n 48 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
49 Description: This file shows the protocol s 49 Description: This file shows the protocol supported by an UFS device.
50 This is one of the UFS device 50 This is one of the UFS device descriptor parameters.
51 The full information about the 51 The full information about the descriptor could be found
52 at UFS specifications 2.1. 52 at UFS specifications 2.1.
53 53
54 The file is read only. 54 The file is read only.
55 55
56 What: /sys/bus/platform/drivers/ufsh 56 What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/number_of_luns
57 What: /sys/bus/platform/devices/*.uf 57 What: /sys/bus/platform/devices/*.ufs/device_descriptor/number_of_luns
58 Date: February 2018 58 Date: February 2018
59 Contact: Stanislav Nijnikov <stanislav.n 59 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
60 Description: This file shows number of logi 60 Description: This file shows number of logical units. This is one of
61 the UFS device descriptor para 61 the UFS device descriptor parameters. The full information
62 about the descriptor could be 62 about the descriptor could be found at UFS specifications 2.1.
63 63
64 The file is read only. 64 The file is read only.
65 65
66 What: /sys/bus/platform/drivers/ufsh 66 What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/number_of_wluns
67 What: /sys/bus/platform/devices/*.uf 67 What: /sys/bus/platform/devices/*.ufs/device_descriptor/number_of_wluns
68 Date: February 2018 68 Date: February 2018
69 Contact: Stanislav Nijnikov <stanislav.n 69 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
70 Description: This file shows number of well 70 Description: This file shows number of well known logical units.
71 This is one of the UFS device 71 This is one of the UFS device descriptor parameters.
72 The full information about the 72 The full information about the descriptor could be found
73 at UFS specifications 2.1. 73 at UFS specifications 2.1.
74 74
75 The file is read only. 75 The file is read only.
76 76
77 What: /sys/bus/platform/drivers/ufsh 77 What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/boot_enable
78 What: /sys/bus/platform/devices/*.uf 78 What: /sys/bus/platform/devices/*.ufs/device_descriptor/boot_enable
79 Date: February 2018 79 Date: February 2018
80 Contact: Stanislav Nijnikov <stanislav.n 80 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
81 Description: This file shows value that ind 81 Description: This file shows value that indicates whether the device is
82 enabled for boot. This is one 82 enabled for boot. This is one of the UFS device descriptor
83 parameters. The full informati 83 parameters. The full information about the descriptor could
84 be found at UFS specifications 84 be found at UFS specifications 2.1.
85 85
86 The file is read only. 86 The file is read only.
87 87
88 What: /sys/bus/platform/drivers/ufsh 88 What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/descriptor_access_enable
89 What: /sys/bus/platform/devices/*.uf 89 What: /sys/bus/platform/devices/*.ufs/device_descriptor/descriptor_access_enable
90 Date: February 2018 90 Date: February 2018
91 Contact: Stanislav Nijnikov <stanislav.n 91 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
92 Description: This file shows value that ind 92 Description: This file shows value that indicates whether the device
93 descriptor could be read after 93 descriptor could be read after partial initialization phase
94 of the boot sequence. This is 94 of the boot sequence. This is one of the UFS device descriptor
95 parameters. The full informati 95 parameters. The full information about the descriptor could
96 be found at UFS specifications 96 be found at UFS specifications 2.1.
97 97
98 The file is read only. 98 The file is read only.
99 99
100 What: /sys/bus/platform/drivers/ufsh 100 What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/initial_power_mode
101 What: /sys/bus/platform/devices/*.uf 101 What: /sys/bus/platform/devices/*.ufs/device_descriptor/initial_power_mode
102 Date: February 2018 102 Date: February 2018
103 Contact: Stanislav Nijnikov <stanislav.n 103 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
104 Description: This file shows value that def 104 Description: This file shows value that defines the power mode after
105 device initialization or hardw 105 device initialization or hardware reset. This is one of
106 the UFS device descriptor para 106 the UFS device descriptor parameters. The full information
107 about the descriptor could be 107 about the descriptor could be found at UFS specifications 2.1.
108 108
109 The file is read only. 109 The file is read only.
110 110
111 What: /sys/bus/platform/drivers/ufsh 111 What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/high_priority_lun
112 What: /sys/bus/platform/devices/*.uf 112 What: /sys/bus/platform/devices/*.ufs/device_descriptor/high_priority_lun
113 Date: February 2018 113 Date: February 2018
114 Contact: Stanislav Nijnikov <stanislav.n 114 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
115 Description: This file shows the high prior 115 Description: This file shows the high priority lun. This is one of
116 the UFS device descriptor para 116 the UFS device descriptor parameters. The full information
117 about the descriptor could be 117 about the descriptor could be found at UFS specifications 2.1.
118 118
119 The file is read only. 119 The file is read only.
120 120
121 What: /sys/bus/platform/drivers/ufsh 121 What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/secure_removal_type
122 What: /sys/bus/platform/devices/*.uf 122 What: /sys/bus/platform/devices/*.ufs/device_descriptor/secure_removal_type
123 Date: February 2018 123 Date: February 2018
124 Contact: Stanislav Nijnikov <stanislav.n 124 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
125 Description: This file shows the secure rem 125 Description: This file shows the secure removal type. This is one of
126 the UFS device descriptor para 126 the UFS device descriptor parameters. The full information
127 about the descriptor could be 127 about the descriptor could be found at UFS specifications 2.1.
128 128
129 The file is read only. 129 The file is read only.
130 130
131 What: /sys/bus/platform/drivers/ufsh 131 What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/support_security_lun
132 What: /sys/bus/platform/devices/*.uf 132 What: /sys/bus/platform/devices/*.ufs/device_descriptor/support_security_lun
133 Date: February 2018 133 Date: February 2018
134 Contact: Stanislav Nijnikov <stanislav.n 134 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
135 Description: This file shows whether the se 135 Description: This file shows whether the security lun is supported.
136 This is one of the UFS device 136 This is one of the UFS device descriptor parameters.
137 The full information about the 137 The full information about the descriptor could be found
138 at UFS specifications 2.1. 138 at UFS specifications 2.1.
139 139
140 The file is read only. 140 The file is read only.
141 141
142 What: /sys/bus/platform/drivers/ufsh 142 What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/bkops_termination_latency
143 What: /sys/bus/platform/devices/*.uf 143 What: /sys/bus/platform/devices/*.ufs/device_descriptor/bkops_termination_latency
144 Date: February 2018 144 Date: February 2018
145 Contact: Stanislav Nijnikov <stanislav.n 145 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
146 Description: This file shows the background 146 Description: This file shows the background operations termination
147 latency. This is one of the UF 147 latency. This is one of the UFS device descriptor parameters.
148 The full information about the 148 The full information about the descriptor could be found
149 at UFS specifications 2.1. 149 at UFS specifications 2.1.
150 150
151 The file is read only. 151 The file is read only.
152 152
153 What: /sys/bus/platform/drivers/ufsh 153 What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/initial_active_icc_level
154 What: /sys/bus/platform/devices/*.uf 154 What: /sys/bus/platform/devices/*.ufs/device_descriptor/initial_active_icc_level
155 Date: February 2018 155 Date: February 2018
156 Contact: Stanislav Nijnikov <stanislav.n 156 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
157 Description: This file shows the initial ac 157 Description: This file shows the initial active ICC level. This is one
158 of the UFS device descriptor p 158 of the UFS device descriptor parameters. The full information
159 about the descriptor could be 159 about the descriptor could be found at UFS specifications 2.1.
160 160
161 The file is read only. 161 The file is read only.
162 162
163 What: /sys/bus/platform/drivers/ufsh 163 What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/specification_version
164 What: /sys/bus/platform/devices/*.uf 164 What: /sys/bus/platform/devices/*.ufs/device_descriptor/specification_version
165 Date: February 2018 165 Date: February 2018
166 Contact: Stanislav Nijnikov <stanislav.n 166 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
167 Description: This file shows the specificat 167 Description: This file shows the specification version. This is one
168 of the UFS device descriptor p 168 of the UFS device descriptor parameters. The full information
169 about the descriptor could be 169 about the descriptor could be found at UFS specifications 2.1.
170 170
171 The file is read only. 171 The file is read only.
172 172
173 What: /sys/bus/platform/drivers/ufsh 173 What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/manufacturing_date
174 What: /sys/bus/platform/devices/*.uf 174 What: /sys/bus/platform/devices/*.ufs/device_descriptor/manufacturing_date
175 Date: February 2018 175 Date: February 2018
176 Contact: Stanislav Nijnikov <stanislav.n 176 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
177 Description: This file shows the manufactur 177 Description: This file shows the manufacturing date in BCD format.
178 This is one of the UFS device 178 This is one of the UFS device descriptor parameters.
179 The full information about the 179 The full information about the descriptor could be found
180 at UFS specifications 2.1. 180 at UFS specifications 2.1.
181 181
182 The file is read only. 182 The file is read only.
183 183
184 What: /sys/bus/platform/drivers/ufsh 184 What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/manufacturer_id
185 What: /sys/bus/platform/devices/*.uf 185 What: /sys/bus/platform/devices/*.ufs/device_descriptor/manufacturer_id
186 Date: February 2018 186 Date: February 2018
187 Contact: Stanislav Nijnikov <stanislav.n 187 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
188 Description: This file shows the manufactur 188 Description: This file shows the manufacturer ID. This is one of the
189 UFS device descriptor paramete 189 UFS device descriptor parameters. The full information about
190 the descriptor could be found 190 the descriptor could be found at UFS specifications 2.1.
191 191
192 The file is read only. 192 The file is read only.
193 193
194 What: /sys/bus/platform/drivers/ufsh 194 What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/rtt_capability
195 What: /sys/bus/platform/devices/*.uf 195 What: /sys/bus/platform/devices/*.ufs/device_descriptor/rtt_capability
196 Date: February 2018 196 Date: February 2018
197 Contact: Stanislav Nijnikov <stanislav.n 197 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
198 Description: This file shows the maximum nu 198 Description: This file shows the maximum number of outstanding RTTs
199 supported by the device. This 199 supported by the device. This is one of the UFS device
200 descriptor parameters. The ful 200 descriptor parameters. The full information about
201 the descriptor could be found 201 the descriptor could be found at UFS specifications 2.1.
202 202
203 The file is read only. 203 The file is read only.
204 204
205 What: /sys/bus/platform/drivers/ufsh 205 What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/rtc_update
206 What: /sys/bus/platform/devices/*.uf 206 What: /sys/bus/platform/devices/*.ufs/device_descriptor/rtc_update
207 Date: February 2018 207 Date: February 2018
208 Contact: Stanislav Nijnikov <stanislav.n 208 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
209 Description: This file shows the frequency 209 Description: This file shows the frequency and method of the realtime
210 clock update. This is one of t 210 clock update. This is one of the UFS device descriptor
211 parameters. The full informati 211 parameters. The full information about the descriptor
212 could be found at UFS specific 212 could be found at UFS specifications 2.1.
213 213
214 The file is read only. 214 The file is read only.
215 215
216 What: /sys/bus/platform/drivers/ufsh 216 What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/ufs_features
217 What: /sys/bus/platform/devices/*.uf 217 What: /sys/bus/platform/devices/*.ufs/device_descriptor/ufs_features
218 Date: February 2018 218 Date: February 2018
219 Contact: Stanislav Nijnikov <stanislav.n 219 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
220 Description: This file shows which features 220 Description: This file shows which features are supported by the device.
221 This is one of the UFS device 221 This is one of the UFS device descriptor parameters.
222 The full information about the 222 The full information about the descriptor could be
223 found at UFS specifications 2. 223 found at UFS specifications 2.1.
224 224
225 The file is read only. 225 The file is read only.
226 226
227 What: /sys/bus/platform/drivers/ufsh 227 What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/ffu_timeout
228 What: /sys/bus/platform/devices/*.uf 228 What: /sys/bus/platform/devices/*.ufs/device_descriptor/ffu_timeout
229 Date: February 2018 229 Date: February 2018
230 Contact: Stanislav Nijnikov <stanislav.n 230 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
231 Description: This file shows the FFU timeou 231 Description: This file shows the FFU timeout. This is one of the
232 UFS device descriptor paramete 232 UFS device descriptor parameters. The full information
233 about the descriptor could be 233 about the descriptor could be found at UFS specifications 2.1.
234 234
235 The file is read only. 235 The file is read only.
236 236
237 What: /sys/bus/platform/drivers/ufsh 237 What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/queue_depth
238 What: /sys/bus/platform/devices/*.uf 238 What: /sys/bus/platform/devices/*.ufs/device_descriptor/queue_depth
239 Date: February 2018 239 Date: February 2018
240 Contact: Stanislav Nijnikov <stanislav.n 240 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
241 Description: This file shows the device que 241 Description: This file shows the device queue depth. This is one of the
242 UFS device descriptor paramete 242 UFS device descriptor parameters. The full information
243 about the descriptor could be 243 about the descriptor could be found at UFS specifications 2.1.
244 244
245 The file is read only. 245 The file is read only.
246 246
247 What: /sys/bus/platform/drivers/ufsh 247 What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/device_version
248 What: /sys/bus/platform/devices/*.uf 248 What: /sys/bus/platform/devices/*.ufs/device_descriptor/device_version
249 Date: February 2018 249 Date: February 2018
250 Contact: Stanislav Nijnikov <stanislav.n 250 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
251 Description: This file shows the device ver 251 Description: This file shows the device version. This is one of the
252 UFS device descriptor paramete 252 UFS device descriptor parameters. The full information
253 about the descriptor could be 253 about the descriptor could be found at UFS specifications 2.1.
254 254
255 The file is read only. 255 The file is read only.
256 256
257 What: /sys/bus/platform/drivers/ufsh 257 What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/number_of_secure_wpa
258 What: /sys/bus/platform/devices/*.uf 258 What: /sys/bus/platform/devices/*.ufs/device_descriptor/number_of_secure_wpa
259 Date: February 2018 259 Date: February 2018
260 Contact: Stanislav Nijnikov <stanislav.n 260 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
261 Description: This file shows number of secu 261 Description: This file shows number of secure write protect areas
262 supported by the device. This 262 supported by the device. This is one of the UFS device
263 descriptor parameters. The ful 263 descriptor parameters. The full information about
264 the descriptor could be found 264 the descriptor could be found at UFS specifications 2.1.
265 265
266 The file is read only. 266 The file is read only.
267 267
268 What: /sys/bus/platform/drivers/ufsh 268 What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/psa_max_data_size
269 What: /sys/bus/platform/devices/*.uf 269 What: /sys/bus/platform/devices/*.ufs/device_descriptor/psa_max_data_size
270 Date: February 2018 270 Date: February 2018
271 Contact: Stanislav Nijnikov <stanislav.n 271 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
272 Description: This file shows the maximum am 272 Description: This file shows the maximum amount of data that may be
273 written during the pre-solderi 273 written during the pre-soldering phase of the PSA flow.
274 This is one of the UFS device 274 This is one of the UFS device descriptor parameters.
275 The full information about the 275 The full information about the descriptor could be found
276 at UFS specifications 2.1. 276 at UFS specifications 2.1.
277 277
278 The file is read only. 278 The file is read only.
279 279
280 What: /sys/bus/platform/drivers/ufsh 280 What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/psa_state_timeout
281 What: /sys/bus/platform/devices/*.uf 281 What: /sys/bus/platform/devices/*.ufs/device_descriptor/psa_state_timeout
282 Date: February 2018 282 Date: February 2018
283 Contact: Stanislav Nijnikov <stanislav.n 283 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
284 Description: This file shows the command ma 284 Description: This file shows the command maximum timeout for a change
285 in PSA state. This is one of t 285 in PSA state. This is one of the UFS device descriptor
286 parameters. The full informati 286 parameters. The full information about the descriptor could
287 be found at UFS specifications 287 be found at UFS specifications 2.1.
288 288
289 The file is read only. 289 The file is read only.
290 290
291 291
292 What: /sys/bus/platform/drivers/ufsh 292 What: /sys/bus/platform/drivers/ufshcd/*/interconnect_descriptor/unipro_version
293 What: /sys/bus/platform/devices/*.uf 293 What: /sys/bus/platform/devices/*.ufs/interconnect_descriptor/unipro_version
294 Date: February 2018 294 Date: February 2018
295 Contact: Stanislav Nijnikov <stanislav.n 295 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
296 Description: This file shows the MIPI UniPr 296 Description: This file shows the MIPI UniPro version number in BCD format.
297 This is one of the UFS interco 297 This is one of the UFS interconnect descriptor parameters.
298 The full information about the 298 The full information about the descriptor could be found at
299 UFS specifications 2.1. 299 UFS specifications 2.1.
300 300
301 The file is read only. 301 The file is read only.
302 302
303 What: /sys/bus/platform/drivers/ufsh 303 What: /sys/bus/platform/drivers/ufshcd/*/interconnect_descriptor/mphy_version
304 What: /sys/bus/platform/devices/*.uf 304 What: /sys/bus/platform/devices/*.ufs/interconnect_descriptor/mphy_version
305 Date: February 2018 305 Date: February 2018
306 Contact: Stanislav Nijnikov <stanislav.n 306 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
307 Description: This file shows the MIPI M-PHY 307 Description: This file shows the MIPI M-PHY version number in BCD format.
308 This is one of the UFS interco 308 This is one of the UFS interconnect descriptor parameters.
309 The full information about the 309 The full information about the descriptor could be found at
310 UFS specifications 2.1. 310 UFS specifications 2.1.
311 311
312 The file is read only. 312 The file is read only.
313 313
314 314
315 What: /sys/bus/platform/drivers/ufsh 315 What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/raw_device_capacity
316 What: /sys/bus/platform/devices/*.uf 316 What: /sys/bus/platform/devices/*.ufs/geometry_descriptor/raw_device_capacity
317 Date: February 2018 317 Date: February 2018
318 Contact: Stanislav Nijnikov <stanislav.n 318 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
319 Description: This file shows the total memo 319 Description: This file shows the total memory quantity available to
320 the user to configure the devi 320 the user to configure the device logical units. This is one
321 of the UFS geometry descriptor 321 of the UFS geometry descriptor parameters. The full
322 information about the descript 322 information about the descriptor could be found at
323 UFS specifications 2.1. 323 UFS specifications 2.1.
324 324
325 The file is read only. 325 The file is read only.
326 326
327 What: /sys/bus/platform/drivers/ufsh 327 What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/max_number_of_luns
328 What: /sys/bus/platform/devices/*.uf 328 What: /sys/bus/platform/devices/*.ufs/geometry_descriptor/max_number_of_luns
329 Date: February 2018 329 Date: February 2018
330 Contact: Stanislav Nijnikov <stanislav.n 330 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
331 Description: This file shows the maximum nu 331 Description: This file shows the maximum number of logical units
332 supported by the UFS device. T 332 supported by the UFS device. This is one of the UFS
333 geometry descriptor parameters 333 geometry descriptor parameters. The full information about
334 the descriptor could be found 334 the descriptor could be found at UFS specifications 2.1.
335 335
336 The file is read only. 336 The file is read only.
337 337
338 What: /sys/bus/platform/drivers/ufsh 338 What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/segment_size
339 What: /sys/bus/platform/devices/*.uf 339 What: /sys/bus/platform/devices/*.ufs/geometry_descriptor/segment_size
340 Date: February 2018 340 Date: February 2018
341 Contact: Stanislav Nijnikov <stanislav.n 341 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
342 Description: This file shows the segment si 342 Description: This file shows the segment size. This is one of the UFS
343 geometry descriptor parameters 343 geometry descriptor parameters. The full information about
344 the descriptor could be found 344 the descriptor could be found at UFS specifications 2.1.
345 345
346 The file is read only. 346 The file is read only.
347 347
348 What: /sys/bus/platform/drivers/ufsh 348 What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/allocation_unit_size
349 What: /sys/bus/platform/devices/*.uf 349 What: /sys/bus/platform/devices/*.ufs/geometry_descriptor/allocation_unit_size
350 Date: February 2018 350 Date: February 2018
351 Contact: Stanislav Nijnikov <stanislav.n 351 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
352 Description: This file shows the allocation 352 Description: This file shows the allocation unit size. This is one of
353 the UFS geometry descriptor pa 353 the UFS geometry descriptor parameters. The full information
354 about the descriptor could be 354 about the descriptor could be found at UFS specifications 2.1.
355 355
356 The file is read only. 356 The file is read only.
357 357
358 What: /sys/bus/platform/drivers/ufsh 358 What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/min_addressable_block_size
359 What: /sys/bus/platform/devices/*.uf 359 What: /sys/bus/platform/devices/*.ufs/geometry_descriptor/min_addressable_block_size
360 Date: February 2018 360 Date: February 2018
361 Contact: Stanislav Nijnikov <stanislav.n 361 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
362 Description: This file shows the minimum ad 362 Description: This file shows the minimum addressable block size. This
363 is one of the UFS geometry des 363 is one of the UFS geometry descriptor parameters. The full
364 information about the descript 364 information about the descriptor could be found at UFS
365 specifications 2.1. 365 specifications 2.1.
366 366
367 The file is read only. 367 The file is read only.
368 368
369 What: /sys/bus/platform/drivers/ufsh 369 What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/optimal_read_block_size
370 What: /sys/bus/platform/devices/*.uf 370 What: /sys/bus/platform/devices/*.ufs/geometry_descriptor/optimal_read_block_size
371 Date: February 2018 371 Date: February 2018
372 Contact: Stanislav Nijnikov <stanislav.n 372 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
373 Description: This file shows the optimal re 373 Description: This file shows the optimal read block size. This is one
374 of the UFS geometry descriptor 374 of the UFS geometry descriptor parameters. The full
375 information about the descript 375 information about the descriptor could be found at UFS
376 specifications 2.1. 376 specifications 2.1.
377 377
378 The file is read only. 378 The file is read only.
379 379
380 What: /sys/bus/platform/drivers/ufsh 380 What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/optimal_write_block_size
381 What: /sys/bus/platform/devices/*.uf 381 What: /sys/bus/platform/devices/*.ufs/geometry_descriptor/optimal_write_block_size
382 Date: February 2018 382 Date: February 2018
383 Contact: Stanislav Nijnikov <stanislav.n 383 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
384 Description: This file shows the optimal wr 384 Description: This file shows the optimal write block size. This is one
385 of the UFS geometry descriptor 385 of the UFS geometry descriptor parameters. The full
386 information about the descript 386 information about the descriptor could be found at UFS
387 specifications 2.1. 387 specifications 2.1.
388 388
389 The file is read only. 389 The file is read only.
390 390
391 What: /sys/bus/platform/drivers/ufsh 391 What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/max_in_buffer_size
392 What: /sys/bus/platform/devices/*.uf 392 What: /sys/bus/platform/devices/*.ufs/geometry_descriptor/max_in_buffer_size
393 Date: February 2018 393 Date: February 2018
394 Contact: Stanislav Nijnikov <stanislav.n 394 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
395 Description: This file shows the maximum da 395 Description: This file shows the maximum data-in buffer size. This
396 is one of the UFS geometry des 396 is one of the UFS geometry descriptor parameters. The full
397 information about the descript 397 information about the descriptor could be found at UFS
398 specifications 2.1. 398 specifications 2.1.
399 399
400 The file is read only. 400 The file is read only.
401 401
402 What: /sys/bus/platform/drivers/ufsh 402 What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/max_out_buffer_size
403 What: /sys/bus/platform/devices/*.uf 403 What: /sys/bus/platform/devices/*.ufs/geometry_descriptor/max_out_buffer_size
404 Date: February 2018 404 Date: February 2018
405 Contact: Stanislav Nijnikov <stanislav.n 405 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
406 Description: This file shows the maximum da 406 Description: This file shows the maximum data-out buffer size. This
407 is one of the UFS geometry des 407 is one of the UFS geometry descriptor parameters. The full
408 information about the descript 408 information about the descriptor could be found at UFS
409 specifications 2.1. 409 specifications 2.1.
410 410
411 The file is read only. 411 The file is read only.
412 412
413 What: /sys/bus/platform/drivers/ufsh 413 What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/rpmb_rw_size
414 What: /sys/bus/platform/devices/*.uf 414 What: /sys/bus/platform/devices/*.ufs/geometry_descriptor/rpmb_rw_size
415 Date: February 2018 415 Date: February 2018
416 Contact: Stanislav Nijnikov <stanislav.n 416 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
417 Description: This file shows the maximum nu 417 Description: This file shows the maximum number of RPMB frames allowed
418 in Security Protocol In/Out. T 418 in Security Protocol In/Out. This is one of the UFS geometry
419 descriptor parameters. The ful 419 descriptor parameters. The full information about the
420 descriptor could be found at U 420 descriptor could be found at UFS specifications 2.1.
421 421
422 The file is read only. 422 The file is read only.
423 423
424 What: /sys/bus/platform/drivers/ufsh 424 What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/dyn_capacity_resource_policy
425 What: /sys/bus/platform/devices/*.uf 425 What: /sys/bus/platform/devices/*.ufs/geometry_descriptor/dyn_capacity_resource_policy
426 Date: February 2018 426 Date: February 2018
427 Contact: Stanislav Nijnikov <stanislav.n 427 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
428 Description: This file shows the dynamic ca 428 Description: This file shows the dynamic capacity resource policy. This
429 is one of the UFS geometry des 429 is one of the UFS geometry descriptor parameters. The full
430 information about the descript 430 information about the descriptor could be found at
431 UFS specifications 2.1. 431 UFS specifications 2.1.
432 432
433 The file is read only. 433 The file is read only.
434 434
435 What: /sys/bus/platform/drivers/ufsh 435 What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/data_ordering
436 What: /sys/bus/platform/devices/*.uf 436 What: /sys/bus/platform/devices/*.ufs/geometry_descriptor/data_ordering
437 Date: February 2018 437 Date: February 2018
438 Contact: Stanislav Nijnikov <stanislav.n 438 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
439 Description: This file shows support for ou 439 Description: This file shows support for out-of-order data transfer.
440 This is one of the UFS geometr 440 This is one of the UFS geometry descriptor parameters.
441 The full information about the 441 The full information about the descriptor could be found at
442 UFS specifications 2.1. 442 UFS specifications 2.1.
443 443
444 The file is read only. 444 The file is read only.
445 445
446 What: /sys/bus/platform/drivers/ufsh 446 What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/max_number_of_contexts
447 What: /sys/bus/platform/devices/*.uf 447 What: /sys/bus/platform/devices/*.ufs/geometry_descriptor/max_number_of_contexts
448 Date: February 2018 448 Date: February 2018
449 Contact: Stanislav Nijnikov <stanislav.n 449 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
450 Description: This file shows maximum availa 450 Description: This file shows maximum available number of contexts which
451 are supported by the device. T 451 are supported by the device. This is one of the UFS geometry
452 descriptor parameters. The ful 452 descriptor parameters. The full information about the
453 descriptor could be found at U 453 descriptor could be found at UFS specifications 2.1.
454 454
455 The file is read only. 455 The file is read only.
456 456
457 What: /sys/bus/platform/drivers/ufsh 457 What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/sys_data_tag_unit_size
458 What: /sys/bus/platform/devices/*.uf 458 What: /sys/bus/platform/devices/*.ufs/geometry_descriptor/sys_data_tag_unit_size
459 Date: February 2018 459 Date: February 2018
460 Contact: Stanislav Nijnikov <stanislav.n 460 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
461 Description: This file shows system data ta 461 Description: This file shows system data tag unit size. This is one of
462 the UFS geometry descriptor pa 462 the UFS geometry descriptor parameters. The full information
463 about the descriptor could be 463 about the descriptor could be found at UFS specifications 2.1.
464 464
465 The file is read only. 465 The file is read only.
466 466
467 What: /sys/bus/platform/drivers/ufsh 467 What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/sys_data_tag_resource_size
468 What: /sys/bus/platform/devices/*.uf 468 What: /sys/bus/platform/devices/*.ufs/geometry_descriptor/sys_data_tag_resource_size
469 Date: February 2018 469 Date: February 2018
470 Contact: Stanislav Nijnikov <stanislav.n 470 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
471 Description: This file shows maximum storag 471 Description: This file shows maximum storage area size allocated by
472 the device to handle system da 472 the device to handle system data by the tagging mechanism.
473 This is one of the UFS geometr 473 This is one of the UFS geometry descriptor parameters.
474 The full information about the 474 The full information about the descriptor could be found at
475 UFS specifications 2.1. 475 UFS specifications 2.1.
476 476
477 The file is read only. 477 The file is read only.
478 478
479 What: /sys/bus/platform/drivers/ufsh 479 What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/secure_removal_types
480 What: /sys/bus/platform/devices/*.uf 480 What: /sys/bus/platform/devices/*.ufs/geometry_descriptor/secure_removal_types
481 Date: February 2018 481 Date: February 2018
482 Contact: Stanislav Nijnikov <stanislav.n 482 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
483 Description: This file shows supported secu 483 Description: This file shows supported secure removal types. This is
484 one of the UFS geometry descri 484 one of the UFS geometry descriptor parameters. The full
485 information about the descript 485 information about the descriptor could be found at
486 UFS specifications 2.1. 486 UFS specifications 2.1.
487 487
488 The file is read only. 488 The file is read only.
489 489
490 What: /sys/bus/platform/drivers/ufsh 490 What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/memory_types
491 What: /sys/bus/platform/devices/*.uf 491 What: /sys/bus/platform/devices/*.ufs/geometry_descriptor/memory_types
492 Date: February 2018 492 Date: February 2018
493 Contact: Stanislav Nijnikov <stanislav.n 493 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
494 Description: This file shows supported memo 494 Description: This file shows supported memory types. This is one of
495 the UFS geometry descriptor pa 495 the UFS geometry descriptor parameters. The full
496 information about the descript 496 information about the descriptor could be found at
497 UFS specifications 2.1. 497 UFS specifications 2.1.
498 498
499 The file is read only. 499 The file is read only.
500 500
501 What: /sys/bus/platform/drivers/ufsh 501 What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/*_memory_max_alloc_units
502 What: /sys/bus/platform/devices/*.uf 502 What: /sys/bus/platform/devices/*.ufs/geometry_descriptor/*_memory_max_alloc_units
503 Date: February 2018 503 Date: February 2018
504 Contact: Stanislav Nijnikov <stanislav.n 504 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
505 Description: This file shows the maximum nu 505 Description: This file shows the maximum number of allocation units for
506 different memory types (system 506 different memory types (system code, non persistent,
507 enhanced type 1-4). This is on 507 enhanced type 1-4). This is one of the UFS geometry
508 descriptor parameters. The ful 508 descriptor parameters. The full information about the
509 descriptor could be found at U 509 descriptor could be found at UFS specifications 2.1.
510 510
511 The file is read only. 511 The file is read only.
512 512
513 What: /sys/bus/platform/drivers/ufsh 513 What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/*_memory_capacity_adjustment_factor
514 What: /sys/bus/platform/devices/*.uf 514 What: /sys/bus/platform/devices/*.ufs/geometry_descriptor/*_memory_capacity_adjustment_factor
515 Date: February 2018 515 Date: February 2018
516 Contact: Stanislav Nijnikov <stanislav.n 516 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
517 Description: This file shows the memory cap 517 Description: This file shows the memory capacity adjustment factor for
518 different memory types (system 518 different memory types (system code, non persistent,
519 enhanced type 1-4). This is on 519 enhanced type 1-4). This is one of the UFS geometry
520 descriptor parameters. The ful 520 descriptor parameters. The full information about the
521 descriptor could be found at U 521 descriptor could be found at UFS specifications 2.1.
522 522
523 The file is read only. 523 The file is read only.
524 524
525 525
526 What: /sys/bus/platform/drivers/ufsh 526 What: /sys/bus/platform/drivers/ufshcd/*/health_descriptor/eol_info
527 What: /sys/bus/platform/devices/*.uf 527 What: /sys/bus/platform/devices/*.ufs/health_descriptor/eol_info
528 Date: February 2018 528 Date: February 2018
529 Contact: Stanislav Nijnikov <stanislav.n 529 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
530 Description: This file shows preend of life 530 Description: This file shows preend of life information. This is one
531 of the UFS health descriptor p 531 of the UFS health descriptor parameters. The full
532 information about the descript 532 information about the descriptor could be found at
533 UFS specifications 2.1. 533 UFS specifications 2.1.
534 534
535 The file is read only. 535 The file is read only.
536 536
537 What: /sys/bus/platform/drivers/ufsh 537 What: /sys/bus/platform/drivers/ufshcd/*/health_descriptor/life_time_estimation_a
538 What: /sys/bus/platform/devices/*.uf 538 What: /sys/bus/platform/devices/*.ufs/health_descriptor/life_time_estimation_a
539 Date: February 2018 539 Date: February 2018
540 Contact: Stanislav Nijnikov <stanislav.n 540 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
541 Description: This file shows indication of 541 Description: This file shows indication of the device life time
542 (method a). This is one of the 542 (method a). This is one of the UFS health descriptor
543 parameters. The full informati 543 parameters. The full information about the descriptor
544 could be found at UFS specific 544 could be found at UFS specifications 2.1.
545 545
546 The file is read only. 546 The file is read only.
547 547
548 What: /sys/bus/platform/drivers/ufsh 548 What: /sys/bus/platform/drivers/ufshcd/*/health_descriptor/life_time_estimation_b
549 What: /sys/bus/platform/devices/*.uf 549 What: /sys/bus/platform/devices/*.ufs/health_descriptor/life_time_estimation_b
550 Date: February 2018 550 Date: February 2018
551 Contact: Stanislav Nijnikov <stanislav.n 551 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
552 Description: This file shows indication of 552 Description: This file shows indication of the device life time
553 (method b). This is one of the 553 (method b). This is one of the UFS health descriptor
554 parameters. The full informati 554 parameters. The full information about the descriptor
555 could be found at UFS specific 555 could be found at UFS specifications 2.1.
556 556
557 The file is read only. 557 The file is read only.
558 558
559 559
560 What: /sys/bus/platform/drivers/ufsh 560 What: /sys/bus/platform/drivers/ufshcd/*/power_descriptor/active_icc_levels_vcc*
561 What: /sys/bus/platform/devices/*.uf 561 What: /sys/bus/platform/devices/*.ufs/power_descriptor/active_icc_levels_vcc*
562 Date: February 2018 562 Date: February 2018
563 Contact: Stanislav Nijnikov <stanislav.n 563 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
564 Description: This file shows maximum VCC, V 564 Description: This file shows maximum VCC, VCCQ and VCCQ2 value for
565 active ICC levels from 0 to 15 565 active ICC levels from 0 to 15. This is one of the UFS
566 power descriptor parameters. T 566 power descriptor parameters. The full information about
567 the descriptor could be found 567 the descriptor could be found at UFS specifications 2.1.
568 568
569 The file is read only. 569 The file is read only.
570 570
571 571
572 What: /sys/bus/platform/drivers/ufsh 572 What: /sys/bus/platform/drivers/ufshcd/*/string_descriptors/manufacturer_name
573 What: /sys/bus/platform/devices/*.uf 573 What: /sys/bus/platform/devices/*.ufs/string_descriptors/manufacturer_name
574 Date: February 2018 574 Date: February 2018
575 Contact: Stanislav Nijnikov <stanislav.n 575 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
576 Description: This file contains a device ma 576 Description: This file contains a device manufacturer name string.
577 The full information about the 577 The full information about the descriptor could be found at
578 UFS specifications 2.1. 578 UFS specifications 2.1.
579 579
580 The file is read only. 580 The file is read only.
581 581
582 What: /sys/bus/platform/drivers/ufsh 582 What: /sys/bus/platform/drivers/ufshcd/*/string_descriptors/product_name
583 What: /sys/bus/platform/devices/*.uf 583 What: /sys/bus/platform/devices/*.ufs/string_descriptors/product_name
584 Date: February 2018 584 Date: February 2018
585 Contact: Stanislav Nijnikov <stanislav.n 585 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
586 Description: This file contains a product n 586 Description: This file contains a product name string. The full information
587 about the descriptor could be 587 about the descriptor could be found at UFS specifications 2.1.
588 588
589 The file is read only. 589 The file is read only.
590 590
591 What: /sys/bus/platform/drivers/ufsh 591 What: /sys/bus/platform/drivers/ufshcd/*/string_descriptors/oem_id
592 What: /sys/bus/platform/devices/*.uf 592 What: /sys/bus/platform/devices/*.ufs/string_descriptors/oem_id
593 Date: February 2018 593 Date: February 2018
594 Contact: Stanislav Nijnikov <stanislav.n 594 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
595 Description: This file contains a OEM ID st 595 Description: This file contains a OEM ID string. The full information
596 about the descriptor could be 596 about the descriptor could be found at UFS specifications 2.1.
597 597
598 The file is read only. 598 The file is read only.
599 599
600 What: /sys/bus/platform/drivers/ufsh 600 What: /sys/bus/platform/drivers/ufshcd/*/string_descriptors/serial_number
601 What: /sys/bus/platform/devices/*.uf 601 What: /sys/bus/platform/devices/*.ufs/string_descriptors/serial_number
602 Date: February 2018 602 Date: February 2018
603 Contact: Stanislav Nijnikov <stanislav.n 603 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
604 Description: This file contains a device se 604 Description: This file contains a device serial number string. The full
605 information about the descript 605 information about the descriptor could be found at
606 UFS specifications 2.1. 606 UFS specifications 2.1.
607 607
608 The file is read only. 608 The file is read only.
609 609
610 What: /sys/bus/platform/drivers/ufsh 610 What: /sys/bus/platform/drivers/ufshcd/*/string_descriptors/product_revision
611 What: /sys/bus/platform/devices/*.uf 611 What: /sys/bus/platform/devices/*.ufs/string_descriptors/product_revision
612 Date: February 2018 612 Date: February 2018
613 Contact: Stanislav Nijnikov <stanislav.n 613 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
614 Description: This file contains a product r 614 Description: This file contains a product revision string. The full
615 information about the descript 615 information about the descriptor could be found at
616 UFS specifications 2.1. 616 UFS specifications 2.1.
617 617
618 The file is read only. 618 The file is read only.
619 619
620 620
621 What: /sys/class/scsi_device/*/devic 621 What: /sys/class/scsi_device/*/device/unit_descriptor/boot_lun_id
622 Date: February 2018 622 Date: February 2018
623 Contact: Stanislav Nijnikov <stanislav.n 623 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
624 Description: This file shows boot LUN infor 624 Description: This file shows boot LUN information. This is one of
625 the UFS unit descriptor parame 625 the UFS unit descriptor parameters. The full information
626 about the descriptor could be 626 about the descriptor could be found at UFS specifications 2.1.
627 627
628 The file is read only. 628 The file is read only.
629 629
630 What: /sys/class/scsi_device/*/devic 630 What: /sys/class/scsi_device/*/device/unit_descriptor/lun_write_protect
631 Date: February 2018 631 Date: February 2018
632 Contact: Stanislav Nijnikov <stanislav.n 632 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
633 Description: This file shows LUN write prot 633 Description: This file shows LUN write protection status. This is one of
634 the UFS unit descriptor parame 634 the UFS unit descriptor parameters. The full information
635 about the descriptor could be 635 about the descriptor could be found at UFS specifications 2.1.
636 636
637 The file is read only. 637 The file is read only.
638 638
639 What: /sys/class/scsi_device/*/devic 639 What: /sys/class/scsi_device/*/device/unit_descriptor/lun_queue_depth
640 Date: February 2018 640 Date: February 2018
641 Contact: Stanislav Nijnikov <stanislav.n 641 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
642 Description: This file shows LUN queue dept 642 Description: This file shows LUN queue depth. This is one of the UFS
643 unit descriptor parameters. Th 643 unit descriptor parameters. The full information about
644 the descriptor could be found 644 the descriptor could be found at UFS specifications 2.1.
645 645
646 The file is read only. 646 The file is read only.
647 647
648 What: /sys/class/scsi_device/*/devic 648 What: /sys/class/scsi_device/*/device/unit_descriptor/psa_sensitive
649 Date: February 2018 649 Date: February 2018
650 Contact: Stanislav Nijnikov <stanislav.n 650 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
651 Description: This file shows PSA sensitivit 651 Description: This file shows PSA sensitivity. This is one of the UFS
652 unit descriptor parameters. Th 652 unit descriptor parameters. The full information about
653 the descriptor could be found 653 the descriptor could be found at UFS specifications 2.1.
654 654
655 The file is read only. 655 The file is read only.
656 656
657 What: /sys/class/scsi_device/*/devic 657 What: /sys/class/scsi_device/*/device/unit_descriptor/lun_memory_type
658 Date: February 2018 658 Date: February 2018
659 Contact: Stanislav Nijnikov <stanislav.n 659 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
660 Description: This file shows LUN memory typ 660 Description: This file shows LUN memory type. This is one of the UFS
661 unit descriptor parameters. Th 661 unit descriptor parameters. The full information about
662 the descriptor could be found 662 the descriptor could be found at UFS specifications 2.1.
663 663
664 The file is read only. 664 The file is read only.
665 665
666 What: /sys/class/scsi_device/*/devic 666 What: /sys/class/scsi_device/*/device/unit_descriptor/data_reliability
667 Date: February 2018 667 Date: February 2018
668 Contact: Stanislav Nijnikov <stanislav.n 668 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
669 Description: This file defines the device b 669 Description: This file defines the device behavior when a power failure
670 occurs during a write operatio 670 occurs during a write operation. This is one of the UFS
671 unit descriptor parameters. Th 671 unit descriptor parameters. The full information about
672 the descriptor could be found 672 the descriptor could be found at UFS specifications 2.1.
673 673
674 The file is read only. 674 The file is read only.
675 675
676 What: /sys/class/scsi_device/*/devic 676 What: /sys/class/scsi_device/*/device/unit_descriptor/logical_block_size
677 Date: February 2018 677 Date: February 2018
678 Contact: Stanislav Nijnikov <stanislav.n 678 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
679 Description: This file shows the size of ad 679 Description: This file shows the size of addressable logical blocks
680 (calculated as an exponent wit 680 (calculated as an exponent with base 2). This is one of
681 the UFS unit descriptor parame 681 the UFS unit descriptor parameters. The full information about
682 the descriptor could be found 682 the descriptor could be found at UFS specifications 2.1.
683 683
684 The file is read only. 684 The file is read only.
685 685
686 What: /sys/class/scsi_device/*/devic 686 What: /sys/class/scsi_device/*/device/unit_descriptor/logical_block_count
687 Date: February 2018 687 Date: February 2018
688 Contact: Stanislav Nijnikov <stanislav.n 688 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
689 Description: This file shows total number o 689 Description: This file shows total number of addressable logical blocks.
690 This is one of the UFS unit de 690 This is one of the UFS unit descriptor parameters. The full
691 information about the descript 691 information about the descriptor could be found at
692 UFS specifications 2.1. 692 UFS specifications 2.1.
693 693
694 The file is read only. 694 The file is read only.
695 695
696 What: /sys/class/scsi_device/*/devic 696 What: /sys/class/scsi_device/*/device/unit_descriptor/erase_block_size
697 Date: February 2018 697 Date: February 2018
698 Contact: Stanislav Nijnikov <stanislav.n 698 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
699 Description: This file shows the erase bloc 699 Description: This file shows the erase block size. This is one of
700 the UFS unit descriptor parame 700 the UFS unit descriptor parameters. The full information
701 about the descriptor could be 701 about the descriptor could be found at UFS specifications 2.1.
702 702
703 The file is read only. 703 The file is read only.
704 704
705 What: /sys/class/scsi_device/*/devic 705 What: /sys/class/scsi_device/*/device/unit_descriptor/provisioning_type
706 Date: February 2018 706 Date: February 2018
707 Contact: Stanislav Nijnikov <stanislav.n 707 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
708 Description: This file shows the thin provi 708 Description: This file shows the thin provisioning type. This is one of
709 the UFS unit descriptor parame 709 the UFS unit descriptor parameters. The full information
710 about the descriptor could be 710 about the descriptor could be found at UFS specifications 2.1.
711 711
712 The file is read only. 712 The file is read only.
713 713
714 What: /sys/class/scsi_device/*/devic 714 What: /sys/class/scsi_device/*/device/unit_descriptor/physical_memory_resourse_count
715 Date: February 2018 715 Date: February 2018
716 Contact: Stanislav Nijnikov <stanislav.n 716 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
717 Description: This file shows the total phys 717 Description: This file shows the total physical memory resources. This is
718 one of the UFS unit descriptor 718 one of the UFS unit descriptor parameters. The full information
719 about the descriptor could be 719 about the descriptor could be found at UFS specifications 2.1.
720 720
721 The file is read only. 721 The file is read only.
722 722
723 What: /sys/class/scsi_device/*/devic 723 What: /sys/class/scsi_device/*/device/unit_descriptor/context_capabilities
724 Date: February 2018 724 Date: February 2018
725 Contact: Stanislav Nijnikov <stanislav.n 725 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
726 Description: This file shows the context ca 726 Description: This file shows the context capabilities. This is one of
727 the UFS unit descriptor parame 727 the UFS unit descriptor parameters. The full information
728 about the descriptor could be 728 about the descriptor could be found at UFS specifications 2.1.
729 729
730 The file is read only. 730 The file is read only.
731 731
732 What: /sys/class/scsi_device/*/devic 732 What: /sys/class/scsi_device/*/device/unit_descriptor/large_unit_granularity
733 Date: February 2018 733 Date: February 2018
734 Contact: Stanislav Nijnikov <stanislav.n 734 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
735 Description: This file shows the granularit 735 Description: This file shows the granularity of the LUN. This is one of
736 the UFS unit descriptor parame 736 the UFS unit descriptor parameters. The full information
737 about the descriptor could be 737 about the descriptor could be found at UFS specifications 2.1.
738 738
739 The file is read only. 739 The file is read only.
740 740
741 741
742 What: /sys/bus/platform/drivers/ufsh 742 What: /sys/bus/platform/drivers/ufshcd/*/flags/device_init
743 What: /sys/bus/platform/devices/*.uf 743 What: /sys/bus/platform/devices/*.ufs/flags/device_init
744 Date: February 2018 744 Date: February 2018
745 Contact: Stanislav Nijnikov <stanislav.n 745 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
746 Description: This file shows the device ini 746 Description: This file shows the device init status. The full information
747 about the flag could be found 747 about the flag could be found at UFS specifications 2.1.
748 748
749 The file is read only. 749 The file is read only.
750 750
751 What: /sys/bus/platform/drivers/ufsh 751 What: /sys/bus/platform/drivers/ufshcd/*/flags/permanent_wpe
752 What: /sys/bus/platform/devices/*.uf 752 What: /sys/bus/platform/devices/*.ufs/flags/permanent_wpe
753 Date: February 2018 753 Date: February 2018
754 Contact: Stanislav Nijnikov <stanislav.n 754 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
755 Description: This file shows whether perman 755 Description: This file shows whether permanent write protection is enabled.
756 The full information about the 756 The full information about the flag could be found at
757 UFS specifications 2.1. 757 UFS specifications 2.1.
758 758
759 The file is read only. 759 The file is read only.
760 760
761 What: /sys/bus/platform/drivers/ufsh 761 What: /sys/bus/platform/drivers/ufshcd/*/flags/power_on_wpe
762 What: /sys/bus/platform/devices/*.uf 762 What: /sys/bus/platform/devices/*.ufs/flags/power_on_wpe
763 Date: February 2018 763 Date: February 2018
764 Contact: Stanislav Nijnikov <stanislav.n 764 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
765 Description: This file shows whether write 765 Description: This file shows whether write protection is enabled on all
766 logical units configured as po 766 logical units configured as power on write protected. The
767 full information about the fla 767 full information about the flag could be found at
768 UFS specifications 2.1. 768 UFS specifications 2.1.
769 769
770 The file is read only. 770 The file is read only.
771 771
772 What: /sys/bus/platform/drivers/ufsh 772 What: /sys/bus/platform/drivers/ufshcd/*/flags/bkops_enable
773 What: /sys/bus/platform/devices/*.uf 773 What: /sys/bus/platform/devices/*.ufs/flags/bkops_enable
774 Date: February 2018 774 Date: February 2018
775 Contact: Stanislav Nijnikov <stanislav.n 775 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
776 Description: This file shows whether the de 776 Description: This file shows whether the device background operations are
777 enabled. The full information 777 enabled. The full information about the flag could be
778 found at UFS specifications 2. 778 found at UFS specifications 2.1.
779 779
780 The file is read only. 780 The file is read only.
781 781
782 What: /sys/bus/platform/drivers/ufsh 782 What: /sys/bus/platform/drivers/ufshcd/*/flags/life_span_mode_enable
783 What: /sys/bus/platform/devices/*.uf 783 What: /sys/bus/platform/devices/*.ufs/flags/life_span_mode_enable
784 Date: February 2018 784 Date: February 2018
785 Contact: Stanislav Nijnikov <stanislav.n 785 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
786 Description: This file shows whether the de 786 Description: This file shows whether the device life span mode is enabled.
787 The full information about the 787 The full information about the flag could be found at
788 UFS specifications 2.1. 788 UFS specifications 2.1.
789 789
790 The file is read only. 790 The file is read only.
791 791
792 What: /sys/bus/platform/drivers/ufsh 792 What: /sys/bus/platform/drivers/ufshcd/*/flags/phy_resource_removal
793 What: /sys/bus/platform/devices/*.uf 793 What: /sys/bus/platform/devices/*.ufs/flags/phy_resource_removal
794 Date: February 2018 794 Date: February 2018
795 Contact: Stanislav Nijnikov <stanislav.n 795 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
796 Description: This file shows whether physic 796 Description: This file shows whether physical resource removal is enable.
797 The full information about the 797 The full information about the flag could be found at
798 UFS specifications 2.1. 798 UFS specifications 2.1.
799 799
800 The file is read only. 800 The file is read only.
801 801
802 What: /sys/bus/platform/drivers/ufsh 802 What: /sys/bus/platform/drivers/ufshcd/*/flags/busy_rtc
803 What: /sys/bus/platform/devices/*.uf 803 What: /sys/bus/platform/devices/*.ufs/flags/busy_rtc
804 Date: February 2018 804 Date: February 2018
805 Contact: Stanislav Nijnikov <stanislav.n 805 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
806 Description: This file shows whether the de 806 Description: This file shows whether the device is executing internal
807 operation related to real time 807 operation related to real time clock. The full information
808 about the flag could be found 808 about the flag could be found at UFS specifications 2.1.
809 809
810 The file is read only. 810 The file is read only.
811 811
812 What: /sys/bus/platform/drivers/ufsh 812 What: /sys/bus/platform/drivers/ufshcd/*/flags/disable_fw_update
813 What: /sys/bus/platform/devices/*.uf 813 What: /sys/bus/platform/devices/*.ufs/flags/disable_fw_update
814 Date: February 2018 814 Date: February 2018
815 Contact: Stanislav Nijnikov <stanislav.n 815 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
816 Description: This file shows whether the de 816 Description: This file shows whether the device FW update is permanently
817 disabled. The full information 817 disabled. The full information about the flag could be found
818 at UFS specifications 2.1. 818 at UFS specifications 2.1.
819 819
820 The file is read only. 820 The file is read only.
821 821
822 822
823 What: /sys/bus/platform/drivers/ufsh 823 What: /sys/bus/platform/drivers/ufshcd/*/attributes/boot_lun_enabled
824 What: /sys/bus/platform/devices/*.uf 824 What: /sys/bus/platform/devices/*.ufs/attributes/boot_lun_enabled
825 Date: February 2018 825 Date: February 2018
826 Contact: Stanislav Nijnikov <stanislav.n 826 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
827 Description: This file provides the boot lu 827 Description: This file provides the boot lun enabled UFS device attribute.
828 The full information about the 828 The full information about the attribute could be found at
829 UFS specifications 2.1. 829 UFS specifications 2.1.
830 830
831 The file is read only. 831 The file is read only.
832 832
833 What: /sys/bus/platform/drivers/ufsh 833 What: /sys/bus/platform/drivers/ufshcd/*/attributes/current_power_mode
834 What: /sys/bus/platform/devices/*.uf 834 What: /sys/bus/platform/devices/*.ufs/attributes/current_power_mode
835 Date: February 2018 835 Date: February 2018
836 Contact: Stanislav Nijnikov <stanislav.n 836 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
837 Description: This file provides the current 837 Description: This file provides the current power mode UFS device attribute.
838 The full information about the 838 The full information about the attribute could be found at
839 UFS specifications 2.1. 839 UFS specifications 2.1.
840 840
841 The file is read only. 841 The file is read only.
842 842
843 What: /sys/bus/platform/drivers/ufsh 843 What: /sys/bus/platform/drivers/ufshcd/*/attributes/active_icc_level
844 What: /sys/bus/platform/devices/*.uf 844 What: /sys/bus/platform/devices/*.ufs/attributes/active_icc_level
845 Date: February 2018 845 Date: February 2018
846 Contact: Stanislav Nijnikov <stanislav.n 846 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
847 Description: This file provides the active 847 Description: This file provides the active icc level UFS device attribute.
848 The full information about the 848 The full information about the attribute could be found at
849 UFS specifications 2.1. 849 UFS specifications 2.1.
850 850
851 The file is read only. 851 The file is read only.
852 852
853 What: /sys/bus/platform/drivers/ufsh 853 What: /sys/bus/platform/drivers/ufshcd/*/attributes/ooo_data_enabled
854 What: /sys/bus/platform/devices/*.uf 854 What: /sys/bus/platform/devices/*.ufs/attributes/ooo_data_enabled
855 Date: February 2018 855 Date: February 2018
856 Contact: Stanislav Nijnikov <stanislav.n 856 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
857 Description: This file provides the out of 857 Description: This file provides the out of order data transfer enabled UFS
858 device attribute. The full inf 858 device attribute. The full information about the attribute
859 could be found at UFS specific 859 could be found at UFS specifications 2.1.
860 860
861 The file is read only. 861 The file is read only.
862 862
863 What: /sys/bus/platform/drivers/ufsh 863 What: /sys/bus/platform/drivers/ufshcd/*/attributes/bkops_status
864 What: /sys/bus/platform/devices/*.uf 864 What: /sys/bus/platform/devices/*.ufs/attributes/bkops_status
865 Date: February 2018 865 Date: February 2018
866 Contact: Stanislav Nijnikov <stanislav.n 866 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
867 Description: This file provides the backgro 867 Description: This file provides the background operations status UFS device
868 attribute. The full informatio 868 attribute. The full information about the attribute could
869 be found at UFS specifications 869 be found at UFS specifications 2.1.
870 870
871 The file is read only. 871 The file is read only.
872 872
873 What: /sys/bus/platform/drivers/ufsh 873 What: /sys/bus/platform/drivers/ufshcd/*/attributes/purge_status
874 What: /sys/bus/platform/devices/*.uf 874 What: /sys/bus/platform/devices/*.ufs/attributes/purge_status
875 Date: February 2018 875 Date: February 2018
876 Contact: Stanislav Nijnikov <stanislav.n 876 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
877 Description: This file provides the purge o 877 Description: This file provides the purge operation status UFS device
878 attribute. The full informatio 878 attribute. The full information about the attribute could
879 be found at UFS specifications 879 be found at UFS specifications 2.1.
880 880
881 The file is read only. 881 The file is read only.
882 882
883 What: /sys/bus/platform/drivers/ufsh 883 What: /sys/bus/platform/drivers/ufshcd/*/attributes/max_data_in_size
884 What: /sys/bus/platform/devices/*.uf 884 What: /sys/bus/platform/devices/*.ufs/attributes/max_data_in_size
885 Date: February 2018 885 Date: February 2018
886 Contact: Stanislav Nijnikov <stanislav.n 886 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
887 Description: This file shows the maximum da 887 Description: This file shows the maximum data size in a DATA IN
888 UPIU. The full information abo 888 UPIU. The full information about the attribute could
889 be found at UFS specifications 889 be found at UFS specifications 2.1.
890 890
891 The file is read only. 891 The file is read only.
892 892
893 What: /sys/bus/platform/drivers/ufsh 893 What: /sys/bus/platform/drivers/ufshcd/*/attributes/max_data_out_size
894 What: /sys/bus/platform/devices/*.uf 894 What: /sys/bus/platform/devices/*.ufs/attributes/max_data_out_size
895 Date: February 2018 895 Date: February 2018
896 Contact: Stanislav Nijnikov <stanislav.n 896 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
897 Description: This file shows the maximum nu 897 Description: This file shows the maximum number of bytes that can be
898 requested with a READY TO TRAN 898 requested with a READY TO TRANSFER UPIU. The full information
899 about the attribute could be f 899 about the attribute could be found at UFS specifications 2.1.
900 900
901 The file is read only. 901 The file is read only.
902 902
903 What: /sys/bus/platform/drivers/ufsh 903 What: /sys/bus/platform/drivers/ufshcd/*/attributes/reference_clock_frequency
904 What: /sys/bus/platform/devices/*.uf 904 What: /sys/bus/platform/devices/*.ufs/attributes/reference_clock_frequency
905 Date: February 2018 905 Date: February 2018
906 Contact: Stanislav Nijnikov <stanislav.n 906 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
907 Description: This file provides the referen 907 Description: This file provides the reference clock frequency UFS device
908 attribute. The full informatio 908 attribute. The full information about the attribute could
909 be found at UFS specifications 909 be found at UFS specifications 2.1.
910 910
911 The file is read only. 911 The file is read only.
912 912
913 What: /sys/bus/platform/drivers/ufsh 913 What: /sys/bus/platform/drivers/ufshcd/*/attributes/configuration_descriptor_lock
914 What: /sys/bus/platform/devices/*.uf 914 What: /sys/bus/platform/devices/*.ufs/attributes/configuration_descriptor_lock
915 Date: February 2018 915 Date: February 2018
916 Contact: Stanislav Nijnikov <stanislav.n 916 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
917 Description: This file shows whether the co 917 Description: This file shows whether the configuration descriptor is locked.
918 The full information about the 918 The full information about the attribute could be found at
919 UFS specifications 2.1. The fi 919 UFS specifications 2.1. The file is read only.
920 920
921 What: /sys/bus/platform/drivers/ufsh 921 What: /sys/bus/platform/drivers/ufshcd/*/attributes/max_number_of_rtt
922 What: /sys/bus/platform/devices/*.uf 922 What: /sys/bus/platform/devices/*.ufs/attributes/max_number_of_rtt
923 Date: May 2024 !! 923 Date: February 2018
924 Contact: Avri Altman <avri.altman@wdc.co !! 924 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
925 Description: This file provides the maximum 925 Description: This file provides the maximum current number of
926 outstanding RTTs in device tha !! 926 outstanding RTTs in device that is allowed. The full
927 read-write persistent attribut !! 927 information about the attribute could be found at
928 manufacturing. It shall not be !! 928 UFS specifications 2.1.
929 bDeviceRTTCap value, and it ma <<
930 empty. <<
931 929
932 The file is read write. !! 930 The file is read only.
933 931
934 What: /sys/bus/platform/drivers/ufsh 932 What: /sys/bus/platform/drivers/ufshcd/*/attributes/exception_event_control
935 What: /sys/bus/platform/devices/*.uf 933 What: /sys/bus/platform/devices/*.ufs/attributes/exception_event_control
936 Date: February 2018 934 Date: February 2018
937 Contact: Stanislav Nijnikov <stanislav.n 935 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
938 Description: This file provides the excepti 936 Description: This file provides the exception event control UFS device
939 attribute. The full informatio 937 attribute. The full information about the attribute could
940 be found at UFS specifications 938 be found at UFS specifications 2.1.
941 939
942 The file is read only. 940 The file is read only.
943 941
944 What: /sys/bus/platform/drivers/ufsh 942 What: /sys/bus/platform/drivers/ufshcd/*/attributes/exception_event_status
945 What: /sys/bus/platform/devices/*.uf 943 What: /sys/bus/platform/devices/*.ufs/attributes/exception_event_status
946 Date: February 2018 944 Date: February 2018
947 Contact: Stanislav Nijnikov <stanislav.n 945 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
948 Description: This file provides the excepti 946 Description: This file provides the exception event status UFS device
949 attribute. The full informatio 947 attribute. The full information about the attribute could
950 be found at UFS specifications 948 be found at UFS specifications 2.1.
951 949
952 The file is read only. 950 The file is read only.
953 951
954 What: /sys/bus/platform/drivers/ufsh 952 What: /sys/bus/platform/drivers/ufshcd/*/attributes/ffu_status
955 What: /sys/bus/platform/devices/*.uf 953 What: /sys/bus/platform/devices/*.ufs/attributes/ffu_status
956 Date: February 2018 954 Date: February 2018
957 Contact: Stanislav Nijnikov <stanislav.n 955 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
958 Description: This file provides the ffu sta 956 Description: This file provides the ffu status UFS device attribute.
959 The full information about the 957 The full information about the attribute could be found at
960 UFS specifications 2.1. 958 UFS specifications 2.1.
961 959
962 The file is read only. 960 The file is read only.
963 961
964 What: /sys/bus/platform/drivers/ufsh 962 What: /sys/bus/platform/drivers/ufshcd/*/attributes/psa_state
965 What: /sys/bus/platform/devices/*.uf 963 What: /sys/bus/platform/devices/*.ufs/attributes/psa_state
966 Date: February 2018 964 Date: February 2018
967 Contact: Stanislav Nijnikov <stanislav.n 965 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
968 Description: This file show the PSA feature 966 Description: This file show the PSA feature status. The full information
969 about the attribute could be f 967 about the attribute could be found at UFS specifications 2.1.
970 968
971 The file is read only. 969 The file is read only.
972 970
973 What: /sys/bus/platform/drivers/ufsh 971 What: /sys/bus/platform/drivers/ufshcd/*/attributes/psa_data_size
974 What: /sys/bus/platform/devices/*.uf 972 What: /sys/bus/platform/devices/*.ufs/attributes/psa_data_size
975 Date: February 2018 973 Date: February 2018
976 Contact: Stanislav Nijnikov <stanislav.n 974 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
977 Description: This file shows the amount of 975 Description: This file shows the amount of data that the host plans to
978 load to all logical units in p 976 load to all logical units in pre-soldering state.
979 The full information about the 977 The full information about the attribute could be found at
980 UFS specifications 2.1. 978 UFS specifications 2.1.
981 979
982 The file is read only. 980 The file is read only.
983 981
984 982
985 What: /sys/class/scsi_device/*/devic 983 What: /sys/class/scsi_device/*/device/dyn_cap_needed
986 Date: February 2018 984 Date: February 2018
987 Contact: Stanislav Nijnikov <stanislav.n 985 Contact: Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
988 Description: This file shows the amount of 986 Description: This file shows the amount of physical memory needed
989 to be removed from the physica 987 to be removed from the physical memory resources pool of
990 the particular logical unit. T 988 the particular logical unit. The full information about
991 the attribute could be found a 989 the attribute could be found at UFS specifications 2.1.
992 990
993 The file is read only. 991 The file is read only.
994 992
995 993
996 What: /sys/bus/platform/drivers/ufsh 994 What: /sys/bus/platform/drivers/ufshcd/*/rpm_lvl
997 What: /sys/bus/platform/devices/*.uf 995 What: /sys/bus/platform/devices/*.ufs/rpm_lvl
998 Date: September 2014 996 Date: September 2014
999 Contact: Can Guo <quic_cang@quicinc.com> !! 997 Contact: Subhash Jadavani <subhashj@codeaurora.org>
1000 Description: This entry could be used to s 998 Description: This entry could be used to set or show the UFS device
1001 runtime power management leve 999 runtime power management level. The current driver
1002 implementation supports 7 lev 1000 implementation supports 7 levels with next target states:
1003 1001
1004 == ========================= 1002 == ====================================================
1005 0 UFS device will stay acti 1003 0 UFS device will stay active, UIC link will
1006 stay active 1004 stay active
1007 1 UFS device will stay acti 1005 1 UFS device will stay active, UIC link will
1008 hibernate 1006 hibernate
1009 2 UFS device will be moved 1007 2 UFS device will be moved to sleep, UIC link will
1010 stay active 1008 stay active
1011 3 UFS device will be moved 1009 3 UFS device will be moved to sleep, UIC link will
1012 hibernate 1010 hibernate
1013 4 UFS device will be powere 1011 4 UFS device will be powered off, UIC link will
1014 hibernate 1012 hibernate
1015 5 UFS device will be powere 1013 5 UFS device will be powered off, UIC link will
1016 be powered off 1014 be powered off
1017 6 UFS device will be moved 1015 6 UFS device will be moved to deep sleep, UIC link
1018 will be powered off. Note 1016 will be powered off. Note, deep sleep might not be
1019 supported in which case t 1017 supported in which case this value will not be
1020 accepted 1018 accepted
1021 == ========================= 1019 == ====================================================
1022 1020
1023 What: /sys/bus/platform/drivers/ufs 1021 What: /sys/bus/platform/drivers/ufshcd/*/rpm_target_dev_state
1024 What: /sys/bus/platform/devices/*.u 1022 What: /sys/bus/platform/devices/*.ufs/rpm_target_dev_state
1025 Date: February 2018 1023 Date: February 2018
1026 Contact: Can Guo <quic_cang@quicinc.com !! 1024 Contact: Subhash Jadavani <subhashj@codeaurora.org>
1027 Description: This entry shows the target p 1025 Description: This entry shows the target power mode of an UFS device
1028 for the chosen runtime power 1026 for the chosen runtime power management level.
1029 1027
1030 The file is read only. 1028 The file is read only.
1031 1029
1032 What: /sys/bus/platform/drivers/ufs 1030 What: /sys/bus/platform/drivers/ufshcd/*/rpm_target_link_state
1033 What: /sys/bus/platform/devices/*.u 1031 What: /sys/bus/platform/devices/*.ufs/rpm_target_link_state
1034 Date: February 2018 1032 Date: February 2018
1035 Contact: Can Guo <quic_cang@quicinc.com !! 1033 Contact: Subhash Jadavani <subhashj@codeaurora.org>
1036 Description: This entry shows the target s 1034 Description: This entry shows the target state of an UFS UIC link
1037 for the chosen runtime power 1035 for the chosen runtime power management level.
1038 1036
1039 The file is read only. 1037 The file is read only.
1040 1038
1041 What: /sys/bus/platform/drivers/ufs 1039 What: /sys/bus/platform/drivers/ufshcd/*/spm_lvl
1042 What: /sys/bus/platform/devices/*.u 1040 What: /sys/bus/platform/devices/*.ufs/spm_lvl
1043 Date: September 2014 1041 Date: September 2014
1044 Contact: Can Guo <quic_cang@quicinc.com !! 1042 Contact: Subhash Jadavani <subhashj@codeaurora.org>
1045 Description: This entry could be used to s 1043 Description: This entry could be used to set or show the UFS device
1046 system power management level 1044 system power management level. The current driver
1047 implementation supports 7 lev 1045 implementation supports 7 levels with next target states:
1048 1046
1049 == ========================= 1047 == ====================================================
1050 0 UFS device will stay acti 1048 0 UFS device will stay active, UIC link will
1051 stay active 1049 stay active
1052 1 UFS device will stay acti 1050 1 UFS device will stay active, UIC link will
1053 hibernate 1051 hibernate
1054 2 UFS device will be moved 1052 2 UFS device will be moved to sleep, UIC link will
1055 stay active 1053 stay active
1056 3 UFS device will be moved 1054 3 UFS device will be moved to sleep, UIC link will
1057 hibernate 1055 hibernate
1058 4 UFS device will be powere 1056 4 UFS device will be powered off, UIC link will
1059 hibernate 1057 hibernate
1060 5 UFS device will be powere 1058 5 UFS device will be powered off, UIC link will
1061 be powered off 1059 be powered off
1062 6 UFS device will be moved 1060 6 UFS device will be moved to deep sleep, UIC link
1063 will be powered off. Note 1061 will be powered off. Note, deep sleep might not be
1064 supported in which case t 1062 supported in which case this value will not be
1065 accepted 1063 accepted
1066 == ========================= 1064 == ====================================================
1067 1065
1068 What: /sys/bus/platform/drivers/ufs 1066 What: /sys/bus/platform/drivers/ufshcd/*/spm_target_dev_state
1069 What: /sys/bus/platform/devices/*.u 1067 What: /sys/bus/platform/devices/*.ufs/spm_target_dev_state
1070 Date: February 2018 1068 Date: February 2018
1071 Contact: Can Guo <quic_cang@quicinc.com !! 1069 Contact: Subhash Jadavani <subhashj@codeaurora.org>
1072 Description: This entry shows the target p 1070 Description: This entry shows the target power mode of an UFS device
1073 for the chosen system power m 1071 for the chosen system power management level.
1074 1072
1075 The file is read only. 1073 The file is read only.
1076 1074
1077 What: /sys/bus/platform/drivers/ufs 1075 What: /sys/bus/platform/drivers/ufshcd/*/spm_target_link_state
1078 What: /sys/bus/platform/devices/*.u 1076 What: /sys/bus/platform/devices/*.ufs/spm_target_link_state
1079 Date: February 2018 1077 Date: February 2018
1080 Contact: Can Guo <quic_cang@quicinc.com !! 1078 Contact: Subhash Jadavani <subhashj@codeaurora.org>
1081 Description: This entry shows the target s 1079 Description: This entry shows the target state of an UFS UIC link
1082 for the chosen system power m 1080 for the chosen system power management level.
1083 1081
1084 The file is read only. 1082 The file is read only.
1085 1083
1086 What: /sys/bus/platform/drivers/ufs 1084 What: /sys/bus/platform/drivers/ufshcd/*/monitor/monitor_enable
1087 What: /sys/bus/platform/devices/*.u 1085 What: /sys/bus/platform/devices/*.ufs/monitor/monitor_enable
1088 Date: January 2021 1086 Date: January 2021
1089 Contact: Can Guo <quic_cang@quicinc.com !! 1087 Contact: Can Guo <cang@codeaurora.org>
1090 Description: This file shows the status of 1088 Description: This file shows the status of performance monitor enablement
1091 and it can be used to start/s 1089 and it can be used to start/stop the monitor. When the monitor
1092 is stopped, the performance d 1090 is stopped, the performance data collected is also cleared.
1093 1091
1094 What: /sys/bus/platform/drivers/ufs 1092 What: /sys/bus/platform/drivers/ufshcd/*/monitor/monitor_chunk_size
1095 What: /sys/bus/platform/devices/*.u 1093 What: /sys/bus/platform/devices/*.ufs/monitor/monitor_chunk_size
1096 Date: January 2021 1094 Date: January 2021
1097 Contact: Can Guo <quic_cang@quicinc.com !! 1095 Contact: Can Guo <cang@codeaurora.org>
1098 Description: This file tells the monitor t 1096 Description: This file tells the monitor to focus on requests transferring
1099 data of specific chunk size ( 1097 data of specific chunk size (in Bytes). 0 means any chunk size.
1100 It can only be changed when m 1098 It can only be changed when monitor is disabled.
1101 1099
1102 What: /sys/bus/platform/drivers/ufs 1100 What: /sys/bus/platform/drivers/ufshcd/*/monitor/read_total_sectors
1103 What: /sys/bus/platform/devices/*.u 1101 What: /sys/bus/platform/devices/*.ufs/monitor/read_total_sectors
1104 Date: January 2021 1102 Date: January 2021
1105 Contact: Can Guo <quic_cang@quicinc.com !! 1103 Contact: Can Guo <cang@codeaurora.org>
1106 Description: This file shows how many sect 1104 Description: This file shows how many sectors (in 512 Bytes) have been
1107 sent from device to host afte 1105 sent from device to host after monitor gets started.
1108 1106
1109 The file is read only. 1107 The file is read only.
1110 1108
1111 What: /sys/bus/platform/drivers/ufs 1109 What: /sys/bus/platform/drivers/ufshcd/*/monitor/read_total_busy
1112 What: /sys/bus/platform/devices/*.u 1110 What: /sys/bus/platform/devices/*.ufs/monitor/read_total_busy
1113 Date: January 2021 1111 Date: January 2021
1114 Contact: Can Guo <quic_cang@quicinc.com !! 1112 Contact: Can Guo <cang@codeaurora.org>
1115 Description: This file shows how long (in 1113 Description: This file shows how long (in micro seconds) has been spent
1116 sending data from device to h 1114 sending data from device to host after monitor gets started.
1117 1115
1118 The file is read only. 1116 The file is read only.
1119 1117
1120 What: /sys/bus/platform/drivers/ufs 1118 What: /sys/bus/platform/drivers/ufshcd/*/monitor/read_nr_requests
1121 What: /sys/bus/platform/devices/*.u 1119 What: /sys/bus/platform/devices/*.ufs/monitor/read_nr_requests
1122 Date: January 2021 1120 Date: January 2021
1123 Contact: Can Guo <quic_cang@quicinc.com !! 1121 Contact: Can Guo <cang@codeaurora.org>
1124 Description: This file shows how many read 1122 Description: This file shows how many read requests have been sent after
1125 monitor gets started. 1123 monitor gets started.
1126 1124
1127 The file is read only. 1125 The file is read only.
1128 1126
1129 What: /sys/bus/platform/drivers/ufs 1127 What: /sys/bus/platform/drivers/ufshcd/*/monitor/read_req_latency_max
1130 What: /sys/bus/platform/devices/*.u 1128 What: /sys/bus/platform/devices/*.ufs/monitor/read_req_latency_max
1131 Date: January 2021 1129 Date: January 2021
1132 Contact: Can Guo <quic_cang@quicinc.com !! 1130 Contact: Can Guo <cang@codeaurora.org>
1133 Description: This file shows the maximum l 1131 Description: This file shows the maximum latency (in micro seconds) of
1134 read requests after monitor g 1132 read requests after monitor gets started.
1135 1133
1136 The file is read only. 1134 The file is read only.
1137 1135
1138 What: /sys/bus/platform/drivers/ufs 1136 What: /sys/bus/platform/drivers/ufshcd/*/monitor/read_req_latency_min
1139 What: /sys/bus/platform/devices/*.u 1137 What: /sys/bus/platform/devices/*.ufs/monitor/read_req_latency_min
1140 Date: January 2021 1138 Date: January 2021
1141 Contact: Can Guo <quic_cang@quicinc.com !! 1139 Contact: Can Guo <cang@codeaurora.org>
1142 Description: This file shows the minimum l 1140 Description: This file shows the minimum latency (in micro seconds) of
1143 read requests after monitor g 1141 read requests after monitor gets started.
1144 1142
1145 The file is read only. 1143 The file is read only.
1146 1144
1147 What: /sys/bus/platform/drivers/ufs 1145 What: /sys/bus/platform/drivers/ufshcd/*/monitor/read_req_latency_avg
1148 What: /sys/bus/platform/devices/*.u 1146 What: /sys/bus/platform/devices/*.ufs/monitor/read_req_latency_avg
1149 Date: January 2021 1147 Date: January 2021
1150 Contact: Can Guo <quic_cang@quicinc.com !! 1148 Contact: Can Guo <cang@codeaurora.org>
1151 Description: This file shows the average l 1149 Description: This file shows the average latency (in micro seconds) of
1152 read requests after monitor g 1150 read requests after monitor gets started.
1153 1151
1154 The file is read only. 1152 The file is read only.
1155 1153
1156 What: /sys/bus/platform/drivers/ufs 1154 What: /sys/bus/platform/drivers/ufshcd/*/monitor/read_req_latency_sum
1157 What: /sys/bus/platform/devices/*.u 1155 What: /sys/bus/platform/devices/*.ufs/monitor/read_req_latency_sum
1158 Date: January 2021 1156 Date: January 2021
1159 Contact: Can Guo <quic_cang@quicinc.com !! 1157 Contact: Can Guo <cang@codeaurora.org>
1160 Description: This file shows the total lat 1158 Description: This file shows the total latency (in micro seconds) of
1161 read requests sent after moni 1159 read requests sent after monitor gets started.
1162 1160
1163 The file is read only. 1161 The file is read only.
1164 1162
1165 What: /sys/bus/platform/drivers/ufs 1163 What: /sys/bus/platform/drivers/ufshcd/*/monitor/write_total_sectors
1166 What: /sys/bus/platform/devices/*.u 1164 What: /sys/bus/platform/devices/*.ufs/monitor/write_total_sectors
1167 Date: January 2021 1165 Date: January 2021
1168 Contact: Can Guo <quic_cang@quicinc.com !! 1166 Contact: Can Guo <cang@codeaurora.org>
1169 Description: This file shows how many sect 1167 Description: This file shows how many sectors (in 512 Bytes) have been sent
1170 from host to device after mon 1168 from host to device after monitor gets started.
1171 1169
1172 The file is read only. 1170 The file is read only.
1173 1171
1174 What: /sys/bus/platform/drivers/ufs 1172 What: /sys/bus/platform/drivers/ufshcd/*/monitor/write_total_busy
1175 What: /sys/bus/platform/devices/*.u 1173 What: /sys/bus/platform/devices/*.ufs/monitor/write_total_busy
1176 Date: January 2021 1174 Date: January 2021
1177 Contact: Can Guo <quic_cang@quicinc.com !! 1175 Contact: Can Guo <cang@codeaurora.org>
1178 Description: This file shows how long (in 1176 Description: This file shows how long (in micro seconds) has been spent
1179 sending data from host to dev 1177 sending data from host to device after monitor gets started.
1180 1178
1181 The file is read only. 1179 The file is read only.
1182 1180
1183 What: /sys/bus/platform/drivers/ufs 1181 What: /sys/bus/platform/drivers/ufshcd/*/monitor/write_nr_requests
1184 What: /sys/bus/platform/devices/*.u 1182 What: /sys/bus/platform/devices/*.ufs/monitor/write_nr_requests
1185 Date: January 2021 1183 Date: January 2021
1186 Contact: Can Guo <quic_cang@quicinc.com !! 1184 Contact: Can Guo <cang@codeaurora.org>
1187 Description: This file shows how many writ 1185 Description: This file shows how many write requests have been sent after
1188 monitor gets started. 1186 monitor gets started.
1189 1187
1190 The file is read only. 1188 The file is read only.
1191 1189
1192 What: /sys/bus/platform/drivers/ufs 1190 What: /sys/bus/platform/drivers/ufshcd/*/monitor/write_req_latency_max
1193 What: /sys/bus/platform/devices/*.u 1191 What: /sys/bus/platform/devices/*.ufs/monitor/write_req_latency_max
1194 Date: January 2021 1192 Date: January 2021
1195 Contact: Can Guo <quic_cang@quicinc.com !! 1193 Contact: Can Guo <cang@codeaurora.org>
1196 Description: This file shows the maximum l 1194 Description: This file shows the maximum latency (in micro seconds) of write
1197 requests after monitor gets s 1195 requests after monitor gets started.
1198 1196
1199 The file is read only. 1197 The file is read only.
1200 1198
1201 What: /sys/bus/platform/drivers/ufs 1199 What: /sys/bus/platform/drivers/ufshcd/*/monitor/write_req_latency_min
1202 What: /sys/bus/platform/devices/*.u 1200 What: /sys/bus/platform/devices/*.ufs/monitor/write_req_latency_min
1203 Date: January 2021 1201 Date: January 2021
1204 Contact: Can Guo <quic_cang@quicinc.com !! 1202 Contact: Can Guo <cang@codeaurora.org>
1205 Description: This file shows the minimum l 1203 Description: This file shows the minimum latency (in micro seconds) of write
1206 requests after monitor gets s 1204 requests after monitor gets started.
1207 1205
1208 The file is read only. 1206 The file is read only.
1209 1207
1210 What: /sys/bus/platform/drivers/ufs 1208 What: /sys/bus/platform/drivers/ufshcd/*/monitor/write_req_latency_avg
1211 What: /sys/bus/platform/devices/*.u 1209 What: /sys/bus/platform/devices/*.ufs/monitor/write_req_latency_avg
1212 Date: January 2021 1210 Date: January 2021
1213 Contact: Can Guo <quic_cang@quicinc.com !! 1211 Contact: Can Guo <cang@codeaurora.org>
1214 Description: This file shows the average l 1212 Description: This file shows the average latency (in micro seconds) of write
1215 requests after monitor gets s 1213 requests after monitor gets started.
1216 1214
1217 The file is read only. 1215 The file is read only.
1218 1216
1219 What: /sys/bus/platform/drivers/ufs 1217 What: /sys/bus/platform/drivers/ufshcd/*/monitor/write_req_latency_sum
1220 What: /sys/bus/platform/devices/*.u 1218 What: /sys/bus/platform/devices/*.ufs/monitor/write_req_latency_sum
1221 Date: January 2021 1219 Date: January 2021
1222 Contact: Can Guo <quic_cang@quicinc.com !! 1220 Contact: Can Guo <cang@codeaurora.org>
1223 Description: This file shows the total lat 1221 Description: This file shows the total latency (in micro seconds) of write
1224 requests after monitor gets s 1222 requests after monitor gets started.
1225 1223
1226 The file is read only. 1224 The file is read only.
1227 1225
1228 What: /sys/bus/platform/drivers/ufs <<
1229 What: /sys/bus/platform/devices/*.u <<
1230 Date: September 2023 <<
1231 Contact: Can Guo <quic_cang@quicinc.com <<
1232 Description: This file shows how many lane <<
1233 i.e., an output 2 means UFS l <<
1234 <<
1235 The file is read only. <<
1236 <<
1237 What: /sys/bus/platform/drivers/ufs <<
1238 What: /sys/bus/platform/devices/*.u <<
1239 Date: September 2023 <<
1240 Contact: Can Guo <quic_cang@quicinc.com <<
1241 Description: This file shows the PA power <<
1242 <<
1243 The file is read only. <<
1244 <<
1245 What: /sys/bus/platform/drivers/ufs <<
1246 What: /sys/bus/platform/devices/*.u <<
1247 Date: September 2023 <<
1248 Contact: Can Guo <quic_cang@quicinc.com <<
1249 Description: This file shows the speed rat <<
1250 <<
1251 The file is read only. <<
1252 <<
1253 What: /sys/bus/platform/drivers/ufs <<
1254 What: /sys/bus/platform/devices/*.u <<
1255 Date: September 2023 <<
1256 Contact: Can Guo <quic_cang@quicinc.com <<
1257 Description: This file shows the gear of U <<
1258 <<
1259 The file is read only. <<
1260 <<
1261 What: /sys/bus/platform/drivers/ufs <<
1262 What: /sys/bus/platform/devices/*.u <<
1263 Date: September 2023 <<
1264 Contact: Can Guo <quic_cang@quicinc.com <<
1265 Description: This file shows the UFS devic <<
1266 <<
1267 The file is read only. <<
1268 <<
1269 What: /sys/bus/platform/drivers/ufs <<
1270 What: /sys/bus/platform/devices/*.u <<
1271 Date: September 2023 <<
1272 Contact: Can Guo <quic_cang@quicinc.com <<
1273 Description: This file shows the state of <<
1274 <<
1275 The file is read only. <<
1276 <<
1277 What: /sys/bus/platform/drivers/ufs 1226 What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/wb_presv_us_en
1278 What: /sys/bus/platform/devices/*.u 1227 What: /sys/bus/platform/devices/*.ufs/device_descriptor/wb_presv_us_en
1279 Date: June 2020 1228 Date: June 2020
1280 Contact: Asutosh Das <quic_asutoshd@qui !! 1229 Contact: Asutosh Das <asutoshd@codeaurora.org>
1281 Description: This entry shows if preserve 1230 Description: This entry shows if preserve user-space was configured
1282 1231
1283 The file is read only. 1232 The file is read only.
1284 1233
1285 What: /sys/bus/platform/drivers/ufs 1234 What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/wb_shared_alloc_units
1286 What: /sys/bus/platform/devices/*.u 1235 What: /sys/bus/platform/devices/*.ufs/device_descriptor/wb_shared_alloc_units
1287 Date: June 2020 1236 Date: June 2020
1288 Contact: Asutosh Das <quic_asutoshd@qui !! 1237 Contact: Asutosh Das <asutoshd@codeaurora.org>
1289 Description: This entry shows the shared a 1238 Description: This entry shows the shared allocated units of WB buffer
1290 1239
1291 The file is read only. 1240 The file is read only.
1292 1241
1293 What: /sys/bus/platform/drivers/ufs 1242 What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/wb_type
1294 What: /sys/bus/platform/devices/*.u 1243 What: /sys/bus/platform/devices/*.ufs/device_descriptor/wb_type
1295 Date: June 2020 1244 Date: June 2020
1296 Contact: Asutosh Das <quic_asutoshd@qui !! 1245 Contact: Asutosh Das <asutoshd@codeaurora.org>
1297 Description: This entry shows the configur 1246 Description: This entry shows the configured WB type.
1298 0x1 for shared buffer mode. 0 1247 0x1 for shared buffer mode. 0x0 for dedicated buffer mode.
1299 1248
1300 The file is read only. 1249 The file is read only.
1301 1250
1302 What: /sys/bus/platform/drivers/ufs 1251 What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/wb_buff_cap_adj
1303 What: /sys/bus/platform/devices/*.u 1252 What: /sys/bus/platform/devices/*.ufs/geometry_descriptor/wb_buff_cap_adj
1304 Date: June 2020 1253 Date: June 2020
1305 Contact: Asutosh Das <quic_asutoshd@qui !! 1254 Contact: Asutosh Das <asutoshd@codeaurora.org>
1306 Description: This entry shows the total us 1255 Description: This entry shows the total user-space decrease in shared
1307 buffer mode. 1256 buffer mode.
1308 The value of this parameter i 1257 The value of this parameter is 3 for TLC NAND when SLC mode
1309 is used as WriteBooster Buffe 1258 is used as WriteBooster Buffer. 2 for MLC NAND.
1310 1259
1311 The file is read only. 1260 The file is read only.
1312 1261
1313 What: /sys/bus/platform/drivers/ufs 1262 What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/wb_max_alloc_units
1314 What: /sys/bus/platform/devices/*.u 1263 What: /sys/bus/platform/devices/*.ufs/geometry_descriptor/wb_max_alloc_units
1315 Date: June 2020 1264 Date: June 2020
1316 Contact: Asutosh Das <quic_asutoshd@qui !! 1265 Contact: Asutosh Das <asutoshd@codeaurora.org>
1317 Description: This entry shows the Maximum 1266 Description: This entry shows the Maximum total WriteBooster Buffer size
1318 which is supported by the ent 1267 which is supported by the entire device.
1319 1268
1320 The file is read only. 1269 The file is read only.
1321 1270
1322 What: /sys/bus/platform/drivers/ufs 1271 What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/wb_max_wb_luns
1323 What: /sys/bus/platform/devices/*.u 1272 What: /sys/bus/platform/devices/*.ufs/geometry_descriptor/wb_max_wb_luns
1324 Date: June 2020 1273 Date: June 2020
1325 Contact: Asutosh Das <quic_asutoshd@qui !! 1274 Contact: Asutosh Das <asutoshd@codeaurora.org>
1326 Description: This entry shows the maximum 1275 Description: This entry shows the maximum number of luns that can support
1327 WriteBooster. 1276 WriteBooster.
1328 1277
1329 The file is read only. 1278 The file is read only.
1330 1279
1331 What: /sys/bus/platform/drivers/ufs 1280 What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/wb_sup_red_type
1332 What: /sys/bus/platform/devices/*.u 1281 What: /sys/bus/platform/devices/*.ufs/geometry_descriptor/wb_sup_red_type
1333 Date: June 2020 1282 Date: June 2020
1334 Contact: Asutosh Das <quic_asutoshd@qui !! 1283 Contact: Asutosh Das <asutoshd@codeaurora.org>
1335 Description: The supportability of user sp 1284 Description: The supportability of user space reduction mode
1336 and preserve user space mode. 1285 and preserve user space mode.
1337 00h: WriteBooster Buffer can 1286 00h: WriteBooster Buffer can be configured only in
1338 user space reduction type. 1287 user space reduction type.
1339 01h: WriteBooster Buffer can 1288 01h: WriteBooster Buffer can be configured only in
1340 preserve user space type. 1289 preserve user space type.
1341 02h: Device can be configured 1290 02h: Device can be configured in either user space
1342 reduction type or preserve us 1291 reduction type or preserve user space type.
1343 1292
1344 The file is read only. 1293 The file is read only.
1345 1294
1346 What: /sys/bus/platform/drivers/ufs 1295 What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/wb_sup_wb_type
1347 What: /sys/bus/platform/devices/*.u 1296 What: /sys/bus/platform/devices/*.ufs/geometry_descriptor/wb_sup_wb_type
1348 Date: June 2020 1297 Date: June 2020
1349 Contact: Asutosh Das <quic_asutoshd@qui !! 1298 Contact: Asutosh Das <asutoshd@codeaurora.org>
1350 Description: The supportability of WriteBo 1299 Description: The supportability of WriteBooster Buffer type.
1351 1300
1352 === ======================== 1301 === ==========================================================
1353 00h LU based WriteBooster Bu 1302 00h LU based WriteBooster Buffer configuration
1354 01h Single shared WriteBoost 1303 01h Single shared WriteBooster Buffer configuration
1355 02h Supporting both LU based 1304 02h Supporting both LU based WriteBooster.
1356 Buffer and Single shared 1305 Buffer and Single shared WriteBooster Buffer configuration
1357 === ======================== 1306 === ==========================================================
1358 1307
1359 The file is read only. 1308 The file is read only.
1360 1309
1361 What: /sys/bus/platform/drivers/ufs 1310 What: /sys/bus/platform/drivers/ufshcd/*/flags/wb_enable
1362 What: /sys/bus/platform/devices/*.u 1311 What: /sys/bus/platform/devices/*.ufs/flags/wb_enable
1363 Date: June 2020 1312 Date: June 2020
1364 Contact: Asutosh Das <quic_asutoshd@qui !! 1313 Contact: Asutosh Das <asutoshd@codeaurora.org>
1365 Description: This entry shows the status o 1314 Description: This entry shows the status of WriteBooster.
1366 1315
1367 == ========================== 1316 == ============================
1368 0 WriteBooster is not enable 1317 0 WriteBooster is not enabled.
1369 1 WriteBooster is enabled 1318 1 WriteBooster is enabled
1370 == ========================== 1319 == ============================
1371 1320
1372 The file is read only. 1321 The file is read only.
1373 1322
1374 What: /sys/bus/platform/drivers/ufs 1323 What: /sys/bus/platform/drivers/ufshcd/*/flags/wb_flush_en
1375 What: /sys/bus/platform/devices/*.u 1324 What: /sys/bus/platform/devices/*.ufs/flags/wb_flush_en
1376 Date: June 2020 1325 Date: June 2020
1377 Contact: Asutosh Das <quic_asutoshd@qui !! 1326 Contact: Asutosh Das <asutoshd@codeaurora.org>
1378 Description: This entry shows if flush is 1327 Description: This entry shows if flush is enabled.
1379 1328
1380 == ========================== 1329 == =================================
1381 0 Flush operation is not per 1330 0 Flush operation is not performed.
1382 1 Flush operation is perform 1331 1 Flush operation is performed.
1383 == ========================== 1332 == =================================
1384 1333
1385 The file is read only. 1334 The file is read only.
1386 1335
1387 What: /sys/bus/platform/drivers/ufs 1336 What: /sys/bus/platform/drivers/ufshcd/*/flags/wb_flush_during_h8
1388 What: /sys/bus/platform/devices/*.u 1337 What: /sys/bus/platform/devices/*.ufs/flags/wb_flush_during_h8
1389 Date: June 2020 1338 Date: June 2020
1390 Contact: Asutosh Das <quic_asutoshd@qui !! 1339 Contact: Asutosh Das <asutoshd@codeaurora.org>
1391 Description: Flush WriteBooster Buffer dur 1340 Description: Flush WriteBooster Buffer during hibernate state.
1392 1341
1393 == ========================== 1342 == =================================================
1394 0 Device is not allowed to f 1343 0 Device is not allowed to flush the
1395 WriteBooster Buffer during 1344 WriteBooster Buffer during link hibernate state.
1396 1 Device is allowed to flush 1345 1 Device is allowed to flush the
1397 WriteBooster Buffer during 1346 WriteBooster Buffer during link hibernate state.
1398 == ========================== 1347 == =================================================
1399 1348
1400 The file is read only. 1349 The file is read only.
1401 1350
1402 What: /sys/bus/platform/drivers/ufs 1351 What: /sys/bus/platform/drivers/ufshcd/*/attributes/wb_avail_buf
1403 What: /sys/bus/platform/devices/*.u 1352 What: /sys/bus/platform/devices/*.ufs/attributes/wb_avail_buf
1404 Date: June 2020 1353 Date: June 2020
1405 Contact: Asutosh Das <quic_asutoshd@qui !! 1354 Contact: Asutosh Das <asutoshd@codeaurora.org>
1406 Description: This entry shows the amount o 1355 Description: This entry shows the amount of unused WriteBooster buffer
1407 available. 1356 available.
1408 1357
1409 The file is read only. 1358 The file is read only.
1410 1359
1411 What: /sys/bus/platform/drivers/ufs 1360 What: /sys/bus/platform/drivers/ufshcd/*/attributes/wb_cur_buf
1412 What: /sys/bus/platform/devices/*.u 1361 What: /sys/bus/platform/devices/*.ufs/attributes/wb_cur_buf
1413 Date: June 2020 1362 Date: June 2020
1414 Contact: Asutosh Das <quic_asutoshd@qui !! 1363 Contact: Asutosh Das <asutoshd@codeaurora.org>
1415 Description: This entry shows the amount o 1364 Description: This entry shows the amount of unused current buffer.
1416 1365
1417 The file is read only. 1366 The file is read only.
1418 1367
1419 What: /sys/bus/platform/drivers/ufs 1368 What: /sys/bus/platform/drivers/ufshcd/*/attributes/wb_flush_status
1420 What: /sys/bus/platform/devices/*.u 1369 What: /sys/bus/platform/devices/*.ufs/attributes/wb_flush_status
1421 Date: June 2020 1370 Date: June 2020
1422 Contact: Asutosh Das <quic_asutoshd@qui !! 1371 Contact: Asutosh Das <asutoshd@codeaurora.org>
1423 Description: This entry shows the flush op 1372 Description: This entry shows the flush operation status.
1424 1373
1425 1374
1426 === ======================== 1375 === ======================================
1427 00h idle 1376 00h idle
1428 01h Flush operation in progr 1377 01h Flush operation in progress
1429 02h Flush operation stopped 1378 02h Flush operation stopped prematurely.
1430 03h Flush operation complete 1379 03h Flush operation completed successfully
1431 04h Flush operation general 1380 04h Flush operation general failure
1432 === ======================== 1381 === ======================================
1433 1382
1434 The file is read only. 1383 The file is read only.
1435 1384
1436 What: /sys/bus/platform/drivers/ufs 1385 What: /sys/bus/platform/drivers/ufshcd/*/attributes/wb_life_time_est
1437 What: /sys/bus/platform/devices/*.u 1386 What: /sys/bus/platform/devices/*.ufs/attributes/wb_life_time_est
1438 Date: June 2020 1387 Date: June 2020
1439 Contact: Asutosh Das <quic_asutoshd@qui !! 1388 Contact: Asutosh Das <asutoshd@codeaurora.org>
1440 Description: This entry shows an indicatio 1389 Description: This entry shows an indication of the WriteBooster Buffer
1441 lifetime based on the amount 1390 lifetime based on the amount of performed program/erase cycles
1442 1391
1443 === ======================== 1392 === =============================================
1444 01h 0% - 10% WriteBooster Bu 1393 01h 0% - 10% WriteBooster Buffer life time used
1445 ... 1394 ...
1446 0Ah 90% - 100% WriteBooster 1395 0Ah 90% - 100% WriteBooster Buffer life time used
1447 === ======================== 1396 === =============================================
1448 1397
1449 The file is read only. 1398 The file is read only.
1450 1399
1451 What: /sys/class/scsi_device/*/devi 1400 What: /sys/class/scsi_device/*/device/unit_descriptor/wb_buf_alloc_units
1452 Date: June 2020 1401 Date: June 2020
1453 Contact: Asutosh Das <quic_asutoshd@qui !! 1402 Contact: Asutosh Das <asutoshd@codeaurora.org>
1454 Description: This entry shows the configur 1403 Description: This entry shows the configured size of WriteBooster buffer.
1455 0400h corresponds to 4GB. 1404 0400h corresponds to 4GB.
1456 1405
1457 The file is read only. 1406 The file is read only.
1458 1407
1459 What: /sys/bus/platform/drivers/ufs 1408 What: /sys/bus/platform/drivers/ufshcd/*/wb_on
1460 What: /sys/bus/platform/devices/*.u 1409 What: /sys/bus/platform/devices/*.ufs/wb_on
1461 Date: January 2021 1410 Date: January 2021
1462 Contact: Bean Huo <beanhuo@micron.com> 1411 Contact: Bean Huo <beanhuo@micron.com>
1463 Description: This node is used to set or d 1412 Description: This node is used to set or display whether UFS WriteBooster is
1464 enabled. Echo 0 to this file 1413 enabled. Echo 0 to this file to disable UFS WriteBooster or 1 to
1465 enable it. The WriteBooster i 1414 enable it. The WriteBooster is enabled after power-on/reset,
1466 however, it will be disabled/ 1415 however, it will be disabled/enable while CLK scaling down/up
1467 (if the platform supports UFS 1416 (if the platform supports UFSHCD_CAP_CLK_SCALING). For a
1468 platform that doesn't support 1417 platform that doesn't support UFSHCD_CAP_CLK_SCALING, we can
1469 disable/enable WriteBooster t 1418 disable/enable WriteBooster through this sysfs node.
1470 1419
1471 What: /sys/bus/platform/drivers/ufs !! 1420 What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/hpb_version
1472 What: /sys/bus/platform/devices/*.u !! 1421 What: /sys/bus/platform/devices/*.ufs/device_descriptor/hpb_version
1473 Date: July 2022 !! 1422 Date: June 2021
1474 Contact: Jinyoung Choi <j-young.choi@sa !! 1423 Contact: Daejun Park <daejun7.park@samsung.com>
1475 Description: This entry shows the status o !! 1424 Description: This entry shows the HPB specification version.
1476 and it can be used to enable !! 1425 The full information about the descriptor can be found in the UFS
1477 If flushing is enabled, the d !! 1426 HPB (Host Performance Booster) Extension specifications.
1478 operation when the command qu !! 1427 Example: version 1.2.3 = 0123h
1479 <<
1480 What: /sys/bus/platform/drivers/ufs <<
1481 What: /sys/bus/platform/devices/*.u <<
1482 Date: June 2023 <<
1483 Contact: Lu Hongfei <luhongfei@vivo.com <<
1484 Description: <<
1485 wb_flush_threshold represents <<
1486 whose value expressed in unit <<
1487 '2' representing 20%, and so <<
1488 If avail_wb_buff < wb_flush_t <<
1489 be flushed, otherwise it is n <<
1490 <<
1491 Contact: Daniil Lunev <dlunev@chromium. <<
1492 What: /sys/bus/platform/drivers/ufs <<
1493 What: /sys/bus/platform/devices/*.u <<
1494 Date: August 2022 <<
1495 Description: The group represents the effe <<
1496 host-device pair. i.e. the ca <<
1497 driver for the specific host <<
1498 controller and are supported <<
1499 configuration on the device s <<
1500 <<
1501 Contact: Daniil Lunev <dlunev@chromium. <<
1502 What: /sys/bus/platform/drivers/ufs <<
1503 What: /sys/bus/platform/devices/*.u <<
1504 Date: August 2022 <<
1505 Contact: Daniil Lunev <dlunev@chromium. <<
1506 Description: Indicates status of clock sca <<
1507 1428
1508 == ========================== !! 1429 The file is read only.
1509 0 Clock scaling is not suppo !! 1430
1510 1 Clock scaling is supported !! 1431 What: /sys/bus/platform/drivers/ufshcd/*/device_descriptor/hpb_control
1511 == ========================== !! 1432 What: /sys/bus/platform/devices/*.ufs/device_descriptor/hpb_control
>> 1433 Date: June 2021
>> 1434 Contact: Daejun Park <daejun7.park@samsung.com>
>> 1435 Description: This entry shows an indication of the HPB control mode.
>> 1436 00h: Host control mode
>> 1437 01h: Device control mode
>> 1438
>> 1439 The file is read only.
>> 1440
>> 1441 What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/hpb_region_size
>> 1442 What: /sys/bus/platform/devices/*.ufs/geometry_descriptor/hpb_region_size
>> 1443 Date: June 2021
>> 1444 Contact: Daejun Park <daejun7.park@samsung.com>
>> 1445 Description: This entry shows the bHPBRegionSize which can be calculated
>> 1446 as in the following (in bytes):
>> 1447 HPB Region size = 512B * 2^bHPBRegionSize
>> 1448
>> 1449 The file is read only.
>> 1450
>> 1451 What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/hpb_number_lu
>> 1452 What: /sys/bus/platform/devices/*.ufs/geometry_descriptor/hpb_number_lu
>> 1453 Date: June 2021
>> 1454 Contact: Daejun Park <daejun7.park@samsung.com>
>> 1455 Description: This entry shows the maximum number of HPB LU supported by
>> 1456 the device.
>> 1457 00h: HPB is not supported by the device.
>> 1458 01h ~ 20h: Maximum number of HPB LU supported by the device
1512 1459
1513 The file is read only. 1460 The file is read only.
1514 1461
1515 What: /sys/bus/platform/drivers/ufs !! 1462 What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/hpb_subregion_size
1516 What: /sys/bus/platform/devices/*.u !! 1463 What: /sys/bus/platform/devices/*.ufs/geometry_descriptor/hpb_subregion_size
1517 Date: August 2022 !! 1464 Date: June 2021
1518 Contact: Daniil Lunev <dlunev@chromium. !! 1465 Contact: Daejun Park <daejun7.park@samsung.com>
1519 Description: Indicates status of Write Boo !! 1466 Description: This entry shows the bHPBSubRegionSize, which can be
>> 1467 calculated as in the following (in bytes) and shall be a multiple of
>> 1468 logical block size:
>> 1469 HPB Sub-Region size = 512B x 2^bHPBSubRegionSize
>> 1470 bHPBSubRegionSize shall not exceed bHPBRegionSize.
>> 1471
>> 1472 The file is read only.
>> 1473
>> 1474 What: /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/hpb_max_active_regions
>> 1475 What: /sys/bus/platform/devices/*.ufs/geometry_descriptor/hpb_max_active_regions
>> 1476 Date: June 2021
>> 1477 Contact: Daejun Park <daejun7.park@samsung.com>
>> 1478 Description: This entry shows the maximum number of active HPB regions that
>> 1479 is supported by the device.
>> 1480
>> 1481 The file is read only.
>> 1482
>> 1483 What: /sys/class/scsi_device/*/device/unit_descriptor/hpb_lu_max_active_regions
>> 1484 Date: June 2021
>> 1485 Contact: Daejun Park <daejun7.park@samsung.com>
>> 1486 Description: This entry shows the maximum number of HPB regions assigned to
>> 1487 the HPB logical unit.
>> 1488
>> 1489 The file is read only.
>> 1490
>> 1491 What: /sys/class/scsi_device/*/device/unit_descriptor/hpb_pinned_region_start_offset
>> 1492 Date: June 2021
>> 1493 Contact: Daejun Park <daejun7.park@samsung.com>
>> 1494 Description: This entry shows the start offset of HPB pinned region.
>> 1495
>> 1496 The file is read only.
>> 1497
>> 1498 What: /sys/class/scsi_device/*/device/unit_descriptor/hpb_number_pinned_regions
>> 1499 Date: June 2021
>> 1500 Contact: Daejun Park <daejun7.park@samsung.com>
>> 1501 Description: This entry shows the number of HPB pinned regions assigned to
>> 1502 the HPB logical unit.
>> 1503
>> 1504 The file is read only.
>> 1505
>> 1506 What: /sys/class/scsi_device/*/device/hpb_stats/hit_cnt
>> 1507 Date: June 2021
>> 1508 Contact: Daejun Park <daejun7.park@samsung.com>
>> 1509 Description: This entry shows the number of reads that changed to HPB read.
>> 1510
>> 1511 The file is read only.
>> 1512
>> 1513 What: /sys/class/scsi_device/*/device/hpb_stats/miss_cnt
>> 1514 Date: June 2021
>> 1515 Contact: Daejun Park <daejun7.park@samsung.com>
>> 1516 Description: This entry shows the number of reads that cannot be changed to
>> 1517 HPB read.
>> 1518
>> 1519 The file is read only.
>> 1520
>> 1521 What: /sys/class/scsi_device/*/device/hpb_stats/rcmd_noti_cnt
>> 1522 Date: June 2021
>> 1523 Contact: Daejun Park <daejun7.park@samsung.com>
>> 1524 Description: This entry shows the number of response UPIUs that has
>> 1525 recommendations for activating sub-regions and/or inactivating region.
>> 1526
>> 1527 The file is read only.
>> 1528
>> 1529 What: /sys/class/scsi_device/*/device/hpb_stats/rcmd_active_cnt
>> 1530 Date: June 2021
>> 1531 Contact: Daejun Park <daejun7.park@samsung.com>
>> 1532 Description: For the HPB device control mode, this entry shows the number of
>> 1533 active sub-regions recommended by response UPIUs. For the HPB host control
>> 1534 mode, this entry shows the number of active sub-regions recommended by the
>> 1535 HPB host control mode heuristic algorithm.
>> 1536
>> 1537 The file is read only.
>> 1538
>> 1539 What: /sys/class/scsi_device/*/device/hpb_stats/rcmd_inactive_cnt
>> 1540 Date: June 2021
>> 1541 Contact: Daejun Park <daejun7.park@samsung.com>
>> 1542 Description: For the HPB device control mode, this entry shows the number of
>> 1543 inactive regions recommended by response UPIUs. For the HPB host control
>> 1544 mode, this entry shows the number of inactive regions recommended by the
>> 1545 HPB host control mode heuristic algorithm.
>> 1546
>> 1547 The file is read only.
>> 1548
>> 1549 What: /sys/class/scsi_device/*/device/hpb_stats/map_req_cnt
>> 1550 Date: June 2021
>> 1551 Contact: Daejun Park <daejun7.park@samsung.com>
>> 1552 Description: This entry shows the number of read buffer commands for
>> 1553 activating sub-regions recommended by response UPIUs.
>> 1554
>> 1555 The file is read only.
>> 1556
>> 1557 What: /sys/class/scsi_device/*/device/hpb_params/requeue_timeout_ms
>> 1558 Date: June 2021
>> 1559 Contact: Daejun Park <daejun7.park@samsung.com>
>> 1560 Description: This entry shows the requeue timeout threshold for write buffer
>> 1561 command in ms. The value can be changed by writing an integer to
>> 1562 this entry.
>> 1563
>> 1564 What: /sys/bus/platform/drivers/ufshcd/*/attributes/max_data_size_hpb_single_cmd
>> 1565 What: /sys/bus/platform/devices/*.ufs/attributes/max_data_size_hpb_single_cmd
>> 1566 Date: June 2021
>> 1567 Contact: Daejun Park <daejun7.park@samsung.com>
>> 1568 Description: This entry shows the maximum HPB data size for using a single HPB
>> 1569 command.
>> 1570
>> 1571 === ========
>> 1572 00h 4KB
>> 1573 01h 8KB
>> 1574 02h 12KB
>> 1575 ...
>> 1576 FFh 1024KB
>> 1577 === ========
>> 1578
>> 1579 The file is read only.
>> 1580
>> 1581 What: /sys/bus/platform/drivers/ufshcd/*/flags/hpb_enable
>> 1582 What: /sys/bus/platform/devices/*.ufs/flags/hpb_enable
>> 1583 Date: June 2021
>> 1584 Contact: Daejun Park <daejun7.park@samsung.com>
>> 1585 Description: This entry shows the status of HPB.
1520 1586
1521 == ========================== 1587 == ============================
1522 0 Write Booster can not be e !! 1588 0 HPB is not enabled.
1523 1 Write Booster can be enabl !! 1589 1 HPB is enabled
1524 == ========================== 1590 == ============================
1525 1591
1526 The file is read only. 1592 The file is read only.
1527 1593
1528 What: /sys/bus/platform/drivers/ufs !! 1594 What: /sys/class/scsi_device/*/device/hpb_param_sysfs/activation_thld
1529 What: /sys/bus/platform/devices/*.u !! 1595 Date: February 2021
1530 Date: November 2023 !! 1596 Contact: Avri Altman <avri.altman@wdc.com>
1531 Contact: Bean Huo <beanhuo@micron.com> !! 1597 Description: In host control mode, reads are the major source of activation
1532 Description: !! 1598 trials. Once this threshold hs met, the region is added to the
1533 rtc_update_ms indicates how o !! 1599 "to-be-activated" list. Since we reset the read counter upon
1534 UFS RTC. If set to 0, this wi !! 1600 write, this include sending a rb command updating the region
>> 1601 ppn as well.
1535 1602
1536 What: /sys/devices/platform/.../ufs !! 1603 What: /sys/class/scsi_device/*/device/hpb_param_sysfs/normalization_factor
1537 Date: August 2024 !! 1604 Date: February 2021
1538 Contact: Avri Altman <avri.altman@wdc.c 1605 Contact: Avri Altman <avri.altman@wdc.com>
1539 Description: !! 1606 Description: In host control mode, we think of the regions as "buckets".
1540 Host Capabilities register gr !! 1607 Those buckets are being filled with reads, and emptied on write.
1541 Symbol - VER. This file show !! 1608 We use entries_per_srgn - the amount of blocks in a subregion as
1542 Example: Version 3.12 would b !! 1609 our bucket size. This applies because HPB1.0 only handles
1543 The file is read only. !! 1610 single-block reads. Once the bucket size is crossed, we trigger
>> 1611 a normalization work - not only to avoid overflow, but mainly
>> 1612 because we want to keep those counters normalized, as we are
>> 1613 using those reads as a comparative score, to make various decisions.
>> 1614 The normalization is dividing (shift right) the read counter by
>> 1615 the normalization_factor. If during consecutive normalizations
>> 1616 an active region has exhausted its reads - inactivate it.
1544 1617
1545 What: /sys/devices/platform/.../ufs !! 1618 What: /sys/class/scsi_device/*/device/hpb_param_sysfs/eviction_thld_enter
1546 Date: August 2024 !! 1619 Date: February 2021
1547 Contact: Avri Altman <avri.altman@wdc.c 1620 Contact: Avri Altman <avri.altman@wdc.com>
1548 Description: !! 1621 Description: Region deactivation is often due to the fact that eviction took
1549 Host Capabilities register gr !! 1622 place: A region becomes active at the expense of another. This is
1550 Symbol - HCPID. This file sh !! 1623 happening when the max-active-regions limit has been crossed.
1551 The content of this register !! 1624 In host mode, eviction is considered an extreme measure. We
1552 The file is read only. !! 1625 want to verify that the entering region has enough reads, and
>> 1626 the exiting region has much fewer reads. eviction_thld_enter is
>> 1627 the min reads that a region must have in order to be considered
>> 1628 a candidate for evicting another region.
1553 1629
1554 What: /sys/devices/platform/.../ufs !! 1630 What: /sys/class/scsi_device/*/device/hpb_param_sysfs/eviction_thld_exit
1555 Date: August 2024 !! 1631 Date: February 2021
1556 Contact: Avri Altman <avri.altman@wdc.c 1632 Contact: Avri Altman <avri.altman@wdc.com>
1557 Description: !! 1633 Description: Same as above for the exiting region. A region is considered to
1558 Host Capabilities register gr !! 1634 be a candidate for eviction only if it has fewer reads than
1559 Symbol - HCMID. This file sho !! 1635 eviction_thld_exit.
1560 The Manufacturer ID is define !! 1636
1561 The file is read only. !! 1637 What: /sys/class/scsi_device/*/device/hpb_param_sysfs/read_timeout_ms
>> 1638 Date: February 2021
>> 1639 Contact: Avri Altman <avri.altman@wdc.com>
>> 1640 Description: In order not to hang on to "cold" regions, we inactivate
>> 1641 a region that has no READ access for a predefined amount of
>> 1642 time - read_timeout_ms. If read_timeout_ms has expired, and the
>> 1643 region is dirty, it is less likely that we can make any use of
>> 1644 HPB reading it so we inactivate it. Still, deactivation has
>> 1645 its overhead, and we may still benefit from HPB reading this
>> 1646 region if it is clean - see read_timeout_expiries.
>> 1647
>> 1648 What: /sys/class/scsi_device/*/device/hpb_param_sysfs/read_timeout_expiries
>> 1649 Date: February 2021
>> 1650 Contact: Avri Altman <avri.altman@wdc.com>
>> 1651 Description: If the region read timeout has expired, but the region is clean,
>> 1652 just re-wind its timer for another spin. Do that as long as it
>> 1653 is clean and did not exhaust its read_timeout_expiries threshold.
>> 1654
>> 1655 What: /sys/class/scsi_device/*/device/hpb_param_sysfs/timeout_polling_interval_ms
>> 1656 Date: February 2021
>> 1657 Contact: Avri Altman <avri.altman@wdc.com>
>> 1658 Description: The frequency with which the delayed worker that checks the
>> 1659 read_timeouts is awakened.
>> 1660
>> 1661 What: /sys/class/scsi_device/*/device/hpb_param_sysfs/inflight_map_req
>> 1662 Date: February 2021
>> 1663 Contact: Avri Altman <avri.altman@wdc.com>
>> 1664 Description: In host control mode the host is the originator of map requests.
>> 1665 To avoid flooding the device with map requests, use a simple throttling
>> 1666 mechanism that limits the number of inflight map requests.
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.