From nobody Mon Sep 28 23:56:19 2026 Received: from mail-pg1-f174.google.com (mail-pg1-f174.google.com [209.85.215.174]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id DD87135B657 for ; Fri, 14 Aug 2026 19:47:10 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.215.174 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786736832; cv=none; b=J/9IN8+iUAflCviQAUee6v3lhodBu4pydbkewd/4ggtdkoFSvK/x1I3mhm3ZL+AORkObfi2hkRg+c0jYyGA7Td8q4wASFY5R5dSLmtA1GQvf16KoNewPsmkL/PINJuxgBEmfsEzdKrR85eLE9EfEnjVuzI6Xfb4Fho35gKrcEyw= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786736832; c=relaxed/simple; bh=U1JoGZnvbz1lmyls1/v3gPQsEpMLAWDBdYn4o9KJ+Yc=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=j1ybkEk/idTVbQBw4qfkZ5dB+iQ+Ey33+/48fw9u0VZUSvIWU5D/OKgBcz56SiOnDVFVKqFAdhb9Rg7XRERJqCvur8qEx+pvKAobHfbvulqxuTuaYmhufQZnZopwXT+zWwSlke+KbycVlExYimGjqJXd82YNBbsp4aKOcO3ATbE= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=chromium.org; spf=pass smtp.mailfrom=chromium.org; dkim=pass (1024-bit key) header.d=chromium.org header.i=@chromium.org header.b=kazr7Rlq; arc=none smtp.client-ip=209.85.215.174 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=chromium.org Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=chromium.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=chromium.org header.i=@chromium.org header.b="kazr7Rlq" Received: by mail-pg1-f174.google.com with SMTP id 41be03b00d2f7-ca7c1176317so1183413a12.1 for ; Fri, 14 Aug 2026 12:47:10 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=chromium.org; s=google; t=1786736830; x=1787341630; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to:content-type; bh=4pFsg5DaBut5RJmYZBe5aOtRtX/aP+9Aa+0P+1l5WK4=; b=kazr7RlqEPdiOEv0GOqS+3z03jFbFKJRHiDQjalQhLdJ5H0QKkmqOpBCRB5JEquP+w pAWkGoaWN4FEPftHcyUnA6kZbLM70rtO9YyXhpQ9G+7NxVc2kj7dvtI0i1FRCfgBEq9E uY4aX/cPooXbamX5vx2OmciH0L46mGCUllsHY= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1786736830; x=1787341630; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to:content-type; bh=4pFsg5DaBut5RJmYZBe5aOtRtX/aP+9Aa+0P+1l5WK4=; b=mLV2lFQv2FARWnN7IWcF9AmiQH0AlHhtoCuTlY/QVGI7DlWhgIQSCLvnrzsnTCYHtC /5AYgwGYXlFXSIozYfrfVpBp3pjgj5E7f0PZC1foJGnpmJ1s4fB8W941SJs393qqsd9+ c0nxhEsFamILw4Z2JL9iE8j/b1fU9WEELE2y6SVYXPozUzg8Z1ANr7zyTB+aM8QyJME/ V9wKebhFQ//1qBL4PYCDvNMKswnKMG+Xiz2LicEA0OyqpZzi0fl6e3p376XbvjkvaE/a LuIOdSO9dIJYXgDgRaowuAeMFtyhW1I5M1VT25ENmIrL8IMxlwmw5xiB233sG7vqB+n1 +mNA== X-Forwarded-Encrypted: i=1; AHgh+RpisK/keE6KWzII+xXEA/EdkdarEcFOVWzwZPv2Ys/cESktHVOsHczyVLx3wJLaTKMeObAxJznsD8kyJ8c=@vger.kernel.org X-Gm-Message-State: AOJu0YwABdWrQBVYwZ0tZqjiduYxAn9cHUY8Oh3c5pp68GSh9RgVGKxE DEWW+5HAc6ocbORsX8VYlIvOzCXOax2oq17Bio8vK3fDcLIMIjLbx5eEUwpWUrInEQ== X-Gm-Gg: AR+sD13zq7SIgKbVkpxYu7UfMpk7oRuZUq8pZiPUn+0gy52OAmk1M8L1BoJXOmdegU7 7bQOMJLxC1MEEMnz8OenNctnvu1k+If9OMZ4PoCKPIc8HYqkeqU1T6vvMaXnU+jLEh2EeSR9TIz CB4LIj4UjqveK+gTkGg7fsW9VdJ7U1XAs7o2/RmrhucgVA1kQLrQNV0t4xXXIAphKrAia5h0tqm lBf+EC3copL+EUhMhRNHYLJV09PIQYGSvgj1/ZFEPPDnCaqeqkYHr561okwZpGQuZaWeX5Ejawh UQif473SS3joV1aFfj/FTg7xZS0aCPalR5Z7/3tw1ZLrUZ4LgGXS/EGEN+okRPc2PFOeASCz6wj KWp9eJ1q5VOEDdFMj2RkJU1OucAXxxJOfABEadcVogE1XnMlNFXt7CRHzJ0WcrDbh0dd8qLHpwz NLTaDefmN99rxL+f61JsJAvVrkTeF4jgY6AMDxOPooRV4zY4gKDOFtORqtvGqMnyLCbldi6nnya 2n9XJsSEogm3lbqjRRD3fgquuzjhdED8KGmDMj6TRZdt70= X-Received: by 2002:a05:6a21:a4a:b0:3c3:9070:96b3 with SMTP id adf61e73a8af0-3cc71af165bmr10151406637.3.1786736829719; Fri, 14 Aug 2026 12:47:09 -0700 (PDT) Received: from dianders.sjc.corp.google.com ([2a00:79e0:2e7c:8:dcf8:d626:8503:b94]) by smtp.gmail.com with ESMTPSA id a92af1059eb24-141386a039asm11446346c88.0.2026.08.14.12.47.05 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 14 Aug 2026 12:47:06 -0700 (PDT) From: Douglas Anderson To: Jassi Brar , Rob Herring , Krzysztof Kozlowski , Conor Dooley Cc: Douglas Anderson , Sudeep Holla , Lee Jones , Bjorn Andersson , Chen-Yu Tsai , Jernej Skrabec , Jonathan Hunter , Konrad Dybcio , Michal Simek , Samuel Holland , Sebastian Reichel , Suman Anna , Thierry Reding , devicetree@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-arm-msm@vger.kernel.org, linux-kernel@vger.kernel.org, linux-pm@vger.kernel.org, linux-sunxi@lists.linux.dev, linux-tegra@vger.kernel.org Subject: [PATCH v2] dt-bindings: mailbox: Delete old 'mailbox.txt' bindings file Date: Fri, 14 Aug 2026 12:46:12 -0700 Message-ID: <20260814124603.v2.1.I8b3ff71c528133e7d6f81fe926fa39e6451d63fd@changeid> X-Mailer: git-send-email 2.55.0.691.gc56d675ccc-goog Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" As per mailing-list discussions [1] [2] [3], we want to delete the following old file from the device-tree bindings that live in the Linux kernel git tree: * Documentation/devicetree/bindings/mailbox/mailbox.txt The old .txt file did have some descriptive text about what some of the properties meant. Those have been added to the dt-schema repository in a pull request [4]. Also remove dangling references to `mailbox.txt` across all remaining device-tree binding documentation files. Link: https://lore.kernel.org/r/20260722140214.GA548057-robh@kernel.org [1] Link: https://lore.kernel.org/r/dc7a2041-50a4-482e-9930-566bb3fd1e72@kernel= .org [2] Link: https://lore.kernel.org/r/CAL_JsqKVjQ2m-dzMUENQry-f_YE9QrYSOKoH9CPj1g= jj8XkPRA@mail.gmail.com [3] Link: https://github.com/devicetree-org/dt-schema/pull/202 [4] Cc: Sudeep Holla Cc: Jassi Brar Cc: Lee Jones Signed-off-by: Douglas Anderson --- - v1: https://lore.kernel.org/r/20260804133801.1.I8b3ff71c528133e7d6f81fe92= 6fa39e6451d63fd@changeid Changes in v2: - Remove dangling mailbox.txt references as per Sashiko. .../firmware/nvidia,tegra186-bpmp.yaml | 6 +- .../mailbox/allwinner,sun6i-a31-msgbox.yaml | 3 - .../bindings/mailbox/altera-mailbox.txt | 12 ++-- .../mailbox/hisilicon,hi3660-mailbox.txt | 2 +- .../mailbox/hisilicon,hi6220-mailbox.txt | 2 +- .../devicetree/bindings/mailbox/mailbox.txt | 60 ------------------- .../bindings/mailbox/ti,omap-mailbox.yaml | 3 +- .../power/reset/xlnx,zynqmp-power.yaml | 9 +-- .../bindings/soc/qcom/qcom,aoss-qmp.yaml | 2 +- 9 files changed, 15 insertions(+), 84 deletions(-) delete mode 100644 Documentation/devicetree/bindings/mailbox/mailbox.txt diff --git a/Documentation/devicetree/bindings/firmware/nvidia,tegra186-bpm= p.yaml b/Documentation/devicetree/bindings/firmware/nvidia,tegra186-bpmp.ya= ml index 3c44fe607e12..acdc5c1d3d8b 100644 --- a/Documentation/devicetree/bindings/firmware/nvidia,tegra186-bpmp.yaml +++ b/Documentation/devicetree/bindings/firmware/nvidia,tegra186-bpmp.yaml @@ -18,11 +18,9 @@ description: | which can create the interprocessor communication (IPC) between the CPU and BPMP. =20 - This node is a mailbox consumer. See the following files for details - of the mailbox subsystem, and the specifiers implemented by the - relevant provider(s): + This node is a mailbox consumer. See the following file for details + of the mailbox specifiers implemented by the relevant provider(s): =20 - - .../mailbox/mailbox.txt - .../mailbox/nvidia,tegra186-hsp.yaml =20 This node is a clock, power domain, and reset provider. See the diff --git a/Documentation/devicetree/bindings/mailbox/allwinner,sun6i-a31-= msgbox.yaml b/Documentation/devicetree/bindings/mailbox/allwinner,sun6i-a31= -msgbox.yaml index 87d31963c1b7..f58b0d412186 100644 --- a/Documentation/devicetree/bindings/mailbox/allwinner,sun6i-a31-msgbox.= yaml +++ b/Documentation/devicetree/bindings/mailbox/allwinner,sun6i-a31-msgbox.= yaml @@ -17,9 +17,6 @@ description: | hold four 32-bit messages; when a FIFO is full, clients must wait before attempting more transmissions. =20 - Refer to ./mailbox.txt for generic information about mailbox device-tree - bindings. - properties: compatible: oneOf: diff --git a/Documentation/devicetree/bindings/mailbox/altera-mailbox.txt b= /Documentation/devicetree/bindings/mailbox/altera-mailbox.txt index c4dd93f1fed2..87749d251f09 100644 --- a/Documentation/devicetree/bindings/mailbox/altera-mailbox.txt +++ b/Documentation/devicetree/bindings/mailbox/altera-mailbox.txt @@ -31,12 +31,12 @@ Example: =20 Mailbox client =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D -"mboxes" and the optional "mbox-names" (please see -Documentation/devicetree/bindings/mailbox/mailbox.txt for details). Each v= alue -of the mboxes property should contain a phandle to the mailbox controller -device node and second argument is the channel index. It must be 0 (hardwa= re -support only one channel).The equivalent "mbox-names" property value can be -used to give a name to the communication channel to be used by the client = user. +The common mailbox binding properties "mboxes" and the optional "mbox-name= s" +can be used. Each value of the mboxes property should contain a phandle to +the mailbox controller device node and second argument is the channel inde= x. +It must be 0 (hardware support only one channel). The equivalent "mbox-nam= es" +property value can be used to give a name to the communication channel to = be +used by the client user. =20 Example: mclient0: mclient0@400 { diff --git a/Documentation/devicetree/bindings/mailbox/hisilicon,hi3660-mai= lbox.txt b/Documentation/devicetree/bindings/mailbox/hisilicon,hi3660-mailb= ox.txt index 3e5b4537407d..ec2da5c9e647 100644 --- a/Documentation/devicetree/bindings/mailbox/hisilicon,hi3660-mailbox.txt +++ b/Documentation/devicetree/bindings/mailbox/hisilicon,hi3660-mailbox.txt @@ -35,7 +35,7 @@ Client =20 Required properties: - compatible : See the client docs -- mboxes : Standard property to specify a Mailbox (See ./mailbox.txt) +- mboxes : Standard property to specify a Mailbox Cells must match 'mbox-cells' (See Controller docs above) =20 Optional properties diff --git a/Documentation/devicetree/bindings/mailbox/hisilicon,hi6220-mai= lbox.txt b/Documentation/devicetree/bindings/mailbox/hisilicon,hi6220-mailb= ox.txt index 044b17f3a77a..de9fbf722bee 100644 --- a/Documentation/devicetree/bindings/mailbox/hisilicon,hi6220-mailbox.txt +++ b/Documentation/devicetree/bindings/mailbox/hisilicon,hi6220-mailbox.txt @@ -55,7 +55,7 @@ Mailbox client Required properties: -------------------- - compatible: Many (See the client docs). -- mboxes: Standard property to specify a Mailbox (See ./mailbox.txt) +- mboxes: Standard property to specify a Mailbox Cells must match 'mbox-cells' (See Mailbox Device Node above). =20 Optional Properties: diff --git a/Documentation/devicetree/bindings/mailbox/mailbox.txt b/Docume= ntation/devicetree/bindings/mailbox/mailbox.txt deleted file mode 100644 index af8ecee2ac68..000000000000 --- a/Documentation/devicetree/bindings/mailbox/mailbox.txt +++ /dev/null @@ -1,60 +0,0 @@ -* Generic Mailbox Controller and client driver bindings - -Generic binding to provide a way for Mailbox controller drivers to -assign appropriate mailbox channel to client drivers. - -* Mailbox Controller - -Required property: -- #mbox-cells: Must be at least 1. Number of cells in a mailbox - specifier. - -Example: - mailbox: mailbox { - ... - #mbox-cells =3D <1>; - }; - - -* Mailbox Client - -Required property: -- mboxes: List of phandle and mailbox channel specifiers. - -Optional property: -- mbox-names: List of identifier strings for each mailbox channel. -- shmem : List of phandle pointing to the shared memory(SHM) area between = the - users of these mailboxes for IPC, one for each mailbox. This shared - memory can be part of any memory reserved for the purpose of this - communication between the mailbox client and the remote. - - -Example: - pwr_cntrl: power { - ... - mbox-names =3D "pwr-ctrl", "rpc"; - mboxes =3D <&mailbox 0 &mailbox 1>; - }; - -Example with shared memory(shmem): - - sram: sram@50000000 { - compatible =3D "mmio-sram"; - reg =3D <0x50000000 0x10000>; - - #address-cells =3D <1>; - #size-cells =3D <1>; - ranges =3D <0 0x50000000 0x10000>; - - cl_shmem: shmem@0 { - compatible =3D "client-shmem"; - reg =3D <0x0 0x200>; - }; - }; - - client@2e000000 { - ... - mboxes =3D <&mailbox 0>; - shmem =3D <&cl_shmem>; - .. - }; diff --git a/Documentation/devicetree/bindings/mailbox/ti,omap-mailbox.yaml= b/Documentation/devicetree/bindings/mailbox/ti,omap-mailbox.yaml index 8504ceb64806..7e3b7b68841c 100644 --- a/Documentation/devicetree/bindings/mailbox/ti,omap-mailbox.yaml +++ b/Documentation/devicetree/bindings/mailbox/ti,omap-mailbox.yaml @@ -53,8 +53,7 @@ description: | =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D A device needing to communicate with a target processor device should sp= ecify them using the common mailbox binding properties, "mboxes" and the optio= nal - "mbox-names" (please see Documentation/devicetree/bindings/mailbox/mailb= ox.txt - for details). Each value of the mboxes property should contain a phandle= to + "mbox-names". Each value of the mboxes property should contain a phandle= to the mailbox controller device node and an args specifier that will be the phandle to the intended sub-mailbox child node to be used for communicat= ion. The equivalent "mbox-names" property value can be used to give a name to= the diff --git a/Documentation/devicetree/bindings/power/reset/xlnx,zynqmp-powe= r.yaml b/Documentation/devicetree/bindings/power/reset/xlnx,zynqmp-power.ya= ml index 079ad977b907..60f0882f5381 100644 --- a/Documentation/devicetree/bindings/power/reset/xlnx,zynqmp-power.yaml +++ b/Documentation/devicetree/bindings/power/reset/xlnx,zynqmp-power.yaml @@ -27,12 +27,9 @@ properties: mailbox controller device node and an args specifier that will be the phandle to the intended sub-mailbox child node to be used for communication. See - Documentation/devicetree/bindings/mailbox/mailbox.txt - for more details about the generic mailbox controller - and client driver bindings. Also see - Documentation/devicetree/bindings/mailbox/ \ - xlnx,zynqmp-ipi-mailbox.txt for typical controller that - is used to communicate with this System controllers. + Documentation/devicetree/bindings/mailbox/xlnx,zynqmp-ipi-mailbox.ya= ml + for typical controller that is used to communicate with + this System controllers. items: - description: tx channel - description: rx channel diff --git a/Documentation/devicetree/bindings/soc/qcom/qcom,aoss-qmp.yaml = b/Documentation/devicetree/bindings/soc/qcom/qcom,aoss-qmp.yaml index 8eaa04431d74..e238f100f8ff 100644 --- a/Documentation/devicetree/bindings/soc/qcom/qcom,aoss-qmp.yaml +++ b/Documentation/devicetree/bindings/soc/qcom/qcom,aoss-qmp.yaml @@ -69,7 +69,7 @@ properties: maxItems: 1 description: Reference to the mailbox representing the outgoing doorbell in APCS = for - this client, as described in mailbox/mailbox.txt + this client. =20 "#clock-cells": const: 0 --=20 2.55.0.691.gc56d675ccc-goog