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