[PATCH v2 4/4] dt-bindings: net: Document use of mac-address-increment

From: Ansuel Smith
Date: Sat Sep 19 2020 - 18:31:13 EST

Two new bindings are now supported by the of_net driver to increase (or
decrease) a mac-address. This can be very useful in case where the
system extract the mac-address for the device from a dedicated partition
and have a generic mac-address that needs to be incremented based on the
device number.
- mac-address-increment-byte is used to tell what byte must be
incremented (if not set the last byte is increased)
- mac-address-increment is used to tell how much to increment of the
extracted mac-address decided byte.

Signed-off-by: Ansuel Smith <ansuelsmth@xxxxxxxxx>
.../bindings/net/ethernet-controller.yaml | 19 +++++++++++++++++++
1 file changed, 19 insertions(+)

diff --git a/Documentation/devicetree/bindings/net/ethernet-controller.yaml b/Documentation/devicetree/bindings/net/ethernet-controller.yaml
index fa2baca8c726..43f2f21faf41 100644
--- a/Documentation/devicetree/bindings/net/ethernet-controller.yaml
+++ b/Documentation/devicetree/bindings/net/ethernet-controller.yaml
@@ -32,6 +32,25 @@ properties:
- minItems: 6
maxItems: 6

+ mac-address-increment:
+ description:
+ The MAC address can optionally be increased (or decreased using
+ negative values) from the original value readed (from a nvmem cell
+ for example). This can be used if the mac is readed from a dedicated
+ partition and must be increased based on the number of device
+ present in the system.
+ minimum: -255
+ maximum: 255
+ mac-address-increment-byte:
+ description:
+ If 'mac-address-increment' is defined, this will tell what byte of
+ the mac-address will be increased. If 'mac-address-increment' is
+ not defined, this option will do nothing.
+ default: 5
+ minimum: 0
+ maximum: 5
$ref: /schemas/types.yaml#definitions/uint32