From nobody Sun Apr 5 13:24:57 2026 Received: from AM0PR02CU008.outbound.protection.outlook.com (mail-westeuropeazon11013030.outbound.protection.outlook.com [52.101.72.30]) (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 DBDAA3921C3; Thu, 26 Feb 2026 10:31:01 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=fail smtp.client-ip=52.101.72.30 ARC-Seal: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1772101864; cv=fail; b=qpe4iS7170fAg+rRRGY04DK2RvDx1V/9b3gVkKAaPTXXosOume5YWWEWa/HxbLD4xI3wlykp/a1PKCaChYs+O9WEc85pF5G5R95uyfl0B4TeTQTpOmnWUbi43jMcRmleNLPDLy9SyJfUzVMDJzJBeYdqi3NS15JTNM1HsedxFPQ= ARC-Message-Signature: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1772101864; c=relaxed/simple; bh=+7tm7pzpX3/jtNZXrIKTr3DGfXLmFdX1eKjRPehVayc=; h=From:Date:Subject:MIME-Version:Content-Type:Message-ID:References: In-Reply-To:To:CC; b=jIpXLbDosTsx5aMh2hNgmBVRICDkUsMaYvqMsp2oKV7HZ6eh/FewJ4BoHWLcp6CVQP8sbkhpoHzpYnWetRy0RAQQsvmwbfThWpiN4+zyPumDysfNk8nVE3VzAXlBBmy9w0/Ip6XrnxY4iXycvAfE8C1m/+o445bmGNwAQUgu7z4= ARC-Authentication-Results: i=2; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=foss.st.com; spf=pass smtp.mailfrom=foss.st.com; dkim=pass (2048-bit key) header.d=foss.st.com header.i=@foss.st.com header.b=aoIdZ6ha; arc=fail smtp.client-ip=52.101.72.30 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=foss.st.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=foss.st.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=foss.st.com header.i=@foss.st.com header.b="aoIdZ6ha" ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=grsgI/H7cPhX4iFE9HnE4fmHDpZsFmn10YEs7ORRmG1y/DQUHNjbwjkOpft1Erjw+Q3QgHnR3ip7jpgP9c2hpOk/9gis/B1ezc11s+wjIioRGM1J9mNOszBaqFFogZHnNfUSXNV2csuOeRLmfLiImWjfC24l7CKCdlL5IyNZOqaqSgnm55HdgX6PMyIH+iHeG47WK4rMAq7hq/tsUh02wkdVr13r/6XXy8FcsPVIGCefG5Fa5udl3Dh0JYLsjZ/spnIDy8ZIuvGP3sGKEBWO9orFHHBP0rnNMID8dW4ZJuYuCEV3UJbRtUNwo82RS+ZdI/rb6bYC46Dq5gmH6wAIoA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=2YpT8lCKbPssC4CKbfQp21d42km8p0Z/sscdsNWw8Vc=; b=SpfwwH9u+gzzIuEQyDfhf/lVFLxstjTLvh039rBXTurAwbbaOqRPhcOBd7Gv+acNFrNi6S5xTQpdek3RAoqjQ+4EkxIwBANV2a/WJrG2Nvmxshzzxu0pYnKJlLb4qDMpc58dg69/4IqHhr8ho90xmRB3w8kcQSkRPl0ZTW1IdYGS6mdB45vQkPtGNJAdZV7GWa7FQLDlg0iXCTfyY78I3IjPUwk9IZWRGhqRTfANF7QpCod2kGW8puYThc+xNxTSi97q0hHnPj36i9hBYbnGQbl1reyZcVaR2GvltcVUt50ebGmzAjvgGq53M15xPK2Y37uYwQwV7HjlhQ0nnPbE3w== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=fail (sender ip is 164.130.1.60) smtp.rcpttodomain=st-md-mailman.stormreply.com smtp.mailfrom=foss.st.com; dmarc=fail (p=none sp=none pct=100) action=none header.from=foss.st.com; dkim=none (message not signed); arc=none (0) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=foss.st.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=2YpT8lCKbPssC4CKbfQp21d42km8p0Z/sscdsNWw8Vc=; b=aoIdZ6ha1Q/3yeVAsNDkkII6HNQ4SXv4c7V+fYZOv0YpkfU5c60fY2pKPTBECMCI1Nvu9ScgUmYdfBadncbCyC8qsQyodrJOVtw68mRBTYyrsbYguswutUNAZg8o+7hEVytoKtTJC/7x0mgCKkajS6dkZPWRvxc6DC4hPlcKisz2WJCiOCsd1KNEBvBifzQHc8syjPWb+eqq4LV3AXuqVnwaunKkMv8q78Dx0nOd+2Qr1+YEuL9O63IlJEgV1EoREGyC2mRqKwm9+C/rTDibD0cMmksegruxHXB8vvJqdHIQYctzgl2as2GmBdX84AoVmHcV4RUVmOvFusQXzgqzMA== Received: from AS4P250CA0025.EURP250.PROD.OUTLOOK.COM (2603:10a6:20b:5e3::15) by PRAPR10MB5204.EURPRD10.PROD.OUTLOOK.COM (2603:10a6:102:299::15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.9654.13; Thu, 26 Feb 2026 10:30:54 +0000 Received: from AM3PEPF00009B9B.eurprd04.prod.outlook.com (2603:10a6:20b:5e3:cafe::98) by AS4P250CA0025.outlook.office365.com (2603:10a6:20b:5e3::15) with Microsoft SMTP Server (version=TLS1_3, cipher=TLS_AES_256_GCM_SHA384) id 15.20.9632.26 via Frontend Transport; Thu, 26 Feb 2026 10:30:54 +0000 X-MS-Exchange-Authentication-Results: spf=fail (sender IP is 164.130.1.60) smtp.mailfrom=foss.st.com; dkim=none (message not signed) header.d=none;dmarc=fail action=none header.from=foss.st.com; Received-SPF: Fail (protection.outlook.com: domain of foss.st.com does not designate 164.130.1.60 as permitted sender) receiver=protection.outlook.com; client-ip=164.130.1.60; helo=smtpO365.st.com; Received: from smtpO365.st.com (164.130.1.60) by AM3PEPF00009B9B.mail.protection.outlook.com (10.167.16.20) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.9632.12 via Frontend Transport; Thu, 26 Feb 2026 10:30:54 +0000 Received: from STKDAG1NODE2.st.com (10.75.128.133) by smtpO365.st.com (10.250.44.72) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.2562.29; Thu, 26 Feb 2026 11:33:01 +0100 Received: from localhost (10.48.86.212) by STKDAG1NODE2.st.com (10.75.128.133) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.2562.29; Thu, 26 Feb 2026 11:30:53 +0100 From: Gatien Chevallier Date: Thu, 26 Feb 2026 11:30:18 +0100 Subject: [PATCH v6 03/12] dt-bindings: bus: document the stm32 debug bus 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: <20260226-debug_bus-v6-3-5d794697798d@foss.st.com> References: <20260226-debug_bus-v6-0-5d794697798d@foss.st.com> In-Reply-To: <20260226-debug_bus-v6-0-5d794697798d@foss.st.com> To: Suzuki K Poulose , Mike Leach , James Clark , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Mathieu Poirier , Leo Yan , =?utf-8?q?Cl=C3=A9ment_Le_Goffic?= , Linus Walleij , "Maxime Coquelin" , Alexandre Torgue , , , , Sudeep Holla CC: , , , , , , Gatien Chevallier X-Mailer: b4 0.14.3 X-ClientProxiedBy: STKCAS1NODE1.st.com (10.75.128.134) To STKDAG1NODE2.st.com (10.75.128.133) X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: AM3PEPF00009B9B:EE_|PRAPR10MB5204:EE_ X-MS-Office365-Filtering-Correlation-Id: 1e8a6208-3d37-4aaf-4159-08de75221f0e X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|82310400026|376014|7416014|1800799024|36860700013|921020|13003099007; X-Microsoft-Antispam-Message-Info: TTS9YKd8hlT0rB5RuxcAditS6xJswtUNUikHzjaDSm0xns/uJfdx693WBbsu83buNJery+/Gr22UKRDDCX4ZI0q2714KxafpHiPTbPLDjqz+y6g8jHcPDHYrapVKXZF9OeBiuTrG5J6I8nymsgPE9tknOJUhzFiYtcoa4045r2wbO2dc/H771kCosHUzgssAfI5vqbkhcLrxv0j+RfVX4IG6o0l8wVS39h3guF0JFvfMPk+mhXm3jd7AtqBsiiSlrDjIFnM9Vk3Hu9SwfoWzupgqrGdn9lVXZhG6LZ2dK/E04MFiXyoQroi0v7YHVZkZ8v/PtkyTYIkcYhqO3RZqzZ4M3ER0J1PMwhRuVQ/68YsYEU1lZsrc7MynspJTYtggK3bkOa4v2NdGdcxuHweKhmibfxed3Arna8HCuqvNknSsAxwmZbE5D53kwEwGtNVDqVubgQWlL1C4A8Ax29cLIsN4xyksqKY9lb/Pa/KO86YEYxxk28wUyq9kvLXPgpe9ULN9qqkpUvRGYTa7YTvmyAB8OZ8/iojmwNjx7uT6sI4+ksLl6WB8DYkJL2Cl3DdzrJHNXqwe4Fs1LPFCdwSLssmItPyA0p9a7dOwGNpyTViTPc3FfrhvEC86uWZYrcwq3nhZ+Bn9/XnmSCLQjZgwsdlfR9652Cslt5K9udWJ9pnO02KgT3HKIepx1ptngkMtuBBpCCdvJcchRIjqiJDMFRCqOJTguX3vnhlsN2fWFcymYBXMpZEVK292qMBpf2ipWPuZhDtiD8NUMWtG8DkADQvjSzuUWHqJfFSMe22+croD3OKSXK//EGBf5bZPJL1B X-Forefront-Antispam-Report: CIP:164.130.1.60;CTRY:IT;LANG:en;SCL:1;SRV:;IPV:CAL;SFV:NSPM;H:smtpO365.st.com;PTR:InfoDomainNonexistent;CAT:NONE;SFS:(13230040)(82310400026)(376014)(7416014)(1800799024)(36860700013)(921020)(13003099007);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: uST5a7nDkEnTEb7LadsfPU1FssS45Z0jCnMPeBG/ZrDrTu/Ze0TqLHI0aF+JPAnsHJp7JU2ShATdiZ4XBIVAQMcqH/bPrvLzBTgXuAJUw86ra04OWDxoHVDXWCXpeF1sHLNyf4PlXLU8/1PTQ8XPtYNyjaQCYwPKZEhiWNcj47sJeZiS4Y564Vd4x1q0lRZJrwoqk0BwIsm4G61OcQ4VxErbEqJ6KqSotwPm3OVJVnfeM+N5oQ8zYX4FClnhZuDBfywzvfvidUmz5YqaRNgtYU8nedNawt5DzE/RtoGp2dxx3qfGvbshBc9WX2dSK3CvcAMal4vxBMbBx23KOnvf9/7HgmEU+tiCDvUhImZRXgE2i8H2j6pAKeP/VQ7BZ+apAQfYImJX8jFiOBJ7vB0oc2IR71/A4Aec2IQJdNO66Gr3rNvFFeD6q234U9SYqfnA X-OriginatorOrg: foss.st.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 26 Feb 2026 10:30:54.2653 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 1e8a6208-3d37-4aaf-4159-08de75221f0e X-MS-Exchange-CrossTenant-Id: 75e027c9-20d5-47d5-b82f-77d7cd041e8f X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=75e027c9-20d5-47d5-b82f-77d7cd041e8f;Ip=[164.130.1.60];Helo=[smtpO365.st.com] X-MS-Exchange-CrossTenant-AuthSource: AM3PEPF00009B9B.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: PRAPR10MB5204 Document the stm32 debug bus. The debug bus is responsible for checking the debug sub-system accessibility before probing any related drivers. Signed-off-by: Gatien Chevallier Reviewed-by: Rob Herring (Arm) --- .../bindings/bus/st,stm32mp131-dbg-bus.yaml | 76 ++++++++++++++++++= ++++ 1 file changed, 76 insertions(+) diff --git a/Documentation/devicetree/bindings/bus/st,stm32mp131-dbg-bus.ya= ml b/Documentation/devicetree/bindings/bus/st,stm32mp131-dbg-bus.yaml new file mode 100644 index 000000000000..6c74433efbe3 --- /dev/null +++ b/Documentation/devicetree/bindings/bus/st,stm32mp131-dbg-bus.yaml @@ -0,0 +1,76 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/bus/st,stm32mp131-dbg-bus.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: STM32 Coresight bus + +maintainers: + - Gatien Chevallier + +description: + The STM32 debug bus is in charge of checking the debug configuration + of the platform before probing the peripheral drivers that rely on the d= ebug + domain. + +properties: + compatible: + items: + - enum: + - st,stm32mp131-dbg-bus + - st,stm32mp151-dbg-bus + + "#address-cells": + const: 1 + + "#size-cells": + const: 1 + + ranges: + minItems: 1 + maxItems: 2 + + "#access-controller-cells": + const: 1 + description: + Contains the debug profile necessary to access the peripheral. + +patternProperties: + "@[0-9a-f]+$": + description: Debug related peripherals + type: object + + additionalProperties: true + + required: + - access-controllers + +required: + - "#access-controller-cells" + - "#address-cells" + - "#size-cells" + - compatible + - ranges + +additionalProperties: false + +examples: + - | + #include + + dbg_bus: bus@50080000 { + compatible =3D "st,stm32mp131-dbg-bus"; + #address-cells =3D <1>; + #size-cells =3D <1>; + #access-controller-cells =3D <1>; + ranges =3D <0x50080000 0x50080000 0x3f80000>; + + cti@50094000 { + compatible =3D "arm,coresight-cti", "arm,primecell"; + reg =3D <0x50094000 0x1000>; + clocks =3D <&rcc CK_DBG>; + clock-names =3D "apb_pclk"; + access-controllers =3D <&dbg_bus 0>; + }; + }; --=20 2.43.0