97fb5e8d9b
Based on 1 normalized pattern(s): this program is free software you can redistribute it and or modify it under the terms of the gnu general public license version 2 and only version 2 as published by the free software foundation this program is distributed in the hope that it will be useful but without any warranty without even the implied warranty of merchantability or fitness for a particular purpose see the gnu general public license for more details extracted by the scancode license scanner the SPDX license identifier GPL-2.0-only has been chosen to replace the boilerplate/reference in 294 file(s). Signed-off-by: Thomas Gleixner <tglx@linutronix.de> Reviewed-by: Allison Randal <allison@lohutok.net> Reviewed-by: Alexios Zavras <alexios.zavras@intel.com> Cc: linux-spdx@vger.kernel.org Link: https://lkml.kernel.org/r/20190529141900.825281744@linutronix.de Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
103 lines
3.6 KiB
C
103 lines
3.6 KiB
C
/* SPDX-License-Identifier: GPL-2.0-only */
|
|
/*
|
|
* Copyright (c) 2014-2016, The Linux Foundation. All rights reserved.
|
|
*/
|
|
|
|
#ifndef _UFS_QUIRKS_H_
|
|
#define _UFS_QUIRKS_H_
|
|
|
|
/* return true if s1 is a prefix of s2 */
|
|
#define STR_PRFX_EQUAL(s1, s2) !strncmp(s1, s2, strlen(s1))
|
|
|
|
#define UFS_ANY_VENDOR 0xFFFF
|
|
#define UFS_ANY_MODEL "ANY_MODEL"
|
|
|
|
#define UFS_VENDOR_TOSHIBA 0x198
|
|
#define UFS_VENDOR_SAMSUNG 0x1CE
|
|
#define UFS_VENDOR_SKHYNIX 0x1AD
|
|
|
|
/**
|
|
* ufs_dev_fix - ufs device quirk info
|
|
* @card: ufs card details
|
|
* @quirk: device quirk
|
|
*/
|
|
struct ufs_dev_fix {
|
|
struct ufs_dev_desc card;
|
|
unsigned int quirk;
|
|
};
|
|
|
|
#define END_FIX { { 0 }, 0 }
|
|
|
|
/* add specific device quirk */
|
|
#define UFS_FIX(_vendor, _model, _quirk) { \
|
|
.card.wmanufacturerid = (_vendor),\
|
|
.card.model = (_model), \
|
|
.quirk = (_quirk), \
|
|
}
|
|
|
|
/*
|
|
* Some vendor's UFS device sends back to back NACs for the DL data frames
|
|
* causing the host controller to raise the DFES error status. Sometimes
|
|
* such UFS devices send back to back NAC without waiting for new
|
|
* retransmitted DL frame from the host and in such cases it might be possible
|
|
* the Host UniPro goes into bad state without raising the DFES error
|
|
* interrupt. If this happens then all the pending commands would timeout
|
|
* only after respective SW command (which is generally too large).
|
|
*
|
|
* We can workaround such device behaviour like this:
|
|
* - As soon as SW sees the DL NAC error, it should schedule the error handler
|
|
* - Error handler would sleep for 50ms to see if there are any fatal errors
|
|
* raised by UFS controller.
|
|
* - If there are fatal errors then SW does normal error recovery.
|
|
* - If there are no fatal errors then SW sends the NOP command to device
|
|
* to check if link is alive.
|
|
* - If NOP command times out, SW does normal error recovery
|
|
* - If NOP command succeed, skip the error handling.
|
|
*
|
|
* If DL NAC error is seen multiple times with some vendor's UFS devices then
|
|
* enable this quirk to initiate quick error recovery and also silence related
|
|
* error logs to reduce spamming of kernel logs.
|
|
*/
|
|
#define UFS_DEVICE_QUIRK_RECOVERY_FROM_DL_NAC_ERRORS (1 << 2)
|
|
|
|
/*
|
|
* Few Toshiba UFS device models advertise RX_MIN_ACTIVATETIME_CAPABILITY as
|
|
* 600us which may not be enough for reliable hibern8 exit hardware sequence
|
|
* from UFS device.
|
|
* To workaround this issue, host should set its PA_TACTIVATE time to 1ms even
|
|
* if device advertises RX_MIN_ACTIVATETIME_CAPABILITY less than 1ms.
|
|
*/
|
|
#define UFS_DEVICE_QUIRK_PA_TACTIVATE (1 << 4)
|
|
|
|
/*
|
|
* It seems some UFS devices may keep drawing more than sleep current
|
|
* (atleast for 500us) from UFS rails (especially from VCCQ rail).
|
|
* To avoid this situation, add 2ms delay before putting these UFS
|
|
* rails in LPM mode.
|
|
*/
|
|
#define UFS_DEVICE_QUIRK_DELAY_BEFORE_LPM (1 << 6)
|
|
|
|
/*
|
|
* Some UFS devices require host PA_TACTIVATE to be lower than device
|
|
* PA_TACTIVATE, enabling this quirk ensure this.
|
|
*/
|
|
#define UFS_DEVICE_QUIRK_HOST_PA_TACTIVATE (1 << 7)
|
|
|
|
/*
|
|
* The max. value PA_SaveConfigTime is 250 (10us) but this is not enough for
|
|
* some vendors.
|
|
* Gear switch from PWM to HS may fail even with this max. PA_SaveConfigTime.
|
|
* Gear switch can be issued by host controller as an error recovery and any
|
|
* software delay will not help on this case so we need to increase
|
|
* PA_SaveConfigTime to >32us as per vendor recommendation.
|
|
*/
|
|
#define UFS_DEVICE_QUIRK_HOST_PA_SAVECONFIGTIME (1 << 8)
|
|
|
|
/*
|
|
* Some UFS devices require VS_DebugSaveConfigTime is 0x10,
|
|
* enabling this quirk ensure this.
|
|
*/
|
|
#define UFS_DEVICE_QUIRK_HOST_VS_DEBUGSAVECONFIGTIME (1 << 9)
|
|
|
|
#endif /* UFS_QUIRKS_H_ */
|