146b57806SIkjoon Jang# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) 246b57806SIkjoon Jang%YAML 1.2 346b57806SIkjoon Jang--- 446b57806SIkjoon Jang$id: http://devicetree.org/schemas/mfd/google,cros-ec.yaml# 546b57806SIkjoon Jang$schema: http://devicetree.org/meta-schemas/core.yaml# 646b57806SIkjoon Jang 746b57806SIkjoon Jangtitle: ChromeOS Embedded Controller 846b57806SIkjoon Jang 946b57806SIkjoon Jangmaintainers: 1046b57806SIkjoon Jang - Benson Leung <bleung@chromium.org> 1146b57806SIkjoon Jang - Enric Balletbo i Serra <enric.balletbo@collabora.com> 1246b57806SIkjoon Jang - Guenter Roeck <groeck@chromium.org> 1346b57806SIkjoon Jang 1446b57806SIkjoon Jangdescription: 1546b57806SIkjoon Jang Google's ChromeOS EC is a microcontroller which talks to the AP and 1646b57806SIkjoon Jang implements various functions such as keyboard and battery charging. 1746b57806SIkjoon Jang The EC can be connected through various interfaces (I2C, SPI, and others) 1846b57806SIkjoon Jang and the compatible string specifies which interface is being used. 1946b57806SIkjoon Jang 2046b57806SIkjoon Jangproperties: 2146b57806SIkjoon Jang compatible: 2246b57806SIkjoon Jang oneOf: 2346b57806SIkjoon Jang - description: 2446b57806SIkjoon Jang For implementations of the EC is connected through I2C. 2546b57806SIkjoon Jang const: google,cros-ec-i2c 2646b57806SIkjoon Jang - description: 2746b57806SIkjoon Jang For implementations of the EC is connected through SPI. 2846b57806SIkjoon Jang const: google,cros-ec-spi 2946b57806SIkjoon Jang - description: 3046b57806SIkjoon Jang For implementations of the EC is connected through RPMSG. 3146b57806SIkjoon Jang const: google,cros-ec-rpmsg 3246b57806SIkjoon Jang 3346b57806SIkjoon Jang google,cros-ec-spi-pre-delay: 3446b57806SIkjoon Jang description: 3546b57806SIkjoon Jang This property specifies the delay in usecs between the 3646b57806SIkjoon Jang assertion of the CS and the first clock pulse. 3746b57806SIkjoon Jang allOf: 3846b57806SIkjoon Jang - $ref: /schemas/types.yaml#/definitions/uint32 3946b57806SIkjoon Jang - default: 0 4046b57806SIkjoon Jang - minimum: 0 4146b57806SIkjoon Jang 4246b57806SIkjoon Jang google,cros-ec-spi-msg-delay: 4346b57806SIkjoon Jang description: 4446b57806SIkjoon Jang This property specifies the delay in usecs between messages. 4546b57806SIkjoon Jang allOf: 4646b57806SIkjoon Jang - $ref: /schemas/types.yaml#/definitions/uint32 4746b57806SIkjoon Jang - default: 0 4846b57806SIkjoon Jang - minimum: 0 4946b57806SIkjoon Jang 5046b57806SIkjoon Jang google,has-vbc-nvram: 5146b57806SIkjoon Jang description: 5246b57806SIkjoon Jang Some implementations of the EC include a small nvram space used to 5346b57806SIkjoon Jang store verified boot context data. This boolean flag is used to specify 5446b57806SIkjoon Jang whether this nvram is present or not. 5546b57806SIkjoon Jang type: boolean 5646b57806SIkjoon Jang 5746b57806SIkjoon Jang spi-max-frequency: 5846b57806SIkjoon Jang description: Maximum SPI frequency of the device in Hz. 5946b57806SIkjoon Jang 6046b57806SIkjoon Jang reg: 6146b57806SIkjoon Jang maxItems: 1 6246b57806SIkjoon Jang 6346b57806SIkjoon Jang interrupts: 6446b57806SIkjoon Jang maxItems: 1 6546b57806SIkjoon Jang 6646b57806SIkjoon Jangrequired: 6746b57806SIkjoon Jang - compatible 6846b57806SIkjoon Jang 6946b57806SIkjoon Jangif: 7046b57806SIkjoon Jang properties: 7146b57806SIkjoon Jang compatible: 7246b57806SIkjoon Jang contains: 7346b57806SIkjoon Jang enum: 7446b57806SIkjoon Jang - google,cros-ec-i2c 7546b57806SIkjoon Jang - google,cros-ec-rpmsg 7646b57806SIkjoon Jangthen: 7746b57806SIkjoon Jang properties: 7846b57806SIkjoon Jang google,cros-ec-spi-pre-delay: false 7946b57806SIkjoon Jang google,cros-ec-spi-msg-delay: false 8046b57806SIkjoon Jang spi-max-frequency: false 8146b57806SIkjoon Jang 8246b57806SIkjoon JangadditionalProperties: false 8346b57806SIkjoon Jang 8446b57806SIkjoon Jangexamples: 8546b57806SIkjoon Jang # Example for I2C 8646b57806SIkjoon Jang - | 8746b57806SIkjoon Jang #include <dt-bindings/gpio/gpio.h> 8846b57806SIkjoon Jang #include <dt-bindings/interrupt-controller/irq.h> 8946b57806SIkjoon Jang 9046b57806SIkjoon Jang i2c0 { 9146b57806SIkjoon Jang #address-cells = <1>; 9246b57806SIkjoon Jang #size-cells = <0>; 9346b57806SIkjoon Jang 9446b57806SIkjoon Jang cros-ec@1e { 9546b57806SIkjoon Jang compatible = "google,cros-ec-i2c"; 9646b57806SIkjoon Jang reg = <0x1e>; 9746b57806SIkjoon Jang interrupts = <6 0>; 9846b57806SIkjoon Jang interrupt-parent = <&gpio0>; 9946b57806SIkjoon Jang }; 10046b57806SIkjoon Jang }; 10146b57806SIkjoon Jang 10246b57806SIkjoon Jang # Example for SPI 10346b57806SIkjoon Jang - | 10446b57806SIkjoon Jang #include <dt-bindings/gpio/gpio.h> 10546b57806SIkjoon Jang #include <dt-bindings/interrupt-controller/irq.h> 10646b57806SIkjoon Jang 10746b57806SIkjoon Jang spi0 { 10846b57806SIkjoon Jang #address-cells = <1>; 10946b57806SIkjoon Jang #size-cells = <0>; 11046b57806SIkjoon Jang 11146b57806SIkjoon Jang cros-ec@0 { 11246b57806SIkjoon Jang compatible = "google,cros-ec-spi"; 11346b57806SIkjoon Jang reg = <0x0>; 11446b57806SIkjoon Jang google,cros-ec-spi-msg-delay = <30>; 11546b57806SIkjoon Jang google,cros-ec-spi-pre-delay = <10>; 11646b57806SIkjoon Jang interrupts = <99 0>; 11746b57806SIkjoon Jang interrupt-parent = <&gpio7>; 11846b57806SIkjoon Jang spi-max-frequency = <5000000>; 11946b57806SIkjoon Jang }; 12046b57806SIkjoon Jang }; 12146b57806SIkjoon Jang 12246b57806SIkjoon Jang # Example for RPMSG 12346b57806SIkjoon Jang - | 12446b57806SIkjoon Jang scp0 { 12546b57806SIkjoon Jang cros-ec { 12646b57806SIkjoon Jang compatible = "google,cros-ec-rpmsg"; 12746b57806SIkjoon Jang }; 12846b57806SIkjoon Jang }; 12946b57806SIkjoon Jang... 130