From: Nishanth Menon <nm@ti.com> To: Rob Herring <robh@kernel.org> Cc: Stephen Boyd <sboyd@kernel.org>, Michael Turquette <mturquette@baylibre.com>, Philipp Zabel <p.zabel@pengutronix.de>, Santosh Shilimkar <ssantosh@kernel.org>, Tero Kristo <kristo@kernel.org>, <linux-clk@vger.kernel.org>, <linux-kernel@vger.kernel.org>, <devicetree@vger.kernel.org>, <linux-arm-kernel@lists.infradead.org> Subject: Re: [PATCH 2/4] dt-bindings: clock: Convert ti,sci-clk to json schema Date: Thu, 22 Apr 2021 09:09:35 -0500 [thread overview] Message-ID: <20210422140935.lzsp6s2ugyvi2icu@iodize> (raw) In-Reply-To: <20210421223145.GB1705110@robh.at.kernel.org> On 17:31-20210421, Rob Herring wrote: [...] > > > > +allOf: > > > > + - $ref: /schemas/clock/clock.yaml# > > > > > > Is this needed? > > No. It is already applied to every node. > > > https://github.com/devicetree-org/dt-schema/blob/master/schemas/clock/clock.yaml > > This standardizes provider properties like '#clock-cells' etc, allowing > > you to add more stricter checks or controls in the future if necessary. > > > > while: > > > > https://github.com/devicetree-org/dt-schema/blob/master/meta-schemas/clocks.yaml > > is more a consumer node description. > > No, the meta-schema is what checks the schemas just as the schemas check > dts files. I will drop and respin. thanks for explaining. > > > Should I have picked a different yaml as base for a standard clock-controller > > base? > > > > > > > > > + > > > > +description: | > > > > + Some TI SoCs contain a system controller (like the Power Management Micro > > > > + Controller (PMMC) on Keystone 66AK2G SoC) that are responsible for controlling > > > > + the state of the various hardware modules present on the SoC. Communication > > > > + between the host processor running an OS and the system controller happens > > > > + through a protocol called TI System Control Interface (TI-SCI protocol). > > > > + > > > > + This clock controller node uses the TI SCI protocol to perform various clock > > > > + management of various hardware modules (devices) present on the SoC. This > > > > + node must be a child node of the associated TI-SCI system controller node. > > > > + > > > > +properties: > > > > + $nodename: > > > > + pattern: "^clock-controller$" > > > > > > Is this nodename pattern check required? > > > > I'd like the definition on rails and not subject to interpretation, and > > restrict the kind of subnodes under TISCI controller node. > > If this schema was standalone and not defined as part of another, then > yes it would be required. In your case, you can enforce the node name > from the parent schema. For consistency though, it would be better to > just always require $nodename. > > Actually, this schema will be applied twice. On it's own matching the > compatible string and by the parent schema. You can prevent that with > 'select: false'. I don't mind the double validation as if the parent > node had a compatible typo you'd get zero validation. Sure. I will keep nodename. -- Regards, Nishanth Menon Key (0xDDB5849D1736249D)/Fingerprint: F8A2 8693 54EB 8232 17A3 1A34 DDB5 849D 1736 249D
WARNING: multiple messages have this Message-ID (diff)
From: Nishanth Menon <nm@ti.com> To: Rob Herring <robh@kernel.org> Cc: Stephen Boyd <sboyd@kernel.org>, Michael Turquette <mturquette@baylibre.com>, Philipp Zabel <p.zabel@pengutronix.de>, Santosh Shilimkar <ssantosh@kernel.org>, Tero Kristo <kristo@kernel.org>, <linux-clk@vger.kernel.org>, <linux-kernel@vger.kernel.org>, <devicetree@vger.kernel.org>, <linux-arm-kernel@lists.infradead.org> Subject: Re: [PATCH 2/4] dt-bindings: clock: Convert ti, sci-clk to json schema Date: Thu, 22 Apr 2021 09:09:35 -0500 [thread overview] Message-ID: <20210422140935.lzsp6s2ugyvi2icu@iodize> (raw) In-Reply-To: <20210421223145.GB1705110@robh.at.kernel.org> On 17:31-20210421, Rob Herring wrote: [...] > > > > +allOf: > > > > + - $ref: /schemas/clock/clock.yaml# > > > > > > Is this needed? > > No. It is already applied to every node. > > > https://github.com/devicetree-org/dt-schema/blob/master/schemas/clock/clock.yaml > > This standardizes provider properties like '#clock-cells' etc, allowing > > you to add more stricter checks or controls in the future if necessary. > > > > while: > > > > https://github.com/devicetree-org/dt-schema/blob/master/meta-schemas/clocks.yaml > > is more a consumer node description. > > No, the meta-schema is what checks the schemas just as the schemas check > dts files. I will drop and respin. thanks for explaining. > > > Should I have picked a different yaml as base for a standard clock-controller > > base? > > > > > > > > > + > > > > +description: | > > > > + Some TI SoCs contain a system controller (like the Power Management Micro > > > > + Controller (PMMC) on Keystone 66AK2G SoC) that are responsible for controlling > > > > + the state of the various hardware modules present on the SoC. Communication > > > > + between the host processor running an OS and the system controller happens > > > > + through a protocol called TI System Control Interface (TI-SCI protocol). > > > > + > > > > + This clock controller node uses the TI SCI protocol to perform various clock > > > > + management of various hardware modules (devices) present on the SoC. This > > > > + node must be a child node of the associated TI-SCI system controller node. > > > > + > > > > +properties: > > > > + $nodename: > > > > + pattern: "^clock-controller$" > > > > > > Is this nodename pattern check required? > > > > I'd like the definition on rails and not subject to interpretation, and > > restrict the kind of subnodes under TISCI controller node. > > If this schema was standalone and not defined as part of another, then > yes it would be required. In your case, you can enforce the node name > from the parent schema. For consistency though, it would be better to > just always require $nodename. > > Actually, this schema will be applied twice. On it's own matching the > compatible string and by the parent schema. You can prevent that with > 'select: false'. I don't mind the double validation as if the parent > node had a compatible typo you'd get zero validation. Sure. I will keep nodename. -- Regards, Nishanth Menon Key (0xDDB5849D1736249D)/Fingerprint: F8A2 8693 54EB 8232 17A3 1A34 DDB5 849D 1736 249D _______________________________________________ linux-arm-kernel mailing list linux-arm-kernel@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-arm-kernel
next prev parent reply other threads:[~2021-04-22 14:09 UTC|newest] Thread overview: 34+ messages / expand[flat|nested] mbox.gz Atom feed top 2021-04-16 6:37 [PATCH 0/4] dt-bindings: soc/arm: Convert pending ti,sci* bindings to json format Nishanth Menon 2021-04-16 6:37 ` [PATCH 0/4] dt-bindings: soc/arm: Convert pending ti, sci* " Nishanth Menon 2021-04-16 6:37 ` [PATCH 1/4] dt-bindings: reset: Convert ti,sci-reset to json schema Nishanth Menon 2021-04-16 6:37 ` Nishanth Menon 2021-04-21 22:32 ` Rob Herring 2021-04-21 22:32 ` Rob Herring 2021-04-16 6:37 ` [PATCH 2/4] dt-bindings: clock: Convert ti,sci-clk " Nishanth Menon 2021-04-16 6:37 ` Nishanth Menon 2021-04-16 23:55 ` Stephen Boyd 2021-04-16 23:55 ` [PATCH 2/4] dt-bindings: clock: Convert ti, sci-clk " Stephen Boyd 2021-04-17 12:51 ` [PATCH 2/4] dt-bindings: clock: Convert ti,sci-clk " Nishanth Menon 2021-04-17 12:51 ` [PATCH 2/4] dt-bindings: clock: Convert ti, sci-clk " Nishanth Menon 2021-04-19 13:35 ` [PATCH 2/4] dt-bindings: clock: Convert ti,sci-clk " Nishanth Menon 2021-04-19 13:35 ` [PATCH 2/4] dt-bindings: clock: Convert ti, sci-clk " Nishanth Menon 2021-04-21 22:31 ` [PATCH 2/4] dt-bindings: clock: Convert ti,sci-clk " Rob Herring 2021-04-21 22:31 ` [PATCH 2/4] dt-bindings: clock: Convert ti, sci-clk " Rob Herring 2021-04-22 14:09 ` Nishanth Menon [this message] 2021-04-22 14:09 ` Nishanth Menon 2021-04-16 6:37 ` [PATCH 3/4] dt-bindings: soc: ti: Convert ti,sci-pm-domain " Nishanth Menon 2021-04-16 6:37 ` [PATCH 3/4] dt-bindings: soc: ti: Convert ti, sci-pm-domain " Nishanth Menon 2021-04-21 22:36 ` Rob Herring 2021-04-21 22:36 ` Rob Herring 2021-04-16 6:37 ` [PATCH 4/4] dt-bindings: arm: keystone: Convert ti,sci " Nishanth Menon 2021-04-16 6:37 ` [PATCH 4/4] dt-bindings: arm: keystone: Convert ti, sci " Nishanth Menon 2021-04-21 22:40 ` [PATCH 4/4] dt-bindings: arm: keystone: Convert ti,sci " Rob Herring 2021-04-21 22:40 ` Rob Herring 2021-04-22 14:17 ` Nishanth Menon 2021-04-22 14:17 ` Nishanth Menon 2021-04-22 16:12 ` Rob Herring 2021-04-22 16:12 ` [PATCH 4/4] dt-bindings: arm: keystone: Convert ti, sci " Rob Herring 2021-04-16 10:37 ` [PATCH 0/4] dt-bindings: soc/arm: Convert pending ti,sci* bindings to json format Tero Kristo 2021-04-16 10:37 ` Tero Kristo 2021-04-21 22:12 ` Rob Herring 2021-04-21 22:12 ` Rob Herring
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=20210422140935.lzsp6s2ugyvi2icu@iodize \ --to=nm@ti.com \ --cc=devicetree@vger.kernel.org \ --cc=kristo@kernel.org \ --cc=linux-arm-kernel@lists.infradead.org \ --cc=linux-clk@vger.kernel.org \ --cc=linux-kernel@vger.kernel.org \ --cc=mturquette@baylibre.com \ --cc=p.zabel@pengutronix.de \ --cc=robh@kernel.org \ --cc=sboyd@kernel.org \ --cc=ssantosh@kernel.org \ /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: linkBe sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes, see mirroring instructions on how to clone and mirror all data and code used by this external index.