Tom Rini | 10e4779 | 2018-05-06 17:58:06 -0400 | [diff] [blame] | 1 | /* SPDX-License-Identifier: GPL-2.0 */ |
Wolfgang Denk | 2f9b7e4 | 2005-08-17 12:55:25 +0200 | [diff] [blame] | 2 | /* |
| 3 | * (C) Copyright 2005 |
| 4 | * 2N Telekomunikace, a.s. <www.2n.cz> |
| 5 | * Ladislav Michl <michl@2n.cz> |
Wolfgang Denk | 2f9b7e4 | 2005-08-17 12:55:25 +0200 | [diff] [blame] | 6 | */ |
| 7 | |
| 8 | #ifndef _NAND_H_ |
| 9 | #define _NAND_H_ |
| 10 | |
Scott Wood | ea0da78 | 2012-01-12 19:42:58 -0600 | [diff] [blame] | 11 | #include <config.h> |
| 12 | |
| 13 | /* |
| 14 | * All boards using a given driver must convert to self-init |
| 15 | * at the same time, so do it here. When all drivers are |
| 16 | * converted, this will go away. |
| 17 | */ |
Bo Shen | 9415b87 | 2014-03-03 14:47:16 +0800 | [diff] [blame] | 18 | #ifdef CONFIG_SPL_BUILD |
| 19 | #if defined(CONFIG_NAND_FSL_ELBC) || defined(CONFIG_NAND_FSL_IFC) |
| 20 | #define CONFIG_SYS_NAND_SELF_INIT |
| 21 | #endif |
| 22 | #else |
Prabhakar Kushwaha | 895d039 | 2013-04-04 18:44:06 +0000 | [diff] [blame] | 23 | #if defined(CONFIG_NAND_FSL_ELBC) || defined(CONFIG_NAND_ATMEL)\ |
| 24 | || defined(CONFIG_NAND_FSL_IFC) |
Scott Wood | ea0da78 | 2012-01-12 19:42:58 -0600 | [diff] [blame] | 25 | #define CONFIG_SYS_NAND_SELF_INIT |
| 26 | #endif |
Bo Shen | 9415b87 | 2014-03-03 14:47:16 +0800 | [diff] [blame] | 27 | #endif |
Scott Wood | ea0da78 | 2012-01-12 19:42:58 -0600 | [diff] [blame] | 28 | |
Scott Wood | 8238dd4 | 2008-07-09 17:47:52 -0500 | [diff] [blame] | 29 | extern void nand_init(void); |
Hou Zhiqiang | 9c8b3c7 | 2017-03-17 16:12:31 +0800 | [diff] [blame] | 30 | unsigned long nand_size(void); |
Scott Wood | 8238dd4 | 2008-07-09 17:47:52 -0500 | [diff] [blame] | 31 | |
Mike Frysinger | 11d1a09 | 2012-04-09 13:39:55 +0000 | [diff] [blame] | 32 | #include <linux/compat.h> |
Wolfgang Denk | 2f9b7e4 | 2005-08-17 12:55:25 +0200 | [diff] [blame] | 33 | #include <linux/mtd/mtd.h> |
Masahiro Yamada | 2b7a873 | 2017-11-30 13:45:24 +0900 | [diff] [blame] | 34 | #include <linux/mtd/rawnand.h> |
Wolfgang Denk | 2f9b7e4 | 2005-08-17 12:55:25 +0200 | [diff] [blame] | 35 | |
Scott Wood | 2c1b7e1 | 2016-05-30 13:57:55 -0500 | [diff] [blame] | 36 | int nand_mtd_to_devnum(struct mtd_info *mtd); |
| 37 | |
Scott Wood | 193a0f5 | 2012-01-12 19:07:23 -0600 | [diff] [blame] | 38 | #ifdef CONFIG_SYS_NAND_SELF_INIT |
| 39 | void board_nand_init(void); |
Scott Wood | 2c1b7e1 | 2016-05-30 13:57:55 -0500 | [diff] [blame] | 40 | int nand_register(int devnum, struct mtd_info *mtd); |
Scott Wood | 193a0f5 | 2012-01-12 19:07:23 -0600 | [diff] [blame] | 41 | #else |
Mike Frysinger | f791172 | 2008-12-06 02:40:55 -0500 | [diff] [blame] | 42 | extern int board_nand_init(struct nand_chip *nand); |
Scott Wood | 193a0f5 | 2012-01-12 19:07:23 -0600 | [diff] [blame] | 43 | #endif |
Mike Frysinger | f791172 | 2008-12-06 02:40:55 -0500 | [diff] [blame] | 44 | |
Wolfgang Denk | 2f9b7e4 | 2005-08-17 12:55:25 +0200 | [diff] [blame] | 45 | extern int nand_curr_device; |
Wolfgang Denk | 2f9b7e4 | 2005-08-17 12:55:25 +0200 | [diff] [blame] | 46 | |
Scott Wood | 08364d9 | 2016-05-30 13:57:54 -0500 | [diff] [blame] | 47 | static inline int nand_read(struct mtd_info *info, loff_t ofs, size_t *len, |
| 48 | u_char *buf) |
Wolfgang Denk | 2f9b7e4 | 2005-08-17 12:55:25 +0200 | [diff] [blame] | 49 | { |
Sergey Lapin | 3a38a55 | 2013-01-14 03:46:50 +0000 | [diff] [blame] | 50 | return mtd_read(info, ofs, *len, (size_t *)len, buf); |
Wolfgang Denk | 2f9b7e4 | 2005-08-17 12:55:25 +0200 | [diff] [blame] | 51 | } |
| 52 | |
Scott Wood | 08364d9 | 2016-05-30 13:57:54 -0500 | [diff] [blame] | 53 | static inline int nand_write(struct mtd_info *info, loff_t ofs, size_t *len, |
| 54 | u_char *buf) |
Wolfgang Denk | 2f9b7e4 | 2005-08-17 12:55:25 +0200 | [diff] [blame] | 55 | { |
Sergey Lapin | 3a38a55 | 2013-01-14 03:46:50 +0000 | [diff] [blame] | 56 | return mtd_write(info, ofs, *len, (size_t *)len, buf); |
Wolfgang Denk | 2f9b7e4 | 2005-08-17 12:55:25 +0200 | [diff] [blame] | 57 | } |
| 58 | |
Scott Wood | 08364d9 | 2016-05-30 13:57:54 -0500 | [diff] [blame] | 59 | static inline int nand_block_isbad(struct mtd_info *info, loff_t ofs) |
Wolfgang Denk | 2f9b7e4 | 2005-08-17 12:55:25 +0200 | [diff] [blame] | 60 | { |
Sergey Lapin | 3a38a55 | 2013-01-14 03:46:50 +0000 | [diff] [blame] | 61 | return mtd_block_isbad(info, ofs); |
Wolfgang Denk | 2f9b7e4 | 2005-08-17 12:55:25 +0200 | [diff] [blame] | 62 | } |
| 63 | |
Scott Wood | 08364d9 | 2016-05-30 13:57:54 -0500 | [diff] [blame] | 64 | static inline int nand_erase(struct mtd_info *info, loff_t off, size_t size) |
Wolfgang Denk | 2f9b7e4 | 2005-08-17 12:55:25 +0200 | [diff] [blame] | 65 | { |
Wolfgang Denk | 9a08dd1 | 2005-11-02 14:29:12 +0100 | [diff] [blame] | 66 | struct erase_info instr; |
| 67 | |
| 68 | instr.mtd = info; |
| 69 | instr.addr = off; |
| 70 | instr.len = size; |
| 71 | instr.callback = 0; |
| 72 | |
Sergey Lapin | 3a38a55 | 2013-01-14 03:46:50 +0000 | [diff] [blame] | 73 | return mtd_erase(info, &instr); |
Wolfgang Denk | 2f9b7e4 | 2005-08-17 12:55:25 +0200 | [diff] [blame] | 74 | } |
| 75 | |
Stefan Roese | d351b2b | 2006-10-10 12:36:02 +0200 | [diff] [blame] | 76 | |
| 77 | /***************************************************************************** |
| 78 | * declarations from nand_util.c |
| 79 | ****************************************************************************/ |
| 80 | |
William Juul | 52c0796 | 2007-10-31 13:53:06 +0100 | [diff] [blame] | 81 | typedef struct mtd_oob_ops mtd_oob_ops_t; |
Stefan Roese | d351b2b | 2006-10-10 12:36:02 +0200 | [diff] [blame] | 82 | |
Stefan Roese | d351b2b | 2006-10-10 12:36:02 +0200 | [diff] [blame] | 83 | struct nand_erase_options { |
Scott Wood | 1b5cd51 | 2010-08-25 14:43:29 -0500 | [diff] [blame] | 84 | loff_t length; /* number of bytes to erase */ |
| 85 | loff_t offset; /* first address in NAND to erase */ |
Stefan Roese | d351b2b | 2006-10-10 12:36:02 +0200 | [diff] [blame] | 86 | int quiet; /* don't display progress messages */ |
| 87 | int jffs2; /* if true: format for jffs2 usage |
| 88 | * (write appropriate cleanmarker blocks) */ |
| 89 | int scrub; /* if true, really clean NAND by erasing |
| 90 | * bad blocks (UNSAFE) */ |
Scott Wood | 1b5cd51 | 2010-08-25 14:43:29 -0500 | [diff] [blame] | 91 | |
| 92 | /* Don't include skipped bad blocks in size to be erased */ |
| 93 | int spread; |
Heiko Schocher | 0ae98b4 | 2013-06-24 18:50:40 +0200 | [diff] [blame] | 94 | /* maximum size that actual may be in order to not exceed the buf */ |
| 95 | loff_t lim; |
Stefan Roese | d351b2b | 2006-10-10 12:36:02 +0200 | [diff] [blame] | 96 | }; |
| 97 | |
| 98 | typedef struct nand_erase_options nand_erase_options_t; |
| 99 | |
Scott Wood | 08364d9 | 2016-05-30 13:57:54 -0500 | [diff] [blame] | 100 | int nand_read_skip_bad(struct mtd_info *mtd, loff_t offset, size_t *length, |
Tom Rini | 32d9618 | 2013-03-14 05:32:50 +0000 | [diff] [blame] | 101 | size_t *actual, loff_t lim, u_char *buffer); |
Ben Gardiner | 1caafbb | 2011-05-24 10:18:35 -0400 | [diff] [blame] | 102 | |
Peter Tyser | ae6ad78 | 2015-02-03 11:58:16 -0600 | [diff] [blame] | 103 | #define WITH_DROP_FFS (1 << 0) /* drop trailing all-0xff pages */ |
| 104 | #define WITH_WR_VERIFY (1 << 1) /* verify data was written correctly */ |
Ben Gardiner | 1caafbb | 2011-05-24 10:18:35 -0400 | [diff] [blame] | 105 | |
Scott Wood | 08364d9 | 2016-05-30 13:57:54 -0500 | [diff] [blame] | 106 | int nand_write_skip_bad(struct mtd_info *mtd, loff_t offset, size_t *length, |
Tom Rini | 32d9618 | 2013-03-14 05:32:50 +0000 | [diff] [blame] | 107 | size_t *actual, loff_t lim, u_char *buffer, int flags); |
Scott Wood | 08364d9 | 2016-05-30 13:57:54 -0500 | [diff] [blame] | 108 | int nand_erase_opts(struct mtd_info *mtd, |
| 109 | const nand_erase_options_t *opts); |
| 110 | int nand_torture(struct mtd_info *mtd, loff_t offset); |
| 111 | int nand_verify_page_oob(struct mtd_info *mtd, struct mtd_oob_ops *ops, |
| 112 | loff_t ofs); |
| 113 | int nand_verify(struct mtd_info *mtd, loff_t ofs, size_t len, u_char *buf); |
Stefan Roese | d351b2b | 2006-10-10 12:36:02 +0200 | [diff] [blame] | 114 | |
| 115 | #define NAND_LOCK_STATUS_TIGHT 0x01 |
Stefan Roese | d351b2b | 2006-10-10 12:36:02 +0200 | [diff] [blame] | 116 | #define NAND_LOCK_STATUS_UNLOCK 0x04 |
| 117 | |
Scott Wood | 08364d9 | 2016-05-30 13:57:54 -0500 | [diff] [blame] | 118 | int nand_lock(struct mtd_info *mtd, int tight); |
| 119 | int nand_unlock(struct mtd_info *mtd, loff_t start, size_t length, |
| 120 | int allexcept); |
| 121 | int nand_get_lock_status(struct mtd_info *mtd, loff_t offset); |
Stefan Roese | d351b2b | 2006-10-10 12:36:02 +0200 | [diff] [blame] | 122 | |
Simon Schwarz | 4f62e98 | 2011-09-14 15:30:16 -0400 | [diff] [blame] | 123 | int nand_spl_load_image(uint32_t offs, unsigned int size, void *dst); |
Thomas Gleixner | daec8a4 | 2016-07-12 20:28:10 +0200 | [diff] [blame] | 124 | int nand_spl_read_block(int block, int offset, int len, void *dst); |
Simon Schwarz | 992dcf7 | 2011-09-14 15:29:26 -0400 | [diff] [blame] | 125 | void nand_deselect(void); |
| 126 | |
Jean-Christophe PLAGNIOL-VILLARD | 0383694 | 2008-10-16 15:01:15 +0200 | [diff] [blame] | 127 | #ifdef CONFIG_SYS_NAND_SELECT_DEVICE |
Stefan Roese | 3cdd3fd | 2006-10-20 14:28:52 +0200 | [diff] [blame] | 128 | void board_nand_select_device(struct nand_chip *nand, int chip); |
| 129 | #endif |
| 130 | |
Scott Wood | b71689b | 2008-06-30 14:13:28 -0500 | [diff] [blame] | 131 | __attribute__((noreturn)) void nand_boot(void); |
| 132 | |
Ben Gardiner | 5fc8b7f | 2010-07-05 13:27:07 -0400 | [diff] [blame] | 133 | #ifdef CONFIG_ENV_OFFSET_OOB |
| 134 | #define ENV_OOB_MARKER 0x30425645 /*"EVB0" in little-endian -- offset is stored |
| 135 | as block number*/ |
| 136 | #define ENV_OOB_MARKER_OLD 0x30564e45 /*"ENV0" in little-endian -- offset is |
| 137 | stored as byte number */ |
| 138 | #define ENV_OFFSET_SIZE 8 |
Scott Wood | 08364d9 | 2016-05-30 13:57:54 -0500 | [diff] [blame] | 139 | int get_nand_env_oob(struct mtd_info *mtd, unsigned long *result); |
Ben Gardiner | 5fc8b7f | 2010-07-05 13:27:07 -0400 | [diff] [blame] | 140 | #endif |
Heiko Schocher | 4ff0c37 | 2014-10-31 08:31:02 +0100 | [diff] [blame] | 141 | int spl_nand_erase_one(int block, int page); |
Boris Brezillon | 57f2038 | 2016-06-15 21:09:23 +0200 | [diff] [blame] | 142 | |
| 143 | /* platform specific init functions */ |
| 144 | void sunxi_nand_init(void); |
Mugunthan V N | 375ec00 | 2017-01-23 16:04:34 -0600 | [diff] [blame] | 145 | |
Mugunthan V N | 7b670cc | 2017-06-26 19:12:51 -0500 | [diff] [blame] | 146 | /* |
| 147 | * get_nand_dev_by_index - Get the nand info based in index. |
| 148 | * |
| 149 | * @dev - index to the nand device. |
| 150 | * |
| 151 | * returns pointer to the nand device info structure or NULL on failure. |
| 152 | */ |
| 153 | struct mtd_info *get_nand_dev_by_index(int dev); |
| 154 | |
Mugunthan V N | 375ec00 | 2017-01-23 16:04:34 -0600 | [diff] [blame] | 155 | #endif /* _NAND_H_ */ |