Bindings/extcon/extcon-usbc-cros-ec.yaml

   1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/extcon/extcon-usbc-cros-ec.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: ChromeOS EC USB Type-C cable and accessories detection
   8
   9 maintainers:
  10   - Benson Leung <bleung@chromium.org>
  11   - Enric Balletbo i Serra <enric.balletbo@collabora.com>
  12
  13 description: |
  14   On ChromeOS systems with USB Type C ports, the ChromeOS Embedded Controller is
  15   able to detect the state of external accessories such as display adapters
  16   or USB devices when said accessories are attached or detached.
  17   The node for this device must be under a cros-ec node like google,cros-ec-spi
  18   or google,cros-ec-i2c.
  19
  20 properties:
  21   compatible:
  22     const: google,extcon-usbc-cros-ec
  23
  24   google,usb-port-id:
  25     allOf:
  26       - $ref: /schemas/types.yaml#/definitions/uint32
  27     description: the port id
  28     minimum: 0
  29     maximum: 255
  30
  31 required:
  32   - compatible
  33   - google,usb-port-id
  34
  35 additionalProperties: false
  36
  37 examples:
  38   - |
  39     spi0 {
  40         #address-cells = <1>;
  41         #size-cells = <0>;
  42         cros-ec@0 {
  43             compatible = "google,cros-ec-spi";
  44             reg = <0>;
  45
  46             usbc_extcon0: extcon0 {
  47                 compatible = "google,extcon-usbc-cros-ec";
  48                 google,usb-port-id = <0>;
  49             };
  50
  51             usbc_extcon1: extcon1 {
  52                 compatible = "google,extcon-usbc-cros-ec";
  53                 google,usb-port-id = <1>;
  54             };
  55         };
  56     };