lkml.org 
[lkml]   [2021]   [Jun]   [9]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
    Patch in this message
    /
    From
    Subject[PATCHv4 3/6] dt-bindings: misc: ge-achc: Convert to DT schema format
    Date
    Convert the binding to DT schema format. Also update the binding
    to fix shortcomings

    * Add "nxp,kinetis-k20" fallback compatible
    * add programming SPI interface and reset GPIO
    * add main clock
    * add voltage supplies
    * drop spi-max-frequency from required properties,
    driver will setup max. frequency

    Signed-off-by: Sebastian Reichel <sebastian.reichel@collabora.com>
    ---
    .../devicetree/bindings/misc/ge-achc.txt | 26 --------
    .../devicetree/bindings/misc/ge-achc.yaml | 65 +++++++++++++++++++
    2 files changed, 65 insertions(+), 26 deletions(-)
    delete mode 100644 Documentation/devicetree/bindings/misc/ge-achc.txt
    create mode 100644 Documentation/devicetree/bindings/misc/ge-achc.yaml

    diff --git a/Documentation/devicetree/bindings/misc/ge-achc.txt b/Documentation/devicetree/bindings/misc/ge-achc.txt
    deleted file mode 100644
    index 77df94d7a32f..000000000000
    --- a/Documentation/devicetree/bindings/misc/ge-achc.txt
    +++ /dev/null
    @@ -1,26 +0,0 @@
    -* GE Healthcare USB Management Controller
    -
    -A device which handles data aquisition from compatible USB based peripherals.
    -SPI is used for device management.
    -
    -Note: This device does not expose the peripherals as USB devices.
    -
    -Required properties:
    -
    -- compatible : Should be "ge,achc"
    -
    -Required SPI properties:
    -
    -- reg : Should be address of the device chip select within
    - the controller.
    -
    -- spi-max-frequency : Maximum SPI clocking speed of device in Hz, should be
    - 1MHz for the GE ACHC.
    -
    -Example:
    -
    -spidev0: spi@0 {
    - compatible = "ge,achc";
    - reg = <0>;
    - spi-max-frequency = <1000000>;
    -};
    diff --git a/Documentation/devicetree/bindings/misc/ge-achc.yaml b/Documentation/devicetree/bindings/misc/ge-achc.yaml
    new file mode 100644
    index 000000000000..ff07aa62ed57
    --- /dev/null
    +++ b/Documentation/devicetree/bindings/misc/ge-achc.yaml
    @@ -0,0 +1,65 @@
    +# SPDX-License-Identifier: GPL-2.0 OR BSD-2-Clause
    +# Copyright (C) 2021 GE Inc.
    +# Copyright (C) 2021 Collabora Ltd.
    +%YAML 1.2
    +---
    +$id: http://devicetree.org/schemas/misc/ge-achc.yaml#
    +$schema: http://devicetree.org/meta-schemas/core.yaml#
    +
    +title: GE Healthcare USB Management Controller
    +
    +description: |
    + A device which handles data acquisition from compatible USB based peripherals.
    + SPI is used for device management.
    +
    + Note: This device does not expose the peripherals as USB devices.
    +
    +maintainers:
    + - Sebastian Reichel <sre@kernel.org>
    +
    +properties:
    + compatible:
    + items:
    + - const: ge,achc
    + - const: nxp,kinetis-k20
    +
    + clocks:
    + maxItems: 1
    +
    + vdd-supply:
    + description: Digital power supply regulator on VDD pin
    +
    + vdda-supply:
    + description: Analog power supply regulator on VDDA pin
    +
    + reg:
    + items:
    + - description: Control interface
    + - description: Firmware programming interface
    +
    + reset-gpios:
    + description: GPIO used for hardware reset.
    + maxItems: 1
    +
    +required:
    + - compatible
    + - clocks
    + - reg
    + - reset-gpios
    +
    +additionalProperties: false
    +
    +examples:
    + - |
    + #include <dt-bindings/gpio/gpio.h>
    + spi {
    + #address-cells = <1>;
    + #size-cells = <0>;
    +
    + spi@1 {
    + compatible = "ge,achc", "nxp,kinetis-k20";
    + reg = <1>, <0>;
    + clocks = <&achc_24M>;
    + reset-gpios = <&gpio3 6 GPIO_ACTIVE_LOW>;
    + };
    + };
    --
    2.30.2
    \
     
     \ /
      Last update: 2021-06-09 17:13    [W:3.251 / U:0.488 seconds]
    ©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site