Series comparison

-[PATCH v6 0/7] Add STM32MP25 SPI NOR support
+[PATCH v7 0/7] Add STM32MP25 SPI NOR support
 ...
 The device tree files adds Octo Memory Manager and its 2 associated Octo
 SPI chidren in stm32mp251.dtsi and adds SPI NOR support in stm32mp257f-ev1
 board.
 Signed-off-by: Patrice Chotard <patrice.chotard@foss.st.com>
+Changes in v7:
+  - update OMM's dt-bindings by updating :
+    - clock-names and reset-names properties.
+    - spi unit-address node.
+    - example.
+  - update stm32mp251.dtsi to match with OMM's bindings update.
+  - update stm32mp257f-ev1.dts to match with OMM's bindings update.
+  - Link to v6: https://lore.kernel.org/r/20250321-upstream_ospi_v6-v6-0-37bbcab43439@foss.st.com
 Changes in v6:
   - Update MAINTAINERS file.
   - Remove previous patch 1/8 and 2/8, merged by Mark Brown in spi git tree.
   - Fix Signed-off-by order for patch 3.
 ...

-[PATCH v6 1/7] MAINTAINERS: add entry for STM32 OCTO MEMORY MANAGER driver
+[PATCH v7 1/7] MAINTAINERS: add entry for STM32 OCTO MEMORY MANAGER driver
 Add myself as STM32 OCTO MEMORY MANAGER maintainer.
 Signed-off-by: Patrice Chotard <patrice.chotard@foss.st.com>
 ---
  MAINTAINERS | 6 ++++++
 file changed, 6 insertions(+)
 diff --git a/MAINTAINERS b/MAINTAINERS
 index XXXXXXX..XXXXXXX 100644
 --- a/MAINTAINERS
 +++ b/MAINTAINERS
 @@ -XXX,XX +XXX,XX @@ L:    linux-i2c@vger.kernel.org
  S:    Maintained
  F:    drivers/i2c/busses/i2c-stm32*
 +ST STM32 OCTO MEMORY MANAGER
 +M:    Patrice Chotard <patrice.chotard@foss.st.com>
 +S:    Maintained
 +F:    Documentation/devicetree/bindings/memory-controllers/st,stm32mp25-omm.yaml
 +F:    drivers/memory/stm32_omm.c
 +
  ST STM32 SPI DRIVER
  M:    Alain Volmat <alain.volmat@foss.st.com>
  L:    linux-spi@vger.kernel.org
 --
 .25.1

-[PATCH v6 2/7] dt-bindings: memory-controllers: Add STM32 Octo Memory Manager controller
+[PATCH v7 2/7] dt-bindings: memory-controllers: Add STM32 Octo Memory Manager controller
 ...
 +  "#size-cells":
 +    const: 1
 +
 +  ranges:
 +    description: |
-+      Reflects the memory layout with four integer values per OSPI instance.
++      Reflects the memory layout per OSPI instance.
 +      Format:
 +      <chip-select> 0 <registers base address> <size>
 +    minItems: 2
 +    maxItems: 2
 +
 ...
 +    items:
 +      - const: regs
 +      - const: memory_map
 +
 +  memory-region:
-+    description: |
++    description:
 +      Memory region shared between the 2 OCTOSPI instance.
 +      One or two phandle to a node describing a memory mapped region
 +      depending of child number.
 +    minItems: 1
 +    maxItems: 2
 +
 +  memory-region-names:
-+    description: |
++    description:
-+      OCTOSPI instance's name to which memory region is associated
++      Identify to which OSPI instance the memory region belongs to.
 +    items:
 +      enum: [ospi1, ospi2]
 +    minItems: 1
 +    maxItems: 2
 +
 +  clocks:
 +    minItems: 3
 +    maxItems: 3
 +
 +  clock-names:
 +    items:
-+      enum: [omm, ospi1, ospi2]
++      - const: omm
-+    minItems: 3
++      - const: ospi1
-+    maxItems: 3
++      - const: ospi2
 +
 +  resets:
 +    minItems: 3
 +    maxItems: 3
 +
 +  reset-names:
 +    items:
-+      enum: [omm, ospi1, ospi2]
++      - const: omm
-+    minItems: 3
++      - const: ospi1
-+    maxItems: 3
++      - const: ospi2
 +
 +  access-controllers:
 +    maxItems: 1
 +
 +  st,syscfg-amcr:
 ...
 +      - description: phandle to syscfg
 +      - description: register offset within syscfg
 +      - description: register bitmask for memory split
 +
 +  st,omm-req2ack-ns:
-+    description: |
++    description:
 +      In multiplexed mode (MUXEN = 1), this field defines the time in
 +      nanoseconds between two transactions.
 +    default: 0
 +
 +  st,omm-cssel-ovr:
 ...
 +
 +  power-domains:
 +    maxItems: 1
 +
 +patternProperties:
-+  ^spi@[a-f0-9]+$:
++  ^spi@[0-9]:
 +    type: object
 +    $ref: /schemas/spi/st,stm32mp25-ospi.yaml#
 +    description: Required spi child node
 +
 +required:
 ...
 +      st,syscfg-amcr = <&syscfg 0x2c00 0x7>;
 +      st,omm-req2ack-ns = <0>;
 +      st,omm-mux = <0>;
 +      st,omm-cssel-ovr = <0>;
 +
