From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id A541CFCC9D4 for ; Tue, 10 Mar 2026 07:22:51 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 14F7710E662; Tue, 10 Mar 2026 07:22:51 +0000 (UTC) Authentication-Results: gabe.freedesktop.org; dkim=pass (2048-bit key; unprotected) header.d=qualcomm.com header.i=@qualcomm.com header.b="OSQUoMBa"; dkim=pass (2048-bit key; unprotected) header.d=oss.qualcomm.com header.i=@oss.qualcomm.com header.b="a3tFluY+"; dkim-atps=neutral Received: from mx0a-0031df01.pphosted.com (mx0a-0031df01.pphosted.com [205.220.168.131]) by gabe.freedesktop.org (Postfix) with ESMTPS id 2B08D10E662 for ; Tue, 10 Mar 2026 07:22:50 +0000 (UTC) Received: from pps.filterd (m0279866.ppops.net [127.0.0.1]) by mx0a-0031df01.pphosted.com (8.18.1.11/8.18.1.11) with ESMTP id 62A6VUmL2021657 for ; Tue, 10 Mar 2026 07:22:49 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= AhZtQR443/E19GewAj1186Zwj+uyAl6zxJPtQ9r8Toc=; b=OSQUoMBakbHD4hGg hdEEZESxYnrKgEiNiGZF9XYy6J7UY0NiX8arF6UUes3B04tI4z439vt9YTljux8Z uhRy3tfLRjLA0tZOLflDX0Rc20zO8/pYDIqD59X01yk/zY51ov6dATB6WQREYciM WsntOdOthV9ni3EuJyVt4J56Tkn7jUVCnjq32UDMeJXRkvgkopgC/tmJ9IWVG+Wf tJpi5uGyx4GjJgYSMVF8BACx48dl4pqe7ZtCtdcfZltevIiy23eXyS0pNknN7M/M hkxcAWT93Cdo9L7FBQjBZrZRRwnN4Lg4xeLfcK7GmWysLZy21XJo8Y4n+G/pBhM3 aa6Shw== Received: from mail-pl1-f198.google.com (mail-pl1-f198.google.com [209.85.214.198]) by mx0a-0031df01.pphosted.com (PPS) with ESMTPS id 4cte3w85fb-1 (version=TLSv1.3 cipher=TLS_AES_128_GCM_SHA256 bits=128 verify=NOT) for ; Tue, 10 Mar 2026 07:22:49 +0000 (GMT) Received: by mail-pl1-f198.google.com with SMTP id d9443c01a7336-2ae4cdfc468so88618245ad.2 for ; Tue, 10 Mar 2026 00:22:49 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oss.qualcomm.com; s=google; t=1773127369; x=1773732169; darn=lists.freedesktop.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:from:to:cc:subject:date:message-id :reply-to; bh=AhZtQR443/E19GewAj1186Zwj+uyAl6zxJPtQ9r8Toc=; b=a3tFluY+Qy577WN9fioy5ynzpSEqpucQuxMDfuOuMruQTRqErfS1DnjOavvrvtgxWK PqfaIE3Ss/3NP40b+Z24/s8LXsaJQRcrAn8udujQMqwS/v2oRH7zwD9ApetkLl15aTfj WxgAPWIotfmHgP8gOXtOoBl1mqG5DJhv8VftuGlViQYgjP+5Xy5gqalwsWswyshjGT0o YMuFrJ9EPUHAMC8H5KoVrm0xDVc+5gaKQmDgvDWPqK/wmJALunHq8ydLjUJfgSrIjL1g RJDQXe38Aq1+fOb0HmV9MCaE3Em6FqBTgpqnkvdgmLmneV3ugl4XLBSS0pNHSP3Wpj4g Jamw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1773127369; x=1773732169; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:x-gm-gg:x-gm-message-state:from:to :cc:subject:date:message-id:reply-to; bh=AhZtQR443/E19GewAj1186Zwj+uyAl6zxJPtQ9r8Toc=; b=pS1n7cXqHanXfN7k+lfSjq2qo7VhvSVA6D+7rAydtVYnC9uycMvu9lGPuJj8WTXKLW +5es2TabyHniLT0l5da3uXHlM0qOfDHigm8I4gJqeMyZ+nn4ouMLABhdeYXkqkOqJkjZ T52LqPrQv537rp+PeU7e6quITBF2DdYnFpLAEj5efye9Iph96AxrBFJD3cNst0m+oknX H7QwbTz5dgAbPedCMMzdU83rq5+JjXR8UsQapsURoxkCpMXrCbVa0WgMvrKJEDoZHTrx /qgi6Vjv3bff8Khci/+zZdk0sBtX01GDsOOXSZhAS2pnFJB+Qh27skD4G2eR5C+11EuB kQfg== X-Forwarded-Encrypted: i=1; AJvYcCX9OqP7pzxQAAiYOp0usWhA+Fs5vYO/SK4l8E+AiOAobYXSDZno4SGHV9mr8sHDG4SOILxh7SEwCfk=@lists.freedesktop.org X-Gm-Message-State: AOJu0YymGFgazlA0J1f22+1JhyAWZK7X9j6YZOJoQwQj/2j87fZ4Yxg7 eBIT222V8FQlG4Fl0Jqv9xLlxdoq7nSUGdo94HwiFoFgxxcFfAyxEqiA/mMHjOOVSlZYBKHdVLF BixxMt2G9P7ZRtGHD0mJQ8KV6G4aTNSkY9dYUErb1R44zs6Ua2iCFNJTj/MHd1w5gwxjBOrg= X-Gm-Gg: ATEYQzy8rcK8Lk3u9i5HEbR5sVPiyYFp3F9JMgYXb3TcfwAYXcELd36gT5f67wjg4OC wNDDwn++gtMQbat0+HonSkdbevLq6jCzr2XA782NSu5ajXZh/VSo5Muc+dtzDReZgRriWT7uWus LdDv/rtFVU9JRFJDmjiLVmnkax7GGRBmfvD/JQtx9J9npc2vVJif3kWn8XCq3riGSwB4/fdpGk0 YHoy9ikJQ4N7mfSk+CP+F5FsrgxoQIfUYs0zS7gh9dkfV/9RCEwEKKc2TaxhsTrgjzFfKt+i6B6 7+ZUXMXEgJnh3fOMvR1ApEgVOu/Ywgk28+yfft6PP+a54KIfpyBo3RTa1HM45wo9SV2u9QB1MpI 9oz5oHDBRs5B4gVzSV7A4dtHPLOtjMFQ5GAA7pvOY0e0bUlfleqE= X-Received: by 2002:a17:902:cf05:b0:2ae:829d:3c33 with SMTP id d9443c01a7336-2ae829d3f2emr149862915ad.8.1773127369015; Tue, 10 Mar 2026 00:22:49 -0700 (PDT) X-Received: by 2002:a17:902:cf05:b0:2ae:829d:3c33 with SMTP id d9443c01a7336-2ae829d3f2emr149862565ad.8.1773127368570; Tue, 10 Mar 2026 00:22:48 -0700 (PDT) Received: from hu-batta-hyd.qualcomm.com ([202.46.23.25]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-2ae840b2e9dsm185200325ad.85.2026.03.10.00.22.45 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 10 Mar 2026 00:22:48 -0700 (PDT) From: Kishore Batta Date: Tue, 10 Mar 2026 12:52:06 +0530 Subject: [PATCH v3 9/9] Documentation: ABI: Add sysfs ABI documentation for DDR training data MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 7bit Message-Id: <20260310-sahara_protocol_new_v2-v3-9-994ea4b0d5ad@oss.qualcomm.com> References: <20260310-sahara_protocol_new_v2-v3-0-994ea4b0d5ad@oss.qualcomm.com> In-Reply-To: <20260310-sahara_protocol_new_v2-v3-0-994ea4b0d5ad@oss.qualcomm.com> To: Jonathan Corbet , Shuah Khan , Jeff Hugo , Carl Vanderlip , Oded Gabbay , Manivannan Sadhasivam Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-arm-msm@vger.kernel.org, dri-devel@lists.freedesktop.org, mhi@lists.linux.dev, Kishore Batta X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=ed25519-sha256; t=1773127328; l=1903; i=kishore.batta@oss.qualcomm.com; s=20260206; h=from:subject:message-id; bh=PYlMjATY4SM1+jaLjbUMOn336QEIJpGFcRpjUcyzz/4=; b=A2ngy+Vh6mGbywAacQ1WhpnAXl4OfWSksXvxmtXi88x0yTGDf+9jd2T6SE6lkrsx9nv4dwTSR O/grnwx19PsAypGENZxaAsrKGNdaoKkokxmqVFwm6mmcVFtenk5b9bW X-Developer-Key: i=kishore.batta@oss.qualcomm.com; a=ed25519; pk=vJo8RvTf+HZpRLK2oOIljmbn9l3zFkibCGh+blaqZCw= X-Proofpoint-Spam-Details-Enc: AW1haW4tMjYwMzEwMDA2MSBTYWx0ZWRfX5q1eynD7qJmZ n9p57XDcj97GDHOnz0BhpAL9tvJyCISVBPEVNUeTyY9QNU3N9cFHrbZtOv92wgJHfalPz20Fwha xIpPV7kHPxoqL7KPFMWCfTSsJ/RZO8dpeUZTq4TRV7jEgpemBVtPtDs8idp6guK6DdffnBqUQTW JaAGBhdSAX0HJfDZ74i874ef7GiUh9EMAbsnGorK1qMOPeT17dqCo8gIWJhxNIRN4+jaEOHnj1H uC5aZyEidkzlihy/+0WTxjErtqawGdrY4SqEUjngrci7SwgZ+E0P4yJlyvB5/1bbiipSFy5SwGj pzxObCDzfLNALkkclAM7pr2uwCLROL9e/RWzq3fu05dakgeJevXHSpWmCGmnPMU/mz9TXz2Co7Q Qs8KBCpShMKqivRGF3s27B8tCu0Jq3YWjpFLEmyZEfTkgD2TTtGx5eSSGeTcmm1GaIsIhIxcaTK sCoXxDInQGSYT5f7/gw== X-Authority-Analysis: v=2.4 cv=GtFPO01C c=1 sm=1 tr=0 ts=69afc6c9 cx=c_pps a=MTSHoo12Qbhz2p7MsH1ifg==:117 a=ZePRamnt/+rB5gQjfz0u9A==:17 a=IkcTkHD0fZMA:10 a=Yq5XynenixoA:10 a=s4-Qcg_JpJYA:10 a=VkNPw1HP01LnGYTKEx00:22 a=u7WPNUs3qKkmUXheDGA7:22 a=YMgV9FUhrdKAYTUUvYB2:22 a=EUspDBNiAAAA:8 a=dkV1H7vRkoxx0F9zaYgA:9 a=QEXdDO2ut3YA:10 a=GvdueXVYPmCkWapjIL-Q:22 X-Proofpoint-ORIG-GUID: YTAVAAklqBu7BBM0dmC8txMG3EmUTCus X-Proofpoint-GUID: YTAVAAklqBu7BBM0dmC8txMG3EmUTCus X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1143,Hydra:6.1.51,FMLib:17.12.100.49 definitions=2026-03-10_01,2026-03-09_02,2025-10-01_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 bulkscore=0 phishscore=0 malwarescore=0 clxscore=1015 lowpriorityscore=0 spamscore=0 suspectscore=0 priorityscore=1501 impostorscore=0 adultscore=0 classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0 reason=mlx scancount=1 engine=8.22.0-2602130000 definitions=main-2603100061 X-BeenThere: dri-devel@lists.freedesktop.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Direct Rendering Infrastructure - Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" Add ABI documentation for the DDR training data sysfs attribute exposed by the sahara MHI driver. The documented sysfs node provides read-only access to the DDR training data captured during sahara command mode and exposed via the MHI controller device. This allows userspace to read the training data and manage it as needed outside the kernel. Signed-off-by: Kishore Batta --- .../ABI/testing/sysfs-bus-mhi-ddr_training_data | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/Documentation/ABI/testing/sysfs-bus-mhi-ddr_training_data b/Documentation/ABI/testing/sysfs-bus-mhi-ddr_training_data new file mode 100644 index 0000000000000000000000000000000000000000..810b487b5a5fdba133d81255f9879844e3938a10 --- /dev/null +++ b/Documentation/ABI/testing/sysfs-bus-mhi-ddr_training_data @@ -0,0 +1,19 @@ +What: /sys/bus/mhi/devices//ddr_training_data + +Date: March 2026 + +Contact: Kishore Batta + +Description: Contains the DDR training data for the Qualcomm device + connected. MHI driver populates different controller + nodes for each device. The DDR training data is exposed + to userspace to read and save the training data file to + the filesystem. In the subsequent boot up of the device, + the training data is restored from host to device + optimizing the boot up time of the device. + +Usage: Example for reading DDR training data: + cat /sys/bus/mhi/devices/mhi0/ddr_training_data + +Permissions: The file permissions are set to 0444 allowing read + access. -- 2.34.1