Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

dt-bindings: pinctrl: add schema for NXP S32 SoCs

Add DT schema for the pinctrl driver of NXP S32 SoC family.

Signed-off-by: Larisa Grigore <larisa.grigore@nxp.com>
Signed-off-by: Ghennadi Procopciuc <Ghennadi.Procopciuc@oss.nxp.com>
Signed-off-by: Chester Lin <clin@suse.com>
Reviewed-by: Rob Herring <robh@kernel.org>
Link: https://lore.kernel.org/r/20230220023320.3499-2-clin@suse.com
Signed-off-by: Linus Walleij <linus.walleij@linaro.org>

authored by

Chester Lin and committed by
Linus Walleij
2545625b 00408f28

+123
+123
Documentation/devicetree/bindings/pinctrl/nxp,s32g2-siul2-pinctrl.yaml
··· 1 + # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) 2 + # Copyright 2022 NXP 3 + %YAML 1.2 4 + --- 5 + $id: http://devicetree.org/schemas/pinctrl/nxp,s32g2-siul2-pinctrl.yaml# 6 + $schema: http://devicetree.org/meta-schemas/core.yaml# 7 + 8 + title: NXP S32G2 pin controller 9 + 10 + maintainers: 11 + - Ghennadi Procopciuc <Ghennadi.Procopciuc@oss.nxp.com> 12 + - Chester Lin <clin@suse.com> 13 + 14 + description: | 15 + S32G2 pinmux is implemented in SIUL2 (System Integration Unit Lite2), 16 + whose memory map is split into two regions: 17 + SIUL2_0 @ 0x4009c000 18 + SIUL2_1 @ 0x44010000 19 + 20 + Every SIUL2 region has multiple register types, and here only MSCR and 21 + IMCR registers need to be revealed for kernel to configure pinmux. 22 + 23 + Please note that some register indexes are reserved in S32G2, such as 24 + MSCR102-MSCR111, MSCR123-MSCR143, IMCR84-IMCR118 and IMCR398-IMCR429. 25 + 26 + properties: 27 + compatible: 28 + enum: 29 + - nxp,s32g2-siul2-pinctrl 30 + 31 + reg: 32 + description: | 33 + A list of MSCR/IMCR register regions to be reserved. 34 + - MSCR (Multiplexed Signal Configuration Register) 35 + An MSCR register can configure the associated pin as either a GPIO pin 36 + or a function output pin depends on the selected signal source. 37 + - IMCR (Input Multiplexed Signal Configuration Register) 38 + An IMCR register can configure the associated pin as function input 39 + pin depends on the selected signal source. 40 + items: 41 + - description: MSCR registers group 0 in SIUL2_0 42 + - description: MSCR registers group 1 in SIUL2_1 43 + - description: MSCR registers group 2 in SIUL2_1 44 + - description: IMCR registers group 0 in SIUL2_0 45 + - description: IMCR registers group 1 in SIUL2_1 46 + - description: IMCR registers group 2 in SIUL2_1 47 + 48 + patternProperties: 49 + '-pins$': 50 + type: object 51 + additionalProperties: false 52 + 53 + patternProperties: 54 + '-grp[0-9]$': 55 + type: object 56 + allOf: 57 + - $ref: pinmux-node.yaml# 58 + - $ref: pincfg-node.yaml# 59 + description: | 60 + Pinctrl node's client devices specify pin muxes using subnodes, 61 + which in turn use the standard properties below. 62 + 63 + properties: 64 + bias-disable: true 65 + bias-high-impedance: true 66 + bias-pull-up: true 67 + bias-pull-down: true 68 + drive-open-drain: true 69 + input-enable: true 70 + output-enable: true 71 + 72 + pinmux: 73 + description: | 74 + An integer array for representing pinmux configurations of 75 + a device. Each integer consists of a PIN_ID and a 4-bit 76 + selected signal source(SSS) as IOMUX setting, which is 77 + calculated as: pinmux = (PIN_ID << 4 | SSS) 78 + 79 + slew-rate: 80 + description: Supported slew rate based on Fmax values (MHz) 81 + enum: [83, 133, 150, 166, 208] 82 + 83 + additionalProperties: false 84 + 85 + required: 86 + - compatible 87 + - reg 88 + 89 + additionalProperties: false 90 + 91 + examples: 92 + - | 93 + pinctrl@4009c240 { 94 + compatible = "nxp,s32g2-siul2-pinctrl"; 95 + 96 + /* MSCR0-MSCR101 registers on siul2_0 */ 97 + reg = <0x4009c240 0x198>, 98 + /* MSCR112-MSCR122 registers on siul2_1 */ 99 + <0x44010400 0x2c>, 100 + /* MSCR144-MSCR190 registers on siul2_1 */ 101 + <0x44010480 0xbc>, 102 + /* IMCR0-IMCR83 registers on siul2_0 */ 103 + <0x4009ca40 0x150>, 104 + /* IMCR119-IMCR397 registers on siul2_1 */ 105 + <0x44010c1c 0x45c>, 106 + /* IMCR430-IMCR495 registers on siul2_1 */ 107 + <0x440110f8 0x108>; 108 + 109 + llce-can0-pins { 110 + llce-can0-grp0 { 111 + pinmux = <0x2b0>; 112 + input-enable; 113 + slew-rate = <208>; 114 + }; 115 + 116 + llce-can0-grp1 { 117 + pinmux = <0x2c2>; 118 + output-enable; 119 + slew-rate = <208>; 120 + }; 121 + }; 122 + }; 123 + ...