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 toshiba_nand_manuf_ops;
77
78 /* MLC pairing schemes */
79 extern const struct mtd_pairing_scheme dist3_pairing_scheme;
80
81 /* Core functions */
82 const struct nand_manufacturer_desc *nand_get_manufacturer_desc(u8 id);
83 int nand_bbm_get_next_page(struct nand_chip *chip, int page);
84 int nand_markbad_bbm(struct nand_chip *chip, loff_t ofs);
85 int nand_erase_nand(struct nand_chip *chip, struct erase_info *instr,
86 int allowbbt);
87 void onfi_fill_interface_config(struct nand_chip *chip,
88 struct nand_interface_config *iface,
89 enum nand_interface_type type,
90 unsigned int timing_mode);
91 unsigned int
92 onfi_find_closest_sdr_mode(const struct nand_sdr_timings *spec_timings);
93 int nand_choose_best_sdr_timings(struct nand_chip *chip,
94 struct nand_interface_config *iface,
95 struct nand_sdr_timings *spec_timings);
96 const struct nand_interface_config *nand_get_reset_interface_config(void);
97 int nand_get_features(struct nand_chip *chip, int addr, u8 *subfeature_param);
98 int nand_set_features(struct nand_chip *chip, int addr, u8 *subfeature_param);
99 int nand_read_page_raw_notsupp(struct nand_chip *chip, u8 *buf,
100 int oob_required, int page);
101 int nand_write_page_raw_notsupp(struct nand_chip *chip, const u8 *buf,
102 int oob_required, int page);
103 int nand_exit_status_op(struct nand_chip *chip);
104 int nand_read_param_page_op(struct nand_chip *chip, u8 page, void *buf,
105 unsigned int len);
106 void nand_decode_ext_id(struct nand_chip *chip);
107 void panic_nand_wait(struct nand_chip *chip, unsigned long timeo);
108 void sanitize_string(uint8_t *s, size_t len);
109
nand_has_exec_op(struct nand_chip * chip)110 static inline bool nand_has_exec_op(struct nand_chip *chip)
111 {
112 if (!chip->controller || !chip->controller->ops ||
113 !chip->controller->ops->exec_op)
114 return false;
115
116 return true;
117 }
118
nand_check_op(struct nand_chip * chip,const struct nand_operation * op)119 static inline int nand_check_op(struct nand_chip *chip,
120 const struct nand_operation *op)
121 {
122 if (!nand_has_exec_op(chip))
123 return 0;
124
125 return chip->controller->ops->exec_op(chip, op, true);
126 }
127
nand_exec_op(struct nand_chip * chip,const struct nand_operation * op)128 static inline int nand_exec_op(struct nand_chip *chip,
129 const struct nand_operation *op)
130 {
131 if (!nand_has_exec_op(chip))
132 return -ENOTSUPP;
133
134 if (WARN_ON(op->cs >= nanddev_ntargets(&chip->base)))
135 return -EINVAL;
136
137 return chip->controller->ops->exec_op(chip, op, false);
138 }
139
nand_controller_can_setup_interface(struct nand_chip * chip)140 static inline bool nand_controller_can_setup_interface(struct nand_chip *chip)
141 {
142 if (!chip->controller || !chip->controller->ops ||
143 !chip->controller->ops->setup_interface)
144 return false;
145
146 if (chip->options & NAND_KEEP_TIMINGS)
147 return false;
148
149 return true;
150 }
151
152 /* BBT functions */
153 int nand_markbad_bbt(struct nand_chip *chip, loff_t offs);
154 int nand_isreserved_bbt(struct nand_chip *chip, loff_t offs);
155 int nand_isbad_bbt(struct nand_chip *chip, loff_t offs, int allowbbt);
156
157 /* Legacy */
158 void nand_legacy_set_defaults(struct nand_chip *chip);
159 void nand_legacy_adjust_cmdfunc(struct nand_chip *chip);
160 int nand_legacy_check_hooks(struct nand_chip *chip);
161
162 /* ONFI functions */
163 u16 onfi_crc16(u16 crc, u8 const *p, size_t len);
164 int nand_onfi_detect(struct nand_chip *chip);
165
166 /* JEDEC functions */
167 int nand_jedec_detect(struct nand_chip *chip);
168
169 #endif /* __LINUX_RAWNAND_INTERNALS */
170