Re: [PATCH net-next 15/22] dt-bindings: can: mpfs: document the mpfs CAN controller

[<Conor.Dooley@microchip.com>]

On 25/06/2022 13:03, Marc Kleine-Budde wrote:
> EXTERNAL EMAIL: Do not click links or open attachments unless you know the content is safe
> 
> From: Conor Dooley <conor.dooley@microchip.com>
> 
> Add a binding for the CAN controller on PolarFire SoC (MPFS).
> 
> A data sheet and a register map can be downloaded at:
> 
> | https://www.microsemi.com/document-portal/doc_download/1245725-polarfire-soc-fpga-mss-technical-reference-manual
> | https://www.microsemi.com/document-portal/doc_download/1244581-polarfire-soc-register-map
> 
> An alternative location for the register map is:
> 
> | http://web.archive.org/web/20220403030214/https://www.microsemi.com/document-portal/doc_download/1244581-polarfire-soc-register-map

Frustratingly, it has not been possible to get the old URL updated.
The new URL for the register map is:
https://ww1.microchip.com/downloads/aemDocuments/documents/FPGA/ProductDocuments/SupportingCollateral/V1_4_Register_Map.zip

Apologies for the inconvenience...
Conor.

> 
> Link: https://lore.kernel.org/all/20220607065459.2035746-2-conor.dooley@microchip.com
> Signed-off-by: Conor Dooley <conor.dooley@microchip.com>
> Reviewed-by: Rob Herring <robh@kernel.org>
> [mkl: add link to data sheet and register map]
> Signed-off-by: Marc Kleine-Budde <mkl@pengutronix.de>
> ---
>   .../bindings/net/can/microchip,mpfs-can.yaml  | 45 +++++++++++++++++++
>   1 file changed, 45 insertions(+)
>   create mode 100644 Documentation/devicetree/bindings/net/can/microchip,mpfs-can.yaml
> 
> diff --git a/Documentation/devicetree/bindings/net/can/microchip,mpfs-can.yaml b/Documentation/devicetree/bindings/net/can/microchip,mpfs-can.yaml
> new file mode 100644
> index 000000000000..45aa3de7cf01
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/net/can/microchip,mpfs-can.yaml
> @@ -0,0 +1,45 @@
> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/net/can/microchip,mpfs-can.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title:
> +  Microchip PolarFire SoC (MPFS) can controller
> +
> +maintainers:
> +  - Conor Dooley <conor.dooley@microchip.com>
> +
> +allOf:
> +  - $ref: can-controller.yaml#
> +
> +properties:
> +  compatible:
> +    const: microchip,mpfs-can
> +
> +  reg:
> +    maxItems: 1
> +
> +  interrupts:
> +    maxItems: 1
> +
> +  clocks:
> +    maxItems: 1
> +
> +required:
> +  - compatible
> +  - reg
> +  - interrupts
> +  - clocks
> +
> +additionalProperties: false
> +
> +examples:
> +  - |
> +    can@2010c000 {
> +        compatible = "microchip,mpfs-can";
> +        reg = <0x2010c000 0x1000>;
> +        clocks = <&clkcfg 17>;
> +        interrupt-parent = <&plic>;
> +        interrupts = <56>;
> +    };
> --
> 2.35.1
> 
>