1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*
3  * Copyright (c) 2018 - Bootlin
4  *
5  * Author: Boris Brezillon <boris.brezillon@bootlin.com>
6  *
7  * Header containing internal definitions to be used only by core files.
8  * NAND controller drivers should not include this file.
9  */
10 
11 #ifndef __LINUX_RAWNAND_INTERNALS
12 #define __LINUX_RAWNAND_INTERNALS
13 
14 #include <linux/mtd/rawnand.h>
15 
16 /*
17  * NAND Flash Manufacturer ID Codes
18  */
19 #define NAND_MFR_AMD		0x01
20 #define NAND_MFR_ATO		0x9b
21 #define NAND_MFR_EON		0x92
22 #define NAND_MFR_ESMT		0xc8
23 #define NAND_MFR_FUJITSU	0x04
24 #define NAND_MFR_HYNIX		0xad
25 #define NAND_MFR_INTEL		0x89
26 #define NAND_MFR_MACRONIX	0xc2
27 #define NAND_MFR_MICRON		0x2c
28 #define NAND_MFR_NATIONAL	0x8f
29 #define NAND_MFR_RENESAS	0x07
30 #define NAND_MFR_SAMSUNG	0xec
31 #define NAND_MFR_SANDISK	0x45
32 #define NAND_MFR_STMICRO	0x20
33 /* Kioxia is new name of Toshiba memory. */
34 #define NAND_MFR_TOSHIBA	0x98
35 #define NAND_MFR_WINBOND	0xef
36 
37 /**
38  * struct nand_manufacturer_ops - NAND Manufacturer operations
39  * @detect: detect the NAND memory organization and capabilities
40  * @init: initialize all vendor specific fields (like the ->read_retry()
41  *	  implementation) if any.
42  * @cleanup: the ->init() function may have allocated resources, ->cleanup()
43  *	     is here to let vendor specific code release those resources.
44  * @fixup_onfi_param_page: apply vendor specific fixups to the ONFI parameter
45  *			   page. This is called after the checksum is verified.
46  */
47 struct nand_manufacturer_ops {
48 	void (*detect)(struct nand_chip *chip);
49 	int (*init)(struct nand_chip *chip);
50 	void (*cleanup)(struct nand_chip *chip);
51 	void (*fixup_onfi_param_page)(struct nand_chip *chip,
52 				      struct nand_onfi_params *p);
53 };
54 
55 /**
56  * struct nand_manufacturer_desc - NAND Flash Manufacturer descriptor
57  * @name: Manufacturer name
58  * @id: manufacturer ID code of device.
59  * @ops: manufacturer operations
60  */
61 struct nand_manufacturer_desc {
62 	int id;
63 	char *name;
64 	const struct nand_manufacturer_ops *ops;
65 };
66 
67 
68 extern struct nand_flash_dev nand_flash_ids[];
69 
70 extern const struct nand_manufacturer_ops amd_nand_manuf_ops;
71 extern const struct nand_manufacturer_ops esmt_nand_manuf_ops;
72 extern const struct nand_manufacturer_ops hynix_nand_manuf_ops;
73 extern const struct nand_manufacturer_ops macronix_nand_manuf_ops;
74 extern const struct nand_manufacturer_ops micron_nand_manuf_ops;
75 extern const struct nand_manufacturer_ops samsung_nand_manuf_ops;
76 extern const struct nand_manufacturer_ops sandisk_nand_manuf_ops;
77 extern const struct nand_manufacturer_ops toshiba_nand_manuf_ops;
78 
79 /* MLC pairing schemes */
80 extern const struct mtd_pairing_scheme dist3_pairing_scheme;
81 
82 /* Core functions */
83 const struct nand_manufacturer_desc *nand_get_manufacturer_desc(u8 id);
84 int nand_bbm_get_next_page(struct nand_chip *chip, int page);
85 int nand_markbad_bbm(struct nand_chip *chip, loff_t ofs);
86 int nand_erase_nand(struct nand_chip *chip, struct erase_info *instr,
87 		    int allowbbt);
88 void onfi_fill_interface_config(struct nand_chip *chip,
89 				struct nand_interface_config *iface,
90 				enum nand_interface_type type,
91 				unsigned int timing_mode);
92 unsigned int
93 onfi_find_closest_sdr_mode(const struct nand_sdr_timings *spec_timings);
94 unsigned int
95 onfi_find_closest_nvddr_mode(const struct nand_nvddr_timings *spec_timings);
96 int nand_choose_best_sdr_timings(struct nand_chip *chip,
97 				 struct nand_interface_config *iface,
98 				 struct nand_sdr_timings *spec_timings);
99 int nand_choose_best_nvddr_timings(struct nand_chip *chip,
100 				   struct nand_interface_config *iface,
101 				   struct nand_nvddr_timings *spec_timings);
102 const struct nand_interface_config *nand_get_reset_interface_config(void);
103 int nand_get_features(struct nand_chip *chip, int addr, u8 *subfeature_param);
104 int nand_set_features(struct nand_chip *chip, int addr, u8 *subfeature_param);
105 int nand_read_page_raw_notsupp(struct nand_chip *chip, u8 *buf,
106 			       int oob_required, int page);
107 int nand_write_page_raw_notsupp(struct nand_chip *chip, const u8 *buf,
108 				int oob_required, int page);
109 int nand_exit_status_op(struct nand_chip *chip);
110 int nand_read_param_page_op(struct nand_chip *chip, u8 page, void *buf,
111 			    unsigned int len);
112 void nand_decode_ext_id(struct nand_chip *chip);
113 void panic_nand_wait(struct nand_chip *chip, unsigned long timeo);
114 void sanitize_string(uint8_t *s, size_t len);
115 
nand_has_exec_op(struct nand_chip * chip)116 static inline bool nand_has_exec_op(struct nand_chip *chip)
117 {
118 	if (!chip->controller || !chip->controller->ops ||
119 	    !chip->controller->ops->exec_op)
120 		return false;
121 
122 	return true;
123 }
124 
nand_check_op(struct nand_chip * chip,const struct nand_operation * op)125 static inline int nand_check_op(struct nand_chip *chip,
126 				const struct nand_operation *op)
127 {
128 	if (!nand_has_exec_op(chip))
129 		return 0;
130 
131 	return chip->controller->ops->exec_op(chip, op, true);
132 }
133 
nand_exec_op(struct nand_chip * chip,const struct nand_operation * op)134 static inline int nand_exec_op(struct nand_chip *chip,
135 			       const struct nand_operation *op)
136 {
137 	if (!nand_has_exec_op(chip))
138 		return -ENOTSUPP;
139 
140 	if (WARN_ON(op->cs >= nanddev_ntargets(&chip->base)))
141 		return -EINVAL;
142 
143 	return chip->controller->ops->exec_op(chip, op, false);
144 }
145 
nand_controller_can_setup_interface(struct nand_chip * chip)146 static inline bool nand_controller_can_setup_interface(struct nand_chip *chip)
147 {
148 	if (!chip->controller || !chip->controller->ops ||
149 	    !chip->controller->ops->setup_interface)
150 		return false;
151 
152 	if (chip->options & NAND_KEEP_TIMINGS)
153 		return false;
154 
155 	return true;
156 }
157 
158 /* BBT functions */
159 int nand_markbad_bbt(struct nand_chip *chip, loff_t offs);
160 int nand_isreserved_bbt(struct nand_chip *chip, loff_t offs);
161 int nand_isbad_bbt(struct nand_chip *chip, loff_t offs, int allowbbt);
162 
163 /* Legacy */
164 void nand_legacy_set_defaults(struct nand_chip *chip);
165 void nand_legacy_adjust_cmdfunc(struct nand_chip *chip);
166 int nand_legacy_check_hooks(struct nand_chip *chip);
167 
168 /* ONFI functions */
169 u16 onfi_crc16(u16 crc, u8 const *p, size_t len);
170 int nand_onfi_detect(struct nand_chip *chip);
171 
172 /* JEDEC functions */
173 int nand_jedec_detect(struct nand_chip *chip);
174 
175 #endif /* __LINUX_RAWNAND_INTERNALS */
176