3 * Wolfgang Denk, DENX Software Engineering, wd@denx.de.
5 * SPDX-License-Identifier: GPL-2.0+
13 #include <mtd/cfi_flash.h>
15 extern flash_info_t flash_info
[]; /* info for FLASH chips */
17 /*-----------------------------------------------------------------------
21 /*-----------------------------------------------------------------------
22 * Set protection status for monitor sectors
24 * The monitor is always located in the _first_ Flash bank.
25 * If necessary you have to map the second bank at lower addresses.
28 flash_protect (int flag
, ulong from
, ulong to
, flash_info_t
*info
)
34 /* Do nothing if input data is bad. */
35 if (!info
|| info
->sector_count
== 0 || info
->size
== 0 || to
< from
) {
39 s_end
= info
->sector_count
- 1; /* index of last sector */
40 b_end
= info
->start
[0] + info
->size
- 1; /* bank end address */
42 debug ("flash_protect %s: from 0x%08lX to 0x%08lX\n",
43 (flag
& FLAG_PROTECT_SET
) ? "ON" :
44 (flag
& FLAG_PROTECT_CLEAR
) ? "OFF" : "???",
47 /* There is nothing to do if we have no data about the flash
48 * or the protect range and flash range don't overlap.
50 if (info
->flash_id
== FLASH_UNKNOWN
||
51 to
< info
->start
[0] || from
> b_end
) {
55 for (i
=0; i
<info
->sector_count
; ++i
) {
56 ulong end
; /* last address in current sect */
58 end
= (i
== s_end
) ? b_end
: info
->start
[i
+ 1] - 1;
60 /* Update protection if any part of the sector
61 * is in the specified range.
63 if (from
<= end
&& to
>= info
->start
[i
]) {
64 if (flag
& FLAG_PROTECT_CLEAR
) {
65 #if defined(CONFIG_SYS_FLASH_PROTECTION)
66 flash_real_protect(info
, i
, 0);
69 #endif /* CONFIG_SYS_FLASH_PROTECTION */
70 debug ("protect off %d\n", i
);
72 else if (flag
& FLAG_PROTECT_SET
) {
73 #if defined(CONFIG_SYS_FLASH_PROTECTION)
74 flash_real_protect(info
, i
, 1);
77 #endif /* CONFIG_SYS_FLASH_PROTECTION */
78 debug ("protect on %d\n", i
);
84 /*-----------------------------------------------------------------------
88 addr2info (ulong addr
)
93 for (i
=0, info
= &flash_info
[0]; i
<CONFIG_SYS_MAX_FLASH_BANKS
; ++i
, ++info
) {
94 if (info
->flash_id
!= FLASH_UNKNOWN
&&
95 addr
>= info
->start
[0] &&
96 /* WARNING - The '- 1' is needed if the flash
97 * is at the end of the address space, since
98 * info->start[0] + info->size wraps back to 0.
99 * Please don't change this unless you understand this.
101 addr
<= info
->start
[0] + info
->size
- 1) {
109 /*-----------------------------------------------------------------------
110 * Copy memory to flash.
111 * Make sure all target addresses are within Flash bounds,
112 * and no protected sectors are hit.
115 * ERR_TIMOUT 1 - write timeout
116 * ERR_NOT_ERASED 2 - Flash not erased
117 * ERR_PROTECTED 4 - target range includes protected sectors
118 * ERR_INVAL 8 - target address not in Flash memory
119 * ERR_ALIGN 16 - target address not aligned on boundary
120 * (only some targets require alignment)
123 flash_write (char *src
, ulong addr
, ulong cnt
)
126 ulong end
= addr
+ cnt
- 1;
127 flash_info_t
*info_first
= addr2info (addr
);
128 flash_info_t
*info_last
= addr2info (end
);
130 __maybe_unused
char *src_orig
= src
;
131 __maybe_unused
char *addr_orig
= (char *)addr
;
132 __maybe_unused ulong cnt_orig
= cnt
;
138 if (!info_first
|| !info_last
) {
142 for (info
= info_first
; info
<= info_last
; ++info
) {
143 ulong b_end
= info
->start
[0] + info
->size
; /* bank end addr */
144 short s_end
= info
->sector_count
- 1;
145 for (i
=0; i
<info
->sector_count
; ++i
) {
146 ulong e_addr
= (i
== s_end
) ? b_end
: info
->start
[i
+ 1];
148 if ((end
>= info
->start
[i
]) && (addr
< e_addr
) &&
149 (info
->protect
[i
] != 0) ) {
150 return (ERR_PROTECTED
);
155 /* finally write data to flash */
156 for (info
= info_first
; info
<= info_last
&& cnt
>0; ++info
) {
159 len
= info
->start
[0] + info
->size
- addr
;
162 if ((i
= write_buff(info
, (uchar
*)src
, addr
, len
)) != 0) {
170 #if defined(CONFIG_FLASH_VERIFY)
171 if (memcmp(src_orig
, addr_orig
, cnt_orig
)) {
172 printf("\nVerify failed!\n");
173 return ERR_PROG_ERROR
;
175 #endif /* CONFIG_SYS_FLASH_VERIFY_AFTER_WRITE */
180 /*-----------------------------------------------------------------------
183 void flash_perror (int err
)
189 puts ("Timeout writing to Flash\n");
192 puts ("Flash not Erased\n");
195 puts ("Can't write to protected Flash sectors\n");
198 puts ("Outside available Flash\n");
201 puts ("Start and/or end address not on sector boundary\n");
203 case ERR_UNKNOWN_FLASH_VENDOR
:
204 puts ("Unknown Vendor of Flash\n");
206 case ERR_UNKNOWN_FLASH_TYPE
:
207 puts ("Unknown Type of Flash\n");
210 puts ("General Flash Programming Error\n");
213 puts("Flash Programming Aborted\n");
216 printf ("%s[%d] FIXME: rc=%d\n", __FILE__
, __LINE__
, err
);