Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

dt-bindings:i2c:i2c-gate: txt to yaml conversion

This file provides very little in the way of actual schema but
does provide a convenient intro to what an i2c-gate node actually
represents.

Signed-off-by: Jonathan Cameron <Jonathan.Cameron@huawei.com>
Cc: Peter Rosin <peda@axentia.se>
Cc: Wolfram Sang <wsa@the-dreams.de>
Link: https://lore.kernel.org/r/20201031181801.742585-2-jic23@kernel.org
Link: https://lore.kernel.org/r/20201128173343.390165-2-jic23@kernel.org
Signed-off-by: Rob Herring <robh@kernel.org>

authored by

Jonathan Cameron and committed by
Rob Herring
9c8421e2 e5dddbed

+39 -41
-41
Documentation/devicetree/bindings/i2c/i2c-gate.txt
··· 1 - An i2c gate is useful to e.g. reduce the digital noise for RF tuners connected 2 - to the i2c bus. Gates are similar to arbitrators in that you need to perform 3 - some kind of operation to access the i2c bus past the arbitrator/gate, but 4 - there are no competing masters to consider for gates and therefore there is 5 - no arbitration happening for gates. 6 - 7 - Common i2c gate properties. 8 - 9 - - i2c-gate child node 10 - 11 - Required properties for the i2c-gate child node: 12 - - #address-cells = <1>; 13 - - #size-cells = <0>; 14 - 15 - Optional properties for i2c-gate child node: 16 - - Child nodes conforming to i2c bus binding 17 - 18 - 19 - Example : 20 - 21 - /* 22 - An Invensense mpu9150 at address 0x68 featuring an on-chip Asahi 23 - Kasei ak8975 compass behind a gate. 24 - */ 25 - 26 - mpu9150@68 { 27 - compatible = "invensense,mpu9150"; 28 - reg = <0x68>; 29 - interrupt-parent = <&gpio1>; 30 - interrupts = <18 1>; 31 - 32 - i2c-gate { 33 - #address-cells = <1>; 34 - #size-cells = <0>; 35 - 36 - ax8975@c { 37 - compatible = "ak,ak8975"; 38 - reg = <0x0c>; 39 - }; 40 - }; 41 - };
+39
Documentation/devicetree/bindings/i2c/i2c-gate.yaml
··· 1 + # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) 2 + %YAML 1.2 3 + --- 4 + $id: http://devicetree.org/schemas/i2c/i2c-gate.yaml# 5 + $schema: http://devicetree.org/meta-schemas/core.yaml# 6 + 7 + title: Common i2c gate properties 8 + 9 + maintainers: 10 + - Peter Rosin <peda@axentia.se> 11 + 12 + description: | 13 + An i2c gate is useful to e.g. reduce the digital noise for RF tuners connected 14 + to the i2c bus. Gates are similar to arbitrators in that you need to perform 15 + some kind of operation to access the i2c bus past the arbitrator/gate, but 16 + there are no competing masters to consider for gates and therefore there is 17 + no arbitration happening for gates. 18 + 19 + allOf: 20 + - $ref: /schemas/i2c/i2c-controller.yaml 21 + 22 + properties: 23 + $nodename: 24 + const: i2c-gate 25 + 26 + additionalProperties: true 27 + 28 + examples: 29 + - | 30 + i2c-gate { 31 + #address-cells = <1>; 32 + #size-cells = <0>; 33 + ak8975@c { 34 + compatible = "ak,ak8975"; 35 + reg = <0x0c>; 36 + }; 37 + }; 38 + ... 39 +