Documentation/ABI/testing/sysfs-driver-ufs

   1 What:           /sys/bus/*/drivers/ufshcd/*/auto_hibern8
   2 Date:           March 2018
   3 Contact:        linux-scsi@vger.kernel.org
   4 Description:
   5                 This file contains the auto-hibernate idle timer setting of a
   6                 UFS host controller. A value of '0' means auto-hibernate is not
   7                 enabled. Otherwise the value is the number of microseconds of
   8                 idle time before the UFS host controller will autonomously put
   9                 the link into hibernate state. That will save power at the
  10                 expense of increased latency. Note that the hardware supports
  11                 10-bit values with a power-of-ten multiplier which allows a
  12                 maximum value of 102300000. Refer to the UFS Host Controller
  13                 Interface specification for more details.
  14
  15 What:           /sys/bus/platform/drivers/ufshcd/*/device_descriptor/device_type
  16 Date:           February 2018
  17 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
  18 Description:    This file shows the device type. This is one of the UFS
  19                 device descriptor parameters. The full information about
  20                 the descriptor could be found at UFS specifications 2.1.
  21                 The file is read only.
  22
  23 What:           /sys/bus/platform/drivers/ufshcd/*/device_descriptor/device_class
  24 Date:           February 2018
  25 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
  26 Description:    This file shows the device class. This is one of the UFS
  27                 device descriptor parameters. The full information about
  28                 the descriptor could be found at UFS specifications 2.1.
  29                 The file is read only.
  30
  31 What:           /sys/bus/platform/drivers/ufshcd/*/device_descriptor/device_sub_class
  32 Date:           February 2018
  33 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
  34 Description:    This file shows the UFS storage subclass. This is one of
  35                 the UFS device descriptor parameters. The full information
  36                 about the descriptor could be found at UFS specifications 2.1.
  37                 The file is read only.
  38
  39 What:           /sys/bus/platform/drivers/ufshcd/*/device_descriptor/protocol
  40 Date:           February 2018
  41 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
  42 Description:    This file shows the protocol supported by an UFS device.
  43                 This is one of the UFS device descriptor parameters.
  44                 The full information about the descriptor could be found
  45                 at UFS specifications 2.1.
  46                 The file is read only.
  47
  48 What:           /sys/bus/platform/drivers/ufshcd/*/device_descriptor/number_of_luns
  49 Date:           February 2018
  50 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
  51 Description:    This file shows number of logical units. This is one of
  52                 the UFS device descriptor parameters. The full information
  53                 about the descriptor could be found at UFS specifications 2.1.
  54                 The file is read only.
  55
  56 What:           /sys/bus/platform/drivers/ufshcd/*/device_descriptor/number_of_wluns
  57 Date:           February 2018
  58 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
  59 Description:    This file shows number of well known logical units.
  60                 This is one of the UFS device descriptor parameters.
  61                 The full information about the descriptor could be found
  62                 at UFS specifications 2.1.
  63                 The file is read only.
  64
  65 What:           /sys/bus/platform/drivers/ufshcd/*/device_descriptor/boot_enable
  66 Date:           February 2018
  67 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
  68 Description:    This file shows value that indicates whether the device is
  69                 enabled for boot. This is one of the UFS device descriptor
  70                 parameters. The full information about the descriptor could
  71                 be found at UFS specifications 2.1.
  72                 The file is read only.
  73
  74 What:           /sys/bus/platform/drivers/ufshcd/*/device_descriptor/descriptor_access_enable
  75 Date:           February 2018
  76 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
  77 Description:    This file shows value that indicates whether the device
  78                 descriptor could be read after partial initialization phase
  79                 of the boot sequence. This is one of the UFS device descriptor
  80                 parameters. The full information about the descriptor could
  81                 be found at UFS specifications 2.1.
  82                 The file is read only.
  83
  84 What:           /sys/bus/platform/drivers/ufshcd/*/device_descriptor/initial_power_mode
  85 Date:           February 2018
  86 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
  87 Description:    This file shows value that defines the power mode after
  88                 device initialization or hardware reset. This is one of
  89                 the UFS device descriptor parameters. The full information
  90                 about the descriptor could be found at UFS specifications 2.1.
  91                 The file is read only.
  92
  93 What:           /sys/bus/platform/drivers/ufshcd/*/device_descriptor/high_priority_lun
  94 Date:           February 2018
  95 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
  96 Description:    This file shows the high priority lun. This is one of
  97                 the UFS device descriptor parameters. The full information
  98                 about the descriptor could be found at UFS specifications 2.1.
  99                 The file is read only.
 100
 101 What:           /sys/bus/platform/drivers/ufshcd/*/device_descriptor/secure_removal_type
 102 Date:           February 2018
 103 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 104 Description:    This file shows the secure removal type. This is one of
 105                 the UFS device descriptor parameters. The full information
 106                 about the descriptor could be found at UFS specifications 2.1.
 107                 The file is read only.
 108
 109 What:           /sys/bus/platform/drivers/ufshcd/*/device_descriptor/support_security_lun
 110 Date:           February 2018
 111 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 112 Description:    This file shows whether the security lun is supported.
 113                 This is one of the UFS device descriptor parameters.
 114                 The full information about the descriptor could be found
 115                 at UFS specifications 2.1.
 116                 The file is read only.
 117
 118 What:           /sys/bus/platform/drivers/ufshcd/*/device_descriptor/bkops_termination_latency
 119 Date:           February 2018
 120 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 121 Description:    This file shows the background operations termination
 122                 latency. This is one of the UFS device descriptor parameters.
 123                 The full information about the descriptor could be found
 124                 at UFS specifications 2.1.
 125                 The file is read only.
 126
 127 What:           /sys/bus/platform/drivers/ufshcd/*/device_descriptor/initial_active_icc_level
 128 Date:           February 2018
 129 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 130 Description:    This file shows the initial active ICC level. This is one
 131                 of the UFS device descriptor parameters. The full information
 132                 about the descriptor could be found at UFS specifications 2.1.
 133                 The file is read only.
 134
 135 What:           /sys/bus/platform/drivers/ufshcd/*/device_descriptor/specification_version
 136 Date:           February 2018
 137 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 138 Description:    This file shows the specification version. This is one
 139                 of the UFS device descriptor parameters. The full information
 140                 about the descriptor could be found at UFS specifications 2.1.
 141                 The file is read only.
 142
 143 What:           /sys/bus/platform/drivers/ufshcd/*/device_descriptor/manufacturing_date
 144 Date:           February 2018
 145 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 146 Description:    This file shows the manufacturing date in BCD format.
 147                 This is one of the UFS device descriptor parameters.
 148                 The full information about the descriptor could be found
 149                 at UFS specifications 2.1.
 150                 The file is read only.
 151
 152 What:           /sys/bus/platform/drivers/ufshcd/*/device_descriptor/manufacturer_id
 153 Date:           February 2018
 154 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 155 Description:    This file shows the manufacturee ID. This is one of the
 156                 UFS device descriptor parameters. The full information about
 157                 the descriptor could be found at UFS specifications 2.1.
 158                 The file is read only.
 159
 160 What:           /sys/bus/platform/drivers/ufshcd/*/device_descriptor/rtt_capability
 161 Date:           February 2018
 162 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 163 Description:    This file shows the maximum number of outstanding RTTs
 164                 supported by the device. This is one of the UFS device
 165                 descriptor parameters. The full information about
 166                 the descriptor could be found at UFS specifications 2.1.
 167                 The file is read only.
 168
 169 What:           /sys/bus/platform/drivers/ufshcd/*/device_descriptor/rtc_update
 170 Date:           February 2018
 171 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 172 Description:    This file shows the frequency and method of the realtime
 173                 clock update. This is one of the UFS device descriptor
 174                 parameters. The full information about the descriptor
 175                 could be found at UFS specifications 2.1.
 176                 The file is read only.
 177
 178 What:           /sys/bus/platform/drivers/ufshcd/*/device_descriptor/ufs_features
 179 Date:           February 2018
 180 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 181 Description:    This file shows which features are supported by the device.
 182                 This is one of the UFS device descriptor parameters.
 183                 The full information about the descriptor could be
 184                 found at UFS specifications 2.1.
 185                 The file is read only.
 186
 187 What:           /sys/bus/platform/drivers/ufshcd/*/device_descriptor/ffu_timeout
 188 Date:           February 2018
 189 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 190 Description:    This file shows the FFU timeout. This is one of the
 191                 UFS device descriptor parameters. The full information
 192                 about the descriptor could be found at UFS specifications 2.1.
 193                 The file is read only.
 194
 195 What:           /sys/bus/platform/drivers/ufshcd/*/device_descriptor/queue_depth
 196 Date:           February 2018
 197 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 198 Description:    This file shows the device queue depth. This is one of the
 199                 UFS device descriptor parameters. The full information
 200                 about the descriptor could be found at UFS specifications 2.1.
 201                 The file is read only.
 202
 203 What:           /sys/bus/platform/drivers/ufshcd/*/device_descriptor/device_version
 204 Date:           February 2018
 205 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 206 Description:    This file shows the device version. This is one of the
 207                 UFS device descriptor parameters. The full information
 208                 about the descriptor could be found at UFS specifications 2.1.
 209                 The file is read only.
 210
 211 What:           /sys/bus/platform/drivers/ufshcd/*/device_descriptor/number_of_secure_wpa
 212 Date:           February 2018
 213 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 214 Description:    This file shows number of secure write protect areas
 215                 supported by the device. This is one of the UFS device
 216                 descriptor parameters. The full information about
 217                 the descriptor could be found at UFS specifications 2.1.
 218                 The file is read only.
 219
 220 What:           /sys/bus/platform/drivers/ufshcd/*/device_descriptor/psa_max_data_size
 221 Date:           February 2018
 222 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 223 Description:    This file shows the maximum amount of data that may be
 224                 written during the pre-soldering phase of the PSA flow.
 225                 This is one of the UFS device descriptor parameters.
 226                 The full information about the descriptor could be found
 227                 at UFS specifications 2.1.
 228                 The file is read only.
 229
 230 What:           /sys/bus/platform/drivers/ufshcd/*/device_descriptor/psa_state_timeout
 231 Date:           February 2018
 232 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 233 Description:    This file shows the command maximum timeout for a change
 234                 in PSA state. This is one of the UFS device descriptor
 235                 parameters. The full information about the descriptor could
 236                 be found at UFS specifications 2.1.
 237                 The file is read only.
 238
 239
 240 What:           /sys/bus/platform/drivers/ufshcd/*/interconnect_descriptor/unipro_version
 241 Date:           February 2018
 242 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 243 Description:    This file shows the MIPI UniPro version number in BCD format.
 244                 This is one of the UFS interconnect descriptor parameters.
 245                 The full information about the descriptor could be found at
 246                 UFS specifications 2.1.
 247                 The file is read only.
 248
 249 What:           /sys/bus/platform/drivers/ufshcd/*/interconnect_descriptor/mphy_version
 250 Date:           February 2018
 251 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 252 Description:    This file shows the MIPI M-PHY version number in BCD format.
 253                 This is one of the UFS interconnect descriptor parameters.
 254                 The full information about the descriptor could be found at
 255                 UFS specifications 2.1.
 256                 The file is read only.
 257
 258
 259 What:           /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/raw_device_capacity
 260 Date:           February 2018
 261 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 262 Description:    This file shows the total memory quantity available to
 263                 the user to configure the device logical units. This is one
 264                 of the UFS geometry descriptor parameters. The full
 265                 information about the descriptor could be found at
 266                 UFS specifications 2.1.
 267                 The file is read only.
 268
 269 What:           /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/max_number_of_luns
 270 Date:           February 2018
 271 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 272 Description:    This file shows the maximum number of logical units
 273                 supported by the UFS device. This is one of the UFS
 274                 geometry descriptor parameters. The full information about
 275                 the descriptor could be found at UFS specifications 2.1.
 276                 The file is read only.
 277
 278 What:           /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/segment_size
 279 Date:           February 2018
 280 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 281 Description:    This file shows the segment size. This is one of the UFS
 282                 geometry descriptor parameters. The full information about
 283                 the descriptor could be found at UFS specifications 2.1.
 284                 The file is read only.
 285
 286 What:           /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/allocation_unit_size
 287 Date:           February 2018
 288 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 289 Description:    This file shows the allocation unit size. This is one of
 290                 the UFS geometry descriptor parameters. The full information
 291                 about the descriptor could be found at UFS specifications 2.1.
 292                 The file is read only.
 293
 294 What:           /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/min_addressable_block_size
 295 Date:           February 2018
 296 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 297 Description:    This file shows the minimum addressable block size. This
 298                 is one of the UFS geometry descriptor parameters. The full
 299                 information about the descriptor could be found at UFS
 300                 specifications 2.1.
 301                 The file is read only.
 302
 303 What:           /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/optimal_read_block_size
 304 Date:           February 2018
 305 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 306 Description:    This file shows the optimal read block size. This is one
 307                 of the UFS geometry descriptor parameters. The full
 308                 information about the descriptor could be found at UFS
 309                 specifications 2.1.
 310                 The file is read only.
 311
 312 What:           /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/optimal_write_block_size
 313 Date:           February 2018
 314 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 315 Description:    This file shows the optimal write block size. This is one
 316                 of the UFS geometry descriptor parameters. The full
 317                 information about the descriptor could be found at UFS
 318                 specifications 2.1.
 319                 The file is read only.
 320
 321 What:           /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/max_in_buffer_size
 322 Date:           February 2018
 323 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 324 Description:    This file shows the maximum data-in buffer size. This
 325                 is one of the UFS geometry descriptor parameters. The full
 326                 information about the descriptor could be found at UFS
 327                 specifications 2.1.
 328                 The file is read only.
 329
 330 What:           /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/max_out_buffer_size
 331 Date:           February 2018
 332 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 333 Description:    This file shows the maximum data-out buffer size. This
 334                 is one of the UFS geometry descriptor parameters. The full
 335                 information about the descriptor could be found at UFS
 336                 specifications 2.1.
 337                 The file is read only.
 338
 339 What:           /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/rpmb_rw_size
 340 Date:           February 2018
 341 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 342 Description:    This file shows the maximum number of RPMB frames allowed
 343                 in Security Protocol In/Out. This is one of the UFS geometry
 344                 descriptor parameters. The full information about the
 345                 descriptor could be found at UFS specifications 2.1.
 346                 The file is read only.
 347
 348 What:           /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/dyn_capacity_resource_policy
 349 Date:           February 2018
 350 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 351 Description:    This file shows the dynamic capacity resource policy. This
 352                 is one of the UFS geometry descriptor parameters. The full
 353                 information about the descriptor could be found at
 354                 UFS specifications 2.1.
 355                 The file is read only.
 356
 357 What:           /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/data_ordering
 358 Date:           February 2018
 359 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 360 Description:    This file shows support for out-of-order data transfer.
 361                 This is one of the UFS geometry descriptor parameters.
 362                 The full information about the descriptor could be found at
 363                 UFS specifications 2.1.
 364                 The file is read only.
 365
 366 What:           /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/max_number_of_contexts
 367 Date:           February 2018
 368 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 369 Description:    This file shows maximum available number of contexts which
 370                 are supported by the device. This is one of the UFS geometry
 371                 descriptor parameters. The full information about the
 372                 descriptor could be found at UFS specifications 2.1.
 373                 The file is read only.
 374
 375 What:           /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/sys_data_tag_unit_size
 376 Date:           February 2018
 377 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 378 Description:    This file shows system data tag unit size. This is one of
 379                 the UFS geometry descriptor parameters. The full information
 380                 about the descriptor could be found at UFS specifications 2.1.
 381                 The file is read only.
 382
 383 What:           /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/sys_data_tag_resource_size
 384 Date:           February 2018
 385 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 386 Description:    This file shows maximum storage area size allocated by
 387                 the device to handle system data by the tagging mechanism.
 388                 This is one of the UFS geometry descriptor parameters.
 389                 The full information about the descriptor could be found at
 390                 UFS specifications 2.1.
 391                 The file is read only.
 392
 393 What:           /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/secure_removal_types
 394 Date:           February 2018
 395 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 396 Description:    This file shows supported secure removal types. This is
 397                 one of the UFS geometry descriptor parameters. The full
 398                 information about the descriptor could be found at
 399                 UFS specifications 2.1.
 400                 The file is read only.
 401
 402 What:           /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/memory_types
 403 Date:           February 2018
 404 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 405 Description:    This file shows supported memory types. This is one of
 406                 the UFS geometry descriptor parameters. The full
 407                 information about the descriptor could be found at
 408                 UFS specifications 2.1.
 409                 The file is read only.
 410
 411 What:           /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/*_memory_max_alloc_units
 412 Date:           February 2018
 413 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 414 Description:    This file shows the maximum number of allocation units for
 415                 different memory types (system code, non persistent,
 416                 enhanced type 1-4). This is one of the UFS geometry
 417                 descriptor parameters. The full information about the
 418                 descriptor could be found at UFS specifications 2.1.
 419                 The file is read only.
 420
 421 What:           /sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/*_memory_capacity_adjustment_factor
 422 Date:           February 2018
 423 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 424 Description:    This file shows the memory capacity adjustment factor for
 425                 different memory types (system code, non persistent,
 426                 enhanced type 1-4). This is one of the UFS geometry
 427                 descriptor parameters. The full information about the
 428                 descriptor could be found at UFS specifications 2.1.
 429                 The file is read only.
 430
 431
 432 What:           /sys/bus/platform/drivers/ufshcd/*/health_descriptor/eol_info
 433 Date:           February 2018
 434 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 435 Description:    This file shows preend of life information. This is one
 436                 of the UFS health descriptor parameters. The full
 437                 information about the descriptor could be found at
 438                 UFS specifications 2.1.
 439                 The file is read only.
 440
 441 What:           /sys/bus/platform/drivers/ufshcd/*/health_descriptor/life_time_estimation_a
 442 Date:           February 2018
 443 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 444 Description:    This file shows indication of the device life time
 445                 (method a). This is one of the UFS health descriptor
 446                 parameters. The full information about the descriptor
 447                 could be found at UFS specifications 2.1.
 448                 The file is read only.
 449
 450 What:           /sys/bus/platform/drivers/ufshcd/*/health_descriptor/life_time_estimation_b
 451 Date:           February 2018
 452 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 453 Description:    This file shows indication of the device life time
 454                 (method b). This is one of the UFS health descriptor
 455                 parameters. The full information about the descriptor
 456                 could be found at UFS specifications 2.1.
 457                 The file is read only.
 458
 459
 460 What:           /sys/bus/platform/drivers/ufshcd/*/power_descriptor/active_icc_levels_vcc*
 461 Date:           February 2018
 462 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 463 Description:    This file shows maximum VCC, VCCQ and VCCQ2 value for
 464                 active ICC levels from 0 to 15. This is one of the UFS
 465                 power descriptor parameters. The full information about
 466                 the descriptor could be found at UFS specifications 2.1.
 467                 The file is read only.
 468
 469
 470 What:           /sys/bus/platform/drivers/ufshcd/*/string_descriptors/manufacturer_name
 471 Date:           February 2018
 472 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 473 Description:    This file contains a device manufactureer name string.
 474                 The full information about the descriptor could be found at
 475                 UFS specifications 2.1.
 476                 The file is read only.
 477
 478 What:           /sys/bus/platform/drivers/ufshcd/*/string_descriptors/product_name
 479 Date:           February 2018
 480 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 481 Description:    This file contains a product name string. The full information
 482                 about the descriptor could be found at UFS specifications 2.1.
 483                 The file is read only.
 484
 485 What:           /sys/bus/platform/drivers/ufshcd/*/string_descriptors/oem_id
 486 Date:           February 2018
 487 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 488 Description:    This file contains a OEM ID string. The full information
 489                 about the descriptor could be found at UFS specifications 2.1.
 490                 The file is read only.
 491
 492 What:           /sys/bus/platform/drivers/ufshcd/*/string_descriptors/serial_number
 493 Date:           February 2018
 494 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 495 Description:    This file contains a device serial number string. The full
 496                 information about the descriptor could be found at
 497                 UFS specifications 2.1.
 498                 The file is read only.
 499
 500 What:           /sys/bus/platform/drivers/ufshcd/*/string_descriptors/product_revision
 501 Date:           February 2018
 502 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 503 Description:    This file contains a product revision string. The full
 504                 information about the descriptor could be found at
 505                 UFS specifications 2.1.
 506                 The file is read only.
 507
 508
 509 What:           /sys/class/scsi_device/*/device/unit_descriptor/boot_lun_id
 510 Date:           February 2018
 511 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 512 Description:    This file shows boot LUN information. This is one of
 513                 the UFS unit descriptor parameters. The full information
 514                 about the descriptor could be found at UFS specifications 2.1.
 515                 The file is read only.
 516
 517 What:           /sys/class/scsi_device/*/device/unit_descriptor/lun_write_protect
 518 Date:           February 2018
 519 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 520 Description:    This file shows LUN write protection status. This is one of
 521                 the UFS unit descriptor parameters. The full information
 522                 about the descriptor could be found at UFS specifications 2.1.
 523                 The file is read only.
 524
 525 What:           /sys/class/scsi_device/*/device/unit_descriptor/lun_queue_depth
 526 Date:           February 2018
 527 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 528 Description:    This file shows LUN queue depth. This is one of the UFS
 529                 unit descriptor parameters. The full information about
 530                 the descriptor could be found at UFS specifications 2.1.
 531                 The file is read only.
 532
 533 What:           /sys/class/scsi_device/*/device/unit_descriptor/psa_sensitive
 534 Date:           February 2018
 535 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 536 Description:    This file shows PSA sensitivity. This is one of the UFS
 537                 unit descriptor parameters. The full information about
 538                 the descriptor could be found at UFS specifications 2.1.
 539                 The file is read only.
 540
 541 What:           /sys/class/scsi_device/*/device/unit_descriptor/lun_memory_type
 542 Date:           February 2018
 543 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 544 Description:    This file shows LUN memory type. This is one of the UFS
 545                 unit descriptor parameters. The full information about
 546                 the descriptor could be found at UFS specifications 2.1.
 547                 The file is read only.
 548
 549 What:           /sys/class/scsi_device/*/device/unit_descriptor/data_reliability
 550 Date:           February 2018
 551 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 552 Description:    This file defines the device behavior when a power failure
 553                 occurs during a write operation. This is one of the UFS
 554                 unit descriptor parameters. The full information about
 555                 the descriptor could be found at UFS specifications 2.1.
 556                 The file is read only.
 557
 558 What:           /sys/class/scsi_device/*/device/unit_descriptor/logical_block_size
 559 Date:           February 2018
 560 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 561 Description:    This file shows the size of addressable logical blocks
 562                 (calculated as an exponent with base 2). This is one of
 563                 the UFS unit descriptor parameters. The full information about
 564                 the descriptor could be found at UFS specifications 2.1.
 565                 The file is read only.
 566
 567 What:           /sys/class/scsi_device/*/device/unit_descriptor/logical_block_count
 568 Date:           February 2018
 569 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 570 Description:    This file shows total number of addressable logical blocks.
 571                 This is one of the UFS unit descriptor parameters. The full
 572                 information about the descriptor could be found at
 573                 UFS specifications 2.1.
 574                 The file is read only.
 575
 576 What:           /sys/class/scsi_device/*/device/unit_descriptor/erase_block_size
 577 Date:           February 2018
 578 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 579 Description:    This file shows the erase block size. This is one of
 580                 the UFS unit descriptor parameters. The full information
 581                 about the descriptor could be found at UFS specifications 2.1.
 582                 The file is read only.
 583
 584 What:           /sys/class/scsi_device/*/device/unit_descriptor/provisioning_type
 585 Date:           February 2018
 586 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 587 Description:    This file shows the thin provisioning type. This is one of
 588                 the UFS unit descriptor parameters. The full information
 589                 about the descriptor could be found at UFS specifications 2.1.
 590                 The file is read only.
 591
 592 What:           /sys/class/scsi_device/*/device/unit_descriptor/physical_memory_resourse_count
 593 Date:           February 2018
 594 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 595 Description:    This file shows the total physical memory resources. This is
 596                 one of the UFS unit descriptor parameters. The full information
 597                 about the descriptor could be found at UFS specifications 2.1.
 598                 The file is read only.
 599
 600 What:           /sys/class/scsi_device/*/device/unit_descriptor/context_capabilities
 601 Date:           February 2018
 602 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 603 Description:    This file shows the context capabilities. This is one of
 604                 the UFS unit descriptor parameters. The full information
 605                 about the descriptor could be found at UFS specifications 2.1.
 606                 The file is read only.
 607
 608 What:           /sys/class/scsi_device/*/device/unit_descriptor/large_unit_granularity
 609 Date:           February 2018
 610 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 611 Description:    This file shows the granularity of the LUN. This is one of
 612                 the UFS unit descriptor parameters. The full information
 613                 about the descriptor could be found at UFS specifications 2.1.
 614                 The file is read only.
 615
 616
 617 What:           /sys/bus/platform/drivers/ufshcd/*/flags/device_init
 618 Date:           February 2018
 619 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 620 Description:    This file shows the device init status. The full information
 621                 about the flag could be found at UFS specifications 2.1.
 622                 The file is read only.
 623
 624 What:           /sys/bus/platform/drivers/ufshcd/*/flags/permanent_wpe
 625 Date:           February 2018
 626 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 627 Description:    This file shows whether permanent write protection is enabled.
 628                 The full information about the flag could be found at
 629                 UFS specifications 2.1.
 630                 The file is read only.
 631
 632 What:           /sys/bus/platform/drivers/ufshcd/*/flags/power_on_wpe
 633 Date:           February 2018
 634 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 635 Description:    This file shows whether write protection is enabled on all
 636                 logical units configured as power on write protected. The
 637                 full information about the flag could be found at
 638                 UFS specifications 2.1.
 639                 The file is read only.
 640
 641 What:           /sys/bus/platform/drivers/ufshcd/*/flags/bkops_enable
 642 Date:           February 2018
 643 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 644 Description:    This file shows whether the device background operations are
 645                 enabled. The full information about the flag could be
 646                 found at UFS specifications 2.1.
 647                 The file is read only.
 648
 649 What:           /sys/bus/platform/drivers/ufshcd/*/flags/life_span_mode_enable
 650 Date:           February 2018
 651 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 652 Description:    This file shows whether the device life span mode is enabled.
 653                 The full information about the flag could be found at
 654                 UFS specifications 2.1.
 655                 The file is read only.
 656
 657 What:           /sys/bus/platform/drivers/ufshcd/*/flags/phy_resource_removal
 658 Date:           February 2018
 659 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 660 Description:    This file shows whether physical resource removal is enable.
 661                 The full information about the flag could be found at
 662                 UFS specifications 2.1.
 663                 The file is read only.
 664
 665 What:           /sys/bus/platform/drivers/ufshcd/*/flags/busy_rtc
 666 Date:           February 2018
 667 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 668 Description:    This file shows whether the device is executing internal
 669                 operation related to real time clock. The full information
 670                 about the flag could be found at UFS specifications 2.1.
 671                 The file is read only.
 672
 673 What:           /sys/bus/platform/drivers/ufshcd/*/flags/disable_fw_update
 674 Date:           February 2018
 675 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 676 Description:    This file shows whether the device FW update is permanently
 677                 disabled. The full information about the flag could be found
 678                 at UFS specifications 2.1.
 679                 The file is read only.
 680
 681
 682 What:           /sys/bus/platform/drivers/ufshcd/*/attributes/boot_lun_enabled
 683 Date:           February 2018
 684 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 685 Description:    This file provides the boot lun enabled UFS device attribute.
 686                 The full information about the attribute could be found at
 687                 UFS specifications 2.1.
 688                 The file is read only.
 689
 690 What:           /sys/bus/platform/drivers/ufshcd/*/attributes/current_power_mode
 691 Date:           February 2018
 692 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 693 Description:    This file provides the current power mode UFS device attribute.
 694                 The full information about the attribute could be found at
 695                 UFS specifications 2.1.
 696                 The file is read only.
 697
 698 What:           /sys/bus/platform/drivers/ufshcd/*/attributes/active_icc_level
 699 Date:           February 2018
 700 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 701 Description:    This file provides the active icc level UFS device attribute.
 702                 The full information about the attribute could be found at
 703                 UFS specifications 2.1.
 704                 The file is read only.
 705
 706 What:           /sys/bus/platform/drivers/ufshcd/*/attributes/ooo_data_enabled
 707 Date:           February 2018
 708 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 709 Description:    This file provides the out of order data transfer enabled UFS
 710                 device attribute. The full information about the attribute
 711                 could be found at UFS specifications 2.1.
 712                 The file is read only.
 713
 714 What:           /sys/bus/platform/drivers/ufshcd/*/attributes/bkops_status
 715 Date:           February 2018
 716 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 717 Description:    This file provides the background operations status UFS device
 718                 attribute. The full information about the attribute could
 719                 be found at UFS specifications 2.1.
 720                 The file is read only.
 721
 722 What:           /sys/bus/platform/drivers/ufshcd/*/attributes/purge_status
 723 Date:           February 2018
 724 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 725 Description:    This file provides the purge operation status UFS device
 726                 attribute. The full information about the attribute could
 727                 be found at UFS specifications 2.1.
 728                 The file is read only.
 729
 730 What:           /sys/bus/platform/drivers/ufshcd/*/attributes/max_data_in_size
 731 Date:           February 2018
 732 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 733 Description:    This file shows the maximum data size in a DATA IN
 734                 UPIU. The full information about the attribute could
 735                 be found at UFS specifications 2.1.
 736                 The file is read only.
 737
 738 What:           /sys/bus/platform/drivers/ufshcd/*/attributes/max_data_out_size
 739 Date:           February 2018
 740 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 741 Description:    This file shows the maximum number of bytes that can be
 742                 requested with a READY TO TRANSFER UPIU. The full information
 743                 about the attribute could be found at UFS specifications 2.1.
 744                 The file is read only.
 745
 746 What:           /sys/bus/platform/drivers/ufshcd/*/attributes/reference_clock_frequency
 747 Date:           February 2018
 748 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 749 Description:    This file provides the reference clock frequency UFS device
 750                 attribute. The full information about the attribute could
 751                 be found at UFS specifications 2.1.
 752                 The file is read only.
 753
 754 What:           /sys/bus/platform/drivers/ufshcd/*/attributes/configuration_descriptor_lock
 755 Date:           February 2018
 756 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 757 Description:    This file shows whether the configuration descriptor is locked.
 758                 The full information about the attribute could be found at
 759                 UFS specifications 2.1. The file is read only.
 760
 761 What:           /sys/bus/platform/drivers/ufshcd/*/attributes/max_number_of_rtt
 762 Date:           February 2018
 763 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 764 Description:    This file provides the maximum current number of
 765                 outstanding RTTs in device that is allowed. The full
 766                 information about the attribute could be found at
 767                 UFS specifications 2.1.
 768                 The file is read only.
 769
 770 What:           /sys/bus/platform/drivers/ufshcd/*/attributes/exception_event_control
 771 Date:           February 2018
 772 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 773 Description:    This file provides the exception event control UFS device
 774                 attribute. The full information about the attribute could
 775                 be found at UFS specifications 2.1.
 776                 The file is read only.
 777
 778 What:           /sys/bus/platform/drivers/ufshcd/*/attributes/exception_event_status
 779 Date:           February 2018
 780 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 781 Description:    This file provides the exception event status UFS device
 782                 attribute. The full information about the attribute could
 783                 be found at UFS specifications 2.1.
 784                 The file is read only.
 785
 786 What:           /sys/bus/platform/drivers/ufshcd/*/attributes/ffu_status
 787 Date:           February 2018
 788 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 789 Description:    This file provides the ffu status UFS device attribute.
 790                 The full information about the attribute could be found at
 791                 UFS specifications 2.1.
 792                 The file is read only.
 793
 794 What:           /sys/bus/platform/drivers/ufshcd/*/attributes/psa_state
 795 Date:           February 2018
 796 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 797 Description:    This file show the PSA feature status. The full information
 798                 about the attribute could be found at UFS specifications 2.1.
 799                 The file is read only.
 800
 801 What:           /sys/bus/platform/drivers/ufshcd/*/attributes/psa_data_size
 802 Date:           February 2018
 803 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 804 Description:    This file shows the amount of data that the host plans to
 805                 load to all logical units in pre-soldering state.
 806                 The full information about the attribute could be found at
 807                 UFS specifications 2.1.
 808                 The file is read only.
 809
 810
 811 What:           /sys/class/scsi_device/*/device/dyn_cap_needed
 812 Date:           February 2018
 813 Contact:        Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
 814 Description:    This file shows the The amount of physical memory needed
 815                 to be removed from the physical memory resources pool of
 816                 the particular logical unit. The full information about
 817                 the attribute could be found at UFS specifications 2.1.
 818                 The file is read only.
 819
 820
 821 What:           /sys/bus/platform/drivers/ufshcd/*/rpm_lvl
 822 Date:           September 2014
 823 Contact:        Subhash Jadavani <subhashj@codeaurora.org>
 824 Description:    This entry could be used to set or show the UFS device
 825                 runtime power management level. The current driver
 826                 implementation supports 6 levels with next target states:
 827                 0 - an UFS device will stay active, an UIC link will
 828                 stay active
 829                 1 - an UFS device will stay active, an UIC link will
 830                 hibernate
 831                 2 - an UFS device will moved to sleep, an UIC link will
 832                 stay active
 833                 3 - an UFS device will moved to sleep, an UIC link will
 834                 hibernate
 835                 4 - an UFS device will be powered off, an UIC link will
 836                 hibernate
 837                 5 - an UFS device will be powered off, an UIC link will
 838                 be powered off
 839
 840 What:           /sys/bus/platform/drivers/ufshcd/*/rpm_target_dev_state
 841 Date:           February 2018
 842 Contact:        Subhash Jadavani <subhashj@codeaurora.org>
 843 Description:    This entry shows the target power mode of an UFS device
 844                 for the chosen runtime power management level.
 845                 The file is read only.
 846
 847 What:           /sys/bus/platform/drivers/ufshcd/*/rpm_target_link_state
 848 Date:           February 2018
 849 Contact:        Subhash Jadavani <subhashj@codeaurora.org>
 850 Description:    This entry shows the target state of an UFS UIC link
 851                 for the chosen runtime power management level.
 852                 The file is read only.
 853
 854 What:           /sys/bus/platform/drivers/ufshcd/*/spm_lvl
 855 Date:           September 2014
 856 Contact:        Subhash Jadavani <subhashj@codeaurora.org>
 857 Description:    This entry could be used to set or show the UFS device
 858                 system power management level. The current driver
 859                 implementation supports 6 levels with next target states:
 860                 0 - an UFS device will stay active, an UIC link will
 861                 stay active
 862                 1 - an UFS device will stay active, an UIC link will
 863                 hibernate
 864                 2 - an UFS device will moved to sleep, an UIC link will
 865                 stay active
 866                 3 - an UFS device will moved to sleep, an UIC link will
 867                 hibernate
 868                 4 - an UFS device will be powered off, an UIC link will
 869                 hibernate
 870                 5 - an UFS device will be powered off, an UIC link will
 871                 be powered off
 872
 873 What:           /sys/bus/platform/drivers/ufshcd/*/spm_target_dev_state
 874 Date:           February 2018
 875 Contact:        Subhash Jadavani <subhashj@codeaurora.org>
 876 Description:    This entry shows the target power mode of an UFS device
 877                 for the chosen system power management level.
 878                 The file is read only.
 879
 880 What:           /sys/bus/platform/drivers/ufshcd/*/spm_target_link_state
 881 Date:           February 2018
 882 Contact:        Subhash Jadavani <subhashj@codeaurora.org>
 883 Description:    This entry shows the target state of an UFS UIC link
 884                 for the chosen system power management level.
 885                 The file is read only.