Re: [PATCH 1/3] dt-bindings: Add dt bindings for flex noc Performance Monitor

From: Rob Herring
Date: Thu Dec 05 2019 - 13:17:44 EST


On Mon, Nov 25, 2019 at 04:25:50PM +0530, shubhrajyoti.datta@xxxxxxxxx wrote:
> From: Shubhrajyoti Datta <shubhrajyoti.datta@xxxxxxxxxx>
>
> Add dt bindings for flexnoc Performance Monitor.
> The flexnoc counters for read and write response and requests are
> supported.
>
> Signed-off-by: Shubhrajyoti Datta <shubhrajyoti.datta@xxxxxxxxxx>
> ---
> changes from RFC:
> moved to schema / yaml
>
> .../devicetree/bindings/perf/xlnx-flexnoc-pm.yaml | 45 ++++++++++++++++++++++
> 1 file changed, 45 insertions(+)
> create mode 100644 Documentation/devicetree/bindings/perf/xlnx-flexnoc-pm.yaml
>
> diff --git a/Documentation/devicetree/bindings/perf/xlnx-flexnoc-pm.yaml b/Documentation/devicetree/bindings/perf/xlnx-flexnoc-pm.yaml
> new file mode 100644
> index 0000000..bd0f345
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/perf/xlnx-flexnoc-pm.yaml
> @@ -0,0 +1,45 @@
> +# SPDX-License-Identifier: GPL-2.0-or-later OR BSD-2-Clause

() around the licenses.

Are you good with GPL v10? Make it 'GPL-2.0-only' instead.

> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/perf/xlnx-flexnoc-pm.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: Xilinx flexnoc Performance Monitor device tree bindings
> +
> +maintainers:
> + - Arnd Bergmann <arnd@xxxxxxxx>
> + - Greg Kroah-Hartman <gregkh@xxxxxxxxxxxxxxxxxxx>

This should be someone familar with this h/w (you).

> +
> +properties:
> + compatible:
> + # Versal SoC based boards
> + items:
> + - enum:
> + - xlnx,flexnoc-pm-2.7
> +
> + reg:
> + items:
> + - description: funnel registers
> + - description: baselpd registers
> + - description: basefpd registers
> +
> + reg-names:
> + # The core schema enforces this is a string array
> + items:
> + - const: funnel
> + - const: baselpd
> + - const: basefpd
> +
> +required:
> + - compatible
> + - reg

No point having 'reg-names' if not required.


Add:

additionalProperties: false

> +
> +examples:
> + - |
> + performance-monitor@f0920000 {
> + compatible = "xlnx,flexnoc-pm-2.7";
> + reg-names = "funnel", "baselpd", "basefpd";
> + reg = <0x0 0xf0920000 0x0 0x1000>,
> + <0x0 0xf0980000 0x0 0x9000>,
> + <0x0 0xf0b80000 0x0 0x9000>;
> + };
> --
> 2.1.1
>