From 07419175fdb507be2c9d3aaf4b7d18306a336348 Mon Sep 17 00:00:00 2001
From: Phil Elwell <phil@raspberrypi.com>
Date: Wed, 2 Aug 2023 11:38:03 +0100
Subject: [PATCH] dt-bindings: input: Add bindings for raspberrypi-button

Add bindings for the firmware-based button driver.

Signed-off-by: Phil Elwell <phil@raspberrypi.com>
---
 .../input/raspberrypi,firmware-button.yaml    | 47 +++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/input/raspberrypi,firmware-button.yaml

--- /dev/null
+++ b/Documentation/devicetree/bindings/input/raspberrypi,firmware-button.yaml
@@ -0,0 +1,47 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/input/raspberrypi,firmware-button.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Raspberry Pi firmware buttons
+
+maintainers:
+  - Phil Elwell <phil@raspberrypi.com>
+
+description: >
+  The Raspberry Pi 5 firmware exposes the state of the power button. The
+  raspberrypi-button driver generates a keycode when it is pressed.
+
+properties:
+  compatible:
+    enum:
+      - raspberrypi,firmware-button
+
+  id:
+    description: A numeric identifier of the button
+
+  label:
+    description: Descriptive name of the button.
+
+  linux,code:
+    description: Key code to emit.
+
+required:
+  - compatible
+  - linux,code
+
+additionalProperties: false
+
+examples:
+  - |
+    #include <dt-bindings/input/raspberrypi-button.h>
+
+    pwr_button: pwr_button {
+        compatible = "raspberrypi,firmware-button";
+        id = <RASPBERRYPI_BUTTON_POWER>;
+        label = "pwr_button";
+        linux,code = <116>; // KEY_POWER
+    };
+
+...