Actually implement nvmem support for mtd
Subsystems (5)
v3 cover Actually implement nvmem support for mtd
The mtd support for the nvmem api has been stalled from 2018 with a patch half pushed hoping that a scheme is found for the mtd name later. This pathset try to address this and add a very needed feature for the mac-address.
My solution to the already discussed problem here [1] is to keep it simple. A mtd subpartition can be set as a nvmem-provider with a specific tag and each direct subnode is treat by the nvmem api as a nvmem-cell and gets correctly registred. The mtd driver will treat a direct subnode of the subpartition as a legacy subpartition of the subpartition using the 'fixed-partition' parser. To fix this every nvmem-cell has to have the 'nvmem-cell' tag and the fixed-partition parser will skip these node if this tag is detected. Simple as that. The subpartition with the tag 'nvmem-provider' will then be set by the config to not skip the of registration in the config and the nvmem-cells are correctly registred and can be used to set mac-address of the devices on the system.
The last 2 patch try to address a problem in the embedded devices (mostly routers) that have the mac-address saved in a dedicated partition and is a ""master"" mac-address. Each device increment or decrement the extracted mac-address based on the device number. The increment function is implemented in the of_net function to get the mac-address that every net driver should allready use if they don't have a trusty mac-address source. (One example of this implementation are many ath10k device that gets the mac-address from the art mtd partition assigned to the network driver and increments it 1 for the wifi 2.4ghz and 2 for the wifi 5ghz).
I really hope my mtd nvmem implementation doesn't conflicts with others and can be used, since this would remove many patch used to get mac-address and other nvmem data.
[1] https://lore.kernel.org/patchwork/patch/765435/
Changes:
v3:
* Fix const discard warning in of_net.c
* Add some info about overflow/underflow of mac-increment
* Limit mac-increment-bytes to the last 3 bytes v2:
* Fix compile error (missing mtd_node in mtdcore)
Ansuel Smith (4):
mtd: Add nvmem support for mtd nvmem-providers
dt-bindings: mtd: partition: Document use of nvmem-provider
of_net: add mac-address-increment support
dt-bindings: net: Document use of mac-address-increment
.../devicetree/bindings/mtd/partition.txt | 59 +++++++++++++++++++ .../bindings/net/ethernet-controller.yaml | 21 +++++++ drivers/mtd/mtdcore.c | 3 +- drivers/mtd/parsers/ofpart.c | 8 +++ drivers/of/of_net.c | 57 ++++++++++++++---- 5 files changed, 134 insertions(+), 14 deletions(-)
Signature · 1 line
2.27.0
PATCH v3 1/4 mtd: Add nvmem support for mtd nvmem-providers
Introduce 2 new bindings for the mtd structure.
Mtd partitions can be set as 'nvmem-provider' and any subpartition defined with the tag 'nvmem-cell' are skipped by the 'fixed-partitions' parser and registred as a nvmem cell by the nvmem api.
--- drivers/mtd/mtdcore.c | 3 ++- drivers/mtd/parsers/ofpart.c | 8 ++++++++ 2 files changed, 10 insertions(+), 1 deletion(-)
drivers/mtd/mtdcore.c +2 -1
@@ -551,6 +551,7 @@ static int mtd_nvmem_reg_read(void *priv, unsigned int offset,static int mtd_nvmem_add (struct mtd_info *mtd) { +struct device_node *mtd_node =mtd_get_of_node (mtd);struct nvmem_config config = {}; config.id =-1 ;
@@ -563,7 +564,7 @@ static int mtd_nvmem_add(struct mtd_info *mtd) config.stride =1 ; config.read_only = true; config.root_only = true; - config.no_of_node = true; + config.no_of_node = !of_property_read_bool (mtd_node,"nvmem-provider" ); config.priv = mtd; mtd->nvmem =nvmem_register (&config);
drivers/mtd/parsers/ofpart.c +8 -0
@@ -61,6 +61,10 @@ static int parse_fixed_partitions(struct mtd_info *master,if (!dedicated &&node_has_compatible (pp))continue ; +/* skip adding if a nvmem-cell is detected */ +if (of_property_read_bool (pp,"nvmem-cell" )) +continue ; + nr_parts++; }
@@ -80,6 +84,10 @@ static int parse_fixed_partitions(struct mtd_info *master,if (!dedicated &&node_has_compatible (pp))continue ; +/* skip adding if a nvmem-cell is detected */ +if (of_property_read_bool (pp,"nvmem-cell" )) +continue ; + reg =of_get_property (pp,"reg" , &len);if (!reg) {if (dedicated) {
Signature · 1 line
2.27.0
PATCH v3 2/4 dt-bindings: mtd: partition: Document use of nvmem-provider
In reply to Ansuel SmithDocument the use of this 2 new bindings, nvmem-provider and nvmem-cell, used to describe the nvmem cell that the subpartition provide to the nvmem api and the system. Nvmem cell are direct subnode of the subpartition and are skipped by the 'fixed-partitions' parser if they contain the 'nvmem-cell' tag. The subpartition must have the 'nvmem-provider' tag or the subpartition will not register the cell to the nvmem api.
--- .../devicetree/bindings/mtd/partition.txt | 59 +++++++++++++++++++ 1 file changed, 59 insertions(+)
Documentation/devicetree/bindings/mtd/partition.txt +59 -0
@@ -64,6 +64,16 @@ Optional properties: - slc-mode: This parameter, if present, allows one to emulate SLC mode on a partition attached to an MLC NAND thus making this partition immune to paired-pages corruptions +- nvmem-provider : Optionally a subpartition can be set as a nvmem-provider. This can + be very useful if some data like the mac-address is stored in a special partition + at a specific offset. Subpartition that describe nvmem-cell must have set the + 'nvmem-cell' of they will be treated as a subpartition and not skipped and registred + as nvmem cells. In this specific case '#address-cells' and '#size-cells' must be + provided. +- nvmem-cell : A direct subnode of a subpartition can be described as a nvmem-cell and + skipped by the fixed-partition parser and registred as a nvmem-cell of the registred + nvmem subpartition IF it does contain the 'nvmem-provider tag. If the subpartition + lacks of such tag the subnode will be skipped and the nvmem api won't register them. Examples:
@@ -158,3 +168,52 @@ flash@3 { }; }; }; + +flash@0 { + partitions { + compatible = "fixed-partitions"; + #address-cells = <1>; + #size-cells = <1>; + + partition@0 { + label = "u-boot"; + reg = <0x0000000 0x100000>; + read-only; + }; + + art: art@1200000 { + label = "art"; + reg = <0x1200000 0x0140000>; + read-only; + nvmem-provider; + + #address-cells = <1>; + #size-cells = <1>; + + macaddr_gmac1: macaddr_gmac1@0 { + nvmem-cell; + reg = <0x0 0x6>; + }; + + macaddr_gmac2: macaddr_gmac2@6 { + nvmem-cell; + reg = <0x6 0x6>; + }; + + macaddr_wifi: macaddr_wifi@6 { + nvmem-cell; + reg = <0x6 0x6>; + }; + + pre_cal_24g: pre_cal_24g@1000 { + nvmem-cell; + reg = <0x1000 0x2f20>; + }; + + pre_cal_5g: pre_cal_5g@5000{ + nvmem-cell; + reg = <0x5000 0x2f20>; + }; + }; + }; +};
Signature · 1 line
2.27.0
PATCH v3 3/4 of_net: add mac-address-increment support
In reply to Ansuel SmithLots of embedded devices use the mac-address of other interface extracted from nvmem cells and increments it by one or two. Add two bindings to integrate this and directly use the right mac-address for the interface. Some example are some routers that use the gmac mac-address stored in the art partition and increments it by one for the wifi. mac-address-increment-byte bindings is used to tell what byte of the mac-address has to be increased (if not defined the last byte is increased) and mac-address-increment tells how much the byte decided early has to be increased.
--- drivers/of/of_net.c | 57 ++++++++++++++++++++++++++++++++++----------- 1 file changed, 44 insertions(+), 13 deletions(-)
drivers/of/of_net.c +44 -13
@@ -45,7 +45,7 @@ int of_get_phy_mode(struct device_node *np, phy_interface_t *interface) }EXPORT_SYMBOL_GPL (of_get_phy_mode); -static const void *of_get_mac_addr (struct device_node *np,const char *name) +static void *of_get_mac_addr (struct device_node *np,const char *name) {struct property *pp =of_find_property (np, name,NULL );
@@ -54,26 +54,31 @@ static const void *of_get_mac_addr(struct device_node *np, const char *name)return NULL ; } -static const void *of_get_mac_addr_nvmem (struct device_node *np) +static void *of_get_mac_addr_nvmem (struct device_node *np,int *err) {int ret; -const void *mac; +void *mac;u8 nvmem_mac[ETH_ALEN ];struct platform_device *pdev =of_find_device_by_node (np); -if (!pdev) -return ERR_PTR (-ENODEV ); +if (!pdev) { + *err = -ENODEV ; +return NULL ; + } ret =nvmem_get_mac_address (&pdev->dev, &nvmem_mac);if (ret) {put_device (&pdev->dev); -return ERR_PTR (ret); + *err = ret; +return NULL ; } mac =devm_kmemdup (&pdev->dev, nvmem_mac,ETH_ALEN ,GFP_KERNEL );put_device (&pdev->dev); -if (!mac) -return ERR_PTR (-ENOMEM ); +if (!mac) { + *err = -ENOMEM ; +return NULL ; + }return mac; }
@@ -98,24 +103,50 @@ static const void *of_get_mac_addr_nvmem(struct device_node *np)* this case, the real MAC is in 'local-mac-address', and 'mac-address' exists * but is all zeros. * +* DT can tell the system to increment the mac-address after is extracted by +* using: +* - mac-address-increment-byte to decide what byte to increase +* (if not defined is increased the last byte) +* - mac-address-increment to decide how much to increase. The value will +* not overflow to other bytes if the increment is over 255. +* (example 00:01:02:03:04:ff + 1 == 00:01:02:03:04:00) +* * Return: Will be a valid pointer on success and ERR_PTR in case of error. */ const void *of_get_mac_address (struct device_node *np) { -const void *addr; +u32 inc_idx, mac_inc; +int ret =0 ; +u8 *addr; + +/* Check first if the increment byte is present and valid. +* If not set assume to increment the last byte if found. +*/ +if (of_property_read_u32 (np,"mac-address-increment-byte" , &inc_idx)) + inc_idx =5 ; +if (inc_idx <3 || inc_idx >5 ) +return ERR_PTR (-EINVAL ); addr =of_get_mac_addr (np,"mac-address" );if (addr) -return addr; + goto found; addr =of_get_mac_addr (np,"local-mac-address" );if (addr) -return addr; + goto found; addr =of_get_mac_addr (np,"address" );if (addr) -return addr; + goto found; + + addr =of_get_mac_addr_nvmem (np, &ret); +if (ret) +return ERR_PTR (ret); + +found: +if (!of_property_read_u32 (np,"mac-address-increment" , &mac_inc)) + addr[inc_idx] += mac_inc; -return of_get_mac_addr_nvmem (np); +return addr; }EXPORT_SYMBOL (of_get_mac_address);
Signature · 1 line
2.27.0
PATCH v3 4/4 dt-bindings: net: Document use of mac-address-increment
In reply to Ansuel SmithTwo 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.
--- .../bindings/net/ethernet-controller.yaml | 21 +++++++++++++++++++ 1 file changed, 21 insertions(+)
Documentation/devicetree/bindings/net/ethernet-controller.yaml +21 -0
@@ -32,6 +32,27 @@ 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 read (from a nvmem cell + for example). This can be used if the mac is read from a dedicated + partition and must be increased based on the number of device + present in the system. The increment will not overflow/underflow to + the other bytes if it's over 255 or 0. + (example 00:01:02:03:04:ff + 1 == 00:01:02:03:04:00) + 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: 3 + maximum: 5 + max-frame-size: $ref: /schemas/types.yaml#definitions/uint32 description:
Signature · 1 line
2.27.0
Re: [PATCH v3 3/4] of_net: add mac-address-increment support
In reply to Ansuel SmithQuoted 10 lines · Ansuel Smith
Lots of embedded devices use the mac-address of other interface extracted from nvmem cells and increments it by one or two. Add two bindings to integrate this and directly use the right mac-address for the interface. Some example are some routers that use the gmac mac-address stored in the art partition and increments it by one for the wifi. mac-address-increment-byte bindings is used to tell what byte of the mac-address has to be increased (if not defined the last byte is increased) and mac-address-increment tells how much the byte decided early has to be increased.
I'm inclined to say if there's a platform specific way to transform MAC addresses, then there should be platform specific code to do that which then stuffs the DT using standard properties. Otherwise, we have a never ending stream of 'generic' properties to try to handle different platforms' cases.
Rob
RE: [PATCH v3 3/4] of_net: add mac-address-increment support
Quoted 30 lines
-----Original Message-----
From: Rob Herring <[email protected]>
Sent: Friday, September 25, 2020 8:24 PM
To: Ansuel Smith <[email protected]>
Cc: Miquel Raynal <[email protected]>; Richard Weinberger <[email protected]>; Vignesh Raghavendra <[email protected]>; David S. Miller <[email protected]>; Jakub Kicinski <[email protected]>; Andrew Lunn <[email protected]>; Heiner Kallweit <[email protected]>; Russell King <[email protected]>; Frank Rowand <[email protected]>; Boris Brezillon <[email protected]>; MTD Maling List <[email protected]>; [email protected]; [email protected]; netdev <[email protected]>
Subject: Re: [PATCH v3 3/4]of_net: add mac-address-increment supportQuoted 10 lines · Ansuel Smith
Lots of embedded devices use the mac-address of other interface extracted from nvmem cells and increments it by one or two. Add two bindings to integrate this and directly use the right mac-address for the interface. Some example are some routers that use the gmac mac-address stored in the art partition and increments it by one for the wifi. mac-address-increment-byte bindings is used to tell what byte of the mac-address has to be increased (if not defined the last byte is increased) and mac-address-increment tells how much the byte decided early has to be increased.
Quoted 7 lines
I'm inclined to say if there's a platform specific way to transform MAC addresses, then there should be platform specific code to do that which then stuffs the DT using standard properties. Otherwise, we have a never ending stream of 'generic' properties to try to handle different platforms' cases.
Rob
I agree about the 'never ending stream'... But I think the increment feature is not that platform specific. I will quote some number by another patch that tried to implement the same feature in a different way, [1]
* mtd-mac-address used 497 times in 357 device tree files
* mtd-mac-address-increment used 74 times in 58 device tree files
* mtd-mac-address-increment-byte used 1 time in 1 device tree file
The mtd-mac-address is what this patchset is trying to fix with the nvmem support. The increment is much more than 74 times since it doesn't count SoC that have wifi integrated (it's common practice for SoC with integrated wifi to take the switch mac and use it to set the wifi mac) Actually what is really specific is the increment-byte that can be dropped if we really want to.
I still think the increment feature would be very useful to add full support for mac-address extracted from nvmem cell.
[1] https://patchwork.ozlabs.org/project/netdev/patch/[email protected]/