public inbox for linux-doc@vger.kernel.org
 help / color / mirror / Atom feed
From: Jonathan Cameron <jic23@kernel.org>
To: Robert Budai <robert.budai@analog.com>
Cc: Nuno Sa <nuno.sa@analog.com>,
	Ramona Gradinariu <ramona.gradinariu@analog.com>,
	Antoniu Miclaus <antoniu.miclaus@analog.com>,
	Lars-Peter Clausen <lars@metafoo.de>,
	Michael Hennerich <Michael.Hennerich@analog.com>,
	"Rob Herring" <robh@kernel.org>,
	Krzysztof Kozlowski <krzk+dt@kernel.org>,
	"Conor Dooley" <conor+dt@kernel.org>,
	Jonathan Corbet <corbet@lwn.net>,
	Shen Jianping <Jianping.Shen@de.bosch.com>,
	Alex Lanzano <lanzano.alex@gmail.com>,
	<linux-iio@vger.kernel.org>, <devicetree@vger.kernel.org>,
	<linux-kernel@vger.kernel.org>, <linux-doc@vger.kernel.org>,
	<robi_budai@yahoo.com>
Subject: Re: [PATCH v3 5/7] dt-bindings: iio: Add adis16550 bindings
Date: Thu, 19 Dec 2024 17:25:24 +0000	[thread overview]
Message-ID: <20241219172524.27b87549@jic23-huawei> (raw)
In-Reply-To: <20241216144818.25344-6-robert.budai@analog.com>

On Mon, 16 Dec 2024 16:48:11 +0200
Robert Budai <robert.budai@analog.com> wrote:

> Document the ADIS16550 device devicetree bindings.
> 
> Co-developed-by: Antoniu Miclaus <antoniu.miclaus@analog.com>
> Signed-off-by: Antoniu Miclaus <antoniu.miclaus@analog.com>
> Signed-off-by: Ramona Gradinariu <ramona.gradinariu@analog.com>
> Signed-off-by: Robert Budai <robert.budai@analog.com>
> ---
> 
> v3:
> - changed sync type to integer
> - conditioned clock only on scaled-sync
> - added: unevaluatedProperties false
> 
>  .../bindings/iio/imu/adi,adis16550.yaml       | 93 +++++++++++++++++++
>  MAINTAINERS                                   |  9 ++
>  2 files changed, 102 insertions(+)
>  create mode 100644 Documentation/devicetree/bindings/iio/imu/adi,adis16550.yaml
> 
> diff --git a/Documentation/devicetree/bindings/iio/imu/adi,adis16550.yaml b/Documentation/devicetree/bindings/iio/imu/adi,adis16550.yaml
> new file mode 100644
> index 000000000000..e0b07b912484
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/iio/imu/adi,adis16550.yaml
> @@ -0,0 +1,93 @@
> +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/iio/imu/adi,adis16550.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: Analog Devices ADIS16550 and similar IMUs
> +
> +maintainers:
> +  - Nuno Sa <nuno.sa@analog.com>
> +  - Ramona Gradinariu <ramona.gradinariu@analog.com>
> +  - Antoniu Miclaus <antoniu.miclaus@analog.com>
> +
> +properties:
> +  compatible:
> +    enum:
> +      - adi,adis16550
> +      - adi,adis16550w
> +
> +  reg:
> +    maxItems: 1
> +
> +  spi-cpha: true
> +
> +  spi-cpol: true
> +
> +  spi-max-frequency:
> +    maximum: 15000000
> +
> +  vdd-supply: true
> +
> +  interrupts:
> +    maxItems: 1
> +
> +  reset-gpios:
> +    description:
> +      RESET active low pin.
> +    maxItems: 1
> +
> +  clocks:
> +    maxItems: 1
> +    description: If not provided, then the internal clock is used.
> +
> +    adi,sync-mode:
This is at least one of the things the bot is complaining about.  Too deep on the indent.
> +        description:
> +          Configures the device SYNC pin. The following modes are supported
> +          0 - direct_sync
> +          1 - scaled_sync

Ah. I see this is lined up with some existing binding.
you should keep the values the same as well given direct and scaled are already in the adis16475 binding.
Just use an enum to constrain the values 1 and 2


> +        $ref: /schemas/types.yaml#/definitions/uint32
> +        minimum: 0
> +        maximum: 1
> +
> +required:
> +  - compatible
> +  - reg
> +  - interrupts
> +  - spi-cpha
> +  - spi-cpol
> +  - spi-max-frequency
> +  - vdd-supply


  parent reply	other threads:[~2024-12-19 17:25 UTC|newest]

Thread overview: 15+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2024-12-16 14:48 [PATCH v3 0/7] Add support for ADIS16550 and ADIS16550W Robert Budai
2024-12-16 14:48 ` [PATCH v3 1/7] iio: imu: adis: Remove documented not used elements Robert Budai
2024-12-19 17:18   ` Jonathan Cameron
2024-12-16 14:48 ` [PATCH v3 2/7] iio: imu: adis: Add custom ops struct Robert Budai
2024-12-16 14:48 ` [PATCH v3 3/7] iio: imu: adis: Add reset to custom ops Robert Budai
2024-12-19 17:20   ` Jonathan Cameron
2024-12-16 14:48 ` [PATCH v3 4/7] iio: imu: adis: Add DIAG_STAT register size Robert Budai
2024-12-16 14:48 ` [PATCH v3 5/7] dt-bindings: iio: Add adis16550 bindings Robert Budai
2024-12-16 16:20   ` Rob Herring (Arm)
2024-12-19 17:25   ` Jonathan Cameron [this message]
2024-12-16 14:48 ` [PATCH v3 6/7] iio: imu: adis16550: add adis16550 support Robert Budai
2024-12-17 10:29   ` Nuno Sá
2024-12-19 17:36   ` Jonathan Cameron
2024-12-16 14:48 ` [PATCH v3 7/7] docs: iio: add documentation for adis16550 driver Robert Budai
2024-12-19 17:39   ` Jonathan Cameron

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20241219172524.27b87549@jic23-huawei \
    --to=jic23@kernel.org \
    --cc=Jianping.Shen@de.bosch.com \
    --cc=Michael.Hennerich@analog.com \
    --cc=antoniu.miclaus@analog.com \
    --cc=conor+dt@kernel.org \
    --cc=corbet@lwn.net \
    --cc=devicetree@vger.kernel.org \
    --cc=krzk+dt@kernel.org \
    --cc=lanzano.alex@gmail.com \
    --cc=lars@metafoo.de \
    --cc=linux-doc@vger.kernel.org \
    --cc=linux-iio@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=nuno.sa@analog.com \
    --cc=ramona.gradinariu@analog.com \
    --cc=robert.budai@analog.com \
    --cc=robh@kernel.org \
    --cc=robi_budai@yahoo.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox