sf_ops.c 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116
  1. /*
  2. * SPI flash operations
  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. #include <common.h>
  11. #include <errno.h>
  12. #include <malloc.h>
  13. #include <mapmem.h>
  14. #include <spi.h>
  15. #include <spi_flash.h>
  16. #include <watchdog.h>
  17. #include <linux/compiler.h>
  18. #include <linux/log2.h>
  19. #include "sf_internal.h"
  20. DECLARE_GLOBAL_DATA_PTR;
  21. static void spi_flash_addr(u32 addr, u8 *cmd)
  22. {
  23. /* cmd[0] is actual command */
  24. cmd[1] = addr >> 16;
  25. cmd[2] = addr >> 8;
  26. cmd[3] = addr >> 0;
  27. }
  28. /* Read commands array */
  29. static u8 spi_read_cmds_array[] = {
  30. CMD_READ_ARRAY_SLOW,
  31. CMD_READ_ARRAY_FAST,
  32. CMD_READ_DUAL_OUTPUT_FAST,
  33. CMD_READ_DUAL_IO_FAST,
  34. CMD_READ_QUAD_OUTPUT_FAST,
  35. CMD_READ_QUAD_IO_FAST,
  36. };
  37. static int spi_flash_cmd_read_status(struct spi_flash *flash, u8 *rs)
  38. {
  39. int ret;
  40. u8 cmd;
  41. cmd = CMD_READ_STATUS;
  42. ret = spi_flash_read_common(flash, &cmd, 1, rs, 1);
  43. if (ret < 0) {
  44. debug("SF: fail to read status register\n");
  45. return ret;
  46. }
  47. return 0;
  48. }
  49. static int read_fsr(struct spi_flash *flash, u8 *fsr)
  50. {
  51. int ret;
  52. const u8 cmd = CMD_FLAG_STATUS;
  53. ret = spi_flash_read_common(flash, &cmd, 1, fsr, 1);
  54. if (ret < 0) {
  55. debug("SF: fail to read flag status register\n");
  56. return ret;
  57. }
  58. return 0;
  59. }
  60. static int spi_flash_cmd_write_status(struct spi_flash *flash, u8 ws)
  61. {
  62. u8 cmd;
  63. int ret;
  64. cmd = CMD_WRITE_STATUS;
  65. ret = spi_flash_write_common(flash, &cmd, 1, &ws, 1);
  66. if (ret < 0) {
  67. debug("SF: fail to write status register\n");
  68. return ret;
  69. }
  70. return 0;
  71. }
  72. #if defined(CONFIG_SPI_FLASH_SPANSION) || defined(CONFIG_SPI_FLASH_WINBOND)
  73. static int spi_flash_cmd_read_config(struct spi_flash *flash, u8 *rc)
  74. {
  75. int ret;
  76. u8 cmd;
  77. cmd = CMD_READ_CONFIG;
  78. ret = spi_flash_read_common(flash, &cmd, 1, rc, 1);
  79. if (ret < 0) {
  80. debug("SF: fail to read config register\n");
  81. return ret;
  82. }
  83. return 0;
  84. }
  85. static int spi_flash_cmd_write_config(struct spi_flash *flash, u8 wc)
  86. {
  87. u8 data[2];
  88. u8 cmd;
  89. int ret;
  90. ret = spi_flash_cmd_read_status(flash, &data[0]);
  91. if (ret < 0)
  92. return ret;
  93. cmd = CMD_WRITE_STATUS;
  94. data[1] = wc;
  95. ret = spi_flash_write_common(flash, &cmd, 1, &data, 2);
  96. if (ret) {
  97. debug("SF: fail to write config register\n");
  98. return ret;
  99. }
  100. return 0;
  101. }
  102. #endif
  103. #ifdef CONFIG_SPI_FLASH_BAR
  104. static int spi_flash_write_bank(struct spi_flash *flash, u32 offset)
  105. {
  106. u8 cmd, bank_sel;
  107. int ret;
  108. bank_sel = offset / (SPI_FLASH_16MB_BOUN << flash->shift);
  109. if (bank_sel == flash->bank_curr)
  110. goto bar_end;
  111. cmd = flash->bank_write_cmd;
  112. ret = spi_flash_write_common(flash, &cmd, 1, &bank_sel, 1);
  113. if (ret < 0) {
  114. debug("SF: fail to write bank register\n");
  115. return ret;
  116. }
  117. bar_end:
  118. flash->bank_curr = bank_sel;
  119. return flash->bank_curr;
  120. }
  121. static int spi_flash_read_bank(struct spi_flash *flash, u8 idcode0)
  122. {
  123. u8 curr_bank = 0;
  124. int ret;
  125. if (flash->size <= SPI_FLASH_16MB_BOUN)
  126. goto bank_end;
  127. switch (idcode0) {
  128. case SPI_FLASH_CFI_MFR_SPANSION:
  129. flash->bank_read_cmd = CMD_BANKADDR_BRRD;
  130. flash->bank_write_cmd = CMD_BANKADDR_BRWR;
  131. default:
  132. flash->bank_read_cmd = CMD_EXTNADDR_RDEAR;
  133. flash->bank_write_cmd = CMD_EXTNADDR_WREAR;
  134. }
  135. ret = spi_flash_read_common(flash, &flash->bank_read_cmd, 1,
  136. &curr_bank, 1);
  137. if (ret) {
  138. debug("SF: fail to read bank addr register\n");
  139. return ret;
  140. }
  141. bank_end:
  142. flash->bank_curr = curr_bank;
  143. return 0;
  144. }
  145. #endif
  146. #ifdef CONFIG_SF_DUAL_FLASH
  147. static void spi_flash_dual_flash(struct spi_flash *flash, u32 *addr)
  148. {
  149. switch (flash->dual_flash) {
  150. case SF_DUAL_STACKED_FLASH:
  151. if (*addr >= (flash->size >> 1)) {
  152. *addr -= flash->size >> 1;
  153. flash->spi->flags |= SPI_XFER_U_PAGE;
  154. } else {
  155. flash->spi->flags &= ~SPI_XFER_U_PAGE;
  156. }
  157. break;
  158. case SF_DUAL_PARALLEL_FLASH:
  159. *addr >>= flash->shift;
  160. break;
  161. default:
  162. debug("SF: Unsupported dual_flash=%d\n", flash->dual_flash);
  163. break;
  164. }
  165. }
  166. #endif
  167. static int spi_flash_sr_ready(struct spi_flash *flash)
  168. {
  169. u8 sr;
  170. int ret;
  171. ret = spi_flash_cmd_read_status(flash, &sr);
  172. if (ret < 0)
  173. return ret;
  174. return !(sr & STATUS_WIP);
  175. }
  176. static int spi_flash_fsr_ready(struct spi_flash *flash)
  177. {
  178. u8 fsr;
  179. int ret;
  180. ret = read_fsr(flash, &fsr);
  181. if (ret < 0)
  182. return ret;
  183. return fsr & STATUS_PEC;
  184. }
  185. static int spi_flash_ready(struct spi_flash *flash)
  186. {
  187. int sr, fsr;
  188. sr = spi_flash_sr_ready(flash);
  189. if (sr < 0)
  190. return sr;
  191. fsr = 1;
  192. if (flash->flags & SNOR_F_USE_FSR) {
  193. fsr = spi_flash_fsr_ready(flash);
  194. if (fsr < 0)
  195. return fsr;
  196. }
  197. return sr && fsr;
  198. }
  199. static int spi_flash_cmd_wait_ready(struct spi_flash *flash,
  200. unsigned long timeout)
  201. {
  202. int timebase, ret;
  203. timebase = get_timer(0);
  204. while (get_timer(timebase) < timeout) {
  205. ret = spi_flash_ready(flash);
  206. if (ret < 0)
  207. return ret;
  208. if (ret)
  209. return 0;
  210. }
  211. printf("SF: Timeout!\n");
  212. return -ETIMEDOUT;
  213. }
  214. int spi_flash_write_common(struct spi_flash *flash, const u8 *cmd,
  215. size_t cmd_len, const void *buf, size_t buf_len)
  216. {
  217. struct spi_slave *spi = flash->spi;
  218. unsigned long timeout = SPI_FLASH_PROG_TIMEOUT;
  219. int ret;
  220. if (buf == NULL)
  221. timeout = SPI_FLASH_PAGE_ERASE_TIMEOUT;
  222. ret = spi_claim_bus(flash->spi);
  223. if (ret) {
  224. debug("SF: unable to claim SPI bus\n");
  225. return ret;
  226. }
  227. ret = spi_flash_cmd_write_enable(flash);
  228. if (ret < 0) {
  229. debug("SF: enabling write failed\n");
  230. return ret;
  231. }
  232. ret = spi_flash_cmd_write(spi, cmd, cmd_len, buf, buf_len);
  233. if (ret < 0) {
  234. debug("SF: write cmd failed\n");
  235. return ret;
  236. }
  237. ret = spi_flash_cmd_wait_ready(flash, timeout);
  238. if (ret < 0) {
  239. debug("SF: write %s timed out\n",
  240. timeout == SPI_FLASH_PROG_TIMEOUT ?
  241. "program" : "page erase");
  242. return ret;
  243. }
  244. spi_release_bus(spi);
  245. return ret;
  246. }
  247. int spi_flash_cmd_erase_ops(struct spi_flash *flash, u32 offset, size_t len)
  248. {
  249. u32 erase_size, erase_addr;
  250. u8 cmd[SPI_FLASH_CMD_LEN];
  251. int ret = -1;
  252. erase_size = flash->erase_size;
  253. if (offset % erase_size || len % erase_size) {
  254. debug("SF: Erase offset/length not multiple of erase size\n");
  255. return -1;
  256. }
  257. if (flash->flash_is_locked) {
  258. if (flash->flash_is_locked(flash, offset, len) > 0) {
  259. printf("offset 0x%x is protected and cannot be erased\n",
  260. offset);
  261. return -EINVAL;
  262. }
  263. }
  264. cmd[0] = flash->erase_cmd;
  265. while (len) {
  266. erase_addr = offset;
  267. #ifdef CONFIG_SF_DUAL_FLASH
  268. if (flash->dual_flash > SF_SINGLE_FLASH)
  269. spi_flash_dual_flash(flash, &erase_addr);
  270. #endif
  271. #ifdef CONFIG_SPI_FLASH_BAR
  272. ret = spi_flash_write_bank(flash, erase_addr);
  273. if (ret < 0)
  274. return ret;
  275. #endif
  276. spi_flash_addr(erase_addr, cmd);
  277. debug("SF: erase %2x %2x %2x %2x (%x)\n", cmd[0], cmd[1],
  278. cmd[2], cmd[3], erase_addr);
  279. ret = spi_flash_write_common(flash, cmd, sizeof(cmd), NULL, 0);
  280. if (ret < 0) {
  281. debug("SF: erase failed\n");
  282. break;
  283. }
  284. offset += erase_size;
  285. len -= erase_size;
  286. }
  287. return ret;
  288. }
  289. int spi_flash_cmd_write_ops(struct spi_flash *flash, u32 offset,
  290. size_t len, const void *buf)
  291. {
  292. unsigned long byte_addr, page_size;
  293. u32 write_addr;
  294. size_t chunk_len, actual;
  295. u8 cmd[SPI_FLASH_CMD_LEN];
  296. int ret = -1;
  297. page_size = flash->page_size;
  298. if (flash->flash_is_locked) {
  299. if (flash->flash_is_locked(flash, offset, len) > 0) {
  300. printf("offset 0x%x is protected and cannot be written\n",
  301. offset);
  302. return -EINVAL;
  303. }
  304. }
  305. cmd[0] = flash->write_cmd;
  306. for (actual = 0; actual < len; actual += chunk_len) {
  307. write_addr = offset;
  308. #ifdef CONFIG_SF_DUAL_FLASH
  309. if (flash->dual_flash > SF_SINGLE_FLASH)
  310. spi_flash_dual_flash(flash, &write_addr);
  311. #endif
  312. #ifdef CONFIG_SPI_FLASH_BAR
  313. ret = spi_flash_write_bank(flash, write_addr);
  314. if (ret < 0)
  315. return ret;
  316. #endif
  317. byte_addr = offset % page_size;
  318. chunk_len = min(len - actual, (size_t)(page_size - byte_addr));
  319. if (flash->spi->max_write_size)
  320. chunk_len = min(chunk_len,
  321. (size_t)flash->spi->max_write_size);
  322. spi_flash_addr(write_addr, cmd);
  323. debug("SF: 0x%p => cmd = { 0x%02x 0x%02x%02x%02x } chunk_len = %zu\n",
  324. buf + actual, cmd[0], cmd[1], cmd[2], cmd[3], chunk_len);
  325. ret = spi_flash_write_common(flash, cmd, sizeof(cmd),
  326. buf + actual, chunk_len);
  327. if (ret < 0) {
  328. debug("SF: write failed\n");
  329. break;
  330. }
  331. offset += chunk_len;
  332. }
  333. return ret;
  334. }
  335. int spi_flash_read_common(struct spi_flash *flash, const u8 *cmd,
  336. size_t cmd_len, void *data, size_t data_len)
  337. {
  338. struct spi_slave *spi = flash->spi;
  339. int ret;
  340. ret = spi_claim_bus(flash->spi);
  341. if (ret) {
  342. debug("SF: unable to claim SPI bus\n");
  343. return ret;
  344. }
  345. ret = spi_flash_cmd_read(spi, cmd, cmd_len, data, data_len);
  346. if (ret < 0) {
  347. debug("SF: read cmd failed\n");
  348. return ret;
  349. }
  350. spi_release_bus(spi);
  351. return ret;
  352. }
  353. void __weak spi_flash_copy_mmap(void *data, void *offset, size_t len)
  354. {
  355. memcpy(data, offset, len);
  356. }
  357. int spi_flash_cmd_read_ops(struct spi_flash *flash, u32 offset,
  358. size_t len, void *data)
  359. {
  360. u8 *cmd, cmdsz;
  361. u32 remain_len, read_len, read_addr;
  362. int bank_sel = 0;
  363. int ret = -1;
  364. /* Handle memory-mapped SPI */
  365. if (flash->memory_map) {
  366. ret = spi_claim_bus(flash->spi);
  367. if (ret) {
  368. debug("SF: unable to claim SPI bus\n");
  369. return ret;
  370. }
  371. spi_xfer(flash->spi, 0, NULL, NULL, SPI_XFER_MMAP);
  372. spi_flash_copy_mmap(data, flash->memory_map + offset, len);
  373. spi_xfer(flash->spi, 0, NULL, NULL, SPI_XFER_MMAP_END);
  374. spi_release_bus(flash->spi);
  375. return 0;
  376. }
  377. cmdsz = SPI_FLASH_CMD_LEN + flash->dummy_byte;
  378. cmd = calloc(1, cmdsz);
  379. if (!cmd) {
  380. debug("SF: Failed to allocate cmd\n");
  381. return -ENOMEM;
  382. }
  383. cmd[0] = flash->read_cmd;
  384. while (len) {
  385. read_addr = offset;
  386. #ifdef CONFIG_SF_DUAL_FLASH
  387. if (flash->dual_flash > SF_SINGLE_FLASH)
  388. spi_flash_dual_flash(flash, &read_addr);
  389. #endif
  390. #ifdef CONFIG_SPI_FLASH_BAR
  391. ret = spi_flash_write_bank(flash, read_addr);
  392. if (ret < 0)
  393. return ret;
  394. bank_sel = flash->bank_curr;
  395. #endif
  396. remain_len = ((SPI_FLASH_16MB_BOUN << flash->shift) *
  397. (bank_sel + 1)) - offset;
  398. if (len < remain_len)
  399. read_len = len;
  400. else
  401. read_len = remain_len;
  402. spi_flash_addr(read_addr, cmd);
  403. ret = spi_flash_read_common(flash, cmd, cmdsz, data, read_len);
  404. if (ret < 0) {
  405. debug("SF: read failed\n");
  406. break;
  407. }
  408. offset += read_len;
  409. len -= read_len;
  410. data += read_len;
  411. }
  412. free(cmd);
  413. return ret;
  414. }
  415. #ifdef CONFIG_SPI_FLASH_SST
  416. static int sst_byte_write(struct spi_flash *flash, u32 offset, const void *buf)
  417. {
  418. int ret;
  419. u8 cmd[4] = {
  420. CMD_SST_BP,
  421. offset >> 16,
  422. offset >> 8,
  423. offset,
  424. };
  425. debug("BP[%02x]: 0x%p => cmd = { 0x%02x 0x%06x }\n",
  426. spi_w8r8(flash->spi, CMD_READ_STATUS), buf, cmd[0], offset);
  427. ret = spi_flash_cmd_write_enable(flash);
  428. if (ret)
  429. return ret;
  430. ret = spi_flash_cmd_write(flash->spi, cmd, sizeof(cmd), buf, 1);
  431. if (ret)
  432. return ret;
  433. return spi_flash_cmd_wait_ready(flash, SPI_FLASH_PROG_TIMEOUT);
  434. }
  435. int sst_write_wp(struct spi_flash *flash, u32 offset, size_t len,
  436. const void *buf)
  437. {
  438. size_t actual, cmd_len;
  439. int ret;
  440. u8 cmd[4];
  441. ret = spi_claim_bus(flash->spi);
  442. if (ret) {
  443. debug("SF: Unable to claim SPI bus\n");
  444. return ret;
  445. }
  446. /* If the data is not word aligned, write out leading single byte */
  447. actual = offset % 2;
  448. if (actual) {
  449. ret = sst_byte_write(flash, offset, buf);
  450. if (ret)
  451. goto done;
  452. }
  453. offset += actual;
  454. ret = spi_flash_cmd_write_enable(flash);
  455. if (ret)
  456. goto done;
  457. cmd_len = 4;
  458. cmd[0] = CMD_SST_AAI_WP;
  459. cmd[1] = offset >> 16;
  460. cmd[2] = offset >> 8;
  461. cmd[3] = offset;
  462. for (; actual < len - 1; actual += 2) {
  463. debug("WP[%02x]: 0x%p => cmd = { 0x%02x 0x%06x }\n",
  464. spi_w8r8(flash->spi, CMD_READ_STATUS), buf + actual,
  465. cmd[0], offset);
  466. ret = spi_flash_cmd_write(flash->spi, cmd, cmd_len,
  467. buf + actual, 2);
  468. if (ret) {
  469. debug("SF: sst word program failed\n");
  470. break;
  471. }
  472. ret = spi_flash_cmd_wait_ready(flash, SPI_FLASH_PROG_TIMEOUT);
  473. if (ret)
  474. break;
  475. cmd_len = 1;
  476. offset += 2;
  477. }
  478. if (!ret)
  479. ret = spi_flash_cmd_write_disable(flash);
  480. /* If there is a single trailing byte, write it out */
  481. if (!ret && actual != len)
  482. ret = sst_byte_write(flash, offset, buf + actual);
  483. done:
  484. debug("SF: sst: program %s %zu bytes @ 0x%zx\n",
  485. ret ? "failure" : "success", len, offset - actual);
  486. spi_release_bus(flash->spi);
  487. return ret;
  488. }
  489. int sst_write_bp(struct spi_flash *flash, u32 offset, size_t len,
  490. const void *buf)
  491. {
  492. size_t actual;
  493. int ret;
  494. ret = spi_claim_bus(flash->spi);
  495. if (ret) {
  496. debug("SF: Unable to claim SPI bus\n");
  497. return ret;
  498. }
  499. for (actual = 0; actual < len; actual++) {
  500. ret = sst_byte_write(flash, offset, buf + actual);
  501. if (ret) {
  502. debug("SF: sst byte program failed\n");
  503. break;
  504. }
  505. offset++;
  506. }
  507. if (!ret)
  508. ret = spi_flash_cmd_write_disable(flash);
  509. debug("SF: sst: program %s %zu bytes @ 0x%zx\n",
  510. ret ? "failure" : "success", len, offset - actual);
  511. spi_release_bus(flash->spi);
  512. return ret;
  513. }
  514. #endif
  515. #if defined(CONFIG_SPI_FLASH_STMICRO) || defined(CONFIG_SPI_FLASH_SST)
  516. static void stm_get_locked_range(struct spi_flash *flash, u8 sr, loff_t *ofs,
  517. u32 *len)
  518. {
  519. u8 mask = SR_BP2 | SR_BP1 | SR_BP0;
  520. int shift = ffs(mask) - 1;
  521. int pow;
  522. if (!(sr & mask)) {
  523. /* No protection */
  524. *ofs = 0;
  525. *len = 0;
  526. } else {
  527. pow = ((sr & mask) ^ mask) >> shift;
  528. *len = flash->size >> pow;
  529. *ofs = flash->size - *len;
  530. }
  531. }
  532. /*
  533. * Return 1 if the entire region is locked, 0 otherwise
  534. */
  535. static int stm_is_locked_sr(struct spi_flash *flash, u32 ofs, u32 len,
  536. u8 sr)
  537. {
  538. loff_t lock_offs;
  539. u32 lock_len;
  540. stm_get_locked_range(flash, sr, &lock_offs, &lock_len);
  541. return (ofs + len <= lock_offs + lock_len) && (ofs >= lock_offs);
  542. }
  543. /*
  544. * Check if a region of the flash is (completely) locked. See stm_lock() for
  545. * more info.
  546. *
  547. * Returns 1 if entire region is locked, 0 if any portion is unlocked, and
  548. * negative on errors.
  549. */
  550. int stm_is_locked(struct spi_flash *flash, u32 ofs, size_t len)
  551. {
  552. int status;
  553. u8 sr;
  554. status = spi_flash_cmd_read_status(flash, &sr);
  555. if (status < 0)
  556. return status;
  557. return stm_is_locked_sr(flash, ofs, len, sr);
  558. }
  559. /*
  560. * Lock a region of the flash. Compatible with ST Micro and similar flash.
  561. * Supports only the block protection bits BP{0,1,2} in the status register
  562. * (SR). Does not support these features found in newer SR bitfields:
  563. * - TB: top/bottom protect - only handle TB=0 (top protect)
  564. * - SEC: sector/block protect - only handle SEC=0 (block protect)
  565. * - CMP: complement protect - only support CMP=0 (range is not complemented)
  566. *
  567. * Sample table portion for 8MB flash (Winbond w25q64fw):
  568. *
  569. * SEC | TB | BP2 | BP1 | BP0 | Prot Length | Protected Portion
  570. * --------------------------------------------------------------------------
  571. * X | X | 0 | 0 | 0 | NONE | NONE
  572. * 0 | 0 | 0 | 0 | 1 | 128 KB | Upper 1/64
  573. * 0 | 0 | 0 | 1 | 0 | 256 KB | Upper 1/32
  574. * 0 | 0 | 0 | 1 | 1 | 512 KB | Upper 1/16
  575. * 0 | 0 | 1 | 0 | 0 | 1 MB | Upper 1/8
  576. * 0 | 0 | 1 | 0 | 1 | 2 MB | Upper 1/4
  577. * 0 | 0 | 1 | 1 | 0 | 4 MB | Upper 1/2
  578. * X | X | 1 | 1 | 1 | 8 MB | ALL
  579. *
  580. * Returns negative on errors, 0 on success.
  581. */
  582. int stm_lock(struct spi_flash *flash, u32 ofs, size_t len)
  583. {
  584. u8 status_old, status_new;
  585. u8 mask = SR_BP2 | SR_BP1 | SR_BP0;
  586. u8 shift = ffs(mask) - 1, pow, val;
  587. int ret;
  588. ret = spi_flash_cmd_read_status(flash, &status_old);
  589. if (ret < 0)
  590. return ret;
  591. /* SPI NOR always locks to the end */
  592. if (ofs + len != flash->size) {
  593. /* Does combined region extend to end? */
  594. if (!stm_is_locked_sr(flash, ofs + len, flash->size - ofs - len,
  595. status_old))
  596. return -EINVAL;
  597. len = flash->size - ofs;
  598. }
  599. /*
  600. * Need smallest pow such that:
  601. *
  602. * 1 / (2^pow) <= (len / size)
  603. *
  604. * so (assuming power-of-2 size) we do:
  605. *
  606. * pow = ceil(log2(size / len)) = log2(size) - floor(log2(len))
  607. */
  608. pow = ilog2(flash->size) - ilog2(len);
  609. val = mask - (pow << shift);
  610. if (val & ~mask)
  611. return -EINVAL;
  612. /* Don't "lock" with no region! */
  613. if (!(val & mask))
  614. return -EINVAL;
  615. status_new = (status_old & ~mask) | val;
  616. /* Only modify protection if it will not unlock other areas */
  617. if ((status_new & mask) <= (status_old & mask))
  618. return -EINVAL;
  619. spi_flash_cmd_write_status(flash, status_new);
  620. return 0;
  621. }
  622. /*
  623. * Unlock a region of the flash. See stm_lock() for more info
  624. *
  625. * Returns negative on errors, 0 on success.
  626. */
  627. int stm_unlock(struct spi_flash *flash, u32 ofs, size_t len)
  628. {
  629. uint8_t status_old, status_new;
  630. u8 mask = SR_BP2 | SR_BP1 | SR_BP0;
  631. u8 shift = ffs(mask) - 1, pow, val;
  632. int ret;
  633. ret = spi_flash_cmd_read_status(flash, &status_old);
  634. if (ret < 0)
  635. return ret;
  636. /* Cannot unlock; would unlock larger region than requested */
  637. if (stm_is_locked_sr(flash, status_old, ofs - flash->erase_size,
  638. flash->erase_size))
  639. return -EINVAL;
  640. /*
  641. * Need largest pow such that:
  642. *
  643. * 1 / (2^pow) >= (len / size)
  644. *
  645. * so (assuming power-of-2 size) we do:
  646. *
  647. * pow = floor(log2(size / len)) = log2(size) - ceil(log2(len))
  648. */
  649. pow = ilog2(flash->size) - order_base_2(flash->size - (ofs + len));
  650. if (ofs + len == flash->size) {
  651. val = 0; /* fully unlocked */
  652. } else {
  653. val = mask - (pow << shift);
  654. /* Some power-of-two sizes are not supported */
  655. if (val & ~mask)
  656. return -EINVAL;
  657. }
  658. status_new = (status_old & ~mask) | val;
  659. /* Only modify protection if it will not lock other areas */
  660. if ((status_new & mask) >= (status_old & mask))
  661. return -EINVAL;
  662. spi_flash_cmd_write_status(flash, status_new);
  663. return 0;
  664. }
  665. #endif
  666. #ifdef CONFIG_SPI_FLASH_MACRONIX
  667. static int spi_flash_set_qeb_mxic(struct spi_flash *flash)
  668. {
  669. u8 qeb_status;
  670. int ret;
  671. ret = spi_flash_cmd_read_status(flash, &qeb_status);
  672. if (ret < 0)
  673. return ret;
  674. if (qeb_status & STATUS_QEB_MXIC) {
  675. debug("SF: mxic: QEB is already set\n");
  676. } else {
  677. ret = spi_flash_cmd_write_status(flash, STATUS_QEB_MXIC);
  678. if (ret < 0)
  679. return ret;
  680. }
  681. return ret;
  682. }
  683. #endif
  684. #if defined(CONFIG_SPI_FLASH_SPANSION) || defined(CONFIG_SPI_FLASH_WINBOND)
  685. static int spi_flash_set_qeb_winspan(struct spi_flash *flash)
  686. {
  687. u8 qeb_status;
  688. int ret;
  689. ret = spi_flash_cmd_read_config(flash, &qeb_status);
  690. if (ret < 0)
  691. return ret;
  692. if (qeb_status & STATUS_QEB_WINSPAN) {
  693. debug("SF: winspan: QEB is already set\n");
  694. } else {
  695. ret = spi_flash_cmd_write_config(flash, STATUS_QEB_WINSPAN);
  696. if (ret < 0)
  697. return ret;
  698. }
  699. return ret;
  700. }
  701. #endif
  702. static int spi_flash_set_qeb(struct spi_flash *flash, u8 idcode0)
  703. {
  704. switch (idcode0) {
  705. #ifdef CONFIG_SPI_FLASH_MACRONIX
  706. case SPI_FLASH_CFI_MFR_MACRONIX:
  707. return spi_flash_set_qeb_mxic(flash);
  708. #endif
  709. #if defined(CONFIG_SPI_FLASH_SPANSION) || defined(CONFIG_SPI_FLASH_WINBOND)
  710. case SPI_FLASH_CFI_MFR_SPANSION:
  711. case SPI_FLASH_CFI_MFR_WINBOND:
  712. return spi_flash_set_qeb_winspan(flash);
  713. #endif
  714. #ifdef CONFIG_SPI_FLASH_STMICRO
  715. case SPI_FLASH_CFI_MFR_STMICRO:
  716. debug("SF: QEB is volatile for %02x flash\n", idcode0);
  717. return 0;
  718. #endif
  719. default:
  720. printf("SF: Need set QEB func for %02x flash\n", idcode0);
  721. return -1;
  722. }
  723. }
  724. #if CONFIG_IS_ENABLED(OF_CONTROL)
  725. int spi_flash_decode_fdt(const void *blob, struct spi_flash *flash)
  726. {
  727. fdt_addr_t addr;
  728. fdt_size_t size;
  729. int node;
  730. /* If there is no node, do nothing */
  731. node = fdtdec_next_compatible(blob, 0, COMPAT_GENERIC_SPI_FLASH);
  732. if (node < 0)
  733. return 0;
  734. addr = fdtdec_get_addr_size(blob, node, "memory-map", &size);
  735. if (addr == FDT_ADDR_T_NONE) {
  736. debug("%s: Cannot decode address\n", __func__);
  737. return 0;
  738. }
  739. if (flash->size != size) {
  740. debug("%s: Memory map must cover entire device\n", __func__);
  741. return -1;
  742. }
  743. flash->memory_map = map_sysmem(addr, size);
  744. return 0;
  745. }
  746. #endif /* CONFIG_IS_ENABLED(OF_CONTROL) */
  747. int spi_flash_scan(struct spi_slave *spi, struct spi_flash *flash)
  748. {
  749. const struct spi_flash_params *params;
  750. u16 jedec, ext_jedec;
  751. u8 idcode[5];
  752. u8 cmd;
  753. int ret;
  754. /* Read the ID codes */
  755. ret = spi_flash_cmd(spi, CMD_READ_ID, idcode, sizeof(idcode));
  756. if (ret) {
  757. printf("SF: Failed to get idcodes\n");
  758. return -EINVAL;
  759. }
  760. #ifdef DEBUG
  761. printf("SF: Got idcodes\n");
  762. print_buffer(0, idcode, 1, sizeof(idcode), 0);
  763. #endif
  764. jedec = idcode[1] << 8 | idcode[2];
  765. ext_jedec = idcode[3] << 8 | idcode[4];
  766. /* Validate params from spi_flash_params table */
  767. params = spi_flash_params_table;
  768. for (; params->name != NULL; params++) {
  769. if ((params->jedec >> 16) == idcode[0]) {
  770. if ((params->jedec & 0xFFFF) == jedec) {
  771. if (params->ext_jedec == 0)
  772. break;
  773. else if (params->ext_jedec == ext_jedec)
  774. break;
  775. }
  776. }
  777. }
  778. if (!params->name) {
  779. printf("SF: Unsupported flash IDs: ");
  780. printf("manuf %02x, jedec %04x, ext_jedec %04x\n",
  781. idcode[0], jedec, ext_jedec);
  782. return -EPROTONOSUPPORT;
  783. }
  784. /* Flash powers up read-only, so clear BP# bits */
  785. #if defined(CONFIG_SPI_FLASH_ATMEL) || \
  786. defined(CONFIG_SPI_FLASH_MACRONIX) || \
  787. defined(CONFIG_SPI_FLASH_SST)
  788. spi_flash_cmd_write_status(flash, 0);
  789. #endif
  790. /* Assign spi data */
  791. flash->spi = spi;
  792. flash->name = params->name;
  793. flash->memory_map = spi->memory_map;
  794. flash->dual_flash = flash->spi->option;
  795. /* Assign spi flash flags */
  796. if (params->flags & SST_WR)
  797. flash->flags |= SNOR_F_SST_WR;
  798. /* Assign spi_flash ops */
  799. #ifndef CONFIG_DM_SPI_FLASH
  800. flash->write = spi_flash_cmd_write_ops;
  801. #if defined(CONFIG_SPI_FLASH_SST)
  802. if (flash->flags & SNOR_F_SST_WR) {
  803. if (flash->spi->op_mode_tx & SPI_OPM_TX_BP)
  804. flash->write = sst_write_bp;
  805. else
  806. flash->write = sst_write_wp;
  807. }
  808. #endif
  809. flash->erase = spi_flash_cmd_erase_ops;
  810. flash->read = spi_flash_cmd_read_ops;
  811. #endif
  812. /* lock hooks are flash specific - assign them based on idcode0 */
  813. switch (idcode[0]) {
  814. #if defined(CONFIG_SPI_FLASH_STMICRO) || defined(CONFIG_SPI_FLASH_SST)
  815. case SPI_FLASH_CFI_MFR_STMICRO:
  816. case SPI_FLASH_CFI_MFR_SST:
  817. flash->flash_lock = stm_lock;
  818. flash->flash_unlock = stm_unlock;
  819. flash->flash_is_locked = stm_is_locked;
  820. #endif
  821. break;
  822. default:
  823. debug("SF: Lock ops not supported for %02x flash\n", idcode[0]);
  824. }
  825. /* Compute the flash size */
  826. flash->shift = (flash->dual_flash & SF_DUAL_PARALLEL_FLASH) ? 1 : 0;
  827. /*
  828. * The Spansion S25FL032P and S25FL064P have 256b pages, yet use the
  829. * 0x4d00 Extended JEDEC code. The rest of the Spansion flashes with
  830. * the 0x4d00 Extended JEDEC code have 512b pages. All of the others
  831. * have 256b pages.
  832. */
  833. if (ext_jedec == 0x4d00) {
  834. if ((jedec == 0x0215) || (jedec == 0x216))
  835. flash->page_size = 256;
  836. else
  837. flash->page_size = 512;
  838. } else {
  839. flash->page_size = 256;
  840. }
  841. flash->page_size <<= flash->shift;
  842. flash->sector_size = params->sector_size << flash->shift;
  843. flash->size = flash->sector_size * params->nr_sectors << flash->shift;
  844. #ifdef CONFIG_SF_DUAL_FLASH
  845. if (flash->dual_flash & SF_DUAL_STACKED_FLASH)
  846. flash->size <<= 1;
  847. #endif
  848. /* Compute erase sector and command */
  849. if (params->flags & SECT_4K) {
  850. flash->erase_cmd = CMD_ERASE_4K;
  851. flash->erase_size = 4096 << flash->shift;
  852. } else if (params->flags & SECT_32K) {
  853. flash->erase_cmd = CMD_ERASE_32K;
  854. flash->erase_size = 32768 << flash->shift;
  855. } else {
  856. flash->erase_cmd = CMD_ERASE_64K;
  857. flash->erase_size = flash->sector_size;
  858. }
  859. /* Now erase size becomes valid sector size */
  860. flash->sector_size = flash->erase_size;
  861. /* Look for the fastest read cmd */
  862. cmd = fls(params->e_rd_cmd & flash->spi->op_mode_rx);
  863. if (cmd) {
  864. cmd = spi_read_cmds_array[cmd - 1];
  865. flash->read_cmd = cmd;
  866. } else {
  867. /* Go for default supported read cmd */
  868. flash->read_cmd = CMD_READ_ARRAY_FAST;
  869. }
  870. /* Not require to look for fastest only two write cmds yet */
  871. if (params->flags & WR_QPP && flash->spi->op_mode_tx & SPI_OPM_TX_QPP)
  872. flash->write_cmd = CMD_QUAD_PAGE_PROGRAM;
  873. else
  874. /* Go for default supported write cmd */
  875. flash->write_cmd = CMD_PAGE_PROGRAM;
  876. /* Set the quad enable bit - only for quad commands */
  877. if ((flash->read_cmd == CMD_READ_QUAD_OUTPUT_FAST) ||
  878. (flash->read_cmd == CMD_READ_QUAD_IO_FAST) ||
  879. (flash->write_cmd == CMD_QUAD_PAGE_PROGRAM)) {
  880. ret = spi_flash_set_qeb(flash, idcode[0]);
  881. if (ret) {
  882. debug("SF: Fail to set QEB for %02x\n", idcode[0]);
  883. return -EINVAL;
  884. }
  885. }
  886. /* Read dummy_byte: dummy byte is determined based on the
  887. * dummy cycles of a particular command.
  888. * Fast commands - dummy_byte = dummy_cycles/8
  889. * I/O commands- dummy_byte = (dummy_cycles * no.of lines)/8
  890. * For I/O commands except cmd[0] everything goes on no.of lines
  891. * based on particular command but incase of fast commands except
  892. * data all go on single line irrespective of command.
  893. */
  894. switch (flash->read_cmd) {
  895. case CMD_READ_QUAD_IO_FAST:
  896. flash->dummy_byte = 2;
  897. break;
  898. case CMD_READ_ARRAY_SLOW:
  899. flash->dummy_byte = 0;
  900. break;
  901. default:
  902. flash->dummy_byte = 1;
  903. }
  904. #ifdef CONFIG_SPI_FLASH_STMICRO
  905. if (params->flags & E_FSR)
  906. flash->flags |= SNOR_F_USE_FSR;
  907. #endif
  908. /* Configure the BAR - discover bank cmds and read current bank */
  909. #ifdef CONFIG_SPI_FLASH_BAR
  910. ret = spi_flash_read_bank(flash, idcode[0]);
  911. if (ret < 0)
  912. return ret;
  913. #endif
  914. #if CONFIG_IS_ENABLED(OF_CONTROL)
  915. ret = spi_flash_decode_fdt(gd->fdt_blob, flash);
  916. if (ret) {
  917. debug("SF: FDT decode error\n");
  918. return -EINVAL;
  919. }
  920. #endif
  921. #ifndef CONFIG_SPL_BUILD
  922. printf("SF: Detected %s with page size ", flash->name);
  923. print_size(flash->page_size, ", erase size ");
  924. print_size(flash->erase_size, ", total ");
  925. print_size(flash->size, "");
  926. if (flash->memory_map)
  927. printf(", mapped at %p", flash->memory_map);
  928. puts("\n");
  929. #endif
  930. #ifndef CONFIG_SPI_FLASH_BAR
  931. if (((flash->dual_flash == SF_SINGLE_FLASH) &&
  932. (flash->size > SPI_FLASH_16MB_BOUN)) ||
  933. ((flash->dual_flash > SF_SINGLE_FLASH) &&
  934. (flash->size > SPI_FLASH_16MB_BOUN << 1))) {
  935. puts("SF: Warning - Only lower 16MiB accessible,");
  936. puts(" Full access #define CONFIG_SPI_FLASH_BAR\n");
  937. }
  938. #endif
  939. return ret;
  940. }