| lists.openwall.net | lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC | |
|
Open Source and information security mailing list archives
| ||
|
Message-ID: <20240918171320.GA1810164-robh@kernel.org>
Date: Wed, 18 Sep 2024 12:13:20 -0500
From: Rob Herring <robh@...nel.org>
To: Ze Huang <18771902331@....com>
Cc: Linus Walleij <linus.walleij@...aro.org>,
Krzysztof Kozlowski <krzysztof.kozlowski+dt@...aro.org>,
Conor Dooley <conor+dt@...nel.org>,
Paul Walmsley <paul.walmsley@...ive.com>,
Palmer Dabbelt <palmer@...belt.com>,
Albert Ou <aou@...s.berkeley.edu>, Yangyu Chen <cyy@...self.name>,
linux-gpio@...r.kernel.org, devicetree@...r.kernel.org,
linux-kernel@...r.kernel.org, linux-riscv@...ts.infradead.org
Subject: Re: [RESEND PATCH 1/3] dt-bindings: pinctrl: Add support for
canaan,k230 SoC
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@....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@....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@...05000 {
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
>
Powered by blists - more mailing lists