From nobody Thu Apr 9 16:25:47 2026 Received: from mx0b-0031df01.pphosted.com (mx0b-0031df01.pphosted.com [205.220.180.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 8A93B358398 for ; Sat, 7 Mar 2026 11:42:38 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=205.220.180.131 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1772883760; cv=none; b=svGvi9UX0WY1xiosKP5eutbFAYgNJ2D9v5TQOa13ehdBvwvYrz/hdwMB4in7rMVF8DzD/gieHJmFzeVr+qBZ9G8GMRFQ+x+JigjfrT5Z3qHFfaNIsj3xlMTbM1tm3HpKv0AtsRmHvZ1tW2k1NvqtY7QMxVznWqXWmZ5Iz26XCCc= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1772883760; c=relaxed/simple; bh=PYlMjATY4SM1+jaLjbUMOn336QEIJpGFcRpjUcyzz/4=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=Iit8oEr2JFhExaicJMwwGbQQXKYYzY8y3iXPK/Lu1Qi7mzEeJb+ZqqGosRkrsKEu5Bw1yBVI91TFObwxIoJkswk+ogr0C5uIWu4sIjnTr7xHZZqMQfUstIubSG0izCAvs6PSvYYjXR3X9APVT7bIyaHdKGhJgmnyjO1Krutw5Co= 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=MMLBSZCE; dkim=pass (2048-bit key) header.d=oss.qualcomm.com header.i=@oss.qualcomm.com header.b=eyGgpbJR; arc=none smtp.client-ip=205.220.180.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="MMLBSZCE"; dkim=pass (2048-bit key) header.d=oss.qualcomm.com header.i=@oss.qualcomm.com header.b="eyGgpbJR" Received: from pps.filterd (m0279869.ppops.net [127.0.0.1]) by mx0a-0031df01.pphosted.com (8.18.1.11/8.18.1.11) with ESMTP id 6276tXU73908104 for ; Sat, 7 Mar 2026 11:42:37 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=MMLBSZCEODmf65KM WTGAu6cSZXV8zO7KcZdu1QYppchEuMAjFw9PsZaPDSObGoHSV298OjX4rRlxS31a ShLIjSX4e/Il5ULFHLHHdpiOO+0YTvtxszMTTF1v2IotkKKKuueLpqbJcE9pbAHW q0N93E2L1djGKr7yNLzYkdDgPwJYxGhSmlWn5sn9PVfOxXZFxK5bSrYiEd1sxYy4 DvO8k2StvOjyipliFk/crY/2v/2jFHO/RTy3khQm23o8EdGHwQR5hMVfo7SoQ5vx +KAs/2nqUXTLOUyCE9CoL8u0YM91zUF3WkeOZi14dDXrqs8XwuLS1HFM2utOrtN/ N7KKvA== Received: from mail-pl1-f199.google.com (mail-pl1-f199.google.com [209.85.214.199]) by mx0a-0031df01.pphosted.com (PPS) with ESMTPS id 4crb14ru7d-1 (version=TLSv1.3 cipher=TLS_AES_128_GCM_SHA256 bits=128 verify=NOT) for ; Sat, 07 Mar 2026 11:42:37 +0000 (GMT) Received: by mail-pl1-f199.google.com with SMTP id d9443c01a7336-2ae405e95f5so76209695ad.2 for ; Sat, 07 Mar 2026 03:42:37 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oss.qualcomm.com; s=google; t=1772883756; x=1773488556; darn=vger.kernel.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=eyGgpbJRMN0YyZHmmhVq2edKK1PvfrGXZ1cw81wOijSv/chc8/X/QUh/O6PyQRAGlc WKK/8HSynN9BxHImaQtW+AjZjNdYtazUriEkFutJOeYH2VBLe1KAtTisndzOwfGweWNn kkxEKz2JmAqfWrP1QVzzI1k46SsSb36Of+ONwxCq2U8/QeUXt63/iyi8B7cU441JoY4M izi/efQPWlBxfZBraCs3Yl739Xv6sJ4CTIVk1cPNUZFf9t+WUYgdjUOZm2GrqvhwEu5u h0WPXtXgNLFpEr7QJ1OHgoBHN57KPk5cVaLLWwb+4KFs+4BOl/MgZ459Nblj1/zIb5z0 BhdQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1772883756; x=1773488556; 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=k+r87QRZXNZ9GZkwj0FOepMBO2NsgAJ+TV24XpkmIlNOQ9ra53CbHsd1+v3PH9e+GT beZJeraN5PvVrTHyk+vWkq/uKvQrh5xhVDA8LyP4a5zb7Qy6LW/Fhj00YYMHpEiZH9w8 eHVMt96Ey3dYw6Q5EdAHd4bpUXP9FkIO5f9GHr/7+ERK4noGvLiKiPtr/9DzuWlKQliN Mrr0IDIgCRlTtL2HBV9JRjstuLu5u5JHvIkTaqlb72XQClKA45TRQL77GrmFgp7DkEQR peUNDO68/wEo0a8WoAx75XBIQaDfKIxXMBHInLeNWYGxfKC1O5WqU7gvp9AXUQUEUxyn ynbg== X-Forwarded-Encrypted: i=1; AJvYcCWn/Flb/jFWqSy+f/t+YebsKFoYVjCd8qvVPFX85Ii7mpmmmm1MKIMe8szM787QGeeG4tsEd62eDXUjpVs=@vger.kernel.org X-Gm-Message-State: AOJu0Yy9F6ofgkr+HOz1qnw/qwJUXlsvTSNS97A8UKY06XQLdxfDYWgJ KAoZdXWrv5gHzDxfpx/JWF9+WEInUZ2+2k60CXzHAucLOKKvAdo2VEq+ndckMsMgiE/S44VSESF SwkMRlLXb5udf6YDRiXd2GLTrW+1al7mq/5P4WUUnSvzljDLUgsyDmnlOdvqtJuGm7kM= X-Gm-Gg: ATEYQzzPID0IZ2lXVTAL5Ds8KtEQ0xi+SlPrK93ENo21mEpfT96PR6hXM2XN2PZVjIx cz4xqZmPgRoXDOFvKu8OQLqU/j6U+r4ZQKwiMasjLIoGpDRvyv7BtTA1NYbDUd1XuKKIU5NGRj6 /gTv9f4krN4VT4TtVQYc9Vf8bY416KNW80j0NNOwERGD2fUPw7dPRwMLwH25UwwoM2lxSBxZQvg 8jjfCZJH3yNr8LdnJIuVrIdjKviXHiExpdQM5ySAkQz/2/hNSYJOSIYob4GGTkKH7GjjaILB8bW Klfwrhpuunh7+n5ZUmSuX4cJ44ezcrFBarZeTjjlmiromADg66NCHhIY74M1NJwTHNjztq+EHKH vSx1wSry0NzCsqQ9PqoEw4r56qr+zDMNEjR22xxNZlYPl+nu3X4Q= X-Received: by 2002:a17:902:e549:b0:2ae:5848:baf0 with SMTP id d9443c01a7336-2ae8241685bmr59503375ad.2.1772883756449; Sat, 07 Mar 2026 03:42:36 -0800 (PST) X-Received: by 2002:a17:902:e549:b0:2ae:5848:baf0 with SMTP id d9443c01a7336-2ae8241685bmr59503205ad.2.1772883755994; Sat, 07 Mar 2026 03:42:35 -0800 (PST) Received: from hu-batta-hyd.qualcomm.com ([202.46.23.25]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-2ae83f8c713sm47996145ad.66.2026.03.07.03.42.32 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 07 Mar 2026 03:42:35 -0800 (PST) From: Kishore Batta Date: Sat, 07 Mar 2026 17:11:30 +0530 Subject: [PATCH v2 9/9] Documentation: ABI: Add sysfs ABI documentation for DDR training data 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 Message-Id: <20260307-sahara_protocol_new_v2-v2-9-29dc748b5e9c@oss.qualcomm.com> References: <20260307-sahara_protocol_new_v2-v2-0-29dc748b5e9c@oss.qualcomm.com> In-Reply-To: <20260307-sahara_protocol_new_v2-v2-0-29dc748b5e9c@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=1772883713; l=1903; i=kishore.batta@oss.qualcomm.com; s=20260206; h=from:subject:message-id; bh=PYlMjATY4SM1+jaLjbUMOn336QEIJpGFcRpjUcyzz/4=; b=w+aHsVXwaMyLhL8Goe7uM28s40e002IzrEGaReObHvVofLk2hwgKkxUc87dYK5Uy5uT4SJ0v/ IsfocM9Rc+BB12kavhO74NwlBai980rYUSUPMwBcVaAgD/rMcxEMAB+ X-Developer-Key: i=kishore.batta@oss.qualcomm.com; a=ed25519; pk=vJo8RvTf+HZpRLK2oOIljmbn9l3zFkibCGh+blaqZCw= X-Authority-Analysis: v=2.4 cv=IYSKmGqa c=1 sm=1 tr=0 ts=69ac0f2d cx=c_pps a=JL+w9abYAAE89/QcEU+0QA==:117 a=ZePRamnt/+rB5gQjfz0u9A==:17 a=IkcTkHD0fZMA:10 a=Yq5XynenixoA:10 a=s4-Qcg_JpJYA:10 a=VkNPw1HP01LnGYTKEx00:22 a=u7WPNUs3qKkmUXheDGA7:22 a=_glEPmIy2e8OvE2BGh3C:22 a=EUspDBNiAAAA:8 a=dkV1H7vRkoxx0F9zaYgA:9 a=QEXdDO2ut3YA:10 a=324X-CrmTo6CU4MGRt3R:22 X-Proofpoint-GUID: z2KBLjtH5bYmAUZ7tZcxH5yXtMK78Xru X-Proofpoint-ORIG-GUID: z2KBLjtH5bYmAUZ7tZcxH5yXtMK78Xru X-Proofpoint-Spam-Details-Enc: AW1haW4tMjYwMzA3MDEwNiBTYWx0ZWRfXxP4t+/VupCz6 IfW/nD0Ke3osz89/Xo5wBdNqWtIQMN9MpGxHg+ID3Uz8fdmszh9CXvVn2rBr1f2XvmZeOIajMLG QJZ0tDAvJCxrqE4cCMYrDZX1KZ+vehVqkFk3eaJvIvF1gDuulGkYhZFfn5I2SD5oZxkApN3udv6 q1H9wdg9VRZwQzg4WcXMfI3vjJSserFU/0IVULMsF5EfltOkY96o0tlbG0mBpwfOoa8KbGQ3q33 SMQG87qMG5/Zv8KKjWAIyicN0wTZ0ZGYs3pGagpLmdWqijjhjH0C0SzeCq3s93QCfJjujcZecQ8 MjDqj8t8o6puNDtGkHzW+tXB27iTFgx43a8oTBRzek/3ZwXttzT9DjSbC8L0sph4QhjrgS25KLM kQi95GPqB6Y6yB58Fsf7+LNrjnstRotsRc3CuHxpPA6BY5ZA0d81NRoX6MXOuJpN+CEUmrMD2Yy Vh1r3rfnduxECELLYKQ== 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-07_04,2026-03-06_02,2025-10-01_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 adultscore=0 suspectscore=0 lowpriorityscore=0 spamscore=0 impostorscore=0 phishscore=0 clxscore=1015 priorityscore=1501 malwarescore=0 bulkscore=0 classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0 reason=mlx scancount=1 engine=8.22.0-2602130000 definitions=main-2603070106 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/Do= cumentation/ABI/testing/sysfs-bus-mhi-ddr_training_data new file mode 100644 index 0000000000000000000000000000000000000000..810b487b5a5fdba133d81255f98= 79844e3938a10 --- /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 de= vice + connected. MHI driver populates different controll= er + nodes for each device. The DDR training data is ex= posed + to userspace to read and save the training data fi= le to + the filesystem. In the subsequent boot up of the d= evice, + 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. --=20 2.34.1