Re: [PATCH 1/1] dt-bindings: i3c: add header for generic I3C flags

From: Krzysztof Kozlowski <krzk@kernel.org>
To: Frank Li <Frank.Li@nxp.com>,
	Alexandre Belloni <alexandre.belloni@bootlin.com>,
	Rob Herring <robh@kernel.org>,
	Krzysztof Kozlowski <krzk+dt@kernel.org>,
	Conor Dooley <conor+dt@kernel.org>,
	Miquel Raynal <miquel.raynal@bootlin.com>,
	"moderated list:I3C SUBSYSTEM" <linux-i3c@lists.infradead.org>,
	"open list:OPEN FIRMWARE AND FLATTENED DEVICE TREE BINDINGS"
	<devicetree@vger.kernel.org>,
	open list <linux-kernel@vger.kernel.org>
Cc: imx@lists.linux.dev
Subject: Re: [PATCH 1/1] dt-bindings: i3c: add header for generic I3C flags
Date: Fri, 12 Jul 2024 19:22:03 +0200	[thread overview]
Message-ID: <ffa6a941-0e01-4f88-90cd-6673b602a7d3@kernel.org> (raw)
In-Reply-To: <20240712170640.3635096-1-Frank.Li@nxp.com>

On 12/07/2024 19:06, Frank Li wrote:
> From: Carlos Song <carlos.song@nxp.com>
> 
> Add header file for generic I3C flags to avoid hard code in dts file.
> 
> Signed-off-by: Carlos Song <carlos.song@nxp.com>
> Reviewed-by: Frank Li <frank.li@nxp.com>
> Acked-by: Jason Liu <jason.hui.liu@nxp.com>
> Signed-off-by: Frank Li <Frank.Li@nxp.com>
> ---
>  Documentation/devicetree/bindings/i3c/i3c.yaml |  5 ++++-
>  MAINTAINERS                                    |  1 +
>  include/dt-bindings/i3c/i3c.h                  | 16 ++++++++++++++++
>  3 files changed, 21 insertions(+), 1 deletion(-)
>  create mode 100644 include/dt-bindings/i3c/i3c.h
> 
> diff --git a/Documentation/devicetree/bindings/i3c/i3c.yaml b/Documentation/devicetree/bindings/i3c/i3c.yaml
> index 113957ebe9f1d..90f3610725185 100644
> --- a/Documentation/devicetree/bindings/i3c/i3c.yaml
> +++ b/Documentation/devicetree/bindings/i3c/i3c.yaml
> @@ -91,6 +91,7 @@ patternProperties:
>                - const: 0
>                - description: |
>                    Shall encode the I3C LVR (Legacy Virtual Register):
> +                  See dt-bindings/i3c/i3c.h

Use full paths.

>                      bit[31:8]: unused/ignored
>                      bit[7:5]: I2C device index. Possible values:
>                        * 0: I2C device has a 50 ns spike filter
> @@ -153,6 +154,8 @@ additionalProperties: true
>  
>  examples:
>    - |
> +    #include <dt-bindings/i3c/i3c.h>
> +
>      i3c@d040000 {
>          compatible = "cdns,i3c-master";
>          clocks = <&coreclock>, <&i3csysclock>;
> @@ -166,7 +169,7 @@ examples:
>          /* I2C device. */
>          eeprom@57 {
>              compatible = "atmel,24c01";
> -            reg = <0x57 0x0 0x10>;
> +            reg = <0x57 0x0 (I2C_FM | I2C_FILTER)>;
>              pagesize = <0x8>;
>          };
>  
> diff --git a/MAINTAINERS b/MAINTAINERS
> index 3c4fdf74a3f9d..f0ce22e04d467 100644
> --- a/MAINTAINERS
> +++ b/MAINTAINERS
> @@ -10479,6 +10479,7 @@ F:	Documentation/ABI/testing/sysfs-bus-i3c
>  F:	Documentation/devicetree/bindings/i3c/
>  F:	Documentation/driver-api/i3c
>  F:	drivers/i3c/
> +F:	include/dt-bindings/i3c/
>  F:	include/linux/i3c/
>  
>  IBM Operation Panel Input Driver
> diff --git a/include/dt-bindings/i3c/i3c.h b/include/dt-bindings/i3c/i3c.h
> new file mode 100644
> index 0000000000000..2513947e70cd2
> --- /dev/null
> +++ b/include/dt-bindings/i3c/i3c.h
> @@ -0,0 +1,16 @@
> +/* SPDX-License-Identifier: GPL-2.0-only OR MIT */

Do not introduce new license, even if it is compatible.
s/MIT/BSD-2-Clause/ - see binding and checkpatch.

Best regards,
Krzysztof

-- 
linux-i3c mailing list
linux-i3c@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/linux-i3c