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