Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18;
IronPort-SDR: mq6pRgjQHWnSNjfzJ/wJgEaiaxlKgQDmGbBPPUTFCRAbsUVv4SevaC5cClzy4vgn6HCi0BNPHY
 fP8nb9Egqy+/3T6Rx3js0aSUHL5xCVCz1+3yJeM3S71pdR+laKsJeXPy5fucWn1I73yxHe/s3j
 0OduUVTB/Anyda9/AwVZcCsIpH/31ypyHl+Gsrd/nQ22k3Nb3Z6BzzUuEL2WLknxar5vMaSEfe
 7zBfjlaE/+5kspBEU1adjR8EOu32hKt0NyGjdWYLMmIsAslbbgDJS6e1UuqqHa2e4tDLoS82Kv
 e377XXtYU+3W2zAwzaMYUozg
From:   Horatiu Vultur <horatiu.vultur@microchip.com>
To:     <peda@axentia.se>, <robh+dt@kernel.org>,
        <linux-i2c@vger.kernel.org>, <devicetree@vger.kernel.org>,
        <linux-kernel@vger.kernel.org>
CC:     Horatiu Vultur <horatiu.vultur@microchip.com>
Subject: [PATCH v4 1/2] dt-bindings: i2c-mux: Add property for settle time
Date:   Wed, 3 Nov 2021 10:18:38 +0100
Message-ID: <20211103091839.1665672-2-horatiu.vultur@microchip.com>
In-Reply-To: <20211103091839.1665672-1-horatiu.vultur@microchip.com>
References: <20211103091839.1665672-1-horatiu.vultur@microchip.com>
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
Content-Type: text/plain
Precedence: bulk

Some HW requires some time for the signals to settle after the muxing is
changed. Allow this time to be specified in device tree.

Signed-off-by: Horatiu Vultur <horatiu.vultur@microchip.com>
---
 Documentation/devicetree/bindings/i2c/i2c-mux.yaml | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/Documentation/devicetree/bindings/i2c/i2c-mux.yaml b/Documentation/devicetree/bindings/i2c/i2c-mux.yaml
index 24cac36037f5..4c81e56d02f7 100644
--- a/Documentation/devicetree/bindings/i2c/i2c-mux.yaml
+++ b/Documentation/devicetree/bindings/i2c/i2c-mux.yaml
@@ -19,6 +19,11 @@ description: |+
   populating the i2c child busses.  If an 'i2c-mux' subnode is present, only
   subnodes of this will be considered as i2c child busses.
 
+  Optional properties may not be supported by all drivers. However, if a driver
+  wants to support one of the below features, it should adopt these bindings.
+
+select: false
+
 properties:
   $nodename:
     pattern: '^(i2c-?)?mux'
@@ -29,6 +34,11 @@ properties:
   '#size-cells':
     const: 0
 
+  settle-time-us:
+    default: 0
+    description:
+      The time required for the signals to settle.
+
 patternProperties:
   '^i2c@[0-9a-f]+$':
     $ref: /schemas/i2c/i2c-controller.yaml
@@ -41,6 +51,10 @@ patternProperties:
 
 additionalProperties: true
 
+required:
+  - '#address-cells'
+  - '#size-cells'
+
 examples:
   - |
     /*
-- 
2.33.0