【经验分享】STM32F7 内部flash操作启动

[复制链接]

STMCU小助手发布时间：2021-12-11 12:00

文章
文章封面:
文章简介:	总体来说与STM32F4操作是一样的，就是扇区大小变化了，测试过程中发现当PG=1之后立即写入数据到flash会造成编程顺序错误，通过增加一个nop的延时即可解决此问题，还可以通过将多个数据连续烧写的方式避免此问题，就是当PG=1之后，把所有数据都烧写完成后再将PG=0，不要频繁的开关。

总体来说与STM32F4操作是一样的，就是扇区大小变化了，测试过程中发现当PG=1之后立即写入数据到flash会造成编程顺序错误，通过增加一个nop的延时即可解决此问题，还可以通过将多个数据连续烧写的方式避免此问题，就是当PG=1之后，把所有数据都烧写完成后再将PG=0，不要频繁的开关。

/*************************************************************************************************************
7 R4 O m& W6 Y. ~) p9 R) q
* 文件名: stm32f7_flash.c
5 b9 a/ N% X$ Q
* 功能: STM32F7 内部FLASH编程驱动函数
8 o! p/ u8 C9 R) d, J& i* X- w
* 作者: <a href="mailto:cp1300@139.com">cp1300@139.com</a>- {: }& L8 F/ Z/ ^; k
* 创建时间: 2013-10-20
3 h1 C6 {; f$ i: |8 h
* 最后修改时间: 2020-02-07
; \1 M' g% @) F: b2 n7 b, h9 ?
* 详细: 用于STM32F7内部flash读写驱动: C- k+ V' D7 z g6 l
默认为3.3V供电，并且宽度为32bit;4 L. T, g8 w, A$ m7 q
扇区擦除最长时间：32KB扇区500ms；128KB扇区1.1秒；256KB扇区：2秒: p3 J" e0 C M3 J9 S2 w
修复STM32F7开始写入数据时，PG=1后没有延时导致异常，增加批量写入多个字的数据函数STM32FLASH_WriteMultipledWord()支持。' C8 L+ x7 ]+ s; @$ N5 `1 Z
*************************************************************************************************************/
! }/ \# d0 A d& R: n/ k# p e
#include "stm32f7_flash.h"
; R: T$ d% `% W& V
#include "system.h"
O0 o9 }* z4 l, H: }5 Y; }
#if(SYS_WDG_EN_) //使能了看门狗0 O3 B! F( p4 T( ?1 S
#include "wdg.h"
' k: Q O) B& W/ a- B% Q
#endif //SYS_WDG_EN_
; U% y! U" d8 a0 @
, `( [9 L: k! j; `, }' o- v
- I! k p0 D0 I
6 S: W4 r) ]4 e7 X$ M4 e8 E
2 C% v) D2 r6 x4 G: L3 s
/*************************************************************************************************************************
6 C' l1 V0 s$ R g; v
* 函数 : void STM32FLASH_Unlock(void)
# D: v9 _& k. k" h c1 _4 P) b
* 功能 : 解锁STM32的FLASH
4 a T8 \4 J$ u) D0 C
* 参数 : 无
! _ Y+ P4 H$ s7 t! @2 i7 |0 g
* 返回 : 无
3 b7 [; }* G' r) B0 ~5 W, v4 K" x6 w
* 依赖 : 底层. D2 I7 S9 \# ~: Q
* 作者 : <a href="mailto:cp1300@139.com">cp1300@139.com</a>* T: ^6 _! O" P/ } X
* 时间 : 2013-10-20+ W. `* s) E# _" X0 t/ w) [
* 最后修改时间 : 2013-10-20
( u/ u9 C9 }, ~, i: Y4 j9 C8 x+ H
* 说明 : ' d* O* o7 `* m, I
*************************************************************************************************************************/+ U2 Q% W$ Y/ v" M0 g6 l d) m5 c4 I( ?
void STM32FLASH_Unlock(void)5 A9 z2 `3 A; V! o; w# j! |
{! m8 i2 s6 H9 w' ^
FLASH->KEYR=FLASH_KEY1; //写入解锁序列.
* T4 v8 L( [2 P5 W( Q
FLASH->KEYR=FLASH_KEY2;- Z7 |9 Z6 `" @( a1 J9 U1 {
}
; Z7 w; y" V, ?7 b+ |4 ]
' ]: A# g$ e2 N" E
- `/ N. F; |$ ^
0 v* b6 J+ c( F9 K" k% i2 c* t
/*************************************************************************************************************************
% f5 h/ l; L, I' {
* 函数 : void STM32FLASH_Lock(void)+ C9 C& j( k( E& f
* 功能 : 上锁STM32的FLASH
4 n5 [& p: D4 p2 z
* 参数 : 无5 \ ^: r9 q* E. X' ?. k- z
* 返回 : 无! B, g, }9 E% O4 ^8 U! c
* 依赖 : 底层8 i* q3 E/ n% g' g* d: V: Z4 r
* 作者 : <a href="mailto:cp1300@139.com">cp1300@139.com</a>
, ~; Z0 s; D! ^; ^
* 时间 : 2013-10-20: R, A4 j$ m: X% J* Q! a
* 最后修改时间 : 2018-01-13
7 w' C- {1 B7 P" R; S0 o
* 说明 : ) V) |5 {- ^5 L7 f$ w
*************************************************************************************************************************/ D5 ]6 [9 @5 X1 Z+ l. P
void STM32FLASH_Lock(void)7 \/ K- o) P/ R
{$ W6 G2 A# Q- G# ^2 _" G$ K
FLASH->CR|=(u32)1<<31; //上锁
7 ~* n5 w( x/ p5 X
}
& i7 j D6 v0 r& O5 `9 m5 \+ W% j
; b3 T% m N* x& R4 [4 W
, {# Q i" v6 R z+ w
0 k1 A! v9 D/ J. `4 t2 ^% W+ r
6 G. E4 I5 G' b9 `& r3 Q# @2 f
/*************************************************************************************************************************& P! W2 E k4 F9 d
* 函数 : STM32FLASH_STATUS STM32FLASH_GetStatus(void): R1 k7 c; T2 y5 c8 T8 S- R" Q
* 功能 : 得到FLASH状态
( d) k; \- D, c- c3 h+ e$ N
* 参数 : 无
+ }2 h+ I5 C( J4 M
* 返回 : STM32FLASH_STATUS7 E4 t+ n" J6 x. {# N
* 依赖 : 底层
& t/ ~, z6 I R( C
* 作者 : <a href="mailto:cp1300@139.com">cp1300@139.com</a>8 r* |* m) |6 D/ X6 `
* 时间 : 2013-10-201 Z, B# m0 p! |( {0 B
* 最后修改时间 : 2018-01-034 z- v9 j5 k* i& [1 e
* 说明 : 0 f/ w" ?: {; S9 H6 [* X- r
*************************************************************************************************************************/0 E1 J% P+ D0 ], ^
STM32FLASH_STATUS STM32FLASH_GetStatus(void)
& F7 i8 `3 ]. c7 ~/ h" t
{ 9 {! S' g' {. O! p6 U
u32 temp=FLASH->SR;
3 O8 d, c( G. G- m% P$ I: b
) w4 L, f0 L& h, W$ o. I4 B
if(temp&(1<<16))return STM32FLASH_BUSY; //忙% J- W( U5 f, `0 h. Q
else if(temp&(1<<4))return STM32FLASH_WPRERR; //写保护错误5 \" y" m7 m7 v# h, u
else if(temp&(1<<5))return STM32FLASH_PGAERR; //编程对齐错误
+ S. ~8 @; r' v) k
else if(temp&(1<<6))return STM32FLASH_PGPERR; //并行位数错误
, f! P( h2 Y4 V* H
else if(temp&(1<<7))return STM32FLASH_PGSERR; //擦除顺序错误
5 N6 a" x7 E" G# M( o( G
else if(temp&(1<<1))return STM32FLASH_OPERR; //操作错误
: o( I" [: L' t0 e
return STM32FLASH_OK; //操作完成# p7 @/ b: p! _2 o
}
5 [, E% q7 s/ \ D# x) J! Y9 c
- n# n$ S- j( G8 b- z' ?7 a
) C3 n% l; s5 I0 @
$ r, h% r: ?+ L u: r- s1 f5 D
/*************************************************************************************************************************2 {' @- U) b! U1 M! G8 \- ~6 d" {
* 函数 : STM32FLASH_STATUS STM32FLASH_WaitDone(u32 time)9 j+ u3 C9 ]" Q
* 功能 : 等待操作完成
3 T0 B+ N: ~% _: @* r" Z* c/ s6 s
* 参数 : time:要延时的长短,单位us
2 L8 W' j' n) b( k; s# m
* 返回 : STM32FLASH_STATUS
5 b6 D6 @8 E$ H
* 依赖 : 底层+ D# y) V+ }% d1 W7 G* ^: y
* 作者 : <a href="mailto:cp1300@139.com">cp1300@139.com</a>
, [. Y1 y( E8 M4 z1 _
* 时间 : 2013-10-20" H3 F. @1 b! L; t! O
* 最后修改时间 : 2018-01-038 c7 j" l* P( ]0 \: Z8 c* I: q
* 说明 : 2018-03-24：增加清除看门狗功能, [. M4 ~$ W8 G0 T& A! ~2 b
*************************************************************************************************************************/! V1 `( [- q/ H/ e! D0 h
STM32FLASH_STATUS STM32FLASH_WaitDone(u32 time), G( O% {, B8 U$ K
{
- i4 N5 a' G8 O- H, ^& z, P6 Y
STM32FLASH_STATUS status;4 n* f I! D1 y4 V2 }
: N& }4 L" w1 F* g: b5 b0 ~
if(time < 1) time = 1;
/ B8 X2 q# i7 \& b
do
/ g9 _" y" m( }) C
{- U0 A% b& F4 N8 l9 ?" P
status=STM32FLASH_GetStatus(); //获取状态
; U2 S1 u% l1 k' k$ C! U+ `
if(status!=STM32FLASH_BUSY)break; //非忙,无需等待了,直接退出.& b c u- h" Z8 ]6 X- }, q$ b
Delay_US(1);
% k4 x7 Q1 v4 J. _
time--;3 B& U1 c. `7 a o5 D! A7 w1 ~
~) u" e" k0 w/ T( ~) e3 z
#if(SYS_WDG_EN_) //使能了看门狗
6 b* @8 {5 L+ a
IWDG_Feed();8 D4 R& p" L0 ? {+ V
#endif //SYS_WDG_EN_
. O/ k0 d* [- V) p, W& w
0 [) f5 Q- F" t0 C5 L
}while(time);+ D3 M& [% q- \- R5 q
0 m& A+ ~9 ^) m6 h x
return status;' S( G4 h/ `* c6 X4 N9 F9 V: Q
}5 S; b- G1 N. `* p
+ Q4 ^0 q9 u4 s( S9 J
$ B2 T6 u3 U, E
8 U' v$ n" p7 D% X- B
/*************************************************************************************************************************
& C/ g1 N& ?/ q0 D i7 [
* 函数 : STM32FLASH_STATUS STM32FLASH_EraseSector(u8 sectoraddr); @- k4 I7 o+ z3 v h1 X8 n u r
* 功能 : 扇区擦除
4 r! T6 r0 C8 B1 e
* 参数 : sectoraddr：扇区地址，0-11
! H' ~/ w3 ?6 L
* 返回 : STM32FLASH_STATUS
* z# W) n- z$ D8 x& E
* 依赖 : 底层! c6 a3 \3 Q1 }; o
* 作者 : <a href="mailto:cp1300@139.com">cp1300@139.com</a>, H4 y7 [1 c3 ?
* 时间 : 2018-01-03
x4 K) d' e6 Q. m4 \' J
* 最后修改时间 : 2018-01-03; e* E2 l J$ f
* 说明 : 扇区大小：0~3：16KB扇区;4：64KB扇区;5~11：128KB扇区% |: c8 H7 ^' [6 z# v
128KB扇区擦除足最大2秒
/ N' E9 r/ l" T, N7 P& w
2018-01-16:修复扇区擦除时没有解锁问题( y( S( _" X8 k* V
*************************************************************************************************************************/
7 [# d& o* s8 h, v$ D. A4 m, k6 H
STM32FLASH_STATUS STM32FLASH_EraseSector(u8 sectoraddr)* E# |8 c w# @5 C$ Z. d- f
{$ H2 m3 ^3 R; x
STM32FLASH_STATUS status;, f4 \0 c$ K: s# h& @
) t: l1 X+ |! W! ?" u7 G
if(FLASH->SR) //有错误，需要清除，测试过程中，发现偶尔启动后会有错误出现
* w7 a8 j, a8 L
{
5 l) @& y- V! G! S+ P- w- ?4 r
DEBUG("需要清除flash错误标记，FLASH_SR=0x%X FLASH_CR=0x%X\r\n",FLASH->SR, FLASH->CR);
. s G+ Q& h) w9 _9 u$ ~
FLASH->SR |= FLASH->SR;2 e! d6 E( ^ L* Y: Z2 _
DEBUG("FLASH_SR=0x%X FLASH_CR=0x%X\r\n",FLASH->SR, FLASH->CR);* N5 ^- z! B1 c3 ?
}
3 W, {- r. m; `, p# o
6 v5 w$ V0 h2 ]# P- Y
status=STM32FLASH_WaitDone(2100000); //等待上次操作完成，最大时间2秒，如果已经操作完成了会直接跳过: ^& X! F% D u! |6 o9 @+ ~
# W& `) m- W& u" u2 Z ~
STM32FLASH_Unlock(); //解锁 3 a3 s6 z# s, Q. o* r2 h+ x
if(status==STM32FLASH_OK) //没有错误
6 y& m- A! S1 k) h
{ / v# q _0 G+ j9 T
FLASH->CR&=~(3<<8); //清除PSIZE原来的设置2 l& [% z: y v# R
FLASH->CR|=2<<8; //设置为32bit宽,确保VCC=2.7~3.6V之间!!
" {6 E# `7 N! P- [5 l
FLASH->CR&=~(0XF<<3); //清除原来的设置
+ u, x8 s; D7 x$ {5 N8 ]% f
FLASH->CR|=(sectoraddr&0x7)<<3; //设置要擦除的扇区 5 I4 a* R- y8 ]2 t& h0 t
FLASH->CR|=1<<1; //扇区擦除 ) C+ A$ [# l, {1 L4 ^
FLASH->CR|=1<<16; //开始擦除) C, g: c9 H, q. N* r' Q& s
status=STM32FLASH_WaitDone(2300000);//等待操作结束,最大2s
+ }) q6 A1 Y8 K0 s- G9 q% P
if(status!=STM32FLASH_BUSY) //非忙9 u5 G$ g1 p& h7 c
{* Y$ l3 S+ \) z/ T7 o: H% e
FLASH->CR&=~(1<<1); //清除扇区擦除标志.2 d o0 i9 G, L: k) V% c
}
5 `1 I+ R8 T$ v% q3 \
}
3 `2 x$ ?' e1 K. i0 K5 H0 X
//DEBUG("扇区擦除状态：%d\r\n", status);# M* m- \$ Z7 x2 t" z8 R
//DEBUG("FLASH_SR=0x%X FLASH_CR=0x%X\r\n", FLASH->SR, FLASH->CR);, O$ O( e, \4 P# w( [" S
( l$ R2 p/ _3 c& ?) {+ }
STM32FLASH_Lock(); //上锁
7 q2 C# t1 l ?7 E1 [3 u6 g
if(status != STM32FLASH_OK)
( m. g) b' |; ^' ~
{
3 \: h: ~, V7 k" G: b4 \0 Y8 m
DEBUG("擦除扇区%d失败(错误:%d) FLASH_SR=0x%X FLASH_CR=0x%X\r\n",sectoraddr, status, FLASH->SR, FLASH->CR);; r T7 q/ c* ?4 O4 {$ f1 N6 x% C+ ~
}
: q" b0 E M& P- h6 f6 H0 R- N) j
. c2 ?! j5 H% M% K
return status; //返回状态0 [8 z* t3 \5 h, `
}+ u1 x: K6 m( t' R# {
8 o; t+ E3 B9 d- \
- H# F( O9 F! O( v
- }% {6 V, }. V- @% Y" b
5 i. C5 Z4 p& C% [& A& D6 k
/*************************************************************************************************************************
* T b/ C8 ?1 r! G1 n
* 函数 : STM32FLASH_STATUS STM32FLASH_WritedWord(u32 faddr, u32 data)) V: \0 H8 l: B- K0 g" h9 [
* 功能 : 在FLASH指定地址写入一个字的数据（32bit写入）6 N B6 B* y6 I" g0 u3 ?
* 参数 : faddr:指定地址(此地址必须为4的倍数!!);data:要写入的数据
$ J) F, i6 B# o8 ^8 ?5 X3 `5 Q
* 返回 : STM32FLASH_STATUS' L, Z5 f( c# u
* 依赖 : 底层4 M. E1 B, l4 ]8 C) z1 Q
* 作者 : <a href="mailto:cp1300@139.com">cp1300@139.com</a>" Y$ w( V9 i5 V# @7 u
* 时间 : 2018-01-03& E5 k0 K6 Y9 W, I3 @- v+ ?: ^( Q
* 最后修改时间 : 2018-01-03. ?$ O. d, c6 p2 B
* 说明 : 警告，地址必须为4的倍数, n' m: y0 L A4 a& |3 p) S
2020-02-08执行PG=1须增加延时，否则可能出现顺序错误，不会执行flash解锁
: K0 T6 l0 l; o
不会判断是否能写入# R2 f& n6 ~+ o \0 G+ V" Q
*************************************************************************************************************************/
+ y0 Q; k& r n( d- ~
STM32FLASH_STATUS STM32FLASH_WritedWord(u32 faddr, u32 data)( U% E8 _' O* u* m6 ?9 O7 u
{, k' D& `: J# o- P2 z' f1 [/ F( E2 l
STM32FLASH_STATUS status;
0 K9 z$ X1 Y# }4 K. \- l" w
, M- y m! D5 y4 d% G" l
status=STM32FLASH_WaitDone(200); //判断状态1 k- Q# [5 f! j, x# S
if(status==STM32FLASH_OK) //没有错误
e5 t5 ^; Q3 Y3 c0 X# f3 G
{1 k B6 r3 q1 c) D5 B
FLASH->CR&=~(3<<8); //清除PSIZE原来的设置, n/ `. {/ ^4 K
FLASH->CR|=2<<8; //设置为32bit宽,确保VCC=2.7~3.6V之间!!
`. ]4 P/ ^% b9 P
FLASH->CR|=1<<0; //编程使能,测试发现使能编程后不延时会出现编程顺序错误8 |& T1 z- N. H; Z* y* F' {: h) K. O
nop;nop;nop;nop; //2020-02-08 此处必须增加延时，否则可能出现顺序错误
+ K; ^5 k( F3 N1 O" V
*(vu32*)faddr=data; //写入数据* H, u! d7 p( P7 g+ F r1 K
status=STM32FLASH_WaitDone(200); //等待操作完成,一个字编程,最多100us.3 R3 v/ s6 D: v' w4 N& `, ^
if(status!=STM32FLASH_BUSY) //非忙% r- ^) X9 W8 T. K+ ?8 O
{ + F- x! H9 P) }! d& R! F5 `0 s
FLASH->CR&=~(1<<0); //清除PG位
1 Y4 V. p4 F- [/ a$ g
}
; |/ ^' S: ^6 ]
} 7 t+ ~3 J' Z4 \ L- D
1 V8 ]& }% g! x
if(status != STM32FLASH_OK)+ H5 `6 B1 ]2 W' O
{
% \: N& | Z, B7 V- [2 q
DEBUG("FLASH写入错误(%d)FLASH_SR=0x%X FLASH_CR=0x%X\r\n",status, FLASH->SR, FLASH->CR);/ v3 V9 |8 @3 l8 Q
}# ^% P- _ o" q+ ?; Y) v2 G) A
% B4 q* J1 E" E, Y
return status;0 g" Q' Q0 w( V( b6 M$ _. w
}
3 ~1 \$ ]' E8 f1 o
$ t1 t( q, {1 k5 p$ U. w
3 Z; @% i1 k# _ z
/*************************************************************************************************************************0 i% r) ~* K$ X0 d0 u0 g
* 函数 : STM32FLASH_STATUS STM32FLASH_WriteMultipledWord(u32 faddr, u32 data[], u32 dWordCount)0 B- g4 N9 y V, E/ e8 o S
* 功能 : 在FLASH指定地址写入多个字的数据（32bit连续写入，提高效率）- }% a' K7 T2 }3 W. c' I( A# y- q
* 参数 : faddr:指定地址(此地址必须为4的倍数);data:要写入的数据
( O: U9 R4 u# L0 {; q
* 返回 : STM32FLASH_STATUS
6 }( \; J* x9 F/ l0 I
* 依赖 : 底层- o& v5 f# z+ q6 b, ]
* 作者 : <a href="mailto:cp1300@139.com">cp1300@139.com</a>
6 ~, T, S) g: z; A- \7 ~0 ^
* 时间 : 2020-02-08
, }/ Q& M9 ~2 W: ~4 H3 Z2 }4 a
* 最后修改时间 : 2020-02-08
6 Z8 F: g" G4 Z/ S! a) D
* 说明 : 警告，地址必须为4的倍数
7 ~+ c/ k! Q& F% Y# w X: ~( Q
2020-02-08执行PG=1须增加延时，否则可能出现顺序错误，不会执行flash解锁
1 w' \, B' K+ t5 M4 j% t6 B+ }
不会判断是否能写入
6 M! y8 s/ p/ g C4 F
*************************************************************************************************************************/$ E3 t7 Y! z7 r0 u; ^7 R# l7 d
STM32FLASH_STATUS STM32FLASH_WriteMultipledWord(u32 faddr, u32 data[], u32 dWordCount)
1 I0 _- F) ?7 a, X; r0 O! l$ \+ z
{3 I" N' S" y" J9 _; j; p: _
STM32FLASH_STATUS status;7 ~, u' |; T0 y `4 @4 [4 z
2 W* S; c' i: o
status=STM32FLASH_WaitDone(200); //判断状态' F( U F, j6 U
if(status==STM32FLASH_OK) //没有错误
, n, \5 F& h1 u- L/ u
{+ U) y; d/ C# j' [# R
FLASH->CR&=~(3<<8); //清除PSIZE原来的设置
% b+ u4 {" l+ s w* s3 v: o
FLASH->CR|=2<<8; //设置为32bit宽,确保VCC=2.7~3.6V之间!!
7 ], m" O# G' S, |' c. y. _
FLASH->CR|=1<<0; //编程使能,测试发现使能编程后不延时会出现编程顺序错误
1 h7 Q7 d6 O# G U2 ^
nop;nop;nop;nop; //2020-02-08 此处必须增加延时，否则可能出现顺序错误
0 V7 B5 p3 i+ ^4 j
while(dWordCount --)# z* _2 @- [2 I S' j# k: Y7 t1 I
{ L1 i3 _0 k& o* a* t: \. Z( v9 U, I/ z+ b
*(vu32*)faddr=*data++; //写入数据
7 N: A& Z+ t- i) {# x4 C* _: W5 \
faddr +=4; //地址自增+40 s6 E; g/ f5 t$ f7 d! B
status=STM32FLASH_WaitDone(200); //等待操作完成,一个字编程,最多100us.
$ @6 k" n& J) J, t9 s
if(status!=STM32FLASH_OK) //有错误9 n- P- t. u3 h
{
: g1 n+ [& t$ I$ c* Q/ p
break;3 F, M, w$ p9 J+ N* E
}2 y+ \5 z3 X. c; V, t
}" m7 Y$ }7 Y7 b( O
4 [& d) c! q# s7 u4 B
if(status!=STM32FLASH_BUSY) //非忙
8 @- ?, {- K+ }# L: K
{ k+ [- ]; Q0 D* L% f5 o* C: ]4 y
FLASH->CR&=~(1<<0); //清除PG位
- e# l. r) Y# \ R) ]+ \# S
}5 S8 ~. V6 y3 e8 L. e1 P1 M
}
: Z$ d- n% F2 i: W9 }4 ?
2 J1 s l- s. ~
if(status != STM32FLASH_OK)
$ t k+ z! H+ y4 W- v2 U
{- o- y" u& ?) R) X
DEBUG("FLASH写入错误(%d)FLASH_SR=0x%X FLASH_CR=0x%X\r\n",status, FLASH->SR, FLASH->CR);
, O7 ?6 x t0 w$ p# x
}4 Z% X' `: _1 g* J* C7 u& T+ y, o; ~6 ^
* h. G0 K w3 ]# r
return status;- B, }, X2 M# S
} 1 E% U) P; L9 M9 @/ V2 N6 P/ v+ `
1 }* ~: @1 m) y) o
5 q0 p$ O2 _0 w$ _3 V; ?8 a' ]. |
/*************************************************************************************************************************+ m% V$ P0 n0 S |4 @
* 函数 : u32 STM32FLASH_ReadWord(u32 faddr)
. V& j& d. D) \
* 功能 : 读取指定地址的一个字(32位数据) . }# V% L4 |) U/ [, S
* 参数 : faddr:指定地址(此地址必须为4的倍数!!);
, i' ?$ f3 r S
* 返回 : 数据( F: ]& k7 N% [6 z8 A
* 依赖 : 底层
/ ~# o7 B2 |8 `
* 作者 : <a href="mailto:cp1300@139.com">cp1300@139.com</a>
9 N. S# Y! j1 f/ i9 t, }
* 时间 : 2018-01-03
3 c+ k6 Z% F1 [' g
* 最后修改时间 : 2018-01-033 l# |% m- ?7 Z( M" _; F
* 说明 : 警告：地址必须是4的整数倍
/ @! z3 J! j' {# ]; C" H
*************************************************************************************************************************/
) d+ m5 E/ J* Q' }+ i
__inline u32 STM32FLASH_ReadWord(u32 faddr)
# T' z/ x3 h1 ^8 A5 ]1 M/ j
{
" d3 M3 \9 G" z! o' R+ c
return *(vu32*)faddr; ' h7 p. f1 ]3 V' a9 p# ^: X+ `0 L
}1 R* j) Q# m6 h; K( \
; l: l7 O( D# |- D" Q
& l6 r4 U2 e, E6 `6 I3 N# G
/*************************************************************************************************************************# j2 C G% `: X! v
* 函数 : u8 STM32FLASH_GetFlashSector(u32 faddr)
( @8 R, L0 g, a
* 功能 : 获取某个地址所在的扇区/ a! k0 M; b9 W. A
* 参数 : faddr:指定地址
$ o+ E8 b W r% M' N9 d; y
* 返回 : 删除编号，0-6，如果超出了也会限制到6& |3 Y9 v& o3 [7 i
* 依赖 : 底层2 m1 z4 Z( s& u* z- ]7 H! `3 `
* 作者 : <a href="mailto:cp1300@139.com">cp1300@139.com</a>' N3 l! h; I1 w: Q8 d( _" X3 ?
* 时间 : 2018-01-033 b: |2 U% F' h5 V. r4 [) ^
* 最后修改时间 : 2018-01-03
* A/ r/ c* T0 P/ r
* 说明 : 地址请不要超出范围$ e$ j9 Q9 R' C/ d D% m
*************************************************************************************************************************/7 u4 |/ Y$ l: X+ O1 c5 r- O
u8 STM32FLASH_GetFlashSector(u32 faddr)
* s) d/ d* G" y" |# p
{
( [6 x+ Y+ b) ]$ x5 f7 F/ e
if(faddr<ADDR_FLASH_SECTOR_1) return 0;3 C F. C* C% V6 ]/ r5 I' A/ d2 Y
else if(faddr<ADDR_FLASH_SECTOR_2) return 1;2 T, d* A, O. G t( D1 `( L
else if(faddr<ADDR_FLASH_SECTOR_3) return 2;
. P3 t8 b* ?5 |& `
else if(faddr<ADDR_FLASH_SECTOR_4) return 3;
! o( A( s# b4 Y2 K# x
else if(faddr<ADDR_FLASH_SECTOR_5) return 4;8 O% |: u+ C- t$ K. q% L5 R1 {
else if(faddr<ADDR_FLASH_SECTOR_6) return 5;
: @, W) X$ n/ I$ d% G
else if(faddr<ADDR_FLASH_SECTOR_7) return 6;1 W- p5 g4 `2 l9 v' v0 n" ?
else return 7; / |0 B/ {: @ g: G3 x4 g
}+ @( P( `- w) n! A+ l; X- S1 ]
8 G5 Z# \. p$ d* A+ Q; ?; F
g8 {1 O4 s: t- q4 h8 D" @+ Y& G
/*************************************************************************************************************************
6 P: W$ z! a8 n
* 函数 : STM32FLASH_STATUS STM32FLASH_Write_NoCheck(u32 WriteAddr,u32 *pBuffer,u16 NumToWrite)
- f/ O2 z% w- r& {# J W
* 功能 : 不检查的写入
1 \; f0 R9 Q1 X& U( @3 Z
* 参数 : WriteAddr:起始地址(必须是4个整数倍);pBuffer:数据指针;NumToWrite:半(32位)数 - H N4 c* l! U2 i- f
* 返回 : 状态) T) F) L8 u9 x8 N' q4 Q
* 依赖 : 底层5 N- r& F/ A/ p0 l) ~& r
* 作者 : <a href="mailto:cp1300@139.com">cp1300@139.com</a>
9 R6 K e6 P8 X: G, ~
* 时间 : 2013-10-20
J! k" r' A* L% ]8 c7 W/ l
* 最后修改时间 : 2018-01-03
, r4 g% Z3 _( E1 r; |$ g
* 说明 : 地址必须为4对齐，如果出现了非FF写入程序会报错并返回（由于STM32硬件会对写入区域进行检查，非FF区域不允许写入）2 ]) v) r6 ~+ p7 N. Q+ v
*************************************************************************************************************************/% M: V) f/ D6 i1 B0 u4 |
STM32FLASH_STATUS STM32FLASH_Write_NoCheck(u32 WriteAddr,u32 *pBuffer,u16 NumToWrite) ! ]) c g4 ^8 r' G7 c
{ $ v! j4 @4 d( }* J
STM32FLASH_STATUS status;
|! t1 h' C& ]1 ?: I
+ `3 i) J( b3 v* G9 T% I( P
if(WriteAddr<STM32_FLASH_BASE||WriteAddr%4)return STM32FLASH_PGPERR ; //非法地址,如果不是4的倍数,返回并行错误
3 p4 n7 b- F! Z) H5 p
STM32FLASH_Unlock(); //解锁 ; b8 Q, f- S! E3 g4 B, K* P
if(FLASH->SR) //有错误，需要清除，测试过程中，发现偶尔启动后会有错误出现( v2 C5 w) Y- b" l& V
{
8 i- D) h, W' n f9 X" r
DEBUG("需要清除flash错误标记，FLASH_SR=0x%X FLASH_CR=0x%X\r\n",FLASH->SR, FLASH->CR);6 H! f6 D& U. g# D
FLASH->SR |= FLASH->SR;
i4 j8 b' ?2 n3 R0 ]$ O
DEBUG("FLASH_SR=0x%X FLASH_CR=0x%X\r\n",FLASH->SR, FLASH->CR);
3 D" e* A3 M# I# T5 Z
}
& I" ?/ K2 V7 F6 ^* ?
status = STM32FLASH_WriteMultipledWord(WriteAddr, pBuffer, NumToWrite); //写入多个字的数据1 M- |% V) k# E X: N- l0 C
STM32FLASH_Lock(); //上锁& k6 n) o" O0 Q4 E+ [
return status;
( W, E+ j- P1 I) y
} . M( I0 a) ^- X
3 {9 ~/ r1 ?% T8 [1 t: L1 B
. N+ u, z* s: R/ E. C
/*************************************************************************************************************************% Y$ @4 W$ i, q' H8 O3 M( w
* 函数 : STM32FLASH_STATUS STM32FLASH_WritedWord_NoCheck(u32 WriteAddr,u32 data) % W* t* ]% t. k& |2 L
* 功能 : 不检查的写入一个字
2 g+ N& \+ Z1 E& X/ M* g/ h: s0 D
* 参数 : WriteAddr:起始地址(必须是4个整数倍);data：要写入的数据值
6 n) k$ ?* U9 C% ?( k Q
* 返回 : 状态' T8 I0 J& N$ z
* 依赖 : 底层
8 n. d% A7 C0 s5 I$ X8 D+ q6 w
* 作者 : <a href="mailto:cp1300@139.com">cp1300@139.com</a>8 }! v6 f) h1 r
* 时间 : 2020-02-088 c. u2 Q0 O9 e, M% K$ N
* 最后修改时间 : 2020-02-08
/ T# O1 [" }; Q1 v5 W
* 说明 : 地址必须为4对齐，如果出现了非FF写入程序会报错并返回（由于STM32硬件会对写入区域进行检查，非FF区域不允许写入）+ \" }0 x" p# z: y% A; Z# X" C
*************************************************************************************************************************/
1 U" e* R6 [; a5 o7 g; u/ T" r
STM32FLASH_STATUS STM32FLASH_WritedWord_NoCheck(u32 WriteAddr,u32 data) 9 X0 Y9 E" ~# M7 @
{ + ~) s1 E2 j9 }$ ?) l- e
STM32FLASH_STATUS status;; M/ M. Z/ v# x: M! t
" m. u# G8 N) i0 ~' E& D
if(WriteAddr<STM32_FLASH_BASE||WriteAddr%4)return STM32FLASH_PGPERR ; //非法地址,如果不是4的倍数,返回并行错误
, o) `+ S; b- [
STM32FLASH_Unlock(); //解锁
( y- F. h7 H) F W
if(FLASH->SR) //有错误，需要清除，测试过程中，发现偶尔启动后会有错误出现6 v' O9 J2 z; o
{
! r! r# |3 W! o. F# ?- x
DEBUG("需要清除flash错误标记，FLASH_SR=0x%X FLASH_CR=0x%X\r\n",FLASH->SR, FLASH->CR);* O9 |/ v5 n8 m) s
FLASH->SR |= FLASH->SR;
- W6 @+ P; `( G5 f5 m% h
DEBUG("FLASH_SR=0x%X FLASH_CR=0x%X\r\n",FLASH->SR, FLASH->CR);
( f2 S! X- x; v5 h
}
7 V; }/ k p6 f/ t6 [- {( Z* g
status = STM32FLASH_WritedWord(WriteAddr, data); //写入1个字的数据; x C' Q/ L0 n# E/ l4 D% N
STM32FLASH_Lock(); //上锁
4 H7 l# b* X3 B( Y. }: v( `+ ~- ?
return status;
- I/ b5 b# [% C% {* s* I
} 4 ^. A; z0 t$ `2 L, E, O8 w9 B
@ }: T+ {* K# C$ d" ?
/ n; I& R. N6 r: D1 J$ x: p
/*************************************************************************************************************************6 [0 L$ ?+ x% V9 c% v
* 函数 : STM32FLASH_STATUS STM32FLASH_Write(u32 WriteAddr,u32 *pBuffer,u16 NumToWrite) : C- O& i8 Q* B
* 功能 : 从指定地址开始写入指定长度的数据（数据长度字为单位）& ]) X/ ^# _+ Q/ x8 L3 k1 G
* 参数 : WriteAddr:起始地址(此地址必须为4的倍数!!);pBuffer:数据指针;NumToWrite:字(32位)数(就是要写入的32位数据的个数.)
$ V# R8 I5 L; K0 y4 ]
* 返回 : 0:完成;1:忙;2:错误;3:写保护
5 g1 d( F9 r- R. l# D
* 依赖 : 底层, J) V5 ?5 ~% t5 O: T, h/ b
* 作者 : <a href="mailto:cp1300@139.com">cp1300@139.com</a>, G) ?) ^ j& d0 v* f8 b
* 时间 : 2013-10-20
! d6 Y8 G3 e4 m* P
* 最后修改时间 : 2016-01-07) N; R2 C9 B4 t$ x
* 说明 : 警告：由于STM32F4的扇区太大，无法使用内存进行缓存，如果要写入的位置有非FF，会直接将整个扇区进行擦除，并丢失其它的数据+ G6 m$ c" Y4 ]6 E6 d, h# D+ }
如果需要保存其他的数据，请在应用层进行实现（比如：先读取扇区，修改扇区，擦除扇区，写入扇区，需要大内存支持）" L7 G, D+ m% R8 ?4 i" Y% v, q
*************************************************************************************************************************/
, z4 a7 N4 s1 S5 t j, K
STM32FLASH_STATUS STM32FLASH_Write(u32 WriteAddr,u32 *pBuffer,u16 NumToWrite) / v( _% t; Q4 u
{
+ M( [1 ]$ {4 y, G6 L. b
STM32FLASH_STATUS status;
) J9 N( ^5 D3 U- v
u32 addrx=0;4 [1 P& r0 I8 Z0 q; U% x4 D. z
u32 endaddr=0;
. R. Q" |, k, k4 S! G5 V+ O
' K8 a2 u9 C; r" l4 a. ]' ~4 K# o
if(WriteAddr<STM32_FLASH_BASE||WriteAddr%4)return STM32FLASH_PGPERR; //非法地址2 G: S' X. O, p% z4 ?
% Q0 R/ f) @$ ^+ Z0 v( n
FLASH->ACR&=~(1<<10); //FLASH擦除期间,必须禁止数据缓存!!!搞了我两晚上才发现这个问题!
1 }' h) y5 L" d+ S
addrx=WriteAddr; //写入的起始地址; c' r# C3 J, @3 R
endaddr=WriteAddr+NumToWrite*4; //写入的结束地址( c1 ]/ j6 h+ X I( M m6 \. b( d0 P( B
8 p$ A6 y$ g2 S1 Z
if(addrx<0X1FFF0000) //只有主存储区,才需要执行擦除操作!!
# O! T; ~3 \: R7 u/ X8 {
{
5 s& ^6 Q' ^# x5 t% S
while(addrx<endaddr) //扫清一切障碍.(对非FFFFFFFF的地方,先擦除)
0 ~% |) B3 J4 d1 n% |9 n- v) X
{0 O: p8 J" Q, @* N4 ^9 }5 t/ o8 B: G
if(STM32FLASH_ReadWord(addrx)!=0XFFFFFFFF) //有非0XFFFFFFFF的地方,要擦除这个扇区+ @! x7 N$ x5 Q$ M
{
k3 L0 _. g/ z& K6 X8 H
status=STM32FLASH_EraseSector(STM32FLASH_GetFlashSector(addrx));
8 t6 z3 e! n+ g/ u
if(status != STM32FLASH_OK)break; //发生错误了
3 `1 j5 X9 ^7 l# K
}else addrx+=4;, w q! s; K1 B' g4 E
}
! w( R& ?: a. p3 U4 ^) N
}
: g% T1 }7 W; _# }( B
if(status==STM32FLASH_OK)1 X3 I8 m4 M2 W8 c$ a( f; U B
{7 @$ h7 F' _7 Y: W7 |
STM32FLASH_Unlock(); //解锁
! E) k' X/ H$ j/ p
if(FLASH->SR) //有错误，需要清除，测试过程中，发现偶尔启动后会有错误出现% i2 w$ w# N5 x) b" d
{
) E+ v/ x' w# E: K$ ]$ p' n
DEBUG("需要清除flash错误标记，FLASH_SR=0x%X FLASH_CR=0x%X\r\n",FLASH->SR, FLASH->CR);
' O* [* {. j- g4 y2 e5 d
FLASH->SR |= FLASH->SR;2 ~5 i8 |& b3 f/ [: {+ I
DEBUG("FLASH_SR=0x%X FLASH_CR=0x%X\r\n",FLASH->SR, FLASH->CR);
) p: s5 j$ _6 L; V9 v, C
}
5 _) ^4 A4 L. K, a+ ]0 T5 g
status = STM32FLASH_WriteMultipledWord(WriteAddr, pBuffer, NumToWrite); //写入多个字的数据
! s l; b n9 m" C4 S7 |( {
STM32FLASH_Lock(); //上锁/ l V+ u6 F/ @) g5 ~/ Z% ~1 ?
}
6 J1 w1 Q/ t# Y* x/ n1 E
FLASH->ACR|=1<<10; //FLASH擦除结束,开启数据fetch
1 ` c; U: Y! C7 _: \8 u
) y! D2 e o) A- J" }
4 h% D$ @3 a' G% j; U
return status;, w, r+ O6 P8 o, n; ?+ [* T* C+ E* @7 J
}
- c! s1 I5 c% E" r) t
8 r- l% _% Q$ j* q
8 E3 G9 e0 _2 k$ v+ X0 s% i+ k6 t
: e0 x0 s$ L; N4 S6 |
( }- G1 e/ k3 q2 M' q
6 J- U" q) C. w+ v
/*************************************************************************************************************************
$ j3 F. n4 U3 G- R
* 函数 : u16 STM32FLASH_Read(u32 ReadAddr,u32 *pBuffer,u16 NumToRead) ' s2 ?5 J4 h0 x/ K k" R
* 功能 : 从指定地址开始读出指定长度的数据
7 p+ K7 T5 i, p) G; z& E' i& ~
* 参数 : ReadAddr:起始地址;pBuffer:数据指针;NumToWrite:字(32位)数
' x8 r0 ?$ `( d5 s G0 A
* 返回 : 读取的数据长度（字为单位）; a3 h9 p( {& a$ V* M- S- w) l0 q
* 依赖 : 底层
8 F4 X8 x3 g! D1 Q4 E0 G
* 作者 : <a href="mailto:cp1300@139.com">cp1300@139.com</a>1 J! M- x4 `# l5 k( N6 W% E
* 时间 : 2013-10-20
# Q: k1 G7 v! M& U* X1 {6 q
* 最后修改时间 : 2016-01-07
: W: M1 E1 z6 j; U% x. r. h
* 说明 : 地址必须为4对齐
7 {9 o9 U; p8 l" ?6 F
*************************************************************************************************************************/# i9 N! d, l' N" z
u16 STM32FLASH_Read(u32 ReadAddr,u32 *pBuffer,u16 NumToRead)
: f7 w2 y3 W- M9 X, f( c' X
{
7 {( ~$ Z) Q0 j$ L
u16 i;
R" m8 O& Z4 E) R0 R e( f5 t
u16 cnt = 0;6 H* _2 @: _0 q0 B3 {5 v. p6 B: L
8 F6 g2 ?- f( M7 z, E
if(ReadAddr<STM32_FLASH_BASE||ReadAddr%4)return 0; //非法地址
# S, V! J- \# U9 K
) M' b; E* I+ N e. H6 F/ ]1 I2 m
for(i=0;i<NumToRead;i++)& Z$ o% e$ N; F5 w: w) M( b/ B3 i
{
0 [1 y J# c; W# _6 \
pBuffer=STM32FLASH_ReadWord(ReadAddr); //读取4个字节.
1 G% {# t2 o8 @ a
cnt++;
9 m5 x' C* l* U( j" u" m F6 A
ReadAddr+=4; //偏移4个字节.
5 ^. P5 \7 R* T
}
% u6 h% Z) a8 P2 D+ i" }# P# o
return cnt;
4 j( J" y; Z; E2 T
}
2 g. O0 g: Z! `/ m3 _5 s, r
5 S! l$ d9 @* f! W
" l9 c8 A) A, j' w9 B8 o# w2 I
/*************************************************************************************************************
% v4 K$ A; y0 ]- R
* 文件名: stm32f7_flash.H
- Q p1 y1 U& f6 Y
* 功能: STM32F7 内部FLASH编程驱动函数
0 g1 I. @6 Z3 a7 p) r
* 作者: <a href="mailto:cp1300@139.com" style="">cp1300@139.com</a>
; s* S9 ~+ z K- `# x/ f
* 创建时间: 2013-10-20# | n4 _" I0 Y2 A7 z p
* 最后修改时间: 2020-02-07' n& m _- a! `3 v7 Y) m/ \
* 详细: 用于STM32F7内部flash读写驱动
# n- y8 ^4 Q& C4 H6 s
*************************************************************************************************************/
. |8 f+ M J7 F Z$ a- v, A
#ifndef __STM32F7_FLASH_H__ w& r5 } N9 I$ ?1 M D
#define __STM32F7_FLASH_H__
4 K" V; ^! _* {: Z
#include "system.h"
% q9 b- l/ G. K! B: m
$ H/ u7 ]: I. o: P$ P* T
//FLASH起始地址. C* I- F# P* s$ j* s9 @
#define STM32_FLASH_BASE 0x08000000 //STM32 FLASH的起始地址
& ~; `, I; u" g' J, `( \: I
8 M f' J: x% W3 s, n7 C( N2 S& y
//FLASH 扇区的起始地址- i0 [. v5 |6 B, _: m2 [
#define ADDR_FLASH_SECTOR_0 ((u32)0x08000000) //扇区0起始地址, 32 Kbytes
3 a0 w* Z+ l2 J H% C
#define ADDR_FLASH_SECTOR_1 ((u32)0x08008000) //扇区1起始地址, 32 Kbytes
3 V, ~; }) B. ]9 R" H
#define ADDR_FLASH_SECTOR_2 ((u32)0x08010000) //扇区2起始地址, 32 Kbytes
. I7 F, J" s8 M' U8 I& a; E
#define ADDR_FLASH_SECTOR_3 ((u32)0x08018000) //扇区3起始地址, 32 Kbytes
* ?6 K: @8 l6 P# u3 @
#define ADDR_FLASH_SECTOR_4 ((u32)0x08020000) //扇区4起始地址, 128 Kbytes
+ s6 Q n3 K7 w1 c$ N) s$ P
#define ADDR_FLASH_SECTOR_5 ((u32)0x08040000) //扇区5起始地址, 256 Kbytes ' C+ k4 k0 O$ r
#define ADDR_FLASH_SECTOR_6 ((u32)0x08080000) //扇区6起始地址, 256 Kbytes
$ U! J( I7 }4 S
#define ADDR_FLASH_SECTOR_7 ((u32)0x080C0000) //扇区7起始地址, 256 Kbytes " o6 v1 V. H/ N
1 O$ Z R/ J$ a$ D
! i2 H" [2 W% U" V* z
//FLASH解锁键值
, y. H. h5 n2 g7 ^8 _, a
#define RDP_KEY 0x00A5
) C8 }2 u/ P/ T
#define FLASH_KEY1 0X45670123
8 K" z. z% ~. X+ N$ J) _2 n
#define FLASH_KEY2 0XCDEF89AB
" E. N6 w+ A& b; x; i. h, K* d7 k% T
#define FLASH_OPT_KEY1 0x08192A3B. X1 a( N! Q$ d
#define FLASH_OPT_KEY2 0x4C5D6E7F3 H" m& g: {8 [# h, z6 }. F
: R0 V3 g% W0 _) J) L- g5 p6 N# E
//STM32F7 Flash操作状态3 W& b' @3 t; }! F. K0 P, R
typedef enum" D9 U A+ i0 A$ `$ B: l* D; X; ^0 Z
{
* H3 L2 t, Q, H; c4 f
STM32FLASH_OK = 0, //操作完成 ~( @8 @) |0 D; W
STM32FLASH_BUSY = 1, //忙
$ f( p0 c3 j4 t% u' o
STM32FLASH_WPRERR = 2, //写保护错误1 ^- u' y" N) Z; }' z# f! P
STM32FLASH_PGAERR = 3, //编程对齐错误，必须128位对齐
* a+ G5 C' F/ C9 A) \/ [
STM32FLASH_PGPERR = 4, //并行位数错误
# N, i0 F! x8 E
STM32FLASH_PGSERR = 5, //擦除顺序错误
+ o2 \" b5 R4 N' |) g
STM32FLASH_OPERR = 6, //操作错误
2 R e" x4 k; o! M- p& ^# ~
}STM32FLASH_STATUS;
G) u- i% _# a, W( c$ P
) T1 H. j7 }9 x. \
//常用接口
* ~; @# b* P( P# m" N0 r! {
STM32FLASH_STATUS STM32FLASH_EraseSector(u8 sectoraddr); //擦除扇区
6 t& }1 s" h, [; C8 [
STM32FLASH_STATUS STM32FLASH_Write_NoCheck(u32 WriteAddr,u32 *pBuffer,u16 NumToWrite) ; //不检查的写入多个字的数据2 I) r- }* N3 G0 L' w: r
STM32FLASH_STATUS STM32FLASH_WritedWord_NoCheck(u32 WriteAddr,u32 data) ; //不检查的写入一个字的数据
6 t. m# L3 Q; c# B7 q' k4 f
STM32FLASH_STATUS STM32FLASH_Write(u32 WriteAddr,u32 *pBuffer,u16 NumToWrite); //从指定地址开始写入指定长度的数据（数据长度字为单位）
! I( G+ i8 b$ G6 m# a& ?
u16 STM32FLASH_Read(u32 ReadAddr,u32 *pBuffer,u16 NumToRead); //从指定地址开始读出指定长度的数据2 `" {6 |$ O4 G5 t, S. J
# k/ A+ j( a8 ~6 c) v! E; H
//不常用接口. B6 _( m, P, ?* K& o: @6 m
void STM32FLASH_Unlock(void); //FLASH解锁
" |9 ?& [$ u+ u9 U
void STM32FLASH_Lock(void); //FLASH上锁
) F: F5 Q% Q& K* U& Y
STM32FLASH_STATUS STM32FLASH_GetStatus(void); //获得状态- K2 a& X. |) y, U0 q( v4 J# I* d
. r- o4 J( n* \& ?2 u/ M
* K: z: _& g$ D: X" }
#endif //__STM32F7_FLASH_H__
) F# W, ~. {- H2 r& x8 k( Q
: H" U! f3 }: v4 Y