Commit d1e1f4e4 authored by Florian Fainelli's avatar Florian Fainelli Committed by David Woodhouse
Browse files

mtd: nand: add support for reading ONFI parameters from NAND device 



This patch adds support for reading NAND device ONFI parameters and use
the ONFI informations to define its geometry. In case the device supports
ONFI, the onfi_version field in struct nand_chip contains the version (BCD)
and the onfi_params structure can be used by drivers to set up timings and
such. We currently only support ONFI 1.0 parameters.

Signed-off-by: default avatarBrian Norris <norris@broadcom.com>
Signed-off-by: default avatarMatthieu Castet <matthieu.castet@parrot.com>
Signed-off-by: default avatarMaxime Bizon <mbizon@freebox.fr>
Signed-off-by: default avatarFlorian Fainelli <ffainelli@freebox.fr>
Signed-off-by: default avatarDavid Woodhouse <David.Woodhouse@intel.com>
parent 42af8b58

drivers/mtd/nand/nand_base.c

+134 −30
Original line number Diff line number Diff line
@@ -2786,15 +2786,47 @@ static void nand_set_defaults(struct nand_chip *chip, int busw) 


}



/*

 * sanitize ONFI strings so we can safely print them

 */

static void sanitize_string(uint8_t *s, size_t len)

{

	ssize_t i;



	/* null terminate */

	s[len - 1] = 0;



	/* remove non printable chars */

	for (i = 0; i < len - 1; i++) {

		if (s[i] < ' ' || s[i] > 127)

			s[i] = '?';

	}



	/* remove trailing spaces */

	strim(s);

}



static u16 onfi_crc16(u16 crc, u8 const *p, size_t len)

{

	int i;

	while (len--) {

		crc ^= *p++ << 8;

		for (i = 0; i < 8; i++)

			crc = (crc << 1) ^ ((crc & 0x8000) ? 0x8005 : 0);

	}



	return crc;

}



/*

 * Get the flash and manufacturer id and lookup if the type is supported

 */

static struct nand_flash_dev *nand_get_flash_type(struct mtd_info *mtd,

						  struct nand_chip *chip,

						  int busw, int *maf_id,

						  int busw, int *maf_id, int *dev_id,

						  struct nand_flash_dev *type)

{

	int i, dev_id, maf_idx;

	int i, maf_idx;

	u8 id_data[8];



