Commit d51093cf authored by Rob Herring (Arm)'s avatar Rob Herring (Arm) Committed by Linus Walleij
Browse files

dt-bindings: pinctrl: Convert Marvell Berlin pinctrl to DT schema 



Convert the Marvell/Synaptics Berlin pinctrl binding to DT schema
format. The "reg" property was not documented for the newer SoCs.
Otherwise, it's a straight-forward conversion.

Signed-off-by: default avatarRob Herring (Arm) <robh@kernel.org>
Signed-off-by: default avatarLinus Walleij <linus.walleij@linaro.org>
parent bfdccbe9

Documentation/devicetree/bindings/pinctrl/berlin,pinctrl.txt

deleted100644 → 0
+0 −47
Original line number Diff line number Diff line 
* Pin-controller driver for the Marvell Berlin SoCs



Pin control registers are part of both chip controller and system

controller register sets. Pin controller nodes should be a sub-node of

either the chip controller or system controller node. The pins

controlled are organized in groups, so no actual pin information is

needed.



A pin-controller node should contain subnodes representing the pin group

configurations, one per function. Each subnode has the group name and

the muxing function used.



Be aware the Marvell Berlin datasheets use the keyword 'mode' for what

is called a 'function' in the pin-controller subsystem.



Required properties:

- compatible: should be one of:

	"marvell,berlin2-soc-pinctrl",

	"marvell,berlin2-system-pinctrl",

	"marvell,berlin2cd-soc-pinctrl",

	"marvell,berlin2cd-system-pinctrl",

	"marvell,berlin2q-soc-pinctrl",

	"marvell,berlin2q-system-pinctrl",

	"marvell,berlin4ct-avio-pinctrl",

	"marvell,berlin4ct-soc-pinctrl",

	"marvell,berlin4ct-system-pinctrl",

	"syna,as370-soc-pinctrl"



Required subnode-properties:

- groups: a list of strings describing the group names.

- function: a string describing the function used to mux the groups.



Example:



sys_pinctrl: pin-controller {

	compatible = "marvell,berlin2q-system-pinctrl";



	uart0_pmux: uart0-pmux {

		groups = "GSM12";

		function = "uart0";

	};

};



&uart0 {

	pinctrl-0 = <&uart0_pmux>;

	pinctrl-names = "default";

};

Documentation/devicetree/bindings/pinctrl/marvell,berlin2-soc-pinctrl.yaml

0 → 100644
+86 −0
Original line number Diff line number Diff line 
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)

%YAML 1.2

---

$id: http://devicetree.org/schemas/pinctrl/marvell,berlin2-soc-pinctrl.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#



title: Marvell Berlin pin-controller driver



maintainers:

  - Antoine Tenart <atenart@kernel.org>

  - Jisheng Zhang <jszhang@kernel.org>



description: >

  Pin control registers are part of both chip controller and system controller

  register sets. Pin controller nodes should be a sub-node of either the chip

  controller or system controller node. The pins controlled are organized in

  groups, so no actual pin information is needed.



  A pin-controller node should contain subnodes representing the pin group

  configurations, one per function. Each subnode has the group name and the

  muxing function used.



  Be aware the Marvell Berlin datasheets use the keyword 'mode' for what is

  called a 'function' in the pin-controller subsystem.



properties:

  compatible:

    items:

      - enum:

          - marvell,berlin2-soc-pinctrl

          - marvell,berlin2-system-pinctrl

          - marvell,berlin2cd-soc-pinctrl

          - marvell,berlin2cd-system-pinctrl

          - marvell,berlin2q-soc-pinctrl

          - marvell,berlin2q-system-pinctrl

          - marvell,berlin4ct-avio-pinctrl

          - marvell,berlin4ct-soc-pinctrl

          - marvell,berlin4ct-system-pinctrl

          - syna,as370-soc-pinctrl



  reg:

    maxItems: 1



additionalProperties:

  description: Pin group configuration subnodes.

  type: object

  $ref: /schemas/pinctrl/pinmux-node.yaml#

  additionalProperties: false



  properties:

    groups:

      description: List of pin group names.

      $ref: /schemas/types.yaml#/definitions/string-array



    function:

      description: Function used to mux the group.

      $ref: /schemas/types.yaml#/definitions/string



  required:

    - groups

    - function



allOf:

  - if:

      properties:

        compatible:

          contains:

            enum:

              - marvell,berlin4ct-avio-pinctrl

              - marvell,berlin4ct-soc-pinctrl

              - marvell,berlin4ct-system-pinctrl

              - syna,as370-soc-pinctrl

    then:

      required:

        - reg



examples:

  - |

    pinctrl {

        compatible = "marvell,berlin2q-system-pinctrl";



        uart0-pmux {

            groups = "GSM12";

            function = "uart0";

        };

    };