xref: /linux/Documentation/devicetree/bindings/gpio/aspeed,sgpio.yaml (revision c532de5a67a70f8533d495f8f2aaa9a0491c3ad0) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/gpio/aspeed,sgpio.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Aspeed SGPIO controller
8
9maintainers:
10  - Andrew Jeffery <andrew@aj.id.au>
11
12description:
13  This SGPIO controller is for ASPEED AST2400, AST2500 and AST2600 SoC,
14  AST2600 have two sgpio master one with 128 pins another one with 80 pins,
15  AST2500/AST2400 have one sgpio master with 80 pins. Each of the Serial
16  GPIO pins can be programmed to support the following options
17  - Support interrupt option for each input port and various interrupt
18    sensitivity option (level-high, level-low, edge-high, edge-low)
19  - Support reset tolerance option for each output port
20  - Directly connected to APB bus and its shift clock is from APB bus clock
21    divided by a programmable value.
22  - Co-work with external signal-chained TTL components (74LV165/74LV595)
23
24properties:
25  compatible:
26    enum:
27      - aspeed,ast2400-sgpio
28      - aspeed,ast2500-sgpio
29      - aspeed,ast2600-sgpiom
30
31  reg:
32    maxItems: 1
33
34  gpio-controller: true
35
36  # Each SGPIO is represented as a pair of input and output GPIOs
37  gpio-line-names:
38    minItems: 160
39    maxItems: 256
40
41  '#gpio-cells':
42    const: 2
43
44  interrupts:
45    maxItems: 1
46
47  interrupt-controller: true
48
49  '#interrupt-cells':
50    const: 2
51
52  clocks:
53    maxItems: 1
54
55  ngpios: true
56
57  bus-frequency: true
58
59required:
60  - compatible
61  - reg
62  - gpio-controller
63  - '#gpio-cells'
64  - interrupts
65  - interrupt-controller
66  - '#interrupt-cells'
67  - ngpios
68  - clocks
69  - bus-frequency
70
71additionalProperties: false
72
73examples:
74  - |
75    #include <dt-bindings/clock/aspeed-clock.h>
76    sgpio: sgpio@1e780200 {
77        #gpio-cells = <2>;
78        compatible = "aspeed,ast2500-sgpio";
79        gpio-controller;
80        interrupts = <40>;
81        reg = <0x1e780200 0x0100>;
82        clocks = <&syscon ASPEED_CLK_APB>;
83        interrupt-controller;
84        #interrupt-cells = <2>;
85        ngpios = <80>;
86        bus-frequency = <12000000>;
87    };
88