	/* Select the device */
@@ -2811,7 +2843,7 @@ static struct nand_flash_dev *nand_get_flash_type(struct mtd_info *mtd, 


	/* Read manufacturer and device IDs */

	*maf_id = chip->read_byte(mtd);

	dev_id = chip->read_byte(mtd);

	*dev_id = chip->read_byte(mtd);



	/* Try again to make sure, as some systems the bus-hold or other

	 * interface concerns can cause random data which looks like a
@@ -2821,15 +2853,13 @@ static struct nand_flash_dev *nand_get_flash_type(struct mtd_info *mtd, 


	chip->cmdfunc(mtd, NAND_CMD_READID, 0x00, -1);



	/* Read entire ID string */



	for (i = 0; i < 8; i++)

	for (i = 0; i < 2; i++)

		id_data[i] = chip->read_byte(mtd);



	if (id_data[0] != *maf_id || id_data[1] != dev_id) {

	if (id_data[0] != *maf_id || id_data[1] != *dev_id) {

		printk(KERN_INFO "%s: second ID read did not match "

		       "%02x,%02x against %02x,%02x\n", __func__,

		       *maf_id, dev_id, id_data[0], id_data[1]);

		       *maf_id, *dev_id, id_data[0], id_data[1]);

		return ERR_PTR(-ENODEV);

	}
@@ -2837,9 +2867,81 @@ static struct nand_flash_dev *nand_get_flash_type(struct mtd_info *mtd, 
		type = nand_flash_ids;



	for (; type->name != NULL; type++)

		if (dev_id == type->id)

		if (*dev_id == type->id)

                        break;



	chip->onfi_version = 0;

	if (!type->name || !type->pagesize) {

		/* try ONFI for unknow chip or LP */

		chip->cmdfunc(mtd, NAND_CMD_READID, 0x20, -1);

		if (chip->read_byte(mtd) == 'O' &&

			chip->read_byte(mtd) == 'N' &&

			chip->read_byte(mtd) == 'F' &&

			chip->read_byte(mtd) == 'I') {



			struct nand_onfi_params *p = &chip->onfi_params;

			int i;



			printk(KERN_INFO "ONFI flash detected\n");

			chip->cmdfunc(mtd, NAND_CMD_PARAM, 0, -1);

			for (i = 0; i < 3; i++) {

				chip->read_buf(mtd, (uint8_t *)p, sizeof(*p));

				if (onfi_crc16(ONFI_CRC_BASE, (uint8_t *)p, 254) ==

								le16_to_cpu(p->crc))

				{

					 printk(KERN_INFO "ONFI param page %d valid\n", i);

					 break;

				}

			}



			if (i < 3) {

				/* check version */

				int val = le16_to_cpu(p->revision);

				if (val == 1 || val > (1 << 4))

					printk(KERN_INFO "%s: unsupported ONFI version: %d\n",

						__func__, val);

				else {

					if (val & (1 << 4))

						chip->onfi_version = 22;

					else if (val & (1 << 3))

						chip->onfi_version = 21;

					else if (val & (1 << 2))

						chip->onfi_version = 20;

					else

						chip->onfi_version = 10;

				}

			}



			if (chip->onfi_version) {

				sanitize_string(p->manufacturer, sizeof(p->manufacturer));

				sanitize_string(p->model, sizeof(p->model));

				if (!mtd->name)

					mtd->name = p->model;

				mtd->writesize = le32_to_cpu(p->byte_per_page);

				mtd->erasesize = le32_to_cpu(p->pages_per_block)*mtd->writesize;

				mtd->oobsize = le16_to_cpu(p->spare_bytes_per_page);

				chip->chipsize = le32_to_cpu(p->blocks_per_lun) * mtd->erasesize;

				busw = 0;

				if (le16_to_cpu(p->features) & 1)

					busw = NAND_BUSWIDTH_16;



				chip->options &= ~NAND_CHIPOPTIONS_MSK;

				chip->options |= (NAND_NO_READRDY |

						NAND_NO_AUTOINCR) & NAND_CHIPOPTIONS_MSK;



				goto ident_done;



			}

		}

	}



	chip->cmdfunc(mtd, NAND_CMD_READID, 0x00, -1);



	/* Read entire ID string */



	for (i = 0; i < 8; i++)

		id_data[i] = chip->read_byte(mtd);



	if (!type->name)

		return ERR_PTR(-ENODEV);
@@ -2927,6 +3029,21 @@ static struct nand_flash_dev *nand_get_flash_type(struct mtd_info *mtd, 
			mtd->erasesize <<= ((id_data[3] & 0x03) << 1);

		}

	}

	/* Get chip options, preserve non chip based options */

	chip->options &= ~NAND_CHIPOPTIONS_MSK;

	chip->options |= type->options & NAND_CHIPOPTIONS_MSK;



	/* Check if chip is a not a samsung device. Do not clear the

	 * options for chips which are not having an extended id.

	 */

	if (*maf_id != NAND_MFR_SAMSUNG && !type->pagesize)

		chip->options &= ~NAND_SAMSUNG_LP_OPTIONS;

ident_done:



	/*

	 * Set chip as a default. Board drivers can override it, if necessary

	 */

	chip->options |= NAND_NO_AUTOINCR;



	/* Try to identify manufacturer */

	for (maf_idx = 0; nand_manuf_ids[maf_idx].id != 0x0; maf_idx++) {
@@ -2941,7 +3058,7 @@ static struct nand_flash_dev *nand_get_flash_type(struct mtd_info *mtd, 
	if (busw != (chip->options & NAND_BUSWIDTH_16)) {

		printk(KERN_INFO "NAND device: Manufacturer ID:"

		       " 0x%02x, Chip ID: 0x%02x (%s %s)\n", *maf_id,

		       dev_id, nand_manuf_ids[maf_idx].name, mtd->name);

		       *dev_id, nand_manuf_ids[maf_idx].name, mtd->name);

		printk(KERN_WARNING "NAND bus width %d instead %d bit\n",

		       (chip->options & NAND_BUSWIDTH_16) ? 16 : 8,

		       busw ? 16 : 8);
@@ -2966,21 +3083,6 @@ static struct nand_flash_dev *nand_get_flash_type(struct mtd_info *mtd, 
	else

		chip->badblockpos = NAND_SMALL_BADBLOCK_POS;



	/* Get chip options, preserve non chip based options */

	chip->options &= ~NAND_CHIPOPTIONS_MSK;

	chip->options |= type->options & NAND_CHIPOPTIONS_MSK;



	/*

	 * Set chip as a default. Board drivers can override it, if necessary

	 */

	chip->options |= NAND_NO_AUTOINCR;



	/* Check if chip is a not a samsung device. Do not clear the

	 * options for chips which are not having an extended id.

	 */

	if (*maf_id != NAND_MFR_SAMSUNG && !type->pagesize)

		chip->options &= ~NAND_SAMSUNG_LP_OPTIONS;



	/*

	 * Bad block marker is stored in the last page of each block

	 * on Samsung and Hynix MLC devices; stored in first two pages
@@ -3021,9 +3123,11 @@ static struct nand_flash_dev *nand_get_flash_type(struct mtd_info *mtd, 
	if (mtd->writesize > 512 && chip->cmdfunc == nand_command)

		chip->cmdfunc = nand_command_lp;



	/* TODO onfi flash name */

	printk(KERN_INFO "NAND device: Manufacturer ID:"

	       " 0x%02x, Chip ID: 0x%02x (%s %s)\n", *maf_id, dev_id,

	       nand_manuf_ids[maf_idx].name, type->name);

		" 0x%02x, Chip ID: 0x%02x (%s %s)\n", *maf_id, *dev_id,

		nand_manuf_ids[maf_idx].name,

		chip->onfi_version ? type->name:chip->onfi_params.model);



	return type;

}
@@ -3042,7 +3146,7 @@ static struct nand_flash_dev *nand_get_flash_type(struct mtd_info *mtd, 
int nand_scan_ident(struct mtd_info *mtd, int maxchips,

		    struct nand_flash_dev *table)

{

	int i, busw, nand_maf_id;

	int i, busw, nand_maf_id, nand_dev_id;

	struct nand_chip *chip = mtd->priv;

	struct nand_flash_dev *type;
@@ -3052,7 +3156,7 @@ int nand_scan_ident(struct mtd_info *mtd, int maxchips, 
	nand_set_defaults(chip, busw);



	/* Read the flash type */

	type = nand_get_flash_type(mtd, chip, busw, &nand_maf_id, table);

	type = nand_get_flash_type(mtd, chip, busw, &nand_maf_id, &nand_dev_id, table);



	if (IS_ERR(type)) {

		if (!(chip->options & NAND_SCAN_SILENT_NODEV))
@@ -3070,7 +3174,7 @@ int nand_scan_ident(struct mtd_info *mtd, int maxchips, 
		chip->cmdfunc(mtd, NAND_CMD_READID, 0x00, -1);

		/* Read manufacturer and device IDs */

		if (nand_maf_id != chip->read_byte(mtd) ||

		    type->id != chip->read_byte(mtd))

		    nand_dev_id != chip->read_byte(mtd))

			break;

	}

	if (i > 1)

include/linux/mtd/nand.h

+68 −0
Original line number Diff line number Diff line
@@ -228,6 +228,69 @@ typedef enum { 
/* Keep gcc happy */

struct nand_chip;



struct nand_onfi_params {

	/* rev info and features block */

	u8		sig[4]; /* 'O' 'N' 'F' 'I'  */

	__le16		revision;

	__le16		features;

	__le16		opt_cmd;

	u8		reserved[22];



	/* manufacturer information block */

	char		manufacturer[12];

	char		model[20];

	u8		jedec_id;

	__le16		date_code;

	u8		reserved2[13];



	/* memory organization block */

	__le32		byte_per_page;

	__le16		spare_bytes_per_page;

	__le32		data_bytes_per_ppage;

	__le16		spare_bytes_per_ppage;

	__le32		pages_per_block;

	__le32		blocks_per_lun;

	u8		lun_count;

	u8		addr_cycles;

	u8		bits_per_cell;

	__le16		bb_per_lun;

	__le16		block_endurance;

	u8		guaranteed_good_blocks;

	__le16		guaranteed_block_endurance;

	u8		programs_per_page;

	u8		ppage_attr;

	u8		ecc_bits;

	u8		interleaved_bits;

	u8		interleaved_ops;

	u8		reserved3[13];



	/* electrical parameter block */

	u8		io_pin_capacitance_max;

	__le16		async_timing_mode;

	__le16		program_cache_timing_mode;

	__le16		t_prog;

	__le16		t_bers;

	__le16		t_r;

	__le16		t_ccs;

	__le16		src_sync_timing_mode;

	__le16		src_ssync_features;

	__le16		clk_pin_capacitance_typ;

	__le16		io_pin_capacitance_typ;

	__le16		input_pin_capacitance_typ;

	u8		input_pin_capacitance_max;

	u8		driver_strenght_support;

	__le16		t_int_r;

	__le16		t_ald;

	u8		reserved4[7];



	/* vendor */

	u8		reserved5[90];



	__le16 crc;

} __attribute__((packed));



#define ONFI_CRC_BASE	0x4F4E



/**

 * struct nand_hw_control - Control structure for hardware controller (e.g ECC generator) shared among independent devices

 * @lock:               protection lock
@@ -360,6 +423,8 @@ struct nand_buffers { 
 * @pagemask:		[INTERN] page number mask = number of (pages / chip) - 1

 * @pagebuf:		[INTERN] holds the pagenumber which is currently in data_buf

 * @subpagesize:	[INTERN] holds the subpagesize

 * @onfi_version:	[INTERN] holds the chip ONFI version (BCD encoded), non 0 if ONFI supported

 * @onfi_params:	[INTERN] holds the ONFI page parameter when ONFI is supported, 0 otherwise

 * @ecclayout:		[REPLACEABLE] the default ecc placement scheme

 * @bbt:		[INTERN] bad block table pointer

 * @bbt_td:		[REPLACEABLE] bad block table descriptor for flash lookup
@@ -412,6 +477,9 @@ struct nand_chip { 
	int		badblockpos;

	int		badblockbits;



	int		onfi_version;

	struct nand_onfi_params	onfi_params;



	flstate_t	state;



	uint8_t		*oob_poi;

CRA Git | Maintained and supported by SUSTech CRA and CCSE