blob: e646d6f13471e82590b7fe7cd1c4ec464355b7e6 [file] [log] [blame]
b.liue9582032025-04-17 19:18:16 +08001/*
2 * SPI flash probing
3 *
4 * Copyright (C) 2008 Atmel Corporation
5 * Copyright (C) 2010 Reinhard Meyer, EMK Elektronik
6 * Copyright (C) 2013 Jagannadha Sutradharudu Teki, Xilinx Inc.
7 *
8 * SPDX-License-Identifier: GPL-2.0+
9 */
10
11#include <common.h>
12#include <fdtdec.h>
13#include <malloc.h>
14#include <spi.h>
15#include <spi_flash.h>
16#include <asm/io.h>
17
18#include "sf_internal.h"
19
20DECLARE_GLOBAL_DATA_PTR;
21
22/* Read commands array */
23static u8 spi_read_cmds_array[] = {
24 CMD_READ_ARRAY_SLOW,
25 CMD_READ_DUAL_OUTPUT_FAST,
26 CMD_READ_DUAL_IO_FAST,
27 CMD_READ_QUAD_OUTPUT_FAST,
28 CMD_READ_QUAD_IO_FAST,
29};
30
31#ifdef CONFIG_SPI_FLASH_MACRONIX
32static int spi_flash_set_qeb_mxic(struct spi_flash *flash)
33{
34 u8 qeb_status;
35 int ret;
36
37 ret = spi_flash_cmd_read_status(flash, &qeb_status);
38 if (ret < 0)
39 return ret;
40
41 if (qeb_status & STATUS_QEB_MXIC) {
42 debug("SF: mxic: QEB is already set\n");
43 } else {
44 ret = spi_flash_cmd_write_status(flash, STATUS_QEB_MXIC);
45 if (ret < 0)
46 return ret;
47 }
48
49 return ret;
50}
51#endif
52
53#if defined(CONFIG_SPI_FLASH_SPANSION) || defined(CONFIG_SPI_FLASH_WINBOND)
54static int spi_flash_set_qeb_winspan(struct spi_flash *flash)
55{
56 u8 qeb_status;
57 int ret;
58
59 ret = spi_flash_cmd_read_config(flash, &qeb_status);
60 if (ret < 0)
61 return ret;
62
63 if (qeb_status & STATUS_QEB_WINSPAN) {
64 debug("SF: winspan: QEB is already set\n");
65 } else {
66 ret = spi_flash_cmd_write_config(flash, STATUS_QEB_WINSPAN);
67 if (ret < 0)
68 return ret;
69 }
70
71 return ret;
72}
73#endif
74
75static int spi_flash_set_qeb(struct spi_flash *flash, u8 idcode0)
76{
77 switch (idcode0) {
78#ifdef CONFIG_SPI_FLASH_MACRONIX
79 case SPI_FLASH_CFI_MFR_MACRONIX:
80 return spi_flash_set_qeb_mxic(flash);
81#endif
82#if defined(CONFIG_SPI_FLASH_SPANSION) || defined(CONFIG_SPI_FLASH_WINBOND)
83 case SPI_FLASH_CFI_MFR_SPANSION:
84 case SPI_FLASH_CFI_MFR_WINBOND:
85 return spi_flash_set_qeb_winspan(flash);
86#endif
87#ifdef CONFIG_SPI_FLASH_STMICRO
88 case SPI_FLASH_CFI_MFR_STMICRO:
89 debug("SF: QEB is volatile for %02x flash\n", idcode0);
90 return 0;
91#endif
92 default:
93 printf("SF: Need set QEB func for %02x flash\n", idcode0);
94 return -1;
95 }
96}
97
98static struct spi_flash *spi_flash_validate_params(struct spi_slave *spi,
99 u8 *idcode)
100{
101 const struct spi_flash_params *params;
102 struct spi_flash *flash;
103 u8 cmd;
104 u16 jedec = idcode[1] << 8 | idcode[2];
105 u16 ext_jedec = idcode[3] << 8 | idcode[4];
106
107 params = spi_flash_params_table;
108 for (; params->name != NULL; params++) {
109 if ((params->jedec >> 16) == idcode[0]) {
110 if ((params->jedec & 0xFFFF) == jedec) {
111 if (params->ext_jedec == 0)
112 break;
113 else if (params->ext_jedec == ext_jedec)
114 break;
115 }
116 }
117 }
118
119 if (!params->name) {
120 printf("SF: Unsupported flash IDs: ");
121 printf("manuf %02x, jedec %04x, ext_jedec %04x\n",
122 idcode[0], jedec, ext_jedec);
123 return NULL;
124 }
125
126 flash = malloc(sizeof(*flash));
127 if (!flash) {
128 debug("SF: Failed to allocate spi_flash\n");
129 return NULL;
130 }
131 memset(flash, '\0', sizeof(*flash));
132
133 /* Assign spi data */
134 flash->spi = spi;
135 flash->name = params->name;
136 flash->memory_map = spi->memory_map;
137 flash->dual_flash = flash->spi->option;
138
139 /* Assign spi_flash ops */
140 flash->write = spi_flash_cmd_write_ops;
141#ifdef CONFIG_SPI_FLASH_SST
142 if (params->flags & SST_WP)
143 flash->write = sst_write_wp;
144#endif
145 flash->erase = spi_flash_cmd_erase_ops;
146 flash->read = spi_flash_cmd_read_ops;
147
148#ifdef CONFIG_PXA_SPI_NOR
149 flash->write = spi_flash_dma_write_ops;
150 flash->read = spi_flash_dma_read_ops;
151#endif
152
153 /* Compute the flash size */
154 flash->shift = (flash->dual_flash & SF_DUAL_PARALLEL_FLASH) ? 1 : 0;
155 flash->page_size = ((ext_jedec == 0x4d00) ? 512 : 256) << flash->shift;
156 flash->sector_size = params->sector_size << flash->shift;
157 flash->size = flash->sector_size * params->nr_sectors << flash->shift;
158#ifdef CONFIG_SF_DUAL_FLASH
159 if (flash->dual_flash & SF_DUAL_STACKED_FLASH)
160 flash->size <<= 1;
161#endif
162
163 /* Compute erase sector and command */
164 if (params->flags & SECT_4K) {
165 flash->erase_cmd = CMD_ERASE_4K;
166 flash->erase_size = 4096 << flash->shift;
167 } else if (params->flags & SECT_32K) {
168 flash->erase_cmd = CMD_ERASE_32K;
169 flash->erase_size = 32768 << flash->shift;
170 } else {
171 flash->erase_cmd = CMD_ERASE_64K;
172 flash->erase_size = flash->sector_size;
173 }
174
175 /* Look for the fastest read cmd */
176 cmd = fls(params->e_rd_cmd & flash->spi->op_mode_rx);
177 if (cmd) {
178 cmd = spi_read_cmds_array[cmd - 1];
179 flash->read_cmd = cmd;
180 } else {
181 /* Go for default supported read cmd */
182 flash->read_cmd = CMD_READ_ARRAY_FAST;
183 }
184
185 /* Not require to look for fastest only two write cmds yet */
186 if (params->flags & WR_QPP && flash->spi->op_mode_tx & SPI_OPM_TX_QPP)
187 flash->write_cmd = CMD_QUAD_PAGE_PROGRAM;
188 else
189 /* Go for default supported write cmd */
190 flash->write_cmd = CMD_PAGE_PROGRAM;
191
192 /* Set the quad enable bit - only for quad commands */
193 if ((flash->read_cmd == CMD_READ_QUAD_OUTPUT_FAST) ||
194 (flash->read_cmd == CMD_READ_QUAD_IO_FAST) ||
195 (flash->write_cmd == CMD_QUAD_PAGE_PROGRAM)) {
196 if (spi_flash_set_qeb(flash, idcode[0])) {
197 debug("SF: Fail to set QEB for %02x\n", idcode[0]);
198 return NULL;
199 }
200 }
201
202 /* Read dummy_byte: dummy byte is determined based on the
203 * dummy cycles of a particular command.
204 * Fast commands - dummy_byte = dummy_cycles/8
205 * I/O commands- dummy_byte = (dummy_cycles * no.of lines)/8
206 * For I/O commands except cmd[0] everything goes on no.of lines
207 * based on particular command but incase of fast commands except
208 * data all go on single line irrespective of command.
209 */
210 switch (flash->read_cmd) {
211 case CMD_READ_QUAD_IO_FAST:
212 flash->dummy_byte = 2;
213 break;
214 case CMD_READ_ARRAY_SLOW:
215 flash->dummy_byte = 0;
216 break;
217 default:
218 flash->dummy_byte = 1;
219 }
220
221 /* Poll cmd selection */
222 flash->poll_cmd = CMD_READ_STATUS;
223#ifdef CONFIG_SPI_FLASH_STMICRO
224 if (params->flags & E_FSR)
225 flash->poll_cmd = CMD_FLAG_STATUS;
226#endif
227
228 /* Configure the BAR - discover bank cmds and read current bank */
229#ifdef CONFIG_SPI_FLASH_BAR
230 u8 curr_bank = 0;
231 if (flash->size > SPI_FLASH_16MB_BOUN) {
232 flash->bank_read_cmd = (idcode[0] == 0x01) ?
233 CMD_BANKADDR_BRRD : CMD_EXTNADDR_RDEAR;
234 flash->bank_write_cmd = (idcode[0] == 0x01) ?
235 CMD_BANKADDR_BRWR : CMD_EXTNADDR_WREAR;
236
237 if (spi_flash_read_common(flash, &flash->bank_read_cmd, 1,
238 &curr_bank, 1)) {
239 debug("SF: fail to read bank addr register\n");
240 return NULL;
241 }
242 flash->bank_curr = curr_bank;
243 } else {
244 flash->bank_curr = curr_bank;
245 }
246#endif
247
248 /* Flash powers up read-only, so clear BP# bits */
249#if defined(CONFIG_SPI_FLASH_ATMEL) || \
250 defined(CONFIG_SPI_FLASH_MACRONIX) || \
251 defined(CONFIG_SPI_FLASH_SST)
252 spi_flash_cmd_write_status(flash, 0);
253#endif
254
255 return flash;
256}
257
258#ifdef CONFIG_OF_CONTROL
259int spi_flash_decode_fdt(const void *blob, struct spi_flash *flash)
260{
261 fdt_addr_t addr;
262 fdt_size_t size;
263 int node;
264
265 /* If there is no node, do nothing */
266 node = fdtdec_next_compatible(blob, 0, COMPAT_GENERIC_SPI_FLASH);
267 if (node < 0)
268 return 0;
269
270 addr = fdtdec_get_addr_size(blob, node, "memory-map", &size);
271 if (addr == FDT_ADDR_T_NONE) {
272 debug("%s: Cannot decode address\n", __func__);
273 return 0;
274 }
275
276 if (flash->size != size) {
277 debug("%s: Memory map must cover entire device\n", __func__);
278 return -1;
279 }
280 flash->memory_map = map_sysmem(addr, size);
281
282 return 0;
283}
284#endif /* CONFIG_OF_CONTROL */
285
286static struct spi_flash *spi_flash_probe_slave(struct spi_slave *spi)
287{
288 struct spi_flash *flash = NULL;
289 u8 idcode[5];
290 int ret;
291
292 /* Setup spi_slave */
293 if (!spi) {
294 printf("SF: Failed to set up slave\n");
295 return NULL;
296 }
297
298 /* Claim spi bus */
299 ret = spi_claim_bus(spi);
300 if (ret) {
301 debug("SF: Failed to claim SPI bus: %d\n", ret);
302 goto err_claim_bus;
303 }
304
305 /* Read the ID codes */
306 ret = spi_flash_cmd(spi, CMD_READ_ID, idcode, sizeof(idcode));
307 if (ret) {
308 printf("SF: Failed to get idcodes\n");
309 goto err_read_id;
310 }
311
312#ifdef DEBUG
313 printf("SF: Got idcodes\n");
314 print_buffer(0, idcode, 1, sizeof(idcode), 0);
315#endif
316
317 /* Validate params from spi_flash_params table */
318 flash = spi_flash_validate_params(spi, idcode);
319 if (!flash)
320 goto err_read_id;
321
322#ifdef CONFIG_OF_CONTROL
323 if (spi_flash_decode_fdt(gd->fdt_blob, flash)) {
324 debug("SF: FDT decode error\n");
325 goto err_read_id;
326 }
327#endif
328#ifndef CONFIG_SPL_BUILD
329 printf("SF: Detected %s with page size ", flash->name);
330 print_size(flash->page_size, ", erase size ");
331 print_size(flash->erase_size, ", total ");
332 print_size(flash->size, "");
333 if (flash->memory_map)
334 printf(", mapped at %p", flash->memory_map);
335 puts("\n");
336#endif
337#ifndef CONFIG_SPI_FLASH_BAR
338 if (((flash->dual_flash == SF_SINGLE_FLASH) &&
339 (flash->size > SPI_FLASH_16MB_BOUN)) ||
340 ((flash->dual_flash > SF_SINGLE_FLASH) &&
341 (flash->size > SPI_FLASH_16MB_BOUN << 1))) {
342 puts("SF: Warning - Only lower 16MiB accessible,");
343 puts(" Full access #define CONFIG_SPI_FLASH_BAR\n");
344 }
345#endif
346
347 /* Release spi bus */
348 spi_release_bus(spi);
349
350 return flash;
351
352err_read_id:
353 spi_release_bus(spi);
354err_claim_bus:
355 spi_free_slave(spi);
356 return NULL;
357}
358
359struct spi_flash *spi_flash_probe(unsigned int bus, unsigned int cs,
360 unsigned int max_hz, unsigned int spi_mode)
361{
362 struct spi_slave *spi;
363
364 spi = spi_setup_slave(bus, cs, max_hz, spi_mode);
365 return spi_flash_probe_slave(spi);
366}
367
368#ifdef CONFIG_OF_SPI_FLASH
369struct spi_flash *spi_flash_probe_fdt(const void *blob, int slave_node,
370 int spi_node)
371{
372 struct spi_slave *spi;
373
374 spi = spi_setup_slave_fdt(blob, slave_node, spi_node);
375 return spi_flash_probe_slave(spi);
376}
377#endif
378
379void spi_flash_free(struct spi_flash *flash)
380{
381 spi_free_slave(flash->spi);
382 free(flash);
383}