diff mbox

mtd: lpddr: add driver for LPDDR2-NVM PCM memories

Message ID 1390167262-4030-1-git-send-email-vincenzo.aliberti@gmail.com
State Superseded
Headers show

Commit Message

Vincenzo Aliberti Jan. 19, 2014, 9:34 p.m. UTC
From: Vincenzo Aliberti <vincenzo.aliberti@gmail.com>

Signed-off-by: Vincenzo Aliberti <vincenzo.aliberti@gmail.com>

---
 drivers/mtd/lpddr/Kconfig      |   12 +-
 drivers/mtd/lpddr/lpddr2_nvm.c |  504 ++++++++++++++++++++++++++++++++++++++++
 include/uapi/mtd/mtd-abi.h     |    1 +
 3 files changed, 515 insertions(+), 2 deletions(-)
 create mode 100644 drivers/mtd/lpddr/lpddr2_nvm.c

Comments

Vincenzo Aliberti Feb. 10, 2014, 10:28 a.m. UTC | #1
Any feedback on this?

On Sun, Jan 19, 2014 at 10:34 PM,  <vincenzo.aliberti@gmail.com> wrote:
> From: Vincenzo Aliberti <vincenzo.aliberti@gmail.com>
>
> Signed-off-by: Vincenzo Aliberti <vincenzo.aliberti@gmail.com>
>
> ---
>  drivers/mtd/lpddr/Kconfig      |   12 +-
>  drivers/mtd/lpddr/lpddr2_nvm.c |  504 ++++++++++++++++++++++++++++++++++++++++
>  include/uapi/mtd/mtd-abi.h     |    1 +
>  3 files changed, 515 insertions(+), 2 deletions(-)
>  create mode 100644 drivers/mtd/lpddr/lpddr2_nvm.c
>
> diff --git a/drivers/mtd/lpddr/Kconfig b/drivers/mtd/lpddr/Kconfig
> index 265f969..94a7f30 100644
> --- a/drivers/mtd/lpddr/Kconfig
> +++ b/drivers/mtd/lpddr/Kconfig
> @@ -1,5 +1,5 @@
> -menu "LPDDR flash memory drivers"
> -       depends on MTD!=n
> +menu "LPDDR & LPDDR2 PCM memory drivers"
> +       depends on MTD
>
>  config MTD_LPDDR
>         tristate "Support for LPDDR flash chips"
> @@ -17,4 +17,12 @@ config MTD_QINFO_PROBE
>             Window QINFO interface, permits software to be used for entire
>             families of devices. This serves similar purpose of CFI on legacy
>             Flash products
> +
> +config MTD_LPDDR2_NVM
> +       depends on MTD && ARM
> +       tristate "Support for LPDDR2-NVM flash chips"
> +       help
> +         This option enables support of PCM memories with a LPDDR2-NVM
> +         (Low power double data rate 2) interface.
> +
>  endmenu
> diff --git a/drivers/mtd/lpddr/lpddr2_nvm.c b/drivers/mtd/lpddr/lpddr2_nvm.c
> new file mode 100644
> index 0000000..23377c8
> --- /dev/null
> +++ b/drivers/mtd/lpddr/lpddr2_nvm.c
> @@ -0,0 +1,504 @@
> +/*
> + * LPDDR2-NVM MTD driver. This module provides read, write, erase, lock/unlock
> + * support for LPDDR2-NVM PCM memories
> + *
> + * Copyright © 2012 Micron Technology, Inc.
> + *
> + * Vincenzo Aliberti <vincenzo.aliberti@gmail.com>
> + * Domenico Manna <domenico.manna@gmail.com>
> + * Many thanks to Andrea Vigilante for initial enabling
> + *
> + * This program is free software; you can redistribute it and/or
> + * modify it under the terms of the GNU General Public License
> + * as published by the Free Software Foundation; either version 2
> + * of the License, or (at your option) any later version.
> + *
> + * This program is distributed in the hope that it will be useful,
> + * but WITHOUT ANY WARRANTY; without even the implied warranty of
> + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
> + * GNU General Public License for more details.
> + *
> + * You should have received a copy of the GNU General Public License
> + * along with this program; if not, write to the Free Software
> + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
> + * 02110-1301, USA.
> + */
> +
> +#define pr_fmt(fmt) KBUILD_MODNAME ":%s: " fmt, __func__
> +
> +#include <linux/init.h>
> +#include <linux/io.h>
> +#include <linux/module.h>
> +#include <linux/kernel.h>
> +#include <linux/mtd/map.h>
> +#include <linux/mtd/mtd.h>
> +#include <linux/mtd/partitions.h>
> +#include <linux/slab.h>
> +#include <linux/platform_device.h>
> +#include <linux/ioport.h>
> +#include <linux/sched.h>
> +
> +/* Parameters */
> +#define ERASE_BLOCKSIZE                        (0x00020000/2)  /* in Word */
> +#define WRITE_BUFFSIZE                 (0x00000400/2)  /* in Word */
> +#define OW_BASE_ADDRESS                        0x00000000      /* OW offset */
> +
> +/* PFOW symbols address offset */
> +#define PFOW_QUERY_STRING_P            (0x0000/2)      /* in Word */
> +#define PFOW_QUERY_STRING_F            (0x0002/2)      /* in Word */
> +#define PFOW_QUERY_STRING_O            (0x0004/2)      /* in Word */
> +#define PFOW_QUERY_STRING_W            (0x0006/2)      /* in Word */
> +
> +/* OW registers address */
> +#define CMD_CODE_OFS                   (0x0080/2)      /* in Word */
> +#define CMD_DATA_OFS                   (0x0084/2)      /* in Word */
> +#define CMD_ADD_L_OFS                  (0x0088/2)      /* in Word */
> +#define CMD_ADD_H_OFS                  (0x008A/2)      /* in Word */
> +#define MPR_L_OFS                      (0x0090/2)      /* in Word */
> +#define MPR_H_OFS                      (0x0092/2)      /* in Word */
> +#define CMD_EXEC_OFS                   (0x00C0/2)      /* in Word */
> +#define STATUS_REG_OFS                 (0x00CC/2)      /* in Word */
> +#define PRG_BUFFER_OFS                 (0x0010/2)      /* in Word */
> +
> +/* Datamask */
> +#define MR_CFGMASK                     0x8000
> +#define SR_OK_DATAMASK                 0x0080
> +
> +/* LPDDR2-NVM Commands */
> +#define LPDDR2_NVM_LOCK                        0x0061
> +#define LPDDR2_NVM_UNLOCK              0x0062
> +#define LPDDR2_NVM_SW_PROGRAM          0x0041
> +#define LPDDR2_NVM_SW_OVERWRITE                0x0042
> +#define LPDDR2_NVM_BUF_PROGRAM         0x00E9
> +#define LPDDR2_NVM_BUF_OVERWRITE       0x00EA
> +#define LPDDR2_NVM_ERASE               0x0020
> +
> +/*
> + * Internal Type Definitions
> + * pcm_int_data contains memory controller details:
> + * @reg_data : LPDDR2_MODE_REG_DATA register address after remapping
> + * @reg_cfg  : LPDDR2_MODE_REG_CFG register address after remapping
> + * &bus_width: memory bus-width (eg: x16 2 Bytes, x32 4 Bytes)
> + */
> +struct pcm_int_data {
> +       void __iomem *reg_data;
> +       void __iomem *reg_cfg;
> +       int bus_width;
> +};
> +
> +static DEFINE_MUTEX(lpdd2_nvm_mutex);
> +
> +/*
> + * Build a map_word starting from an u_long
> + */
> +static inline map_word build_map_word(u_long myword)
> +{
> +       map_word val = { {0} };
> +       val.x[0] = myword;
> +       return val;
> +}
> +
> +/*
> + * Build Mode Register Configuration DataMask based on device bus-width
> + */
> +static inline u_int build_mr_cfgmask(u_int bus_width)
> +{
> +       u_int val = MR_CFGMASK;
> +
> +       if (bus_width == 0x0004)                /* x32 device */
> +               val = val << 16;
> +
> +       return val;
> +}
> +
> +/*
> + * Build Status Register OK DataMask based on device bus-width
> + */
> +static inline u_int build_sr_ok_datamask(u_int bus_width)
> +{
> +       u_int val = SR_OK_DATAMASK;
> +
> +       if (bus_width == 0x0004)                /* x32 device */
> +               val = (val << 16)+val;
> +
> +       return val;
> +}
> +
> +/*
> + * Evaluates Overlay Window Control Registers address
> + */
> +static inline u_long ow_reg_add(struct map_info *map, u_long offset)
> +{
> +       u_long val = 0;
> +       struct pcm_int_data *pcm_data = map->fldrv_priv;
> +
> +       val = map->pfow_base + offset*pcm_data->bus_width;
> +
> +       return val;
> +}
> +
> +/*
> + * Enable lpddr2-nvm Overlay Window
> + * Overlay Window is a memory mapped area containing all LPDDR2-NVM registers
> + * used by device commands as well as uservisible resources like Device Status
> + * Register, Device ID, etc
> + */
> +static inline void ow_enable(struct map_info *map)
> +{
> +       struct pcm_int_data *pcm_data = map->fldrv_priv;
> +
> +       writel_relaxed(build_mr_cfgmask(pcm_data->bus_width) | 0x18,
> +               pcm_data->reg_cfg);
> +       writel_relaxed(0x01, pcm_data->reg_data);
> +}
> +
> +/*
> + * Disable lpddr2-nvm Overlay Window
> + * Overlay Window is a memory mapped area containing all LPDDR2-NVM registers
> + * used by device commands as well as uservisible resources like Device Status
> + * Register, Device ID, etc
> + */
> +static inline void ow_disable(struct map_info *map)
> +{
> +       struct pcm_int_data *pcm_data = map->fldrv_priv;
> +
> +       writel_relaxed(build_mr_cfgmask(pcm_data->bus_width) | 0x18,
> +               pcm_data->reg_cfg);
> +       writel_relaxed(0x02, pcm_data->reg_data);
> +}
> +
> +/*
> + * Execute lpddr2-nvm operations
> + */
> +static int lpddr2_nvm_do_op(struct map_info *map, u_long cmd_code,
> +       u_long cmd_data, u_long cmd_add, u_long cmd_mpr, u_char *buf)
> +{
> +       map_word add_l = { {0} }, add_h = { {0} }, mpr_l = { {0} },
> +               mpr_h = { {0} }, data_l = { {0} }, cmd = { {0} },
> +               exec_cmd = { {0} }, sr;
> +       map_word data_h = { {0} };      /* only for 2x x16 devices stacked */
> +       u_long i, status_reg, prg_buff_ofs;
> +       struct pcm_int_data *pcm_data = map->fldrv_priv;
> +       u_int sr_ok_datamask = build_sr_ok_datamask(pcm_data->bus_width);
> +
> +       /* Builds low and high words for OW Control Registers */
> +       add_l.x[0]      = cmd_add & 0x0000FFFF;
> +       add_h.x[0]      = (cmd_add >> 16) & 0x0000FFFF;
> +       mpr_l.x[0]      = cmd_mpr & 0x0000FFFF;
> +       mpr_h.x[0]      = (cmd_mpr >> 16) & 0x0000FFFF;
> +       cmd.x[0]        = cmd_code & 0x0000FFFF;
> +       exec_cmd.x[0]   = 0x0001;
> +       data_l.x[0]     = cmd_data & 0x0000FFFF;
> +       data_h.x[0]     = (cmd_data >> 16) & 0x0000FFFF; /* only for 2x x16 */
> +
> +       /* Set Overlay Window Control Registers */
> +       map_write(map, cmd, ow_reg_add(map, CMD_CODE_OFS));
> +       map_write(map, data_l, ow_reg_add(map, CMD_DATA_OFS));
> +       map_write(map, add_l, ow_reg_add(map, CMD_ADD_L_OFS));
> +       map_write(map, add_h, ow_reg_add(map, CMD_ADD_H_OFS));
> +       map_write(map, mpr_l, ow_reg_add(map, MPR_L_OFS));
> +       map_write(map, mpr_h, ow_reg_add(map, MPR_H_OFS));
> +       if (pcm_data->bus_width == 0x0004) {    /* 2x16 devices stacked */
> +               map_write(map, cmd, ow_reg_add(map, CMD_CODE_OFS) + 2);
> +               map_write(map, data_h, ow_reg_add(map, CMD_DATA_OFS) + 2);
> +               map_write(map, add_l, ow_reg_add(map, CMD_ADD_L_OFS) + 2);
> +               map_write(map, add_h, ow_reg_add(map, CMD_ADD_H_OFS) + 2);
> +               map_write(map, mpr_l, ow_reg_add(map, MPR_L_OFS) + 2);
> +               map_write(map, mpr_h, ow_reg_add(map, MPR_H_OFS) + 2);
> +       }
> +
> +       /* Fill Program Buffer */
> +       if ((cmd_code == LPDDR2_NVM_BUF_PROGRAM) ||
> +               (cmd_code == LPDDR2_NVM_BUF_OVERWRITE)) {
> +               prg_buff_ofs = (map_read(map,
> +                       ow_reg_add(map, PRG_BUFFER_OFS))).x[0];
> +               for (i = 0; i < cmd_mpr; i++) {
> +                       map_write(map, build_map_word(buf[i]), map->pfow_base +
> +                       prg_buff_ofs + i);
> +               }
> +       }
> +
> +       /* Command Execute */
> +       map_write(map, exec_cmd, ow_reg_add(map, CMD_EXEC_OFS));
> +       if (pcm_data->bus_width == 0x0004)      /* 2x16 devices stacked */
> +               map_write(map, exec_cmd, ow_reg_add(map, CMD_EXEC_OFS) + 2);
> +
> +       /* Status Register Check */
> +       do {
> +               sr = map_read(map, ow_reg_add(map, STATUS_REG_OFS));
> +               status_reg = sr.x[0];
> +               if (pcm_data->bus_width == 0x0004) {/* 2x16 devices stacked */
> +                       sr = map_read(map, ow_reg_add(map,
> +                               STATUS_REG_OFS) + 2);
> +                       status_reg += sr.x[0] << 16;
> +               }
> +       } while ((status_reg & sr_ok_datamask) != sr_ok_datamask);
> +
> +       return (((status_reg & sr_ok_datamask) == sr_ok_datamask) ? 0 : -EIO);
> +}
> +
> +/*
> + * Execute lpddr2-nvm operations @ block level
> + */
> +static int lpddr2_nvm_do_block_op(struct mtd_info *mtd, loff_t start_add,
> +       uint64_t len, u_char block_op)
> +{
> +       struct map_info *map = mtd->priv;
> +       u_long add, end_add;
> +       int ret = 0;
> +
> +       mutex_lock(&lpdd2_nvm_mutex);
> +
> +       ow_enable(map);
> +
> +       add = start_add;
> +       end_add = add + len;
> +
> +       do {
> +               ret = lpddr2_nvm_do_op(map, block_op, 0x00, add, add, NULL);
> +               if (ret)
> +                       goto out;
> +               add += mtd->erasesize;
> +       } while (add < end_add);
> +
> +out:
> +       ow_disable(map);
> +       mutex_unlock(&lpdd2_nvm_mutex);
> +       return ret;
> +}
> +
> +/*
> + * verify presence of PFOW string
> + */
> +static int lpddr2_nvm_pfow_present(struct map_info *map)
> +{
> +       map_word pfow_val[4];
> +       unsigned int found = 1;
> +
> +       mutex_lock(&lpdd2_nvm_mutex);
> +
> +       ow_enable(map);
> +
> +       /* Load string from array */
> +       pfow_val[0] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_P));
> +       pfow_val[1] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_F));
> +       pfow_val[2] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_O));
> +       pfow_val[3] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_W));
> +
> +       /* Verify the string loaded vs expected */
> +       if (!map_word_equal(map, build_map_word('P'), pfow_val[0]))
> +               found = 0;
> +       if (!map_word_equal(map, build_map_word('F'), pfow_val[1]))
> +               found = 0;
> +       if (!map_word_equal(map, build_map_word('O'), pfow_val[2]))
> +               found = 0;
> +       if (!map_word_equal(map, build_map_word('W'), pfow_val[3]))
> +               found = 0;
> +
> +       ow_disable(map);
> +
> +       mutex_unlock(&lpdd2_nvm_mutex);
> +
> +       return found;
> +}
> +
> +/*
> + * lpddr2_nvm driver read method
> + */
> +static int lpddr2_nvm_read(struct mtd_info *mtd, loff_t start_add,
> +                               size_t len, size_t *retlen, u_char *buf)
> +{
> +       struct map_info *map = mtd->priv;
> +
> +       mutex_lock(&lpdd2_nvm_mutex);
> +
> +       *retlen = len;
> +
> +       map_copy_from(map, buf, start_add, *retlen);
> +
> +       mutex_unlock(&lpdd2_nvm_mutex);
> +       return 0;
> +}
> +
> +/*
> + * lpddr2_nvm driver write method
> + */
> +static int lpddr2_nvm_write(struct mtd_info *mtd, loff_t start_add,
> +                               size_t len, size_t *retlen, const u_char *buf)
> +{
> +       struct map_info *map = mtd->priv;
> +       struct pcm_int_data *pcm_data = map->fldrv_priv;
> +       u_long add, current_len, tot_len, target_len, my_data;
> +       u_char *write_buf = (u_char *)buf;
> +       int ret = 0;
> +
> +       mutex_lock(&lpdd2_nvm_mutex);
> +
> +       ow_enable(map);
> +
> +       /* Set start value for the variables */
> +       add = start_add;
> +       target_len = len;
> +       tot_len = 0;
> +
> +       while (tot_len < target_len) {
> +               if (!(IS_ALIGNED(add, mtd->writesize))) { /* do sw program */
> +                       my_data = write_buf[tot_len];
> +                       my_data += (write_buf[tot_len+1]) << 8;
> +                       if (pcm_data->bus_width == 0x0004) {/* 2x16 devices */
> +                               my_data += (write_buf[tot_len+2]) << 16;
> +                               my_data += (write_buf[tot_len+3]) << 24;
> +                       }
> +                       ret = lpddr2_nvm_do_op(map, LPDDR2_NVM_SW_OVERWRITE,
> +                               my_data, add, 0x00, NULL);
> +                       if (ret)
> +                               goto out;
> +
> +                       add += pcm_data->bus_width;
> +                       tot_len += pcm_data->bus_width;
> +               } else {                /* do buffer program */
> +                       current_len = min(target_len - tot_len,
> +                               (u_long) mtd->writesize);
> +                       ret = lpddr2_nvm_do_op(map, LPDDR2_NVM_BUF_OVERWRITE,
> +                               0x00, add, current_len, write_buf + tot_len);
> +                       if (ret)
> +                               goto out;
> +
> +                       add += current_len;
> +                       tot_len += current_len;
> +               }
> +       }
> +
> +out:
> +       *retlen = tot_len;
> +       ow_disable(map);
> +       mutex_unlock(&lpdd2_nvm_mutex);
> +       return ret;
> +}
> +
> +/*
> + * lpddr2_nvm driver erase method
> + */
> +static int lpddr2_nvm_erase(struct mtd_info *mtd, struct erase_info *instr)
> +{
> +       int ret = lpddr2_nvm_do_block_op(mtd, instr->addr, instr->len,
> +               LPDDR2_NVM_ERASE);
> +       if (!ret) {
> +               instr->state = MTD_ERASE_DONE;
> +               mtd_erase_callback(instr);
> +       }
> +
> +       return ret;
> +}
> +
> +/*
> + * lpddr2_nvm driver unlock method
> + */
> +static int lpddr2_nvm_unlock(struct mtd_info *mtd, loff_t start_add,
> +       uint64_t len)
> +{
> +       return lpddr2_nvm_do_block_op(mtd, start_add, len, LPDDR2_NVM_UNLOCK);
> +}
> +
> +/*
> + * lpddr2_nvm driver lock method
> + */
> +static int lpddr2_nvm_lock(struct mtd_info *mtd, loff_t start_add,
> +       uint64_t len)
> +{
> +       return lpddr2_nvm_do_block_op(mtd, start_add, len, LPDDR2_NVM_LOCK);
> +}
> +
> +/*
> + * lpddr2_nvm driver probe method
> + */
> +static int lpddr2_nvm_probe(struct platform_device *pdev)
> +{
> +       struct map_info *map;
> +       struct mtd_info *mtd;
> +       struct resource *add_range = platform_get_resource(pdev,
> +                                               IORESOURCE_MEM, 0);
> +       struct resource *control_regs = platform_get_resource(pdev,
> +                                               IORESOURCE_MEM, 1);
> +       struct resource *buswidth = platform_get_resource(pdev,
> +                                               IORESOURCE_BUS, 0);
> +       struct pcm_int_data *pcm_data;
> +
> +       /* Allocate memory control_regs data structures */
> +       pcm_data = devm_kzalloc(&pdev->dev, sizeof(*pcm_data), GFP_KERNEL);
> +       if (!pcm_data)
> +               return -ENOMEM;
> +       pcm_data->reg_data =    (void *) control_regs->start;
> +       pcm_data->reg_cfg =     (void *) control_regs->end;
> +       pcm_data->bus_width =   (int) buswidth->start;
> +
> +       /* Allocate memory for map_info & mtd_info data structures */
> +       map = devm_kzalloc(&pdev->dev, sizeof(*map), GFP_KERNEL);
> +       if (!map)
> +               return -ENOMEM;
> +
> +       mtd = devm_kzalloc(&pdev->dev, sizeof(*mtd), GFP_KERNEL);
> +       if (!mtd)
> +               return -ENOMEM;
> +
> +       /* Reserve lpddr2_nvm address range */
> +       if (devm_request_mem_region(&pdev->dev, add_range->start,
> +               (add_range->end - add_range->start + 1),
> +               "lpddr2_nvm") == NULL) {
> +               pr_err("Unable to reserve address range\n");
> +               return -EBUSY;
> +       }
> +
> +       /* Populate map_info data structure */
> +       *map = (struct map_info) {
> +               .virt           = devm_ioremap_nocache(&pdev->dev,
> +                               add_range->start, (add_range->end -
> +                               add_range->start a + 1)),
> +               .name           = pdev->dev.init_name,
> +               .phys           = add_range->start,
> +               .size           = add_range->end - add_range->start + 1,
> +               .bankwidth      = pcm_data->bus_width/2,
> +               .pfow_base      = OW_BASE_ADDRESS,
> +               .fldrv_priv     = pcm_data,
> +       };
> +
> +       simple_map_init(map);   /* fill with default methods */
> +
> +       /* Populate mtd_info data structure */
> +       *mtd = (struct mtd_info) {
> +               .name           = pdev->dev.init_name,
> +               .type           = MTD_RAM,
> +               .priv           = map,
> +               .size           = add_range->end - add_range->start + 1,
> +               .erasesize      = ERASE_BLOCKSIZE * pcm_data->bus_width,
> +               .writesize      = 1,
> +               .writebufsize   = WRITE_BUFFSIZE * pcm_data->bus_width,
> +               .flags          = (MTD_CAP_NVRAM | MTD_POWERUP_LOCK),
> +               ._read          = lpddr2_nvm_read,
> +               ._write         = lpddr2_nvm_write,
> +               ._erase         = lpddr2_nvm_erase,
> +               ._unlock        = lpddr2_nvm_unlock,
> +               ._lock          = lpddr2_nvm_lock,
> +       };
> +
> +       /* Verify the presence of the device looking for PFOW string */
> +       if (!lpddr2_nvm_pfow_present(map)) {
> +               pr_err("device not recognized\n");
> +               return -EINVAL;
> +       }
> +       /* Register the mtd_partition structure */
> +       return mtd_add_partition(mtd, "my_pcm", 0x10000000, 0x00);
> +}
> +
> +/* Initialize platform_driver data structure for lpddr2_nvm */
> +static struct platform_driver lpddr2_nvm_drv = {
> +       .driver         = {
> +               .name   = "lpddr2_nvm",
> +       },
> +       .probe          = lpddr2_nvm_probe,
> +};
> +
> +module_platform_driver(lpddr2_nvm_drv);
> +MODULE_LICENSE("GPL");
> +MODULE_AUTHOR("Vincenzo Aliberti <vincenzo.aliberti@gmail.com>");
> +MODULE_DESCRIPTION("MTD driver for LPDDR2-NVM PCM memories");
> diff --git a/include/uapi/mtd/mtd-abi.h b/include/uapi/mtd/mtd-abi.h
> index 36eace0..8a2bbf2 100644
> --- a/include/uapi/mtd/mtd-abi.h
> +++ b/include/uapi/mtd/mtd-abi.h
> @@ -107,6 +107,7 @@ struct mtd_write_req {
>  /* Some common devices / combinations of capabilities */
>  #define MTD_CAP_ROM            0
>  #define MTD_CAP_RAM            (MTD_WRITEABLE | MTD_BIT_WRITEABLE | MTD_NO_ERASE)
> +#define MTD_CAP_NVRAM          (MTD_WRITEABLE | MTD_BIT_WRITEABLE | MTD_NO_ERASE)
>  #define MTD_CAP_NORFLASH       (MTD_WRITEABLE | MTD_BIT_WRITEABLE)
>  #define MTD_CAP_NANDFLASH      (MTD_WRITEABLE)
>
> --
> 1.7.9.5
>
Brian Norris Feb. 27, 2014, 8:37 a.m. UTC | #2
Hi Vincenzo,

On Mon, Feb 10, 2014 at 11:28:54AM +0100, Vincenzo Aliberti wrote:
> Any feedback on this?

Sure! I see that you never replied to my feed back back in August:

http://lists.infradead.org/pipermail/linux-mtd/2013-August/048094.html

But it looks like you did address many of the problems I had originally.
Can you please double check and review my comments though, since I
didn't hear anything from you after I spent the time to review it?

> On Sun, Jan 19, 2014 at 10:34 PM,  <vincenzo.aliberti@gmail.com> wrote:
> > From: Vincenzo Aliberti <vincenzo.aliberti@gmail.com>
> >
> > Signed-off-by: Vincenzo Aliberti <vincenzo.aliberti@gmail.com>
> >
> > ---
> >  drivers/mtd/lpddr/Kconfig      |   12 +-
> >  drivers/mtd/lpddr/lpddr2_nvm.c |  504 ++++++++++++++++++++++++++++++++++++++++
> >  include/uapi/mtd/mtd-abi.h     |    1 +

One thing right off the bat: you didn't add your driver to
drivers/mtd/lpddr/Makefile!

> >  3 files changed, 515 insertions(+), 2 deletions(-)
> >  create mode 100644 drivers/mtd/lpddr/lpddr2_nvm.c
> >
> > diff --git a/drivers/mtd/lpddr/Kconfig b/drivers/mtd/lpddr/Kconfig
> > index 265f969..94a7f30 100644
> > --- a/drivers/mtd/lpddr/Kconfig
> > +++ b/drivers/mtd/lpddr/Kconfig
> > @@ -1,5 +1,5 @@
> > -menu "LPDDR flash memory drivers"
> > -       depends on MTD!=n
> > +menu "LPDDR & LPDDR2 PCM memory drivers"
> > +       depends on MTD
> >
> >  config MTD_LPDDR
> >         tristate "Support for LPDDR flash chips"
> > @@ -17,4 +17,12 @@ config MTD_QINFO_PROBE
> >             Window QINFO interface, permits software to be used for entire
> >             families of devices. This serves similar purpose of CFI on legacy
> >             Flash products
> > +
> > +config MTD_LPDDR2_NVM
> > +       depends on MTD && ARM
> > +       tristate "Support for LPDDR2-NVM flash chips"
> > +       help
> > +         This option enables support of PCM memories with a LPDDR2-NVM
> > +         (Low power double data rate 2) interface.
> > +
> >  endmenu
> > diff --git a/drivers/mtd/lpddr/lpddr2_nvm.c b/drivers/mtd/lpddr/lpddr2_nvm.c
> > new file mode 100644
> > index 0000000..23377c8
> > --- /dev/null
> > +++ b/drivers/mtd/lpddr/lpddr2_nvm.c
> > @@ -0,0 +1,504 @@
> > +/*
> > + * LPDDR2-NVM MTD driver. This module provides read, write, erase, lock/unlock
> > + * support for LPDDR2-NVM PCM memories
> > + *
> > + * Copyright © 2012 Micron Technology, Inc.

You still didn't update the copyright...

> > + *
> > + * Vincenzo Aliberti <vincenzo.aliberti@gmail.com>
> > + * Domenico Manna <domenico.manna@gmail.com>
> > + * Many thanks to Andrea Vigilante for initial enabling
> > + *
> > + * This program is free software; you can redistribute it and/or
> > + * modify it under the terms of the GNU General Public License
> > + * as published by the Free Software Foundation; either version 2
> > + * of the License, or (at your option) any later version.
> > + *
> > + * This program is distributed in the hope that it will be useful,
> > + * but WITHOUT ANY WARRANTY; without even the implied warranty of
> > + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
> > + * GNU General Public License for more details.
> > + *
> > + * You should have received a copy of the GNU General Public License
> > + * along with this program; if not, write to the Free Software
> > + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
> > + * 02110-1301, USA.
> > + */
> > +
> > +#define pr_fmt(fmt) KBUILD_MODNAME ":%s: " fmt, __func__

Missing a space between the ':' and '%s':

#define pr_fmt(fmt) KBUILD_MODNAME ": %s: " fmt, __func__

> > +
> > +#include <linux/init.h>
> > +#include <linux/io.h>
> > +#include <linux/module.h>
> > +#include <linux/kernel.h>
> > +#include <linux/mtd/map.h>
> > +#include <linux/mtd/mtd.h>
> > +#include <linux/mtd/partitions.h>
> > +#include <linux/slab.h>
> > +#include <linux/platform_device.h>
> > +#include <linux/ioport.h>
> > +#include <linux/sched.h>
> > +
> > +/* Parameters */
> > +#define ERASE_BLOCKSIZE                        (0x00020000/2)  /* in Word */
> > +#define WRITE_BUFFSIZE                 (0x00000400/2)  /* in Word */
> > +#define OW_BASE_ADDRESS                        0x00000000      /* OW offset */
> > +
> > +/* PFOW symbols address offset */
> > +#define PFOW_QUERY_STRING_P            (0x0000/2)      /* in Word */
> > +#define PFOW_QUERY_STRING_F            (0x0002/2)      /* in Word */
> > +#define PFOW_QUERY_STRING_O            (0x0004/2)      /* in Word */
> > +#define PFOW_QUERY_STRING_W            (0x0006/2)      /* in Word */
> > +
> > +/* OW registers address */
> > +#define CMD_CODE_OFS                   (0x0080/2)      /* in Word */
> > +#define CMD_DATA_OFS                   (0x0084/2)      /* in Word */
> > +#define CMD_ADD_L_OFS                  (0x0088/2)      /* in Word */
> > +#define CMD_ADD_H_OFS                  (0x008A/2)      /* in Word */
> > +#define MPR_L_OFS                      (0x0090/2)      /* in Word */
> > +#define MPR_H_OFS                      (0x0092/2)      /* in Word */
> > +#define CMD_EXEC_OFS                   (0x00C0/2)      /* in Word */
> > +#define STATUS_REG_OFS                 (0x00CC/2)      /* in Word */
> > +#define PRG_BUFFER_OFS                 (0x0010/2)      /* in Word */
> > +
> > +/* Datamask */
> > +#define MR_CFGMASK                     0x8000
> > +#define SR_OK_DATAMASK                 0x0080
> > +
> > +/* LPDDR2-NVM Commands */
> > +#define LPDDR2_NVM_LOCK                        0x0061
> > +#define LPDDR2_NVM_UNLOCK              0x0062
> > +#define LPDDR2_NVM_SW_PROGRAM          0x0041
> > +#define LPDDR2_NVM_SW_OVERWRITE                0x0042
> > +#define LPDDR2_NVM_BUF_PROGRAM         0x00E9
> > +#define LPDDR2_NVM_BUF_OVERWRITE       0x00EA
> > +#define LPDDR2_NVM_ERASE               0x0020
> > +
> > +/*
> > + * Internal Type Definitions
> > + * pcm_int_data contains memory controller details:
> > + * @reg_data : LPDDR2_MODE_REG_DATA register address after remapping
> > + * @reg_cfg  : LPDDR2_MODE_REG_CFG register address after remapping
> > + * &bus_width: memory bus-width (eg: x16 2 Bytes, x32 4 Bytes)
> > + */
> > +struct pcm_int_data {
> > +       void __iomem *reg_data;
> > +       void __iomem *reg_cfg;
> > +       int bus_width;
> > +};
> > +
> > +static DEFINE_MUTEX(lpdd2_nvm_mutex);
> > +
> > +/*
> > + * Build a map_word starting from an u_long
> > + */
> > +static inline map_word build_map_word(u_long myword)
> > +{
> > +       map_word val = { {0} };
> > +       val.x[0] = myword;
> > +       return val;
> > +}
> > +
> > +/*
> > + * Build Mode Register Configuration DataMask based on device bus-width
> > + */
> > +static inline u_int build_mr_cfgmask(u_int bus_width)
> > +{
> > +       u_int val = MR_CFGMASK;
> > +
> > +       if (bus_width == 0x0004)                /* x32 device */
> > +               val = val << 16;
> > +
> > +       return val;
> > +}
> > +
> > +/*
> > + * Build Status Register OK DataMask based on device bus-width
> > + */
> > +static inline u_int build_sr_ok_datamask(u_int bus_width)
> > +{
> > +       u_int val = SR_OK_DATAMASK;
> > +
> > +       if (bus_width == 0x0004)                /* x32 device */
> > +               val = (val << 16)+val;
> > +
> > +       return val;
> > +}
> > +
> > +/*
> > + * Evaluates Overlay Window Control Registers address
> > + */
> > +static inline u_long ow_reg_add(struct map_info *map, u_long offset)
> > +{
> > +       u_long val = 0;
> > +       struct pcm_int_data *pcm_data = map->fldrv_priv;
> > +
> > +       val = map->pfow_base + offset*pcm_data->bus_width;
> > +
> > +       return val;
> > +}
> > +
> > +/*
> > + * Enable lpddr2-nvm Overlay Window
> > + * Overlay Window is a memory mapped area containing all LPDDR2-NVM registers
> > + * used by device commands as well as uservisible resources like Device Status
> > + * Register, Device ID, etc
> > + */
> > +static inline void ow_enable(struct map_info *map)
> > +{
> > +       struct pcm_int_data *pcm_data = map->fldrv_priv;
> > +
> > +       writel_relaxed(build_mr_cfgmask(pcm_data->bus_width) | 0x18,
> > +               pcm_data->reg_cfg);
> > +       writel_relaxed(0x01, pcm_data->reg_data);
> > +}
> > +
> > +/*
> > + * Disable lpddr2-nvm Overlay Window
> > + * Overlay Window is a memory mapped area containing all LPDDR2-NVM registers
> > + * used by device commands as well as uservisible resources like Device Status
> > + * Register, Device ID, etc
> > + */
> > +static inline void ow_disable(struct map_info *map)
> > +{
> > +       struct pcm_int_data *pcm_data = map->fldrv_priv;
> > +
> > +       writel_relaxed(build_mr_cfgmask(pcm_data->bus_width) | 0x18,
> > +               pcm_data->reg_cfg);
> > +       writel_relaxed(0x02, pcm_data->reg_data);
> > +}
> > +
> > +/*
> > + * Execute lpddr2-nvm operations
> > + */
> > +static int lpddr2_nvm_do_op(struct map_info *map, u_long cmd_code,
> > +       u_long cmd_data, u_long cmd_add, u_long cmd_mpr, u_char *buf)
> > +{
> > +       map_word add_l = { {0} }, add_h = { {0} }, mpr_l = { {0} },
> > +               mpr_h = { {0} }, data_l = { {0} }, cmd = { {0} },
> > +               exec_cmd = { {0} }, sr;
> > +       map_word data_h = { {0} };      /* only for 2x x16 devices stacked */
> > +       u_long i, status_reg, prg_buff_ofs;
> > +       struct pcm_int_data *pcm_data = map->fldrv_priv;
> > +       u_int sr_ok_datamask = build_sr_ok_datamask(pcm_data->bus_width);
> > +
> > +       /* Builds low and high words for OW Control Registers */
> > +       add_l.x[0]      = cmd_add & 0x0000FFFF;
> > +       add_h.x[0]      = (cmd_add >> 16) & 0x0000FFFF;
> > +       mpr_l.x[0]      = cmd_mpr & 0x0000FFFF;
> > +       mpr_h.x[0]      = (cmd_mpr >> 16) & 0x0000FFFF;
> > +       cmd.x[0]        = cmd_code & 0x0000FFFF;
> > +       exec_cmd.x[0]   = 0x0001;
> > +       data_l.x[0]     = cmd_data & 0x0000FFFF;
> > +       data_h.x[0]     = (cmd_data >> 16) & 0x0000FFFF; /* only for 2x x16 */
> > +
> > +       /* Set Overlay Window Control Registers */
> > +       map_write(map, cmd, ow_reg_add(map, CMD_CODE_OFS));
> > +       map_write(map, data_l, ow_reg_add(map, CMD_DATA_OFS));
> > +       map_write(map, add_l, ow_reg_add(map, CMD_ADD_L_OFS));
> > +       map_write(map, add_h, ow_reg_add(map, CMD_ADD_H_OFS));
> > +       map_write(map, mpr_l, ow_reg_add(map, MPR_L_OFS));
> > +       map_write(map, mpr_h, ow_reg_add(map, MPR_H_OFS));
> > +       if (pcm_data->bus_width == 0x0004) {    /* 2x16 devices stacked */
> > +               map_write(map, cmd, ow_reg_add(map, CMD_CODE_OFS) + 2);
> > +               map_write(map, data_h, ow_reg_add(map, CMD_DATA_OFS) + 2);
> > +               map_write(map, add_l, ow_reg_add(map, CMD_ADD_L_OFS) + 2);
> > +               map_write(map, add_h, ow_reg_add(map, CMD_ADD_H_OFS) + 2);
> > +               map_write(map, mpr_l, ow_reg_add(map, MPR_L_OFS) + 2);
> > +               map_write(map, mpr_h, ow_reg_add(map, MPR_H_OFS) + 2);
> > +       }
> > +
> > +       /* Fill Program Buffer */
> > +       if ((cmd_code == LPDDR2_NVM_BUF_PROGRAM) ||
> > +               (cmd_code == LPDDR2_NVM_BUF_OVERWRITE)) {
> > +               prg_buff_ofs = (map_read(map,
> > +                       ow_reg_add(map, PRG_BUFFER_OFS))).x[0];
> > +               for (i = 0; i < cmd_mpr; i++) {
> > +                       map_write(map, build_map_word(buf[i]), map->pfow_base +
> > +                       prg_buff_ofs + i);
> > +               }
> > +       }
> > +
> > +       /* Command Execute */
> > +       map_write(map, exec_cmd, ow_reg_add(map, CMD_EXEC_OFS));
> > +       if (pcm_data->bus_width == 0x0004)      /* 2x16 devices stacked */
> > +               map_write(map, exec_cmd, ow_reg_add(map, CMD_EXEC_OFS) + 2);
> > +
> > +       /* Status Register Check */
> > +       do {
> > +               sr = map_read(map, ow_reg_add(map, STATUS_REG_OFS));
> > +               status_reg = sr.x[0];
> > +               if (pcm_data->bus_width == 0x0004) {/* 2x16 devices stacked */
> > +                       sr = map_read(map, ow_reg_add(map,
> > +                               STATUS_REG_OFS) + 2);
> > +                       status_reg += sr.x[0] << 16;
> > +               }
> > +       } while ((status_reg & sr_ok_datamask) != sr_ok_datamask);
> > +
> > +       return (((status_reg & sr_ok_datamask) == sr_ok_datamask) ? 0 : -EIO);
> > +}
> > +
> > +/*
> > + * Execute lpddr2-nvm operations @ block level
> > + */
> > +static int lpddr2_nvm_do_block_op(struct mtd_info *mtd, loff_t start_add,
> > +       uint64_t len, u_char block_op)
> > +{
> > +       struct map_info *map = mtd->priv;
> > +       u_long add, end_add;
> > +       int ret = 0;
> > +
> > +       mutex_lock(&lpdd2_nvm_mutex);
> > +
> > +       ow_enable(map);
> > +
> > +       add = start_add;
> > +       end_add = add + len;
> > +
> > +       do {
> > +               ret = lpddr2_nvm_do_op(map, block_op, 0x00, add, add, NULL);
> > +               if (ret)
> > +                       goto out;
> > +               add += mtd->erasesize;
> > +       } while (add < end_add);
> > +
> > +out:
> > +       ow_disable(map);
> > +       mutex_unlock(&lpdd2_nvm_mutex);
> > +       return ret;
> > +}
> > +
> > +/*
> > + * verify presence of PFOW string
> > + */
> > +static int lpddr2_nvm_pfow_present(struct map_info *map)
> > +{
> > +       map_word pfow_val[4];
> > +       unsigned int found = 1;
> > +
> > +       mutex_lock(&lpdd2_nvm_mutex);
> > +
> > +       ow_enable(map);
> > +
> > +       /* Load string from array */
> > +       pfow_val[0] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_P));
> > +       pfow_val[1] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_F));
> > +       pfow_val[2] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_O));
> > +       pfow_val[3] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_W));
> > +
> > +       /* Verify the string loaded vs expected */
> > +       if (!map_word_equal(map, build_map_word('P'), pfow_val[0]))
> > +               found = 0;
> > +       if (!map_word_equal(map, build_map_word('F'), pfow_val[1]))
> > +               found = 0;
> > +       if (!map_word_equal(map, build_map_word('O'), pfow_val[2]))
> > +               found = 0;
> > +       if (!map_word_equal(map, build_map_word('W'), pfow_val[3]))
> > +               found = 0;
> > +
> > +       ow_disable(map);
> > +
> > +       mutex_unlock(&lpdd2_nvm_mutex);
> > +
> > +       return found;
> > +}
> > +
> > +/*
> > + * lpddr2_nvm driver read method
> > + */
> > +static int lpddr2_nvm_read(struct mtd_info *mtd, loff_t start_add,
> > +                               size_t len, size_t *retlen, u_char *buf)
> > +{
> > +       struct map_info *map = mtd->priv;
> > +
> > +       mutex_lock(&lpdd2_nvm_mutex);
> > +
> > +       *retlen = len;
> > +
> > +       map_copy_from(map, buf, start_add, *retlen);
> > +
> > +       mutex_unlock(&lpdd2_nvm_mutex);
> > +       return 0;
> > +}
> > +
> > +/*
> > + * lpddr2_nvm driver write method
> > + */
> > +static int lpddr2_nvm_write(struct mtd_info *mtd, loff_t start_add,
> > +                               size_t len, size_t *retlen, const u_char *buf)
> > +{
> > +       struct map_info *map = mtd->priv;
> > +       struct pcm_int_data *pcm_data = map->fldrv_priv;
> > +       u_long add, current_len, tot_len, target_len, my_data;
> > +       u_char *write_buf = (u_char *)buf;
> > +       int ret = 0;
> > +
> > +       mutex_lock(&lpdd2_nvm_mutex);
> > +
> > +       ow_enable(map);
> > +
> > +       /* Set start value for the variables */
> > +       add = start_add;
> > +       target_len = len;
> > +       tot_len = 0;
> > +
> > +       while (tot_len < target_len) {
> > +               if (!(IS_ALIGNED(add, mtd->writesize))) { /* do sw program */
> > +                       my_data = write_buf[tot_len];
> > +                       my_data += (write_buf[tot_len+1]) << 8;
> > +                       if (pcm_data->bus_width == 0x0004) {/* 2x16 devices */
> > +                               my_data += (write_buf[tot_len+2]) << 16;
> > +                               my_data += (write_buf[tot_len+3]) << 24;
> > +                       }
> > +                       ret = lpddr2_nvm_do_op(map, LPDDR2_NVM_SW_OVERWRITE,
> > +                               my_data, add, 0x00, NULL);
> > +                       if (ret)
> > +                               goto out;
> > +
> > +                       add += pcm_data->bus_width;
> > +                       tot_len += pcm_data->bus_width;
> > +               } else {                /* do buffer program */
> > +                       current_len = min(target_len - tot_len,
> > +                               (u_long) mtd->writesize);
> > +                       ret = lpddr2_nvm_do_op(map, LPDDR2_NVM_BUF_OVERWRITE,
> > +                               0x00, add, current_len, write_buf + tot_len);
> > +                       if (ret)
> > +                               goto out;
> > +
> > +                       add += current_len;
> > +                       tot_len += current_len;
> > +               }
> > +       }
> > +
> > +out:
> > +       *retlen = tot_len;
> > +       ow_disable(map);
> > +       mutex_unlock(&lpdd2_nvm_mutex);
> > +       return ret;
> > +}
> > +
> > +/*
> > + * lpddr2_nvm driver erase method
> > + */
> > +static int lpddr2_nvm_erase(struct mtd_info *mtd, struct erase_info *instr)
> > +{
> > +       int ret = lpddr2_nvm_do_block_op(mtd, instr->addr, instr->len,
> > +               LPDDR2_NVM_ERASE);
> > +       if (!ret) {
> > +               instr->state = MTD_ERASE_DONE;
> > +               mtd_erase_callback(instr);
> > +       }
> > +
> > +       return ret;
> > +}
> > +
> > +/*
> > + * lpddr2_nvm driver unlock method
> > + */
> > +static int lpddr2_nvm_unlock(struct mtd_info *mtd, loff_t start_add,
> > +       uint64_t len)
> > +{
> > +       return lpddr2_nvm_do_block_op(mtd, start_add, len, LPDDR2_NVM_UNLOCK);
> > +}
> > +
> > +/*
> > + * lpddr2_nvm driver lock method
> > + */
> > +static int lpddr2_nvm_lock(struct mtd_info *mtd, loff_t start_add,
> > +       uint64_t len)
> > +{
> > +       return lpddr2_nvm_do_block_op(mtd, start_add, len, LPDDR2_NVM_LOCK);
> > +}
> > +
> > +/*
> > + * lpddr2_nvm driver probe method
> > + */
> > +static int lpddr2_nvm_probe(struct platform_device *pdev)
> > +{
> > +       struct map_info *map;
> > +       struct mtd_info *mtd;
> > +       struct resource *add_range = platform_get_resource(pdev,
> > +                                               IORESOURCE_MEM, 0);
> > +       struct resource *control_regs = platform_get_resource(pdev,
> > +                                               IORESOURCE_MEM, 1);
> > +       struct resource *buswidth = platform_get_resource(pdev,
> > +                                               IORESOURCE_BUS, 0);
> > +       struct pcm_int_data *pcm_data;
> > +
> > +       /* Allocate memory control_regs data structures */
> > +       pcm_data = devm_kzalloc(&pdev->dev, sizeof(*pcm_data), GFP_KERNEL);
> > +       if (!pcm_data)
> > +               return -ENOMEM;
> > +       pcm_data->reg_data =    (void *) control_regs->start;
> > +       pcm_data->reg_cfg =     (void *) control_regs->end;
> > +       pcm_data->bus_width =   (int) buswidth->start;
> > +
> > +       /* Allocate memory for map_info & mtd_info data structures */
> > +       map = devm_kzalloc(&pdev->dev, sizeof(*map), GFP_KERNEL);
> > +       if (!map)
> > +               return -ENOMEM;
> > +
> > +       mtd = devm_kzalloc(&pdev->dev, sizeof(*mtd), GFP_KERNEL);
> > +       if (!mtd)
> > +               return -ENOMEM;
> > +
> > +       /* Reserve lpddr2_nvm address range */
> > +       if (devm_request_mem_region(&pdev->dev, add_range->start,
> > +               (add_range->end - add_range->start + 1),
> > +               "lpddr2_nvm") == NULL) {
> > +               pr_err("Unable to reserve address range\n");
> > +               return -EBUSY;
> > +       }
> > +
> > +       /* Populate map_info data structure */
> > +       *map = (struct map_info) {
> > +               .virt           = devm_ioremap_nocache(&pdev->dev,
> > +                               add_range->start, (add_range->end -
> > +                               add_range->start a + 1)),
> > +               .name           = pdev->dev.init_name,
> > +               .phys           = add_range->start,
> > +               .size           = add_range->end - add_range->start + 1,
> > +               .bankwidth      = pcm_data->bus_width/2,
> > +               .pfow_base      = OW_BASE_ADDRESS,
> > +               .fldrv_priv     = pcm_data,
> > +       };
> > +
> > +       simple_map_init(map);   /* fill with default methods */
> > +
> > +       /* Populate mtd_info data structure */
> > +       *mtd = (struct mtd_info) {
> > +               .name           = pdev->dev.init_name,
> > +               .type           = MTD_RAM,
> > +               .priv           = map,
> > +               .size           = add_range->end - add_range->start + 1,
> > +               .erasesize      = ERASE_BLOCKSIZE * pcm_data->bus_width,
> > +               .writesize      = 1,
> > +               .writebufsize   = WRITE_BUFFSIZE * pcm_data->bus_width,
> > +               .flags          = (MTD_CAP_NVRAM | MTD_POWERUP_LOCK),
> > +               ._read          = lpddr2_nvm_read,
> > +               ._write         = lpddr2_nvm_write,
> > +               ._erase         = lpddr2_nvm_erase,
> > +               ._unlock        = lpddr2_nvm_unlock,
> > +               ._lock          = lpddr2_nvm_lock,
> > +       };
> > +
> > +       /* Verify the presence of the device looking for PFOW string */
> > +       if (!lpddr2_nvm_pfow_present(map)) {
> > +               pr_err("device not recognized\n");
> > +               return -EINVAL;
> > +       }
> > +       /* Register the mtd_partition structure */
> > +       return mtd_add_partition(mtd, "my_pcm", 0x10000000, 0x00);
> > +}
> > +
> > +/* Initialize platform_driver data structure for lpddr2_nvm */
> > +static struct platform_driver lpddr2_nvm_drv = {
> > +       .driver         = {
> > +               .name   = "lpddr2_nvm",
> > +       },
> > +       .probe          = lpddr2_nvm_probe,
> > +};
> > +
> > +module_platform_driver(lpddr2_nvm_drv);
> > +MODULE_LICENSE("GPL");
> > +MODULE_AUTHOR("Vincenzo Aliberti <vincenzo.aliberti@gmail.com>");
> > +MODULE_DESCRIPTION("MTD driver for LPDDR2-NVM PCM memories");
> > diff --git a/include/uapi/mtd/mtd-abi.h b/include/uapi/mtd/mtd-abi.h
> > index 36eace0..8a2bbf2 100644
> > --- a/include/uapi/mtd/mtd-abi.h
> > +++ b/include/uapi/mtd/mtd-abi.h
> > @@ -107,6 +107,7 @@ struct mtd_write_req {
> >  /* Some common devices / combinations of capabilities */
> >  #define MTD_CAP_ROM            0
> >  #define MTD_CAP_RAM            (MTD_WRITEABLE | MTD_BIT_WRITEABLE | MTD_NO_ERASE)
> > +#define MTD_CAP_NVRAM          (MTD_WRITEABLE | MTD_BIT_WRITEABLE | MTD_NO_ERASE)
> >  #define MTD_CAP_NORFLASH       (MTD_WRITEABLE | MTD_BIT_WRITEABLE)
> >  #define MTD_CAP_NANDFLASH      (MTD_WRITEABLE)
> >

Brian
Vincenzo Aliberti Feb. 27, 2014, 3:04 p.m. UTC | #3
Brian,
   thanks for your feedback, sorry for previous post: in your feedback
you asked me to change
subsystem prefix and this is the reason why I have sent a new one with
different subject.

Here below my feedback: please let me know if I can resend the patch accordingly

Thanks again for your help and sorry fot the mistake,
   Vincenzo

On Thu, Feb 27, 2014 at 9:37 AM, Brian Norris
<computersforpeace@gmail.com> wrote:
> Hi Vincenzo,
>
> On Mon, Feb 10, 2014 at 11:28:54AM +0100, Vincenzo Aliberti wrote:
>> Any feedback on this?
>
> Sure! I see that you never replied to my feed back back in August:
>
> http://lists.infradead.org/pipermail/linux-mtd/2013-August/048094.html
>
> But it looks like you did address many of the problems I had originally.
> Can you please double check and review my comments though, since I
> didn't hear anything from you after I spent the time to review it?
>
>> On Sun, Jan 19, 2014 at 10:34 PM,  <vincenzo.aliberti@gmail.com> wrote:
>> > From: Vincenzo Aliberti <vincenzo.aliberti@gmail.com>
>> >
>> > Signed-off-by: Vincenzo Aliberti <vincenzo.aliberti@gmail.com>
>> >
>> > ---
>> >  drivers/mtd/lpddr/Kconfig      |   12 +-
>> >  drivers/mtd/lpddr/lpddr2_nvm.c |  504 ++++++++++++++++++++++++++++++++++++++++
>> >  include/uapi/mtd/mtd-abi.h     |    1 +
>
> One thing right off the bat: you didn't add your driver to
> drivers/mtd/lpddr/Makefile!
>
>> >  3 files changed, 515 insertions(+), 2 deletions(-)
>> >  create mode 100644 drivers/mtd/lpddr/lpddr2_nvm.c
>> >
>> > diff --git a/drivers/mtd/lpddr/Kconfig b/drivers/mtd/lpddr/Kconfig
>> > index 265f969..94a7f30 100644
>> > --- a/drivers/mtd/lpddr/Kconfig
>> > +++ b/drivers/mtd/lpddr/Kconfig
>> > @@ -1,5 +1,5 @@
>> > -menu "LPDDR flash memory drivers"
>> > -       depends on MTD!=n
>> > +menu "LPDDR & LPDDR2 PCM memory drivers"
>> > +       depends on MTD
>> >
>> >  config MTD_LPDDR
>> >         tristate "Support for LPDDR flash chips"
>> > @@ -17,4 +17,12 @@ config MTD_QINFO_PROBE
>> >             Window QINFO interface, permits software to be used for entire
>> >             families of devices. This serves similar purpose of CFI on legacy
>> >             Flash products
>> > +
>> > +config MTD_LPDDR2_NVM
>> > +       depends on MTD && ARM
>> > +       tristate "Support for LPDDR2-NVM flash chips"
>> > +       help
>> > +         This option enables support of PCM memories with a LPDDR2-NVM
>> > +         (Low power double data rate 2) interface.
>> > +
>> >  endmenu
>> > diff --git a/drivers/mtd/lpddr/lpddr2_nvm.c b/drivers/mtd/lpddr/lpddr2_nvm.c
>> > new file mode 100644
>> > index 0000000..23377c8
>> > --- /dev/null
>> > +++ b/drivers/mtd/lpddr/lpddr2_nvm.c
>> > @@ -0,0 +1,504 @@
>> > +/*
>> > + * LPDDR2-NVM MTD driver. This module provides read, write, erase, lock/unlock
>> > + * support for LPDDR2-NVM PCM memories
>> > + *
>> > + * Copyright Š 2012 Micron Technology, Inc.
>
> You still didn't update the copyright...
>
Vincenzo: you are right: some partners started using it in 2012 so I
have kept this for the copyright
>> > + *
>> > + * Vincenzo Aliberti <vincenzo.aliberti@gmail.com>
>> > + * Domenico Manna <domenico.manna@gmail.com>
>> > + * Many thanks to Andrea Vigilante for initial enabling
>> > + *
>> > + * This program is free software; you can redistribute it and/or
>> > + * modify it under the terms of the GNU General Public License
>> > + * as published by the Free Software Foundation; either version 2
>> > + * of the License, or (at your option) any later version.
>> > + *
>> > + * This program is distributed in the hope that it will be useful,
>> > + * but WITHOUT ANY WARRANTY; without even the implied warranty of
>> > + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
>> > + * GNU General Public License for more details.
>> > + *
>> > + * You should have received a copy of the GNU General Public License
>> > + * along with this program; if not, write to the Free Software
>> > + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
>> > + * 02110-1301, USA.
>> > + */
>> > +
>> > +#define pr_fmt(fmt) KBUILD_MODNAME ":%s: " fmt, __func__
>
> Missing a space between the ':' and '%s':
>
Vincenzo: sorry you are right
> #define pr_fmt(fmt) KBUILD_MODNAME ": %s: " fmt, __func__
>
>> > +
>> > +#include <linux/init.h>
>> > +#include <linux/io.h>
>> > +#include <linux/module.h>
>> > +#include <linux/kernel.h>
>> > +#include <linux/mtd/map.h>
>> > +#include <linux/mtd/mtd.h>
>> > +#include <linux/mtd/partitions.h>
>> > +#include <linux/slab.h>
>> > +#include <linux/platform_device.h>
>> > +#include <linux/ioport.h>
>> > +#include <linux/sched.h>
>> > +
>> > +/* Parameters */
>> > +#define ERASE_BLOCKSIZE                        (0x00020000/2)  /* in Word */
>> > +#define WRITE_BUFFSIZE                 (0x00000400/2)  /* in Word */
>> > +#define OW_BASE_ADDRESS                        0x00000000      /* OW offset */
>> > +
>> > +/* PFOW symbols address offset */
>> > +#define PFOW_QUERY_STRING_P            (0x0000/2)      /* in Word */
>> > +#define PFOW_QUERY_STRING_F            (0x0002/2)      /* in Word */
>> > +#define PFOW_QUERY_STRING_O            (0x0004/2)      /* in Word */
>> > +#define PFOW_QUERY_STRING_W            (0x0006/2)      /* in Word */
>> > +
>> > +/* OW registers address */
>> > +#define CMD_CODE_OFS                   (0x0080/2)      /* in Word */
>> > +#define CMD_DATA_OFS                   (0x0084/2)      /* in Word */
>> > +#define CMD_ADD_L_OFS                  (0x0088/2)      /* in Word */
>> > +#define CMD_ADD_H_OFS                  (0x008A/2)      /* in Word */
>> > +#define MPR_L_OFS                      (0x0090/2)      /* in Word */
>> > +#define MPR_H_OFS                      (0x0092/2)      /* in Word */
>> > +#define CMD_EXEC_OFS                   (0x00C0/2)      /* in Word */
>> > +#define STATUS_REG_OFS                 (0x00CC/2)      /* in Word */
>> > +#define PRG_BUFFER_OFS                 (0x0010/2)      /* in Word */
>> > +
>> > +/* Datamask */
>> > +#define MR_CFGMASK                     0x8000
>> > +#define SR_OK_DATAMASK                 0x0080
>> > +
>> > +/* LPDDR2-NVM Commands */
>> > +#define LPDDR2_NVM_LOCK                        0x0061
>> > +#define LPDDR2_NVM_UNLOCK              0x0062
>> > +#define LPDDR2_NVM_SW_PROGRAM          0x0041
>> > +#define LPDDR2_NVM_SW_OVERWRITE                0x0042
>> > +#define LPDDR2_NVM_BUF_PROGRAM         0x00E9
>> > +#define LPDDR2_NVM_BUF_OVERWRITE       0x00EA
>> > +#define LPDDR2_NVM_ERASE               0x0020
>> > +
>> > +/*
>> > + * Internal Type Definitions
>> > + * pcm_int_data contains memory controller details:
>> > + * @reg_data : LPDDR2_MODE_REG_DATA register address after remapping
>> > + * @reg_cfg  : LPDDR2_MODE_REG_CFG register address after remapping
>> > + * &bus_width: memory bus-width (eg: x16 2 Bytes, x32 4 Bytes)
>> > + */
>> > +struct pcm_int_data {
>> > +       void __iomem *reg_data;
>> > +       void __iomem *reg_cfg;
>> > +       int bus_width;
>> > +};
>> > +
>> > +static DEFINE_MUTEX(lpdd2_nvm_mutex);
>> > +
>> > +/*
>> > + * Build a map_word starting from an u_long
>> > + */
>> > +static inline map_word build_map_word(u_long myword)
>> > +{
>> > +       map_word val = { {0} };
>> > +       val.x[0] = myword;
>> > +       return val;
>> > +}
>> > +
>> > +/*
>> > + * Build Mode Register Configuration DataMask based on device bus-width
>> > + */
>> > +static inline u_int build_mr_cfgmask(u_int bus_width)
>> > +{
>> > +       u_int val = MR_CFGMASK;
>> > +
>> > +       if (bus_width == 0x0004)                /* x32 device */
>> > +               val = val << 16;
>> > +
>> > +       return val;
>> > +}
>> > +
>> > +/*
>> > + * Build Status Register OK DataMask based on device bus-width
>> > + */
>> > +static inline u_int build_sr_ok_datamask(u_int bus_width)
>> > +{
>> > +       u_int val = SR_OK_DATAMASK;
>> > +
>> > +       if (bus_width == 0x0004)                /* x32 device */
>> > +               val = (val << 16)+val;
>> > +
>> > +       return val;
>> > +}
>> > +
>> > +/*
>> > + * Evaluates Overlay Window Control Registers address
>> > + */
>> > +static inline u_long ow_reg_add(struct map_info *map, u_long offset)
>> > +{
>> > +       u_long val = 0;
>> > +       struct pcm_int_data *pcm_data = map->fldrv_priv;
>> > +
>> > +       val = map->pfow_base + offset*pcm_data->bus_width;
>> > +
>> > +       return val;
>> > +}
>> > +
>> > +/*
>> > + * Enable lpddr2-nvm Overlay Window
>> > + * Overlay Window is a memory mapped area containing all LPDDR2-NVM registers
>> > + * used by device commands as well as uservisible resources like Device Status
>> > + * Register, Device ID, etc
>> > + */
>> > +static inline void ow_enable(struct map_info *map)
>> > +{
>> > +       struct pcm_int_data *pcm_data = map->fldrv_priv;
>> > +
>> > +       writel_relaxed(build_mr_cfgmask(pcm_data->bus_width) | 0x18,
>> > +               pcm_data->reg_cfg);
>> > +       writel_relaxed(0x01, pcm_data->reg_data);
>> > +}
>> > +
>> > +/*
>> > + * Disable lpddr2-nvm Overlay Window
>> > + * Overlay Window is a memory mapped area containing all LPDDR2-NVM registers
>> > + * used by device commands as well as uservisible resources like Device Status
>> > + * Register, Device ID, etc
>> > + */
>> > +static inline void ow_disable(struct map_info *map)
>> > +{
>> > +       struct pcm_int_data *pcm_data = map->fldrv_priv;
>> > +
>> > +       writel_relaxed(build_mr_cfgmask(pcm_data->bus_width) | 0x18,
>> > +               pcm_data->reg_cfg);
>> > +       writel_relaxed(0x02, pcm_data->reg_data);
>> > +}
>> > +
>> > +/*
>> > + * Execute lpddr2-nvm operations
>> > + */
>> > +static int lpddr2_nvm_do_op(struct map_info *map, u_long cmd_code,
>> > +       u_long cmd_data, u_long cmd_add, u_long cmd_mpr, u_char *buf)
>> > +{
>> > +       map_word add_l = { {0} }, add_h = { {0} }, mpr_l = { {0} },
>> > +               mpr_h = { {0} }, data_l = { {0} }, cmd = { {0} },
>> > +               exec_cmd = { {0} }, sr;
>> > +       map_word data_h = { {0} };      /* only for 2x x16 devices stacked */
>> > +       u_long i, status_reg, prg_buff_ofs;
>> > +       struct pcm_int_data *pcm_data = map->fldrv_priv;
>> > +       u_int sr_ok_datamask = build_sr_ok_datamask(pcm_data->bus_width);
>> > +
>> > +       /* Builds low and high words for OW Control Registers */
>> > +       add_l.x[0]      = cmd_add & 0x0000FFFF;
>> > +       add_h.x[0]      = (cmd_add >> 16) & 0x0000FFFF;
>> > +       mpr_l.x[0]      = cmd_mpr & 0x0000FFFF;
>> > +       mpr_h.x[0]      = (cmd_mpr >> 16) & 0x0000FFFF;
>> > +       cmd.x[0]        = cmd_code & 0x0000FFFF;
>> > +       exec_cmd.x[0]   = 0x0001;
>> > +       data_l.x[0]     = cmd_data & 0x0000FFFF;
>> > +       data_h.x[0]     = (cmd_data >> 16) & 0x0000FFFF; /* only for 2x x16 */
>> > +
>> > +       /* Set Overlay Window Control Registers */
>> > +       map_write(map, cmd, ow_reg_add(map, CMD_CODE_OFS));
>> > +       map_write(map, data_l, ow_reg_add(map, CMD_DATA_OFS));
>> > +       map_write(map, add_l, ow_reg_add(map, CMD_ADD_L_OFS));
>> > +       map_write(map, add_h, ow_reg_add(map, CMD_ADD_H_OFS));
>> > +       map_write(map, mpr_l, ow_reg_add(map, MPR_L_OFS));
>> > +       map_write(map, mpr_h, ow_reg_add(map, MPR_H_OFS));
>> > +       if (pcm_data->bus_width == 0x0004) {    /* 2x16 devices stacked */
>> > +               map_write(map, cmd, ow_reg_add(map, CMD_CODE_OFS) + 2);
>> > +               map_write(map, data_h, ow_reg_add(map, CMD_DATA_OFS) + 2);
>> > +               map_write(map, add_l, ow_reg_add(map, CMD_ADD_L_OFS) + 2);
>> > +               map_write(map, add_h, ow_reg_add(map, CMD_ADD_H_OFS) + 2);
>> > +               map_write(map, mpr_l, ow_reg_add(map, MPR_L_OFS) + 2);
>> > +               map_write(map, mpr_h, ow_reg_add(map, MPR_H_OFS) + 2);
>> > +       }
>> > +
>> > +       /* Fill Program Buffer */
>> > +       if ((cmd_code == LPDDR2_NVM_BUF_PROGRAM) ||
>> > +               (cmd_code == LPDDR2_NVM_BUF_OVERWRITE)) {
>> > +               prg_buff_ofs = (map_read(map,
>> > +                       ow_reg_add(map, PRG_BUFFER_OFS))).x[0];
>> > +               for (i = 0; i < cmd_mpr; i++) {
>> > +                       map_write(map, build_map_word(buf[i]), map->pfow_base +
>> > +                       prg_buff_ofs + i);
>> > +               }
>> > +       }
>> > +
>> > +       /* Command Execute */
>> > +       map_write(map, exec_cmd, ow_reg_add(map, CMD_EXEC_OFS));
>> > +       if (pcm_data->bus_width == 0x0004)      /* 2x16 devices stacked */
>> > +               map_write(map, exec_cmd, ow_reg_add(map, CMD_EXEC_OFS) + 2);
>> > +
>> > +       /* Status Register Check */
>> > +       do {
>> > +               sr = map_read(map, ow_reg_add(map, STATUS_REG_OFS));
>> > +               status_reg = sr.x[0];
>> > +               if (pcm_data->bus_width == 0x0004) {/* 2x16 devices stacked */
>> > +                       sr = map_read(map, ow_reg_add(map,
>> > +                               STATUS_REG_OFS) + 2);
>> > +                       status_reg += sr.x[0] << 16;
>> > +               }
>> > +       } while ((status_reg & sr_ok_datamask) != sr_ok_datamask);
>> > +
>> > +       return (((status_reg & sr_ok_datamask) == sr_ok_datamask) ? 0 : -EIO);
>> > +}
>> > +
>> > +/*
>> > + * Execute lpddr2-nvm operations @ block level
>> > + */
>> > +static int lpddr2_nvm_do_block_op(struct mtd_info *mtd, loff_t start_add,
>> > +       uint64_t len, u_char block_op)
>> > +{
>> > +       struct map_info *map = mtd->priv;
>> > +       u_long add, end_add;
>> > +       int ret = 0;
>> > +
>> > +       mutex_lock(&lpdd2_nvm_mutex);
>> > +
>> > +       ow_enable(map);
>> > +
>> > +       add = start_add;
>> > +       end_add = add + len;
>> > +
>> > +       do {
>> > +               ret = lpddr2_nvm_do_op(map, block_op, 0x00, add, add, NULL);
>> > +               if (ret)
>> > +                       goto out;
>> > +               add += mtd->erasesize;
>> > +       } while (add < end_add);
>> > +
>> > +out:
>> > +       ow_disable(map);
>> > +       mutex_unlock(&lpdd2_nvm_mutex);
>> > +       return ret;
>> > +}
>> > +
>> > +/*
>> > + * verify presence of PFOW string
>> > + */
>> > +static int lpddr2_nvm_pfow_present(struct map_info *map)
>> > +{
>> > +       map_word pfow_val[4];
>> > +       unsigned int found = 1;
>> > +
>> > +       mutex_lock(&lpdd2_nvm_mutex);
>> > +
>> > +       ow_enable(map);
>> > +
>> > +       /* Load string from array */
>> > +       pfow_val[0] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_P));
>> > +       pfow_val[1] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_F));
>> > +       pfow_val[2] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_O));
>> > +       pfow_val[3] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_W));
>> > +
>> > +       /* Verify the string loaded vs expected */
>> > +       if (!map_word_equal(map, build_map_word('P'), pfow_val[0]))
>> > +               found = 0;
>> > +       if (!map_word_equal(map, build_map_word('F'), pfow_val[1]))
>> > +               found = 0;
>> > +       if (!map_word_equal(map, build_map_word('O'), pfow_val[2]))
>> > +               found = 0;
>> > +       if (!map_word_equal(map, build_map_word('W'), pfow_val[3]))
>> > +               found = 0;
>> > +
>> > +       ow_disable(map);
>> > +
>> > +       mutex_unlock(&lpdd2_nvm_mutex);
>> > +
>> > +       return found;
>> > +}
>> > +
>> > +/*
>> > + * lpddr2_nvm driver read method
>> > + */
>> > +static int lpddr2_nvm_read(struct mtd_info *mtd, loff_t start_add,
>> > +                               size_t len, size_t *retlen, u_char *buf)
>> > +{
>> > +       struct map_info *map = mtd->priv;
>> > +
>> > +       mutex_lock(&lpdd2_nvm_mutex);
>> > +
>> > +       *retlen = len;
>> > +
>> > +       map_copy_from(map, buf, start_add, *retlen);
>> > +
>> > +       mutex_unlock(&lpdd2_nvm_mutex);
>> > +       return 0;
>> > +}
>> > +
>> > +/*
>> > + * lpddr2_nvm driver write method
>> > + */
>> > +static int lpddr2_nvm_write(struct mtd_info *mtd, loff_t start_add,
>> > +                               size_t len, size_t *retlen, const u_char *buf)
>> > +{
>> > +       struct map_info *map = mtd->priv;
>> > +       struct pcm_int_data *pcm_data = map->fldrv_priv;
>> > +       u_long add, current_len, tot_len, target_len, my_data;
>> > +       u_char *write_buf = (u_char *)buf;
>> > +       int ret = 0;
>> > +
>> > +       mutex_lock(&lpdd2_nvm_mutex);
>> > +
>> > +       ow_enable(map);
>> > +
>> > +       /* Set start value for the variables */
>> > +       add = start_add;
>> > +       target_len = len;
>> > +       tot_len = 0;
>> > +
>> > +       while (tot_len < target_len) {
>> > +               if (!(IS_ALIGNED(add, mtd->writesize))) { /* do sw program */
>> > +                       my_data = write_buf[tot_len];
>> > +                       my_data += (write_buf[tot_len+1]) << 8;
>> > +                       if (pcm_data->bus_width == 0x0004) {/* 2x16 devices */
>> > +                               my_data += (write_buf[tot_len+2]) << 16;
>> > +                               my_data += (write_buf[tot_len+3]) << 24;
>> > +                       }
>> > +                       ret = lpddr2_nvm_do_op(map, LPDDR2_NVM_SW_OVERWRITE,
>> > +                               my_data, add, 0x00, NULL);
>> > +                       if (ret)
>> > +                               goto out;
>> > +
>> > +                       add += pcm_data->bus_width;
>> > +                       tot_len += pcm_data->bus_width;
>> > +               } else {                /* do buffer program */
>> > +                       current_len = min(target_len - tot_len,
>> > +                               (u_long) mtd->writesize);
>> > +                       ret = lpddr2_nvm_do_op(map, LPDDR2_NVM_BUF_OVERWRITE,
>> > +                               0x00, add, current_len, write_buf + tot_len);
>> > +                       if (ret)
>> > +                               goto out;
>> > +
>> > +                       add += current_len;
>> > +                       tot_len += current_len;
>> > +               }
>> > +       }
>> > +
>> > +out:
>> > +       *retlen = tot_len;
>> > +       ow_disable(map);
>> > +       mutex_unlock(&lpdd2_nvm_mutex);
>> > +       return ret;
>> > +}
>> > +
>> > +/*
>> > + * lpddr2_nvm driver erase method
>> > + */
>> > +static int lpddr2_nvm_erase(struct mtd_info *mtd, struct erase_info *instr)
>> > +{
>> > +       int ret = lpddr2_nvm_do_block_op(mtd, instr->addr, instr->len,
>> > +               LPDDR2_NVM_ERASE);
>> > +       if (!ret) {
>> > +               instr->state = MTD_ERASE_DONE;
>> > +               mtd_erase_callback(instr);
>> > +       }
>> > +
>> > +       return ret;
>> > +}
>> > +
>> > +/*
>> > + * lpddr2_nvm driver unlock method
>> > + */
>> > +static int lpddr2_nvm_unlock(struct mtd_info *mtd, loff_t start_add,
>> > +       uint64_t len)
>> > +{
>> > +       return lpddr2_nvm_do_block_op(mtd, start_add, len, LPDDR2_NVM_UNLOCK);
>> > +}
>> > +
>> > +/*
>> > + * lpddr2_nvm driver lock method
>> > + */
>> > +static int lpddr2_nvm_lock(struct mtd_info *mtd, loff_t start_add,
>> > +       uint64_t len)
>> > +{
>> > +       return lpddr2_nvm_do_block_op(mtd, start_add, len, LPDDR2_NVM_LOCK);
>> > +}
>> > +
>> > +/*
>> > + * lpddr2_nvm driver probe method
>> > + */
>> > +static int lpddr2_nvm_probe(struct platform_device *pdev)
>> > +{
>> > +       struct map_info *map;
>> > +       struct mtd_info *mtd;
>> > +       struct resource *add_range = platform_get_resource(pdev,
>> > +                                               IORESOURCE_MEM, 0);
>> > +       struct resource *control_regs = platform_get_resource(pdev,
>> > +                                               IORESOURCE_MEM, 1);
>> > +       struct resource *buswidth = platform_get_resource(pdev,
>> > +                                               IORESOURCE_BUS, 0);
>> > +       struct pcm_int_data *pcm_data;
>> > +
>> > +       /* Allocate memory control_regs data structures */
>> > +       pcm_data = devm_kzalloc(&pdev->dev, sizeof(*pcm_data), GFP_KERNEL);
>> > +       if (!pcm_data)
>> > +               return -ENOMEM;
>> > +       pcm_data->reg_data =    (void *) control_regs->start;
>> > +       pcm_data->reg_cfg =     (void *) control_regs->end;
>> > +       pcm_data->bus_width =   (int) buswidth->start;
>> > +
>> > +       /* Allocate memory for map_info & mtd_info data structures */
>> > +       map = devm_kzalloc(&pdev->dev, sizeof(*map), GFP_KERNEL);
>> > +       if (!map)
>> > +               return -ENOMEM;
>> > +
>> > +       mtd = devm_kzalloc(&pdev->dev, sizeof(*mtd), GFP_KERNEL);
>> > +       if (!mtd)
>> > +               return -ENOMEM;
>> > +
>> > +       /* Reserve lpddr2_nvm address range */
>> > +       if (devm_request_mem_region(&pdev->dev, add_range->start,
>> > +               (add_range->end - add_range->start + 1),
>> > +               "lpddr2_nvm") == NULL) {
>> > +               pr_err("Unable to reserve address range\n");
>> > +               return -EBUSY;
>> > +       }
>> > +
>> > +       /* Populate map_info data structure */
>> > +       *map = (struct map_info) {
>> > +               .virt           = devm_ioremap_nocache(&pdev->dev,
>> > +                               add_range->start, (add_range->end -
>> > +                               add_range->start a + 1)),
>> > +               .name           = pdev->dev.init_name,
>> > +               .phys           = add_range->start,
>> > +               .size           = add_range->end - add_range->start + 1,
>> > +               .bankwidth      = pcm_data->bus_width/2,
>> > +               .pfow_base      = OW_BASE_ADDRESS,
>> > +               .fldrv_priv     = pcm_data,
>> > +       };
>> > +
>> > +       simple_map_init(map);   /* fill with default methods */
>> > +
>> > +       /* Populate mtd_info data structure */
>> > +       *mtd = (struct mtd_info) {
>> > +               .name           = pdev->dev.init_name,
>> > +               .type           = MTD_RAM,
>> > +               .priv           = map,
>> > +               .size           = add_range->end - add_range->start + 1,
>> > +               .erasesize      = ERASE_BLOCKSIZE * pcm_data->bus_width,
>> > +               .writesize      = 1,
>> > +               .writebufsize   = WRITE_BUFFSIZE * pcm_data->bus_width,
>> > +               .flags          = (MTD_CAP_NVRAM | MTD_POWERUP_LOCK),
>> > +               ._read          = lpddr2_nvm_read,
>> > +               ._write         = lpddr2_nvm_write,
>> > +               ._erase         = lpddr2_nvm_erase,
>> > +               ._unlock        = lpddr2_nvm_unlock,
>> > +               ._lock          = lpddr2_nvm_lock,
>> > +       };
>> > +
>> > +       /* Verify the presence of the device looking for PFOW string */
>> > +       if (!lpddr2_nvm_pfow_present(map)) {
>> > +               pr_err("device not recognized\n");
>> > +               return -EINVAL;
>> > +       }
>> > +       /* Register the mtd_partition structure */
>> > +       return mtd_add_partition(mtd, "my_pcm", 0x10000000, 0x00);
>> > +}
>> > +
>> > +/* Initialize platform_driver data structure for lpddr2_nvm */
>> > +static struct platform_driver lpddr2_nvm_drv = {
>> > +       .driver         = {
>> > +               .name   = "lpddr2_nvm",
>> > +       },
>> > +       .probe          = lpddr2_nvm_probe,
>> > +};
>> > +
>> > +module_platform_driver(lpddr2_nvm_drv);
>> > +MODULE_LICENSE("GPL");
>> > +MODULE_AUTHOR("Vincenzo Aliberti <vincenzo.aliberti@gmail.com>");
>> > +MODULE_DESCRIPTION("MTD driver for LPDDR2-NVM PCM memories");
>> > diff --git a/include/uapi/mtd/mtd-abi.h b/include/uapi/mtd/mtd-abi.h
>> > index 36eace0..8a2bbf2 100644
>> > --- a/include/uapi/mtd/mtd-abi.h
>> > +++ b/include/uapi/mtd/mtd-abi.h
>> > @@ -107,6 +107,7 @@ struct mtd_write_req {
>> >  /* Some common devices / combinations of capabilities */
>> >  #define MTD_CAP_ROM            0
>> >  #define MTD_CAP_RAM            (MTD_WRITEABLE | MTD_BIT_WRITEABLE | MTD_NO_ERASE)
>> > +#define MTD_CAP_NVRAM          (MTD_WRITEABLE | MTD_BIT_WRITEABLE | MTD_NO_ERASE)
>> >  #define MTD_CAP_NORFLASH       (MTD_WRITEABLE | MTD_BIT_WRITEABLE)
>> >  #define MTD_CAP_NANDFLASH      (MTD_WRITEABLE)
>> >
>
> Brian
Vincenzo Aliberti Feb. 27, 2014, 3:59 p.m. UTC | #4
Sorry I forgot feedback on one point

On Thu, Feb 27, 2014 at 4:04 PM, Vincenzo Aliberti
<vincenzo.aliberti@gmail.com> wrote:
> Brian,
>    thanks for your feedback, sorry for previous post: in your feedback
> you asked me to change
> subsystem prefix and this is the reason why I have sent a new one with
> different subject.
>
> Here below my feedback: please let me know if I can resend the patch accordingly
>
> Thanks again for your help and sorry fot the mistake,
>    Vincenzo
>
> On Thu, Feb 27, 2014 at 9:37 AM, Brian Norris
> <computersforpeace@gmail.com> wrote:
>> Hi Vincenzo,
>>
>> On Mon, Feb 10, 2014 at 11:28:54AM +0100, Vincenzo Aliberti wrote:
>>> Any feedback on this?
>>
>> Sure! I see that you never replied to my feed back back in August:
>>
>> http://lists.infradead.org/pipermail/linux-mtd/2013-August/048094.html
>>
>> But it looks like you did address many of the problems I had originally.
>> Can you please double check and review my comments though, since I
>> didn't hear anything from you after I spent the time to review it?
>>
>>> On Sun, Jan 19, 2014 at 10:34 PM,  <vincenzo.aliberti@gmail.com> wrote:
>>> > From: Vincenzo Aliberti <vincenzo.aliberti@gmail.com>
>>> >
>>> > Signed-off-by: Vincenzo Aliberti <vincenzo.aliberti@gmail.com>
>>> >
>>> > ---
>>> >  drivers/mtd/lpddr/Kconfig      |   12 +-
>>> >  drivers/mtd/lpddr/lpddr2_nvm.c |  504 ++++++++++++++++++++++++++++++++++++++++
>>> >  include/uapi/mtd/mtd-abi.h     |    1 +
>>
>> One thing right off the bat: you didn't add your driver to
>> drivers/mtd/lpddr/Makefile!
>>

Vincenzo: thanks forgot in the version I used to generate the patch

>>> >  3 files changed, 515 insertions(+), 2 deletions(-)
>>> >  create mode 100644 drivers/mtd/lpddr/lpddr2_nvm.c
>>> >
>>> > diff --git a/drivers/mtd/lpddr/Kconfig b/drivers/mtd/lpddr/Kconfig
>>> > index 265f969..94a7f30 100644
>>> > --- a/drivers/mtd/lpddr/Kconfig
>>> > +++ b/drivers/mtd/lpddr/Kconfig
>>> > @@ -1,5 +1,5 @@
>>> > -menu "LPDDR flash memory drivers"
>>> > -       depends on MTD!=n
>>> > +menu "LPDDR & LPDDR2 PCM memory drivers"
>>> > +       depends on MTD
>>> >
>>> >  config MTD_LPDDR
>>> >         tristate "Support for LPDDR flash chips"
>>> > @@ -17,4 +17,12 @@ config MTD_QINFO_PROBE
>>> >             Window QINFO interface, permits software to be used for entire
>>> >             families of devices. This serves similar purpose of CFI on legacy
>>> >             Flash products
>>> > +
>>> > +config MTD_LPDDR2_NVM
>>> > +       depends on MTD && ARM
>>> > +       tristate "Support for LPDDR2-NVM flash chips"
>>> > +       help
>>> > +         This option enables support of PCM memories with a LPDDR2-NVM
>>> > +         (Low power double data rate 2) interface.
>>> > +
>>> >  endmenu
>>> > diff --git a/drivers/mtd/lpddr/lpddr2_nvm.c b/drivers/mtd/lpddr/lpddr2_nvm.c
>>> > new file mode 100644
>>> > index 0000000..23377c8
>>> > --- /dev/null
>>> > +++ b/drivers/mtd/lpddr/lpddr2_nvm.c
>>> > @@ -0,0 +1,504 @@
>>> > +/*
>>> > + * LPDDR2-NVM MTD driver. This module provides read, write, erase, lock/unlock
>>> > + * support for LPDDR2-NVM PCM memories
>>> > + *
>>> > + * Copyright Š 2012 Micron Technology, Inc.
>>
>> You still didn't update the copyright...
>>
> Vincenzo: you are right: some partners started using it in 2012 so I
> have kept this for the copyright
>>> > + *
>>> > + * Vincenzo Aliberti <vincenzo.aliberti@gmail.com>
>>> > + * Domenico Manna <domenico.manna@gmail.com>
>>> > + * Many thanks to Andrea Vigilante for initial enabling
>>> > + *
>>> > + * This program is free software; you can redistribute it and/or
>>> > + * modify it under the terms of the GNU General Public License
>>> > + * as published by the Free Software Foundation; either version 2
>>> > + * of the License, or (at your option) any later version.
>>> > + *
>>> > + * This program is distributed in the hope that it will be useful,
>>> > + * but WITHOUT ANY WARRANTY; without even the implied warranty of
>>> > + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
>>> > + * GNU General Public License for more details.
>>> > + *
>>> > + * You should have received a copy of the GNU General Public License
>>> > + * along with this program; if not, write to the Free Software
>>> > + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
>>> > + * 02110-1301, USA.
>>> > + */
>>> > +
>>> > +#define pr_fmt(fmt) KBUILD_MODNAME ":%s: " fmt, __func__
>>
>> Missing a space between the ':' and '%s':
>>
> Vincenzo: sorry you are right
>> #define pr_fmt(fmt) KBUILD_MODNAME ": %s: " fmt, __func__
>>
>>> > +
>>> > +#include <linux/init.h>
>>> > +#include <linux/io.h>
>>> > +#include <linux/module.h>
>>> > +#include <linux/kernel.h>
>>> > +#include <linux/mtd/map.h>
>>> > +#include <linux/mtd/mtd.h>
>>> > +#include <linux/mtd/partitions.h>
>>> > +#include <linux/slab.h>
>>> > +#include <linux/platform_device.h>
>>> > +#include <linux/ioport.h>
>>> > +#include <linux/sched.h>
>>> > +
>>> > +/* Parameters */
>>> > +#define ERASE_BLOCKSIZE                        (0x00020000/2)  /* in Word */
>>> > +#define WRITE_BUFFSIZE                 (0x00000400/2)  /* in Word */
>>> > +#define OW_BASE_ADDRESS                        0x00000000      /* OW offset */
>>> > +
>>> > +/* PFOW symbols address offset */
>>> > +#define PFOW_QUERY_STRING_P            (0x0000/2)      /* in Word */
>>> > +#define PFOW_QUERY_STRING_F            (0x0002/2)      /* in Word */
>>> > +#define PFOW_QUERY_STRING_O            (0x0004/2)      /* in Word */
>>> > +#define PFOW_QUERY_STRING_W            (0x0006/2)      /* in Word */
>>> > +
>>> > +/* OW registers address */
>>> > +#define CMD_CODE_OFS                   (0x0080/2)      /* in Word */
>>> > +#define CMD_DATA_OFS                   (0x0084/2)      /* in Word */
>>> > +#define CMD_ADD_L_OFS                  (0x0088/2)      /* in Word */
>>> > +#define CMD_ADD_H_OFS                  (0x008A/2)      /* in Word */
>>> > +#define MPR_L_OFS                      (0x0090/2)      /* in Word */
>>> > +#define MPR_H_OFS                      (0x0092/2)      /* in Word */
>>> > +#define CMD_EXEC_OFS                   (0x00C0/2)      /* in Word */
>>> > +#define STATUS_REG_OFS                 (0x00CC/2)      /* in Word */
>>> > +#define PRG_BUFFER_OFS                 (0x0010/2)      /* in Word */
>>> > +
>>> > +/* Datamask */
>>> > +#define MR_CFGMASK                     0x8000
>>> > +#define SR_OK_DATAMASK                 0x0080
>>> > +
>>> > +/* LPDDR2-NVM Commands */
>>> > +#define LPDDR2_NVM_LOCK                        0x0061
>>> > +#define LPDDR2_NVM_UNLOCK              0x0062
>>> > +#define LPDDR2_NVM_SW_PROGRAM          0x0041
>>> > +#define LPDDR2_NVM_SW_OVERWRITE                0x0042
>>> > +#define LPDDR2_NVM_BUF_PROGRAM         0x00E9
>>> > +#define LPDDR2_NVM_BUF_OVERWRITE       0x00EA
>>> > +#define LPDDR2_NVM_ERASE               0x0020
>>> > +
>>> > +/*
>>> > + * Internal Type Definitions
>>> > + * pcm_int_data contains memory controller details:
>>> > + * @reg_data : LPDDR2_MODE_REG_DATA register address after remapping
>>> > + * @reg_cfg  : LPDDR2_MODE_REG_CFG register address after remapping
>>> > + * &bus_width: memory bus-width (eg: x16 2 Bytes, x32 4 Bytes)
>>> > + */
>>> > +struct pcm_int_data {
>>> > +       void __iomem *reg_data;
>>> > +       void __iomem *reg_cfg;
>>> > +       int bus_width;
>>> > +};
>>> > +
>>> > +static DEFINE_MUTEX(lpdd2_nvm_mutex);
>>> > +
>>> > +/*
>>> > + * Build a map_word starting from an u_long
>>> > + */
>>> > +static inline map_word build_map_word(u_long myword)
>>> > +{
>>> > +       map_word val = { {0} };
>>> > +       val.x[0] = myword;
>>> > +       return val;
>>> > +}
>>> > +
>>> > +/*
>>> > + * Build Mode Register Configuration DataMask based on device bus-width
>>> > + */
>>> > +static inline u_int build_mr_cfgmask(u_int bus_width)
>>> > +{
>>> > +       u_int val = MR_CFGMASK;
>>> > +
>>> > +       if (bus_width == 0x0004)                /* x32 device */
>>> > +               val = val << 16;
>>> > +
>>> > +       return val;
>>> > +}
>>> > +
>>> > +/*
>>> > + * Build Status Register OK DataMask based on device bus-width
>>> > + */
>>> > +static inline u_int build_sr_ok_datamask(u_int bus_width)
>>> > +{
>>> > +       u_int val = SR_OK_DATAMASK;
>>> > +
>>> > +       if (bus_width == 0x0004)                /* x32 device */
>>> > +               val = (val << 16)+val;
>>> > +
>>> > +       return val;
>>> > +}
>>> > +
>>> > +/*
>>> > + * Evaluates Overlay Window Control Registers address
>>> > + */
>>> > +static inline u_long ow_reg_add(struct map_info *map, u_long offset)
>>> > +{
>>> > +       u_long val = 0;
>>> > +       struct pcm_int_data *pcm_data = map->fldrv_priv;
>>> > +
>>> > +       val = map->pfow_base + offset*pcm_data->bus_width;
>>> > +
>>> > +       return val;
>>> > +}
>>> > +
>>> > +/*
>>> > + * Enable lpddr2-nvm Overlay Window
>>> > + * Overlay Window is a memory mapped area containing all LPDDR2-NVM registers
>>> > + * used by device commands as well as uservisible resources like Device Status
>>> > + * Register, Device ID, etc
>>> > + */
>>> > +static inline void ow_enable(struct map_info *map)
>>> > +{
>>> > +       struct pcm_int_data *pcm_data = map->fldrv_priv;
>>> > +
>>> > +       writel_relaxed(build_mr_cfgmask(pcm_data->bus_width) | 0x18,
>>> > +               pcm_data->reg_cfg);
>>> > +       writel_relaxed(0x01, pcm_data->reg_data);
>>> > +}
>>> > +
>>> > +/*
>>> > + * Disable lpddr2-nvm Overlay Window
>>> > + * Overlay Window is a memory mapped area containing all LPDDR2-NVM registers
>>> > + * used by device commands as well as uservisible resources like Device Status
>>> > + * Register, Device ID, etc
>>> > + */
>>> > +static inline void ow_disable(struct map_info *map)
>>> > +{
>>> > +       struct pcm_int_data *pcm_data = map->fldrv_priv;
>>> > +
>>> > +       writel_relaxed(build_mr_cfgmask(pcm_data->bus_width) | 0x18,
>>> > +               pcm_data->reg_cfg);
>>> > +       writel_relaxed(0x02, pcm_data->reg_data);
>>> > +}
>>> > +
>>> > +/*
>>> > + * Execute lpddr2-nvm operations
>>> > + */
>>> > +static int lpddr2_nvm_do_op(struct map_info *map, u_long cmd_code,
>>> > +       u_long cmd_data, u_long cmd_add, u_long cmd_mpr, u_char *buf)
>>> > +{
>>> > +       map_word add_l = { {0} }, add_h = { {0} }, mpr_l = { {0} },
>>> > +               mpr_h = { {0} }, data_l = { {0} }, cmd = { {0} },
>>> > +               exec_cmd = { {0} }, sr;
>>> > +       map_word data_h = { {0} };      /* only for 2x x16 devices stacked */
>>> > +       u_long i, status_reg, prg_buff_ofs;
>>> > +       struct pcm_int_data *pcm_data = map->fldrv_priv;
>>> > +       u_int sr_ok_datamask = build_sr_ok_datamask(pcm_data->bus_width);
>>> > +
>>> > +       /* Builds low and high words for OW Control Registers */
>>> > +       add_l.x[0]      = cmd_add & 0x0000FFFF;
>>> > +       add_h.x[0]      = (cmd_add >> 16) & 0x0000FFFF;
>>> > +       mpr_l.x[0]      = cmd_mpr & 0x0000FFFF;
>>> > +       mpr_h.x[0]      = (cmd_mpr >> 16) & 0x0000FFFF;
>>> > +       cmd.x[0]        = cmd_code & 0x0000FFFF;
>>> > +       exec_cmd.x[0]   = 0x0001;
>>> > +       data_l.x[0]     = cmd_data & 0x0000FFFF;
>>> > +       data_h.x[0]     = (cmd_data >> 16) & 0x0000FFFF; /* only for 2x x16 */
>>> > +
>>> > +       /* Set Overlay Window Control Registers */
>>> > +       map_write(map, cmd, ow_reg_add(map, CMD_CODE_OFS));
>>> > +       map_write(map, data_l, ow_reg_add(map, CMD_DATA_OFS));
>>> > +       map_write(map, add_l, ow_reg_add(map, CMD_ADD_L_OFS));
>>> > +       map_write(map, add_h, ow_reg_add(map, CMD_ADD_H_OFS));
>>> > +       map_write(map, mpr_l, ow_reg_add(map, MPR_L_OFS));
>>> > +       map_write(map, mpr_h, ow_reg_add(map, MPR_H_OFS));
>>> > +       if (pcm_data->bus_width == 0x0004) {    /* 2x16 devices stacked */
>>> > +               map_write(map, cmd, ow_reg_add(map, CMD_CODE_OFS) + 2);
>>> > +               map_write(map, data_h, ow_reg_add(map, CMD_DATA_OFS) + 2);
>>> > +               map_write(map, add_l, ow_reg_add(map, CMD_ADD_L_OFS) + 2);
>>> > +               map_write(map, add_h, ow_reg_add(map, CMD_ADD_H_OFS) + 2);
>>> > +               map_write(map, mpr_l, ow_reg_add(map, MPR_L_OFS) + 2);
>>> > +               map_write(map, mpr_h, ow_reg_add(map, MPR_H_OFS) + 2);
>>> > +       }
>>> > +
>>> > +       /* Fill Program Buffer */
>>> > +       if ((cmd_code == LPDDR2_NVM_BUF_PROGRAM) ||
>>> > +               (cmd_code == LPDDR2_NVM_BUF_OVERWRITE)) {
>>> > +               prg_buff_ofs = (map_read(map,
>>> > +                       ow_reg_add(map, PRG_BUFFER_OFS))).x[0];
>>> > +               for (i = 0; i < cmd_mpr; i++) {
>>> > +                       map_write(map, build_map_word(buf[i]), map->pfow_base +
>>> > +                       prg_buff_ofs + i);
>>> > +               }
>>> > +       }
>>> > +
>>> > +       /* Command Execute */
>>> > +       map_write(map, exec_cmd, ow_reg_add(map, CMD_EXEC_OFS));
>>> > +       if (pcm_data->bus_width == 0x0004)      /* 2x16 devices stacked */
>>> > +               map_write(map, exec_cmd, ow_reg_add(map, CMD_EXEC_OFS) + 2);
>>> > +
>>> > +       /* Status Register Check */
>>> > +       do {
>>> > +               sr = map_read(map, ow_reg_add(map, STATUS_REG_OFS));
>>> > +               status_reg = sr.x[0];
>>> > +               if (pcm_data->bus_width == 0x0004) {/* 2x16 devices stacked */
>>> > +                       sr = map_read(map, ow_reg_add(map,
>>> > +                               STATUS_REG_OFS) + 2);
>>> > +                       status_reg += sr.x[0] << 16;
>>> > +               }
>>> > +       } while ((status_reg & sr_ok_datamask) != sr_ok_datamask);
>>> > +
>>> > +       return (((status_reg & sr_ok_datamask) == sr_ok_datamask) ? 0 : -EIO);
>>> > +}
>>> > +
>>> > +/*
>>> > + * Execute lpddr2-nvm operations @ block level
>>> > + */
>>> > +static int lpddr2_nvm_do_block_op(struct mtd_info *mtd, loff_t start_add,
>>> > +       uint64_t len, u_char block_op)
>>> > +{
>>> > +       struct map_info *map = mtd->priv;
>>> > +       u_long add, end_add;
>>> > +       int ret = 0;
>>> > +
>>> > +       mutex_lock(&lpdd2_nvm_mutex);
>>> > +
>>> > +       ow_enable(map);
>>> > +
>>> > +       add = start_add;
>>> > +       end_add = add + len;
>>> > +
>>> > +       do {
>>> > +               ret = lpddr2_nvm_do_op(map, block_op, 0x00, add, add, NULL);
>>> > +               if (ret)
>>> > +                       goto out;
>>> > +               add += mtd->erasesize;
>>> > +       } while (add < end_add);
>>> > +
>>> > +out:
>>> > +       ow_disable(map);
>>> > +       mutex_unlock(&lpdd2_nvm_mutex);
>>> > +       return ret;
>>> > +}
>>> > +
>>> > +/*
>>> > + * verify presence of PFOW string
>>> > + */
>>> > +static int lpddr2_nvm_pfow_present(struct map_info *map)
>>> > +{
>>> > +       map_word pfow_val[4];
>>> > +       unsigned int found = 1;
>>> > +
>>> > +       mutex_lock(&lpdd2_nvm_mutex);
>>> > +
>>> > +       ow_enable(map);
>>> > +
>>> > +       /* Load string from array */
>>> > +       pfow_val[0] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_P));
>>> > +       pfow_val[1] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_F));
>>> > +       pfow_val[2] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_O));
>>> > +       pfow_val[3] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_W));
>>> > +
>>> > +       /* Verify the string loaded vs expected */
>>> > +       if (!map_word_equal(map, build_map_word('P'), pfow_val[0]))
>>> > +               found = 0;
>>> > +       if (!map_word_equal(map, build_map_word('F'), pfow_val[1]))
>>> > +               found = 0;
>>> > +       if (!map_word_equal(map, build_map_word('O'), pfow_val[2]))
>>> > +               found = 0;
>>> > +       if (!map_word_equal(map, build_map_word('W'), pfow_val[3]))
>>> > +               found = 0;
>>> > +
>>> > +       ow_disable(map);
>>> > +
>>> > +       mutex_unlock(&lpdd2_nvm_mutex);
>>> > +
>>> > +       return found;
>>> > +}
>>> > +
>>> > +/*
>>> > + * lpddr2_nvm driver read method
>>> > + */
>>> > +static int lpddr2_nvm_read(struct mtd_info *mtd, loff_t start_add,
>>> > +                               size_t len, size_t *retlen, u_char *buf)
>>> > +{
>>> > +       struct map_info *map = mtd->priv;
>>> > +
>>> > +       mutex_lock(&lpdd2_nvm_mutex);
>>> > +
>>> > +       *retlen = len;
>>> > +
>>> > +       map_copy_from(map, buf, start_add, *retlen);
>>> > +
>>> > +       mutex_unlock(&lpdd2_nvm_mutex);
>>> > +       return 0;
>>> > +}
>>> > +
>>> > +/*
>>> > + * lpddr2_nvm driver write method
>>> > + */
>>> > +static int lpddr2_nvm_write(struct mtd_info *mtd, loff_t start_add,
>>> > +                               size_t len, size_t *retlen, const u_char *buf)
>>> > +{
>>> > +       struct map_info *map = mtd->priv;
>>> > +       struct pcm_int_data *pcm_data = map->fldrv_priv;
>>> > +       u_long add, current_len, tot_len, target_len, my_data;
>>> > +       u_char *write_buf = (u_char *)buf;
>>> > +       int ret = 0;
>>> > +
>>> > +       mutex_lock(&lpdd2_nvm_mutex);
>>> > +
>>> > +       ow_enable(map);
>>> > +
>>> > +       /* Set start value for the variables */
>>> > +       add = start_add;
>>> > +       target_len = len;
>>> > +       tot_len = 0;
>>> > +
>>> > +       while (tot_len < target_len) {
>>> > +               if (!(IS_ALIGNED(add, mtd->writesize))) { /* do sw program */
>>> > +                       my_data = write_buf[tot_len];
>>> > +                       my_data += (write_buf[tot_len+1]) << 8;
>>> > +                       if (pcm_data->bus_width == 0x0004) {/* 2x16 devices */
>>> > +                               my_data += (write_buf[tot_len+2]) << 16;
>>> > +                               my_data += (write_buf[tot_len+3]) << 24;
>>> > +                       }
>>> > +                       ret = lpddr2_nvm_do_op(map, LPDDR2_NVM_SW_OVERWRITE,
>>> > +                               my_data, add, 0x00, NULL);
>>> > +                       if (ret)
>>> > +                               goto out;
>>> > +
>>> > +                       add += pcm_data->bus_width;
>>> > +                       tot_len += pcm_data->bus_width;
>>> > +               } else {                /* do buffer program */
>>> > +                       current_len = min(target_len - tot_len,
>>> > +                               (u_long) mtd->writesize);
>>> > +                       ret = lpddr2_nvm_do_op(map, LPDDR2_NVM_BUF_OVERWRITE,
>>> > +                               0x00, add, current_len, write_buf + tot_len);
>>> > +                       if (ret)
>>> > +                               goto out;
>>> > +
>>> > +                       add += current_len;
>>> > +                       tot_len += current_len;
>>> > +               }
>>> > +       }
>>> > +
>>> > +out:
>>> > +       *retlen = tot_len;
>>> > +       ow_disable(map);
>>> > +       mutex_unlock(&lpdd2_nvm_mutex);
>>> > +       return ret;
>>> > +}
>>> > +
>>> > +/*
>>> > + * lpddr2_nvm driver erase method
>>> > + */
>>> > +static int lpddr2_nvm_erase(struct mtd_info *mtd, struct erase_info *instr)
>>> > +{
>>> > +       int ret = lpddr2_nvm_do_block_op(mtd, instr->addr, instr->len,
>>> > +               LPDDR2_NVM_ERASE);
>>> > +       if (!ret) {
>>> > +               instr->state = MTD_ERASE_DONE;
>>> > +               mtd_erase_callback(instr);
>>> > +       }
>>> > +
>>> > +       return ret;
>>> > +}
>>> > +
>>> > +/*
>>> > + * lpddr2_nvm driver unlock method
>>> > + */
>>> > +static int lpddr2_nvm_unlock(struct mtd_info *mtd, loff_t start_add,
>>> > +       uint64_t len)
>>> > +{
>>> > +       return lpddr2_nvm_do_block_op(mtd, start_add, len, LPDDR2_NVM_UNLOCK);
>>> > +}
>>> > +
>>> > +/*
>>> > + * lpddr2_nvm driver lock method
>>> > + */
>>> > +static int lpddr2_nvm_lock(struct mtd_info *mtd, loff_t start_add,
>>> > +       uint64_t len)
>>> > +{
>>> > +       return lpddr2_nvm_do_block_op(mtd, start_add, len, LPDDR2_NVM_LOCK);
>>> > +}
>>> > +
>>> > +/*
>>> > + * lpddr2_nvm driver probe method
>>> > + */
>>> > +static int lpddr2_nvm_probe(struct platform_device *pdev)
>>> > +{
>>> > +       struct map_info *map;
>>> > +       struct mtd_info *mtd;
>>> > +       struct resource *add_range = platform_get_resource(pdev,
>>> > +                                               IORESOURCE_MEM, 0);
>>> > +       struct resource *control_regs = platform_get_resource(pdev,
>>> > +                                               IORESOURCE_MEM, 1);
>>> > +       struct resource *buswidth = platform_get_resource(pdev,
>>> > +                                               IORESOURCE_BUS, 0);
>>> > +       struct pcm_int_data *pcm_data;
>>> > +
>>> > +       /* Allocate memory control_regs data structures */
>>> > +       pcm_data = devm_kzalloc(&pdev->dev, sizeof(*pcm_data), GFP_KERNEL);
>>> > +       if (!pcm_data)
>>> > +               return -ENOMEM;
>>> > +       pcm_data->reg_data =    (void *) control_regs->start;
>>> > +       pcm_data->reg_cfg =     (void *) control_regs->end;
>>> > +       pcm_data->bus_width =   (int) buswidth->start;
>>> > +
>>> > +       /* Allocate memory for map_info & mtd_info data structures */
>>> > +       map = devm_kzalloc(&pdev->dev, sizeof(*map), GFP_KERNEL);
>>> > +       if (!map)
>>> > +               return -ENOMEM;
>>> > +
>>> > +       mtd = devm_kzalloc(&pdev->dev, sizeof(*mtd), GFP_KERNEL);
>>> > +       if (!mtd)
>>> > +               return -ENOMEM;
>>> > +
>>> > +       /* Reserve lpddr2_nvm address range */
>>> > +       if (devm_request_mem_region(&pdev->dev, add_range->start,
>>> > +               (add_range->end - add_range->start + 1),
>>> > +               "lpddr2_nvm") == NULL) {
>>> > +               pr_err("Unable to reserve address range\n");
>>> > +               return -EBUSY;
>>> > +       }
>>> > +
>>> > +       /* Populate map_info data structure */
>>> > +       *map = (struct map_info) {
>>> > +               .virt           = devm_ioremap_nocache(&pdev->dev,
>>> > +                               add_range->start, (add_range->end -
>>> > +                               add_range->start a + 1)),
>>> > +               .name           = pdev->dev.init_name,
>>> > +               .phys           = add_range->start,
>>> > +               .size           = add_range->end - add_range->start + 1,
>>> > +               .bankwidth      = pcm_data->bus_width/2,
>>> > +               .pfow_base      = OW_BASE_ADDRESS,
>>> > +               .fldrv_priv     = pcm_data,
>>> > +       };
>>> > +
>>> > +       simple_map_init(map);   /* fill with default methods */
>>> > +
>>> > +       /* Populate mtd_info data structure */
>>> > +       *mtd = (struct mtd_info) {
>>> > +               .name           = pdev->dev.init_name,
>>> > +               .type           = MTD_RAM,
>>> > +               .priv           = map,
>>> > +               .size           = add_range->end - add_range->start + 1,
>>> > +               .erasesize      = ERASE_BLOCKSIZE * pcm_data->bus_width,
>>> > +               .writesize      = 1,
>>> > +               .writebufsize   = WRITE_BUFFSIZE * pcm_data->bus_width,
>>> > +               .flags          = (MTD_CAP_NVRAM | MTD_POWERUP_LOCK),
>>> > +               ._read          = lpddr2_nvm_read,
>>> > +               ._write         = lpddr2_nvm_write,
>>> > +               ._erase         = lpddr2_nvm_erase,
>>> > +               ._unlock        = lpddr2_nvm_unlock,
>>> > +               ._lock          = lpddr2_nvm_lock,
>>> > +       };
>>> > +
>>> > +       /* Verify the presence of the device looking for PFOW string */
>>> > +       if (!lpddr2_nvm_pfow_present(map)) {
>>> > +               pr_err("device not recognized\n");
>>> > +               return -EINVAL;
>>> > +       }
>>> > +       /* Register the mtd_partition structure */
>>> > +       return mtd_add_partition(mtd, "my_pcm", 0x10000000, 0x00);
>>> > +}
>>> > +
>>> > +/* Initialize platform_driver data structure for lpddr2_nvm */
>>> > +static struct platform_driver lpddr2_nvm_drv = {
>>> > +       .driver         = {
>>> > +               .name   = "lpddr2_nvm",
>>> > +       },
>>> > +       .probe          = lpddr2_nvm_probe,
>>> > +};
>>> > +
>>> > +module_platform_driver(lpddr2_nvm_drv);
>>> > +MODULE_LICENSE("GPL");
>>> > +MODULE_AUTHOR("Vincenzo Aliberti <vincenzo.aliberti@gmail.com>");
>>> > +MODULE_DESCRIPTION("MTD driver for LPDDR2-NVM PCM memories");
>>> > diff --git a/include/uapi/mtd/mtd-abi.h b/include/uapi/mtd/mtd-abi.h
>>> > index 36eace0..8a2bbf2 100644
>>> > --- a/include/uapi/mtd/mtd-abi.h
>>> > +++ b/include/uapi/mtd/mtd-abi.h
>>> > @@ -107,6 +107,7 @@ struct mtd_write_req {
>>> >  /* Some common devices / combinations of capabilities */
>>> >  #define MTD_CAP_ROM            0
>>> >  #define MTD_CAP_RAM            (MTD_WRITEABLE | MTD_BIT_WRITEABLE | MTD_NO_ERASE)
>>> > +#define MTD_CAP_NVRAM          (MTD_WRITEABLE | MTD_BIT_WRITEABLE | MTD_NO_ERASE)
>>> >  #define MTD_CAP_NORFLASH       (MTD_WRITEABLE | MTD_BIT_WRITEABLE)
>>> >  #define MTD_CAP_NANDFLASH      (MTD_WRITEABLE)
>>> >
>>
>> Brian
Vincenzo Aliberti April 11, 2014, 2:43 p.m. UTC | #5
If you have no further comment is it possible to push upstream?

Vincenzo

On Sun, Jan 19, 2014 at 10:34 PM,  <vincenzo.aliberti@gmail.com> wrote:
> From: Vincenzo Aliberti <vincenzo.aliberti@gmail.com>
>
> Signed-off-by: Vincenzo Aliberti <vincenzo.aliberti@gmail.com>
>
> ---
>  drivers/mtd/lpddr/Kconfig      |   12 +-
>  drivers/mtd/lpddr/lpddr2_nvm.c |  504 ++++++++++++++++++++++++++++++++++++++++
>  include/uapi/mtd/mtd-abi.h     |    1 +
>  3 files changed, 515 insertions(+), 2 deletions(-)
>  create mode 100644 drivers/mtd/lpddr/lpddr2_nvm.c
>
> diff --git a/drivers/mtd/lpddr/Kconfig b/drivers/mtd/lpddr/Kconfig
> index 265f969..94a7f30 100644
> --- a/drivers/mtd/lpddr/Kconfig
> +++ b/drivers/mtd/lpddr/Kconfig
> @@ -1,5 +1,5 @@
> -menu "LPDDR flash memory drivers"
> -       depends on MTD!=n
> +menu "LPDDR & LPDDR2 PCM memory drivers"
> +       depends on MTD
>
>  config MTD_LPDDR
>         tristate "Support for LPDDR flash chips"
> @@ -17,4 +17,12 @@ config MTD_QINFO_PROBE
>             Window QINFO interface, permits software to be used for entire
>             families of devices. This serves similar purpose of CFI on legacy
>             Flash products
> +
> +config MTD_LPDDR2_NVM
> +       depends on MTD && ARM
> +       tristate "Support for LPDDR2-NVM flash chips"
> +       help
> +         This option enables support of PCM memories with a LPDDR2-NVM
> +         (Low power double data rate 2) interface.
> +
>  endmenu
> diff --git a/drivers/mtd/lpddr/lpddr2_nvm.c b/drivers/mtd/lpddr/lpddr2_nvm.c
> new file mode 100644
> index 0000000..23377c8
> --- /dev/null
> +++ b/drivers/mtd/lpddr/lpddr2_nvm.c
> @@ -0,0 +1,504 @@
> +/*
> + * LPDDR2-NVM MTD driver. This module provides read, write, erase, lock/unlock
> + * support for LPDDR2-NVM PCM memories
> + *
> + * Copyright © 2012 Micron Technology, Inc.
> + *
> + * Vincenzo Aliberti <vincenzo.aliberti@gmail.com>
> + * Domenico Manna <domenico.manna@gmail.com>
> + * Many thanks to Andrea Vigilante for initial enabling
> + *
> + * This program is free software; you can redistribute it and/or
> + * modify it under the terms of the GNU General Public License
> + * as published by the Free Software Foundation; either version 2
> + * of the License, or (at your option) any later version.
> + *
> + * This program is distributed in the hope that it will be useful,
> + * but WITHOUT ANY WARRANTY; without even the implied warranty of
> + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
> + * GNU General Public License for more details.
> + *
> + * You should have received a copy of the GNU General Public License
> + * along with this program; if not, write to the Free Software
> + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
> + * 02110-1301, USA.
> + */
> +
> +#define pr_fmt(fmt) KBUILD_MODNAME ":%s: " fmt, __func__
> +
> +#include <linux/init.h>
> +#include <linux/io.h>
> +#include <linux/module.h>
> +#include <linux/kernel.h>
> +#include <linux/mtd/map.h>
> +#include <linux/mtd/mtd.h>
> +#include <linux/mtd/partitions.h>
> +#include <linux/slab.h>
> +#include <linux/platform_device.h>
> +#include <linux/ioport.h>
> +#include <linux/sched.h>
> +
> +/* Parameters */
> +#define ERASE_BLOCKSIZE                        (0x00020000/2)  /* in Word */
> +#define WRITE_BUFFSIZE                 (0x00000400/2)  /* in Word */
> +#define OW_BASE_ADDRESS                        0x00000000      /* OW offset */
> +
> +/* PFOW symbols address offset */
> +#define PFOW_QUERY_STRING_P            (0x0000/2)      /* in Word */
> +#define PFOW_QUERY_STRING_F            (0x0002/2)      /* in Word */
> +#define PFOW_QUERY_STRING_O            (0x0004/2)      /* in Word */
> +#define PFOW_QUERY_STRING_W            (0x0006/2)      /* in Word */
> +
> +/* OW registers address */
> +#define CMD_CODE_OFS                   (0x0080/2)      /* in Word */
> +#define CMD_DATA_OFS                   (0x0084/2)      /* in Word */
> +#define CMD_ADD_L_OFS                  (0x0088/2)      /* in Word */
> +#define CMD_ADD_H_OFS                  (0x008A/2)      /* in Word */
> +#define MPR_L_OFS                      (0x0090/2)      /* in Word */
> +#define MPR_H_OFS                      (0x0092/2)      /* in Word */
> +#define CMD_EXEC_OFS                   (0x00C0/2)      /* in Word */
> +#define STATUS_REG_OFS                 (0x00CC/2)      /* in Word */
> +#define PRG_BUFFER_OFS                 (0x0010/2)      /* in Word */
> +
> +/* Datamask */
> +#define MR_CFGMASK                     0x8000
> +#define SR_OK_DATAMASK                 0x0080
> +
> +/* LPDDR2-NVM Commands */
> +#define LPDDR2_NVM_LOCK                        0x0061
> +#define LPDDR2_NVM_UNLOCK              0x0062
> +#define LPDDR2_NVM_SW_PROGRAM          0x0041
> +#define LPDDR2_NVM_SW_OVERWRITE                0x0042
> +#define LPDDR2_NVM_BUF_PROGRAM         0x00E9
> +#define LPDDR2_NVM_BUF_OVERWRITE       0x00EA
> +#define LPDDR2_NVM_ERASE               0x0020
> +
> +/*
> + * Internal Type Definitions
> + * pcm_int_data contains memory controller details:
> + * @reg_data : LPDDR2_MODE_REG_DATA register address after remapping
> + * @reg_cfg  : LPDDR2_MODE_REG_CFG register address after remapping
> + * &bus_width: memory bus-width (eg: x16 2 Bytes, x32 4 Bytes)
> + */
> +struct pcm_int_data {
> +       void __iomem *reg_data;
> +       void __iomem *reg_cfg;
> +       int bus_width;
> +};
> +
> +static DEFINE_MUTEX(lpdd2_nvm_mutex);
> +
> +/*
> + * Build a map_word starting from an u_long
> + */
> +static inline map_word build_map_word(u_long myword)
> +{
> +       map_word val = { {0} };
> +       val.x[0] = myword;
> +       return val;
> +}
> +
> +/*
> + * Build Mode Register Configuration DataMask based on device bus-width
> + */
> +static inline u_int build_mr_cfgmask(u_int bus_width)
> +{
> +       u_int val = MR_CFGMASK;
> +
> +       if (bus_width == 0x0004)                /* x32 device */
> +               val = val << 16;
> +
> +       return val;
> +}
> +
> +/*
> + * Build Status Register OK DataMask based on device bus-width
> + */
> +static inline u_int build_sr_ok_datamask(u_int bus_width)
> +{
> +       u_int val = SR_OK_DATAMASK;
> +
> +       if (bus_width == 0x0004)                /* x32 device */
> +               val = (val << 16)+val;
> +
> +       return val;
> +}
> +
> +/*
> + * Evaluates Overlay Window Control Registers address
> + */
> +static inline u_long ow_reg_add(struct map_info *map, u_long offset)
> +{
> +       u_long val = 0;
> +       struct pcm_int_data *pcm_data = map->fldrv_priv;
> +
> +       val = map->pfow_base + offset*pcm_data->bus_width;
> +
> +       return val;
> +}
> +
> +/*
> + * Enable lpddr2-nvm Overlay Window
> + * Overlay Window is a memory mapped area containing all LPDDR2-NVM registers
> + * used by device commands as well as uservisible resources like Device Status
> + * Register, Device ID, etc
> + */
> +static inline void ow_enable(struct map_info *map)
> +{
> +       struct pcm_int_data *pcm_data = map->fldrv_priv;
> +
> +       writel_relaxed(build_mr_cfgmask(pcm_data->bus_width) | 0x18,
> +               pcm_data->reg_cfg);
> +       writel_relaxed(0x01, pcm_data->reg_data);
> +}
> +
> +/*
> + * Disable lpddr2-nvm Overlay Window
> + * Overlay Window is a memory mapped area containing all LPDDR2-NVM registers
> + * used by device commands as well as uservisible resources like Device Status
> + * Register, Device ID, etc
> + */
> +static inline void ow_disable(struct map_info *map)
> +{
> +       struct pcm_int_data *pcm_data = map->fldrv_priv;
> +
> +       writel_relaxed(build_mr_cfgmask(pcm_data->bus_width) | 0x18,
> +               pcm_data->reg_cfg);
> +       writel_relaxed(0x02, pcm_data->reg_data);
> +}
> +
> +/*
> + * Execute lpddr2-nvm operations
> + */
> +static int lpddr2_nvm_do_op(struct map_info *map, u_long cmd_code,
> +       u_long cmd_data, u_long cmd_add, u_long cmd_mpr, u_char *buf)
> +{
> +       map_word add_l = { {0} }, add_h = { {0} }, mpr_l = { {0} },
> +               mpr_h = { {0} }, data_l = { {0} }, cmd = { {0} },
> +               exec_cmd = { {0} }, sr;
> +       map_word data_h = { {0} };      /* only for 2x x16 devices stacked */
> +       u_long i, status_reg, prg_buff_ofs;
> +       struct pcm_int_data *pcm_data = map->fldrv_priv;
> +       u_int sr_ok_datamask = build_sr_ok_datamask(pcm_data->bus_width);
> +
> +       /* Builds low and high words for OW Control Registers */
> +       add_l.x[0]      = cmd_add & 0x0000FFFF;
> +       add_h.x[0]      = (cmd_add >> 16) & 0x0000FFFF;
> +       mpr_l.x[0]      = cmd_mpr & 0x0000FFFF;
> +       mpr_h.x[0]      = (cmd_mpr >> 16) & 0x0000FFFF;
> +       cmd.x[0]        = cmd_code & 0x0000FFFF;
> +       exec_cmd.x[0]   = 0x0001;
> +       data_l.x[0]     = cmd_data & 0x0000FFFF;
> +       data_h.x[0]     = (cmd_data >> 16) & 0x0000FFFF; /* only for 2x x16 */
> +
> +       /* Set Overlay Window Control Registers */
> +       map_write(map, cmd, ow_reg_add(map, CMD_CODE_OFS));
> +       map_write(map, data_l, ow_reg_add(map, CMD_DATA_OFS));
> +       map_write(map, add_l, ow_reg_add(map, CMD_ADD_L_OFS));
> +       map_write(map, add_h, ow_reg_add(map, CMD_ADD_H_OFS));
> +       map_write(map, mpr_l, ow_reg_add(map, MPR_L_OFS));
> +       map_write(map, mpr_h, ow_reg_add(map, MPR_H_OFS));
> +       if (pcm_data->bus_width == 0x0004) {    /* 2x16 devices stacked */
> +               map_write(map, cmd, ow_reg_add(map, CMD_CODE_OFS) + 2);
> +               map_write(map, data_h, ow_reg_add(map, CMD_DATA_OFS) + 2);
> +               map_write(map, add_l, ow_reg_add(map, CMD_ADD_L_OFS) + 2);
> +               map_write(map, add_h, ow_reg_add(map, CMD_ADD_H_OFS) + 2);
> +               map_write(map, mpr_l, ow_reg_add(map, MPR_L_OFS) + 2);
> +               map_write(map, mpr_h, ow_reg_add(map, MPR_H_OFS) + 2);
> +       }
> +
> +       /* Fill Program Buffer */
> +       if ((cmd_code == LPDDR2_NVM_BUF_PROGRAM) ||
> +               (cmd_code == LPDDR2_NVM_BUF_OVERWRITE)) {
> +               prg_buff_ofs = (map_read(map,
> +                       ow_reg_add(map, PRG_BUFFER_OFS))).x[0];
> +               for (i = 0; i < cmd_mpr; i++) {
> +                       map_write(map, build_map_word(buf[i]), map->pfow_base +
> +                       prg_buff_ofs + i);
> +               }
> +       }
> +
> +       /* Command Execute */
> +       map_write(map, exec_cmd, ow_reg_add(map, CMD_EXEC_OFS));
> +       if (pcm_data->bus_width == 0x0004)      /* 2x16 devices stacked */
> +               map_write(map, exec_cmd, ow_reg_add(map, CMD_EXEC_OFS) + 2);
> +
> +       /* Status Register Check */
> +       do {
> +               sr = map_read(map, ow_reg_add(map, STATUS_REG_OFS));
> +               status_reg = sr.x[0];
> +               if (pcm_data->bus_width == 0x0004) {/* 2x16 devices stacked */
> +                       sr = map_read(map, ow_reg_add(map,
> +                               STATUS_REG_OFS) + 2);
> +                       status_reg += sr.x[0] << 16;
> +               }
> +       } while ((status_reg & sr_ok_datamask) != sr_ok_datamask);
> +
> +       return (((status_reg & sr_ok_datamask) == sr_ok_datamask) ? 0 : -EIO);
> +}
> +
> +/*
> + * Execute lpddr2-nvm operations @ block level
> + */
> +static int lpddr2_nvm_do_block_op(struct mtd_info *mtd, loff_t start_add,
> +       uint64_t len, u_char block_op)
> +{
> +       struct map_info *map = mtd->priv;
> +       u_long add, end_add;
> +       int ret = 0;
> +
> +       mutex_lock(&lpdd2_nvm_mutex);
> +
> +       ow_enable(map);
> +
> +       add = start_add;
> +       end_add = add + len;
> +
> +       do {
> +               ret = lpddr2_nvm_do_op(map, block_op, 0x00, add, add, NULL);
> +               if (ret)
> +                       goto out;
> +               add += mtd->erasesize;
> +       } while (add < end_add);
> +
> +out:
> +       ow_disable(map);
> +       mutex_unlock(&lpdd2_nvm_mutex);
> +       return ret;
> +}
> +
> +/*
> + * verify presence of PFOW string
> + */
> +static int lpddr2_nvm_pfow_present(struct map_info *map)
> +{
> +       map_word pfow_val[4];
> +       unsigned int found = 1;
> +
> +       mutex_lock(&lpdd2_nvm_mutex);
> +
> +       ow_enable(map);
> +
> +       /* Load string from array */
> +       pfow_val[0] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_P));
> +       pfow_val[1] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_F));
> +       pfow_val[2] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_O));
> +       pfow_val[3] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_W));
> +
> +       /* Verify the string loaded vs expected */
> +       if (!map_word_equal(map, build_map_word('P'), pfow_val[0]))
> +               found = 0;
> +       if (!map_word_equal(map, build_map_word('F'), pfow_val[1]))
> +               found = 0;
> +       if (!map_word_equal(map, build_map_word('O'), pfow_val[2]))
> +               found = 0;
> +       if (!map_word_equal(map, build_map_word('W'), pfow_val[3]))
> +               found = 0;
> +
> +       ow_disable(map);
> +
> +       mutex_unlock(&lpdd2_nvm_mutex);
> +
> +       return found;
> +}
> +
> +/*
> + * lpddr2_nvm driver read method
> + */
> +static int lpddr2_nvm_read(struct mtd_info *mtd, loff_t start_add,
> +                               size_t len, size_t *retlen, u_char *buf)
> +{
> +       struct map_info *map = mtd->priv;
> +
> +       mutex_lock(&lpdd2_nvm_mutex);
> +
> +       *retlen = len;
> +
> +       map_copy_from(map, buf, start_add, *retlen);
> +
> +       mutex_unlock(&lpdd2_nvm_mutex);
> +       return 0;
> +}
> +
> +/*
> + * lpddr2_nvm driver write method
> + */
> +static int lpddr2_nvm_write(struct mtd_info *mtd, loff_t start_add,
> +                               size_t len, size_t *retlen, const u_char *buf)
> +{
> +       struct map_info *map = mtd->priv;
> +       struct pcm_int_data *pcm_data = map->fldrv_priv;
> +       u_long add, current_len, tot_len, target_len, my_data;
> +       u_char *write_buf = (u_char *)buf;
> +       int ret = 0;
> +
> +       mutex_lock(&lpdd2_nvm_mutex);
> +
> +       ow_enable(map);
> +
> +       /* Set start value for the variables */
> +       add = start_add;
> +       target_len = len;
> +       tot_len = 0;
> +
> +       while (tot_len < target_len) {
> +               if (!(IS_ALIGNED(add, mtd->writesize))) { /* do sw program */
> +                       my_data = write_buf[tot_len];
> +                       my_data += (write_buf[tot_len+1]) << 8;
> +                       if (pcm_data->bus_width == 0x0004) {/* 2x16 devices */
> +                               my_data += (write_buf[tot_len+2]) << 16;
> +                               my_data += (write_buf[tot_len+3]) << 24;
> +                       }
> +                       ret = lpddr2_nvm_do_op(map, LPDDR2_NVM_SW_OVERWRITE,
> +                               my_data, add, 0x00, NULL);
> +                       if (ret)
> +                               goto out;
> +
> +                       add += pcm_data->bus_width;
> +                       tot_len += pcm_data->bus_width;
> +               } else {                /* do buffer program */
> +                       current_len = min(target_len - tot_len,
> +                               (u_long) mtd->writesize);
> +                       ret = lpddr2_nvm_do_op(map, LPDDR2_NVM_BUF_OVERWRITE,
> +                               0x00, add, current_len, write_buf + tot_len);
> +                       if (ret)
> +                               goto out;
> +
> +                       add += current_len;
> +                       tot_len += current_len;
> +               }
> +       }
> +
> +out:
> +       *retlen = tot_len;
> +       ow_disable(map);
> +       mutex_unlock(&lpdd2_nvm_mutex);
> +       return ret;
> +}
> +
> +/*
> + * lpddr2_nvm driver erase method
> + */
> +static int lpddr2_nvm_erase(struct mtd_info *mtd, struct erase_info *instr)
> +{
> +       int ret = lpddr2_nvm_do_block_op(mtd, instr->addr, instr->len,
> +               LPDDR2_NVM_ERASE);
> +       if (!ret) {
> +               instr->state = MTD_ERASE_DONE;
> +               mtd_erase_callback(instr);
> +       }
> +
> +       return ret;
> +}
> +
> +/*
> + * lpddr2_nvm driver unlock method
> + */
> +static int lpddr2_nvm_unlock(struct mtd_info *mtd, loff_t start_add,
> +       uint64_t len)
> +{
> +       return lpddr2_nvm_do_block_op(mtd, start_add, len, LPDDR2_NVM_UNLOCK);
> +}
> +
> +/*
> + * lpddr2_nvm driver lock method
> + */
> +static int lpddr2_nvm_lock(struct mtd_info *mtd, loff_t start_add,
> +       uint64_t len)
> +{
> +       return lpddr2_nvm_do_block_op(mtd, start_add, len, LPDDR2_NVM_LOCK);
> +}
> +
> +/*
> + * lpddr2_nvm driver probe method
> + */
> +static int lpddr2_nvm_probe(struct platform_device *pdev)
> +{
> +       struct map_info *map;
> +       struct mtd_info *mtd;
> +       struct resource *add_range = platform_get_resource(pdev,
> +                                               IORESOURCE_MEM, 0);
> +       struct resource *control_regs = platform_get_resource(pdev,
> +                                               IORESOURCE_MEM, 1);
> +       struct resource *buswidth = platform_get_resource(pdev,
> +                                               IORESOURCE_BUS, 0);
> +       struct pcm_int_data *pcm_data;
> +
> +       /* Allocate memory control_regs data structures */
> +       pcm_data = devm_kzalloc(&pdev->dev, sizeof(*pcm_data), GFP_KERNEL);
> +       if (!pcm_data)
> +               return -ENOMEM;
> +       pcm_data->reg_data =    (void *) control_regs->start;
> +       pcm_data->reg_cfg =     (void *) control_regs->end;
> +       pcm_data->bus_width =   (int) buswidth->start;
> +
> +       /* Allocate memory for map_info & mtd_info data structures */
> +       map = devm_kzalloc(&pdev->dev, sizeof(*map), GFP_KERNEL);
> +       if (!map)
> +               return -ENOMEM;
> +
> +       mtd = devm_kzalloc(&pdev->dev, sizeof(*mtd), GFP_KERNEL);
> +       if (!mtd)
> +               return -ENOMEM;
> +
> +       /* Reserve lpddr2_nvm address range */
> +       if (devm_request_mem_region(&pdev->dev, add_range->start,
> +               (add_range->end - add_range->start + 1),
> +               "lpddr2_nvm") == NULL) {
> +               pr_err("Unable to reserve address range\n");
> +               return -EBUSY;
> +       }
> +
> +       /* Populate map_info data structure */
> +       *map = (struct map_info) {
> +               .virt           = devm_ioremap_nocache(&pdev->dev,
> +                               add_range->start, (add_range->end -
> +                               add_range->start a + 1)),
> +               .name           = pdev->dev.init_name,
> +               .phys           = add_range->start,
> +               .size           = add_range->end - add_range->start + 1,
> +               .bankwidth      = pcm_data->bus_width/2,
> +               .pfow_base      = OW_BASE_ADDRESS,
> +               .fldrv_priv     = pcm_data,
> +       };
> +
> +       simple_map_init(map);   /* fill with default methods */
> +
> +       /* Populate mtd_info data structure */
> +       *mtd = (struct mtd_info) {
> +               .name           = pdev->dev.init_name,
> +               .type           = MTD_RAM,
> +               .priv           = map,
> +               .size           = add_range->end - add_range->start + 1,
> +               .erasesize      = ERASE_BLOCKSIZE * pcm_data->bus_width,
> +               .writesize      = 1,
> +               .writebufsize   = WRITE_BUFFSIZE * pcm_data->bus_width,
> +               .flags          = (MTD_CAP_NVRAM | MTD_POWERUP_LOCK),
> +               ._read          = lpddr2_nvm_read,
> +               ._write         = lpddr2_nvm_write,
> +               ._erase         = lpddr2_nvm_erase,
> +               ._unlock        = lpddr2_nvm_unlock,
> +               ._lock          = lpddr2_nvm_lock,
> +       };
> +
> +       /* Verify the presence of the device looking for PFOW string */
> +       if (!lpddr2_nvm_pfow_present(map)) {
> +               pr_err("device not recognized\n");
> +               return -EINVAL;
> +       }
> +       /* Register the mtd_partition structure */
> +       return mtd_add_partition(mtd, "my_pcm", 0x10000000, 0x00);
> +}
> +
> +/* Initialize platform_driver data structure for lpddr2_nvm */
> +static struct platform_driver lpddr2_nvm_drv = {
> +       .driver         = {
> +               .name   = "lpddr2_nvm",
> +       },
> +       .probe          = lpddr2_nvm_probe,
> +};
> +
> +module_platform_driver(lpddr2_nvm_drv);
> +MODULE_LICENSE("GPL");
> +MODULE_AUTHOR("Vincenzo Aliberti <vincenzo.aliberti@gmail.com>");
> +MODULE_DESCRIPTION("MTD driver for LPDDR2-NVM PCM memories");
> diff --git a/include/uapi/mtd/mtd-abi.h b/include/uapi/mtd/mtd-abi.h
> index 36eace0..8a2bbf2 100644
> --- a/include/uapi/mtd/mtd-abi.h
> +++ b/include/uapi/mtd/mtd-abi.h
> @@ -107,6 +107,7 @@ struct mtd_write_req {
>  /* Some common devices / combinations of capabilities */
>  #define MTD_CAP_ROM            0
>  #define MTD_CAP_RAM            (MTD_WRITEABLE | MTD_BIT_WRITEABLE | MTD_NO_ERASE)
> +#define MTD_CAP_NVRAM          (MTD_WRITEABLE | MTD_BIT_WRITEABLE | MTD_NO_ERASE)
>  #define MTD_CAP_NORFLASH       (MTD_WRITEABLE | MTD_BIT_WRITEABLE)
>  #define MTD_CAP_NANDFLASH      (MTD_WRITEABLE)
>
> --
> 1.7.9.5
>
Brian Norris April 11, 2014, 5:06 p.m. UTC | #6
On Fri, Apr 11, 2014 at 04:43:43PM +0200, Vincenzo Aliberti wrote:
> If you have no further comment is it possible to push upstream?

Sorry, I haven't made time to review your patch again. But remember,
last time I checked, you hadn't even read all my comments, so I hope you
can understand how I might not be motivated to quickly read your patch
again ;)

