| Message ID | 20240916064225.316863-1-18771902331@163.com |
|---|---|
| State | Superseded |
| Headers | show |
| Series | Add initial support for Canaan Kendryte K230 pinctrl | expand |
On Mon, Sep 16, 2024 at 02:42:23PM +0800, Ze Huang wrote: > Add device tree binding details for Canaan K230 pinctrl device. > > Signed-off-by: Ze Huang <18771902331@163.com> > --- > .../bindings/pinctrl/canaan,k230-pinctrl.yaml | 128 ++++++++++++++++++ > 1 file changed, 128 insertions(+) > create mode 100644 Documentation/devicetree/bindings/pinctrl/canaan,k230-pinctrl.yaml > > diff --git a/Documentation/devicetree/bindings/pinctrl/canaan,k230-pinctrl.yaml b/Documentation/devicetree/bindings/pinctrl/canaan,k230-pinctrl.yaml > new file mode 100644 > index 000000000000..979c5bd71e3d > --- /dev/null > +++ b/Documentation/devicetree/bindings/pinctrl/canaan,k230-pinctrl.yaml > @@ -0,0 +1,128 @@ > +# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/pinctrl/canaan,k230-pinctrl.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Canaan Kendryte K230 Pin Controller > + > +maintainers: > + - Ze Huang <18771902331@163.com> > + > +description: > + The Canaan Kendryte K230 platform includes 64 IO pins, each capable of > + multiplexing up to 5 different functions. Pin function configuration is > + performed on a per-pin basis. > + > +properties: > + compatible: > + const: canaan,k230-pinctrl > + > + reg: > + maxItems: 1 > + > +patternProperties: > + '-pins$': > + type: object > + additionalProperties: false > + description: > + A pinctrl node should contain at least one subnode representing the > + pinctrl groups available on the machine. > + > + patternProperties: > + '-cfg$': > + type: object > + $ref: /schemas/pinctrl/pincfg-node.yaml > + additionalProperties: false > + description: > + Each subnode will list the pins it needs, and how they should > + be configured, with regard to muxer configuration, bias, input > + enable/disable, input schmitt trigger, slew-rate enable/disable, > + slew-rate, drive strength. > + > + properties: > + pinmux: > + $ref: /schemas/types.yaml#/definitions/uint32-array Drop. You need to add a $ref to pinmux-node.yaml (alongside pincfg-node.yaml). > + description: > + The list of GPIOs and their mux settings that properties in > + the node apply to. This should be set with the macro > + 'K230_PINMUX(pin, mode)' > + > + bias-disable: true > + > + bias-pull-up: true > + > + bias-pull-down: true > + > + drive-strength: > + minimum: 0 > + maximum: 15 > + > + input-enable: true > + > + output-enable: true > + > + input-schmitt-enable: true > + > + slew-rate: > + $ref: /schemas/types.yaml#/definitions/uint32 Drop. Already has a defined type. > + description: | > + slew rate control enable > + 0: disable > + 1: enable > + > + enum: [0, 1] > + > + power-source: > + $ref: /schemas/types.yaml#/definitions/uint32 Drop. Already has a defined type. > + description: | > + Specifies the power source voltage for the IO bank that the > + pin belongs to. Each bank of IO pins operate at a specific, > + fixed voltage levels. Incorrect voltage configuration can > + damage the chip. The defined constants represent the > + possible voltage configurations: > + > + - K230_MSC_3V3 (value 0): 3.3V power supply > + - K230_MSC_1V8 (value 1): 1.8V power supply > + > + The following banks have the corresponding voltage > + configurations: > + > + - bank IO0 to IO1: Fixed at 1.8V > + - bank IO2 to IO13: Fixed at 1.8V > + - bank IO14 to IO25: Fixed at 1.8V > + - bank IO26 to IO37: Fixed at 1.8V > + - bank IO38 to IO49: Fixed at 1.8V > + - bank IO50 to IO61: Fixed at 3.3V > + - bank IO62 to IO63: Fixed at 1.8V > + > + enum: [0, 1] > + > + required: > + - pinmux > + > +required: > + - compatible > + - reg > + > +additionalProperties: false > + > +examples: > + - | > + pinctrl: pinctrl@91105000 { Drop unused labels. > + compatible = "canaan,k230-pinctrl"; > + reg = <0x91105000 0x100>; > + > + uart2_pins: uart2-pins { > + uart2-pins-cfg { > + pinmux = <0x503>, /* uart2 txd */ > + <0x603>; /* uart2 rxd */ > + slew-rate = <0>; > + drive-strength = <4>; > + power-source = <1>; > + input-enable; > + output-enable; > + bias-disable; > + }; > + }; > + }; > -- > 2.46.1 >
On 9/19/24 1:13 AM, Rob Herring wrote: > On Mon, Sep 16, 2024 at 02:42:23PM +0800, Ze Huang wrote: >> Add device tree binding details for Canaan K230 pinctrl device. >> >> Signed-off-by: Ze Huang <18771902331@163.com> >> --- >> .../bindings/pinctrl/canaan,k230-pinctrl.yaml | 128 ++++++++++++++++++ >> 1 file changed, 128 insertions(+) >> create mode 100644 Documentation/devicetree/bindings/pinctrl/canaan,k230-pinctrl.yaml >> >> diff --git a/Documentation/devicetree/bindings/pinctrl/canaan,k230-pinctrl.yaml b/Documentation/devicetree/bindings/pinctrl/canaan,k230-pinctrl.yaml >> new file mode 100644 >> index 000000000000..979c5bd71e3d >> --- /dev/null >> +++ b/Documentation/devicetree/bindings/pinctrl/canaan,k230-pinctrl.yaml >> @@ -0,0 +1,128 @@ >> +# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause >> +%YAML 1.2 >> +--- >> +$id: http://devicetree.org/schemas/pinctrl/canaan,k230-pinctrl.yaml# >> +$schema: http://devicetree.org/meta-schemas/core.yaml# >> + >> +title: Canaan Kendryte K230 Pin Controller >> + >> +maintainers: >> + - Ze Huang <18771902331@163.com> >> + >> +description: >> + The Canaan Kendryte K230 platform includes 64 IO pins, each capable of >> + multiplexing up to 5 different functions. Pin function configuration is >> + performed on a per-pin basis. >> + >> +properties: >> + compatible: >> + const: canaan,k230-pinctrl >> + >> + reg: >> + maxItems: 1 >> + >> +patternProperties: >> + '-pins$': >> + type: object >> + additionalProperties: false >> + description: >> + A pinctrl node should contain at least one subnode representing the >> + pinctrl groups available on the machine. >> + >> + patternProperties: >> + '-cfg$': >> + type: object >> + $ref: /schemas/pinctrl/pincfg-node.yaml >> + additionalProperties: false >> + description: >> + Each subnode will list the pins it needs, and how they should >> + be configured, with regard to muxer configuration, bias, input >> + enable/disable, input schmitt trigger, slew-rate enable/disable, >> + slew-rate, drive strength. >> + >> + properties: >> + pinmux: >> + $ref: /schemas/types.yaml#/definitions/uint32-array > Drop. You need to add a $ref to pinmux-node.yaml (alongside > pincfg-node.yaml). OK. will use a allOf like this: patternProperties: '-cfg$': type: object allOf: - $ref: /schemas/pinctrl/pincfg-node.yaml# - $ref: /schemas/pinctrl/pinmux-node.yaml# > >> + description: >> + The list of GPIOs and their mux settings that properties in >> + the node apply to. This should be set with the macro >> + 'K230_PINMUX(pin, mode)' >> + >> + bias-disable: true >> + >> + bias-pull-up: true >> + >> + bias-pull-down: true >> + >> + drive-strength: >> + minimum: 0 >> + maximum: 15 >> + >> + input-enable: true >> + >> + output-enable: true >> + >> + input-schmitt-enable: true >> + >> + slew-rate: >> + $ref: /schemas/types.yaml#/definitions/uint32 > Drop. Already has a defined type. Acknowledged. > >> + description: | >> + slew rate control enable >> + 0: disable >> + 1: enable >> + >> + enum: [0, 1] >> + >> + power-source: >> + $ref: /schemas/types.yaml#/definitions/uint32 > Drop. Already has a defined type. Acknowledged. > >> + description: | >> + Specifies the power source voltage for the IO bank that the >> + pin belongs to. Each bank of IO pins operate at a specific, >> + fixed voltage levels. Incorrect voltage configuration can >> + damage the chip. The defined constants represent the >> + possible voltage configurations: >> + >> + - K230_MSC_3V3 (value 0): 3.3V power supply >> + - K230_MSC_1V8 (value 1): 1.8V power supply >> + >> + The following banks have the corresponding voltage >> + configurations: >> + >> + - bank IO0 to IO1: Fixed at 1.8V >> + - bank IO2 to IO13: Fixed at 1.8V >> + - bank IO14 to IO25: Fixed at 1.8V >> + - bank IO26 to IO37: Fixed at 1.8V >> + - bank IO38 to IO49: Fixed at 1.8V >> + - bank IO50 to IO61: Fixed at 3.3V >> + - bank IO62 to IO63: Fixed at 1.8V >> + >> + enum: [0, 1] >> + >> + required: >> + - pinmux >> + >> +required: >> + - compatible >> + - reg >> + >> +additionalProperties: false >> + >> +examples: >> + - | >> + pinctrl: pinctrl@91105000 { > Drop unused labels. Will do. > >> + compatible = "canaan,k230-pinctrl"; >> + reg = <0x91105000 0x100>; >> + >> + uart2_pins: uart2-pins { >> + uart2-pins-cfg { >> + pinmux = <0x503>, /* uart2 txd */ >> + <0x603>; /* uart2 rxd */ >> + slew-rate = <0>; >> + drive-strength = <4>; >> + power-source = <1>; >> + input-enable; >> + output-enable; >> + bias-disable; >> + }; >> + }; >> + }; >> -- >> 2.46.1 >>
diff --git a/Documentation/devicetree/bindings/pinctrl/canaan,k230-pinctrl.yaml b/Documentation/devicetree/bindings/pinctrl/canaan,k230-pinctrl.yaml new file mode 100644 index 000000000000..979c5bd71e3d --- /dev/null +++ b/Documentation/devicetree/bindings/pinctrl/canaan,k230-pinctrl.yaml @@ -0,0 +1,128 @@ +# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/pinctrl/canaan,k230-pinctrl.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Canaan Kendryte K230 Pin Controller + +maintainers: + - Ze Huang <18771902331@163.com> + +description: + The Canaan Kendryte K230 platform includes 64 IO pins, each capable of + multiplexing up to 5 different functions. Pin function configuration is + performed on a per-pin basis. + +properties: + compatible: + const: canaan,k230-pinctrl + + reg: + maxItems: 1 + +patternProperties: + '-pins$': + type: object + additionalProperties: false + description: + A pinctrl node should contain at least one subnode representing the + pinctrl groups available on the machine. + + patternProperties: + '-cfg$': + type: object + $ref: /schemas/pinctrl/pincfg-node.yaml + additionalProperties: false + description: + Each subnode will list the pins it needs, and how they should + be configured, with regard to muxer configuration, bias, input + enable/disable, input schmitt trigger, slew-rate enable/disable, + slew-rate, drive strength. + + properties: + pinmux: + $ref: /schemas/types.yaml#/definitions/uint32-array + description: + The list of GPIOs and their mux settings that properties in + the node apply to. This should be set with the macro + 'K230_PINMUX(pin, mode)' + + bias-disable: true + + bias-pull-up: true + + bias-pull-down: true + + drive-strength: + minimum: 0 + maximum: 15 + + input-enable: true + + output-enable: true + + input-schmitt-enable: true + + slew-rate: + $ref: /schemas/types.yaml#/definitions/uint32 + description: | + slew rate control enable + 0: disable + 1: enable + + enum: [0, 1] + + power-source: + $ref: /schemas/types.yaml#/definitions/uint32 + description: | + Specifies the power source voltage for the IO bank that the + pin belongs to. Each bank of IO pins operate at a specific, + fixed voltage levels. Incorrect voltage configuration can + damage the chip. The defined constants represent the + possible voltage configurations: + + - K230_MSC_3V3 (value 0): 3.3V power supply + - K230_MSC_1V8 (value 1): 1.8V power supply + + The following banks have the corresponding voltage + configurations: + + - bank IO0 to IO1: Fixed at 1.8V + - bank IO2 to IO13: Fixed at 1.8V + - bank IO14 to IO25: Fixed at 1.8V + - bank IO26 to IO37: Fixed at 1.8V + - bank IO38 to IO49: Fixed at 1.8V + - bank IO50 to IO61: Fixed at 3.3V + - bank IO62 to IO63: Fixed at 1.8V + + enum: [0, 1] + + required: + - pinmux + +required: + - compatible + - reg + +additionalProperties: false + +examples: + - | + pinctrl: pinctrl@91105000 { + compatible = "canaan,k230-pinctrl"; + reg = <0x91105000 0x100>; + + uart2_pins: uart2-pins { + uart2-pins-cfg { + pinmux = <0x503>, /* uart2 txd */ + <0x603>; /* uart2 rxd */ + slew-rate = <0>; + drive-strength = <4>; + power-source = <1>; + input-enable; + output-enable; + bias-disable; + }; + }; + };
Add device tree binding details for Canaan K230 pinctrl device. Signed-off-by: Ze Huang <18771902331@163.com> --- .../bindings/pinctrl/canaan,k230-pinctrl.yaml | 128 ++++++++++++++++++ 1 file changed, 128 insertions(+) create mode 100644 Documentation/devicetree/bindings/pinctrl/canaan,k230-pinctrl.yaml