flash.c 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583
  1. /*
  2. * (C) Copyright 2000
  3. * Wolfgang Denk, DENX Software Engineering, wd@denx.de.
  4. * (C) Copyright 2001-2003
  5. *
  6. * Changes for MATRIX Vision mvBLUE devices
  7. * MATRIX Vision GmbH / hg,as info@matrix-vision.de
  8. *
  9. * This program is free software; you can redistribute it and/or
  10. * modify it under the terms of the GNU General Public License as
  11. * published by the Free Software Foundation; either version 2 of
  12. * the License, or (at your option) any later version.
  13. *
  14. * This program is distributed in the hope that it will be useful,
  15. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  17. * GNU General Public License for more details.
  18. *
  19. * You should have received a copy of the GNU General Public License
  20. * along with this program; if not, write to the Free Software
  21. * Foundation, Inc., 59 Temple Place, Suite 330, Boston,
  22. * MA 02111-1307 USA
  23. */
  24. #include <common.h>
  25. #include <mpc824x.h>
  26. #if 0
  27. #define mvdebug(p) printf ##p
  28. #else
  29. #define mvdebug(p)
  30. #endif
  31. flash_info_t flash_info[CONFIG_SYS_MAX_FLASH_BANKS];
  32. #define FLASH_BUS_WIDTH 8
  33. #if (FLASH_BUS_WIDTH==32)
  34. #define FLASH_DATA_MASK 0xffffffff
  35. #define FLASH_SHIFT 1
  36. #define FDT vu_long
  37. #elif (FLASH_BUS_WIDTH==16)
  38. #define FLASH_DATA_MASK 0xff
  39. #define FLASH_SHIFT 0
  40. #define FDT vu_short
  41. #elif (FLASH_BUS_WIDTH==8)
  42. #define FLASH_DATA_MASK 0xff
  43. #define FLASH_SHIFT 0
  44. #define FDT vu_char
  45. #else
  46. #error FLASH_BUS_WIDTH undefined
  47. #endif
  48. /*-----------------------------------------------------------------------
  49. * Functions
  50. */
  51. static ulong flash_get_size (vu_long *address, flash_info_t *info);
  52. static int write_word (flash_info_t *info, ulong dest, ulong data);
  53. static void flash_get_offsets (ulong base, flash_info_t *info);
  54. /*-----------------------------------------------------------------------
  55. */
  56. unsigned long flash_init (void)
  57. {
  58. unsigned long size_b0;
  59. int i;
  60. for (i=0; i<CONFIG_SYS_MAX_FLASH_BANKS; ++i) {
  61. flash_info[i].flash_id = FLASH_UNKNOWN;
  62. }
  63. size_b0 = flash_get_size((vu_long *)0xffc00000, &flash_info[0]);
  64. if (flash_info[0].flash_id == FLASH_UNKNOWN) {
  65. printf ("## Unknown FLASH : Size = 0x%08lx = %ld MB\n",
  66. size_b0, size_b0<<20);
  67. }
  68. flash_get_offsets (0xffc00000, &flash_info[0]);
  69. flash_info[0].size = size_b0;
  70. /* monitor protection OFF by default */
  71. flash_protect ( FLAG_PROTECT_CLEAR, 0xffc00000, 0x2000, flash_info );
  72. return size_b0;
  73. }
  74. /*-----------------------------------------------------------------------
  75. */
  76. static void flash_get_offsets (ulong base, flash_info_t *info)
  77. {
  78. int i;
  79. /* set up sector start address table */
  80. if (info->flash_id & FLASH_BTYPE)
  81. { /* bottom boot sector types - these are the useful ones! */
  82. /* set sector offsets for bottom boot block type */
  83. if ((info->flash_id & FLASH_TYPEMASK) == FLASH_AM320B)
  84. { /* AMDLV320B has 8 x 8k bottom boot sectors */
  85. for (i = 0; i < 8; i++) /* +8k */
  86. info->start[i] = base + (i * (0x00002000 << FLASH_SHIFT));
  87. for (; i < info->sector_count; i++) /* +64k */
  88. info->start[i] = base + (i * (0x00010000 << FLASH_SHIFT)) - (0x00070000 << FLASH_SHIFT);
  89. }
  90. else
  91. { /* other types have 4 bottom boot sectors (16,8,8,32) */
  92. i = 0;
  93. info->start[i++] = base + 0x00000000; /* - */
  94. info->start[i++] = base + (0x00004000 << FLASH_SHIFT); /* +16k */
  95. info->start[i++] = base + (0x00006000 << FLASH_SHIFT); /* +8k */
  96. info->start[i++] = base + (0x00008000 << FLASH_SHIFT); /* +8k */
  97. info->start[i++] = base + (0x00010000 << FLASH_SHIFT); /* +32k */
  98. for (; i < info->sector_count; i++) /* +64k */
  99. info->start[i] = base + (i * (0x00010000 << FLASH_SHIFT)) - (0x00030000 << FLASH_SHIFT);
  100. }
  101. }
  102. else
  103. { /* top boot sector types - not so useful */
  104. /* set sector offsets for top boot block type */
  105. if ((info->flash_id & FLASH_TYPEMASK) == FLASH_AM320T)
  106. { /* AMDLV320T has 8 x 8k top boot sectors */
  107. for (i = 0; i < info->sector_count - 8; i++) /* +64k */
  108. info->start[i] = base + (i * (0x00010000 << FLASH_SHIFT));
  109. for (; i < info->sector_count; i++) /* +8k */
  110. info->start[i] = base + (i * (0x00002000 << FLASH_SHIFT));
  111. }
  112. else
  113. { /* other types have 4 top boot sectors (32,8,8,16) */
  114. for (i = 0; i < info->sector_count - 4; i++) /* +64k */
  115. info->start[i] = base + (i * (0x00010000 << FLASH_SHIFT));
  116. info->start[i++] = base + info->size - (0x00010000 << FLASH_SHIFT); /* -32k */
  117. info->start[i++] = base + info->size - (0x00008000 << FLASH_SHIFT); /* -8k */
  118. info->start[i++] = base + info->size - (0x00006000 << FLASH_SHIFT); /* -8k */
  119. info->start[i] = base + info->size - (0x00004000 << FLASH_SHIFT); /* -16k */
  120. }
  121. }
  122. }
  123. /*-----------------------------------------------------------------------
  124. */
  125. void flash_print_info (flash_info_t *info)
  126. {
  127. int i;
  128. if (info->flash_id == FLASH_UNKNOWN) {
  129. printf ("missing or unknown FLASH type\n");
  130. return;
  131. }
  132. switch (info->flash_id & FLASH_VENDMASK) {
  133. case FLASH_MAN_AMD: printf ("AMD "); break;
  134. case FLASH_MAN_FUJ: printf ("FUJITSU "); break;
  135. case FLASH_MAN_STM: printf ("ST "); break;
  136. default: printf ("Unknown Vendor "); break;
  137. }
  138. switch (info->flash_id & FLASH_TYPEMASK) {
  139. case FLASH_AM160B: printf ("AM29LV160B (16 Mbit, bottom boot sect)\n");
  140. break;
  141. case FLASH_AM160T: printf ("AM29LV160T (16 Mbit, top boot sector)\n");
  142. break;
  143. case FLASH_AM320B: printf ("AM29LV320B (32 Mbit, bottom boot sect)\n");
  144. break;
  145. case FLASH_AM320T: printf ("AM29LV320T (32 Mbit, top boot sector)\n");
  146. break;
  147. case FLASH_STMW320DB: printf ("M29W320B (32 Mbit, bottom boot sect)\n");
  148. break;
  149. case FLASH_STMW320DT: printf ("M29W320T (32 Mbit, top boot sector)\n");
  150. break;
  151. default: printf ("Unknown Chip Type\n");
  152. break;
  153. }
  154. printf (" Size: %ld MB in %d Sectors\n", info->size >> 20, info->sector_count);
  155. printf (" Sector Start Addresses:");
  156. for (i=0; i<info->sector_count; ++i) {
  157. if ((i % 5) == 0)
  158. printf ("\n ");
  159. printf (" %08lX%s", info->start[i], info->protect[i] ? " (RO)" : " ");
  160. }
  161. printf ("\n");
  162. }
  163. /*
  164. * The following code cannot be run from FLASH!
  165. */
  166. #define AMD_ID_LV160T_MVS (AMD_ID_LV160T & FLASH_DATA_MASK)
  167. #define AMD_ID_LV160B_MVS (AMD_ID_LV160B & FLASH_DATA_MASK)
  168. #define AMD_ID_LV320T_MVS (AMD_ID_LV320T & FLASH_DATA_MASK)
  169. #define AMD_ID_LV320B_MVS (AMD_ID_LV320B & FLASH_DATA_MASK)
  170. #define STM_ID_W320DT_MVS (STM_ID_29W320DT & FLASH_DATA_MASK)
  171. #define STM_ID_W320DB_MVS (STM_ID_29W320DB & FLASH_DATA_MASK)
  172. #define AMD_MANUFACT_MVS (AMD_MANUFACT & FLASH_DATA_MASK)
  173. #define FUJ_MANUFACT_MVS (FUJ_MANUFACT & FLASH_DATA_MASK)
  174. #define STM_MANUFACT_MVS (STM_MANUFACT & FLASH_DATA_MASK)
  175. #if (FLASH_BUS_WIDTH >= 16)
  176. #define AUTOSELECT_ADDR1 0x0555
  177. #define AUTOSELECT_ADDR2 0x02AA
  178. #define AUTOSELECT_ADDR3 AUTOSELECT_ADDR1
  179. #else
  180. #define AUTOSELECT_ADDR1 0x0AAA
  181. #define AUTOSELECT_ADDR2 0x0555
  182. #define AUTOSELECT_ADDR3 AUTOSELECT_ADDR1
  183. #endif
  184. #define AUTOSELECT_DATA1 (0x00AA00AA & FLASH_DATA_MASK)
  185. #define AUTOSELECT_DATA2 (0x00550055 & FLASH_DATA_MASK)
  186. #define AUTOSELECT_DATA3 (0x00900090 & FLASH_DATA_MASK)
  187. #define RESET_BANK_DATA (0x00F000F0 & FLASH_DATA_MASK)
  188. static ulong flash_get_size (vu_long *address, flash_info_t *info)
  189. {
  190. short i;
  191. FDT value;
  192. FDT *addr = (FDT *)address;
  193. ulong base = (ulong)address;
  194. addr[AUTOSELECT_ADDR1] = AUTOSELECT_DATA1;
  195. addr[AUTOSELECT_ADDR2] = AUTOSELECT_DATA2;
  196. addr[AUTOSELECT_ADDR3] = AUTOSELECT_DATA3;
  197. __asm__ __volatile__("sync");
  198. udelay(180);
  199. value = addr[0]; /* manufacturer ID */
  200. switch (value) {
  201. case AMD_MANUFACT_MVS:
  202. info->flash_id = FLASH_MAN_AMD;
  203. break;
  204. case FUJ_MANUFACT_MVS:
  205. info->flash_id = FLASH_MAN_FUJ;
  206. break;
  207. case STM_MANUFACT_MVS:
  208. info->flash_id = FLASH_MAN_STM;
  209. break;
  210. default:
  211. info->flash_id = FLASH_UNKNOWN;
  212. info->sector_count = 0;
  213. info->size = 0;
  214. return (0); /* no or unknown flash */
  215. }
  216. #if (FLASH_BUS_WIDTH >= 16)
  217. value = addr[1]; /* device ID */
  218. #else
  219. value = addr[2]; /* device ID */
  220. #endif
  221. switch (value) {
  222. case AMD_ID_LV160T_MVS:
  223. info->flash_id += FLASH_AM160T;
  224. info->sector_count = 37;
  225. info->size = (0x00200000 << FLASH_SHIFT);
  226. break; /* => 2 or 4 MB */
  227. case AMD_ID_LV160B_MVS:
  228. info->flash_id += FLASH_AM160B;
  229. info->sector_count = 37;
  230. info->size = (0x00200000 << FLASH_SHIFT);
  231. break; /* => 2 or 4 MB */
  232. case AMD_ID_LV320T_MVS:
  233. info->flash_id += FLASH_AM320T;
  234. info->sector_count = 71;
  235. info->size = (0x00400000 << FLASH_SHIFT);
  236. break; /* => 4 or 8 MB */
  237. case AMD_ID_LV320B_MVS:
  238. info->flash_id += FLASH_AM320B;
  239. info->sector_count = 71;
  240. info->size = (0x00400000 << FLASH_SHIFT);
  241. break; /* => 4 or 8MB */
  242. case STM_ID_W320DT_MVS:
  243. info->flash_id += FLASH_STMW320DT;
  244. info->sector_count = 67;
  245. info->size = (0x00400000 << FLASH_SHIFT);
  246. break; /* => 4 or 8 MB */
  247. case STM_ID_W320DB_MVS:
  248. info->flash_id += FLASH_STMW320DB;
  249. info->sector_count = 67;
  250. info->size = (0x00400000 << FLASH_SHIFT);
  251. break; /* => 4 or 8MB */
  252. default:
  253. info->flash_id = FLASH_UNKNOWN;
  254. return (0); /* => no or unknown flash */
  255. }
  256. /* set up sector start address table */
  257. flash_get_offsets (base, info);
  258. /* check for protected sectors */
  259. for (i = 0; i < info->sector_count; i++) {
  260. /* read sector protection at sector address, (A7 .. A0) = 0x02 */
  261. /* D0 = 1 if protected */
  262. addr = (FDT *)(info->start[i]);
  263. info->protect[i] = addr[2] & 1;
  264. }
  265. /*
  266. * Prevent writes to uninitialized FLASH.
  267. */
  268. if (info->flash_id != FLASH_UNKNOWN) {
  269. addr = (FDT *)info->start[0];
  270. *addr = RESET_BANK_DATA; /* reset bank */
  271. }
  272. return (info->size);
  273. }
  274. /*-----------------------------------------------------------------------
  275. */
  276. #if (FLASH_BUS_WIDTH >= 16)
  277. #define ERASE_ADDR1 0x0555
  278. #define ERASE_ADDR2 0x02AA
  279. #else
  280. #define ERASE_ADDR1 0x0AAA
  281. #define ERASE_ADDR2 0x0555
  282. #endif
  283. #define ERASE_ADDR3 ERASE_ADDR1
  284. #define ERASE_ADDR4 ERASE_ADDR1
  285. #define ERASE_ADDR5 ERASE_ADDR2
  286. #define ERASE_DATA1 (0x00AA00AA & FLASH_DATA_MASK)
  287. #define ERASE_DATA2 (0x00550055 & FLASH_DATA_MASK)
  288. #define ERASE_DATA3 (0x00800080 & FLASH_DATA_MASK)
  289. #define ERASE_DATA4 ERASE_DATA1
  290. #define ERASE_DATA5 ERASE_DATA2
  291. #define ERASE_SECTOR_DATA (0x00300030 & FLASH_DATA_MASK)
  292. #define ERASE_CHIP_DATA (0x00100010 & FLASH_DATA_MASK)
  293. #define ERASE_CONFIRM_DATA (0x00800080 & FLASH_DATA_MASK)
  294. int flash_erase (flash_info_t *info, int s_first, int s_last)
  295. {
  296. FDT *addr = (FDT *)(info->start[0]);
  297. int prot, sect, l_sect, flag;
  298. ulong start, now, last;
  299. __asm__ __volatile__ ("sync");
  300. addr[0] = 0xf0;
  301. udelay(1000);
  302. printf("\nflash_erase: first = %d @ 0x%08lx\n", s_first, info->start[s_first] );
  303. printf(" last = %d @ 0x%08lx\n", s_last , info->start[s_last ] );
  304. if ((s_first < 0) || (s_first > s_last)) {
  305. if (info->flash_id == FLASH_UNKNOWN) {
  306. printf ("- missing\n");
  307. } else {
  308. printf ("- no sectors to erase\n");
  309. }
  310. return 1;
  311. }
  312. if ((info->flash_id == FLASH_UNKNOWN) || (info->flash_id > FLASH_AMD_COMP)) {
  313. printf ("Can't erase unknown flash type %08lx - aborted\n", info->flash_id);
  314. return 1;
  315. }
  316. prot = 0;
  317. for (sect=s_first; sect<=s_last; ++sect) {
  318. if (info->protect[sect]) {
  319. prot++;
  320. }
  321. }
  322. if (prot) {
  323. printf ("- Warning: %d protected sectors will not be erased!\n",
  324. prot);
  325. } else {
  326. printf ("\n");
  327. }
  328. l_sect = -1;
  329. /* Disable interrupts which might cause a timeout here */
  330. flag = disable_interrupts();
  331. addr[ERASE_ADDR1] = ERASE_DATA1;
  332. addr[ERASE_ADDR2] = ERASE_DATA2;
  333. addr[ERASE_ADDR3] = ERASE_DATA3;
  334. addr[ERASE_ADDR4] = ERASE_DATA4;
  335. addr[ERASE_ADDR5] = ERASE_DATA5;
  336. for (sect = s_first; sect <= s_last; sect++) {
  337. if (info->protect[sect] == 0) {
  338. addr = (FDT *)(info->start[sect]);
  339. addr[0] = ERASE_SECTOR_DATA;
  340. l_sect = sect;
  341. }
  342. }
  343. if (flag)
  344. enable_interrupts();
  345. /*
  346. * We wait for the last triggered sector
  347. */
  348. if (l_sect < 0)
  349. goto DONE;
  350. start = get_timer (0);
  351. last = start;
  352. addr = (FDT *)(info->start[l_sect]);
  353. while ((addr[0] & ERASE_CONFIRM_DATA) != ERASE_CONFIRM_DATA) {
  354. if ((now = get_timer(start)) > CONFIG_SYS_FLASH_ERASE_TOUT) {
  355. printf ("Timeout\n");
  356. return 1;
  357. }
  358. /* show that we're waiting */
  359. if ((now - last) > 1000) { /* every second */
  360. putc ('.');
  361. last = now;
  362. }
  363. }
  364. DONE:
  365. printf (" done\n");
  366. return 0;
  367. }
  368. /*-----------------------------------------------------------------------
  369. * Copy memory to flash, returns:
  370. * 0 - OK
  371. * 1 - write timeout
  372. * 2 - Flash not erased
  373. */
  374. int write_buff (flash_info_t *info, uchar *src, ulong addr, ulong cnt)
  375. {
  376. #define BUFF_INC 4
  377. ulong cp, wp, data;
  378. int i, l, rc;
  379. mvdebug (("+write_buff %p ==> 0x%08lx, count = 0x%08lx\n", src, addr, cnt));
  380. wp = (addr & ~3); /* get lower word aligned address */
  381. /*
  382. * handle unaligned start bytes
  383. */
  384. if ((l = addr - wp) != 0) {
  385. mvdebug ((" handle unaligned start bytes (cnt = 0x%08lx)\n", cnt));
  386. data = 0;
  387. for (i=0, cp=wp; i<l; ++i, ++cp) {
  388. data = (data << 8) | (*(uchar *)cp);
  389. }
  390. for (; i<BUFF_INC && cnt>0; ++i) {
  391. data = (data << 8) | *src++;
  392. --cnt;
  393. ++cp;
  394. }
  395. for (; cnt==0 && i<BUFF_INC; ++i, ++cp) {
  396. data = (data << 8) | (*(uchar *)cp);
  397. }
  398. if ((rc = write_word(info, wp, data)) != 0) {
  399. return (rc);
  400. }
  401. wp += BUFF_INC;
  402. }
  403. /*
  404. * handle (half)word aligned part
  405. */
  406. mvdebug ((" handle word aligned part (cnt = 0x%08lx)\n", cnt));
  407. while (cnt >= BUFF_INC) {
  408. data = 0;
  409. for (i=0; i<BUFF_INC; ++i) {
  410. data = (data << 8) | *src++;
  411. }
  412. if ((rc = write_word(info, wp, data)) != 0) {
  413. return (rc);
  414. }
  415. wp += BUFF_INC;
  416. cnt -= BUFF_INC;
  417. }
  418. if (cnt == 0) {
  419. return (0);
  420. }
  421. /*
  422. * handle unaligned tail bytes
  423. */
  424. mvdebug ((" handle unaligned tail bytes (cnt = 0x%08lx)\n", cnt));
  425. data = 0;
  426. for (i=0, cp=wp; i<BUFF_INC && cnt>0; ++i, ++cp) {
  427. data = (data << 8) | *src++;
  428. --cnt;
  429. }
  430. for (; i<BUFF_INC; ++i, ++cp) {
  431. data = (data << 8) | (*(uchar *)cp);
  432. }
  433. return (write_word(info, wp, data));
  434. }
  435. #if (FLASH_BUS_WIDTH >= 16)
  436. #define WRITE_ADDR1 0x0555
  437. #define WRITE_ADDR2 0x02AA
  438. #else
  439. #define WRITE_ADDR1 0x0AAA
  440. #define WRITE_ADDR2 0x0555
  441. #define WRITE_ADDR3 WRITE_ADDR1
  442. #endif
  443. #define WRITE_DATA1 (0x00AA00AA & FLASH_DATA_MASK)
  444. #define WRITE_DATA2 (0x00550055 & FLASH_DATA_MASK)
  445. #define WRITE_DATA3 (0x00A000A0 & FLASH_DATA_MASK)
  446. #define WRITE_CONFIRM_DATA ERASE_CONFIRM_DATA
  447. /*-----------------------------------------------------------------------
  448. * Write a byte to Flash, returns:
  449. * 0 - OK
  450. * 1 - write timeout
  451. * 2 - Flash not erased
  452. */
  453. static int write_char (flash_info_t *info, ulong dest, uchar data)
  454. {
  455. vu_char *addr = (vu_char *)(info->start[0]);
  456. ulong start;
  457. int flag;
  458. /* Check if Flash is (sufficiently) erased */
  459. if ((*((vu_char *)dest) & data) != data) {
  460. printf(" *** ERROR: Flash not erased !\n");
  461. return (2);
  462. }
  463. flag = disable_interrupts();
  464. addr[WRITE_ADDR1] = WRITE_DATA1;
  465. addr[WRITE_ADDR2] = WRITE_DATA2;
  466. addr[WRITE_ADDR3] = WRITE_DATA3;
  467. *((vu_char *)dest) = data;
  468. if (flag)
  469. enable_interrupts();
  470. /* data polling for D7 */
  471. start = get_timer (0);
  472. addr = (vu_char *)dest;
  473. while (( (*addr) & WRITE_CONFIRM_DATA) != (data & WRITE_CONFIRM_DATA)) {
  474. if (get_timer(start) > CONFIG_SYS_FLASH_WRITE_TOUT) {
  475. printf(" *** ERROR: Flash write timeout !");
  476. return (1);
  477. }
  478. }
  479. mvdebug (("-write_byte\n"));
  480. return (0);
  481. }
  482. /*-----------------------------------------------------------------------
  483. * Write a word to Flash, returns:
  484. * 0 - OK
  485. * 1 - write timeout
  486. * 2 - Flash not erased
  487. */
  488. static int write_word (flash_info_t *info, ulong dest, ulong data)
  489. {
  490. int i,
  491. result = 0;
  492. mvdebug (("+write_word : 0x%08lx @ 0x%08lx\n", data, dest));
  493. for ( i=0; (i < 4) && (result == 0); i++, dest+=1 )
  494. result = write_char (info, dest, (data >> (8*(3-i))) & 0xff );
  495. mvdebug (("-write_word\n"));
  496. return result;
  497. }
  498. /*---------------------------------------------------------------- */