From nobody Mon Feb 9 12:24:35 2026 Received: from mx0a-0031df01.pphosted.com (mx0a-0031df01.pphosted.com [205.220.168.131]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 8E34D2DF126 for ; Wed, 31 Dec 2025 04:56:27 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=205.220.168.131 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1767156989; cv=none; b=mrQ0MsSBxDFPZQyiZhUBZqV6rvHXs9D/sOAnwWqqEXeXrJNLuofeKqiaKyNjeOHnfvGJeiRiArKsjWI/72ejoTASdaHE4KwSgfsIzMv9jQYv8P/90Uz0XoofKgHmwckr0j/WXPKY4hiyfyd8ncrMkraUBTpHRfS/PVG82f6El2E= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1767156989; c=relaxed/simple; bh=RZhUJsCsLQ8did8MwMm1CGALj2u+dMNRhc+pjjIQnsE=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version:Content-Type; b=OXLHotutL1a4QOJplEfOcyPbHO3+4eTlb650VJrHxZi+EiIeS5TvjoGidI+bvPvkkV8fppqvJcSf9p97IsmlXpG0VlPG5ZnVkTfWHSt4VfYfxyBgFGD9VRaEd6oDjsihV6TGtqUQIAVT6O5TFqOZOOAO/JN5lQ5l2h2Eb1ieJ94= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=oss.qualcomm.com; spf=pass smtp.mailfrom=oss.qualcomm.com; dkim=pass (2048-bit key) header.d=qualcomm.com header.i=@qualcomm.com header.b=CheNtjhi; dkim=pass (2048-bit key) header.d=oss.qualcomm.com header.i=@oss.qualcomm.com header.b=WU+tFXvf; arc=none smtp.client-ip=205.220.168.131 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=oss.qualcomm.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=oss.qualcomm.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=qualcomm.com header.i=@qualcomm.com header.b="CheNtjhi"; dkim=pass (2048-bit key) header.d=oss.qualcomm.com header.i=@oss.qualcomm.com header.b="WU+tFXvf" Received: from pps.filterd (m0279862.ppops.net [127.0.0.1]) by mx0a-0031df01.pphosted.com (8.18.1.11/8.18.1.11) with ESMTP id 5BUEcOxU3539627 for ; Wed, 31 Dec 2025 04:56:27 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=qualcomm.com; h= cc:content-transfer-encoding:content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to; s=qcppdkim1; bh= 0DJ6ywmffk/NvVfS6DMQL/6EhTDM6B1Ko//XWCitums=; b=CheNtjhiz8hn4Ugo Qrv5Fo1H4M8RgRg/F1j+WozE9PPv4LGEXIbJC1Gn6Dkb3my9rbMrd1xhwfV1+dUd C3TStYk43N0dRPUfT3b8/Q8CnInTmBOFdD2bXvnI+Px5YNU5HBV7b4bIta25OItZ zBWTaIKGzprTVpmL20VqHDwEMj92M0OijeI4uhofNkBq4JZU0UNQmqhIKUrDNG/e r5TucjXq2Mr3ol+Z7hyh9L5bFp54wnsf81yEO4MrgqKPR9ZqhvCGGC7FyTmt8/xt LkFYUZta/cGtOqnn98RYRSreuwSVCC1bjlr1JXJS+H50qppv9YNSdwetspwX+BMW qFimgg== Received: from mail-pj1-f71.google.com (mail-pj1-f71.google.com [209.85.216.71]) by mx0a-0031df01.pphosted.com (PPS) with ESMTPS id 4bc88yjs05-1 (version=TLSv1.3 cipher=TLS_AES_128_GCM_SHA256 bits=128 verify=NOT) for ; Wed, 31 Dec 2025 04:56:26 +0000 (GMT) Received: by mail-pj1-f71.google.com with SMTP id 98e67ed59e1d1-34c66cb671fso14578631a91.3 for ; Tue, 30 Dec 2025 20:56:26 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oss.qualcomm.com; s=google; t=1767156986; x=1767761786; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=0DJ6ywmffk/NvVfS6DMQL/6EhTDM6B1Ko//XWCitums=; b=WU+tFXvf0mJnirdCR1i3W+s7aRCJLZGjCrBQCgV+08S5BAknS3UY4LGgniu9+dHkuk DRRQOdZtc/nWYiAtqS95kD20Vo+En4yzJXsM7AaH3YCoRYmsPLmBtHVQ5PhneCwzhPxr HXSN1bvv6jGAh9iVhk2jrobZbRbKT/wGsNTNMM9gdtMdxPuliCfiyrwAgKeAHPZclFCe nbYPwimrguUgIC1cBIGsr+E62qsGkGB8IHuarsDxMhAv8QBf1iQX33/8zOrApKAs4gX4 NeWfsFSFzdyjL3FOYe5bYZiTc1DlLPIAbel6/Dfyh4ajNrl9Vmu8gMpjqgMfG1Q+7epB co9w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1767156986; x=1767761786; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=0DJ6ywmffk/NvVfS6DMQL/6EhTDM6B1Ko//XWCitums=; b=IEf7nl4jt8OmZSH/J5ajoRe+c2xfUG6ZRSyHgI0gQibTiLrHfkCYxhtrM5w29c6i2N DJgA5+AB5xi14p627KZIarbscGqD666qda5zFU2t4yMuLYOQftZ3y1V2nZmVi5010SFe YeoDUxvLsmlV1ADRJNhKIcYfNg7A6x6gjgh+h1jAc4pO57QKGLKCPSYJYnFbPtukWn2o sEyajM19AiQE4OqWiEBb6Lr0Ji9g50k86wPKAg9uHVgQvjaPZyIEMU8uOdT3VqW+HfBB bVtb1tiMkHwCs8ydXgxfkfuvgMJ7dMDAfFuLik3AYqYxPqsAmhRB7lTTXRwZ9CwOZhTQ Judg== X-Forwarded-Encrypted: i=1; AJvYcCXhGIF2p7BYEQ17istVqgJd5PytyY+Hm9JcnvqNPGf6SMZDq564YLg2iVeByLxrFsSTvq5Emx/Ga946lAE=@vger.kernel.org X-Gm-Message-State: AOJu0Yw3P/+tOJGesc5wzpzIP+ZOfit4kFsjvlYvaaW553hv900mSIdf 25uqJv3Z1RQ+OlGrtnVsxSASCE8hlbjnsLEdtZBiR4LYDAxOYc+QYCeW46eeyMyeNDIYu96F38Z OnRMKHXjjBTWDHTCG3/zK6K4HbUjir4rGohDfPRz8qpLzwPKDja7mRVNTIz9bezmCIgU= X-Gm-Gg: AY/fxX6GRXoQ44GyIEhzMhfxJoiYvHRj+4kI5fFpGQPUuzD4iwg74GXnLjA4MPJ2Lr4 oza8pyuMoTWOXU1YmfTQn1WnvxrL6RBlA61b/uMiYaLtX4eZ+jQGp+6xZX/sxTaPHN7f2QZJUFW 43gmxTSMQVUB9bdK4OH6Ap2aq0Ukp72BZFoG2+9pt8WmnchemepUPgin0FEDl8iapkKugSla14P 66wbkPKVIOKDrbe4EhdchE1bMF4xeRXSb9VEHOn11TOEIG1HAnuAgRBNxErQn+pPRY6bJIzv7W0 qUtxjWvD6YpIUN1MQKLJYqADo/VfxCmY22t6HHgMiFjsVSdtWawabuIX+zkBfOe+P+JlM/zibCp Tz4xTO+2A01jJbL/CAZS5OoHKZVqmcsRKlMX2l8fV X-Received: by 2002:a17:90b:1d49:b0:340:c060:4d44 with SMTP id 98e67ed59e1d1-34e921353ffmr31607805a91.14.1767156986104; Tue, 30 Dec 2025 20:56:26 -0800 (PST) X-Google-Smtp-Source: AGHT+IFJesyqrxp1GrNh6zATDoRhTiZKRBfA4mQENsxcdqx6gV8UJULOCvVOHwhRLwzkEnp6dYxCsg== X-Received: by 2002:a17:90b:1d49:b0:340:c060:4d44 with SMTP id 98e67ed59e1d1-34e921353ffmr31607785a91.14.1767156985652; Tue, 30 Dec 2025 20:56:25 -0800 (PST) Received: from hu-rdwivedi-hyd.qualcomm.com ([202.46.22.19]) by smtp.gmail.com with ESMTPSA id 98e67ed59e1d1-34e70d4f7d3sm34547697a91.4.2025.12.30.20.56.21 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 30 Dec 2025 20:56:25 -0800 (PST) From: Ram Kumar Dwivedi To: mani@kernel.org, alim.akhtar@samsung.com, avri.altman@wdc.com, bvanassche@acm.org, robh@kernel.org, krzk+dt@kernel.org, conor+dt@kernel.org, James.Bottomley@HansenPartnership.com, martin.petersen@oracle.com, ram.dwivedi@oss.qualcomm.com, anjana.hari@oss.qualcomm.com Cc: linux-arm-msm@vger.kernel.org, linux-scsi@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH V3 2/4] dt-bindings: ufs: Document bindings for SA8255P UFS Host Controller Date: Wed, 31 Dec 2025 10:25:51 +0530 Message-Id: <20251231045553.622611-3-ram.dwivedi@oss.qualcomm.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20251231045553.622611-1-ram.dwivedi@oss.qualcomm.com> References: <20251231045553.622611-1-ram.dwivedi@oss.qualcomm.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-Authority-Analysis: v=2.4 cv=POcCOPqC c=1 sm=1 tr=0 ts=6954acfa cx=c_pps a=UNFcQwm+pnOIJct1K4W+Mw==:117 a=fChuTYTh2wq5r3m49p7fHw==:17 a=IkcTkHD0fZMA:10 a=wP3pNCr1ah4A:10 a=s4-Qcg_JpJYA:10 a=VkNPw1HP01LnGYTKEx00:22 a=gEfo2CItAAAA:8 a=EUspDBNiAAAA:8 a=VcM-S10TGioI4za7RKgA:9 a=3ZKOabzyN94A:10 a=QEXdDO2ut3YA:10 a=uKXjsCUrEbL0IQVhDsJ9:22 a=sptkURWiP4Gy88Gu7hUp:22 X-Proofpoint-ORIG-GUID: Nhc_4eMCcRuP04nAaMxJZ4VHdRP9WP7k X-Proofpoint-Spam-Details-Enc: AW1haW4tMjUxMjMxMDAzOSBTYWx0ZWRfX+LYvkjHBmhzz /rwq1w7cfHEu7MqLTZJAGeEfX7Fo18BYEFoGEZVkqHcEFlxjcmYZwVLOaISWWi+hS+lkqitn7kb O4fOqtNSQfNvlc2fYmGh25VVHXhbNDvQ+e9O3wZHOWkPwlyqzQeqtmW7SCnx0DbJquCTBdYtvcR gRXZKRAhutrWPxYPOp1hgh9ZoUUwIv+/9jq1IU4Tswp+/Eq2jHa7NBVhfQ96bmbzU7J0VY5zZCs L0PRdm6MeMWUtNOGu2pRKUIosoxdvbCoRkpY8hSOGOe4C13iNgQS3ddnB1+8JFD5P9sjBbDWZ7m +ajW0Ob2SjvgCl9Cy9iSuXZ4Xxxs5NHZZtIeUBUC7LTDhU2ZKZvTZx6ZK3odxqssLroPu69fxmc ApMa3H29td/gCGss7811y8EJnANA84gb+Oc4/8Mq11Qwq/en1BqAr/e3yZRNZJZf/CDZPlQvkPH E/hrbNmPZ3blpkvc4Mw== X-Proofpoint-GUID: Nhc_4eMCcRuP04nAaMxJZ4VHdRP9WP7k X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1121,Hydra:6.1.9,FMLib:17.12.100.49 definitions=2025-12-31_01,2025-12-31_01,2025-10-01_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 impostorscore=0 suspectscore=0 lowpriorityscore=0 malwarescore=0 adultscore=0 bulkscore=0 phishscore=0 clxscore=1015 priorityscore=1501 spamscore=0 classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0 reason=mlx scancount=1 engine=8.22.0-2512120000 definitions=main-2512310039 Document the device tree bindings for UFS host controller on Qualcomm SA8255P platform which integrates firmware-managed resources. The platform firmware implements the SCMI server and manages resources such as the PHY, clocks, regulators and resets via the SCMI power protocol. As a result, the OS-visible DT only describes the controller=E2=80=99s MMIO, interrupt, IOMMU and power-domain interfaces. The generic "qcom,ufshc" and "jedec,ufs-2.0" compatible strings are removed from the binding, since this firmware managed design won't be compatible with the drivers doing full resource management. Co-developed-by: Anjana Hari Signed-off-by: Anjana Hari Signed-off-by: Ram Kumar Dwivedi --- .../bindings/ufs/qcom,sa8255p-ufshc.yaml | 62 +++++++++++++++++++ 1 file changed, 62 insertions(+) create mode 100644 Documentation/devicetree/bindings/ufs/qcom,sa8255p-ufsh= c.yaml diff --git a/Documentation/devicetree/bindings/ufs/qcom,sa8255p-ufshc.yaml = b/Documentation/devicetree/bindings/ufs/qcom,sa8255p-ufshc.yaml new file mode 100644 index 000000000000..846a3552a9e4 --- /dev/null +++ b/Documentation/devicetree/bindings/ufs/qcom,sa8255p-ufshc.yaml @@ -0,0 +1,62 @@ +# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/ufs/qcom,sa8255p-ufshc.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Qualcomm SA8255P UFS Host Controller + +maintainers: + - Ram Kumar Dwivedi + - Anjana Hari + +properties: + compatible: + const: qcom,sa8255p-ufshc + + reg: + maxItems: 1 + + interrupts: + maxItems: 1 + + iommus: + maxItems: 1 + + dma-coherent: true + + power-domains: + maxItems: 1 + +required: + - compatible + - reg + - interrupts + - power-domains + - iommus + - dma-coherent + +allOf: + - $ref: ufs-common.yaml + +unevaluatedProperties: false + +examples: + - | + #include + + soc { + #address-cells =3D <1>; + #size-cells =3D <1>; + + ufshc@1d84000 { + compatible =3D "qcom,sa8255p-ufshc"; + reg =3D <0x01d84000 0x3000>; + interrupts =3D ; + lanes-per-direction =3D <2>; + + iommus =3D <&apps_smmu 0x100 0x0>; + power-domains =3D <&scmi3_pd 0>; + dma-coherent; + }; + }; --=20 2.34.1