From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pf1-f171.google.com (mail-pf1-f171.google.com [209.85.210.171]) (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 16938262FD8 for ; Mon, 18 Aug 2025 04:11:14 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.171 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755490276; cv=none; b=BQFzRaWiox7KwUXHLYYbK+VQ8PfcteEnM7iXkGFpvpUPdwWR4L55aTBUT/LUinWSneDtb5ZjyRAa93MvZJhIKrRQvsK0nEWlOomar6TGf/LrW5nnPabUQJ7LihlECT/6HTsaN3/BVNIsG7EMWf5xTuwxqB8imlD4MdgUS/AQMoU= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755490276; c=relaxed/simple; bh=dNnAUr+2trSDmCnQ7YgS/ZuDyO2yPRTU4DJLikPf2R4=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=Xy99iygjGjRXTe0wrEyR11Sz7WIbKG29vCLL5ZY4qbxsKDiHwIBj6Rhp83vSwRVpPykU1hnB2Xcc9bunY9c5QYZTeI4tzfiuzSM4BJWd4E7YPPf9zgKrS6IVaGkbhRsXLXfi9u1rB3FRXeYn4MOkSTyEDtwTtM6il/gqhxsbZKc= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=ventanamicro.com; spf=pass smtp.mailfrom=ventanamicro.com; dkim=pass (2048-bit key) header.d=ventanamicro.com header.i=@ventanamicro.com header.b=L7yecv++; arc=none smtp.client-ip=209.85.210.171 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=ventanamicro.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=ventanamicro.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=ventanamicro.com header.i=@ventanamicro.com header.b="L7yecv++" Received: by mail-pf1-f171.google.com with SMTP id d2e1a72fcca58-76e6cbb991aso266296b3a.1 for ; Sun, 17 Aug 2025 21:11:14 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ventanamicro.com; s=google; t=1755490274; x=1756095074; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=X+ejybDVQT/aGz6Lcll3wkVRKaiK+174ISdzaVIOfkE=; b=L7yecv++YfTdiQH3LP8sXJz/zFgqIUvFc3RdS+eMbyZXCedJnF/iQFTlcKlAYwckxx CHUHCiwOYtO2cBlRIQle7Yt+7hoPtJnaVnanl+cd50qn/YOjve7upvXbJ/sMR+fRJ+HI tT7UqT2HCRtvewhktbRzGHvMHUk/F0o/oDGL1nP5vJqE3eiF4yKxfk935Jj5PxvZMofa wgztZwZ5A/R5WsoyHjL7n2DQrKchQGCCCRMBduQtNxKR6xf9nw50U+wo0w4gDnONTg0a eqAo7fAic2YcFG/SO0YYHEKpLJuZFWpTvwfr7fnhgmkTE6qx+3LW4t1NEtpSvI3JYQ9a vH9Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1755490274; x=1756095074; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=X+ejybDVQT/aGz6Lcll3wkVRKaiK+174ISdzaVIOfkE=; b=EJkdCEKOYusonqEsXtq8vrbGrcR+KkcwAsSPkr0jUukDUmEhtgb4QUWgDbKFTy4+sz rp6cINMKJ/i1v+fbROH+XaQ092LH4+zfgY+7dLlCJ8o/XeHIHWMR/6lwuLdY4ena8X6U xR65E2GT0sFKXYhr+Dt9DND8aNoLlnjTx01IFfD9a2RMZWKUI2lA4C791++iRp9pYcYk 8IoId7Na5MTHqKaWaIgaBxIxpdkcbsL05xEX8NE0X8de3oPQ0Wl+vg/vOnFOOXO4bQaN WyknyIb2XOsa8ujqOpCbdEDrnBevG5cSBbjWHL8xUTcXOe1V84M8oZ2Tp0LQruARoiYI 5VNQ== X-Forwarded-Encrypted: i=1; AJvYcCUysf8BqxMgb3ekJ3gWcqrWX13+k38Xj9R23pPRsI92KZOUV6O9mlN+tAT1rMw0gVj4Plu0VcYyJWtm@vger.kernel.org X-Gm-Message-State: AOJu0YwR2mYTmvg3/UrI22/Uuv/yYfqiivZHL49wzmDsLlGxYCN1CuoI MveQevSsAwnq/1XUtZ/9RAaK5N48EPT3hkV0jZBX1g+B23EVd7Af8nyYve8j5nBQJco= X-Gm-Gg: ASbGncvoCWhjEEHMa6IF00B/wtkKUI/bR6EpMGSLCm56NQBqHgDdiyAi6pIiJY8mOeS Kw/BeoUkCr7mhmEzJyUIUjFXHvuShpEPZQRZ4bK3lVEdnlEp9iwtM+xhmNFeNku43BY4u0Xcl70 Xu5+gldo4NwDNUem1KVYZjTUXmgPlYLP7OVpXHXA/ghxwGvi8SHs3EHhSsoOhNDzFNrr/ysh5Co Uhd7Tajtn4rDRT3gBbVmYce1KwDMa1f4/8DKpVboYjV/dFsKmU+yAGDi2sP3csRGBbJRUGtZpxx B1fZ+GFxISrV5K1Ql2DhKSL8wO1e549UphG2TLOBymslz6RTd5Fx5VlixhFcdz4QNTgbN/ZsXR7 WStPc4b5cAqAlQvlS/wD972Hz6iqgPpKZnlPkZcR8NiYIu1JX+3epEA== X-Google-Smtp-Source: AGHT+IEUmCBJqt58NVIHDPHHca9PR8O5TrOG4aqKnEqH28bGTGwWCZIcGW0W6/qShoAW7F8CGp1xoA== X-Received: by 2002:a05:6a20:9183:b0:23d:9dd0:b2ce with SMTP id adf61e73a8af0-240d2f668bfmr14194804637.44.1755490273971; Sun, 17 Aug 2025 21:11:13 -0700 (PDT) Received: from localhost.localdomain ([122.171.17.53]) by smtp.gmail.com with ESMTPSA id 98e67ed59e1d1-32343c70356sm6560972a91.25.2025.08.17.21.11.05 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 17 Aug 2025 21:11:13 -0700 (PDT) From: Anup Patel To: Michael Turquette , Stephen Boyd , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Jassi Brar , Thomas Gleixner , "Rafael J . Wysocki" , Mika Westerberg , Andy Shevchenko , Linus Walleij , Bartosz Golaszewski , =?UTF-8?q?Uwe=20Kleine-K=C3=B6nig?= Cc: Palmer Dabbelt , Paul Walmsley , Alexandre Ghiti , Len Brown , Sunil V L , Rahul Pathak , Leyfoon Tan , Atish Patra , Andrew Jones , Samuel Holland , Anup Patel , linux-clk@vger.kernel.org, devicetree@vger.kernel.org, linux-acpi@vger.kernel.org, linux-riscv@lists.infradead.org, linux-kernel@vger.kernel.org, Anup Patel , Conor Dooley Subject: [PATCH v10 08/24] dt-bindings: clock: Add RPMI clock service message proxy bindings Date: Mon, 18 Aug 2025 09:39:04 +0530 Message-ID: <20250818040920.272664-9-apatel@ventanamicro.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20250818040920.272664-1-apatel@ventanamicro.com> References: <20250818040920.272664-1-apatel@ventanamicro.com> Precedence: bulk X-Mailing-List: devicetree@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Add device tree bindings for the RPMI clock service group based message proxy implemented by the SBI implementation (machine mode firmware or hypervisor). The RPMI clock service group is defined by the RISC-V platform management interface (RPMI) specification. Reviewed-by: Conor Dooley Signed-off-by: Anup Patel --- .../bindings/clock/riscv,rpmi-mpxy-clock.yaml | 64 +++++++++++++++++++ 1 file changed, 64 insertions(+) create mode 100644 Documentation/devicetree/bindings/clock/riscv,rpmi-mpxy-clock.yaml diff --git a/Documentation/devicetree/bindings/clock/riscv,rpmi-mpxy-clock.yaml b/Documentation/devicetree/bindings/clock/riscv,rpmi-mpxy-clock.yaml new file mode 100644 index 000000000000..76f2a1b3d30d --- /dev/null +++ b/Documentation/devicetree/bindings/clock/riscv,rpmi-mpxy-clock.yaml @@ -0,0 +1,64 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/clock/riscv,rpmi-mpxy-clock.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: RISC-V RPMI clock service group based message proxy + +maintainers: + - Anup Patel + +description: | + The RISC-V Platform Management Interface (RPMI) [1] defines a + messaging protocol which is modular and extensible. The supervisor + software can send/receive RPMI messages via SBI MPXY extension [2] + or some dedicated supervisor-mode RPMI transport. + + The RPMI specification [1] defines clock service group for accessing + system clocks managed by a platform microcontroller. The SBI implementation + (machine mode firmware or hypervisor) can implement an SBI MPXY channel + to allow RPMI clock service group access to the supervisor software. + + =========================================== + References + =========================================== + + [1] RISC-V Platform Management Interface (RPMI) v1.0 (or higher) + https://github.com/riscv-non-isa/riscv-rpmi/releases + + [2] RISC-V Supervisor Binary Interface (SBI) v3.0 (or higher) + https://github.com/riscv-non-isa/riscv-sbi-doc/releases + +properties: + compatible: + description: + Intended for use by the SBI implementation. + const: riscv,rpmi-mpxy-clock + + mboxes: + maxItems: 1 + description: + Mailbox channel of the underlying RPMI transport. + + riscv,sbi-mpxy-channel-id: + $ref: /schemas/types.yaml#/definitions/uint32 + description: + The SBI MPXY channel id to be used for providing RPMI access to + the supervisor software. + +required: + - compatible + - mboxes + - riscv,sbi-mpxy-channel-id + +additionalProperties: false + +examples: + - | + clock-service { + compatible = "riscv,rpmi-mpxy-clock"; + mboxes = <&rpmi_shmem_mbox 0x8>; + riscv,sbi-mpxy-channel-id = <0x1000>; + }; +... -- 2.43.0