Message ID | 20200312171259.151442-5-ebiggers@kernel.org (mailing list archive) |
---|---|
State | New, archived |
Headers | show |
Series | Inline crypto support on DragonBoard 845c | expand |
Hi Eric, I am confused on why you are trying to re-implement functions already present within the crypto_vops. Is there a reason why the ICE driver cannot register for KSM with its own function for keyslot_program and keyslot_evict and register for crypto_vops with its own functions for 'init/enable/disable/suspend/resume/debug'. Given that the ufs-crypto has the interface to do this why do we have to re-implement the same functionality with another set of functions. In addition in the future if for performance reasons (with per-file keys) we have to use passthrough KSM and use prepare/complete_lrbp_crypto that can easily be added as well. IMO the crypto_vops is a clean way for vendors to override the default functionality rather than using direct function calls from within the UFS driver and this can easily be extended for eMMC. -----Original Message----- From: Eric Biggers <ebiggers@kernel.org> Sent: Thursday, March 12, 2020 10:13 AM To: linux-scsi@vger.kernel.org; linux-arm-msm@vger.kernel.org Cc: linux-block@vger.kernel.org; linux-fscrypt@vger.kernel.org; Alim Akhtar <alim.akhtar@samsung.com>; Andy Gross <agross@kernel.org>; Avri Altman <avri.altman@wdc.com>; Barani Muthukumaran <bmuthuku@qti.qualcomm.com>; bjorn.andersson@linaro.org; Can Guo <cang@codeaurora.org>; Elliot Berman <eberman@codeaurora.org>; Jaegeuk Kim <jaegeuk@kernel.org>; John Stultz <john.stultz@linaro.org>; Satya Tangirala <satyat@google.com> Subject: [EXT] [RFC PATCH v3 4/4] scsi: ufs-qcom: add Inline Crypto Engine support From: Eric Biggers <ebiggers@google.com> Add support for Qualcomm Inline Crypto Engine (ICE) to ufs-qcom. The standards-compliant parts, such as querying the crypto capabilities and enabling crypto for individual UFS requests, are already handled by ufshcd-crypto.c, which itself is wired into the blk-crypto framework. However, ICE requires vendor-specific init, enable, and resume logic, and it requires that keys be programmed and evicted by vendor-specific SMC calls. Make the ufs-qcom driver handle these details. I tested this on Dragonboard 845c, which is a publicly available development board that uses the Snapdragon 845 SoC and runs the upstream Linux kernel. This is the same SoC used in the Pixel 3 and Pixel 3 XL phones. This testing included (among other things) verifying that the expected ciphertext was produced, both manually using ext4 encryption and automatically using a block layer self-test I've written. This driver also works nearly as-is on Snapdragon 765 and Snapdragon 865, which are very recent SoCs, having just been announced in Dec 2019 (though these newer SoCs currently lack upstream kernel support). This is based very loosely on the vendor-provided driver in the kernel source code for the Pixel 3, but I've greatly simplified it. Also, for now I've only included support for major version 3 of ICE, since that's all I have the hardware to test with the mainline kernel. Plus it appears that version 3 is easier to use than older versions of ICE. For now, only allow using AES-256-XTS. The hardware also declares support for AES-128-XTS, AES-{128,256}-ECB, and AES-{128,256}-CBC (BitLocker variant). But none of these others are really useful, and they'd need to be individually tested to be sure they worked properly. This commit also changes the name of the loadable module from "ufs-qcom" to "ufs_qcom", as this is necessary to compile it from multiple source files (unless we were to rename ufs-qcom.c). Signed-off-by: Eric Biggers <ebiggers@google.com> --- MAINTAINERS | 2 +- drivers/scsi/ufs/Kconfig | 1 + drivers/scsi/ufs/Makefile | 4 +- drivers/scsi/ufs/ufs-qcom-ice.c | 244 ++++++++++++++++++++++++++++++++ drivers/scsi/ufs/ufs-qcom.c | 12 +- drivers/scsi/ufs/ufs-qcom.h | 27 ++++ 6 files changed, 287 insertions(+), 3 deletions(-) create mode 100644 drivers/scsi/ufs/ufs-qcom-ice.c diff --git a/MAINTAINERS b/MAINTAINERS index a0d86490c2c62..d0df7738fcb88 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -2202,7 +2202,7 @@ F:drivers/pci/controller/dwc/pcie-qcom.c F:drivers/phy/qualcomm/ F:drivers/power/*/msm* F:drivers/reset/reset-qcom-* -F:drivers/scsi/ufs/ufs-qcom.* +F:drivers/scsi/ufs/ufs-qcom* F:drivers/spi/spi-qup.c F:drivers/spi/spi-geni-qcom.c F:drivers/spi/spi-qcom-qspi.c diff --git a/drivers/scsi/ufs/Kconfig b/drivers/scsi/ufs/Kconfig index c69f1b49167b0..7d1260988ab2b 100644 --- a/drivers/scsi/ufs/Kconfig +++ b/drivers/scsi/ufs/Kconfig @@ -99,6 +99,7 @@ config SCSI_UFS_DWC_TC_PLATFORM config SCSI_UFS_QCOM tristate "QCOM specific hooks to UFS controller platform driver" depends on SCSI_UFSHCD_PLATFORM && ARCH_QCOM +select QCOM_SCM select RESET_CONTROLLER help This selects the QCOM specific additions to UFSHCD platform driver. diff --git a/drivers/scsi/ufs/Makefile b/drivers/scsi/ufs/Makefile index 197e178f44bce..13fda1b697b2a 100644 --- a/drivers/scsi/ufs/Makefile +++ b/drivers/scsi/ufs/Makefile @@ -3,7 +3,9 @@ obj-$(CONFIG_SCSI_UFS_DWC_TC_PCI) += tc-dwc-g210-pci.o ufshcd-dwc.o tc-dwc-g210.o obj-$(CONFIG_SCSI_UFS_DWC_TC_PLATFORM) += tc-dwc-g210-pltfrm.o ufshcd-dwc.o tc-dwc-g210.o obj-$(CONFIG_SCSI_UFS_CDNS_PLATFORM) += cdns-pltfrm.o -obj-$(CONFIG_SCSI_UFS_QCOM) += ufs-qcom.o +obj-$(CONFIG_SCSI_UFS_QCOM) += ufs_qcom.o ufs_qcom-y += ufs-qcom.o +ufs_qcom-$(CONFIG_SCSI_UFS_CRYPTO) += ufs-qcom-ice.o obj-$(CONFIG_SCSI_UFSHCD) += ufshcd-core.o ufshcd-core-y+= ufshcd.o ufs-sysfs.o ufshcd-core-$(CONFIG_SCSI_UFS_BSG)+= ufs_bsg.o diff --git a/drivers/scsi/ufs/ufs-qcom-ice.c b/drivers/scsi/ufs/ufs-qcom-ice.c new file mode 100644 index 0000000000000..b2c592003d1a2 --- /dev/null +++ b/drivers/scsi/ufs/ufs-qcom-ice.c @@ -0,0 +1,244 @@ +// SPDX-License-Identifier: GPL-2.0-only +/* + * Qualcomm ICE (Inline Crypto Engine) support. + * + * Copyright (c) 2014-2019, The Linux Foundation. All rights reserved. + * Copyright (c) 2019 Google LLC + */ + +#include <linux/platform_device.h> +#include <linux/qcom_scm.h> + +#include "ufshcd-crypto.h" +#include "ufs-qcom.h" + +#define AES_256_XTS_KEY_SIZE64 + +/* QCOM ICE registers */ + +#define QCOM_ICE_REG_CONTROL0x0000 +#define QCOM_ICE_REG_RESET0x0004 +#define QCOM_ICE_REG_VERSION0x0008 +#define QCOM_ICE_REG_FUSE_SETTING0x0010 +#define QCOM_ICE_REG_PARAMETERS_10x0014 +#define QCOM_ICE_REG_PARAMETERS_20x0018 +#define QCOM_ICE_REG_PARAMETERS_30x001C +#define QCOM_ICE_REG_PARAMETERS_40x0020 +#define QCOM_ICE_REG_PARAMETERS_50x0024 + +/* QCOM ICE v3.X only */ +#define QCOM_ICE_GENERAL_ERR_STTS0x0040 +#define QCOM_ICE_INVALID_CCFG_ERR_STTS0x0030 +#define QCOM_ICE_GENERAL_ERR_MASK0x0044 + +/* QCOM ICE v2.X only */ +#define QCOM_ICE_REG_NON_SEC_IRQ_STTS0x0040 +#define QCOM_ICE_REG_NON_SEC_IRQ_MASK0x0044 + +#define QCOM_ICE_REG_NON_SEC_IRQ_CLR0x0048 +#define QCOM_ICE_REG_STREAM1_ERROR_SYNDROME10x0050 +#define QCOM_ICE_REG_STREAM1_ERROR_SYNDROME20x0054 +#define QCOM_ICE_REG_STREAM2_ERROR_SYNDROME10x0058 +#define QCOM_ICE_REG_STREAM2_ERROR_SYNDROME20x005C +#define QCOM_ICE_REG_STREAM1_BIST_ERROR_VEC0x0060 +#define QCOM_ICE_REG_STREAM2_BIST_ERROR_VEC0x0064 +#define QCOM_ICE_REG_STREAM1_BIST_FINISH_VEC0x0068 +#define QCOM_ICE_REG_STREAM2_BIST_FINISH_VEC0x006C +#define QCOM_ICE_REG_BIST_STATUS0x0070 +#define QCOM_ICE_REG_BYPASS_STATUS0x0074 +#define QCOM_ICE_REG_ADVANCED_CONTROL0x1000 +#define QCOM_ICE_REG_ENDIAN_SWAP0x1004 +#define QCOM_ICE_REG_TEST_BUS_CONTROL0x1010 +#define QCOM_ICE_REG_TEST_BUS_REG0x1014 + +/* BIST ("built-in self-test"?) status flags */ +#define QCOM_ICE_BIST_STATUS_MASK0xF0000000 + +#define QCOM_ICE_FUSE_SETTING_MASK0x1 +#define QCOM_ICE_FORCE_HW_KEY0_SETTING_MASK0x2 +#define QCOM_ICE_FORCE_HW_KEY1_SETTING_MASK0x4 + +#define qcom_ice_writel(host, val, reg)\ +writel((val), (host)->ice_mmio + (reg)) +#define qcom_ice_readl(host, reg)\ +readl((host)->ice_mmio + (reg)) + +static bool qcom_ice_supported(struct ufs_qcom_host *host) { +struct device *dev = host->hba->dev; +u32 regval = qcom_ice_readl(host, QCOM_ICE_REG_VERSION); +int major = regval >> 24; +int minor = (regval >> 16) & 0xFF; +int step = regval & 0xFFFF; + +/* For now this driver only supports ICE version 3. */ +if (major != 3) { +dev_warn(dev, "Unsupported ICE version: v%d.%d.%d\n", + major, minor, step); +return false; +} + +dev_info(dev, "Found QC Inline Crypto Engine (ICE) v%d.%d.%d\n", + major, minor, step); + +/* If fuses are blown, ICE might not work in the standard way. */ +regval = qcom_ice_readl(host, QCOM_ICE_REG_FUSE_SETTING); +if (regval & (QCOM_ICE_FUSE_SETTING_MASK | + QCOM_ICE_FORCE_HW_KEY0_SETTING_MASK | + QCOM_ICE_FORCE_HW_KEY1_SETTING_MASK)) { +dev_warn(dev, "Fuses are blown; ICE is unusable!\n"); +return false; +} +return true; +} + +int ufs_qcom_ice_init(struct ufs_qcom_host *host) { +struct ufs_hba *hba = host->hba; +struct device *dev = hba->dev; +struct platform_device *pdev = to_platform_device(dev); +struct resource *res; +int err; + +if (!(ufshcd_readl(hba, REG_CONTROLLER_CAPABILITIES) & + MASK_CRYPTO_SUPPORT)) +return 0; + +res = platform_get_resource(pdev, IORESOURCE_MEM, 2); +if (!res) { +dev_warn(dev, "ICE registers not found\n"); +goto disable; +} + +if (!qcom_scm_ice_available()) { +dev_warn(dev, "ICE SCM interface not found\n"); +goto disable; +} + +host->ice_mmio = devm_ioremap_resource(dev, res); +if (IS_ERR(host->ice_mmio)) { +dev_err(dev, "Failed to map ICE registers; err=%d\n", err); +return err; +} + +if (!qcom_ice_supported(host)) +goto disable; + +return 0; + +disable: +dev_warn(dev, "Disabling inline encryption support\n"); +hba->caps &= ~UFSHCD_CAP_CRYPTO; +return 0; +} + +static void qcom_ice_low_power_mode_enable(struct ufs_qcom_host *host) +{ +u32 regval; + +regval = qcom_ice_readl(host, QCOM_ICE_REG_ADVANCED_CONTROL); +/* + * Enable low power mode sequence + * [0]-0, [1]-0, [2]-0, [3]-E, [4]-0, [5]-0, [6]-0, [7]-0 + */ +regval |= 0x7000; +qcom_ice_writel(host, regval, QCOM_ICE_REG_ADVANCED_CONTROL); } + +static void qcom_ice_optimization_enable(struct ufs_qcom_host *host) { +u32 regval; + +/* ICE Optimizations Enable Sequence */ +regval = qcom_ice_readl(host, QCOM_ICE_REG_ADVANCED_CONTROL); +regval |= 0xD807100; +/* ICE HPG requires delay before writing */ +udelay(5); +qcom_ice_writel(host, regval, QCOM_ICE_REG_ADVANCED_CONTROL); +udelay(5); +} + +int ufs_qcom_ice_enable(struct ufs_qcom_host *host) { +if (!(host->hba->caps & UFSHCD_CAP_CRYPTO)) +return 0; +qcom_ice_low_power_mode_enable(host); +qcom_ice_optimization_enable(host); +return ufs_qcom_ice_resume(host); +} + +/* Poll until all BIST bits are reset */ static int +qcom_ice_wait_bist_status(struct ufs_qcom_host *host) { +int count; +u32 reg; + +for (count = 0; count < 100; count++) { +reg = qcom_ice_readl(host, QCOM_ICE_REG_BIST_STATUS); +if (!(reg & QCOM_ICE_BIST_STATUS_MASK)) +break; +udelay(50); +} +if (reg) +return -ETIMEDOUT; +return 0; +} + +int ufs_qcom_ice_resume(struct ufs_qcom_host *host) { +int err; + +if (!(host->hba->caps & UFSHCD_CAP_CRYPTO)) +return 0; + +err = qcom_ice_wait_bist_status(host); +if (err) { +dev_err(host->hba->dev, "BIST status error (%d)\n", err); +return err; +} +return 0; +} + +/* + * Program a key into a QC ICE keyslot, or evict a keyslot. QC ICE +requires + * vendor-specific SCM calls for this; it doesn't support the standard way. + */ +int ufs_qcom_ice_program_key(struct ufs_hba *hba, + const union ufs_crypto_cfg_entry *cfg, int slot) { +union ufs_crypto_cap_entry cap; +union { +u8 bytes[AES_256_XTS_KEY_SIZE]; +u32 words[AES_256_XTS_KEY_SIZE / sizeof(u32)]; +} key; +int i; +int err; + +if (!(cfg->config_enable & UFS_CRYPTO_CONFIGURATION_ENABLE)) +return qcom_scm_ice_invalidate_key(slot); + +/* Only AES-256-XTS has been tested so far. */ +cap = hba->crypto_cap_array[cfg->crypto_cap_idx]; +if (cap.algorithm_id != UFS_CRYPTO_ALG_AES_XTS || + cap.key_size != UFS_CRYPTO_KEY_SIZE_256) { +dev_err_ratelimited(hba->dev, + "Unhandled crypto capability; algorithm_id=%d, key_size=%d\n", + cap.algorithm_id, cap.key_size); +return -EINVAL; +} + +memcpy(key.bytes, cfg->crypto_key, AES_256_XTS_KEY_SIZE); + +/* + * ICE (or maybe the SCM call?) byte-swaps the 32-bit words of the key. + * So we have to do the same, in order for the final key be correct. + */ +for (i = 0; i < ARRAY_SIZE(key.words); i++) +__cpu_to_be32s(&key.words[i]); + +err = qcom_scm_ice_set_key(slot, key.bytes, AES_256_XTS_KEY_SIZE, + QCOM_SCM_ICE_CIPHER_AES_256_XTS, + cfg->data_unit_size); +memzero_explicit(&key, sizeof(key)); +return err; +} diff --git a/drivers/scsi/ufs/ufs-qcom.c b/drivers/scsi/ufs/ufs-qcom.c index c69c29a1ceb90..5b3fbbbb7c0af 100644 --- a/drivers/scsi/ufs/ufs-qcom.c +++ b/drivers/scsi/ufs/ufs-qcom.c @@ -365,7 +365,7 @@ static int ufs_qcom_hce_enable_notify(struct ufs_hba *hba, /* check if UFS PHY moved from DISABLED to HIBERN8 */ err = ufs_qcom_check_hibern8(hba); ufs_qcom_enable_hw_clk_gating(hba); - +ufs_qcom_ice_enable(host); break; default: dev_err(hba->dev, "%s: invalid status %d\n", __func__, status); @@ -616,6 +616,10 @@ static int ufs_qcom_resume(struct ufs_hba *hba, enum ufs_pm_op pm_op) return err; } +err = ufs_qcom_ice_resume(host); +if (err) +return err; + hba->is_sys_suspended = false; return 0; } @@ -1011,6 +1015,7 @@ static void ufs_qcom_set_caps(struct ufs_hba *hba) hba->caps |= UFSHCD_CAP_CLK_GATING | UFSHCD_CAP_HIBERN8_WITH_CLK_GATING; hba->caps |= UFSHCD_CAP_CLK_SCALING; hba->caps |= UFSHCD_CAP_AUTO_BKOPS_SUSPEND; +hba->caps |= UFSHCD_CAP_CRYPTO; if (host->hw_ver.major >= 0x2) { host->caps = UFS_QCOM_CAP_QUNIPRO | @@ -1238,6 +1243,10 @@ static int ufs_qcom_init(struct ufs_hba *hba) ufs_qcom_set_caps(hba); ufs_qcom_advertise_quirks(hba); +err = ufs_qcom_ice_init(host); +if (err) +goto out_variant_clear; + ufs_qcom_setup_clocks(hba, true, POST_CHANGE); if (hba->dev->id < MAX_UFS_QCOM_HOSTS) @@ -1651,6 +1660,7 @@ static const struct ufs_hba_variant_ops ufs_hba_qcom_vops = { .resume= ufs_qcom_resume, .dbg_register_dump= ufs_qcom_dump_dbg_regs, .device_reset= ufs_qcom_device_reset, +.program_key= ufs_qcom_ice_program_key, }; /** diff --git a/drivers/scsi/ufs/ufs-qcom.h b/drivers/scsi/ufs/ufs-qcom.h index 2d95e7cc71874..97247d17e258a 100644 --- a/drivers/scsi/ufs/ufs-qcom.h +++ b/drivers/scsi/ufs/ufs-qcom.h @@ -227,6 +227,9 @@ struct ufs_qcom_host { void __iomem *dev_ref_clk_ctrl_mmio; bool is_dev_ref_clk_enabled; struct ufs_hw_version hw_ver; +#ifdef CONFIG_SCSI_UFS_CRYPTO +void __iomem *ice_mmio; +#endif u32 dev_ref_clk_en_mask; @@ -264,4 +267,28 @@ static inline bool ufs_qcom_cap_qunipro(struct ufs_qcom_host *host) return false; } +/* ufs-qcom-ice.c */ + +#ifdef CONFIG_SCSI_UFS_CRYPTO +int ufs_qcom_ice_init(struct ufs_qcom_host *host); int +ufs_qcom_ice_enable(struct ufs_qcom_host *host); int +ufs_qcom_ice_resume(struct ufs_qcom_host *host); int +ufs_qcom_ice_program_key(struct ufs_hba *hba, + const union ufs_crypto_cfg_entry *cfg, int slot); #else static +inline int ufs_qcom_ice_init(struct ufs_qcom_host *host) { +return 0; +} +static inline int ufs_qcom_ice_enable(struct ufs_qcom_host *host) { +return 0; +} +static inline int ufs_qcom_ice_resume(struct ufs_qcom_host *host) { +return 0; +} +#define ufs_qcom_ice_program_key NULL +#endif /* !CONFIG_SCSI_UFS_CRYPTO */ + #endif /* UFS_QCOM_H_ */ -- 2.25.1
Hi Barani, On Thu, Mar 12, 2020 at 06:21:02PM +0000, Barani Muthukumaran wrote: > Hi Eric, > > I am confused on why you are trying to re-implement functions already present > within the crypto_vops. Is there a reason why the ICE driver cannot register > for KSM with its own function for keyslot_program and keyslot_evict and > register for crypto_vops with its own functions for > 'init/enable/disable/suspend/resume/debug'. Given that the ufs-crypto has the > interface to do this why do we have to re-implement the same functionality > with another set of functions. In addition in the future if for performance > reasons (with per-file keys) we have to use passthrough KSM and use > prepare/complete_lrbp_crypto that can easily be added as well. > > IMO the crypto_vops is a clean way for vendors to override the default > functionality rather than using direct function calls from within the UFS > driver and this can easily be extended for eMMC. ufshcd_hba_crypto_variant_ops doesn't exist in the patchset for upstream. We had to add ufshcd_hba_crypto_variant_ops out-of-tree to the Android common kernels to unblock vendors implementing their drivers this year, because we didn't know exactly what functionality they'd need. So we just had to guess and add ~10 different operations just in case people needed them. (Note that some or all of these may go away next year, once we see what was actually used.) That's not acceptable for upstream. For upstream we can only add variant operations that are actually used by in-tree drivers. So far the only hardware support actually proposed upstream are my patch for ufs-qcom, and Stanley's patch for ufs-mediatek. ufs-qcom only needs ->program_key(), and ufs-mediatek doesn't need any new variant op. So, that's why only ->program_key() has been proposed upstream thus far: it's the minimal functionality that's been demonstrated to be needed. Of course, if someone actually posts patches to support hardware that diverges from the UFS standard in new and "exciting" ways (whether it's another vendor's hardware or future Qualcomm hardware) then they'll need to post any variant operation(s) they need. They need to be targetted to only the specific quirk(s) needed, so that drivers don't have to unnecessarily re-implement stuff. - Eric
Hi Eric, The crypto_variant_ops exposed were not a guess, we had worked with Satya to add the functionality that is required. Can we define the below crypto_variant_ops that exposes the same functionality you have added, this allows us to extend this in the future in a seamless manner. As an example QC implementation uses 'debug', 'suspend' and we can add that when we upstream the implementation in the next few weeks once our validation is complete. Thanks. struct ufs_hba_crypto_variant_ops { int (*hba_init_crypto)(struct ufs_hba *hba, const struct keyslot_mgmt_ll_ops *ksm_ops); void (*enable)(struct ufs_hba *hba); int (*resume)(struct ufs_hba *hba); int (*program_key(struct ufs_hba *hba, const union ufs_crypto_cfg_entry *cfg, int slot); }; -----Original Message----- From: Eric Biggers <ebiggers@kernel.org> Sent: Thursday, March 12, 2020 12:06 PM To: Barani Muthukumaran <bmuthuku@qti.qualcomm.com> Cc: linux-scsi@vger.kernel.org; linux-arm-msm@vger.kernel.org; linux-block@vger.kernel.org; linux-fscrypt@vger.kernel.org; Alim Akhtar <alim.akhtar@samsung.com>; Andy Gross <agross@kernel.org>; Avri Altman <avri.altman@wdc.com>; bjorn.andersson@linaro.org; Can Guo <cang@codeaurora.org>; Elliot Berman <eberman@codeaurora.org>; Jaegeuk Kim <jaegeuk@kernel.org>; John Stultz <john.stultz@linaro.org>; Satya Tangirala <satyat@google.com> Subject: [EXT] Re: [RFC PATCH v3 4/4] scsi: ufs-qcom: add Inline Crypto Engine support Hi Barani, On Thu, Mar 12, 2020 at 06:21:02PM +0000, Barani Muthukumaran wrote: > Hi Eric, > > I am confused on why you are trying to re-implement functions already > present within the crypto_vops. Is there a reason why the ICE driver > cannot register for KSM with its own function for keyslot_program and > keyslot_evict and register for crypto_vops with its own functions for > 'init/enable/disable/suspend/resume/debug'. Given that the ufs-crypto > has the interface to do this why do we have to re-implement the same > functionality with another set of functions. In addition in the future > if for performance reasons (with per-file keys) we have to use > passthrough KSM and use prepare/complete_lrbp_crypto that can easily be added as well. > > IMO the crypto_vops is a clean way for vendors to override the default > functionality rather than using direct function calls from within the > UFS driver and this can easily be extended for eMMC. ufshcd_hba_crypto_variant_ops doesn't exist in the patchset for upstream. We had to add ufshcd_hba_crypto_variant_ops out-of-tree to the Android common kernels to unblock vendors implementing their drivers this year, because we didn't know exactly what functionality they'd need. So we just had to guess and add ~10 different operations just in case people needed them. (Note that some or all of these may go away next year, once we see what was actually used.) That's not acceptable for upstream. For upstream we can only add variant operations that are actually used by in-tree drivers. So far the only hardware support actually proposed upstream are my patch for ufs-qcom, and Stanley's patch for ufs-mediatek. ufs-qcom only needs ->program_key(), and ufs-mediatek doesn't need any new variant op. So, that's why only ->program_key() has been proposed upstream thus far: it's the minimal functionality that's been demonstrated to be needed. Of course, if someone actually posts patches to support hardware that diverges from the UFS standard in new and "exciting" ways (whether it's another vendor's hardware or future Qualcomm hardware) then they'll need to post any variant operation(s) they need. They need to be targetted to only the specific quirk(s) needed, so that drivers don't have to unnecessarily re-implement stuff. - Eric
On Fri, Mar 13, 2020 at 05:05:35PM +0000, Barani Muthukumaran wrote: > Hi Eric, > > The crypto_variant_ops exposed were not a guess, we had worked with Satya to > add the functionality that is required. As far as I can tell, my patch works fine with just the new ->program_key() variant op. Note that I'm also taking advantage of some of the existing, non-crypto-specific variant ops. For example, I didn't need to add a ->crypto_resume() operation because there's already ufs_hba_variant_ops::resume(). I understand that the old downstream ICE code defined and used a lot of crypto variant ops, which did give the impression that a lot more would be needed. But ultimately I found that most of them were unnecessary or could be replaced with the existing non-crypto-specific variant ops. > Can we define the below crypto_variant_ops that exposes the same functionality > you have added, this allows us to extend this in the future in a seamless > manner. As an example QC implementation uses 'debug', 'suspend' and we can add > that when we upstream the implementation in the next few weeks once our > validation is complete. Thanks. > > struct ufs_hba_crypto_variant_ops { > int (*hba_init_crypto)(struct ufs_hba *hba, > const struct keyslot_mgmt_ll_ops *ksm_ops); > void (*enable)(struct ufs_hba *hba); > int (*resume)(struct ufs_hba *hba); > int (*program_key(struct ufs_hba *hba, > const union ufs_crypto_cfg_entry *cfg, int slot); > }; To re-iterate, upstream doesn't add hooks with no in-tree users. It's great to hear that you'll be sending out a patchset soon. Just send out the hooks you need along with them, so that they can all be properly reviewed. - Eric
On Thu, Mar 12, 2020 at 12:05:41PM -0700, Eric Biggers wrote: > Of course, if someone actually posts patches to support hardware that diverges > from the UFS standard in new and "exciting" ways (whether it's another vendor's > hardware or future Qualcomm hardware) then they'll need to post any variant > operation(s) they need. They need to be targetted to only the specific quirk(s) > needed, so that drivers don't have to unnecessarily re-implement stuff. I think the only sane answer is that we only support hardware upstream that conforms to the standard and we skip all that bullshit. The whole point of the standard is that things just work, and we should not give vendors a wild card to come up with bullshit like the interfaces handled in this patchset.
diff --git a/MAINTAINERS b/MAINTAINERS index a0d86490c2c62..d0df7738fcb88 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -2202,7 +2202,7 @@ F: drivers/pci/controller/dwc/pcie-qcom.c F: drivers/phy/qualcomm/ F: drivers/power/*/msm* F: drivers/reset/reset-qcom-* -F: drivers/scsi/ufs/ufs-qcom.* +F: drivers/scsi/ufs/ufs-qcom* F: drivers/spi/spi-qup.c F: drivers/spi/spi-geni-qcom.c F: drivers/spi/spi-qcom-qspi.c diff --git a/drivers/scsi/ufs/Kconfig b/drivers/scsi/ufs/Kconfig index c69f1b49167b0..7d1260988ab2b 100644 --- a/drivers/scsi/ufs/Kconfig +++ b/drivers/scsi/ufs/Kconfig @@ -99,6 +99,7 @@ config SCSI_UFS_DWC_TC_PLATFORM config SCSI_UFS_QCOM tristate "QCOM specific hooks to UFS controller platform driver" depends on SCSI_UFSHCD_PLATFORM && ARCH_QCOM + select QCOM_SCM select RESET_CONTROLLER help This selects the QCOM specific additions to UFSHCD platform driver. diff --git a/drivers/scsi/ufs/Makefile b/drivers/scsi/ufs/Makefile index 197e178f44bce..13fda1b697b2a 100644 --- a/drivers/scsi/ufs/Makefile +++ b/drivers/scsi/ufs/Makefile @@ -3,7 +3,9 @@ obj-$(CONFIG_SCSI_UFS_DWC_TC_PCI) += tc-dwc-g210-pci.o ufshcd-dwc.o tc-dwc-g210.o obj-$(CONFIG_SCSI_UFS_DWC_TC_PLATFORM) += tc-dwc-g210-pltfrm.o ufshcd-dwc.o tc-dwc-g210.o obj-$(CONFIG_SCSI_UFS_CDNS_PLATFORM) += cdns-pltfrm.o -obj-$(CONFIG_SCSI_UFS_QCOM) += ufs-qcom.o +obj-$(CONFIG_SCSI_UFS_QCOM) += ufs_qcom.o +ufs_qcom-y += ufs-qcom.o +ufs_qcom-$(CONFIG_SCSI_UFS_CRYPTO) += ufs-qcom-ice.o obj-$(CONFIG_SCSI_UFSHCD) += ufshcd-core.o ufshcd-core-y += ufshcd.o ufs-sysfs.o ufshcd-core-$(CONFIG_SCSI_UFS_BSG) += ufs_bsg.o diff --git a/drivers/scsi/ufs/ufs-qcom-ice.c b/drivers/scsi/ufs/ufs-qcom-ice.c new file mode 100644 index 0000000000000..b2c592003d1a2 --- /dev/null +++ b/drivers/scsi/ufs/ufs-qcom-ice.c @@ -0,0 +1,244 @@ +// SPDX-License-Identifier: GPL-2.0-only +/* + * Qualcomm ICE (Inline Crypto Engine) support. + * + * Copyright (c) 2014-2019, The Linux Foundation. All rights reserved. + * Copyright (c) 2019 Google LLC + */ + +#include <linux/platform_device.h> +#include <linux/qcom_scm.h> + +#include "ufshcd-crypto.h" +#include "ufs-qcom.h" + +#define AES_256_XTS_KEY_SIZE 64 + +/* QCOM ICE registers */ + +#define QCOM_ICE_REG_CONTROL 0x0000 +#define QCOM_ICE_REG_RESET 0x0004 +#define QCOM_ICE_REG_VERSION 0x0008 +#define QCOM_ICE_REG_FUSE_SETTING 0x0010 +#define QCOM_ICE_REG_PARAMETERS_1 0x0014 +#define QCOM_ICE_REG_PARAMETERS_2 0x0018 +#define QCOM_ICE_REG_PARAMETERS_3 0x001C +#define QCOM_ICE_REG_PARAMETERS_4 0x0020 +#define QCOM_ICE_REG_PARAMETERS_5 0x0024 + +/* QCOM ICE v3.X only */ +#define QCOM_ICE_GENERAL_ERR_STTS 0x0040 +#define QCOM_ICE_INVALID_CCFG_ERR_STTS 0x0030 +#define QCOM_ICE_GENERAL_ERR_MASK 0x0044 + +/* QCOM ICE v2.X only */ +#define QCOM_ICE_REG_NON_SEC_IRQ_STTS 0x0040 +#define QCOM_ICE_REG_NON_SEC_IRQ_MASK 0x0044 + +#define QCOM_ICE_REG_NON_SEC_IRQ_CLR 0x0048 +#define QCOM_ICE_REG_STREAM1_ERROR_SYNDROME1 0x0050 +#define QCOM_ICE_REG_STREAM1_ERROR_SYNDROME2 0x0054 +#define QCOM_ICE_REG_STREAM2_ERROR_SYNDROME1 0x0058 +#define QCOM_ICE_REG_STREAM2_ERROR_SYNDROME2 0x005C +#define QCOM_ICE_REG_STREAM1_BIST_ERROR_VEC 0x0060 +#define QCOM_ICE_REG_STREAM2_BIST_ERROR_VEC 0x0064 +#define QCOM_ICE_REG_STREAM1_BIST_FINISH_VEC 0x0068 +#define QCOM_ICE_REG_STREAM2_BIST_FINISH_VEC 0x006C +#define QCOM_ICE_REG_BIST_STATUS 0x0070 +#define QCOM_ICE_REG_BYPASS_STATUS 0x0074 +#define QCOM_ICE_REG_ADVANCED_CONTROL 0x1000 +#define QCOM_ICE_REG_ENDIAN_SWAP 0x1004 +#define QCOM_ICE_REG_TEST_BUS_CONTROL 0x1010 +#define QCOM_ICE_REG_TEST_BUS_REG 0x1014 + +/* BIST ("built-in self-test"?) status flags */ +#define QCOM_ICE_BIST_STATUS_MASK 0xF0000000 + +#define QCOM_ICE_FUSE_SETTING_MASK 0x1 +#define QCOM_ICE_FORCE_HW_KEY0_SETTING_MASK 0x2 +#define QCOM_ICE_FORCE_HW_KEY1_SETTING_MASK 0x4 + +#define qcom_ice_writel(host, val, reg) \ + writel((val), (host)->ice_mmio + (reg)) +#define qcom_ice_readl(host, reg) \ + readl((host)->ice_mmio + (reg)) + +static bool qcom_ice_supported(struct ufs_qcom_host *host) +{ + struct device *dev = host->hba->dev; + u32 regval = qcom_ice_readl(host, QCOM_ICE_REG_VERSION); + int major = regval >> 24; + int minor = (regval >> 16) & 0xFF; + int step = regval & 0xFFFF; + + /* For now this driver only supports ICE version 3. */ + if (major != 3) { + dev_warn(dev, "Unsupported ICE version: v%d.%d.%d\n", + major, minor, step); + return false; + } + + dev_info(dev, "Found QC Inline Crypto Engine (ICE) v%d.%d.%d\n", + major, minor, step); + + /* If fuses are blown, ICE might not work in the standard way. */ + regval = qcom_ice_readl(host, QCOM_ICE_REG_FUSE_SETTING); + if (regval & (QCOM_ICE_FUSE_SETTING_MASK | + QCOM_ICE_FORCE_HW_KEY0_SETTING_MASK | + QCOM_ICE_FORCE_HW_KEY1_SETTING_MASK)) { + dev_warn(dev, "Fuses are blown; ICE is unusable!\n"); + return false; + } + return true; +} + +int ufs_qcom_ice_init(struct ufs_qcom_host *host) +{ + struct ufs_hba *hba = host->hba; + struct device *dev = hba->dev; + struct platform_device *pdev = to_platform_device(dev); + struct resource *res; + int err; + + if (!(ufshcd_readl(hba, REG_CONTROLLER_CAPABILITIES) & + MASK_CRYPTO_SUPPORT)) + return 0; + + res = platform_get_resource(pdev, IORESOURCE_MEM, 2); + if (!res) { + dev_warn(dev, "ICE registers not found\n"); + goto disable; + } + + if (!qcom_scm_ice_available()) { + dev_warn(dev, "ICE SCM interface not found\n"); + goto disable; + } + + host->ice_mmio = devm_ioremap_resource(dev, res); + if (IS_ERR(host->ice_mmio)) { + dev_err(dev, "Failed to map ICE registers; err=%d\n", err); + return err; + } + + if (!qcom_ice_supported(host)) + goto disable; + + return 0; + +disable: + dev_warn(dev, "Disabling inline encryption support\n"); + hba->caps &= ~UFSHCD_CAP_CRYPTO; + return 0; +} + +static void qcom_ice_low_power_mode_enable(struct ufs_qcom_host *host) +{ + u32 regval; + + regval = qcom_ice_readl(host, QCOM_ICE_REG_ADVANCED_CONTROL); + /* + * Enable low power mode sequence + * [0]-0, [1]-0, [2]-0, [3]-E, [4]-0, [5]-0, [6]-0, [7]-0 + */ + regval |= 0x7000; + qcom_ice_writel(host, regval, QCOM_ICE_REG_ADVANCED_CONTROL); +} + +static void qcom_ice_optimization_enable(struct ufs_qcom_host *host) +{ + u32 regval; + + /* ICE Optimizations Enable Sequence */ + regval = qcom_ice_readl(host, QCOM_ICE_REG_ADVANCED_CONTROL); + regval |= 0xD807100; + /* ICE HPG requires delay before writing */ + udelay(5); + qcom_ice_writel(host, regval, QCOM_ICE_REG_ADVANCED_CONTROL); + udelay(5); +} + +int ufs_qcom_ice_enable(struct ufs_qcom_host *host) +{ + if (!(host->hba->caps & UFSHCD_CAP_CRYPTO)) + return 0; + qcom_ice_low_power_mode_enable(host); + qcom_ice_optimization_enable(host); + return ufs_qcom_ice_resume(host); +} + +/* Poll until all BIST bits are reset */ +static int qcom_ice_wait_bist_status(struct ufs_qcom_host *host) +{ + int count; + u32 reg; + + for (count = 0; count < 100; count++) { + reg = qcom_ice_readl(host, QCOM_ICE_REG_BIST_STATUS); + if (!(reg & QCOM_ICE_BIST_STATUS_MASK)) + break; + udelay(50); + } + if (reg) + return -ETIMEDOUT; + return 0; +} + +int ufs_qcom_ice_resume(struct ufs_qcom_host *host) +{ + int err; + + if (!(host->hba->caps & UFSHCD_CAP_CRYPTO)) + return 0; + + err = qcom_ice_wait_bist_status(host); + if (err) { + dev_err(host->hba->dev, "BIST status error (%d)\n", err); + return err; + } + return 0; +} + +/* + * Program a key into a QC ICE keyslot, or evict a keyslot. QC ICE requires + * vendor-specific SCM calls for this; it doesn't support the standard way. + */ +int ufs_qcom_ice_program_key(struct ufs_hba *hba, + const union ufs_crypto_cfg_entry *cfg, int slot) +{ + union ufs_crypto_cap_entry cap; + union { + u8 bytes[AES_256_XTS_KEY_SIZE]; + u32 words[AES_256_XTS_KEY_SIZE / sizeof(u32)]; + } key; + int i; + int err; + + if (!(cfg->config_enable & UFS_CRYPTO_CONFIGURATION_ENABLE)) + return qcom_scm_ice_invalidate_key(slot); + + /* Only AES-256-XTS has been tested so far. */ + cap = hba->crypto_cap_array[cfg->crypto_cap_idx]; + if (cap.algorithm_id != UFS_CRYPTO_ALG_AES_XTS || + cap.key_size != UFS_CRYPTO_KEY_SIZE_256) { + dev_err_ratelimited(hba->dev, + "Unhandled crypto capability; algorithm_id=%d, key_size=%d\n", + cap.algorithm_id, cap.key_size); + return -EINVAL; + } + + memcpy(key.bytes, cfg->crypto_key, AES_256_XTS_KEY_SIZE); + + /* + * ICE (or maybe the SCM call?) byte-swaps the 32-bit words of the key. + * So we have to do the same, in order for the final key be correct. + */ + for (i = 0; i < ARRAY_SIZE(key.words); i++) + __cpu_to_be32s(&key.words[i]); + + err = qcom_scm_ice_set_key(slot, key.bytes, AES_256_XTS_KEY_SIZE, + QCOM_SCM_ICE_CIPHER_AES_256_XTS, + cfg->data_unit_size); + memzero_explicit(&key, sizeof(key)); + return err; +} diff --git a/drivers/scsi/ufs/ufs-qcom.c b/drivers/scsi/ufs/ufs-qcom.c index c69c29a1ceb90..5b3fbbbb7c0af 100644 --- a/drivers/scsi/ufs/ufs-qcom.c +++ b/drivers/scsi/ufs/ufs-qcom.c @@ -365,7 +365,7 @@ static int ufs_qcom_hce_enable_notify(struct ufs_hba *hba, /* check if UFS PHY moved from DISABLED to HIBERN8 */ err = ufs_qcom_check_hibern8(hba); ufs_qcom_enable_hw_clk_gating(hba); - + ufs_qcom_ice_enable(host); break; default: dev_err(hba->dev, "%s: invalid status %d\n", __func__, status); @@ -616,6 +616,10 @@ static int ufs_qcom_resume(struct ufs_hba *hba, enum ufs_pm_op pm_op) return err; } + err = ufs_qcom_ice_resume(host); + if (err) + return err; + hba->is_sys_suspended = false; return 0; } @@ -1011,6 +1015,7 @@ static void ufs_qcom_set_caps(struct ufs_hba *hba) hba->caps |= UFSHCD_CAP_CLK_GATING | UFSHCD_CAP_HIBERN8_WITH_CLK_GATING; hba->caps |= UFSHCD_CAP_CLK_SCALING; hba->caps |= UFSHCD_CAP_AUTO_BKOPS_SUSPEND; + hba->caps |= UFSHCD_CAP_CRYPTO; if (host->hw_ver.major >= 0x2) { host->caps = UFS_QCOM_CAP_QUNIPRO | @@ -1238,6 +1243,10 @@ static int ufs_qcom_init(struct ufs_hba *hba) ufs_qcom_set_caps(hba); ufs_qcom_advertise_quirks(hba); + err = ufs_qcom_ice_init(host); + if (err) + goto out_variant_clear; + ufs_qcom_setup_clocks(hba, true, POST_CHANGE); if (hba->dev->id < MAX_UFS_QCOM_HOSTS) @@ -1651,6 +1660,7 @@ static const struct ufs_hba_variant_ops ufs_hba_qcom_vops = { .resume = ufs_qcom_resume, .dbg_register_dump = ufs_qcom_dump_dbg_regs, .device_reset = ufs_qcom_device_reset, + .program_key = ufs_qcom_ice_program_key, }; /** diff --git a/drivers/scsi/ufs/ufs-qcom.h b/drivers/scsi/ufs/ufs-qcom.h index 2d95e7cc71874..97247d17e258a 100644 --- a/drivers/scsi/ufs/ufs-qcom.h +++ b/drivers/scsi/ufs/ufs-qcom.h @@ -227,6 +227,9 @@ struct ufs_qcom_host { void __iomem *dev_ref_clk_ctrl_mmio; bool is_dev_ref_clk_enabled; struct ufs_hw_version hw_ver; +#ifdef CONFIG_SCSI_UFS_CRYPTO + void __iomem *ice_mmio; +#endif u32 dev_ref_clk_en_mask; @@ -264,4 +267,28 @@ static inline bool ufs_qcom_cap_qunipro(struct ufs_qcom_host *host) return false; } +/* ufs-qcom-ice.c */ + +#ifdef CONFIG_SCSI_UFS_CRYPTO +int ufs_qcom_ice_init(struct ufs_qcom_host *host); +int ufs_qcom_ice_enable(struct ufs_qcom_host *host); +int ufs_qcom_ice_resume(struct ufs_qcom_host *host); +int ufs_qcom_ice_program_key(struct ufs_hba *hba, + const union ufs_crypto_cfg_entry *cfg, int slot); +#else +static inline int ufs_qcom_ice_init(struct ufs_qcom_host *host) +{ + return 0; +} +static inline int ufs_qcom_ice_enable(struct ufs_qcom_host *host) +{ + return 0; +} +static inline int ufs_qcom_ice_resume(struct ufs_qcom_host *host) +{ + return 0; +} +#define ufs_qcom_ice_program_key NULL +#endif /* !CONFIG_SCSI_UFS_CRYPTO */ + #endif /* UFS_QCOM_H_ */