Re: [PATCH 6/7] dt-bindings: net: bgmac: add bindings documentation for bgmac

From: Arnd Bergmann
Date: Fri Jul 01 2016 - 05:44:31 EST


On Thursday, June 30, 2016 6:59:13 PM CEST Jon Mason wrote:
> +
> +Required properties:
> + - compatible: "brcm,bgmac-nsp"
> + - reg: Address and length of the GMAC registers,
> + Address and length of the GMAC IDM registers
> + - reg-names: Names of the registers. Must have both "gmac_base" and
> + "idm_base"
> + - interrupts: Interrupt number
> +


"brcm,bgmac-nsp" sounds a bit too general. As I understand, this is a family
of SoCs that might not all have the exact same implementation of this
ethernet device, as we can see from the long lookup table in bgmac_probe().

Please document the specific product numbers here that are publically
known already. Having the driver match just on "brcm,bgmac-nsp" as a fallback
is fine, so you can document that one as required for all users.

Arnd