xref: /linux/Documentation/devicetree/bindings/embedded-controller/microsoft,surface-sam.yaml (revision 4f38da1f027ea2c9f01bb71daa7a299c191b6940)
1*3d6a17fcSKrzysztof Kozlowski# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2*3d6a17fcSKrzysztof Kozlowski%YAML 1.2
3*3d6a17fcSKrzysztof Kozlowski---
4*3d6a17fcSKrzysztof Kozlowski$id: http://devicetree.org/schemas/embedded-controller/microsoft,surface-sam.yaml#
5*3d6a17fcSKrzysztof Kozlowski$schema: http://devicetree.org/meta-schemas/core.yaml#
6*3d6a17fcSKrzysztof Kozlowski
7*3d6a17fcSKrzysztof Kozlowskititle: Surface System Aggregator Module (SAM, SSAM)
8*3d6a17fcSKrzysztof Kozlowski
9*3d6a17fcSKrzysztof Kozlowskimaintainers:
10*3d6a17fcSKrzysztof Kozlowski  - Konrad Dybcio <konradybcio@kernel.org>
11*3d6a17fcSKrzysztof Kozlowski
12*3d6a17fcSKrzysztof Kozlowskidescription: |
13*3d6a17fcSKrzysztof Kozlowski  Surface devices use a standardized embedded controller to let the
14*3d6a17fcSKrzysztof Kozlowski  operating system interface with various hardware functions. The
15*3d6a17fcSKrzysztof Kozlowski  specific functionalities are modeled as subdevices and matched on
16*3d6a17fcSKrzysztof Kozlowski  five levels: domain, category, target, instance and function.
17*3d6a17fcSKrzysztof Kozlowski
18*3d6a17fcSKrzysztof Kozlowskiproperties:
19*3d6a17fcSKrzysztof Kozlowski  compatible:
20*3d6a17fcSKrzysztof Kozlowski    const: microsoft,surface-sam
21*3d6a17fcSKrzysztof Kozlowski
22*3d6a17fcSKrzysztof Kozlowski  interrupts:
23*3d6a17fcSKrzysztof Kozlowski    maxItems: 1
24*3d6a17fcSKrzysztof Kozlowski
25*3d6a17fcSKrzysztof Kozlowski  current-speed: true
26*3d6a17fcSKrzysztof Kozlowski
27*3d6a17fcSKrzysztof Kozlowskirequired:
28*3d6a17fcSKrzysztof Kozlowski  - compatible
29*3d6a17fcSKrzysztof Kozlowski  - interrupts
30*3d6a17fcSKrzysztof Kozlowski
31*3d6a17fcSKrzysztof KozlowskiadditionalProperties: false
32*3d6a17fcSKrzysztof Kozlowski
33*3d6a17fcSKrzysztof Kozlowskiexamples:
34*3d6a17fcSKrzysztof Kozlowski  - |
35*3d6a17fcSKrzysztof Kozlowski    #include <dt-bindings/interrupt-controller/irq.h>
36*3d6a17fcSKrzysztof Kozlowski    uart {
37*3d6a17fcSKrzysztof Kozlowski        embedded-controller {
38*3d6a17fcSKrzysztof Kozlowski            compatible = "microsoft,surface-sam";
39*3d6a17fcSKrzysztof Kozlowski
40*3d6a17fcSKrzysztof Kozlowski            interrupts-extended = <&tlmm 91 IRQ_TYPE_EDGE_RISING>;
41*3d6a17fcSKrzysztof Kozlowski
42*3d6a17fcSKrzysztof Kozlowski            pinctrl-0 = <&ssam_state>;
43*3d6a17fcSKrzysztof Kozlowski            pinctrl-names = "default";
44*3d6a17fcSKrzysztof Kozlowski
45*3d6a17fcSKrzysztof Kozlowski            current-speed = <4000000>;
46*3d6a17fcSKrzysztof Kozlowski        };
47*3d6a17fcSKrzysztof Kozlowski    };
48