From nobody Thu Apr 9 10:36:21 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 55E113E7179 for ; Tue, 10 Mar 2026 07:22:50 +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=1773127371; cv=none; b=U8vWCVtBNnZ3Me7tOV/zFAtq5YULaloFMOK2ryuLT81scoXFFHH1qZ6qalB/TB9c5WxcfZNcgTCsNMiv/w5trD6IdGZZCab6tRzc0P7w3ce4iUQuLNyxPWxEagFfOnVHUKKwn2fs2lc52p8XnUrMBpIwESxzJdfj+mrjebLtE7g= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773127371; c=relaxed/simple; bh=PYlMjATY4SM1+jaLjbUMOn336QEIJpGFcRpjUcyzz/4=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=jo8WH8To+1pTei3e6VdoWsP5Cii9eb1gaVUxVW1/Mt4GmjzV10FswbEZ37kDtie0eJY06stxLAlj4CzKQtA/jLFuKIYB5mnBH4kb3eXh4SXQJAnmpScySBKdWV0LZXwU5t9OZi62GliuhSIoyj6f7cXRn7opP7EL0ZU0EoOd+Dg= 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=OSQUoMBa; dkim=pass (2048-bit key) header.d=oss.qualcomm.com header.i=@oss.qualcomm.com header.b=aoIVQuo/; 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="OSQUoMBa"; dkim=pass (2048-bit key) header.d=oss.qualcomm.com header.i=@oss.qualcomm.com header.b="aoIVQuo/" Received: from pps.filterd (m0279867.ppops.net [127.0.0.1]) by mx0a-0031df01.pphosted.com (8.18.1.11/8.18.1.11) with ESMTP id 62A2EInl2362835 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 4ct032b249-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-2ae59e057f1so94545925ad.1 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=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=aoIVQuo/NVgwsjEXYNZkTsXj5mEe7CJbtj65DoJml4ZT/UmDmDVHQGkd2Z6x23PtH4 g3Lf2YXUeki41cjg3DT8+rR+kgPlR55IooDSNl+u0pMN6B/6at47SjgF0BKIslSBqgs8 hL06siIzWUpAPjCLsBRMur3hfXciYajBAU7a4PcfPzgHM4C/dTg9YxzawVlXNjxeCIMO XOR6NTeMBQWSrpA7YGl0I69hppkEBwNz5AJSMQLxVM6IVxxdTPxtsxpUElLOqNayk50j kKxHzQnX58hk6hCEPrr9bPe2s0G4ePVD37BWEfyON6pAzQYo582v+iLDC0Sa86R1Dnki 7iqw== 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=clNyzaC6Xv1VgGjA9f+6/tlrfqUd3V9d+ncBg15ENtgXPvI6+YIY+ggVoQZTAios5S CsA2SM/si7i0uBW9l7CDhOc6Mb7cnnHtgDf+eg46eWpVcaB2F5ON1UqnaGINnKVWjf7L 0pgvUSRCGAmaAUp84Tr2DIeuy9LNKmE1tWxL/tr2PN0CkaYc2Z4x6hWcgjRuj93pEd4t NcgNJFzIvDJMi3cz1RlEK9/jNtU+ugt3IBzY+3HXFhK1r5yvqVJogO/64ds655TBYPtp fazejir9+khKQFvZEYnAI2QNg/q8kAU/sPHGCd+OSwyvCb7Vgji3N+PN1WSUycubfB0f xpLg== X-Forwarded-Encrypted: i=1; AJvYcCWPLJTWoDGyZocoqvBHsyk+kG8ci8Mq+b/k04eT5q7EYgtsOopYfSgQif10gk7dXGeo/0DTbt4Y/3rf+wY=@vger.kernel.org X-Gm-Message-State: AOJu0YyI9SXG+jYCGb0L9dbJQWjIwingYjk3DVnOqlI57gea8WqDUT3W XilT1sFBt5/traJGy97JvLpQrw1pryWwcE8rQyD6vrcfvVHs1gRBpNiFw6/nUJI1KnkselL735z 3pWYP511BpQ5A1+8y/IxBA8RDfpr0JqNGvLcCCx3qWugVr6XvUhdB5su6mLosZPaE0mE= X-Gm-Gg: ATEYQzwwpkXKK+oo+zWe6ioALroF67sErlStHIz7kGGl0YLMcY6C3HJrJSvh4deH35P u6vb9DnkZCXDa0WTKsNVn7MSeiMLeU0ttCS7XUjZsjCNZRWPMoJN2UEBwUBcQ+xBYi9Ewpuo8Yf jppusGtxxMd9wcCUEpSniiovJnYY/9AuNPq11DKMIxm42q/RYtN9X/JF/HpPWtq5HySVeb3ylhC uztLJ4sXX/Pl5ZXiCeNvDd2QoJqYAZ2M5Rie6i5hGa4UDvdErElJLt7Hlxn5iff9QmLDuheRF+H YlsEs7oFP76rzV9svPMetnp+wW3UYrsIUaVMvjBzMLwFFQQ2yHSX8PGom/o3DqfAXDLkuxuJ/UP h5vV1+0V0lMztySDwVtJUo9vNr1q0Ygi104J3mhq4xmktbMkAfXQ= X-Received: by 2002:a17:902:cf05:b0:2ae:829d:3c33 with SMTP id d9443c01a7336-2ae829d3f2emr149862965ad.8.1773127369017; 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 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: <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: AW1haW4tMjYwMzEwMDA2MSBTYWx0ZWRfX8jXsnivYW0KV QDyVtAPIuG9+UBahPVS/1JnT0tp/flZQBr1SciFrO6KOe5JhOayi63ZRgMd92ygjQ/ZH4GXSpO5 x7VClXK0t1JReV8abwJG87oXiWMRyEpLDP578y2crj8CNKgMHSn+oQKXFe/OlM2GwJZUkg9IEYE eU17OX/XPoaV8IskPM6/BPl3QhiMhDMulFWQ90sSyIm00TLBH22Lbgu1DAkek/V19LSAGAmqLFS pOOIc5Ys2A2GHCiR540X8PSZ/O/HUTryyvUnhmQb4jL1NVJkyuTfCQmpRHQsN4Kmdla1+Gl74Of h7rnlkpx1FqnOzlZnxofQYF/Z8WK2u768wze7ZFFoZ+jwIQthSZNm7H7I93y4JF98FHVhT02rkX YJ9Im3OBkSwNdoL2zzfKYwdQba8oMfLwAJ0ZLKqIoHH6tQQ3T3rfY1/dUuYOLve+yEg8jxRWpUz yth+4TE2wvQg5c5rTrA== X-Proofpoint-ORIG-GUID: yxqGwDKJvkPHOAwcjhGHOAWDTDXDiA_h X-Proofpoint-GUID: yxqGwDKJvkPHOAwcjhGHOAWDTDXDiA_h X-Authority-Analysis: v=2.4 cv=WtEm8Nfv 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=eoimf2acIAo5FJnRuUoq:22 a=EUspDBNiAAAA:8 a=dkV1H7vRkoxx0F9zaYgA:9 a=QEXdDO2ut3YA:10 a=GvdueXVYPmCkWapjIL-Q:22 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 clxscore=1015 impostorscore=0 spamscore=0 bulkscore=0 priorityscore=1501 lowpriorityscore=0 malwarescore=0 phishscore=0 adultscore=0 suspectscore=0 classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0 reason=mlx scancount=1 engine=8.22.0-2602130000 definitions=main-2603100061 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