marvell,berlin2-soc-pinctrl.yaml

 1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
 2%YAML 1.2
 3---
 4$id: http://devicetree.org/schemas/pinctrl/marvell,berlin2-soc-pinctrl.yaml#
 5$schema: http://devicetree.org/meta-schemas/core.yaml#
 6
 7title: Marvell Berlin pin-controller driver
 8
 9maintainers:
10  - Antoine Tenart <atenart@kernel.org>
11  - Jisheng Zhang <jszhang@kernel.org>
12
13description: >
14  Pin control registers are part of both chip controller and system controller
15  register sets. Pin controller nodes should be a sub-node of either the chip
16  controller or system controller node. The pins controlled are organized in
17  groups, so no actual pin information is needed.
18
19  A pin-controller node should contain subnodes representing the pin group
20  configurations, one per function. Each subnode has the group name and the
21  muxing function used.
22
23  Be aware the Marvell Berlin datasheets use the keyword 'mode' for what is
24  called a 'function' in the pin-controller subsystem.
25
26properties:
27  compatible:
28    items:
29      - enum:
30          - marvell,berlin2-soc-pinctrl
31          - marvell,berlin2-system-pinctrl
32          - marvell,berlin2cd-soc-pinctrl
33          - marvell,berlin2cd-system-pinctrl
34          - marvell,berlin2q-soc-pinctrl
35          - marvell,berlin2q-system-pinctrl
36          - marvell,berlin4ct-avio-pinctrl
37          - marvell,berlin4ct-soc-pinctrl
38          - marvell,berlin4ct-system-pinctrl
39          - syna,as370-soc-pinctrl
40
41  reg:
42    maxItems: 1
43
44additionalProperties:
45  description: Pin group configuration subnodes.
46  type: object
47  $ref: /schemas/pinctrl/pinmux-node.yaml#
48  additionalProperties: false
49
50  properties:
51    groups:
52      description: List of pin group names.
53      $ref: /schemas/types.yaml#/definitions/string-array
54
55    function:
56      description: Function used to mux the group.
57      $ref: /schemas/types.yaml#/definitions/string
58
59  required:
60    - groups
61    - function
62
63allOf:
64  - if:
65      properties:
66        compatible:
67          contains:
68            enum:
69              - marvell,berlin4ct-avio-pinctrl
70              - marvell,berlin4ct-soc-pinctrl
71              - marvell,berlin4ct-system-pinctrl
72              - syna,as370-soc-pinctrl
73    then:
74      required:
75        - reg
76
77examples:
78  - |
79    pinctrl {
80        compatible = "marvell,berlin2q-system-pinctrl";
81
82        uart0-pmux {
83            groups = "GSM12";
84            function = "uart0";
85        };
86    };