From nobody Sat Apr 4 00:07:11 2026 Received: from mail-pl1-f170.google.com (mail-pl1-f170.google.com [209.85.214.170]) (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 6502640DFC3 for ; Sat, 21 Mar 2026 21:20:08 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.170 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1774128009; cv=none; b=acZ0c8iqI6B4SA1zbgBXzptJqFHILaFA9rRbVG+Yz1RhBZY6vQlnpcFb+hj6jm1NXQfRgl5Bvyp6m2IyUtJjUYguZEXDA3BEsIEk8rdLWBANaeZzX1zsthpr3fGnx9VpZR+glcH4gT6LwYv43VYfHV99BNYVQ5q9xshs7ybfLbY= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1774128009; c=relaxed/simple; bh=ZKk0y+cFIrZ/4uI+fWfBRwLXc6bjmfZ30cUW3aVa3zM=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:To:Cc; b=FUZkRJOez3YVye8WtDSGMmTdRCQF5uERg3F6THo/EUtbP7x+KaAM8dVKJyRci8Ww3XID972t+86Si3TirnHYRYzoqqqEbgvJAgDriA1HK3yRu2U7pHWkDWtyzn6bwjwQOGdLUoLJfBMne69JyMvcAot2BD++oQPn/MRgMHLBJ3g= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=hPjayRhi; arc=none smtp.client-ip=209.85.214.170 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="hPjayRhi" Received: by mail-pl1-f170.google.com with SMTP id d9443c01a7336-2aae146b604so19113515ad.3 for ; Sat, 21 Mar 2026 14:20:08 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1774128008; x=1774732808; darn=vger.kernel.org; h=cc:to:message-id:content-transfer-encoding:mime-version:subject :date:from:from:to:cc:subject:date:message-id:reply-to; bh=WhIdzTmYC8R2SfzqFRZ7Gsyo+REWy2RCSseFLAZzguo=; b=hPjayRhic4rLf2jNLlXpE6TizmgLhacAxioeH59vtTGPWwUXZFsxvFeGCXvwlJ2SBD ajkf+bEJPJx2S0Ly8ikI+ax8XwWXgUYFMQlSxTbKUsfiv0D0/WNdwsNnEDTT6uCsRO90 XqUEG4fYLJ5D3pdbjG6kyNhkyDSypa9KES/yRgRVqdLvRL3wtXZpXhJstFB2q1Eyb559 LORzoQ2V5WF9QWL8ILbYr3GdnoGuo93Io+N6kd03gjGtUDcSlc9tg0GhhxwAtEuRUMVG XkAo/4uEl875RDUpfve0MMeFIC6mRy9MgDFPoDRF4xRRxZifWn8gc8c8aZhEUdeMtF9j eHjQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1774128008; x=1774732808; h=cc:to: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=WhIdzTmYC8R2SfzqFRZ7Gsyo+REWy2RCSseFLAZzguo=; b=rWUww+cqVuQPI0yVwvAIonobQmb6gfNfl8050z67XGVN/38mlLXlqQtAsNtEuZtWEZ qKafFAAJAB9LlubfjDxAGOlj8RjYsdIlKtJPQ2UHReG0fBkQ1uVdzJ8I/Ng298stDY08 Hi368FkfSusC/SrvX3PunZTyrCf1jF0lbwbyDdk2ozUMXh2/O5LtqTmW8KyCth1YiXWt UHq5NxIBfYbKlPgbR6RK3PoO2nMfBMkMclGUgOiIySWhJekbY4WPbwEb3hm/TvylLarl wVd/RGl99uynLsR2G2QM6z9Ozyd/ezgrubqyDvSEouDmr+dpZuSKdePz6EAll8jVgARv vpiA== X-Forwarded-Encrypted: i=1; AJvYcCVHW+Kf8sMxbdY9eYHH6Df6d9IplPpmLcibQWHnZFh668mIrOE4oiRxwAATzes3Hkj46NYhCgVePvhoxeA=@vger.kernel.org X-Gm-Message-State: AOJu0Yzvk0CqJG/QZXZ1cYWbH7OiXGtnIb7sxskTlNs9nsgixdpdigRf 5mUdb0lU3w2qW/jtGkWYG64rDv+wIOJNUrFBUw19l2WPbkyYvMAo/Ely X-Gm-Gg: ATEYQzwZdsBoChM1ZpyWy2T6S1r0vvuEQU55aGYFEuEvfRQI+ySFyXmBI7cVQd4xaJq 6mnHNtM7WaVcVVZq+4WPPuYPVOib0DXGG9EmEiENx1ZSp+PweITXgHgHkEwoVy+Dkp6Ks4EESUN /WCarTzHTg4t0dtum1aCjpFsjV8MpCDZV5MWNL2+Vqii/n4xTi6mi8Gbz/lCdOvOwXwJldvaqjE CND71LFAWqSWNbuXNK1nHghIBpMBizrbmiWwgZDcN9g0DYM8U2U7Q85EiJqWfCxhuanFCnXhMro IHuKpe5glg1kBiTHoOkxFc1cVfLv8EeFVarwa/XlYWpFb9yVKqyuPfZfz6ffjoZLD9fNfPCH7Rz 5jy6xqzNgOhDXGxojRTUyZZNHjAqR+Rep/M/yJHkWSM2KxN8cMVNDnndFoKfpJL6B1i8EBl8EAh hwxCG+mjTFPGd8188UIb30cwT96w== X-Received: by 2002:a17:902:f690:b0:2b0:700e:fc9b with SMTP id d9443c01a7336-2b082793ebbmr78523325ad.34.1774128007628; Sat, 21 Mar 2026 14:20:07 -0700 (PDT) Received: from [127.0.1.1] ([103.216.213.160]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-2b083655b81sm82269275ad.41.2026.03.21.14.20.03 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 21 Mar 2026 14:20:07 -0700 (PDT) From: Atharv Dubey Date: Sun, 22 Mar 2026 02:50:01 +0530 Subject: [PATCH] mailbox: dt-bindings: mailbox: Convert to DT-SCHEMA 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: <20260322-mailbox-v1-1-c6251f18187c@gmail.com> X-B4-Tracking: v=1; b=H4sIAIALv2kC/6tWKk4tykwtVrJSqFYqSi3LLM7MzwNyDHUUlJIzE vPSU3UzU4B8JSMDIzMDYyMj3dzEzJyk/ApdQ7O0xDRjc0Pz5LRUJaDqgqLUtMwKsEnRsbW1AIT J/nxZAAAA X-Change-ID: 20260322-mailbox-16faf3717cfe To: Jassi Brar , Rob Herring , Krzysztof Kozlowski , Conor Dooley Cc: Jassi Brar , linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, Atharv Dubey X-Mailer: b4 0.14.3 X-Developer-Signature: v=1; a=ed25519-sha256; t=1774128003; l=4642; i=atharvd440@gmail.com; s=20260314; h=from:subject:message-id; bh=ZKk0y+cFIrZ/4uI+fWfBRwLXc6bjmfZ30cUW3aVa3zM=; b=CAktGuVb7uax32Ia6huj7xstfxG/NMPnbq6uUNxekUQvvunPpZIv7rfd8cXQ76wU/HSadUPEH TUuMPoevcelCs5hSMmoV2HOic7OwbdLUJB1DYe6qKXl2dCUQLs17aoR X-Developer-Key: i=atharvd440@gmail.com; a=ed25519; pk=T6i1xWOKT/RUSDYATSgyVG/4X7ac8jPjRSG1mMAcqVk= Convert the Generic Mailbox Controller and Client binding from text format to DT schema format. Signed-off-by: Atharv Dubey --- .../devicetree/bindings/mailbox/mailbox.txt | 60 ----------------- .../devicetree/bindings/mailbox/mailbox.yaml | 78 ++++++++++++++++++= ++++ 2 files changed, 78 insertions(+), 60 deletions(-) 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/mailbox.yaml b/Docum= entation/devicetree/bindings/mailbox/mailbox.yaml new file mode 100644 index 000000000000..856386f076b4 --- /dev/null +++ b/Documentation/devicetree/bindings/mailbox/mailbox.yaml @@ -0,0 +1,78 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/mailbox/mailbox.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Generic Mailbox Controller and Client + +maintainers: + - Jassi Brar + +description: + Generic binding to provide a way for Mailbox controller drivers to + assign appropriate mailbox channel to client drivers. + +select: false + +properties: + "#mbox-cells": + minimum: 1 + description: + Number of cells in a mailbox specifier. Must be at least 1. + + mboxes: + $ref: /schemas/types.yaml#/definitions/phandle-array + description: + List of phandle and mailbox channel specifiers. + + mbox-names: + $ref: /schemas/types.yaml#/definitions/string-array + description: + List of identifier strings for each mailbox channel. + + shmem: + $ref: /schemas/types.yaml#/definitions/phandle-array + description: + List of phandles 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. + +additionalProperties: true + +examples: + # Mailbox Controller + - | + mailbox: mailbox { + #mbox-cells =3D <1>; + }; + + # Mailbox Client + - | + pwr_cntrl: power { + mbox-names =3D "pwr-ctrl", "rpc"; + mboxes =3D <&mailbox 0>, <&mailbox 1>; + }; + + # Mailbox Client with shared memory + - | + 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: scmi-sram@0 { + compatible =3D "arm,scmi-shmem"; + reg =3D <0x0 0x200>; + }; + }; + + client@2e000000 { + reg =3D <0x2e000000 0x400>; + mboxes =3D <&mailbox 0>; + shmem =3D <&cl_shmem>; + }; --- base-commit: c612261bedd6bbab7109f798715e449c9d20ff2f change-id: 20260322-mailbox-16faf3717cfe Best regards, --=20 Atharv Dubey