But I'll take a look soon and probably queue it up for 3.16 after the
merge window if it looks alright.

Brian
Brian Norris April 16, 2014, 6:03 a.m. UTC | #7
Hi Vincenzo,

On Mon, Mar 03, 2014 at 10:44:33PM +0100, Vincenzo Aliberti wrote:
> Hi Brian,
>    here-below the version of driver modified as per your
> kind suggestion.

Thanks for the update. I have a few comments below. In the future,
please provide only the patch description here (that goes in the
change-log), and any side comments can go below.

> Regards,
>    Vincenzo
> 
> Signed-off-by: Vincenzo Aliberti <vincenzo.aliberti@gmail.com>
> 
> ---

Stuff that doesn't need to go in the change-log can go here (below the 3
hyphen line '---').

Also, can you provide a subject that begins with [PATCH vX], where X is
the version (e.g., your next patch should actually be [PATCH v3]), and
include here (below the line) a short description of what changed? e.g.:

  changes in v3:
      - addressed foo comment
      - fixed bar bug
      - resolved world hunger

>  drivers/mtd/lpddr/Kconfig      |   12 +-
>  drivers/mtd/lpddr/Makefile     |    1 +
>  drivers/mtd/lpddr/lpddr2_nvm.c |  504 ++++++++++++++++++++++++++++++++++++++++
>  include/uapi/mtd/mtd-abi.h     |    1 +
>  4 files changed, 516 insertions(+), 2 deletions(-)
>  create mode 100644 drivers/mtd/lpddr/lpddr2_nvm.c
> 
> diff --git a/drivers/mtd/lpddr/Kconfig b/drivers/mtd/lpddr/Kconfig
> index 265f969..94a7f30 100644
> --- a/drivers/mtd/lpddr/Kconfig
> +++ b/drivers/mtd/lpddr/Kconfig
> @@ -1,5 +1,5 @@
> -menu "LPDDR flash memory drivers"
> -	depends on MTD!=n
> +menu "LPDDR & LPDDR2 PCM memory drivers"
> +	depends on MTD
>  
>  config MTD_LPDDR
>  	tristate "Support for LPDDR flash chips"
> @@ -17,4 +17,12 @@ config MTD_QINFO_PROBE
>  	    Window QINFO interface, permits software to be used for entire
>  	    families of devices. This serves similar purpose of CFI on legacy
>  	    Flash products
> +
> +config MTD_LPDDR2_NVM
> +	depends on MTD && ARM
> +	tristate "Support for LPDDR2-NVM flash chips"
> +	help
> +	  This option enables support of PCM memories with a LPDDR2-NVM
> +	  (Low power double data rate 2) interface.
> +
>  endmenu
> diff --git a/drivers/mtd/lpddr/Makefile b/drivers/mtd/lpddr/Makefile
> index da48e46..881d440 100644
> --- a/drivers/mtd/lpddr/Makefile
> +++ b/drivers/mtd/lpddr/Makefile
> @@ -4,3 +4,4 @@
>  
>  obj-$(CONFIG_MTD_QINFO_PROBE)	+= qinfo_probe.o
>  obj-$(CONFIG_MTD_LPDDR)	+= lpddr_cmds.o
> +obj-$(CONFIG_MTD_LPDDR2_NVM) += lpddr2_nvm.o
> diff --git a/drivers/mtd/lpddr/lpddr2_nvm.c b/drivers/mtd/lpddr/lpddr2_nvm.c
> new file mode 100644
> index 0000000..5d52c47
> --- /dev/null
> +++ b/drivers/mtd/lpddr/lpddr2_nvm.c
> @@ -0,0 +1,504 @@
> +/*
> + * LPDDR2-NVM MTD driver. This module provides read, write, erase, lock/unlock
> + * support for LPDDR2-NVM PCM memories
> + *
> + * Copyright © 2012 Micron Technology, Inc.
> + *
> + * Vincenzo Aliberti <vincenzo.aliberti@gmail.com>
> + * Domenico Manna <domenico.manna@gmail.com>
> + * Many thanks to Andrea Vigilante for initial enabling
> + *
> + * This program is free software; you can redistribute it and/or
> + * modify it under the terms of the GNU General Public License
> + * as published by the Free Software Foundation; either version 2
> + * of the License, or (at your option) any later version.
> + *
> + * This program is distributed in the hope that it will be useful,
> + * but WITHOUT ANY WARRANTY; without even the implied warranty of
> + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
> + * GNU General Public License for more details.
> + *
> + * You should have received a copy of the GNU General Public License
> + * along with this program; if not, write to the Free Software
> + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
> + * 02110-1301, USA.

Drop the paragraph about the FSF address. checkpatch.pl warns you that
this address may change, and is not needed.

> + */
> +
> +#define pr_fmt(fmt) KBUILD_MODNAME ": %s: " fmt, __func__
> +
> +#include <linux/init.h>
> +#include <linux/io.h>
> +#include <linux/module.h>
> +#include <linux/kernel.h>
> +#include <linux/mtd/map.h>
> +#include <linux/mtd/mtd.h>
> +#include <linux/mtd/partitions.h>
> +#include <linux/slab.h>
> +#include <linux/platform_device.h>
> +#include <linux/ioport.h>
> +#include <linux/sched.h>
> +
> +/* Parameters */
> +#define ERASE_BLOCKSIZE			(0x00020000/2)	/* in Word */
> +#define WRITE_BUFFSIZE			(0x00000400/2)	/* in Word */
> +#define OW_BASE_ADDRESS			0x00000000	/* OW offset */
> +
> +/* PFOW symbols address offset */
> +#define PFOW_QUERY_STRING_P		(0x0000/2)	/* in Word */
> +#define PFOW_QUERY_STRING_F		(0x0002/2)	/* in Word */
> +#define PFOW_QUERY_STRING_O		(0x0004/2)	/* in Word */
> +#define PFOW_QUERY_STRING_W		(0x0006/2)	/* in Word */
> +
> +/* OW registers address */
> +#define CMD_CODE_OFS			(0x0080/2)	/* in Word */
> +#define CMD_DATA_OFS			(0x0084/2)	/* in Word */
> +#define CMD_ADD_L_OFS			(0x0088/2)	/* in Word */
> +#define CMD_ADD_H_OFS			(0x008A/2)	/* in Word */
> +#define MPR_L_OFS			(0x0090/2)	/* in Word */
> +#define MPR_H_OFS			(0x0092/2)	/* in Word */
> +#define CMD_EXEC_OFS			(0x00C0/2)	/* in Word */
> +#define STATUS_REG_OFS			(0x00CC/2)	/* in Word */
> +#define PRG_BUFFER_OFS			(0x0010/2)	/* in Word */
> +
> +/* Datamask */
> +#define MR_CFGMASK			0x8000
> +#define SR_OK_DATAMASK			0x0080
> +
> +/* LPDDR2-NVM Commands */
> +#define LPDDR2_NVM_LOCK			0x0061
> +#define LPDDR2_NVM_UNLOCK		0x0062
> +#define LPDDR2_NVM_SW_PROGRAM		0x0041
> +#define LPDDR2_NVM_SW_OVERWRITE		0x0042
> +#define LPDDR2_NVM_BUF_PROGRAM		0x00E9
> +#define LPDDR2_NVM_BUF_OVERWRITE	0x00EA
> +#define LPDDR2_NVM_ERASE		0x0020
> +
> +/*
> + * Internal Type Definitions
> + * pcm_int_data contains memory controller details:
> + * @reg_data : LPDDR2_MODE_REG_DATA register address after remapping
> + * @reg_cfg  : LPDDR2_MODE_REG_CFG register address after remapping
> + * &bus_width: memory bus-width (eg: x16 2 Bytes, x32 4 Bytes)
> + */
> +struct pcm_int_data {
> +	void __iomem *reg_data;
> +	void __iomem *reg_cfg;
> +	int bus_width;
> +};
> +
> +static DEFINE_MUTEX(lpdd2_nvm_mutex);
> +
> +/*
> + * Build a map_word starting from an u_long
> + */
> +static inline map_word build_map_word(u_long myword)
> +{
> +	map_word val = { {0} };
> +	val.x[0] = myword;
> +	return val;
> +}
> +
> +/*
> + * Build Mode Register Configuration DataMask based on device bus-width
> + */
> +static inline u_int build_mr_cfgmask(u_int bus_width)
> +{
> +	u_int val = MR_CFGMASK;
> +
> +	if (bus_width == 0x0004)		/* x32 device */
> +		val = val << 16;
> +
> +	return val;
> +}
> +
> +/*
> + * Build Status Register OK DataMask based on device bus-width
> + */
> +static inline u_int build_sr_ok_datamask(u_int bus_width)
> +{
> +	u_int val = SR_OK_DATAMASK;
> +
> +	if (bus_width == 0x0004)		/* x32 device */
> +		val = (val << 16)+val;
> +
> +	return val;
> +}
> +
> +/*
> + * Evaluates Overlay Window Control Registers address
> + */
> +static inline u_long ow_reg_add(struct map_info *map, u_long offset)
> +{
> +	u_long val = 0;
> +	struct pcm_int_data *pcm_data = map->fldrv_priv;
> +
> +	val = map->pfow_base + offset*pcm_data->bus_width;
> +
> +	return val;
> +}
> +
> +/*
> + * Enable lpddr2-nvm Overlay Window
> + * Overlay Window is a memory mapped area containing all LPDDR2-NVM registers
> + * used by device commands as well as uservisible resources like Device Status
> + * Register, Device ID, etc
> + */
> +static inline void ow_enable(struct map_info *map)
> +{
> +	struct pcm_int_data *pcm_data = map->fldrv_priv;
> +
> +	writel_relaxed(build_mr_cfgmask(pcm_data->bus_width) | 0x18,
> +		pcm_data->reg_cfg);
> +	writel_relaxed(0x01, pcm_data->reg_data);
> +}
> +
> +/*
> + * Disable lpddr2-nvm Overlay Window
> + * Overlay Window is a memory mapped area containing all LPDDR2-NVM registers
> + * used by device commands as well as uservisible resources like Device Status
> + * Register, Device ID, etc
> + */
> +static inline void ow_disable(struct map_info *map)
> +{
> +	struct pcm_int_data *pcm_data = map->fldrv_priv;
> +
> +	writel_relaxed(build_mr_cfgmask(pcm_data->bus_width) | 0x18,
> +		pcm_data->reg_cfg);
> +	writel_relaxed(0x02, pcm_data->reg_data);
> +}
> +
> +/*
> + * Execute lpddr2-nvm operations
> + */
> +static int lpddr2_nvm_do_op(struct map_info *map, u_long cmd_code,
> +	u_long cmd_data, u_long cmd_add, u_long cmd_mpr, u_char *buf)
> +{
> +	map_word add_l = { {0} }, add_h = { {0} }, mpr_l = { {0} },
> +		mpr_h = { {0} }, data_l = { {0} }, cmd = { {0} },
> +		exec_cmd = { {0} }, sr;
> +	map_word data_h = { {0} };	/* only for 2x x16 devices stacked */
> +	u_long i, status_reg, prg_buff_ofs;
> +	struct pcm_int_data *pcm_data = map->fldrv_priv;
> +	u_int sr_ok_datamask = build_sr_ok_datamask(pcm_data->bus_width);
> +
> +	/* Builds low and high words for OW Control Registers */
> +	add_l.x[0]	= cmd_add & 0x0000FFFF;
> +	add_h.x[0]	= (cmd_add >> 16) & 0x0000FFFF;
> +	mpr_l.x[0]	= cmd_mpr & 0x0000FFFF;
> +	mpr_h.x[0]	= (cmd_mpr >> 16) & 0x0000FFFF;
> +	cmd.x[0]	= cmd_code & 0x0000FFFF;
> +	exec_cmd.x[0]	= 0x0001;
> +	data_l.x[0]	= cmd_data & 0x0000FFFF;
> +	data_h.x[0]	= (cmd_data >> 16) & 0x0000FFFF; /* only for 2x x16 */
> +
> +	/* Set Overlay Window Control Registers */
> +	map_write(map, cmd, ow_reg_add(map, CMD_CODE_OFS));
> +	map_write(map, data_l, ow_reg_add(map, CMD_DATA_OFS));
> +	map_write(map, add_l, ow_reg_add(map, CMD_ADD_L_OFS));
> +	map_write(map, add_h, ow_reg_add(map, CMD_ADD_H_OFS));
> +	map_write(map, mpr_l, ow_reg_add(map, MPR_L_OFS));
> +	map_write(map, mpr_h, ow_reg_add(map, MPR_H_OFS));
> +	if (pcm_data->bus_width == 0x0004) {	/* 2x16 devices stacked */
> +		map_write(map, cmd, ow_reg_add(map, CMD_CODE_OFS) + 2);
> +		map_write(map, data_h, ow_reg_add(map, CMD_DATA_OFS) + 2);
> +		map_write(map, add_l, ow_reg_add(map, CMD_ADD_L_OFS) + 2);
> +		map_write(map, add_h, ow_reg_add(map, CMD_ADD_H_OFS) + 2);
> +		map_write(map, mpr_l, ow_reg_add(map, MPR_L_OFS) + 2);
> +		map_write(map, mpr_h, ow_reg_add(map, MPR_H_OFS) + 2);
> +	}
> +
> +	/* Fill Program Buffer */
> +	if ((cmd_code == LPDDR2_NVM_BUF_PROGRAM) ||
> +		(cmd_code == LPDDR2_NVM_BUF_OVERWRITE)) {
> +		prg_buff_ofs = (map_read(map,
> +			ow_reg_add(map, PRG_BUFFER_OFS))).x[0];
> +		for (i = 0; i < cmd_mpr; i++) {
> +			map_write(map, build_map_word(buf[i]), map->pfow_base +
> +			prg_buff_ofs + i);
> +		}
> +	}
> +
> +	/* Command Execute */
> +	map_write(map, exec_cmd, ow_reg_add(map, CMD_EXEC_OFS));
> +	if (pcm_data->bus_width == 0x0004)	/* 2x16 devices stacked */
> +		map_write(map, exec_cmd, ow_reg_add(map, CMD_EXEC_OFS) + 2);
> +
> +	/* Status Register Check */
> +	do {
> +		sr = map_read(map, ow_reg_add(map, STATUS_REG_OFS));
> +		status_reg = sr.x[0];
> +		if (pcm_data->bus_width == 0x0004) {/* 2x16 devices stacked */
> +			sr = map_read(map, ow_reg_add(map,
> +				STATUS_REG_OFS) + 2);
> +			status_reg += sr.x[0] << 16;
> +		}
> +	} while ((status_reg & sr_ok_datamask) != sr_ok_datamask);
> +
> +	return (((status_reg & sr_ok_datamask) == sr_ok_datamask) ? 0 : -EIO);
> +}
> +
> +/*
> + * Execute lpddr2-nvm operations @ block level
> + */
> +static int lpddr2_nvm_do_block_op(struct mtd_info *mtd, loff_t start_add,
> +	uint64_t len, u_char block_op)
> +{
> +	struct map_info *map = mtd->priv;
> +	u_long add, end_add;
> +	int ret = 0;
> +
> +	mutex_lock(&lpdd2_nvm_mutex);
> +
> +	ow_enable(map);
> +
> +	add = start_add;
> +	end_add = add + len;
> +
> +	do {
> +		ret = lpddr2_nvm_do_op(map, block_op, 0x00, add, add, NULL);
> +		if (ret)
> +			goto out;
> +		add += mtd->erasesize;
> +	} while (add < end_add);
> +
> +out:
> +	ow_disable(map);
> +	mutex_unlock(&lpdd2_nvm_mutex);
> +	return ret;
> +}
> +
> +/*
> + * verify presence of PFOW string
> + */
> +static int lpddr2_nvm_pfow_present(struct map_info *map)
> +{
> +	map_word pfow_val[4];
> +	unsigned int found = 1;
> +
> +	mutex_lock(&lpdd2_nvm_mutex);
> +
> +	ow_enable(map);
> +
> +	/* Load string from array */
> +	pfow_val[0] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_P));
> +	pfow_val[1] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_F));
> +	pfow_val[2] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_O));
> +	pfow_val[3] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_W));
> +
> +	/* Verify the string loaded vs expected */
> +	if (!map_word_equal(map, build_map_word('P'), pfow_val[0]))
> +		found = 0;
> +	if (!map_word_equal(map, build_map_word('F'), pfow_val[1]))
> +		found = 0;
> +	if (!map_word_equal(map, build_map_word('O'), pfow_val[2]))
> +		found = 0;
> +	if (!map_word_equal(map, build_map_word('W'), pfow_val[3]))
> +		found = 0;
> +
> +	ow_disable(map);
> +
> +	mutex_unlock(&lpdd2_nvm_mutex);
> +
> +	return found;
> +}
> +
> +/*
> + * lpddr2_nvm driver read method
> + */
> +static int lpddr2_nvm_read(struct mtd_info *mtd, loff_t start_add,
> +				size_t len, size_t *retlen, u_char *buf)
> +{
> +	struct map_info *map = mtd->priv;
> +
> +	mutex_lock(&lpdd2_nvm_mutex);
> +
> +	*retlen = len;
> +
> +	map_copy_from(map, buf, start_add, *retlen);
> +
> +	mutex_unlock(&lpdd2_nvm_mutex);
> +	return 0;
> +}
> +
> +/*
> + * lpddr2_nvm driver write method
> + */
> +static int lpddr2_nvm_write(struct mtd_info *mtd, loff_t start_add,
> +				size_t len, size_t *retlen, const u_char *buf)
> +{
> +	struct map_info *map = mtd->priv;
> +	struct pcm_int_data *pcm_data = map->fldrv_priv;
> +	u_long add, current_len, tot_len, target_len, my_data;
> +	u_char *write_buf = (u_char *)buf;
> +	int ret = 0;
> +
> +	mutex_lock(&lpdd2_nvm_mutex);
> +
> +	ow_enable(map);
> +
> +	/* Set start value for the variables */
> +	add = start_add;
> +	target_len = len;
> +	tot_len = 0;
> +
> +	while (tot_len < target_len) {
> +		if (!(IS_ALIGNED(add, mtd->writesize))) { /* do sw program */
> +			my_data = write_buf[tot_len];
> +			my_data += (write_buf[tot_len+1]) << 8;
> +			if (pcm_data->bus_width == 0x0004) {/* 2x16 devices */
> +				my_data += (write_buf[tot_len+2]) << 16;
> +				my_data += (write_buf[tot_len+3]) << 24;
> +			}
> +			ret = lpddr2_nvm_do_op(map, LPDDR2_NVM_SW_OVERWRITE,
> +				my_data, add, 0x00, NULL);
> +			if (ret)
> +				goto out;
> +
> +			add += pcm_data->bus_width;
> +			tot_len += pcm_data->bus_width;
> +		} else {		/* do buffer program */
> +			current_len = min(target_len - tot_len,
> +				(u_long) mtd->writesize);
> +			ret = lpddr2_nvm_do_op(map, LPDDR2_NVM_BUF_OVERWRITE,
> +				0x00, add, current_len, write_buf + tot_len);
> +			if (ret)
> +				goto out;
> +
> +			add += current_len;
> +			tot_len += current_len;
> +		}
> +	}
> +
> +out:
> +	*retlen = tot_len;
> +	ow_disable(map);
> +	mutex_unlock(&lpdd2_nvm_mutex);
> +	return ret;
> +}
> +
> +/*
> + * lpddr2_nvm driver erase method
> + */
> +static int lpddr2_nvm_erase(struct mtd_info *mtd, struct erase_info *instr)
> +{
> +	int ret = lpddr2_nvm_do_block_op(mtd, instr->addr, instr->len,
> +		LPDDR2_NVM_ERASE);
> +	if (!ret) {
> +		instr->state = MTD_ERASE_DONE;
> +		mtd_erase_callback(instr);
> +	}
> +
> +	return ret;
> +}
> +
> +/*
> + * lpddr2_nvm driver unlock method
> + */
> +static int lpddr2_nvm_unlock(struct mtd_info *mtd, loff_t start_add,
> +	uint64_t len)
> +{
> +	return lpddr2_nvm_do_block_op(mtd, start_add, len, LPDDR2_NVM_UNLOCK);
> +}
> +
> +/*
> + * lpddr2_nvm driver lock method
> + */
> +static int lpddr2_nvm_lock(struct mtd_info *mtd, loff_t start_add,
> +	uint64_t len)
> +{
> +	return lpddr2_nvm_do_block_op(mtd, start_add, len, LPDDR2_NVM_LOCK);
> +}
> +
> +/*
> + * lpddr2_nvm driver probe method
> + */
> +static int lpddr2_nvm_probe(struct platform_device *pdev)
> +{
> +	struct map_info *map;
> +	struct mtd_info *mtd;
> +	struct resource *add_range = platform_get_resource(pdev,
> +						IORESOURCE_MEM, 0);
> +	struct resource *control_regs = platform_get_resource(pdev,
> +						IORESOURCE_MEM, 1);
> +	struct resource *buswidth = platform_get_resource(pdev,
> +						IORESOURCE_BUS, 0);

This doesn't look right. You're using an IORESOURCE_BUS to represent
your bus width?

Are you using device-tree or traditional platform_device for
initializing this driver?

> +	struct pcm_int_data *pcm_data;
> +
> +	/* Allocate memory control_regs data structures */
> +	pcm_data = devm_kzalloc(&pdev->dev, sizeof(*pcm_data), GFP_KERNEL);
> +	if (!pcm_data)
> +		return -ENOMEM;
> +	pcm_data->reg_data =	(void *) control_regs->start;
> +	pcm_data->reg_cfg =	(void *) control_regs->end;

This seems like an abuse of the 'resource' construct; you're
representing two register addresses as the start/end of a resource?
Typically, device drivers will represent their device register space(s)
as contiguous resources, and the driver will know the register offsets
themselves. So you would do:

	struct resource *res;
	/* Get control registers */
	res = platform_get_resource(pdev, IOIRESOURCE_MEM, 1);
	pcm_data->ctl_regs = devm_ioremap_resource(&pdev->dev, res);
	if (IS_ERR(pcm_data->ctl_regs))
		return ERR_PTR(pcm_data->ctl_regs);

Then you'd access your registers with some fixed offsets:

	writel(val1, pcm_data->ctl_regs + LPDDR2_NVM_CONTROL_DATA);
	writel(val2, pcm_data->ctl_regs + LPDDR2_NVM_CONTROL_CFG);

Does this model not work for you?

> +	pcm_data->bus_width =	(int) buswidth->start;
> +
> +	/* Allocate memory for map_info & mtd_info data structures */
> +	map = devm_kzalloc(&pdev->dev, sizeof(*map), GFP_KERNEL);
> +	if (!map)
> +		return -ENOMEM;
> +
> +	mtd = devm_kzalloc(&pdev->dev, sizeof(*mtd), GFP_KERNEL);
> +	if (!mtd)
> +		return -ENOMEM;
> +
> +	/* Reserve lpddr2_nvm address range */
> +	if (devm_request_mem_region(&pdev->dev, add_range->start,
> +		(add_range->end - add_range->start + 1),

That can be resource_size(add_range). Or just combine the request_mem
with the ioremap (later) and use devm_ioremap_resource(). This saves you
some error handling and other boilerplate.

> +		"lpddr2_nvm") == NULL) {
> +		pr_err("Unable to reserve address range\n");
> +		return -EBUSY;
> +	}
> +
> +	/* Populate map_info data structure */
> +	*map = (struct map_info) {
> +		.virt		= devm_ioremap_nocache(&pdev->dev,
> +				add_range->start, (add_range->end -
> +				add_range->start + 1)),
> +		.name		= pdev->dev.init_name,
> +		.phys		= add_range->start,
> +		.size		= add_range->end - add_range->start + 1,

resource_size()

> +		.bankwidth	= pcm_data->bus_width/2,
> +		.pfow_base	= OW_BASE_ADDRESS,
> +		.fldrv_priv	= pcm_data,
> +	};
> +
> +	simple_map_init(map);	/* fill with default methods */
> +
> +	/* Populate mtd_info data structure */
> +	*mtd = (struct mtd_info) {
> +		.name		= pdev->dev.init_name,
> +		.type		= MTD_RAM,
> +		.priv		= map,
> +		.size		= add_range->end - add_range->start + 1,

resource_size(add_range)

> +		.erasesize	= ERASE_BLOCKSIZE * pcm_data->bus_width,

The eraseblock size is dependent on the bus width? That's odd.

> +		.writesize	= 1,
> +		.writebufsize	= WRITE_BUFFSIZE * pcm_data->bus_width,

Same here. Why does the bus width have anything to do with this?

> +		.flags		= (MTD_CAP_NVRAM | MTD_POWERUP_LOCK),
> +		._read		= lpddr2_nvm_read,
> +		._write		= lpddr2_nvm_write,
> +		._erase		= lpddr2_nvm_erase,
> +		._unlock	= lpddr2_nvm_unlock,
> +		._lock		= lpddr2_nvm_lock,
> +	};
> +
> +	/* Verify the presence of the device looking for PFOW string */
> +	if (!lpddr2_nvm_pfow_present(map)) {
> +		pr_err("device not recognized\n");
> +		return -EINVAL;
> +	}
> +	/* Register the mtd_partition structure */
> +	return mtd_add_partition(mtd, "my_pcm", 0x10000000, 0x00);

Hmm, that's not right. You don't call mtd_add_partition() directly in a
driver. How about:

	mtd_device_parse_register(mtd, NULL, NULL, NULL, 0);

?

At a minimum, users should be able to specify partitions (via
cmdlinepart or ofpart; see default_mtd_part_types in
drivers/mtd/mtdpart.c). If you need, you can also provide a default
partition list via the 4th and 5th arguments (provided via platform_data
or just fixed to a single "my_pcm" partition like you do here), if you
must.

> +}
> +
> +/* Initialize platform_driver data structure for lpddr2_nvm */
> +static struct platform_driver lpddr2_nvm_drv = {
> +	.driver		= {
> +		.name	= "lpddr2_nvm",
> +	},
> +	.probe		= lpddr2_nvm_probe,

Can you provide a remove callback too? Otherwise, you won't be able to
remove your .ko module (if you're using this as a module).

> +};
> +
> +module_platform_driver(lpddr2_nvm_drv);
> +MODULE_LICENSE("GPL");
> +MODULE_AUTHOR("Vincenzo Aliberti <vincenzo.aliberti@gmail.com>");
> +MODULE_DESCRIPTION("MTD driver for LPDDR2-NVM PCM memories");
> diff --git a/include/uapi/mtd/mtd-abi.h b/include/uapi/mtd/mtd-abi.h
> index 36eace0..8a2bbf2 100644
> --- a/include/uapi/mtd/mtd-abi.h
> +++ b/include/uapi/mtd/mtd-abi.h
> @@ -107,6 +107,7 @@ struct mtd_write_req {
>  /* Some common devices / combinations of capabilities */
>  #define MTD_CAP_ROM		0
>  #define MTD_CAP_RAM		(MTD_WRITEABLE | MTD_BIT_WRITEABLE | MTD_NO_ERASE)
> +#define MTD_CAP_NVRAM		(MTD_WRITEABLE | MTD_BIT_WRITEABLE | MTD_NO_ERASE)
>  #define MTD_CAP_NORFLASH	(MTD_WRITEABLE | MTD_BIT_WRITEABLE)
>  #define MTD_CAP_NANDFLASH	(MTD_WRITEABLE)
>  

Brian
Vincenzo Aliberti April 23, 2014, 10:03 a.m. UTC | #8
Brian,
   thanks for your help! Here-after my feedback

On Wed, Apr 16, 2014 at 8:03 AM, Brian Norris
<computersforpeace@gmail.com> wrote:
> Hi Vincenzo,
>
> On Mon, Mar 03, 2014 at 10:44:33PM +0100, Vincenzo Aliberti wrote:
>> Hi Brian,
>>    here-below the version of driver modified as per your
>> kind suggestion.
>
> Thanks for the update. I have a few comments below. In the future,
> please provide only the patch description here (that goes in the
> change-log), and any side comments can go below.
>

VA: OK, clear now

>> Regards,
>>    Vincenzo
>>
>> Signed-off-by: Vincenzo Aliberti <vincenzo.aliberti@gmail.com>
>>
>> ---
>
> Stuff that doesn't need to go in the change-log can go here (below the 3
> hyphen line '---').
>
> Also, can you provide a subject that begins with [PATCH vX], where X is
> the version (e.g., your next patch should actually be [PATCH v3]), and
> include here (below the line) a short description of what changed? e.g.:
>
>   changes in v3:
>       - addressed foo comment
>       - fixed bar bug
>       - resolved world hunger
>

VA: I'll rename in line with your suggestion and add changelog

>>  drivers/mtd/lpddr/Kconfig      |   12 +-
>>  drivers/mtd/lpddr/Makefile     |    1 +
>>  drivers/mtd/lpddr/lpddr2_nvm.c |  504 ++++++++++++++++++++++++++++++++++++++++
>>  include/uapi/mtd/mtd-abi.h     |    1 +
>>  4 files changed, 516 insertions(+), 2 deletions(-)
>>  create mode 100644 drivers/mtd/lpddr/lpddr2_nvm.c
>>
>> diff --git a/drivers/mtd/lpddr/Kconfig b/drivers/mtd/lpddr/Kconfig
>> index 265f969..94a7f30 100644
>> --- a/drivers/mtd/lpddr/Kconfig
>> +++ b/drivers/mtd/lpddr/Kconfig
>> @@ -1,5 +1,5 @@
>> -menu "LPDDR flash memory drivers"
>> -     depends on MTD!=n
>> +menu "LPDDR & LPDDR2 PCM memory drivers"
>> +     depends on MTD
>>
>>  config MTD_LPDDR
>>       tristate "Support for LPDDR flash chips"
>> @@ -17,4 +17,12 @@ config MTD_QINFO_PROBE
>>           Window QINFO interface, permits software to be used for entire
>>           families of devices. This serves similar purpose of CFI on legacy
>>           Flash products
>> +
>> +config MTD_LPDDR2_NVM
>> +     depends on MTD && ARM
>> +     tristate "Support for LPDDR2-NVM flash chips"
>> +     help
>> +       This option enables support of PCM memories with a LPDDR2-NVM
>> +       (Low power double data rate 2) interface.
>> +
>>  endmenu
>> diff --git a/drivers/mtd/lpddr/Makefile b/drivers/mtd/lpddr/Makefile
>> index da48e46..881d440 100644
>> --- a/drivers/mtd/lpddr/Makefile
>> +++ b/drivers/mtd/lpddr/Makefile
>> @@ -4,3 +4,4 @@
>>
>>  obj-$(CONFIG_MTD_QINFO_PROBE)        += qinfo_probe.o
>>  obj-$(CONFIG_MTD_LPDDR)      += lpddr_cmds.o
>> +obj-$(CONFIG_MTD_LPDDR2_NVM) += lpddr2_nvm.o
>> diff --git a/drivers/mtd/lpddr/lpddr2_nvm.c b/drivers/mtd/lpddr/lpddr2_nvm.c
>> new file mode 100644
>> index 0000000..5d52c47
>> --- /dev/null
>> +++ b/drivers/mtd/lpddr/lpddr2_nvm.c
>> @@ -0,0 +1,504 @@
>> +/*
>> + * LPDDR2-NVM MTD driver. This module provides read, write, erase, lock/unlock
>> + * support for LPDDR2-NVM PCM memories
>> + *
>> + * Copyright © 2012 Micron Technology, Inc.
>> + *
>> + * Vincenzo Aliberti <vincenzo.aliberti@gmail.com>
>> + * Domenico Manna <domenico.manna@gmail.com>
>> + * Many thanks to Andrea Vigilante for initial enabling
>> + *
>> + * This program is free software; you can redistribute it and/or
>> + * modify it under the terms of the GNU General Public License
>> + * as published by the Free Software Foundation; either version 2
>> + * of the License, or (at your option) any later version.
>> + *
>> + * This program is distributed in the hope that it will be useful,
>> + * but WITHOUT ANY WARRANTY; without even the implied warranty of
>> + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
>> + * GNU General Public License for more details.
>> + *
>> + * You should have received a copy of the GNU General Public License
>> + * along with this program; if not, write to the Free Software
>> + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
>> + * 02110-1301, USA.
>
> Drop the paragraph about the FSF address. checkpatch.pl warns you that
> this address may change, and is not needed.
>

VA: OK will do

>> + */
>> +
>> +#define pr_fmt(fmt) KBUILD_MODNAME ": %s: " fmt, __func__
>> +
>> +#include <linux/init.h>
>> +#include <linux/io.h>
>> +#include <linux/module.h>
>> +#include <linux/kernel.h>
>> +#include <linux/mtd/map.h>
>> +#include <linux/mtd/mtd.h>
>> +#include <linux/mtd/partitions.h>
>> +#include <linux/slab.h>
>> +#include <linux/platform_device.h>
>> +#include <linux/ioport.h>
>> +#include <linux/sched.h>
>> +
>> +/* Parameters */
>> +#define ERASE_BLOCKSIZE                      (0x00020000/2)  /* in Word */
>> +#define WRITE_BUFFSIZE                       (0x00000400/2)  /* in Word */
>> +#define OW_BASE_ADDRESS                      0x00000000      /* OW offset */
>> +
>> +/* PFOW symbols address offset */
>> +#define PFOW_QUERY_STRING_P          (0x0000/2)      /* in Word */
>> +#define PFOW_QUERY_STRING_F          (0x0002/2)      /* in Word */
>> +#define PFOW_QUERY_STRING_O          (0x0004/2)      /* in Word */
>> +#define PFOW_QUERY_STRING_W          (0x0006/2)      /* in Word */
>> +
>> +/* OW registers address */
>> +#define CMD_CODE_OFS                 (0x0080/2)      /* in Word */
>> +#define CMD_DATA_OFS                 (0x0084/2)      /* in Word */
>> +#define CMD_ADD_L_OFS                        (0x0088/2)      /* in Word */
>> +#define CMD_ADD_H_OFS                        (0x008A/2)      /* in Word */
>> +#define MPR_L_OFS                    (0x0090/2)      /* in Word */
>> +#define MPR_H_OFS                    (0x0092/2)      /* in Word */
>> +#define CMD_EXEC_OFS                 (0x00C0/2)      /* in Word */
>> +#define STATUS_REG_OFS                       (0x00CC/2)      /* in Word */
>> +#define PRG_BUFFER_OFS                       (0x0010/2)      /* in Word */
>> +
>> +/* Datamask */
>> +#define MR_CFGMASK                   0x8000
>> +#define SR_OK_DATAMASK                       0x0080
>> +
>> +/* LPDDR2-NVM Commands */
>> +#define LPDDR2_NVM_LOCK                      0x0061
>> +#define LPDDR2_NVM_UNLOCK            0x0062
>> +#define LPDDR2_NVM_SW_PROGRAM                0x0041
>> +#define LPDDR2_NVM_SW_OVERWRITE              0x0042
>> +#define LPDDR2_NVM_BUF_PROGRAM               0x00E9
>> +#define LPDDR2_NVM_BUF_OVERWRITE     0x00EA
>> +#define LPDDR2_NVM_ERASE             0x0020
>> +
>> +/*
>> + * Internal Type Definitions
>> + * pcm_int_data contains memory controller details:
>> + * @reg_data : LPDDR2_MODE_REG_DATA register address after remapping
>> + * @reg_cfg  : LPDDR2_MODE_REG_CFG register address after remapping
>> + * &bus_width: memory bus-width (eg: x16 2 Bytes, x32 4 Bytes)
>> + */
>> +struct pcm_int_data {
>> +     void __iomem *reg_data;
>> +     void __iomem *reg_cfg;
>> +     int bus_width;
>> +};
>> +
>> +static DEFINE_MUTEX(lpdd2_nvm_mutex);
>> +
>> +/*
>> + * Build a map_word starting from an u_long
>> + */
>> +static inline map_word build_map_word(u_long myword)
>> +{
>> +     map_word val = { {0} };
>> +     val.x[0] = myword;
>> +     return val;
>> +}
>> +
>> +/*
>> + * Build Mode Register Configuration DataMask based on device bus-width
>> + */
>> +static inline u_int build_mr_cfgmask(u_int bus_width)
>> +{
>> +     u_int val = MR_CFGMASK;
>> +
>> +     if (bus_width == 0x0004)                /* x32 device */
>> +             val = val << 16;
>> +
>> +     return val;
>> +}
>> +
>> +/*
>> + * Build Status Register OK DataMask based on device bus-width
>> + */
>> +static inline u_int build_sr_ok_datamask(u_int bus_width)
>> +{
>> +     u_int val = SR_OK_DATAMASK;
>> +
>> +     if (bus_width == 0x0004)                /* x32 device */
>> +             val = (val << 16)+val;
>> +
>> +     return val;
>> +}
>> +
>> +/*
>> + * Evaluates Overlay Window Control Registers address
>> + */
>> +static inline u_long ow_reg_add(struct map_info *map, u_long offset)
>> +{
>> +     u_long val = 0;
>> +     struct pcm_int_data *pcm_data = map->fldrv_priv;
>> +
>> +     val = map->pfow_base + offset*pcm_data->bus_width;
>> +
>> +     return val;
>> +}
>> +
>> +/*
>> + * Enable lpddr2-nvm Overlay Window
>> + * Overlay Window is a memory mapped area containing all LPDDR2-NVM registers
>> + * used by device commands as well as uservisible resources like Device Status
>> + * Register, Device ID, etc
>> + */
>> +static inline void ow_enable(struct map_info *map)
>> +{
>> +     struct pcm_int_data *pcm_data = map->fldrv_priv;
>> +
>> +     writel_relaxed(build_mr_cfgmask(pcm_data->bus_width) | 0x18,
>> +             pcm_data->reg_cfg);
>> +     writel_relaxed(0x01, pcm_data->reg_data);
>> +}
>> +
>> +/*
>> + * Disable lpddr2-nvm Overlay Window
>> + * Overlay Window is a memory mapped area containing all LPDDR2-NVM registers
>> + * used by device commands as well as uservisible resources like Device Status
>> + * Register, Device ID, etc
>> + */
>> +static inline void ow_disable(struct map_info *map)
>> +{
>> +     struct pcm_int_data *pcm_data = map->fldrv_priv;
>> +
>> +     writel_relaxed(build_mr_cfgmask(pcm_data->bus_width) | 0x18,
>> +             pcm_data->reg_cfg);
>> +     writel_relaxed(0x02, pcm_data->reg_data);
>> +}
>> +
>> +/*
>> + * Execute lpddr2-nvm operations
>> + */
>> +static int lpddr2_nvm_do_op(struct map_info *map, u_long cmd_code,
>> +     u_long cmd_data, u_long cmd_add, u_long cmd_mpr, u_char *buf)
>> +{
>> +     map_word add_l = { {0} }, add_h = { {0} }, mpr_l = { {0} },
>> +             mpr_h = { {0} }, data_l = { {0} }, cmd = { {0} },
>> +             exec_cmd = { {0} }, sr;
>> +     map_word data_h = { {0} };      /* only for 2x x16 devices stacked */
>> +     u_long i, status_reg, prg_buff_ofs;
>> +     struct pcm_int_data *pcm_data = map->fldrv_priv;
>> +     u_int sr_ok_datamask = build_sr_ok_datamask(pcm_data->bus_width);
>> +
>> +     /* Builds low and high words for OW Control Registers */
>> +     add_l.x[0]      = cmd_add & 0x0000FFFF;
>> +     add_h.x[0]      = (cmd_add >> 16) & 0x0000FFFF;
>> +     mpr_l.x[0]      = cmd_mpr & 0x0000FFFF;
>> +     mpr_h.x[0]      = (cmd_mpr >> 16) & 0x0000FFFF;
>> +     cmd.x[0]        = cmd_code & 0x0000FFFF;
>> +     exec_cmd.x[0]   = 0x0001;
>> +     data_l.x[0]     = cmd_data & 0x0000FFFF;
>> +     data_h.x[0]     = (cmd_data >> 16) & 0x0000FFFF; /* only for 2x x16 */
>> +
>> +     /* Set Overlay Window Control Registers */
>> +     map_write(map, cmd, ow_reg_add(map, CMD_CODE_OFS));
>> +     map_write(map, data_l, ow_reg_add(map, CMD_DATA_OFS));
>> +     map_write(map, add_l, ow_reg_add(map, CMD_ADD_L_OFS));
>> +     map_write(map, add_h, ow_reg_add(map, CMD_ADD_H_OFS));
>> +     map_write(map, mpr_l, ow_reg_add(map, MPR_L_OFS));
>> +     map_write(map, mpr_h, ow_reg_add(map, MPR_H_OFS));
>> +     if (pcm_data->bus_width == 0x0004) {    /* 2x16 devices stacked */
>> +             map_write(map, cmd, ow_reg_add(map, CMD_CODE_OFS) + 2);
>> +             map_write(map, data_h, ow_reg_add(map, CMD_DATA_OFS) + 2);
>> +             map_write(map, add_l, ow_reg_add(map, CMD_ADD_L_OFS) + 2);
>> +             map_write(map, add_h, ow_reg_add(map, CMD_ADD_H_OFS) + 2);
>> +             map_write(map, mpr_l, ow_reg_add(map, MPR_L_OFS) + 2);
>> +             map_write(map, mpr_h, ow_reg_add(map, MPR_H_OFS) + 2);
>> +     }
>> +
>> +     /* Fill Program Buffer */
>> +     if ((cmd_code == LPDDR2_NVM_BUF_PROGRAM) ||
>> +             (cmd_code == LPDDR2_NVM_BUF_OVERWRITE)) {
>> +             prg_buff_ofs = (map_read(map,
>> +                     ow_reg_add(map, PRG_BUFFER_OFS))).x[0];
>> +             for (i = 0; i < cmd_mpr; i++) {
>> +                     map_write(map, build_map_word(buf[i]), map->pfow_base +
>> +                     prg_buff_ofs + i);
>> +             }
>> +     }
>> +
>> +     /* Command Execute */
>> +     map_write(map, exec_cmd, ow_reg_add(map, CMD_EXEC_OFS));
>> +     if (pcm_data->bus_width == 0x0004)      /* 2x16 devices stacked */
>> +             map_write(map, exec_cmd, ow_reg_add(map, CMD_EXEC_OFS) + 2);
>> +
>> +     /* Status Register Check */
>> +     do {
>> +             sr = map_read(map, ow_reg_add(map, STATUS_REG_OFS));
>> +             status_reg = sr.x[0];
>> +             if (pcm_data->bus_width == 0x0004) {/* 2x16 devices stacked */
>> +                     sr = map_read(map, ow_reg_add(map,
>> +                             STATUS_REG_OFS) + 2);
>> +                     status_reg += sr.x[0] << 16;
>> +             }
>> +     } while ((status_reg & sr_ok_datamask) != sr_ok_datamask);
>> +
>> +     return (((status_reg & sr_ok_datamask) == sr_ok_datamask) ? 0 : -EIO);
>> +}
>> +
>> +/*
>> + * Execute lpddr2-nvm operations @ block level
>> + */
>> +static int lpddr2_nvm_do_block_op(struct mtd_info *mtd, loff_t start_add,
>> +     uint64_t len, u_char block_op)
>> +{
>> +     struct map_info *map = mtd->priv;
>> +     u_long add, end_add;
>> +     int ret = 0;
>> +
>> +     mutex_lock(&lpdd2_nvm_mutex);
>> +
>> +     ow_enable(map);
>> +
>> +     add = start_add;
>> +     end_add = add + len;
>> +
>> +     do {
>> +             ret = lpddr2_nvm_do_op(map, block_op, 0x00, add, add, NULL);
>> +             if (ret)
>> +                     goto out;
>> +             add += mtd->erasesize;
>> +     } while (add < end_add);
>> +
>> +out:
>> +     ow_disable(map);
>> +     mutex_unlock(&lpdd2_nvm_mutex);
>> +     return ret;
>> +}
>> +
>> +/*
>> + * verify presence of PFOW string
>> + */
>> +static int lpddr2_nvm_pfow_present(struct map_info *map)
>> +{
>> +     map_word pfow_val[4];
>> +     unsigned int found = 1;
>> +
>> +     mutex_lock(&lpdd2_nvm_mutex);
>> +
>> +     ow_enable(map);
>> +
>> +     /* Load string from array */
>> +     pfow_val[0] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_P));
>> +     pfow_val[1] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_F));
>> +     pfow_val[2] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_O));
>> +     pfow_val[3] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_W));
>> +
>> +     /* Verify the string loaded vs expected */
>> +     if (!map_word_equal(map, build_map_word('P'), pfow_val[0]))
>> +             found = 0;
>> +     if (!map_word_equal(map, build_map_word('F'), pfow_val[1]))
>> +             found = 0;
>> +     if (!map_word_equal(map, build_map_word('O'), pfow_val[2]))
>> +             found = 0;
>> +     if (!map_word_equal(map, build_map_word('W'), pfow_val[3]))
>> +             found = 0;
>> +
>> +     ow_disable(map);
>> +
>> +     mutex_unlock(&lpdd2_nvm_mutex);
>> +
>> +     return found;
>> +}
>> +
>> +/*
>> + * lpddr2_nvm driver read method
>> + */
>> +static int lpddr2_nvm_read(struct mtd_info *mtd, loff_t start_add,
>> +                             size_t len, size_t *retlen, u_char *buf)
>> +{
>> +     struct map_info *map = mtd->priv;
>> +
>> +     mutex_lock(&lpdd2_nvm_mutex);
>> +
>> +     *retlen = len;
>> +
>> +     map_copy_from(map, buf, start_add, *retlen);
>> +
>> +     mutex_unlock(&lpdd2_nvm_mutex);
>> +     return 0;
>> +}
>> +
>> +/*
>> + * lpddr2_nvm driver write method
>> + */
>> +static int lpddr2_nvm_write(struct mtd_info *mtd, loff_t start_add,
>> +                             size_t len, size_t *retlen, const u_char *buf)
>> +{
>> +     struct map_info *map = mtd->priv;
>> +     struct pcm_int_data *pcm_data = map->fldrv_priv;
>> +     u_long add, current_len, tot_len, target_len, my_data;
>> +     u_char *write_buf = (u_char *)buf;
>> +     int ret = 0;
>> +
>> +     mutex_lock(&lpdd2_nvm_mutex);
>> +
>> +     ow_enable(map);
>> +
>> +     /* Set start value for the variables */
>> +     add = start_add;
>> +     target_len = len;
>> +     tot_len = 0;
>> +
>> +     while (tot_len < target_len) {
>> +             if (!(IS_ALIGNED(add, mtd->writesize))) { /* do sw program */
>> +                     my_data = write_buf[tot_len];
>> +                     my_data += (write_buf[tot_len+1]) << 8;
>> +                     if (pcm_data->bus_width == 0x0004) {/* 2x16 devices */
>> +                             my_data += (write_buf[tot_len+2]) << 16;
>> +                             my_data += (write_buf[tot_len+3]) << 24;
>> +                     }
>> +                     ret = lpddr2_nvm_do_op(map, LPDDR2_NVM_SW_OVERWRITE,
>> +                             my_data, add, 0x00, NULL);
>> +                     if (ret)
>> +                             goto out;
>> +
>> +                     add += pcm_data->bus_width;
>> +                     tot_len += pcm_data->bus_width;
>> +             } else {                /* do buffer program */
>> +                     current_len = min(target_len - tot_len,
>> +                             (u_long) mtd->writesize);
>> +                     ret = lpddr2_nvm_do_op(map, LPDDR2_NVM_BUF_OVERWRITE,
>> +                             0x00, add, current_len, write_buf + tot_len);
>> +                     if (ret)
>> +                             goto out;
>> +
>> +                     add += current_len;
>> +                     tot_len += current_len;
>> +             }
>> +     }
>> +
>> +out:
>> +     *retlen = tot_len;
>> +     ow_disable(map);
>> +     mutex_unlock(&lpdd2_nvm_mutex);
>> +     return ret;
>> +}
>> +
>> +/*
>> + * lpddr2_nvm driver erase method
>> + */
>> +static int lpddr2_nvm_erase(struct mtd_info *mtd, struct erase_info *instr)
>> +{
>> +     int ret = lpddr2_nvm_do_block_op(mtd, instr->addr, instr->len,
>> +             LPDDR2_NVM_ERASE);
>> +     if (!ret) {
>> +             instr->state = MTD_ERASE_DONE;
>> +             mtd_erase_callback(instr);
>> +     }
>> +
>> +     return ret;
>> +}
>> +
>> +/*
>> + * lpddr2_nvm driver unlock method
>> + */
>> +static int lpddr2_nvm_unlock(struct mtd_info *mtd, loff_t start_add,
>> +     uint64_t len)
>> +{
>> +     return lpddr2_nvm_do_block_op(mtd, start_add, len, LPDDR2_NVM_UNLOCK);
>> +}
>> +
>> +/*
>> + * lpddr2_nvm driver lock method
>> + */
>> +static int lpddr2_nvm_lock(struct mtd_info *mtd, loff_t start_add,
>> +     uint64_t len)
>> +{
>> +     return lpddr2_nvm_do_block_op(mtd, start_add, len, LPDDR2_NVM_LOCK);
>> +}
>> +
>> +/*
>> + * lpddr2_nvm driver probe method
>> + */
>> +static int lpddr2_nvm_probe(struct platform_device *pdev)
>> +{
>> +     struct map_info *map;
>> +     struct mtd_info *mtd;
>> +     struct resource *add_range = platform_get_resource(pdev,
>> +                                             IORESOURCE_MEM, 0);
>> +     struct resource *control_regs = platform_get_resource(pdev,
>> +                                             IORESOURCE_MEM, 1);
>> +     struct resource *buswidth = platform_get_resource(pdev,
>> +                                             IORESOURCE_BUS, 0);
>
> This doesn't look right. You're using an IORESOURCE_BUS to represent
> your bus width?
>
> Are you using device-tree or traditional platform_device for
> initializing this driver?
>

VA: I understand now; I use platform_device to initialize. So what do
you suggest to pass
this parameter to the driver in the cleanest way?

>> +     struct pcm_int_data *pcm_data;
>> +
>> +     /* Allocate memory control_regs data structures */
>> +     pcm_data = devm_kzalloc(&pdev->dev, sizeof(*pcm_data), GFP_KERNEL);
>> +     if (!pcm_data)
>> +             return -ENOMEM;
>> +     pcm_data->reg_data =    (void *) control_regs->start;
>> +     pcm_data->reg_cfg =     (void *) control_regs->end;
>
> This seems like an abuse of the 'resource' construct; you're
> representing two register addresses as the start/end of a resource?
> Typically, device drivers will represent their device register space(s)
> as contiguous resources, and the driver will know the register offsets
> themselves. So you would do:
>
>         struct resource *res;
>         /* Get control registers */
>         res = platform_get_resource(pdev, IOIRESOURCE_MEM, 1);
>         pcm_data->ctl_regs = devm_ioremap_resource(&pdev->dev, res);
>         if (IS_ERR(pcm_data->ctl_regs))
>                 return ERR_PTR(pcm_data->ctl_regs);
>
> Then you'd access your registers with some fixed offsets:
>
>         writel(val1, pcm_data->ctl_regs + LPDDR2_NVM_CONTROL_DATA);
>         writel(val2, pcm_data->ctl_regs + LPDDR2_NVM_CONTROL_CFG);
>
> Does this model not work for you?
>

VA: I guess this is more clean; I'll try to implement in the new
release I'm working on

>> +     pcm_data->bus_width =   (int) buswidth->start;
>> +
>> +     /* Allocate memory for map_info & mtd_info data structures */
>> +     map = devm_kzalloc(&pdev->dev, sizeof(*map), GFP_KERNEL);
>> +     if (!map)
>> +             return -ENOMEM;
>> +
>> +     mtd = devm_kzalloc(&pdev->dev, sizeof(*mtd), GFP_KERNEL);
>> +     if (!mtd)
>> +             return -ENOMEM;
>> +
>> +     /* Reserve lpddr2_nvm address range */
>> +     if (devm_request_mem_region(&pdev->dev, add_range->start,
>> +             (add_range->end - add_range->start + 1),
>
> That can be resource_size(add_range). Or just combine the request_mem
> with the ioremap (later) and use devm_ioremap_resource(). This saves you
> some error handling and other boilerplate.
>

VA: OK will do, looks much more clean

>> +             "lpddr2_nvm") == NULL) {
>> +             pr_err("Unable to reserve address range\n");
>> +             return -EBUSY;
>> +     }
>> +
>> +     /* Populate map_info data structure */
>> +     *map = (struct map_info) {
>> +             .virt           = devm_ioremap_nocache(&pdev->dev,
>> +                             add_range->start, (add_range->end -
>> +                             add_range->start + 1)),
>> +             .name           = pdev->dev.init_name,
>> +             .phys           = add_range->start,
>> +             .size           = add_range->end - add_range->start + 1,
>
> resource_size()
>
>> +             .bankwidth      = pcm_data->bus_width/2,
>> +             .pfow_base      = OW_BASE_ADDRESS,
>> +             .fldrv_priv     = pcm_data,
>> +     };
>> +
>> +     simple_map_init(map);   /* fill with default methods */
>> +
>> +     /* Populate mtd_info data structure */
>> +     *mtd = (struct mtd_info) {
>> +             .name           = pdev->dev.init_name,
>> +             .type           = MTD_RAM,
>> +             .priv           = map,
>> +             .size           = add_range->end - add_range->start + 1,
>
> resource_size(add_range)
>
>> +             .erasesize      = ERASE_BLOCKSIZE * pcm_data->bus_width,
>
> The eraseblock size is dependent on the bus width? That's odd.
>
>> +             .writesize      = 1,
>> +             .writebufsize   = WRITE_BUFFSIZE * pcm_data->bus_width,
>
> Same here. Why does the bus width have anything to do with this?
>

VA: x32 bus width devices are only obtained staking two devices so
eraseblock and
writebufsize are doubled in x32 devices

>> +             .flags          = (MTD_CAP_NVRAM | MTD_POWERUP_LOCK),
>> +             ._read          = lpddr2_nvm_read,
>> +             ._write         = lpddr2_nvm_write,
>> +             ._erase         = lpddr2_nvm_erase,
>> +             ._unlock        = lpddr2_nvm_unlock,
>> +             ._lock          = lpddr2_nvm_lock,
>> +     };
>> +
>> +     /* Verify the presence of the device looking for PFOW string */
>> +     if (!lpddr2_nvm_pfow_present(map)) {
>> +             pr_err("device not recognized\n");
>> +             return -EINVAL;
>> +     }
>> +     /* Register the mtd_partition structure */
>> +     return mtd_add_partition(mtd, "my_pcm", 0x10000000, 0x00);
>
> Hmm, that's not right. You don't call mtd_add_partition() directly in a
> driver. How about:
>
>         mtd_device_parse_register(mtd, NULL, NULL, NULL, 0);
>
> ?
>
> At a minimum, users should be able to specify partitions (via
> cmdlinepart or ofpart; see default_mtd_part_types in
> drivers/mtd/mtdpart.c). If you need, you can also provide a default
> partition list via the 4th and 5th arguments (provided via platform_data
> or just fixed to a single "my_pcm" partition like you do here), if you
> must.
>

VA: ok thanks will do

>> +}
>> +
>> +/* Initialize platform_driver data structure for lpddr2_nvm */
>> +static struct platform_driver lpddr2_nvm_drv = {
>> +     .driver         = {
>> +             .name   = "lpddr2_nvm",
>> +     },
>> +     .probe          = lpddr2_nvm_probe,
>
> Can you provide a remove callback too? Otherwise, you won't be able to
> remove your .ko module (if you're using this as a module).
>

VA: ok will do; I'm look to some different examples and try to
implement in the right way

>> +};
>> +
>> +module_platform_driver(lpddr2_nvm_drv);
>> +MODULE_LICENSE("GPL");
>> +MODULE_AUTHOR("Vincenzo Aliberti <vincenzo.aliberti@gmail.com>");
>> +MODULE_DESCRIPTION("MTD driver for LPDDR2-NVM PCM memories");
>> diff --git a/include/uapi/mtd/mtd-abi.h b/include/uapi/mtd/mtd-abi.h
>> index 36eace0..8a2bbf2 100644
>> --- a/include/uapi/mtd/mtd-abi.h
>> +++ b/include/uapi/mtd/mtd-abi.h
>> @@ -107,6 +107,7 @@ struct mtd_write_req {
>>  /* Some common devices / combinations of capabilities */
>>  #define MTD_CAP_ROM          0
>>  #define MTD_CAP_RAM          (MTD_WRITEABLE | MTD_BIT_WRITEABLE | MTD_NO_ERASE)
>> +#define MTD_CAP_NVRAM                (MTD_WRITEABLE | MTD_BIT_WRITEABLE | MTD_NO_ERASE)
>>  #define MTD_CAP_NORFLASH     (MTD_WRITEABLE | MTD_BIT_WRITEABLE)
>>  #define MTD_CAP_NANDFLASH    (MTD_WRITEABLE)
>>
>
> Brian

Vincenzo
Vincenzo Aliberti May 6, 2014, 10:25 a.m. UTC | #9
Fixed item on buswidth parameter to pass to the driver: no longer required
as all devices and host works only x32

On Wed, Apr 23, 2014 at 12:03 PM, Vincenzo Aliberti
<vincenzo.aliberti@gmail.com> wrote:
> Brian,
>    thanks for your help! Here-after my feedback
>
> On Wed, Apr 16, 2014 at 8:03 AM, Brian Norris
> <computersforpeace@gmail.com> wrote:
>> Hi Vincenzo,
>>
>> On Mon, Mar 03, 2014 at 10:44:33PM +0100, Vincenzo Aliberti wrote:
>>> Hi Brian,
>>>    here-below the version of driver modified as per your
>>> kind suggestion.
>>
>> Thanks for the update. I have a few comments below. In the future,
>> please provide only the patch description here (that goes in the
>> change-log), and any side comments can go below.
>>
>
> VA: OK, clear now
>
>>> Regards,
>>>    Vincenzo
>>>
>>> Signed-off-by: Vincenzo Aliberti <vincenzo.aliberti@gmail.com>
>>>
>>> ---
>>
>> Stuff that doesn't need to go in the change-log can go here (below the 3
>> hyphen line '---').
>>
>> Also, can you provide a subject that begins with [PATCH vX], where X is
>> the version (e.g., your next patch should actually be [PATCH v3]), and
>> include here (below the line) a short description of what changed? e.g.:
>>
>>   changes in v3:
>>       - addressed foo comment
>>       - fixed bar bug
>>       - resolved world hunger
>>
>
> VA: I'll rename in line with your suggestion and add changelog
>
>>>  drivers/mtd/lpddr/Kconfig      |   12 +-
>>>  drivers/mtd/lpddr/Makefile     |    1 +
>>>  drivers/mtd/lpddr/lpddr2_nvm.c |  504 ++++++++++++++++++++++++++++++++++++++++
>>>  include/uapi/mtd/mtd-abi.h     |    1 +
>>>  4 files changed, 516 insertions(+), 2 deletions(-)
>>>  create mode 100644 drivers/mtd/lpddr/lpddr2_nvm.c
>>>
>>> diff --git a/drivers/mtd/lpddr/Kconfig b/drivers/mtd/lpddr/Kconfig
>>> index 265f969..94a7f30 100644
>>> --- a/drivers/mtd/lpddr/Kconfig
>>> +++ b/drivers/mtd/lpddr/Kconfig
>>> @@ -1,5 +1,5 @@
>>> -menu "LPDDR flash memory drivers"
>>> -     depends on MTD!=n
>>> +menu "LPDDR & LPDDR2 PCM memory drivers"
>>> +     depends on MTD
>>>
>>>  config MTD_LPDDR
>>>       tristate "Support for LPDDR flash chips"
>>> @@ -17,4 +17,12 @@ config MTD_QINFO_PROBE
>>>           Window QINFO interface, permits software to be used for entire
>>>           families of devices. This serves similar purpose of CFI on legacy
>>>           Flash products
>>> +
>>> +config MTD_LPDDR2_NVM
>>> +     depends on MTD && ARM
>>> +     tristate "Support for LPDDR2-NVM flash chips"
>>> +     help
>>> +       This option enables support of PCM memories with a LPDDR2-NVM
>>> +       (Low power double data rate 2) interface.
>>> +
>>>  endmenu
>>> diff --git a/drivers/mtd/lpddr/Makefile b/drivers/mtd/lpddr/Makefile
>>> index da48e46..881d440 100644
>>> --- a/drivers/mtd/lpddr/Makefile
>>> +++ b/drivers/mtd/lpddr/Makefile
>>> @@ -4,3 +4,4 @@
>>>
>>>  obj-$(CONFIG_MTD_QINFO_PROBE)        += qinfo_probe.o
>>>  obj-$(CONFIG_MTD_LPDDR)      += lpddr_cmds.o
>>> +obj-$(CONFIG_MTD_LPDDR2_NVM) += lpddr2_nvm.o
>>> diff --git a/drivers/mtd/lpddr/lpddr2_nvm.c b/drivers/mtd/lpddr/lpddr2_nvm.c
>>> new file mode 100644
>>> index 0000000..5d52c47
>>> --- /dev/null
>>> +++ b/drivers/mtd/lpddr/lpddr2_nvm.c
>>> @@ -0,0 +1,504 @@
>>> +/*
>>> + * LPDDR2-NVM MTD driver. This module provides read, write, erase, lock/unlock
>>> + * support for LPDDR2-NVM PCM memories
>>> + *
>>> + * Copyright © 2012 Micron Technology, Inc.
>>> + *
>>> + * Vincenzo Aliberti <vincenzo.aliberti@gmail.com>
>>> + * Domenico Manna <domenico.manna@gmail.com>
>>> + * Many thanks to Andrea Vigilante for initial enabling
>>> + *
>>> + * This program is free software; you can redistribute it and/or
>>> + * modify it under the terms of the GNU General Public License
>>> + * as published by the Free Software Foundation; either version 2
>>> + * of the License, or (at your option) any later version.
>>> + *
>>> + * This program is distributed in the hope that it will be useful,
>>> + * but WITHOUT ANY WARRANTY; without even the implied warranty of
>>> + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
>>> + * GNU General Public License for more details.
>>> + *
>>> + * You should have received a copy of the GNU General Public License
>>> + * along with this program; if not, write to the Free Software
>>> + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
>>> + * 02110-1301, USA.
>>
>> Drop the paragraph about the FSF address. checkpatch.pl warns you that
>> this address may change, and is not needed.
>>
>
> VA: OK will do
>
>>> + */
>>> +
>>> +#define pr_fmt(fmt) KBUILD_MODNAME ": %s: " fmt, __func__
>>> +
>>> +#include <linux/init.h>
>>> +#include <linux/io.h>
>>> +#include <linux/module.h>
>>> +#include <linux/kernel.h>
>>> +#include <linux/mtd/map.h>
>>> +#include <linux/mtd/mtd.h>
>>> +#include <linux/mtd/partitions.h>
>>> +#include <linux/slab.h>
>>> +#include <linux/platform_device.h>
>>> +#include <linux/ioport.h>
>>> +#include <linux/sched.h>
>>> +
>>> +/* Parameters */
>>> +#define ERASE_BLOCKSIZE                      (0x00020000/2)  /* in Word */
>>> +#define WRITE_BUFFSIZE                       (0x00000400/2)  /* in Word */
>>> +#define OW_BASE_ADDRESS                      0x00000000      /* OW offset */
>>> +
>>> +/* PFOW symbols address offset */
>>> +#define PFOW_QUERY_STRING_P          (0x0000/2)      /* in Word */
>>> +#define PFOW_QUERY_STRING_F          (0x0002/2)      /* in Word */
>>> +#define PFOW_QUERY_STRING_O          (0x0004/2)      /* in Word */
>>> +#define PFOW_QUERY_STRING_W          (0x0006/2)      /* in Word */
>>> +
>>> +/* OW registers address */
>>> +#define CMD_CODE_OFS                 (0x0080/2)      /* in Word */
>>> +#define CMD_DATA_OFS                 (0x0084/2)      /* in Word */
>>> +#define CMD_ADD_L_OFS                        (0x0088/2)      /* in Word */
>>> +#define CMD_ADD_H_OFS                        (0x008A/2)      /* in Word */
>>> +#define MPR_L_OFS                    (0x0090/2)      /* in Word */
>>> +#define MPR_H_OFS                    (0x0092/2)      /* in Word */
>>> +#define CMD_EXEC_OFS                 (0x00C0/2)      /* in Word */
>>> +#define STATUS_REG_OFS                       (0x00CC/2)      /* in Word */
>>> +#define PRG_BUFFER_OFS                       (0x0010/2)      /* in Word */
>>> +
>>> +/* Datamask */
>>> +#define MR_CFGMASK                   0x8000
>>> +#define SR_OK_DATAMASK                       0x0080
>>> +
>>> +/* LPDDR2-NVM Commands */
>>> +#define LPDDR2_NVM_LOCK                      0x0061
>>> +#define LPDDR2_NVM_UNLOCK            0x0062
>>> +#define LPDDR2_NVM_SW_PROGRAM                0x0041
>>> +#define LPDDR2_NVM_SW_OVERWRITE              0x0042
>>> +#define LPDDR2_NVM_BUF_PROGRAM               0x00E9
>>> +#define LPDDR2_NVM_BUF_OVERWRITE     0x00EA
>>> +#define LPDDR2_NVM_ERASE             0x0020
>>> +
>>> +/*
>>> + * Internal Type Definitions
>>> + * pcm_int_data contains memory controller details:
>>> + * @reg_data : LPDDR2_MODE_REG_DATA register address after remapping
>>> + * @reg_cfg  : LPDDR2_MODE_REG_CFG register address after remapping
>>> + * &bus_width: memory bus-width (eg: x16 2 Bytes, x32 4 Bytes)
>>> + */
>>> +struct pcm_int_data {
>>> +     void __iomem *reg_data;
>>> +     void __iomem *reg_cfg;
>>> +     int bus_width;
>>> +};
>>> +
>>> +static DEFINE_MUTEX(lpdd2_nvm_mutex);
>>> +
>>> +/*
>>> + * Build a map_word starting from an u_long
>>> + */
>>> +static inline map_word build_map_word(u_long myword)
>>> +{
>>> +     map_word val = { {0} };
>>> +     val.x[0] = myword;
>>> +     return val;
>>> +}
>>> +
>>> +/*
>>> + * Build Mode Register Configuration DataMask based on device bus-width
>>> + */
>>> +static inline u_int build_mr_cfgmask(u_int bus_width)
>>> +{
>>> +     u_int val = MR_CFGMASK;
>>> +
>>> +     if (bus_width == 0x0004)                /* x32 device */
>>> +             val = val << 16;
>>> +
>>> +     return val;
>>> +}
>>> +
>>> +/*
>>> + * Build Status Register OK DataMask based on device bus-width
>>> + */
>>> +static inline u_int build_sr_ok_datamask(u_int bus_width)
>>> +{
>>> +     u_int val = SR_OK_DATAMASK;
>>> +
>>> +     if (bus_width == 0x0004)                /* x32 device */
>>> +             val = (val << 16)+val;
>>> +
>>> +     return val;
>>> +}
>>> +
>>> +/*
>>> + * Evaluates Overlay Window Control Registers address
>>> + */
>>> +static inline u_long ow_reg_add(struct map_info *map, u_long offset)
>>> +{
>>> +     u_long val = 0;
>>> +     struct pcm_int_data *pcm_data = map->fldrv_priv;
>>> +
>>> +     val = map->pfow_base + offset*pcm_data->bus_width;
>>> +
>>> +     return val;
>>> +}
>>> +
>>> +/*
>>> + * Enable lpddr2-nvm Overlay Window
>>> + * Overlay Window is a memory mapped area containing all LPDDR2-NVM registers
>>> + * used by device commands as well as uservisible resources like Device Status
>>> + * Register, Device ID, etc
>>> + */
>>> +static inline void ow_enable(struct map_info *map)
>>> +{
>>> +     struct pcm_int_data *pcm_data = map->fldrv_priv;
>>> +
>>> +     writel_relaxed(build_mr_cfgmask(pcm_data->bus_width) | 0x18,
>>> +             pcm_data->reg_cfg);
>>> +     writel_relaxed(0x01, pcm_data->reg_data);
>>> +}
>>> +
>>> +/*
>>> + * Disable lpddr2-nvm Overlay Window
>>> + * Overlay Window is a memory mapped area containing all LPDDR2-NVM registers
>>> + * used by device commands as well as uservisible resources like Device Status
>>> + * Register, Device ID, etc
>>> + */
>>> +static inline void ow_disable(struct map_info *map)
>>> +{
>>> +     struct pcm_int_data *pcm_data = map->fldrv_priv;
>>> +
>>> +     writel_relaxed(build_mr_cfgmask(pcm_data->bus_width) | 0x18,
>>> +             pcm_data->reg_cfg);
>>> +     writel_relaxed(0x02, pcm_data->reg_data);
>>> +}
>>> +
>>> +/*
>>> + * Execute lpddr2-nvm operations
>>> + */
>>> +static int lpddr2_nvm_do_op(struct map_info *map, u_long cmd_code,
>>> +     u_long cmd_data, u_long cmd_add, u_long cmd_mpr, u_char *buf)
>>> +{
>>> +     map_word add_l = { {0} }, add_h = { {0} }, mpr_l = { {0} },
>>> +             mpr_h = { {0} }, data_l = { {0} }, cmd = { {0} },
>>> +             exec_cmd = { {0} }, sr;
>>> +     map_word data_h = { {0} };      /* only for 2x x16 devices stacked */
>>> +     u_long i, status_reg, prg_buff_ofs;
>>> +     struct pcm_int_data *pcm_data = map->fldrv_priv;
>>> +     u_int sr_ok_datamask = build_sr_ok_datamask(pcm_data->bus_width);
>>> +
>>> +     /* Builds low and high words for OW Control Registers */
>>> +     add_l.x[0]      = cmd_add & 0x0000FFFF;
>>> +     add_h.x[0]      = (cmd_add >> 16) & 0x0000FFFF;
>>> +     mpr_l.x[0]      = cmd_mpr & 0x0000FFFF;
>>> +     mpr_h.x[0]      = (cmd_mpr >> 16) & 0x0000FFFF;
>>> +     cmd.x[0]        = cmd_code & 0x0000FFFF;
>>> +     exec_cmd.x[0]   = 0x0001;
>>> +     data_l.x[0]     = cmd_data & 0x0000FFFF;
>>> +     data_h.x[0]     = (cmd_data >> 16) & 0x0000FFFF; /* only for 2x x16 */
>>> +
>>> +     /* Set Overlay Window Control Registers */
>>> +     map_write(map, cmd, ow_reg_add(map, CMD_CODE_OFS));
>>> +     map_write(map, data_l, ow_reg_add(map, CMD_DATA_OFS));
>>> +     map_write(map, add_l, ow_reg_add(map, CMD_ADD_L_OFS));
>>> +     map_write(map, add_h, ow_reg_add(map, CMD_ADD_H_OFS));
>>> +     map_write(map, mpr_l, ow_reg_add(map, MPR_L_OFS));
>>> +     map_write(map, mpr_h, ow_reg_add(map, MPR_H_OFS));
>>> +     if (pcm_data->bus_width == 0x0004) {    /* 2x16 devices stacked */
>>> +             map_write(map, cmd, ow_reg_add(map, CMD_CODE_OFS) + 2);
>>> +             map_write(map, data_h, ow_reg_add(map, CMD_DATA_OFS) + 2);
>>> +             map_write(map, add_l, ow_reg_add(map, CMD_ADD_L_OFS) + 2);
>>> +             map_write(map, add_h, ow_reg_add(map, CMD_ADD_H_OFS) + 2);
>>> +             map_write(map, mpr_l, ow_reg_add(map, MPR_L_OFS) + 2);
>>> +             map_write(map, mpr_h, ow_reg_add(map, MPR_H_OFS) + 2);
>>> +     }
>>> +
>>> +     /* Fill Program Buffer */
>>> +     if ((cmd_code == LPDDR2_NVM_BUF_PROGRAM) ||
>>> +             (cmd_code == LPDDR2_NVM_BUF_OVERWRITE)) {
>>> +             prg_buff_ofs = (map_read(map,
>>> +                     ow_reg_add(map, PRG_BUFFER_OFS))).x[0];
>>> +             for (i = 0; i < cmd_mpr; i++) {
>>> +                     map_write(map, build_map_word(buf[i]), map->pfow_base +
>>> +                     prg_buff_ofs + i);
>>> +             }
>>> +     }
>>> +
>>> +     /* Command Execute */
>>> +     map_write(map, exec_cmd, ow_reg_add(map, CMD_EXEC_OFS));
>>> +     if (pcm_data->bus_width == 0x0004)      /* 2x16 devices stacked */
>>> +             map_write(map, exec_cmd, ow_reg_add(map, CMD_EXEC_OFS) + 2);
>>> +
>>> +     /* Status Register Check */
>>> +     do {
>>> +             sr = map_read(map, ow_reg_add(map, STATUS_REG_OFS));
>>> +             status_reg = sr.x[0];
>>> +             if (pcm_data->bus_width == 0x0004) {/* 2x16 devices stacked */
>>> +                     sr = map_read(map, ow_reg_add(map,
>>> +                             STATUS_REG_OFS) + 2);
>>> +                     status_reg += sr.x[0] << 16;
>>> +             }
>>> +     } while ((status_reg & sr_ok_datamask) != sr_ok_datamask);
>>> +
>>> +     return (((status_reg & sr_ok_datamask) == sr_ok_datamask) ? 0 : -EIO);
>>> +}
>>> +
>>> +/*
>>> + * Execute lpddr2-nvm operations @ block level
>>> + */
>>> +static int lpddr2_nvm_do_block_op(struct mtd_info *mtd, loff_t start_add,
>>> +     uint64_t len, u_char block_op)
>>> +{
>>> +     struct map_info *map = mtd->priv;
>>> +     u_long add, end_add;
>>> +     int ret = 0;
>>> +
>>> +     mutex_lock(&lpdd2_nvm_mutex);
>>> +
>>> +     ow_enable(map);
>>> +
>>> +     add = start_add;
>>> +     end_add = add + len;
>>> +
>>> +     do {
>>> +             ret = lpddr2_nvm_do_op(map, block_op, 0x00, add, add, NULL);
>>> +             if (ret)
>>> +                     goto out;
>>> +             add += mtd->erasesize;
>>> +     } while (add < end_add);
>>> +
>>> +out:
>>> +     ow_disable(map);
>>> +     mutex_unlock(&lpdd2_nvm_mutex);
>>> +     return ret;
>>> +}
>>> +
>>> +/*
>>> + * verify presence of PFOW string
>>> + */
>>> +static int lpddr2_nvm_pfow_present(struct map_info *map)
>>> +{
>>> +     map_word pfow_val[4];
>>> +     unsigned int found = 1;
>>> +
>>> +     mutex_lock(&lpdd2_nvm_mutex);
>>> +
>>> +     ow_enable(map);
>>> +
>>> +     /* Load string from array */
>>> +     pfow_val[0] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_P));
>>> +     pfow_val[1] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_F));
>>> +     pfow_val[2] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_O));
>>> +     pfow_val[3] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_W));
>>> +
>>> +     /* Verify the string loaded vs expected */
>>> +     if (!map_word_equal(map, build_map_word('P'), pfow_val[0]))
>>> +             found = 0;
>>> +     if (!map_word_equal(map, build_map_word('F'), pfow_val[1]))
>>> +             found = 0;
>>> +     if (!map_word_equal(map, build_map_word('O'), pfow_val[2]))
>>> +             found = 0;
>>> +     if (!map_word_equal(map, build_map_word('W'), pfow_val[3]))
>>> +             found = 0;
>>> +
>>> +     ow_disable(map);
>>> +
>>> +     mutex_unlock(&lpdd2_nvm_mutex);
>>> +
>>> +     return found;
>>> +}
>>> +
>>> +/*
>>> + * lpddr2_nvm driver read method
>>> + */
>>> +static int lpddr2_nvm_read(struct mtd_info *mtd, loff_t start_add,
>>> +                             size_t len, size_t *retlen, u_char *buf)
>>> +{
>>> +     struct map_info *map = mtd->priv;
>>> +
>>> +     mutex_lock(&lpdd2_nvm_mutex);
>>> +
>>> +     *retlen = len;
>>> +
>>> +     map_copy_from(map, buf, start_add, *retlen);
>>> +
>>> +     mutex_unlock(&lpdd2_nvm_mutex);
>>> +     return 0;
>>> +}
>>> +
>>> +/*
>>> + * lpddr2_nvm driver write method
>>> + */
>>> +static int lpddr2_nvm_write(struct mtd_info *mtd, loff_t start_add,
>>> +                             size_t len, size_t *retlen, const u_char *buf)
>>> +{
>>> +     struct map_info *map = mtd->priv;
>>> +     struct pcm_int_data *pcm_data = map->fldrv_priv;
>>> +     u_long add, current_len, tot_len, target_len, my_data;
>>> +     u_char *write_buf = (u_char *)buf;
>>> +     int ret = 0;
>>> +
>>> +     mutex_lock(&lpdd2_nvm_mutex);
>>> +
>>> +     ow_enable(map);
>>> +
>>> +     /* Set start value for the variables */
>>> +     add = start_add;
>>> +     target_len = len;
>>> +     tot_len = 0;
>>> +
>>> +     while (tot_len < target_len) {
>>> +             if (!(IS_ALIGNED(add, mtd->writesize))) { /* do sw program */
>>> +                     my_data = write_buf[tot_len];
>>> +                     my_data += (write_buf[tot_len+1]) << 8;
>>> +                     if (pcm_data->bus_width == 0x0004) {/* 2x16 devices */
>>> +                             my_data += (write_buf[tot_len+2]) << 16;
>>> +                             my_data += (write_buf[tot_len+3]) << 24;
>>> +                     }
>>> +                     ret = lpddr2_nvm_do_op(map, LPDDR2_NVM_SW_OVERWRITE,
>>> +                             my_data, add, 0x00, NULL);
>>> +                     if (ret)
>>> +                             goto out;
>>> +
>>> +                     add += pcm_data->bus_width;
>>> +                     tot_len += pcm_data->bus_width;
>>> +             } else {                /* do buffer program */
>>> +                     current_len = min(target_len - tot_len,
>>> +                             (u_long) mtd->writesize);
>>> +                     ret = lpddr2_nvm_do_op(map, LPDDR2_NVM_BUF_OVERWRITE,
>>> +                             0x00, add, current_len, write_buf + tot_len);
>>> +                     if (ret)
>>> +                             goto out;
>>> +
>>> +                     add += current_len;
>>> +                     tot_len += current_len;
>>> +             }
>>> +     }
>>> +
>>> +out:
>>> +     *retlen = tot_len;
>>> +     ow_disable(map);
>>> +     mutex_unlock(&lpdd2_nvm_mutex);
>>> +     return ret;
>>> +}
>>> +
>>> +/*
>>> + * lpddr2_nvm driver erase method
>>> + */
>>> +static int lpddr2_nvm_erase(struct mtd_info *mtd, struct erase_info *instr)
>>> +{
>>> +     int ret = lpddr2_nvm_do_block_op(mtd, instr->addr, instr->len,
>>> +             LPDDR2_NVM_ERASE);
>>> +     if (!ret) {
>>> +             instr->state = MTD_ERASE_DONE;
>>> +             mtd_erase_callback(instr);
>>> +     }
>>> +
>>> +     return ret;
>>> +}
>>> +
>>> +/*
>>> + * lpddr2_nvm driver unlock method
>>> + */
>>> +static int lpddr2_nvm_unlock(struct mtd_info *mtd, loff_t start_add,
>>> +     uint64_t len)
>>> +{
>>> +     return lpddr2_nvm_do_block_op(mtd, start_add, len, LPDDR2_NVM_UNLOCK);
>>> +}
>>> +
>>> +/*
>>> + * lpddr2_nvm driver lock method
>>> + */
>>> +static int lpddr2_nvm_lock(struct mtd_info *mtd, loff_t start_add,
>>> +     uint64_t len)
>>> +{
>>> +     return lpddr2_nvm_do_block_op(mtd, start_add, len, LPDDR2_NVM_LOCK);
>>> +}
>>> +
>>> +/*
>>> + * lpddr2_nvm driver probe method
>>> + */
>>> +static int lpddr2_nvm_probe(struct platform_device *pdev)
>>> +{
>>> +     struct map_info *map;
>>> +     struct mtd_info *mtd;
>>> +     struct resource *add_range = platform_get_resource(pdev,
>>> +                                             IORESOURCE_MEM, 0);
>>> +     struct resource *control_regs = platform_get_resource(pdev,
>>> +                                             IORESOURCE_MEM, 1);
>>> +     struct resource *buswidth = platform_get_resource(pdev,
>>> +                                             IORESOURCE_BUS, 0);
>>
>> This doesn't look right. You're using an IORESOURCE_BUS to represent
>> your bus width?
>>
>> Are you using device-tree or traditional platform_device for
>> initializing this driver?
>>
>
> VA: I understand now; I use platform_device to initialize. So what do
> you suggest to pass
> this parameter to the driver in the cleanest way?
>
>>> +     struct pcm_int_data *pcm_data;
>>> +
>>> +     /* Allocate memory control_regs data structures */
>>> +     pcm_data = devm_kzalloc(&pdev->dev, sizeof(*pcm_data), GFP_KERNEL);
>>> +     if (!pcm_data)
>>> +             return -ENOMEM;
>>> +     pcm_data->reg_data =    (void *) control_regs->start;
>>> +     pcm_data->reg_cfg =     (void *) control_regs->end;
>>
>> This seems like an abuse of the 'resource' construct; you're
>> representing two register addresses as the start/end of a resource?
>> Typically, device drivers will represent their device register space(s)
>> as contiguous resources, and the driver will know the register offsets
>> themselves. So you would do:
>>
>>         struct resource *res;
>>         /* Get control registers */
>>         res = platform_get_resource(pdev, IOIRESOURCE_MEM, 1);
>>         pcm_data->ctl_regs = devm_ioremap_resource(&pdev->dev, res);
>>         if (IS_ERR(pcm_data->ctl_regs))
>>                 return ERR_PTR(pcm_data->ctl_regs);
>>
>> Then you'd access your registers with some fixed offsets:
>>
>>         writel(val1, pcm_data->ctl_regs + LPDDR2_NVM_CONTROL_DATA);
>>         writel(val2, pcm_data->ctl_regs + LPDDR2_NVM_CONTROL_CFG);
>>
>> Does this model not work for you?
>>
>
> VA: I guess this is more clean; I'll try to implement in the new
> release I'm working on
>
>>> +     pcm_data->bus_width =   (int) buswidth->start;
>>> +
>>> +     /* Allocate memory for map_info & mtd_info data structures */
>>> +     map = devm_kzalloc(&pdev->dev, sizeof(*map), GFP_KERNEL);
>>> +     if (!map)
>>> +             return -ENOMEM;
>>> +
>>> +     mtd = devm_kzalloc(&pdev->dev, sizeof(*mtd), GFP_KERNEL);
>>> +     if (!mtd)
>>> +             return -ENOMEM;
>>> +
>>> +     /* Reserve lpddr2_nvm address range */
>>> +     if (devm_request_mem_region(&pdev->dev, add_range->start,
>>> +             (add_range->end - add_range->start + 1),
>>
>> That can be resource_size(add_range). Or just combine the request_mem
>> with the ioremap (later) and use devm_ioremap_resource(). This saves you
>> some error handling and other boilerplate.
>>
>
> VA: OK will do, looks much more clean
>
>>> +             "lpddr2_nvm") == NULL) {
>>> +             pr_err("Unable to reserve address range\n");
>>> +             return -EBUSY;
>>> +     }
>>> +
>>> +     /* Populate map_info data structure */
>>> +     *map = (struct map_info) {
>>> +             .virt           = devm_ioremap_nocache(&pdev->dev,
>>> +                             add_range->start, (add_range->end -
>>> +                             add_range->start + 1)),
>>> +             .name           = pdev->dev.init_name,
>>> +             .phys           = add_range->start,
>>> +             .size           = add_range->end - add_range->start + 1,
>>
>> resource_size()
>>
>>> +             .bankwidth      = pcm_data->bus_width/2,
>>> +             .pfow_base      = OW_BASE_ADDRESS,
>>> +             .fldrv_priv     = pcm_data,
>>> +     };
>>> +
>>> +     simple_map_init(map);   /* fill with default methods */
>>> +
>>> +     /* Populate mtd_info data structure */
>>> +     *mtd = (struct mtd_info) {
>>> +             .name           = pdev->dev.init_name,
>>> +             .type           = MTD_RAM,
>>> +             .priv           = map,
>>> +             .size           = add_range->end - add_range->start + 1,
>>
>> resource_size(add_range)
>>
>>> +             .erasesize      = ERASE_BLOCKSIZE * pcm_data->bus_width,
>>
>> The eraseblock size is dependent on the bus width? That's odd.
>>
>>> +             .writesize      = 1,
>>> +             .writebufsize   = WRITE_BUFFSIZE * pcm_data->bus_width,
>>
>> Same here. Why does the bus width have anything to do with this?
>>
>
> VA: x32 bus width devices are only obtained staking two devices so
> eraseblock and
> writebufsize are doubled in x32 devices
>
>>> +             .flags          = (MTD_CAP_NVRAM | MTD_POWERUP_LOCK),
>>> +             ._read          = lpddr2_nvm_read,
>>> +             ._write         = lpddr2_nvm_write,
>>> +             ._erase         = lpddr2_nvm_erase,
>>> +             ._unlock        = lpddr2_nvm_unlock,
>>> +             ._lock          = lpddr2_nvm_lock,
>>> +     };
>>> +
>>> +     /* Verify the presence of the device looking for PFOW string */
>>> +     if (!lpddr2_nvm_pfow_present(map)) {
>>> +             pr_err("device not recognized\n");
>>> +             return -EINVAL;
>>> +     }
>>> +     /* Register the mtd_partition structure */
>>> +     return mtd_add_partition(mtd, "my_pcm", 0x10000000, 0x00);
>>
>> Hmm, that's not right. You don't call mtd_add_partition() directly in a
>> driver. How about:
>>
>>         mtd_device_parse_register(mtd, NULL, NULL, NULL, 0);
>>
>> ?
>>
>> At a minimum, users should be able to specify partitions (via
>> cmdlinepart or ofpart; see default_mtd_part_types in
>> drivers/mtd/mtdpart.c). If you need, you can also provide a default
>> partition list via the 4th and 5th arguments (provided via platform_data
>> or just fixed to a single "my_pcm" partition like you do here), if you
>> must.
>>
>
> VA: ok thanks will do
>
>>> +}
>>> +
>>> +/* Initialize platform_driver data structure for lpddr2_nvm */
>>> +static struct platform_driver lpddr2_nvm_drv = {
>>> +     .driver         = {
>>> +             .name   = "lpddr2_nvm",
>>> +     },
>>> +     .probe          = lpddr2_nvm_probe,
>>
>> Can you provide a remove callback too? Otherwise, you won't be able to
>> remove your .ko module (if you're using this as a module).
>>
>
> VA: ok will do; I'm look to some different examples and try to
> implement in the right way
>
>>> +};
>>> +
>>> +module_platform_driver(lpddr2_nvm_drv);
>>> +MODULE_LICENSE("GPL");
>>> +MODULE_AUTHOR("Vincenzo Aliberti <vincenzo.aliberti@gmail.com>");
>>> +MODULE_DESCRIPTION("MTD driver for LPDDR2-NVM PCM memories");
>>> diff --git a/include/uapi/mtd/mtd-abi.h b/include/uapi/mtd/mtd-abi.h
>>> index 36eace0..8a2bbf2 100644
>>> --- a/include/uapi/mtd/mtd-abi.h
>>> +++ b/include/uapi/mtd/mtd-abi.h
>>> @@ -107,6 +107,7 @@ struct mtd_write_req {
>>>  /* Some common devices / combinations of capabilities */
>>>  #define MTD_CAP_ROM          0
>>>  #define MTD_CAP_RAM          (MTD_WRITEABLE | MTD_BIT_WRITEABLE | MTD_NO_ERASE)
>>> +#define MTD_CAP_NVRAM                (MTD_WRITEABLE | MTD_BIT_WRITEABLE | MTD_NO_ERASE)
>>>  #define MTD_CAP_NORFLASH     (MTD_WRITEABLE | MTD_BIT_WRITEABLE)
>>>  #define MTD_CAP_NANDFLASH    (MTD_WRITEABLE)
>>>
>>
>> Brian
>
> Vincenzo
diff mbox

Patch

diff --git a/drivers/mtd/lpddr/Kconfig b/drivers/mtd/lpddr/Kconfig
index 265f969..94a7f30 100644
--- a/drivers/mtd/lpddr/Kconfig
+++ b/drivers/mtd/lpddr/Kconfig
@@ -1,5 +1,5 @@ 
-menu "LPDDR flash memory drivers"
-	depends on MTD!=n
+menu "LPDDR & LPDDR2 PCM memory drivers"
+	depends on MTD
 
 config MTD_LPDDR
 	tristate "Support for LPDDR flash chips"
@@ -17,4 +17,12 @@  config MTD_QINFO_PROBE
 	    Window QINFO interface, permits software to be used for entire
 	    families of devices. This serves similar purpose of CFI on legacy
 	    Flash products
+
+config MTD_LPDDR2_NVM
+	depends on MTD && ARM
+	tristate "Support for LPDDR2-NVM flash chips"
+	help
+	  This option enables support of PCM memories with a LPDDR2-NVM
+	  (Low power double data rate 2) interface.
+
 endmenu
diff --git a/drivers/mtd/lpddr/lpddr2_nvm.c b/drivers/mtd/lpddr/lpddr2_nvm.c
new file mode 100644
index 0000000..23377c8
--- /dev/null
+++ b/drivers/mtd/lpddr/lpddr2_nvm.c
@@ -0,0 +1,504 @@ 
+/*
+ * LPDDR2-NVM MTD driver. This module provides read, write, erase, lock/unlock
+ * support for LPDDR2-NVM PCM memories
+ *
+ * Copyright © 2012 Micron Technology, Inc.
+ *
+ * Vincenzo Aliberti <vincenzo.aliberti@gmail.com>
+ * Domenico Manna <domenico.manna@gmail.com>
+ * Many thanks to Andrea Vigilante for initial enabling
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License
+ * as published by the Free Software Foundation; either version 2
+ * of the License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
+ * 02110-1301, USA.
+ */
+
+#define pr_fmt(fmt) KBUILD_MODNAME ":%s: " fmt, __func__
+
+#include <linux/init.h>
+#include <linux/io.h>
+#include <linux/module.h>
+#include <linux/kernel.h>
+#include <linux/mtd/map.h>
+#include <linux/mtd/mtd.h>
+#include <linux/mtd/partitions.h>
+#include <linux/slab.h>
+#include <linux/platform_device.h>
+#include <linux/ioport.h>
+#include <linux/sched.h>
+
+/* Parameters */
+#define ERASE_BLOCKSIZE			(0x00020000/2)	/* in Word */
+#define WRITE_BUFFSIZE			(0x00000400/2)	/* in Word */
+#define OW_BASE_ADDRESS			0x00000000	/* OW offset */
+
+/* PFOW symbols address offset */
+#define PFOW_QUERY_STRING_P		(0x0000/2)	/* in Word */
+#define PFOW_QUERY_STRING_F		(0x0002/2)	/* in Word */
+#define PFOW_QUERY_STRING_O		(0x0004/2)	/* in Word */
+#define PFOW_QUERY_STRING_W		(0x0006/2)	/* in Word */
+
+/* OW registers address */
+#define CMD_CODE_OFS			(0x0080/2)	/* in Word */
+#define CMD_DATA_OFS			(0x0084/2)	/* in Word */
+#define CMD_ADD_L_OFS			(0x0088/2)	/* in Word */
+#define CMD_ADD_H_OFS			(0x008A/2)	/* in Word */
+#define MPR_L_OFS			(0x0090/2)	/* in Word */
+#define MPR_H_OFS			(0x0092/2)	/* in Word */
+#define CMD_EXEC_OFS			(0x00C0/2)	/* in Word */
+#define STATUS_REG_OFS			(0x00CC/2)	/* in Word */
+#define PRG_BUFFER_OFS			(0x0010/2)	/* in Word */
+
+/* Datamask */
+#define MR_CFGMASK			0x8000
+#define SR_OK_DATAMASK			0x0080
+
+/* LPDDR2-NVM Commands */
+#define LPDDR2_NVM_LOCK			0x0061
+#define LPDDR2_NVM_UNLOCK		0x0062
+#define LPDDR2_NVM_SW_PROGRAM		0x0041
+#define LPDDR2_NVM_SW_OVERWRITE		0x0042
+#define LPDDR2_NVM_BUF_PROGRAM		0x00E9
+#define LPDDR2_NVM_BUF_OVERWRITE	0x00EA
+#define LPDDR2_NVM_ERASE		0x0020
+
+/*
+ * Internal Type Definitions
+ * pcm_int_data contains memory controller details:
+ * @reg_data : LPDDR2_MODE_REG_DATA register address after remapping
+ * @reg_cfg  : LPDDR2_MODE_REG_CFG register address after remapping
+ * &bus_width: memory bus-width (eg: x16 2 Bytes, x32 4 Bytes)
+ */
+struct pcm_int_data {
+	void __iomem *reg_data;
+	void __iomem *reg_cfg;
+	int bus_width;
+};
+
+static DEFINE_MUTEX(lpdd2_nvm_mutex);
+
+/*
+ * Build a map_word starting from an u_long
+ */
+static inline map_word build_map_word(u_long myword)
+{
+	map_word val = { {0} };
+	val.x[0] = myword;
+	return val;
+}
+
+/*
+ * Build Mode Register Configuration DataMask based on device bus-width
+ */
+static inline u_int build_mr_cfgmask(u_int bus_width)
+{
+	u_int val = MR_CFGMASK;
+
+	if (bus_width == 0x0004)		/* x32 device */
+		val = val << 16;
+
+	return val;
+}
+
+/*
+ * Build Status Register OK DataMask based on device bus-width
+ */
+static inline u_int build_sr_ok_datamask(u_int bus_width)
+{
+	u_int val = SR_OK_DATAMASK;
+
+	if (bus_width == 0x0004)		/* x32 device */
+		val = (val << 16)+val;
+
+	return val;
+}
+
+/*
+ * Evaluates Overlay Window Control Registers address
+ */
+static inline u_long ow_reg_add(struct map_info *map, u_long offset)
+{
+	u_long val = 0;
+	struct pcm_int_data *pcm_data = map->fldrv_priv;
+
+	val = map->pfow_base + offset*pcm_data->bus_width;
+
+	return val;
+}
+
+/*
+ * Enable lpddr2-nvm Overlay Window
+ * Overlay Window is a memory mapped area containing all LPDDR2-NVM registers
+ * used by device commands as well as uservisible resources like Device Status
+ * Register, Device ID, etc
+ */
+static inline void ow_enable(struct map_info *map)
+{
+	struct pcm_int_data *pcm_data = map->fldrv_priv;
+
+	writel_relaxed(build_mr_cfgmask(pcm_data->bus_width) | 0x18,
+		pcm_data->reg_cfg);
+	writel_relaxed(0x01, pcm_data->reg_data);
+}
+
+/*
+ * Disable lpddr2-nvm Overlay Window
+ * Overlay Window is a memory mapped area containing all LPDDR2-NVM registers
+ * used by device commands as well as uservisible resources like Device Status
+ * Register, Device ID, etc
+ */
+static inline void ow_disable(struct map_info *map)
+{
+	struct pcm_int_data *pcm_data = map->fldrv_priv;
+
+	writel_relaxed(build_mr_cfgmask(pcm_data->bus_width) | 0x18,
+		pcm_data->reg_cfg);
+	writel_relaxed(0x02, pcm_data->reg_data);
+}
+
+/*
+ * Execute lpddr2-nvm operations
+ */
+static int lpddr2_nvm_do_op(struct map_info *map, u_long cmd_code,
+	u_long cmd_data, u_long cmd_add, u_long cmd_mpr, u_char *buf)
+{
+	map_word add_l = { {0} }, add_h = { {0} }, mpr_l = { {0} },
+		mpr_h = { {0} }, data_l = { {0} }, cmd = { {0} },
+		exec_cmd = { {0} }, sr;
+	map_word data_h = { {0} };	/* only for 2x x16 devices stacked */
+	u_long i, status_reg, prg_buff_ofs;
+	struct pcm_int_data *pcm_data = map->fldrv_priv;
+	u_int sr_ok_datamask = build_sr_ok_datamask(pcm_data->bus_width);
+
+	/* Builds low and high words for OW Control Registers */
+	add_l.x[0]	= cmd_add & 0x0000FFFF;
+	add_h.x[0]	= (cmd_add >> 16) & 0x0000FFFF;
+	mpr_l.x[0]	= cmd_mpr & 0x0000FFFF;
+	mpr_h.x[0]	= (cmd_mpr >> 16) & 0x0000FFFF;
+	cmd.x[0]	= cmd_code & 0x0000FFFF;
+	exec_cmd.x[0]	= 0x0001;
+	data_l.x[0]	= cmd_data & 0x0000FFFF;
+	data_h.x[0]	= (cmd_data >> 16) & 0x0000FFFF; /* only for 2x x16 */
+
+	/* Set Overlay Window Control Registers */
+	map_write(map, cmd, ow_reg_add(map, CMD_CODE_OFS));
+	map_write(map, data_l, ow_reg_add(map, CMD_DATA_OFS));
+	map_write(map, add_l, ow_reg_add(map, CMD_ADD_L_OFS));
+	map_write(map, add_h, ow_reg_add(map, CMD_ADD_H_OFS));
+	map_write(map, mpr_l, ow_reg_add(map, MPR_L_OFS));
+	map_write(map, mpr_h, ow_reg_add(map, MPR_H_OFS));
+	if (pcm_data->bus_width == 0x0004) {	/* 2x16 devices stacked */
+		map_write(map, cmd, ow_reg_add(map, CMD_CODE_OFS) + 2);
+		map_write(map, data_h, ow_reg_add(map, CMD_DATA_OFS) + 2);
+		map_write(map, add_l, ow_reg_add(map, CMD_ADD_L_OFS) + 2);
+		map_write(map, add_h, ow_reg_add(map, CMD_ADD_H_OFS) + 2);
+		map_write(map, mpr_l, ow_reg_add(map, MPR_L_OFS) + 2);
+		map_write(map, mpr_h, ow_reg_add(map, MPR_H_OFS) + 2);
+	}
+
+	/* Fill Program Buffer */
+	if ((cmd_code == LPDDR2_NVM_BUF_PROGRAM) ||
+		(cmd_code == LPDDR2_NVM_BUF_OVERWRITE)) {
+		prg_buff_ofs = (map_read(map,
+			ow_reg_add(map, PRG_BUFFER_OFS))).x[0];
+		for (i = 0; i < cmd_mpr; i++) {
+			map_write(map, build_map_word(buf[i]), map->pfow_base +
+			prg_buff_ofs + i);
+		}
+	}
+
+	/* Command Execute */
+	map_write(map, exec_cmd, ow_reg_add(map, CMD_EXEC_OFS));
+	if (pcm_data->bus_width == 0x0004)	/* 2x16 devices stacked */
+		map_write(map, exec_cmd, ow_reg_add(map, CMD_EXEC_OFS) + 2);
+
+	/* Status Register Check */
+	do {
+		sr = map_read(map, ow_reg_add(map, STATUS_REG_OFS));
+		status_reg = sr.x[0];
+		if (pcm_data->bus_width == 0x0004) {/* 2x16 devices stacked */
+			sr = map_read(map, ow_reg_add(map,
+				STATUS_REG_OFS) + 2);
+			status_reg += sr.x[0] << 16;
+		}
+	} while ((status_reg & sr_ok_datamask) != sr_ok_datamask);
+
+	return (((status_reg & sr_ok_datamask) == sr_ok_datamask) ? 0 : -EIO);
+}
+
+/*
+ * Execute lpddr2-nvm operations @ block level
+ */
+static int lpddr2_nvm_do_block_op(struct mtd_info *mtd, loff_t start_add,
+	uint64_t len, u_char block_op)
+{
+	struct map_info *map = mtd->priv;
+	u_long add, end_add;
+	int ret = 0;
+
+	mutex_lock(&lpdd2_nvm_mutex);
+
+	ow_enable(map);
+
+	add = start_add;
+	end_add = add + len;
+
+	do {
+		ret = lpddr2_nvm_do_op(map, block_op, 0x00, add, add, NULL);
+		if (ret)
+			goto out;
+		add += mtd->erasesize;
+	} while (add < end_add);
+
+out:
+	ow_disable(map);
+	mutex_unlock(&lpdd2_nvm_mutex);
+	return ret;
+}
+
+/*
+ * verify presence of PFOW string
+ */
+static int lpddr2_nvm_pfow_present(struct map_info *map)
+{
+	map_word pfow_val[4];
+	unsigned int found = 1;
+
+	mutex_lock(&lpdd2_nvm_mutex);
+
+	ow_enable(map);
+
+	/* Load string from array */
+	pfow_val[0] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_P));
+	pfow_val[1] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_F));
+	pfow_val[2] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_O));
+	pfow_val[3] = map_read(map, ow_reg_add(map, PFOW_QUERY_STRING_W));
+
+	/* Verify the string loaded vs expected */
+	if (!map_word_equal(map, build_map_word('P'), pfow_val[0]))
+		found = 0;
+	if (!map_word_equal(map, build_map_word('F'), pfow_val[1]))
+		found = 0;
+	if (!map_word_equal(map, build_map_word('O'), pfow_val[2]))
+		found = 0;
+	if (!map_word_equal(map, build_map_word('W'), pfow_val[3]))
+		found = 0;
+
+	ow_disable(map);
+
+	mutex_unlock(&lpdd2_nvm_mutex);
+
+	return found;
+}
+
+/*
+ * lpddr2_nvm driver read method
+ */
+static int lpddr2_nvm_read(struct mtd_info *mtd, loff_t start_add,
+				size_t len, size_t *retlen, u_char *buf)
+{
+	struct map_info *map = mtd->priv;
+
+	mutex_lock(&lpdd2_nvm_mutex);
+
+	*retlen = len;
+
+	map_copy_from(map, buf, start_add, *retlen);
+
+	mutex_unlock(&lpdd2_nvm_mutex);
+	return 0;
+}
+
+/*
+ * lpddr2_nvm driver write method
+ */
+static int lpddr2_nvm_write(struct mtd_info *mtd, loff_t start_add,
+				size_t len, size_t *retlen, const u_char *buf)
+{
+	struct map_info *map = mtd->priv;
+	struct pcm_int_data *pcm_data = map->fldrv_priv;
+	u_long add, current_len, tot_len, target_len, my_data;
+	u_char *write_buf = (u_char *)buf;
+	int ret = 0;
+
+	mutex_lock(&lpdd2_nvm_mutex);
+
+	ow_enable(map);
+
+	/* Set start value for the variables */
+	add = start_add;
+	target_len = len;
+	tot_len = 0;
+
+	while (tot_len < target_len) {
+		if (!(IS_ALIGNED(add, mtd->writesize))) { /* do sw program */
+			my_data = write_buf[tot_len];
+			my_data += (write_buf[tot_len+1]) << 8;
+			if (pcm_data->bus_width == 0x0004) {/* 2x16 devices */
+				my_data += (write_buf[tot_len+2]) << 16;
+				my_data += (write_buf[tot_len+3]) << 24;
+			}
+			ret = lpddr2_nvm_do_op(map, LPDDR2_NVM_SW_OVERWRITE,
+				my_data, add, 0x00, NULL);
+			if (ret)
+				goto out;
+
+			add += pcm_data->bus_width;
+			tot_len += pcm_data->bus_width;
+		} else {		/* do buffer program */
+			current_len = min(target_len - tot_len,
+				(u_long) mtd->writesize);
+			ret = lpddr2_nvm_do_op(map, LPDDR2_NVM_BUF_OVERWRITE,
+				0x00, add, current_len, write_buf + tot_len);
+			if (ret)
+				goto out;
+
+			add += current_len;
+			tot_len += current_len;
+		}
+	}
+
+out:
+	*retlen = tot_len;
+	ow_disable(map);
+	mutex_unlock(&lpdd2_nvm_mutex);
+	return ret;
+}
+
+/*
+ * lpddr2_nvm driver erase method
+ */
+static int lpddr2_nvm_erase(struct mtd_info *mtd, struct erase_info *instr)
+{
+	int ret = lpddr2_nvm_do_block_op(mtd, instr->addr, instr->len,
+		LPDDR2_NVM_ERASE);
+	if (!ret) {
+		instr->state = MTD_ERASE_DONE;
+		mtd_erase_callback(instr);
+	}
+
+	return ret;
+}
+
+/*
+ * lpddr2_nvm driver unlock method
+ */
+static int lpddr2_nvm_unlock(struct mtd_info *mtd, loff_t start_add,
+	uint64_t len)
+{
+	return lpddr2_nvm_do_block_op(mtd, start_add, len, LPDDR2_NVM_UNLOCK);
+}
+
+/*
+ * lpddr2_nvm driver lock method
+ */
+static int lpddr2_nvm_lock(struct mtd_info *mtd, loff_t start_add,
+	uint64_t len)
+{
+	return lpddr2_nvm_do_block_op(mtd, start_add, len, LPDDR2_NVM_LOCK);
+}
+
+/*
+ * lpddr2_nvm driver probe method
+ */
+static int lpddr2_nvm_probe(struct platform_device *pdev)
+{
+	struct map_info *map;
+	struct mtd_info *mtd;
+	struct resource *add_range = platform_get_resource(pdev,
+						IORESOURCE_MEM, 0);
+	struct resource *control_regs = platform_get_resource(pdev,
+						IORESOURCE_MEM, 1);
+	struct resource *buswidth = platform_get_resource(pdev,
+						IORESOURCE_BUS, 0);
+	struct pcm_int_data *pcm_data;
+
+	/* Allocate memory control_regs data structures */
+	pcm_data = devm_kzalloc(&pdev->dev, sizeof(*pcm_data), GFP_KERNEL);
+	if (!pcm_data)
+		return -ENOMEM;
+	pcm_data->reg_data =	(void *) control_regs->start;
+	pcm_data->reg_cfg =	(void *) control_regs->end;
+	pcm_data->bus_width =	(int) buswidth->start;
+
+	/* Allocate memory for map_info & mtd_info data structures */
+	map = devm_kzalloc(&pdev->dev, sizeof(*map), GFP_KERNEL);
+	if (!map)
+		return -ENOMEM;
+
+	mtd = devm_kzalloc(&pdev->dev, sizeof(*mtd), GFP_KERNEL);
+	if (!mtd)
+		return -ENOMEM;
+
+	/* Reserve lpddr2_nvm address range */
+	if (devm_request_mem_region(&pdev->dev, add_range->start,
+		(add_range->end - add_range->start + 1),
+		"lpddr2_nvm") == NULL) {
+		pr_err("Unable to reserve address range\n");
+		return -EBUSY;
+	}
+
+	/* Populate map_info data structure */
+	*map = (struct map_info) {
+		.virt		= devm_ioremap_nocache(&pdev->dev,
+				add_range->start, (add_range->end -
+				add_range->start a + 1)),
+		.name		= pdev->dev.init_name,
+		.phys		= add_range->start,
+		.size		= add_range->end - add_range->start + 1,
+		.bankwidth	= pcm_data->bus_width/2,
+		.pfow_base	= OW_BASE_ADDRESS,
+		.fldrv_priv	= pcm_data,
+	};
+
+	simple_map_init(map);	/* fill with default methods */
+
+	/* Populate mtd_info data structure */
+	*mtd = (struct mtd_info) {
+		.name		= pdev->dev.init_name,
+		.type		= MTD_RAM,
+		.priv		= map,
+		.size		= add_range->end - add_range->start + 1,
+		.erasesize	= ERASE_BLOCKSIZE * pcm_data->bus_width,
+		.writesize	= 1,
+		.writebufsize	= WRITE_BUFFSIZE * pcm_data->bus_width,
+		.flags		= (MTD_CAP_NVRAM | MTD_POWERUP_LOCK),
+		._read		= lpddr2_nvm_read,
+		._write		= lpddr2_nvm_write,
+		._erase		= lpddr2_nvm_erase,
+		._unlock	= lpddr2_nvm_unlock,
+		._lock		= lpddr2_nvm_lock,
+	};
+
+	/* Verify the presence of the device looking for PFOW string */
+	if (!lpddr2_nvm_pfow_present(map)) {
+		pr_err("device not recognized\n");
+		return -EINVAL;
+	}
+	/* Register the mtd_partition structure */
+	return mtd_add_partition(mtd, "my_pcm", 0x10000000, 0x00);
+}
+
+/* Initialize platform_driver data structure for lpddr2_nvm */
+static struct platform_driver lpddr2_nvm_drv = {
+	.driver		= {
+		.name	= "lpddr2_nvm",
+	},
+	.probe		= lpddr2_nvm_probe,
+};
+
+module_platform_driver(lpddr2_nvm_drv);
+MODULE_LICENSE("GPL");
+MODULE_AUTHOR("Vincenzo Aliberti <vincenzo.aliberti@gmail.com>");
+MODULE_DESCRIPTION("MTD driver for LPDDR2-NVM PCM memories");
diff --git a/include/uapi/mtd/mtd-abi.h b/include/uapi/mtd/mtd-abi.h
index 36eace0..8a2bbf2 100644
--- a/include/uapi/mtd/mtd-abi.h
+++ b/include/uapi/mtd/mtd-abi.h
@@ -107,6 +107,7 @@  struct mtd_write_req {
 /* Some common devices / combinations of capabilities */
 #define MTD_CAP_ROM		0
 #define MTD_CAP_RAM		(MTD_WRITEABLE | MTD_BIT_WRITEABLE | MTD_NO_ERASE)
+#define MTD_CAP_NVRAM		(MTD_WRITEABLE | MTD_BIT_WRITEABLE | MTD_NO_ERASE)
 #define MTD_CAP_NORFLASH	(MTD_WRITEABLE | MTD_BIT_WRITEABLE)
 #define MTD_CAP_NANDFLASH	(MTD_WRITEABLE)