-+      spi@40430000 {
++      spi@0 {
 +        compatible = "st,stm32mp25-ospi";
 +        reg = <0 0 0x400>;
 +        memory-region = <&mm_ospi1>;
 +        interrupts = <GIC_SPI 163 IRQ_TYPE_LEVEL_HIGH>;
 +        dmas = <&hpdma 2 0x62 0x00003121 0x0>,
 ...
 +        #address-cells = <1>;
 +        #size-cells = <0>;
 +        st,syscfg-dlyb = <&syscfg 0x1000>;
 +      };
 +
-+      spi@40440000 {
++      spi@1 {
 +        compatible = "st,stm32mp25-ospi";
 +        reg = <1 0 0x400>;
 +        memory-region = <&mm_ospi1>;
 +        interrupts = <GIC_SPI 164 IRQ_TYPE_LEVEL_HIGH>;
 +        dmas = <&hpdma 3 0x62 0x00003121 0x0>,
 ...

-[PATCH v6 3/7] memory: Add STM32 Octo Memory Manager driver
+[PATCH v7 3/7] memory: Add STM32 Octo Memory Manager driver
 Octo Memory Manager driver (OMM) manages:
   - the muxing between 2 OSPI busses and 2 output ports.
     There are 4 possible muxing configurations:
       - direct mode (no multiplexing): OSPI1 output is on port 1 and OSPI2
         output is on port 2
       - OSPI1 and OSPI2 are multiplexed over the same output port 1
       - swapped mode (no multiplexing), OSPI1 output is on port 2,
         OSPI2 output is on port 1
       - OSPI1 and OSPI2 are multiplexed over the same output port 2
   - the split of the memory area shared between the 2 OSPI instances.
   - chip select selection override.
   - the time between 2 transactions in multiplexed mode.
   - check firewall access.
 Signed-off-by: Christophe Kerello <christophe.kerello@foss.st.com>
 Signed-off-by: Patrice Chotard <patrice.chotard@foss.st.com>
 ---
  drivers/memory/Kconfig     |  17 ++
  drivers/memory/Makefile    |   1 +
  drivers/memory/stm32_omm.c | 474 +++++++++++++++++++++++++++++++++++++++++++++
 files changed, 492 insertions(+)
 diff --git a/drivers/memory/Kconfig b/drivers/memory/Kconfig
 index XXXXXXX..XXXXXXX 100644
 --- a/drivers/memory/Kconfig
 +++ b/drivers/memory/Kconfig
 @@ -XXX,XX +XXX,XX @@ config STM32_FMC2_EBI
        devices (like SRAM, ethernet adapters, FPGAs, LCD displays, ...) on
        SOCs containing the FMC2 External Bus Interface.
 +config STM32_OMM
 +    tristate "STM32 Octo Memory Manager"
 +    depends on SPI_STM32_OSPI || COMPILE_TEST
 +    help
 +      This driver manages the muxing between the 2 OSPI busses and
 +      the 2 output ports. There are 4 possible muxing configurations:
 +      - direct mode (no multiplexing): OSPI1 output is on port 1 and OSPI2
 +           output is on port 2
 +      - OSPI1 and OSPI2 are multiplexed over the same output port 1
 +      - swapped mode (no multiplexing), OSPI1 output is on port 2,
 +           OSPI2 output is on port 1
 +      - OSPI1 and OSPI2 are multiplexed over the same output port 2
 +      It also manages :
 +        - the split of the memory area shared between the 2 OSPI instances.
 +        - chip select selection override.
 +        - the time between 2 transactions in multiplexed mode.
 +
  source "drivers/memory/samsung/Kconfig"
  source "drivers/memory/tegra/Kconfig"
 diff --git a/drivers/memory/Makefile b/drivers/memory/Makefile
 index XXXXXXX..XXXXXXX 100644
 --- a/drivers/memory/Makefile
 +++ b/drivers/memory/Makefile
 @@ -XXX,XX +XXX,XX @@ obj-$(CONFIG_DA8XX_DDRCTL)    += da8xx-ddrctl.o
  obj-$(CONFIG_PL353_SMC)        += pl353-smc.o
  obj-$(CONFIG_RENESAS_RPCIF)    += renesas-rpc-if.o
  obj-$(CONFIG_STM32_FMC2_EBI)    += stm32-fmc2-ebi.o
 +obj-$(CONFIG_STM32_OMM)        += stm32_omm.o
  obj-$(CONFIG_SAMSUNG_MC)    += samsung/
  obj-$(CONFIG_TEGRA_MC)        += tegra/
 diff --git a/drivers/memory/stm32_omm.c b/drivers/memory/stm32_omm.c
 new file mode 100644
 index XXXXXXX..XXXXXXX
 --- /dev/null
 +++ b/drivers/memory/stm32_omm.c
 @@ -XXX,XX +XXX,XX @@
 +// SPDX-License-Identifier: GPL-2.0
 +/*
 + * Copyright (C) STMicroelectronics 2025 - All Rights Reserved
 + * Author(s): Patrice Chotard <patrice.chotard@foss.st.com> for STMicroelectronics.
 + */
 +
 +#include <linux/bitfield.h>
 +#include <linux/bus/stm32_firewall_device.h>
 +#include <linux/clk.h>
 +#include <linux/err.h>
 +#include <linux/mfd/syscon.h>
 +#include <linux/mod_devicetable.h>
 +#include <linux/module.h>
 +#include <linux/of_address.h>
 +#include <linux/of_platform.h>
 +#include <linux/pinctrl/consumer.h>
 +#include <linux/pm_runtime.h>
 +#include <linux/regmap.h>
 +#include <linux/reset.h>
 +
 +#define OMM_CR            0
 +#define CR_MUXEN        BIT(0)
 +#define CR_MUXENMODE_MASK    GENMASK(1, 0)
 +#define CR_CSSEL_OVR_EN        BIT(4)
 +#define CR_CSSEL_OVR_MASK    GENMASK(6, 5)
 +#define CR_REQ2ACK_MASK        GENMASK(23, 16)
 +
 +#define OMM_CHILD_NB        2
 +#define OMM_CLK_NB        3
 +
 +struct stm32_omm {
 +    struct resource *mm_res;
 +    struct clk_bulk_data clk_bulk[OMM_CLK_NB];
 +    void __iomem *io_base;
 +    u32 cr;
 +    u8 nb_child;
 +    bool restore_omm;
 +};
 +
 +static int stm32_omm_set_amcr(struct device *dev, bool set)
 +{
 +    struct stm32_omm *omm = dev_get_drvdata(dev);
 +    resource_size_t mm_ospi2_size = 0;
 +    static const char * const mm_name[] = { "ospi1", "ospi2" };
 +    struct regmap *syscfg_regmap;
 +    struct device_node *node;
 +    struct resource res, res1;
 +    u32 amcr_base, amcr_mask;
 +    int ret, idx;
 +    unsigned int i, amcr, read_amcr;
 +
 +    for (i = 0; i < omm->nb_child; i++) {
 +        idx = of_property_match_string(dev->of_node,
 +                           "memory-region-names",
 +                           mm_name[i]);
 +        if (idx < 0)
 +            continue;
 +
 +        /* res1 only used on second loop iteration */
 +        res1.start = res.start;
 +        res1.end = res.end;
 +
 +        node = of_parse_phandle(dev->of_node, "memory-region", idx);
 +        if (!node)
 +            continue;
 +
 +        ret = of_address_to_resource(node, 0, &res);
 +        if (ret) {
 +            dev_err(dev, "unable to resolve memory region\n");
 +            return ret;
 +        }
 +
 +        /* check that memory region fits inside OMM memory map area */
 +        if (!resource_contains(omm->mm_res, &res)) {
 +            dev_err(dev, "%s doesn't fit inside OMM memory map area\n",
 +                mm_name[i]);
 +            dev_err(dev, "%pR doesn't fit inside %pR\n", &res, omm->mm_res);
 +
 +            return -EFAULT;
 +        }
 +
 +        if (i == 1) {
 +            mm_ospi2_size = resource_size(&res);
 +
 +            /* check that OMM memory region 1 doesn't overlap memory region 2 */
 +            if (resource_overlaps(&res, &res1)) {
 +                dev_err(dev, "OMM memory-region %s overlaps memory region %s\n",
 +                    mm_name[0], mm_name[1]);
 +                dev_err(dev, "%pR overlaps %pR\n", &res1, &res);
 +
 +                return -EFAULT;
 +            }
 +        }
 +    }
 +
 +    syscfg_regmap = syscon_regmap_lookup_by_phandle(dev->of_node, "st,syscfg-amcr");
 +    if (IS_ERR(syscfg_regmap))
 +        return dev_err_probe(dev, PTR_ERR(syscfg_regmap),
 +                     "Failed to get st,syscfg-amcr property\n");
 +
 +    ret = of_property_read_u32_index(dev->of_node, "st,syscfg-amcr", 1,
 +                     &amcr_base);
 +    if (ret)
 +        return ret;
 +
 +    ret = of_property_read_u32_index(dev->of_node, "st,syscfg-amcr", 2,
 +                     &amcr_mask);
 +    if (ret)
 +        return ret;
 +
 +    amcr = mm_ospi2_size / SZ_64M;
 +
 +    if (set)
 +        regmap_update_bits(syscfg_regmap, amcr_base, amcr_mask, amcr);
 +
 +    /* read AMCR and check coherency with memory-map areas defined in DT */
 +    regmap_read(syscfg_regmap, amcr_base, &read_amcr);
 +    read_amcr = read_amcr >> (ffs(amcr_mask) - 1);
 +
 +    if (amcr != read_amcr) {
 +        dev_err(dev, "AMCR value not coherent with DT memory-map areas\n");
 +        ret = -EINVAL;
 +    }
 +
 +    return ret;
 +}
 +
 +static int stm32_omm_toggle_child_clock(struct device *dev, bool enable)
 +{
 +    /* As there is only 2 children, remember first child in case of error */
 +    struct clk *first_child_clk = NULL;
 +    struct stm32_omm *omm = dev_get_drvdata(dev);
 +    u8 i;
 +    int ret;
 +
 +    for (i = 0; i < omm->nb_child; i++) {
 +        if (enable) {
 +            ret = clk_prepare_enable(omm->clk_bulk[i + 1].clk);
 +            if (ret) {
 +                if (first_child_clk)
 +                    clk_disable_unprepare(first_child_clk);
 +
 +                dev_err(dev, "Can not enable clock\n");
 +                return ret;
 +            }
 +        } else {
 +            clk_disable_unprepare(omm->clk_bulk[i + 1].clk);
 +        }
 +
 +        first_child_clk = omm->clk_bulk[i + 1].clk;
 +    }
 +
 +    return 0;
 +}
 +
 +static int stm32_omm_disable_child(struct device *dev)
 +{
 +    static const char * const resets_name[] = {"ospi1", "ospi2"};
 +    struct stm32_omm *omm = dev_get_drvdata(dev);
 +    struct reset_control *reset;
 +    int ret;
 +    u8 i;
 +
 +    ret = stm32_omm_toggle_child_clock(dev, true);
 +    if (!ret)
 +        return ret;
 +
 +    for (i = 0; i < omm->nb_child; i++) {
 +        reset = reset_control_get_exclusive(dev, resets_name[i]);
 +        if (IS_ERR(reset)) {
 +            dev_err(dev, "Can't get %s reset\n", resets_name[i]);
 +            return PTR_ERR(reset);
 +        };
 +
 +        /* reset OSPI to ensure CR_EN bit is set to 0 */
 +        reset_control_assert(reset);
 +        udelay(2);
 +        reset_control_deassert(reset);
 +
 +        reset_control_put(reset);
 +    }
 +
 +    return stm32_omm_toggle_child_clock(dev, false);
 +}
 +
 +static int stm32_omm_configure(struct device *dev)
 +{
 +    static const char * const clocks_name[] = {"omm", "ospi1", "ospi2"};
 +    struct stm32_omm *omm = dev_get_drvdata(dev);
 +    unsigned long clk_rate_max = 0;
 +    u32 mux = 0;
 +    u32 cssel_ovr = 0;
 +    u32 req2ack = 0;
 +    struct reset_control *rstc;
 +    unsigned long clk_rate;
 +    int ret;
 +    u8 i;
 +
 +    for (i = 0; i < OMM_CLK_NB; i++)
 +        omm->clk_bulk[i].id = clocks_name[i];
 +
 +    /* retrieve OMM, OSPI1 and OSPI2 clocks */
 +    ret = devm_clk_bulk_get(dev, OMM_CLK_NB, omm->clk_bulk);
 +    if (ret)
 +        return dev_err_probe(dev, ret, "Failed to get OMM/OSPI's clocks\n");
 +
 +    /* Ensure both OSPI instance are disabled before configuring OMM */
 +    ret = stm32_omm_disable_child(dev);
 +    if (ret)
 +        return ret;
 +
 +    ret = pm_runtime_resume_and_get(dev);
 +    if (ret < 0)
 +        return ret;
 +
 +    /* parse children's clock */
 +    for (i = 1; i <= omm->nb_child; i++) {
 +        clk_rate = clk_get_rate(omm->clk_bulk[i].clk);
 +        if (!clk_rate) {
 +            dev_err(dev, "Invalid clock rate\n");
 +            goto err_clk_disable;
 +        }
 +
 +        if (clk_rate > clk_rate_max)
 +            clk_rate_max = clk_rate;
 +    }
 +
 +    rstc = devm_reset_control_get_exclusive(dev, "omm");
 +    if (IS_ERR(rstc))
 +        return dev_err_probe(dev, PTR_ERR(rstc), "reset get failed\n");
 +
 +    reset_control_assert(rstc);
 +    udelay(2);
 +    reset_control_deassert(rstc);
 +
 +    omm->cr = readl_relaxed(omm->io_base + OMM_CR);
 +    /* optional */
 +    ret = of_property_read_u32(dev->of_node, "st,omm-mux", &mux);
 +    if (!ret) {
 +        if (mux & CR_MUXEN) {
 +            ret = of_property_read_u32(dev->of_node, "st,omm-req2ack-ns",
 +                           &req2ack);
 +            if (!ret && !req2ack) {
 +                req2ack = DIV_ROUND_UP(req2ack, NSEC_PER_SEC / clk_rate_max) - 1;
 +
 +                if (req2ack > 256)
 +                    req2ack = 256;
 +            }
 +
 +            req2ack = FIELD_PREP(CR_REQ2ACK_MASK, req2ack);
 +
 +            omm->cr &= ~CR_REQ2ACK_MASK;
 +            omm->cr |= FIELD_PREP(CR_REQ2ACK_MASK, req2ack);
 +
 +            /*
 +             * If the mux is enabled, the 2 OSPI clocks have to be
 +             * always enabled
 +             */
 +            ret = stm32_omm_toggle_child_clock(dev, true);
 +            if (ret)
 +                goto err_clk_disable;
 +        }
 +
 +        omm->cr &= ~CR_MUXENMODE_MASK;
 +        omm->cr |= FIELD_PREP(CR_MUXENMODE_MASK, mux);
 +    }
 +
 +    /* optional */
 +    ret = of_property_read_u32(dev->of_node, "st,omm-cssel-ovr", &cssel_ovr);
 +    if (!ret) {
 +        omm->cr &= ~CR_CSSEL_OVR_MASK;
 +        omm->cr |= FIELD_PREP(CR_CSSEL_OVR_MASK, cssel_ovr);
 +        omm->cr |= CR_CSSEL_OVR_EN;
 +    }
 +
 +    omm->restore_omm = true;
 +    writel_relaxed(omm->cr, omm->io_base + OMM_CR);
 +
 +    ret = stm32_omm_set_amcr(dev, true);
 +
 +err_clk_disable:
 +    pm_runtime_put_sync_suspend(dev);
 +
 +    return ret;
 +}
 +
 +static int stm32_omm_check_access(struct device_node *np)
 +{
 +    struct stm32_firewall firewall;
 +    int ret;
 +
 +    ret = stm32_firewall_get_firewall(np, &firewall, 1);
 +    if (ret)
 +        return ret;
 +
 +    return stm32_firewall_grant_access(&firewall);
 +}
 +
 +static int stm32_omm_probe(struct platform_device *pdev)
 +{
 +    struct device *dev = &pdev->dev;
 +    u8 child_access_granted = 0;
 +    struct stm32_omm *omm;
 +    int ret;
 +
 +    omm = devm_kzalloc(dev, sizeof(*omm), GFP_KERNEL);
 +    if (!omm)
 +        return -ENOMEM;
 +
 +    omm->io_base = devm_platform_ioremap_resource_byname(pdev, "regs");
 +    if (IS_ERR(omm->io_base))
 +        return PTR_ERR(omm->io_base);
 +
 +    omm->mm_res = platform_get_resource_byname(pdev, IORESOURCE_MEM, "memory_map");
 +    if (IS_ERR(omm->mm_res))
 +        return PTR_ERR(omm->mm_res);
 +
 +    /* check child's access */
 +    for_each_child_of_node_scoped(dev->of_node, child) {
 +        if (omm->nb_child >= OMM_CHILD_NB) {
 +            dev_err(dev, "Bad DT, found too much children\n");
 +            return -E2BIG;
 +        }
 +
 +        if (!of_device_is_compatible(child, "st,stm32mp25-omi"))
 +            return -EINVAL;
 +
 +        ret = stm32_omm_check_access(child);
 +        if (ret < 0 && ret != -EACCES)
 +            return ret;
 +
 +        if (!ret)
 +            child_access_granted++;
 +
 +        omm->nb_child++;
 +    }
 +
 +    if (omm->nb_child != OMM_CHILD_NB)
 +        return -EINVAL;
 +
 +    platform_set_drvdata(pdev, omm);
 +
 +    pm_runtime_enable(dev);
 +
 +    /* check if OMM's resource access is granted */
 +    ret = stm32_omm_check_access(dev->of_node);
 +    if (ret < 0 && ret != -EACCES)
 +        goto error;
 +
 +    if (!ret && child_access_granted == OMM_CHILD_NB) {
 +        ret = stm32_omm_configure(dev);
 +        if (ret)
 +            goto error;
 +    } else {
 +        dev_dbg(dev, "Octo Memory Manager resource's access not granted\n");
 +        /*
 +         * AMCR can't be set, so check if current value is coherent
 +         * with memory-map areas defined in DT
 +         */
 +        ret = stm32_omm_set_amcr(dev, false);
 +        if (ret)
 +            goto error;
 +    }
 +
 +    ret = of_platform_populate(dev->of_node, NULL, NULL, dev);
 +    if (ret) {
 +        dev_err(dev, "Failed to create Octo Memory Manager child\n");
 +        of_platform_depopulate(dev);
 +        ret = -EINVAL;
 +        goto error;
 +    }
 +
 +    return ret;
 +
 +error:
 +    pm_runtime_disable(dev);
 +
 +    return ret;
 +
 +}
 +
 +static void stm32_omm_remove(struct platform_device *pdev)
 +{
 +    struct stm32_omm *omm = platform_get_drvdata(pdev);
 +
 +    of_platform_depopulate(&pdev->dev);
 +    if (omm->cr & CR_MUXEN)
 +        stm32_omm_toggle_child_clock(&pdev->dev, false);
 +
 +    pm_runtime_disable(&pdev->dev);
 +}
 +
 +static const struct of_device_id stm32_omm_of_match[] = {
 +    { .compatible = "st,stm32mp25-omm", },
 +    {}
 +};
 +MODULE_DEVICE_TABLE(of, stm32_omm_of_match);
 +
 +static int __maybe_unused stm32_omm_runtime_suspend(struct device *dev)
 +{
 +    struct stm32_omm *omm = dev_get_drvdata(dev);
 +
 +    clk_disable_unprepare(omm->clk_bulk[0].clk);
 +
 +    return 0;
 +}
 +
 +static int __maybe_unused stm32_omm_runtime_resume(struct device *dev)
 +{
 +    struct stm32_omm *omm = dev_get_drvdata(dev);
 +
 +    return clk_prepare_enable(omm->clk_bulk[0].clk);
 +}
 +
 +static int __maybe_unused stm32_omm_suspend(struct device *dev)
 +{
 +    struct stm32_omm *omm = dev_get_drvdata(dev);
 +
 +    if (omm->restore_omm && omm->cr & CR_MUXEN)
 +        stm32_omm_toggle_child_clock(dev, false);
 +
 +    return pinctrl_pm_select_sleep_state(dev);
 +}
 +
 +static int __maybe_unused stm32_omm_resume(struct device *dev)
 +{
 +    struct stm32_omm *omm = dev_get_drvdata(dev);
 +    int ret;
 +
 +    pinctrl_pm_select_default_state(dev);
 +
 +    if (!omm->restore_omm)
 +        return 0;
 +
 +    /* Ensure both OSPI instance are disabled before configuring OMM */
 +    ret = stm32_omm_disable_child(dev);
 +    if (ret)
 +        return ret;
 +
 +    ret = pm_runtime_resume_and_get(dev);
 +    if (ret < 0)
 +        return ret;
 +
 +    writel_relaxed(omm->cr, omm->io_base + OMM_CR);
 +    ret = stm32_omm_set_amcr(dev, true);
 +    pm_runtime_put_sync_suspend(dev);
 +    if (ret)
 +        return ret;
 +
 +    if (omm->cr & CR_MUXEN)
 +        ret = stm32_omm_toggle_child_clock(dev, true);
 +
 +    return ret;
 +}
 +
 +static const struct dev_pm_ops stm32_omm_pm_ops = {
 +    SET_RUNTIME_PM_OPS(stm32_omm_runtime_suspend,
 +               stm32_omm_runtime_resume, NULL)
 +    SET_SYSTEM_SLEEP_PM_OPS(stm32_omm_suspend, stm32_omm_resume)
 +};
 +
 +static struct platform_driver stm32_omm_driver = {
 +    .probe    = stm32_omm_probe,
 +    .remove = stm32_omm_remove,
 +    .driver    = {
 +        .name = "stm32-omm",
 +        .of_match_table = stm32_omm_of_match,
 +        .pm = &stm32_omm_pm_ops,
 +    },
 +};
 +module_platform_driver(stm32_omm_driver);
 +
 +MODULE_DESCRIPTION("STMicroelectronics Octo Memory Manager driver");
 +MODULE_LICENSE("GPL");
 --
 .25.1

-[PATCH v6 4/7] arm64: dts: st: Add OMM node on stm32mp251
+[PATCH v7 4/7] arm64: dts: st: Add OMM node on stm32mp251
 ...
 +                #address-cells = <2>;
 +                #size-cells = <1>;
 +                st,syscfg-amcr = <&syscfg 0x2c00 0x7>;
 +                status = "disabled";
 +
-+                ospi1: spi@40430000 {
++                ospi1: spi@0 {
 +                    compatible = "st,stm32mp25-ospi";
 +                    reg = <0 0 0x400>;
 +                    interrupts = <GIC_SPI 163 IRQ_TYPE_LEVEL_HIGH>;
 +                    dmas = <&hpdma 2 0x62 0x00003121>,
 +                           <&hpdma 2 0x42 0x00003112>;
 ...
 +                    power-domains = <&CLUSTER_PD>;
 +                    st,syscfg-dlyb = <&syscfg 0x1000>;
 +                    status = "disabled";
 +                };
 +
-+                ospi2: spi@40440000 {
++                ospi2: spi@1 {
 +                    compatible = "st,stm32mp25-ospi";
 +                    reg = <1 0 0x400>;
 +                    interrupts = <GIC_SPI 164 IRQ_TYPE_LEVEL_HIGH>;
 +                    dmas = <&hpdma 3 0x62 0x00003121>,
 +                           <&hpdma 3 0x42 0x00003112>;
 ...

-[PATCH v6 5/7] arm64: dts: st: Add ospi port1 pinctrl entries in stm32mp25-pinctrl.dtsi
+[PATCH v7 5/7] arm64: dts: st: Add ospi port1 pinctrl entries in stm32mp25-pinctrl.dtsi
 Add pinctrl entry related to OSPI's port1 in stm32mp25-pinctrl.dtsi
 Signed-off-by: Patrice Chotard <patrice.chotard@foss.st.com>
 ---
  arch/arm64/boot/dts/st/stm32mp25-pinctrl.dtsi | 51 +++++++++++++++++++++++++++
 file changed, 51 insertions(+)
 diff --git a/arch/arm64/boot/dts/st/stm32mp25-pinctrl.dtsi b/arch/arm64/boot/dts/st/stm32mp25-pinctrl.dtsi
 index XXXXXXX..XXXXXXX 100644
 --- a/arch/arm64/boot/dts/st/stm32mp25-pinctrl.dtsi
 +++ b/arch/arm64/boot/dts/st/stm32mp25-pinctrl.dtsi
 @@ -XXX,XX +XXX,XX @@ pins2 {
          };
      };
 +    ospi_port1_clk_pins_a: ospi-port1-clk-0 {
 +        pins {
 +            pinmux = <STM32_PINMUX('D', 0, AF10)>; /* OSPI1_CLK */
 +            bias-disable;
 +            drive-push-pull;
 +            slew-rate = <2>;
 +        };
 +    };
 +
 +    ospi_port1_clk_sleep_pins_a: ospi-port1-clk-sleep-0 {
 +        pins {
 +            pinmux = <STM32_PINMUX('D', 0, ANALOG)>; /* OSPI1_CLK */
 +        };
 +    };
 +
 +    ospi_port1_cs0_pins_a: ospi-port1-cs0-0 {
 +        pins {
 +            pinmux = <STM32_PINMUX('D', 3, AF10)>; /* OSPI_NCS0 */
 +            bias-pull-up;
 +            drive-push-pull;
 +            slew-rate = <0>;
 +        };
 +    };
 +
 +    ospi_port1_cs0_sleep_pins_a: ospi-port1-cs0-sleep-0 {
 +        pins {
 +            pinmux = <STM32_PINMUX('D', 3, ANALOG)>; /* OSPI_NCS0 */
 +        };
 +    };
 +
 +    ospi_port1_io03_pins_a: ospi-port1-io03-0 {
 +        pins {
 +            pinmux = <STM32_PINMUX('D', 4, AF10)>, /* OSPI_IO0 */
 +                 <STM32_PINMUX('D', 5, AF10)>, /* OSPI_IO1 */
 +                 <STM32_PINMUX('D', 6, AF10)>, /* OSPI_IO2 */
 +                 <STM32_PINMUX('D', 7, AF10)>; /* OSPI_IO3 */
 +            bias-disable;
 +            drive-push-pull;
 +            slew-rate = <0>;
 +        };
 +    };
 +
 +    ospi_port1_io03_sleep_pins_a: ospi-port1-io03-sleep-0 {
 +        pins {
 +            pinmux = <STM32_PINMUX('D', 4, ANALOG)>, /* OSPI_IO0 */
 +                 <STM32_PINMUX('D', 5, ANALOG)>, /* OSPI_IO1 */
 +                 <STM32_PINMUX('D', 6, ANALOG)>, /* OSPI_IO2 */
 +                 <STM32_PINMUX('D', 7, ANALOG)>; /* OSPI_IO3 */
 +        };
 +    };
 +
      sdmmc1_b4_od_pins_a: sdmmc1-b4-od-0 {
          pins1 {
              pinmux = <STM32_PINMUX('E', 4, AF10)>, /* SDMMC1_D0 */
 --
 .25.1

-[PATCH v6 6/7] arm64: dts: st: Add SPI NOR flash support on stm32mp257f-ev1 board
+[PATCH v7 6/7] arm64: dts: st: Add SPI NOR flash support on stm32mp257f-ev1 board
 ...
 +             &ospi_port1_io03_sleep_pins_a
 +             &ospi_port1_cs0_sleep_pins_a>;
 +    pinctrl-names = "default", "sleep";
 +    status = "okay";
 +
-+    spi@40430000 {
++    spi@0 {
 +        #address-cells = <1>;
 +        #size-cells = <0>;
 +        memory-region = <&mm_ospi1>;
 +        status = "okay";
 +
 ...

-[PATCH v6 7/7] arm64: defconfig: Enable STM32 Octo Memory Manager and OcstoSPI driver
+[PATCH v7 7/7] arm64: defconfig: Enable STM32 Octo Memory Manager and OcstoSPI driver
 Enable STM32 OctoSPI driver.
 Enable STM32 Octo Memory Manager (OMM) driver which is needed
 for OSPI usage on STM32MP257F-EV1 board.
 Signed-off-by: Patrice Chotard <patrice.chotard@foss.st.com>
 ---
  arch/arm64/configs/defconfig | 2 ++
 file changed, 2 insertions(+)
 diff --git a/arch/arm64/configs/defconfig b/arch/arm64/configs/defconfig
 index XXXXXXX..XXXXXXX 100644
 --- a/arch/arm64/configs/defconfig
 +++ b/arch/arm64/configs/defconfig
 @@ -XXX,XX +XXX,XX @@ CONFIG_SPI_QUP=y
  CONFIG_SPI_QCOM_GENI=m
  CONFIG_SPI_S3C64XX=y
  CONFIG_SPI_SH_MSIOF=m
 +CONFIG_SPI_STM32_OSPI=m
  CONFIG_SPI_SUN6I=y
  CONFIG_SPI_TEGRA210_QUAD=m
  CONFIG_SPI_TEGRA114=m
 @@ -XXX,XX +XXX,XX @@ CONFIG_EXTCON_USB_GPIO=y
  CONFIG_EXTCON_USBC_CROS_EC=y
  CONFIG_FSL_IFC=y
  CONFIG_RENESAS_RPCIF=m
 +CONFIG_STM32_OMM=m
  CONFIG_IIO=y
  CONFIG_EXYNOS_ADC=y
  CONFIG_IMX8QXP_ADC=m
 --
 .25.1

This series adds SPI NOR support for STM32MP25 SoCs from STMicroelectronics.

On STM32MP25 SoCs family, an Octo Memory Manager block manages the muxing,
the memory area split, the chip select override and the time constraint
between its 2 Octo SPI children.

Due to these depedencies, this series adds support for:
  - Octo Memory Manager driver.
  - Octo SPI driver.
  - yaml schema for Octo Memory Manager and Octo SPI drivers.

The device tree files adds Octo Memory Manager and its 2 associated Octo
SPI chidren in stm32mp251.dtsi and adds SPI NOR support in stm32mp257f-ev1
board.
    
Signed-off-by: Patrice Chotard <patrice.chotard@foss.st.com>

Changes in v6:
  - Update MAINTAINERS file.
  - Remove previous patch 1/8 and 2/8, merged by Mark Brown in spi git tree.
  - Fix Signed-off-by order for patch 3.
  - OMM driver:
    - Add dev_err_probe() in error path.
    - Rename stm32_omm_enable_child_clock() to stm32_omm_toggle_child_clock().
    - Reorder initialised/non-initialized variable in stm32_omm_configure()
          and stm32_omm_probe().
    - Move pm_runtime_disable() calls from stm32_omm_configure() to
      stm32_omm_probe().
    - Update children's clocks and reset management.
    - Use of_platform_populate() to probe children.
    - Add missing pm_runtime_disable().
    - Remove useless stm32_omm_check_access's first parameter.
  - Update OMM's dt-bindings by adding OSPI's clocks and resets.
  - Update stm32mp251.dtsi by adding OSPI's clock and reset in OMM's node.

Changes in v5:
  - Add Reviewed-by Krzysztof Kozlowski for patch 1 and 3.

Changes in v4:
  - Add default value requested by Krzysztof for st,omm-req2ack-ns,
    st,omm-cssel-ovr and st,omm-mux properties in st,stm32mp25-omm.yaml
  - Remove constraint in free form test for st,omm-mux property.
  - Fix drivers/memory/Kconfig by replacing TEST_COMPILE_ by COMPILE_TEST.
  - Fix SPDX-License-Identifier for stm32-omm.c.
  - Fix Kernel test robot by fixing dev_err() format in stm32-omm.c.
  - Add missing pm_runtime_disable() in the error handling path in
    stm32-omm.c.
  - Replace an int by an unsigned int in stm32-omm.c
  - Remove uneeded "," after terminator in stm32-omm.c.
  - Update cover letter description to explain dependecies between
Octo Memory Manager and its 2 Octo SPI children.

Changes in v3:
  - Squash defconfig patches 8 and 9.
  - Update STM32 Octo Memory Manager controller bindings.
  - Rename st,stm32-omm.yaml to st,stm32mp25-omm.yaml.
  - Update STM32 OSPI controller bindings.
  - Reorder DT properties in .dtsi and .dts files.
  - Replace devm_reset_control_get_optional() by
    devm_reset_control_get_optional_exclusive() in stm32_omm.c.
  - Reintroduce region-memory-names management in stm32_omm.c.
  - Rename stm32_ospi_tx_poll() and stm32_ospi_tx() to respectively to
    stm32_ospi_poll() and stm32_ospi_xfer() in spi-stm32-ospi.c.
  - Set SPI_CONTROLLER_HALF_DUPLEX in controller flags in spi-stm32-ospi.c.

Changes in v2:
  - Move STM32 Octo Memory Manager controller driver and bindings from
    misc to memory-controllers.
  - Update STM32 OSPI controller bindings.
  - Update STM32 Octo Memory Manager controller bindings.
  - Update STM32 Octo Memory Manager driver to match bindings update.
  - Update DT to match bindings update.

Signed-off-by: Patrice Chotard <patrice.chotard@foss.st.com>
---
Patrice Chotard (7):
      MAINTAINERS: add entry for STM32 OCTO MEMORY MANAGER driver
      dt-bindings: memory-controllers: Add STM32 Octo Memory Manager controller
      memory: Add STM32 Octo Memory Manager driver
      arm64: dts: st: Add OMM node on stm32mp251
      arm64: dts: st: Add ospi port1 pinctrl entries in stm32mp25-pinctrl.dtsi
      arm64: dts: st: Add SPI NOR flash support on stm32mp257f-ev1 board
      arm64: defconfig: Enable STM32 Octo Memory Manager and OcstoSPI driver

.../memory-controllers/st,stm32mp25-omm.yaml       | 227 ++++++++++
 MAINTAINERS                                        |   6 +
 arch/arm64/boot/dts/st/stm32mp25-pinctrl.dtsi      |  51 +++
 arch/arm64/boot/dts/st/stm32mp251.dtsi             |  54 +++
 arch/arm64/boot/dts/st/stm32mp257f-ev1.dts         |  32 ++
 arch/arm64/configs/defconfig                       |   2 +
 drivers/memory/Kconfig                             |  17 +
 drivers/memory/Makefile                            |   1 +
 drivers/memory/stm32_omm.c                         | 474 +++++++++++++++++++++
 9 files changed, 864 insertions(+)
---
base-commit: 88424abd55ab36c3565898a656589a0a25ecd92f
change-id: 20250320-upstream_ospi_v6-d432a8172105

Best regards,
-- 
Patrice Chotard <patrice.chotard@foss.st.com>

Add bindings for STM32 Octo Memory Manager (OMM) controller.

OMM manages:
  - the muxing between 2 OSPI busses and 2 output ports.
    There are 4 possible muxing configurations:
      - direct mode (no multiplexing): OSPI1 output is on port 1 and OSPI2
        output is on port 2
      - OSPI1 and OSPI2 are multiplexed over the same output port 1
      - swapped mode (no multiplexing), OSPI1 output is on port 2,
        OSPI2 output is on port 1
      - OSPI1 and OSPI2 are multiplexed over the same output port 2
  - the split of the memory area shared between the 2 OSPI instances.
  - chip select selection override.
  - the time between 2 transactions in multiplexed mode.

Signed-off-by: Patrice Chotard <patrice.chotard@foss.st.com>
---
 .../memory-controllers/st,stm32mp25-omm.yaml       | 227 +++++++++++++++++++++
 1 file changed, 227 insertions(+)

diff --git a/Documentation/devicetree/bindings/memory-controllers/st,stm32mp25-omm.yaml b/Documentation/devicetree/bindings/memory-controllers/st,stm32mp25-omm.yaml
new file mode 100644
index XXXXXXX..XXXXXXX
--- /dev/null
+++ b/Documentation/devicetree/bindings/memory-controllers/st,stm32mp25-omm.yaml
@@ -XXX,XX +XXX,XX @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/memory-controllers/st,stm32mp25-omm.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: STM32 Octo Memory Manager (OMM)
+
+maintainers:
+  - Patrice Chotard <patrice.chotard@foss.st.com>
+
+description: |
+  The STM32 Octo Memory Manager is a low-level interface that enables an
+  efficient OCTOSPI pin assignment with a full I/O matrix (before alternate
+  function map) and multiplex of single/dual/quad/octal SPI interfaces over
+  the same bus. It Supports up to:
+    - Two single/dual/quad/octal SPI interfaces
+    - Two ports for pin assignment
+
+properties:
+  compatible:
+    const: st,stm32mp25-omm
+
+  "#address-cells":
+    const: 2
+
+  "#size-cells":
+    const: 1
+
+  ranges:
+    description: |
+      Reflects the memory layout with four integer values per OSPI instance.
+      Format:
+      <chip-select> 0 <registers base address> <size>
+    minItems: 2
+    maxItems: 2
+
+  reg:
+    items:
+      - description: OMM registers
+      - description: OMM memory map area
+
+  reg-names:
+    items:
+      - const: regs
+      - const: memory_map
+
+  memory-region:
+    description: |
+      Memory region shared between the 2 OCTOSPI instance.
+      One or two phandle to a node describing a memory mapped region
+      depending of child number.
+    minItems: 1
+    maxItems: 2
+
+  memory-region-names:
+    description: |
+      OCTOSPI instance's name to which memory region is associated
+    items:
+      enum: [ospi1, ospi2]
+    minItems: 1
+    maxItems: 2
+
+  clocks:
+    minItems: 3
+    maxItems: 3
+
+  clock-names:
+    items:
+      enum: [omm, ospi1, ospi2]
+    minItems: 3
+    maxItems: 3
+
+  resets:
+    minItems: 3
+    maxItems: 3
+
+  reset-names:
+    items:
+      enum: [omm, ospi1, ospi2]
+    minItems: 3
+    maxItems: 3
+
+  access-controllers:
+    maxItems: 1
+
+  st,syscfg-amcr:
+    $ref: /schemas/types.yaml#/definitions/phandle-array
+    description: |
+      The Address Mapping Control Register (AMCR) is used to split the 256MB
+      memory map area shared between the 2 OSPI instance. The Octo Memory
+      Manager sets the AMCR depending of the memory-region configuration.
+      The memory split bitmask description is:
+        - 000: OCTOSPI1 (256 Mbytes), OCTOSPI2 unmapped
+        - 001: OCTOSPI1 (192 Mbytes), OCTOSPI2 (64 Mbytes)
+        - 010: OCTOSPI1 (128 Mbytes), OCTOSPI2 (128 Mbytes)
+        - 011: OCTOSPI1 (64 Mbytes), OCTOSPI2 (192 Mbytes)
+        - 1xx: OCTOSPI1 unmapped, OCTOSPI2 (256 Mbytes)
+    items:
+      - description: phandle to syscfg
+      - description: register offset within syscfg
+      - description: register bitmask for memory split
+
+  st,omm-req2ack-ns:
+    description: |
+      In multiplexed mode (MUXEN = 1), this field defines the time in
+      nanoseconds between two transactions.
+    default: 0
+
+  st,omm-cssel-ovr:
+    $ref: /schemas/types.yaml#/definitions/uint32
+    description: |
+      Configure the chip select selector override for the 2 OCTOSPIs.
+      - 0: OCTOSPI1 chip select send to NCS1 OCTOSPI2 chip select send to NCS1
+      - 1: OCTOSPI1 chip select send to NCS2 OCTOSPI2 chip select send to NCS1
+      - 2: OCTOSPI1 chip select send to NCS1 OCTOSPI2 chip select send to NCS2
+      - 3: OCTOSPI1 chip select send to NCS2 OCTOSPI2 chip select send to NCS2
+    minimum: 0
+    maximum: 3
+    default: 0
+
+  st,omm-mux:
+    $ref: /schemas/types.yaml#/definitions/uint32
+    description: |
+      Configure the muxing between the 2 OCTOSPIs busses and the 2 output ports.
+      - 0: direct mode
+      - 1: mux OCTOSPI1 and OCTOSPI2 to port 1
+      - 2: swapped mode
+      - 3: mux OCTOSPI1 and OCTOSPI2 to port 2
+    minimum: 0
+    maximum: 3
+    default: 0
+
+  power-domains:
+    maxItems: 1
+
+patternProperties:
+  ^spi@[a-f0-9]+$:
+    type: object
+    $ref: /schemas/spi/st,stm32mp25-ospi.yaml#
+    description: Required spi child node
+
+required:
+  - compatible
+  - reg
+  - "#address-cells"
+  - "#size-cells"
+  - clocks
+  - clock-names
+  - resets
+  - reset-names
+  - st,syscfg-amcr
+  - ranges
+
+additionalProperties: false
+
+examples:
+  - |
+    #include <dt-bindings/clock/st,stm32mp25-rcc.h>
+    #include <dt-bindings/interrupt-controller/arm-gic.h>
+    #include <dt-bindings/reset/st,stm32mp25-rcc.h>
+    ommanager@40500000 {
+      compatible = "st,stm32mp25-omm";
+      reg = <0x40500000 0x400>, <0x60000000 0x10000000>;
+      reg-names = "regs", "memory_map";
+      ranges = <0 0 0x40430000 0x400>,
+               <1 0 0x40440000 0x400>;
+      memory-region = <&mm_ospi1>, <&mm_ospi2>;
+      memory-region-names = "ospi1", "ospi2";
+      pinctrl-0 = <&ospi_port1_clk_pins_a
+                   &ospi_port1_io03_pins_a
+                   &ospi_port1_cs0_pins_a>;
+      pinctrl-1 = <&ospi_port1_clk_sleep_pins_a
+                   &ospi_port1_io03_sleep_pins_a
+                   &ospi_port1_cs0_sleep_pins_a>;
+      pinctrl-names = "default", "sleep";
+      clocks = <&rcc CK_BUS_OSPIIOM>,
+               <&scmi_clk CK_SCMI_OSPI1>,
+               <&scmi_clk CK_SCMI_OSPI2>;
+      clock-names = "omm", "ospi1", "ospi2";
+      resets = <&rcc OSPIIOM_R>,
+               <&scmi_reset RST_SCMI_OSPI1>,
+               <&scmi_reset RST_SCMI_OSPI2>;
+      reset-names = "omm", "ospi1", "ospi2";
+      access-controllers = <&rifsc 111>;
+      power-domains = <&CLUSTER_PD>;
+      #address-cells = <2>;
+      #size-cells = <1>;
+      st,syscfg-amcr = <&syscfg 0x2c00 0x7>;
+      st,omm-req2ack-ns = <0>;
+      st,omm-mux = <0>;
+      st,omm-cssel-ovr = <0>;
+
+      spi@40430000 {
+        compatible = "st,stm32mp25-ospi";
+        reg = <0 0 0x400>;
+        memory-region = <&mm_ospi1>;
+        interrupts = <GIC_SPI 163 IRQ_TYPE_LEVEL_HIGH>;
+        dmas = <&hpdma 2 0x62 0x00003121 0x0>,
+               <&hpdma 2 0x42 0x00003112 0x0>;
+        dma-names = "tx", "rx";
+        clocks = <&scmi_clk CK_SCMI_OSPI1>;
+        resets = <&scmi_reset RST_SCMI_OSPI1>, <&scmi_reset RST_SCMI_OSPI1DLL>;
+        access-controllers = <&rifsc 74>;
+        power-domains = <&CLUSTER_PD>;
+        #address-cells = <1>;
+        #size-cells = <0>;
+        st,syscfg-dlyb = <&syscfg 0x1000>;
+      };
+
+      spi@40440000 {
+        compatible = "st,stm32mp25-ospi";
+        reg = <1 0 0x400>;
+        memory-region = <&mm_ospi1>;
+        interrupts = <GIC_SPI 164 IRQ_TYPE_LEVEL_HIGH>;
+        dmas = <&hpdma 3 0x62 0x00003121 0x0>,
+               <&hpdma 3 0x42 0x00003112 0x0>;
+        dma-names = "tx", "rx";
+        clocks = <&scmi_clk CK_KER_OSPI2>;
+        resets = <&scmi_reset RST_SCMI_OSPI2>, <&scmi_reset RST_SCMI_OSPI1DLL>;
+        access-controllers = <&rifsc 75>;
+        power-domains = <&CLUSTER_PD>;
+        #address-cells = <1>;
+        #size-cells = <0>;
+        st,syscfg-dlyb = <&syscfg 0x1000>;
+      };
+    };

-- 
2.25.1

Octo Memory Manager driver (OMM) manages:
  - the muxing between 2 OSPI busses and 2 output ports.
    There are 4 possible muxing configurations:
      - direct mode (no multiplexing): OSPI1 output is on port 1 and OSPI2
        output is on port 2
      - OSPI1 and OSPI2 are multiplexed over the same output port 1
      - swapped mode (no multiplexing), OSPI1 output is on port 2,
        OSPI2 output is on port 1
      - OSPI1 and OSPI2 are multiplexed over the same output port 2
  - the split of the memory area shared between the 2 OSPI instances.
  - chip select selection override.
  - the time between 2 transactions in multiplexed mode.
  - check firewall access.

Signed-off-by: Christophe Kerello <christophe.kerello@foss.st.com>
Signed-off-by: Patrice Chotard <patrice.chotard@foss.st.com>
---
 drivers/memory/Kconfig     |  17 ++
 drivers/memory/Makefile    |   1 +
 drivers/memory/stm32_omm.c | 474 +++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 492 insertions(+)

diff --git a/drivers/memory/Kconfig b/drivers/memory/Kconfig
index XXXXXXX..XXXXXXX 100644
--- a/drivers/memory/Kconfig
+++ b/drivers/memory/Kconfig
@@ -XXX,XX +XXX,XX @@ config STM32_FMC2_EBI
 	  devices (like SRAM, ethernet adapters, FPGAs, LCD displays, ...) on
 	  SOCs containing the FMC2 External Bus Interface.
 
+config STM32_OMM
+	tristate "STM32 Octo Memory Manager"
+	depends on SPI_STM32_OSPI || COMPILE_TEST
+	help
+	  This driver manages the muxing between the 2 OSPI busses and
+	  the 2 output ports. There are 4 possible muxing configurations:
+	  - direct mode (no multiplexing): OSPI1 output is on port 1 and OSPI2
+	       output is on port 2
+	  - OSPI1 and OSPI2 are multiplexed over the same output port 1
+	  - swapped mode (no multiplexing), OSPI1 output is on port 2,
+	       OSPI2 output is on port 1
+	  - OSPI1 and OSPI2 are multiplexed over the same output port 2
+	  It also manages :
+	    - the split of the memory area shared between the 2 OSPI instances.
+	    - chip select selection override.
+	    - the time between 2 transactions in multiplexed mode.
+
 source "drivers/memory/samsung/Kconfig"
 source "drivers/memory/tegra/Kconfig"
 
diff --git a/drivers/memory/Makefile b/drivers/memory/Makefile
index XXXXXXX..XXXXXXX 100644
--- a/drivers/memory/Makefile
+++ b/drivers/memory/Makefile
@@ -XXX,XX +XXX,XX @@ obj-$(CONFIG_DA8XX_DDRCTL)	+= da8xx-ddrctl.o
 obj-$(CONFIG_PL353_SMC)		+= pl353-smc.o
 obj-$(CONFIG_RENESAS_RPCIF)	+= renesas-rpc-if.o
 obj-$(CONFIG_STM32_FMC2_EBI)	+= stm32-fmc2-ebi.o
+obj-$(CONFIG_STM32_OMM)		+= stm32_omm.o
 
 obj-$(CONFIG_SAMSUNG_MC)	+= samsung/
 obj-$(CONFIG_TEGRA_MC)		+= tegra/
diff --git a/drivers/memory/stm32_omm.c b/drivers/memory/stm32_omm.c
new file mode 100644
index XXXXXXX..XXXXXXX
--- /dev/null
+++ b/drivers/memory/stm32_omm.c
@@ -XXX,XX +XXX,XX @@
+// SPDX-License-Identifier: GPL-2.0
+/*
+ * Copyright (C) STMicroelectronics 2025 - All Rights Reserved
+ * Author(s): Patrice Chotard <patrice.chotard@foss.st.com> for STMicroelectronics.
+ */
+
+#include <linux/bitfield.h>
+#include <linux/bus/stm32_firewall_device.h>
+#include <linux/clk.h>
+#include <linux/err.h>
+#include <linux/mfd/syscon.h>
+#include <linux/mod_devicetable.h>
+#include <linux/module.h>
+#include <linux/of_address.h>
+#include <linux/of_platform.h>
+#include <linux/pinctrl/consumer.h>
+#include <linux/pm_runtime.h>
+#include <linux/regmap.h>
+#include <linux/reset.h>
+
+#define OMM_CR			0
+#define CR_MUXEN		BIT(0)
+#define CR_MUXENMODE_MASK	GENMASK(1, 0)
+#define CR_CSSEL_OVR_EN		BIT(4)
+#define CR_CSSEL_OVR_MASK	GENMASK(6, 5)
+#define CR_REQ2ACK_MASK		GENMASK(23, 16)
+
+#define OMM_CHILD_NB		2
+#define OMM_CLK_NB		3
+
+struct stm32_omm {
+	struct resource *mm_res;
+	struct clk_bulk_data clk_bulk[OMM_CLK_NB];
+	void __iomem *io_base;
+	u32 cr;
+	u8 nb_child;
+	bool restore_omm;
+};
+
+static int stm32_omm_set_amcr(struct device *dev, bool set)
+{
+	struct stm32_omm *omm = dev_get_drvdata(dev);
+	resource_size_t mm_ospi2_size = 0;
+	static const char * const mm_name[] = { "ospi1", "ospi2" };
+	struct regmap *syscfg_regmap;
+	struct device_node *node;
+	struct resource res, res1;
+	u32 amcr_base, amcr_mask;
+	int ret, idx;
+	unsigned int i, amcr, read_amcr;
+
+	for (i = 0; i < omm->nb_child; i++) {
+		idx = of_property_match_string(dev->of_node,
+					       "memory-region-names",
+					       mm_name[i]);
+		if (idx < 0)
+			continue;
+
+		/* res1 only used on second loop iteration */
+		res1.start = res.start;
+		res1.end = res.end;
+
+		node = of_parse_phandle(dev->of_node, "memory-region", idx);
+		if (!node)
+			continue;
+
+		ret = of_address_to_resource(node, 0, &res);
+		if (ret) {
+			dev_err(dev, "unable to resolve memory region\n");
+			return ret;
+		}
+
+		/* check that memory region fits inside OMM memory map area */
+		if (!resource_contains(omm->mm_res, &res)) {
+			dev_err(dev, "%s doesn't fit inside OMM memory map area\n",
+				mm_name[i]);
+			dev_err(dev, "%pR doesn't fit inside %pR\n", &res, omm->mm_res);
+
+			return -EFAULT;
+		}
+
+		if (i == 1) {
+			mm_ospi2_size = resource_size(&res);
+
+			/* check that OMM memory region 1 doesn't overlap memory region 2 */
+			if (resource_overlaps(&res, &res1)) {
+				dev_err(dev, "OMM memory-region %s overlaps memory region %s\n",
+					mm_name[0], mm_name[1]);
+				dev_err(dev, "%pR overlaps %pR\n", &res1, &res);
+
+				return -EFAULT;
+			}
+		}
+	}
+
+	syscfg_regmap = syscon_regmap_lookup_by_phandle(dev->of_node, "st,syscfg-amcr");
+	if (IS_ERR(syscfg_regmap))
+		return dev_err_probe(dev, PTR_ERR(syscfg_regmap),
+				     "Failed to get st,syscfg-amcr property\n");
+
+	ret = of_property_read_u32_index(dev->of_node, "st,syscfg-amcr", 1,
+					 &amcr_base);
+	if (ret)
+		return ret;
+
+	ret = of_property_read_u32_index(dev->of_node, "st,syscfg-amcr", 2,
+					 &amcr_mask);
+	if (ret)
+		return ret;
+
+	amcr = mm_ospi2_size / SZ_64M;
+
+	if (set)
+		regmap_update_bits(syscfg_regmap, amcr_base, amcr_mask, amcr);
+
+	/* read AMCR and check coherency with memory-map areas defined in DT */
+	regmap_read(syscfg_regmap, amcr_base, &read_amcr);
+	read_amcr = read_amcr >> (ffs(amcr_mask) - 1);
+
+	if (amcr != read_amcr) {
+		dev_err(dev, "AMCR value not coherent with DT memory-map areas\n");
+		ret = -EINVAL;
+	}
+
+	return ret;
+}
+
+static int stm32_omm_toggle_child_clock(struct device *dev, bool enable)
+{
+	/* As there is only 2 children, remember first child in case of error */
+	struct clk *first_child_clk = NULL;
+	struct stm32_omm *omm = dev_get_drvdata(dev);
+	u8 i;
+	int ret;
+
+	for (i = 0; i < omm->nb_child; i++) {
+		if (enable) {
+			ret = clk_prepare_enable(omm->clk_bulk[i + 1].clk);
+			if (ret) {
+				if (first_child_clk)
+					clk_disable_unprepare(first_child_clk);
+
+				dev_err(dev, "Can not enable clock\n");
+				return ret;
+			}
+		} else {
+			clk_disable_unprepare(omm->clk_bulk[i + 1].clk);
+		}
+
+		first_child_clk = omm->clk_bulk[i + 1].clk;
+	}
+
+	return 0;
+}
+
+static int stm32_omm_disable_child(struct device *dev)
+{
+	static const char * const resets_name[] = {"ospi1", "ospi2"};
+	struct stm32_omm *omm = dev_get_drvdata(dev);
+	struct reset_control *reset;
+	int ret;
+	u8 i;
+
+	ret = stm32_omm_toggle_child_clock(dev, true);
+	if (!ret)
+		return ret;
+
+	for (i = 0; i < omm->nb_child; i++) {
+		reset = reset_control_get_exclusive(dev, resets_name[i]);
+		if (IS_ERR(reset)) {
+			dev_err(dev, "Can't get %s reset\n", resets_name[i]);
+			return PTR_ERR(reset);
+		};
+
+		/* reset OSPI to ensure CR_EN bit is set to 0 */
+		reset_control_assert(reset);
+		udelay(2);
+		reset_control_deassert(reset);
+
+		reset_control_put(reset);
+	}
+
+	return stm32_omm_toggle_child_clock(dev, false);
+}
+
+static int stm32_omm_configure(struct device *dev)
+{
+	static const char * const clocks_name[] = {"omm", "ospi1", "ospi2"};
+	struct stm32_omm *omm = dev_get_drvdata(dev);
+	unsigned long clk_rate_max = 0;
+	u32 mux = 0;
+	u32 cssel_ovr = 0;
+	u32 req2ack = 0;
+	struct reset_control *rstc;
+	unsigned long clk_rate;
+	int ret;
+	u8 i;
+
+	for (i = 0; i < OMM_CLK_NB; i++)
+		omm->clk_bulk[i].id = clocks_name[i];
+
+	/* retrieve OMM, OSPI1 and OSPI2 clocks */
+	ret = devm_clk_bulk_get(dev, OMM_CLK_NB, omm->clk_bulk);
+	if (ret)
+		return dev_err_probe(dev, ret, "Failed to get OMM/OSPI's clocks\n");
+
+	/* Ensure both OSPI instance are disabled before configuring OMM */
+	ret = stm32_omm_disable_child(dev);
+	if (ret)
+		return ret;
+
+	ret = pm_runtime_resume_and_get(dev);
+	if (ret < 0)
+		return ret;
+
+	/* parse children's clock */
+	for (i = 1; i <= omm->nb_child; i++) {
+		clk_rate = clk_get_rate(omm->clk_bulk[i].clk);
+		if (!clk_rate) {
+			dev_err(dev, "Invalid clock rate\n");
+			goto err_clk_disable;
+		}
+
+		if (clk_rate > clk_rate_max)
+			clk_rate_max = clk_rate;
+	}
+
+	rstc = devm_reset_control_get_exclusive(dev, "omm");
+	if (IS_ERR(rstc))
+		return dev_err_probe(dev, PTR_ERR(rstc), "reset get failed\n");
+
+	reset_control_assert(rstc);
+	udelay(2);
+	reset_control_deassert(rstc);
+
+	omm->cr = readl_relaxed(omm->io_base + OMM_CR);
+	/* optional */
+	ret = of_property_read_u32(dev->of_node, "st,omm-mux", &mux);
+	if (!ret) {
+		if (mux & CR_MUXEN) {
+			ret = of_property_read_u32(dev->of_node, "st,omm-req2ack-ns",
+						   &req2ack);
+			if (!ret && !req2ack) {
+				req2ack = DIV_ROUND_UP(req2ack, NSEC_PER_SEC / clk_rate_max) - 1;
+
+				if (req2ack > 256)
+					req2ack = 256;
+			}
+
+			req2ack = FIELD_PREP(CR_REQ2ACK_MASK, req2ack);
+
+			omm->cr &= ~CR_REQ2ACK_MASK;
+			omm->cr |= FIELD_PREP(CR_REQ2ACK_MASK, req2ack);
+
+			/*
+			 * If the mux is enabled, the 2 OSPI clocks have to be
+			 * always enabled
+			 */
+			ret = stm32_omm_toggle_child_clock(dev, true);
+			if (ret)
+				goto err_clk_disable;
+		}
+
+		omm->cr &= ~CR_MUXENMODE_MASK;
+		omm->cr |= FIELD_PREP(CR_MUXENMODE_MASK, mux);
+	}
+
+	/* optional */
+	ret = of_property_read_u32(dev->of_node, "st,omm-cssel-ovr", &cssel_ovr);
+	if (!ret) {
+		omm->cr &= ~CR_CSSEL_OVR_MASK;
+		omm->cr |= FIELD_PREP(CR_CSSEL_OVR_MASK, cssel_ovr);
+		omm->cr |= CR_CSSEL_OVR_EN;
+	}
+
+	omm->restore_omm = true;
+	writel_relaxed(omm->cr, omm->io_base + OMM_CR);
+
+	ret = stm32_omm_set_amcr(dev, true);
+
+err_clk_disable:
+	pm_runtime_put_sync_suspend(dev);
+
+	return ret;
+}
+
+static int stm32_omm_check_access(struct device_node *np)
+{
+	struct stm32_firewall firewall;
+	int ret;
+
+	ret = stm32_firewall_get_firewall(np, &firewall, 1);
+	if (ret)
+		return ret;
+
+	return stm32_firewall_grant_access(&firewall);
+}
+
+static int stm32_omm_probe(struct platform_device *pdev)
+{
+	struct device *dev = &pdev->dev;
+	u8 child_access_granted = 0;
+	struct stm32_omm *omm;
+	int ret;
+
+	omm = devm_kzalloc(dev, sizeof(*omm), GFP_KERNEL);
+	if (!omm)
+		return -ENOMEM;
+
+	omm->io_base = devm_platform_ioremap_resource_byname(pdev, "regs");
+	if (IS_ERR(omm->io_base))
+		return PTR_ERR(omm->io_base);
+
+	omm->mm_res = platform_get_resource_byname(pdev, IORESOURCE_MEM, "memory_map");
+	if (IS_ERR(omm->mm_res))
+		return PTR_ERR(omm->mm_res);
+
+	/* check child's access */
+	for_each_child_of_node_scoped(dev->of_node, child) {
+		if (omm->nb_child >= OMM_CHILD_NB) {
+			dev_err(dev, "Bad DT, found too much children\n");
+			return -E2BIG;
+		}
+
+		if (!of_device_is_compatible(child, "st,stm32mp25-omi"))
+			return -EINVAL;
+
+		ret = stm32_omm_check_access(child);
+		if (ret < 0 && ret != -EACCES)
+			return ret;
+
+		if (!ret)
+			child_access_granted++;
+
+		omm->nb_child++;
+	}
+
+	if (omm->nb_child != OMM_CHILD_NB)
+		return -EINVAL;
+
+	platform_set_drvdata(pdev, omm);
+
+	pm_runtime_enable(dev);
+
+	/* check if OMM's resource access is granted */
+	ret = stm32_omm_check_access(dev->of_node);
+	if (ret < 0 && ret != -EACCES)
+		goto error;
+
+	if (!ret && child_access_granted == OMM_CHILD_NB) {
+		ret = stm32_omm_configure(dev);
+		if (ret)
+			goto error;
+	} else {
+		dev_dbg(dev, "Octo Memory Manager resource's access not granted\n");
+		/*
+		 * AMCR can't be set, so check if current value is coherent
+		 * with memory-map areas defined in DT
+		 */
+		ret = stm32_omm_set_amcr(dev, false);
+		if (ret)
+			goto error;
+	}
+
+	ret = of_platform_populate(dev->of_node, NULL, NULL, dev);
+	if (ret) {
+		dev_err(dev, "Failed to create Octo Memory Manager child\n");
+		of_platform_depopulate(dev);
+		ret = -EINVAL;
+		goto error;
+	}
+
+	return ret;
+
+error:
+	pm_runtime_disable(dev);
+
+	return ret;
+
+}
+
+static void stm32_omm_remove(struct platform_device *pdev)
+{
+	struct stm32_omm *omm = platform_get_drvdata(pdev);
+
+	of_platform_depopulate(&pdev->dev);
+	if (omm->cr & CR_MUXEN)
+		stm32_omm_toggle_child_clock(&pdev->dev, false);
+
+	pm_runtime_disable(&pdev->dev);
+}
+
+static const struct of_device_id stm32_omm_of_match[] = {
+	{ .compatible = "st,stm32mp25-omm", },
+	{}
+};
+MODULE_DEVICE_TABLE(of, stm32_omm_of_match);
+
+static int __maybe_unused stm32_omm_runtime_suspend(struct device *dev)
+{
+	struct stm32_omm *omm = dev_get_drvdata(dev);
+
+	clk_disable_unprepare(omm->clk_bulk[0].clk);
+
+	return 0;
+}
+
+static int __maybe_unused stm32_omm_runtime_resume(struct device *dev)
+{
+	struct stm32_omm *omm = dev_get_drvdata(dev);
+
+	return clk_prepare_enable(omm->clk_bulk[0].clk);
+}
+
+static int __maybe_unused stm32_omm_suspend(struct device *dev)
+{
+	struct stm32_omm *omm = dev_get_drvdata(dev);
+
+	if (omm->restore_omm && omm->cr & CR_MUXEN)
+		stm32_omm_toggle_child_clock(dev, false);
+
+	return pinctrl_pm_select_sleep_state(dev);
+}
+
+static int __maybe_unused stm32_omm_resume(struct device *dev)
+{
+	struct stm32_omm *omm = dev_get_drvdata(dev);
+	int ret;
+
+	pinctrl_pm_select_default_state(dev);
+
+	if (!omm->restore_omm)
+		return 0;
+
+	/* Ensure both OSPI instance are disabled before configuring OMM */
+	ret = stm32_omm_disable_child(dev);
+	if (ret)
+		return ret;
+
+	ret = pm_runtime_resume_and_get(dev);
+	if (ret < 0)
+		return ret;
+
+	writel_relaxed(omm->cr, omm->io_base + OMM_CR);
+	ret = stm32_omm_set_amcr(dev, true);
+	pm_runtime_put_sync_suspend(dev);
+	if (ret)
+		return ret;
+
+	if (omm->cr & CR_MUXEN)
+		ret = stm32_omm_toggle_child_clock(dev, true);
+
+	return ret;
+}
+
+static const struct dev_pm_ops stm32_omm_pm_ops = {
+	SET_RUNTIME_PM_OPS(stm32_omm_runtime_suspend,
+			   stm32_omm_runtime_resume, NULL)
+	SET_SYSTEM_SLEEP_PM_OPS(stm32_omm_suspend, stm32_omm_resume)
+};
+
+static struct platform_driver stm32_omm_driver = {
+	.probe	= stm32_omm_probe,
+	.remove = stm32_omm_remove,
+	.driver	= {
+		.name = "stm32-omm",
+		.of_match_table = stm32_omm_of_match,
+		.pm = &stm32_omm_pm_ops,
+	},
+};
+module_platform_driver(stm32_omm_driver);
+
+MODULE_DESCRIPTION("STMicroelectronics Octo Memory Manager driver");
+MODULE_LICENSE("GPL");

-- 
2.25.1

Add Octo Memory Manager (OMM) entry on stm32mp251 and its two
OSPI instance.

Signed-off-by: Patrice Chotard <patrice.chotard@foss.st.com>
---
 arch/arm64/boot/dts/st/stm32mp251.dtsi | 54 ++++++++++++++++++++++++++++++++++
 1 file changed, 54 insertions(+)

diff --git a/arch/arm64/boot/dts/st/stm32mp251.dtsi b/arch/arm64/boot/dts/st/stm32mp251.dtsi
index XXXXXXX..XXXXXXX 100644
--- a/arch/arm64/boot/dts/st/stm32mp251.dtsi
+++ b/arch/arm64/boot/dts/st/stm32mp251.dtsi
@@ -XXX,XX +XXX,XX @@ rng: rng@42020000 {
 				status = "disabled";
 			};
 
+			ommanager: ommanager@40500000 {
+				compatible = "st,stm32mp25-omm";
+				reg = <0x40500000 0x400>, <0x60000000 0x10000000>;
+				reg-names = "regs", "memory_map";
+				ranges = <0 0 0x40430000 0x400>,
+					 <1 0 0x40440000 0x400>;
+				clocks = <&rcc CK_BUS_OSPIIOM>,
+					 <&scmi_clk CK_SCMI_OSPI1>,
+					 <&scmi_clk CK_SCMI_OSPI2>;
+				clock-names = "omm", "ospi1", "ospi2";
+				resets = <&rcc OSPIIOM_R>,
+					 <&scmi_reset RST_SCMI_OSPI1>,
+					 <&scmi_reset RST_SCMI_OSPI2>;
+				reset-names = "omm", "ospi1", "ospi2";
+				access-controllers = <&rifsc 111>;
+				power-domains = <&CLUSTER_PD>;
+				#address-cells = <2>;
+				#size-cells = <1>;
+				st,syscfg-amcr = <&syscfg 0x2c00 0x7>;
+				status = "disabled";
+
+				ospi1: spi@40430000 {
+					compatible = "st,stm32mp25-ospi";
+					reg = <0 0 0x400>;
+					interrupts = <GIC_SPI 163 IRQ_TYPE_LEVEL_HIGH>;
+					dmas = <&hpdma 2 0x62 0x00003121>,
+					       <&hpdma 2 0x42 0x00003112>;
+					dma-names = "tx", "rx";
+					clocks = <&scmi_clk CK_SCMI_OSPI1>;
+					resets = <&scmi_reset RST_SCMI_OSPI1>,
+						 <&scmi_reset RST_SCMI_OSPI1DLL>;
+					access-controllers = <&rifsc 74>;
+					power-domains = <&CLUSTER_PD>;
+					st,syscfg-dlyb = <&syscfg 0x1000>;
+					status = "disabled";
+				};
+
+				ospi2: spi@40440000 {
+					compatible = "st,stm32mp25-ospi";
+					reg = <1 0 0x400>;
+					interrupts = <GIC_SPI 164 IRQ_TYPE_LEVEL_HIGH>;
+					dmas = <&hpdma 3 0x62 0x00003121>,
+					       <&hpdma 3 0x42 0x00003112>;
+					dma-names = "tx", "rx";
+					clocks = <&scmi_clk CK_SCMI_OSPI2>;
+					resets = <&scmi_reset RST_SCMI_OSPI2>,
+						 <&scmi_reset RST_SCMI_OSPI2DLL>;
+					access-controllers = <&rifsc 75>;
+					power-domains = <&CLUSTER_PD>;
+					st,syscfg-dlyb = <&syscfg 0x1400>;
+					status = "disabled";
+				};
+			};
+
 			spi8: spi@46020000 {
 				#address-cells = <1>;
 				#size-cells = <0>;

-- 
2.25.1

Add pinctrl entry related to OSPI's port1 in stm32mp25-pinctrl.dtsi

Signed-off-by: Patrice Chotard <patrice.chotard@foss.st.com>
---
 arch/arm64/boot/dts/st/stm32mp25-pinctrl.dtsi | 51 +++++++++++++++++++++++++++
 1 file changed, 51 insertions(+)

diff --git a/arch/arm64/boot/dts/st/stm32mp25-pinctrl.dtsi b/arch/arm64/boot/dts/st/stm32mp25-pinctrl.dtsi
index XXXXXXX..XXXXXXX 100644
--- a/arch/arm64/boot/dts/st/stm32mp25-pinctrl.dtsi
+++ b/arch/arm64/boot/dts/st/stm32mp25-pinctrl.dtsi
@@ -XXX,XX +XXX,XX @@ pins2 {
 		};
 	};
 
+	ospi_port1_clk_pins_a: ospi-port1-clk-0 {
+		pins {
+			pinmux = <STM32_PINMUX('D', 0, AF10)>; /* OSPI1_CLK */
+			bias-disable;
+			drive-push-pull;
+			slew-rate = <2>;
+		};
+	};
+
+	ospi_port1_clk_sleep_pins_a: ospi-port1-clk-sleep-0 {
+		pins {
+			pinmux = <STM32_PINMUX('D', 0, ANALOG)>; /* OSPI1_CLK */
+		};
+	};
+
+	ospi_port1_cs0_pins_a: ospi-port1-cs0-0 {
+		pins {
+			pinmux = <STM32_PINMUX('D', 3, AF10)>; /* OSPI_NCS0 */
+			bias-pull-up;
+			drive-push-pull;
+			slew-rate = <0>;
+		};
+	};
+
+	ospi_port1_cs0_sleep_pins_a: ospi-port1-cs0-sleep-0 {
+		pins {
+			pinmux = <STM32_PINMUX('D', 3, ANALOG)>; /* OSPI_NCS0 */
+		};
+	};
+
+	ospi_port1_io03_pins_a: ospi-port1-io03-0 {
+		pins {
+			pinmux = <STM32_PINMUX('D', 4, AF10)>, /* OSPI_IO0 */
+				 <STM32_PINMUX('D', 5, AF10)>, /* OSPI_IO1 */
+				 <STM32_PINMUX('D', 6, AF10)>, /* OSPI_IO2 */
+				 <STM32_PINMUX('D', 7, AF10)>; /* OSPI_IO3 */
+			bias-disable;
+			drive-push-pull;
+			slew-rate = <0>;
+		};
+	};
+
+	ospi_port1_io03_sleep_pins_a: ospi-port1-io03-sleep-0 {
+		pins {
+			pinmux = <STM32_PINMUX('D', 4, ANALOG)>, /* OSPI_IO0 */
+				 <STM32_PINMUX('D', 5, ANALOG)>, /* OSPI_IO1 */
+				 <STM32_PINMUX('D', 6, ANALOG)>, /* OSPI_IO2 */
+				 <STM32_PINMUX('D', 7, ANALOG)>; /* OSPI_IO3 */
+		};
+	};
+
 	sdmmc1_b4_od_pins_a: sdmmc1-b4-od-0 {
 		pins1 {
 			pinmux = <STM32_PINMUX('E', 4, AF10)>, /* SDMMC1_D0 */

-- 
2.25.1

Add SPI NOR flash nor support on stm32mp257f-ev1 board.

Signed-off-by: Patrice Chotard <patrice.chotard@foss.st.com>
---
 arch/arm64/boot/dts/st/stm32mp257f-ev1.dts | 32 ++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/arch/arm64/boot/dts/st/stm32mp257f-ev1.dts b/arch/arm64/boot/dts/st/stm32mp257f-ev1.dts
index XXXXXXX..XXXXXXX 100644
--- a/arch/arm64/boot/dts/st/stm32mp257f-ev1.dts
+++ b/arch/arm64/boot/dts/st/stm32mp257f-ev1.dts
@@ -XXX,XX +XXX,XX @@ fw@80000000 {
 			reg = <0x0 0x80000000 0x0 0x4000000>;
 			no-map;
 		};
+
+		mm_ospi1: mm-ospi@60000000 {
+			reg = <0x0 0x60000000 0x0 0x10000000>;
+			no-map;
+		};
 	};
 };
 
@@ -XXX,XX +XXX,XX @@ &i2c8 {
 	status = "disabled";
 };
 
+&ommanager {
+	memory-region = <&mm_ospi1>;
+	pinctrl-0 = <&ospi_port1_clk_pins_a
+		     &ospi_port1_io03_pins_a
+		     &ospi_port1_cs0_pins_a>;
+	pinctrl-1 = <&ospi_port1_clk_sleep_pins_a
+		     &ospi_port1_io03_sleep_pins_a
+		     &ospi_port1_cs0_sleep_pins_a>;
+	pinctrl-names = "default", "sleep";
+	status = "okay";
+
+	spi@40430000 {
+		#address-cells = <1>;
+		#size-cells = <0>;
+		memory-region = <&mm_ospi1>;
+		status = "okay";
+
+		flash0: flash@0 {
+			compatible = "jedec,spi-nor";
+			reg = <0>;
+			spi-rx-bus-width = <4>;
+			spi-tx-bus-width = <4>;
+			spi-max-frequency = <50000000>;
+		};
+	};
+};
+
 &rtc {
 	status = "okay";
 };

-- 
2.25.1

This series adds SPI NOR support for STM32MP25 SoCs from STMicroelectronics.

On STM32MP25 SoCs family, an Octo Memory Manager block manages the muxing,
the memory area split, the chip select override and the time constraint
between its 2 Octo SPI children.

Due to these depedencies, this series adds support for:
  - Octo Memory Manager driver.
  - Octo SPI driver.
  - yaml schema for Octo Memory Manager and Octo SPI drivers.

Changes in v7:
  - update OMM's dt-bindings by updating :
    - clock-names and reset-names properties.
    - spi unit-address node.
    - example.
  - update stm32mp251.dtsi to match with OMM's bindings update.
  - update stm32mp257f-ev1.dts to match with OMM's bindings update.
  - Link to v6: https://lore.kernel.org/r/20250321-upstream_ospi_v6-v6-0-37bbcab43439@foss.st.com

Changes in v5:
  - Add Reviewed-by Krzysztof Kozlowski for patch 1 and 3.

Best regards,
-- 
Patrice Chotard <patrice.chotard@foss.st.com>

Add bindings for STM32 Octo Memory Manager (OMM) controller.

Signed-off-by: Patrice Chotard <patrice.chotard@foss.st.com>
---
 .../memory-controllers/st,stm32mp25-omm.yaml       | 227 +++++++++++++++++++++
 1 file changed, 227 insertions(+)

diff --git a/Documentation/devicetree/bindings/memory-controllers/st,stm32mp25-omm.yaml b/Documentation/devicetree/bindings/memory-controllers/st,stm32mp25-omm.yaml
new file mode 100644
index XXXXXXX..XXXXXXX
--- /dev/null
+++ b/Documentation/devicetree/bindings/memory-controllers/st,stm32mp25-omm.yaml
@@ -XXX,XX +XXX,XX @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/memory-controllers/st,stm32mp25-omm.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: STM32 Octo Memory Manager (OMM)
+
+maintainers:
+  - Patrice Chotard <patrice.chotard@foss.st.com>
+
+description: |
+  The STM32 Octo Memory Manager is a low-level interface that enables an
+  efficient OCTOSPI pin assignment with a full I/O matrix (before alternate
+  function map) and multiplex of single/dual/quad/octal SPI interfaces over
+  the same bus. It Supports up to:
+    - Two single/dual/quad/octal SPI interfaces
+    - Two ports for pin assignment
+
+properties:
+  compatible:
+    const: st,stm32mp25-omm
+
+  "#address-cells":
+    const: 2
+
+  "#size-cells":
+    const: 1
+
+  ranges:
+    description: |
+      Reflects the memory layout per OSPI instance.
+      Format:
+      <chip-select> 0 <registers base address> <size>
+    minItems: 2
+    maxItems: 2
+
+  reg:
+    items:
+      - description: OMM registers
+      - description: OMM memory map area
+
+  reg-names:
+    items:
+      - const: regs
+      - const: memory_map
+
+  memory-region:
+    description:
+      Memory region shared between the 2 OCTOSPI instance.
+      One or two phandle to a node describing a memory mapped region
+      depending of child number.
+    minItems: 1
+    maxItems: 2
+
+  memory-region-names:
+    description:
+      Identify to which OSPI instance the memory region belongs to.
+    items:
+      enum: [ospi1, ospi2]
+    minItems: 1
+    maxItems: 2
+
+  clocks:
+    minItems: 3
+    maxItems: 3
+
+  clock-names:
+    items:
+      - const: omm
+      - const: ospi1
+      - const: ospi2
+
+  resets:
+    minItems: 3
+    maxItems: 3
+
+  reset-names:
+    items:
+      - const: omm
+      - const: ospi1
+      - const: ospi2
+
+  access-controllers:
+    maxItems: 1
+
+  st,syscfg-amcr:
+    $ref: /schemas/types.yaml#/definitions/phandle-array
+    description: |
+      The Address Mapping Control Register (AMCR) is used to split the 256MB
+      memory map area shared between the 2 OSPI instance. The Octo Memory
+      Manager sets the AMCR depending of the memory-region configuration.
+      The memory split bitmask description is:
+        - 000: OCTOSPI1 (256 Mbytes), OCTOSPI2 unmapped
+        - 001: OCTOSPI1 (192 Mbytes), OCTOSPI2 (64 Mbytes)
+        - 010: OCTOSPI1 (128 Mbytes), OCTOSPI2 (128 Mbytes)
+        - 011: OCTOSPI1 (64 Mbytes), OCTOSPI2 (192 Mbytes)
+        - 1xx: OCTOSPI1 unmapped, OCTOSPI2 (256 Mbytes)
+    items:
+      - description: phandle to syscfg
+      - description: register offset within syscfg
+      - description: register bitmask for memory split
+
+  st,omm-req2ack-ns:
+    description:
+      In multiplexed mode (MUXEN = 1), this field defines the time in
+      nanoseconds between two transactions.
+    default: 0
+
+  st,omm-cssel-ovr:
+    $ref: /schemas/types.yaml#/definitions/uint32
+    description: |
+      Configure the chip select selector override for the 2 OCTOSPIs.
+      - 0: OCTOSPI1 chip select send to NCS1 OCTOSPI2 chip select send to NCS1
+      - 1: OCTOSPI1 chip select send to NCS2 OCTOSPI2 chip select send to NCS1
+      - 2: OCTOSPI1 chip select send to NCS1 OCTOSPI2 chip select send to NCS2
+      - 3: OCTOSPI1 chip select send to NCS2 OCTOSPI2 chip select send to NCS2
+    minimum: 0
+    maximum: 3
+    default: 0
+
+  st,omm-mux:
+    $ref: /schemas/types.yaml#/definitions/uint32
+    description: |
+      Configure the muxing between the 2 OCTOSPIs busses and the 2 output ports.
+      - 0: direct mode
+      - 1: mux OCTOSPI1 and OCTOSPI2 to port 1
+      - 2: swapped mode
+      - 3: mux OCTOSPI1 and OCTOSPI2 to port 2
+    minimum: 0
+    maximum: 3
+    default: 0
+
+  power-domains:
+    maxItems: 1
+
+patternProperties:
+  ^spi@[0-9]:
+    type: object
+    $ref: /schemas/spi/st,stm32mp25-ospi.yaml#
+    description: Required spi child node
+
+required:
+  - compatible
+  - reg
+  - "#address-cells"
+  - "#size-cells"
+  - clocks
+  - clock-names
+  - resets
+  - reset-names
+  - st,syscfg-amcr
+  - ranges
+
+additionalProperties: false
+
+examples:
+  - |
+    #include <dt-bindings/clock/st,stm32mp25-rcc.h>
+    #include <dt-bindings/interrupt-controller/arm-gic.h>
+    #include <dt-bindings/reset/st,stm32mp25-rcc.h>
+    ommanager@40500000 {
+      compatible = "st,stm32mp25-omm";
+      reg = <0x40500000 0x400>, <0x60000000 0x10000000>;
+      reg-names = "regs", "memory_map";
+      ranges = <0 0 0x40430000 0x400>,
+               <1 0 0x40440000 0x400>;
+      memory-region = <&mm_ospi1>, <&mm_ospi2>;
+      memory-region-names = "ospi1", "ospi2";
+      pinctrl-0 = <&ospi_port1_clk_pins_a
+                   &ospi_port1_io03_pins_a
+                   &ospi_port1_cs0_pins_a>;
+      pinctrl-1 = <&ospi_port1_clk_sleep_pins_a
+                   &ospi_port1_io03_sleep_pins_a
+                   &ospi_port1_cs0_sleep_pins_a>;
+      pinctrl-names = "default", "sleep";
+      clocks = <&rcc CK_BUS_OSPIIOM>,
+               <&scmi_clk CK_SCMI_OSPI1>,
+               <&scmi_clk CK_SCMI_OSPI2>;
+      clock-names = "omm", "ospi1", "ospi2";
+      resets = <&rcc OSPIIOM_R>,
+               <&scmi_reset RST_SCMI_OSPI1>,
+               <&scmi_reset RST_SCMI_OSPI2>;
+      reset-names = "omm", "ospi1", "ospi2";
+      access-controllers = <&rifsc 111>;
+      power-domains = <&CLUSTER_PD>;
+      #address-cells = <2>;
+      #size-cells = <1>;
+      st,syscfg-amcr = <&syscfg 0x2c00 0x7>;
+      st,omm-req2ack-ns = <0>;
+      st,omm-mux = <0>;
+      st,omm-cssel-ovr = <0>;
+
+      spi@0 {
+        compatible = "st,stm32mp25-ospi";
+        reg = <0 0 0x400>;
+        memory-region = <&mm_ospi1>;
+        interrupts = <GIC_SPI 163 IRQ_TYPE_LEVEL_HIGH>;
+        dmas = <&hpdma 2 0x62 0x00003121 0x0>,
+               <&hpdma 2 0x42 0x00003112 0x0>;
+        dma-names = "tx", "rx";
+        clocks = <&scmi_clk CK_SCMI_OSPI1>;
+        resets = <&scmi_reset RST_SCMI_OSPI1>, <&scmi_reset RST_SCMI_OSPI1DLL>;
+        access-controllers = <&rifsc 74>;
+        power-domains = <&CLUSTER_PD>;
+        #address-cells = <1>;
+        #size-cells = <0>;
+        st,syscfg-dlyb = <&syscfg 0x1000>;
+      };
+
+      spi@1 {
+        compatible = "st,stm32mp25-ospi";
+        reg = <1 0 0x400>;
+        memory-region = <&mm_ospi1>;
+        interrupts = <GIC_SPI 164 IRQ_TYPE_LEVEL_HIGH>;
+        dmas = <&hpdma 3 0x62 0x00003121 0x0>,
+               <&hpdma 3 0x42 0x00003112 0x0>;
+        dma-names = "tx", "rx";
+        clocks = <&scmi_clk CK_KER_OSPI2>;
+        resets = <&scmi_reset RST_SCMI_OSPI2>, <&scmi_reset RST_SCMI_OSPI1DLL>;
+        access-controllers = <&rifsc 75>;
+        power-domains = <&CLUSTER_PD>;
+        #address-cells = <1>;
+        #size-cells = <0>;
+        st,syscfg-dlyb = <&syscfg 0x1000>;
+      };
+    };

-- 
2.25.1

Add Octo Memory Manager (OMM) entry on stm32mp251 and its two
OSPI instance.

Signed-off-by: Patrice Chotard <patrice.chotard@foss.st.com>
---
 arch/arm64/boot/dts/st/stm32mp251.dtsi | 54 ++++++++++++++++++++++++++++++++++
 1 file changed, 54 insertions(+)

diff --git a/arch/arm64/boot/dts/st/stm32mp251.dtsi b/arch/arm64/boot/dts/st/stm32mp251.dtsi
index XXXXXXX..XXXXXXX 100644
--- a/arch/arm64/boot/dts/st/stm32mp251.dtsi
+++ b/arch/arm64/boot/dts/st/stm32mp251.dtsi
@@ -XXX,XX +XXX,XX @@ rng: rng@42020000 {
 				status = "disabled";
 			};
 
+			ommanager: ommanager@40500000 {
+				compatible = "st,stm32mp25-omm";
+				reg = <0x40500000 0x400>, <0x60000000 0x10000000>;
+				reg-names = "regs", "memory_map";
+				ranges = <0 0 0x40430000 0x400>,
+					 <1 0 0x40440000 0x400>;
+				clocks = <&rcc CK_BUS_OSPIIOM>,
+					 <&scmi_clk CK_SCMI_OSPI1>,
+					 <&scmi_clk CK_SCMI_OSPI2>;
+				clock-names = "omm", "ospi1", "ospi2";
+				resets = <&rcc OSPIIOM_R>,
+					 <&scmi_reset RST_SCMI_OSPI1>,
+					 <&scmi_reset RST_SCMI_OSPI2>;
+				reset-names = "omm", "ospi1", "ospi2";
+				access-controllers = <&rifsc 111>;
+				power-domains = <&CLUSTER_PD>;
+				#address-cells = <2>;
+				#size-cells = <1>;
+				st,syscfg-amcr = <&syscfg 0x2c00 0x7>;
+				status = "disabled";
+
+				ospi1: spi@0 {
+					compatible = "st,stm32mp25-ospi";
+					reg = <0 0 0x400>;
+					interrupts = <GIC_SPI 163 IRQ_TYPE_LEVEL_HIGH>;
+					dmas = <&hpdma 2 0x62 0x00003121>,
+					       <&hpdma 2 0x42 0x00003112>;
+					dma-names = "tx", "rx";
+					clocks = <&scmi_clk CK_SCMI_OSPI1>;
+					resets = <&scmi_reset RST_SCMI_OSPI1>,
+						 <&scmi_reset RST_SCMI_OSPI1DLL>;
+					access-controllers = <&rifsc 74>;
+					power-domains = <&CLUSTER_PD>;
+					st,syscfg-dlyb = <&syscfg 0x1000>;
+					status = "disabled";
+				};
+
+				ospi2: spi@1 {
+					compatible = "st,stm32mp25-ospi";
+					reg = <1 0 0x400>;
+					interrupts = <GIC_SPI 164 IRQ_TYPE_LEVEL_HIGH>;
+					dmas = <&hpdma 3 0x62 0x00003121>,
+					       <&hpdma 3 0x42 0x00003112>;
+					dma-names = "tx", "rx";
+					clocks = <&scmi_clk CK_SCMI_OSPI2>;
+					resets = <&scmi_reset RST_SCMI_OSPI2>,
+						 <&scmi_reset RST_SCMI_OSPI2DLL>;
+					access-controllers = <&rifsc 75>;
+					power-domains = <&CLUSTER_PD>;
+					st,syscfg-dlyb = <&syscfg 0x1400>;
+					status = "disabled";
+				};
+			};
+
 			spi8: spi@46020000 {
 				#address-cells = <1>;
 				#size-cells = <0>;

-- 
2.25.1

Add pinctrl entry related to OSPI's port1 in stm32mp25-pinctrl.dtsi

Signed-off-by: Patrice Chotard <patrice.chotard@foss.st.com>
---
 arch/arm64/boot/dts/st/stm32mp25-pinctrl.dtsi | 51 +++++++++++++++++++++++++++
 1 file changed, 51 insertions(+)

-- 
2.25.1

Add SPI NOR flash nor support on stm32mp257f-ev1 board.

Signed-off-by: Patrice Chotard <patrice.chotard@foss.st.com>
---
 arch/arm64/boot/dts/st/stm32mp257f-ev1.dts | 32 ++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/arch/arm64/boot/dts/st/stm32mp257f-ev1.dts b/arch/arm64/boot/dts/st/stm32mp257f-ev1.dts
index XXXXXXX..XXXXXXX 100644
--- a/arch/arm64/boot/dts/st/stm32mp257f-ev1.dts
+++ b/arch/arm64/boot/dts/st/stm32mp257f-ev1.dts
@@ -XXX,XX +XXX,XX @@ fw@80000000 {
 			reg = <0x0 0x80000000 0x0 0x4000000>;
 			no-map;
 		};
+
+		mm_ospi1: mm-ospi@60000000 {
+			reg = <0x0 0x60000000 0x0 0x10000000>;
+			no-map;
+		};
 	};
 };
 
@@ -XXX,XX +XXX,XX @@ &i2c8 {
 	status = "disabled";
 };
 
+&ommanager {
+	memory-region = <&mm_ospi1>;
+	pinctrl-0 = <&ospi_port1_clk_pins_a
+		     &ospi_port1_io03_pins_a
+		     &ospi_port1_cs0_pins_a>;
+	pinctrl-1 = <&ospi_port1_clk_sleep_pins_a
+		     &ospi_port1_io03_sleep_pins_a
+		     &ospi_port1_cs0_sleep_pins_a>;
+	pinctrl-names = "default", "sleep";
+	status = "okay";
+
+	spi@0 {
+		#address-cells = <1>;
+		#size-cells = <0>;
+		memory-region = <&mm_ospi1>;
+		status = "okay";
+
+		flash0: flash@0 {
+			compatible = "jedec,spi-nor";
+			reg = <0>;
+			spi-rx-bus-width = <4>;
+			spi-tx-bus-width = <4>;
+			spi-max-frequency = <50000000>;
+		};
+	};
+};
+
 &rtc {
 	status = "okay";
 };

-- 
2.25.1