mirror of https://lore.kernel.org/lkml/
 help / color / mirror / Atom feed
From: "Chalios, Babis" <bchalios@amazon.es>
To: "richardcochran@gmail.com" <richardcochran@gmail.com>,
	"dwmw2@infradead.org" <dwmw2@infradead.org>,
	"andrew+netdev@lunn.ch" <andrew+netdev@lunn.ch>,
	"davem@davemloft.net" <davem@davemloft.net>,
	"edumazet@google.com" <edumazet@google.com>,
	"kuba@kernel.org" <kuba@kernel.org>,
	"pabeni@redhat.com" <pabeni@redhat.com>,
	"netdev@vger.kernel.org" <netdev@vger.kernel.org>,
	"linux-kernel@vger.kernel.org" <linux-kernel@vger.kernel.org>
Cc: "Chalios, Babis" <bchalios@amazon.es>, "Graf (AWS),
	Alexander" <graf@amazon.de>,
	"mzxreary@0pointer.de" <mzxreary@0pointer.de>,
	"Woodhouse, David" <dwmw@amazon.co.uk>
Subject: [PATCH v2 3/4] dt-bindings: clock: Add device tree bindings for vmclock
Date: Tue, 2 Dec 2025 20:11:55 +0000	[thread overview]
Message-ID: <20251202201118.20209-4-bchalios@amazon.es> (raw)
In-Reply-To: <20251202201118.20209-1-bchalios@amazon.es>

From: David Woodhouse <dwmw@amazon.co.uk>

Add device tree bindings for the vmclock device, similar to the existing
vmgenid bindings. The vmclock device provides a PTP clock source and
precise timekeeping across live migration and snapshot/restore operations.

The bindings specify a required memory region containing the vmclock_abi
structure and an optional interrupt for clock disruption notifications.

Signed-off-by: David Woodhouse <dwmw@amazon.co.uk>
Signed-off-by: Babis Chalios <bchalios@amazon.es>
---
 .../bindings/clock/amazon,vmclock.yaml        | 46 +++++++++++++++++++
 1 file changed, 46 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/clock/amazon,vmclock.yaml

diff --git a/Documentation/devicetree/bindings/clock/amazon,vmclock.yaml b/Documentation/devicetree/bindings/clock/amazon,vmclock.yaml
new file mode 100644
index 000000000000..f7dfa022bf6f
--- /dev/null
+++ b/Documentation/devicetree/bindings/clock/amazon,vmclock.yaml
@@ -0,0 +1,46 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/clock/amazon,vmclock.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Virtual Machine Clock
+
+maintainers:
+  - David Woodhouse <dwmw2@infradead.org>
+
+description:
+  The vmclock device provides a precise clock source and allows for
+  accurate timekeeping across live migration and snapshot/restore
+  operations. The full specification of the shared data structure
+  is available at https://david.woodhou.se/VMClock.pdf
+
+properties:
+  compatible:
+    const: amazon,vmclock
+
+  reg:
+    description:
+      Specifies the shared memory region containing the vmclock_abi structure.
+    maxItems: 1
+
+  interrupts:
+    description:
+      Interrupt used to notify when the contents of the vmclock_abi structure
+      have been updated.
+    maxItems: 1
+
+required:
+  - compatible
+  - reg
+
+additionalProperties: false
+
+examples:
+  - |
+    #include <dt-bindings/interrupt-controller/arm-gic.h>
+    vmclock@80000000 {
+      compatible = "amazon,vmclock";
+      reg = <0x80000000 0x1000>;
+      interrupts = <GIC_SPI 36 IRQ_TYPE_EDGE_RISING>;
+    };
-- 
2.34.1


  parent reply	other threads:[~2025-12-02 20:12 UTC|newest]

Thread overview: 10+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2025-12-02 20:11 [PATCH v2 0/4] ptp: vmclock: Add VM generation counter and ACPI notification Chalios, Babis
2025-12-02 20:11 ` [PATCH v2 1/4] ptp: vmclock: add vm generation counter Chalios, Babis
2025-12-02 20:11 ` [PATCH v2 2/4] ptp: vmclock: support device notifications Chalios, Babis
2025-12-02 23:45   ` David Woodhouse
2025-12-02 20:11 ` Chalios, Babis [this message]
2025-12-03  7:22   ` [PATCH v2 3/4] dt-bindings: clock: Add device tree bindings for vmclock Krzysztof Kozlowski
2025-12-03  7:25     ` Krzysztof Kozlowski
2025-12-03  9:14       ` David Woodhouse
2025-12-02 20:12 ` [PATCH v2 4/4] ptp: ptp_vmclock: Add device tree support Chalios, Babis
2025-12-02 23:43   ` David Woodhouse

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20251202201118.20209-4-bchalios@amazon.es \
    --to=bchalios@amazon.es \
    --cc=andrew+netdev@lunn.ch \
    --cc=davem@davemloft.net \
    --cc=dwmw2@infradead.org \
    --cc=dwmw@amazon.co.uk \
    --cc=edumazet@google.com \
    --cc=graf@amazon.de \
    --cc=kuba@kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=mzxreary@0pointer.de \
    --cc=netdev@vger.kernel.org \
    --cc=pabeni@redhat.com \
    --cc=richardcochran@gmail.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox

all inboxes | Powered by JetHome®