Re: [PATCH v5 1/2] dt-bindings: i2c: npcm7xx: * add binding for i2c controller

From: Peter Rosin
Date: Tue Nov 19 2019 - 17:30:27 EST


On 2019-11-19 15:49, Tali Perry wrote:
> dt-bindings: i2c: npcm7xx: * add binding for i2c controller

I missing an empty line before the block of tags, but the bigger problem
is the repeated subject line. Also, the '*' in the subject makes no
sense to me.

> Signed-off-by: Tali Perry <tali.perry1@xxxxxxxxx>
> Reviewed-by: Rob Herring <robh@xxxxxxxxxx>
> ---
> .../devicetree/bindings/i2c/i2c-npcm7xx.txt | 29 +++++++++++++++++++
> 1 file changed, 29 insertions(+)
> create mode 100644 Documentation/devicetree/bindings/i2c/i2c-npcm7xx.txt
>
> diff --git a/Documentation/devicetree/bindings/i2c/i2c-npcm7xx.txt b/Documentation/devicetree/bindings/i2c/i2c-npcm7xx.txt
> new file mode 100644
> index 000000000000..0ecae950748b
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/i2c/i2c-npcm7xx.txt
> @@ -0,0 +1,29 @@
> +Nuvoton NPCM7XX I2C bus
> +
> +The NPCM750x includes sixteen I2C bus controllers. All Controllers support
> +both master and slave mode. Each controller has two 16 byte HW FIFO for TX and
> +RX.
> +
> +Required properties:
> +- compatible : must be "nuvoton,npcm750-i2c"
> +- reg : Offset and length of the register set for the device.
> +- interrupts : Contain the I2C interrupt with flags for falling edge.
> +- clocks : phandle of I2C reference clock.
> +
> +Optional:
> +- bus-frequency : Contain the I2C bus frequency,
> + the default I2C bus frequency is 100000.
> +- pinctrl-0 : must be <&smbX_pins>, X is module number
> + (on NPCM7XX it's 0 to 15)

Isn't this a strange requirement? Am I, as a device tree author, not free to
use any label names I want? Surely, what is important is what the label refers
to and not its name?

Cheers,
Peter

> +- pinctrl-names : should be set to "default"
> +Example:
> +
> + i2c0: i2c@80000 {
> + compatible = "nuvoton,npcm750-i2c";
> + reg = <0x80000 0x1000>;
> + clocks = <&clk NPCM7XX_CLK_APB2>;
> + bus-frequency = <100000>;
> + interrupts = <GIC_SPI 64 IRQ_TYPE_LEVEL_HIGH>;
> + pinctrl-names = "default";
> + pinctrl-0 = <&smb0_pins>;
> + };
>