* [PATCH V5] dt-bindings: soc: imx: Add binding doc for spba bus
@ 2020-11-18 23:04 Adam Ford
2020-11-26 13:50 ` Adam Ford
2020-11-30 22:02 ` Rob Herring
0 siblings, 2 replies; 7+ messages in thread
From: Adam Ford @ 2020-11-18 23:04 UTC (permalink / raw)
To: devicetree; +Cc: aford, Adam Ford, Rob Herring, Shawn Guo, linux-kernel
Add binding doc for fsl,spba-bus.
Signed-off-by: Adam Ford <aford173@gmail.com>
---
make dt_binding_check -j8 |grep spba
DTEX Documentation/devicetree/bindings/bus/fsl,spba-bus.example.dts
DTC Documentation/devicetree/bindings/bus/fsl,spba-bus.example.dt.yaml
CHECK Documentation/devicetree/bindings/bus/fsl,spba-bus.example.dt.yaml
V5: Rebase on 5.10-rc2 to be able to check yaml
Add Reg entry
V4: Remove an accidental makefile change
Move type:object under additional properties
V3: Rebase sample from aips-bus example
Split off from series adding i.MX8M Nano functions to reduce noise
V2: Attempted to update yaml from feedback
diff --git a/Documentation/devicetree/bindings/bus/fsl,spba-bus.yaml b/Documentation/devicetree/bindings/bus/fsl,spba-bus.yaml
new file mode 100644
index 000000000000..e9f77ecae3d3
--- /dev/null
+++ b/Documentation/devicetree/bindings/bus/fsl,spba-bus.yaml
@@ -0,0 +1,68 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/bus/fsl,spba-bus.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Shared Peripherals Bus Interface
+
+maintainers:
+ - Shawn Guo <shawnguo@kernel.org>
+
+description: |
+ A simple bus enabling access to shared peripherals.
+
+ The "spba-bus" follows the "simple-bus" set of properties, as
+ specified in the Devicetree Specification. It is an extension of
+ "simple-bus" because the SDMA controller uses this compatible flag to
+ determine which peripherals are available to it and the range over which
+ the SDMA can access. There are no special clocks for the bus, because
+ the SDMA controller itself has its interrupt, and clock assignments.
+
+select:
+ properties:
+ compatible:
+ contains:
+ const: fsl,spba-bus
+ required:
+ - compatible
+
+properties:
+ $nodename:
+ pattern: "^bus(@[0-9a-f]+)?$"
+
+ compatible:
+ items:
+ - const: fsl,spba-bus
+ - const: simple-bus
+
+ '#address-cells':
+ enum: [ 1, 2 ]
+
+ '#size-cells':
+ enum: [ 1, 2 ]
+
+ reg:
+ maxItems: 1
+
+ ranges: true
+
+required:
+ - compatible
+ - '#address-cells'
+ - '#size-cells'
+ - reg
+ - ranges
+
+additionalProperties:
+ type: object
+
+examples:
+ - |
+ bus@30000000 {
+ compatible = "fsl,spba-bus", "simple-bus";
+ #address-cells = <1>;
+ #size-cells = <1>;
+ reg = <0x30000000 0x100000>;
+ ranges;
+ };
--
2.25.1
^ permalink raw reply related [flat|nested] 7+ messages in thread
* Re: [PATCH V5] dt-bindings: soc: imx: Add binding doc for spba bus
2020-11-18 23:04 [PATCH V5] dt-bindings: soc: imx: Add binding doc for spba bus Adam Ford
@ 2020-11-26 13:50 ` Adam Ford
2020-11-30 22:02 ` Rob Herring
1 sibling, 0 replies; 7+ messages in thread
From: Adam Ford @ 2020-11-26 13:50 UTC (permalink / raw)
To: devicetree
Cc: Adam Ford-BE, Rob Herring, Shawn Guo, Linux Kernel Mailing List
On Wed, Nov 18, 2020 at 5:04 PM Adam Ford <aford173@gmail.com> wrote:
>
> Add binding doc for fsl,spba-bus.
>
> Signed-off-by: Adam Ford <aford173@gmail.com>
Rob,
Sorry to be a pest. I have a series for the i.MX8M Nano that's
waiting on this. Have you had time to review my latest attempt?
adam
> ---
> make dt_binding_check -j8 |grep spba
> DTEX Documentation/devicetree/bindings/bus/fsl,spba-bus.example.dts
> DTC Documentation/devicetree/bindings/bus/fsl,spba-bus.example.dt.yaml
> CHECK Documentation/devicetree/bindings/bus/fsl,spba-bus.example.dt.yaml
>
> V5: Rebase on 5.10-rc2 to be able to check yaml
> Add Reg entry
>
> V4: Remove an accidental makefile change
> Move type:object under additional properties
>
> V3: Rebase sample from aips-bus example
> Split off from series adding i.MX8M Nano functions to reduce noise
>
> V2: Attempted to update yaml from feedback
>
> diff --git a/Documentation/devicetree/bindings/bus/fsl,spba-bus.yaml b/Documentation/devicetree/bindings/bus/fsl,spba-bus.yaml
> new file mode 100644
> index 000000000000..e9f77ecae3d3
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/bus/fsl,spba-bus.yaml
> @@ -0,0 +1,68 @@
> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/bus/fsl,spba-bus.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: Shared Peripherals Bus Interface
> +
> +maintainers:
> + - Shawn Guo <shawnguo@kernel.org>
> +
> +description: |
> + A simple bus enabling access to shared peripherals.
> +
> + The "spba-bus" follows the "simple-bus" set of properties, as
> + specified in the Devicetree Specification. It is an extension of
> + "simple-bus" because the SDMA controller uses this compatible flag to
> + determine which peripherals are available to it and the range over which
> + the SDMA can access. There are no special clocks for the bus, because
> + the SDMA controller itself has its interrupt, and clock assignments.
> +
> +select:
> + properties:
> + compatible:
> + contains:
> + const: fsl,spba-bus
> + required:
> + - compatible
> +
> +properties:
> + $nodename:
> + pattern: "^bus(@[0-9a-f]+)?$"
> +
> + compatible:
> + items:
> + - const: fsl,spba-bus
> + - const: simple-bus
> +
> + '#address-cells':
> + enum: [ 1, 2 ]
> +
> + '#size-cells':
> + enum: [ 1, 2 ]
> +
> + reg:
> + maxItems: 1
> +
> + ranges: true
> +
> +required:
> + - compatible
> + - '#address-cells'
> + - '#size-cells'
> + - reg
> + - ranges
> +
> +additionalProperties:
> + type: object
> +
> +examples:
> + - |
> + bus@30000000 {
> + compatible = "fsl,spba-bus", "simple-bus";
> + #address-cells = <1>;
> + #size-cells = <1>;
> + reg = <0x30000000 0x100000>;
> + ranges;
> + };
> --
> 2.25.1
>
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [PATCH V5] dt-bindings: soc: imx: Add binding doc for spba bus
2020-11-18 23:04 [PATCH V5] dt-bindings: soc: imx: Add binding doc for spba bus Adam Ford
2020-11-26 13:50 ` Adam Ford
@ 2020-11-30 22:02 ` Rob Herring
2021-04-01 21:19 ` Adam Ford
1 sibling, 1 reply; 7+ messages in thread
From: Rob Herring @ 2020-11-30 22:02 UTC (permalink / raw)
To: Adam Ford; +Cc: Rob Herring, devicetree, linux-kernel, Shawn Guo, aford
On Wed, 18 Nov 2020 17:04:14 -0600, Adam Ford wrote:
> Add binding doc for fsl,spba-bus.
>
> Signed-off-by: Adam Ford <aford173@gmail.com>
> ---
> make dt_binding_check -j8 |grep spba
> DTEX Documentation/devicetree/bindings/bus/fsl,spba-bus.example.dts
> DTC Documentation/devicetree/bindings/bus/fsl,spba-bus.example.dt.yaml
> CHECK Documentation/devicetree/bindings/bus/fsl,spba-bus.example.dt.yaml
>
> V5: Rebase on 5.10-rc2 to be able to check yaml
> Add Reg entry
>
> V4: Remove an accidental makefile change
> Move type:object under additional properties
>
> V3: Rebase sample from aips-bus example
> Split off from series adding i.MX8M Nano functions to reduce noise
>
> V2: Attempted to update yaml from feedback
>
Applied, thanks!
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [PATCH V5] dt-bindings: soc: imx: Add binding doc for spba bus
2020-11-30 22:02 ` Rob Herring
@ 2021-04-01 21:19 ` Adam Ford
2021-10-16 20:11 ` Adam Ford
0 siblings, 1 reply; 7+ messages in thread
From: Adam Ford @ 2021-04-01 21:19 UTC (permalink / raw)
To: Rob Herring
Cc: Rob Herring, devicetree, Linux Kernel Mailing List, Shawn Guo,
Adam Ford-BE
On Mon, Nov 30, 2020 at 4:02 PM Rob Herring <robh@kernel.org> wrote:
>
> On Wed, 18 Nov 2020 17:04:14 -0600, Adam Ford wrote:
> > Add binding doc for fsl,spba-bus.
> >
> > Signed-off-by: Adam Ford <aford173@gmail.com>
> > ---
> > make dt_binding_check -j8 |grep spba
> > DTEX Documentation/devicetree/bindings/bus/fsl,spba-bus.example.dts
> > DTC Documentation/devicetree/bindings/bus/fsl,spba-bus.example.dt.yaml
> > CHECK Documentation/devicetree/bindings/bus/fsl,spba-bus.example.dt.yaml
> >
> > V5: Rebase on 5.10-rc2 to be able to check yaml
> > Add Reg entry
> >
> > V4: Remove an accidental makefile change
> > Move type:object under additional properties
> >
> > V3: Rebase sample from aips-bus example
> > Split off from series adding i.MX8M Nano functions to reduce noise
> >
> > V2: Attempted to update yaml from feedback
> >
>
> Applied, thanks!
Rob,
I am not seeing this anywhere. Can you tell me where this was
applied? It's not appearing in Linux-next
adam
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [PATCH V5] dt-bindings: soc: imx: Add binding doc for spba bus
2021-04-01 21:19 ` Adam Ford
@ 2021-10-16 20:11 ` Adam Ford
2021-11-03 14:36 ` Adam Ford
0 siblings, 1 reply; 7+ messages in thread
From: Adam Ford @ 2021-10-16 20:11 UTC (permalink / raw)
To: Rob Herring
Cc: Rob Herring, devicetree, Linux Kernel Mailing List, Shawn Guo,
Adam Ford-BE
On Thu, Apr 1, 2021 at 4:19 PM Adam Ford <aford173@gmail.com> wrote:
>
> On Mon, Nov 30, 2020 at 4:02 PM Rob Herring <robh@kernel.org> wrote:
> >
> > On Wed, 18 Nov 2020 17:04:14 -0600, Adam Ford wrote:
> > > Add binding doc for fsl,spba-bus.
> > >
> > > Signed-off-by: Adam Ford <aford173@gmail.com>
> > > ---
> > > make dt_binding_check -j8 |grep spba
> > > DTEX Documentation/devicetree/bindings/bus/fsl,spba-bus.example.dts
> > > DTC Documentation/devicetree/bindings/bus/fsl,spba-bus.example.dt.yaml
> > > CHECK Documentation/devicetree/bindings/bus/fsl,spba-bus.example.dt.yaml
> > >
> > > V5: Rebase on 5.10-rc2 to be able to check yaml
> > > Add Reg entry
> > >
> > > V4: Remove an accidental makefile change
> > > Move type:object under additional properties
> > >
> > > V3: Rebase sample from aips-bus example
> > > Split off from series adding i.MX8M Nano functions to reduce noise
> > >
> > > V2: Attempted to update yaml from feedback
> > >
> >
> > Applied, thanks!
>
> Rob,
>
> I am not seeing this anywhere. Can you tell me where this was
> applied? It's not appearing in Linux-next
Rob,
Patchwork shows this has been accepted [1], however I don't see that
it's still applied.
[1] https://patchwork.ozlabs.org/project/devicetree-bindings/patch/20201118230414.121316-1-aford173@gmail.com/
Can you apply it? It looks like building the device tree is throwing
messages because this is missing.
adam
>
> adam
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [PATCH V5] dt-bindings: soc: imx: Add binding doc for spba bus
2021-10-16 20:11 ` Adam Ford
@ 2021-11-03 14:36 ` Adam Ford
2021-11-20 10:13 ` Shawn Guo
0 siblings, 1 reply; 7+ messages in thread
From: Adam Ford @ 2021-11-03 14:36 UTC (permalink / raw)
To: Rob Herring
Cc: Rob Herring, devicetree, Linux Kernel Mailing List, Shawn Guo,
Adam Ford-BE
On Sat, Oct 16, 2021 at 3:11 PM Adam Ford <aford173@gmail.com> wrote:
>
> On Thu, Apr 1, 2021 at 4:19 PM Adam Ford <aford173@gmail.com> wrote:
> >
> > On Mon, Nov 30, 2020 at 4:02 PM Rob Herring <robh@kernel.org> wrote:
> > >
> > > On Wed, 18 Nov 2020 17:04:14 -0600, Adam Ford wrote:
> > > > Add binding doc for fsl,spba-bus.
> > > >
> > > > Signed-off-by: Adam Ford <aford173@gmail.com>
> > > > ---
> > > > make dt_binding_check -j8 |grep spba
> > > > DTEX Documentation/devicetree/bindings/bus/fsl,spba-bus.example.dts
> > > > DTC Documentation/devicetree/bindings/bus/fsl,spba-bus.example.dt.yaml
> > > > CHECK Documentation/devicetree/bindings/bus/fsl,spba-bus.example.dt.yaml
> > > >
> > > > V5: Rebase on 5.10-rc2 to be able to check yaml
> > > > Add Reg entry
> > > >
> > > > V4: Remove an accidental makefile change
> > > > Move type:object under additional properties
> > > >
> > > > V3: Rebase sample from aips-bus example
> > > > Split off from series adding i.MX8M Nano functions to reduce noise
> > > >
> > > > V2: Attempted to update yaml from feedback
> > > >
> > >
> > > Applied, thanks!
> >
> > Rob,
> >
> > I am not seeing this anywhere. Can you tell me where this was
> > applied? It's not appearing in Linux-next
>
> Rob,
>
> Patchwork shows this has been accepted [1], however I don't see that
> it's still applied.
>
>
> [1] https://patchwork.ozlabs.org/project/devicetree-bindings/patch/20201118230414.121316-1-aford173@gmail.com/
>
> Can you apply it? It looks like building the device tree is throwing
> messages because this is missing.
>
Shawn,
Since you're the maintainer for the IMX stuff, can I update the
MAINTAINERS file to add this yaml file under the IMX section? When
building device trees, it throws a bunch of splat because this patch
was never applied, and checkpatch is showing it wants a maintainer.
> adam
> >
> > adam
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [PATCH V5] dt-bindings: soc: imx: Add binding doc for spba bus
2021-11-03 14:36 ` Adam Ford
@ 2021-11-20 10:13 ` Shawn Guo
0 siblings, 0 replies; 7+ messages in thread
From: Shawn Guo @ 2021-11-20 10:13 UTC (permalink / raw)
To: Adam Ford
Cc: Rob Herring, Rob Herring, devicetree, Linux Kernel Mailing List,
Adam Ford-BE
On Wed, Nov 03, 2021 at 09:36:59AM -0500, Adam Ford wrote:
> On Sat, Oct 16, 2021 at 3:11 PM Adam Ford <aford173@gmail.com> wrote:
> >
> > On Thu, Apr 1, 2021 at 4:19 PM Adam Ford <aford173@gmail.com> wrote:
> > >
> > > On Mon, Nov 30, 2020 at 4:02 PM Rob Herring <robh@kernel.org> wrote:
> > > >
> > > > On Wed, 18 Nov 2020 17:04:14 -0600, Adam Ford wrote:
> > > > > Add binding doc for fsl,spba-bus.
> > > > >
> > > > > Signed-off-by: Adam Ford <aford173@gmail.com>
> > > > > ---
> > > > > make dt_binding_check -j8 |grep spba
> > > > > DTEX Documentation/devicetree/bindings/bus/fsl,spba-bus.example.dts
> > > > > DTC Documentation/devicetree/bindings/bus/fsl,spba-bus.example.dt.yaml
> > > > > CHECK Documentation/devicetree/bindings/bus/fsl,spba-bus.example.dt.yaml
> > > > >
> > > > > V5: Rebase on 5.10-rc2 to be able to check yaml
> > > > > Add Reg entry
> > > > >
> > > > > V4: Remove an accidental makefile change
> > > > > Move type:object under additional properties
> > > > >
> > > > > V3: Rebase sample from aips-bus example
> > > > > Split off from series adding i.MX8M Nano functions to reduce noise
> > > > >
> > > > > V2: Attempted to update yaml from feedback
> > > > >
> > > >
> > > > Applied, thanks!
> > >
> > > Rob,
> > >
> > > I am not seeing this anywhere. Can you tell me where this was
> > > applied? It's not appearing in Linux-next
> >
> > Rob,
> >
> > Patchwork shows this has been accepted [1], however I don't see that
> > it's still applied.
> >
> >
> > [1] https://patchwork.ozlabs.org/project/devicetree-bindings/patch/20201118230414.121316-1-aford173@gmail.com/
> >
> > Can you apply it? It looks like building the device tree is throwing
> > messages because this is missing.
> >
>
> Shawn,
>
> Since you're the maintainer for the IMX stuff, can I update the
> MAINTAINERS file to add this yaml file under the IMX section? When
> building device trees, it throws a bunch of splat because this patch
> was never applied, and checkpatch is showing it wants a maintainer.
checkpatch warning on maintainer shouldn't be a problem. We don't
really want to bloat IMX entry in MAINTAINERS.
Shawn
^ permalink raw reply [flat|nested] 7+ messages in thread
end of thread, other threads:[~2021-11-20 10:14 UTC | newest]
Thread overview: 7+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-11-18 23:04 [PATCH V5] dt-bindings: soc: imx: Add binding doc for spba bus Adam Ford
2020-11-26 13:50 ` Adam Ford
2020-11-30 22:02 ` Rob Herring
2021-04-01 21:19 ` Adam Ford
2021-10-16 20:11 ` Adam Ford
2021-11-03 14:36 ` Adam Ford
2021-11-20 10:13 ` Shawn Guo
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).