FlashStorage_STM32F1下载FlashStorage

中文(简体)

中文(简体) 中文(繁体) 한국어 日本語 English Português Español Русский العربية Indonesia Deutsch Français ภาษาไทย

首页>建站资源>FLASH源码

FlashStorage_STM32F1

FLASH源码

v1.1.0 to fix `multiple-definitions` linker error and to optimize library code by using `reference-passing` instead of `value-passing`

下载

flashstorage_stm32f1库

v1.1.0的重要变化
为什么我们需要此flashstorage_stm32f1库
- 特征
- 目前支持的董事会
  - STM32F1XX
  - STM32F3XX
ChangElog
先决条件
安装
- 使用Arduino Library Manager
- 手动安装
- VS代码和平台
软件包的补丁
- 1。用于使用LAN8720的STM32板
- 2。使用STM32板使用Serial1
如何修复Multiple Definitions链接器错误
有限的写作
用法
- 使用替代性EEPROM样API
例子
- 1。EEPROM_CLEAR
- 2。EEPROM_CRC
- 3。eeprom_get
- 4。eeprom_iteration
- 5。eeprom_put
- 6。eeprom_read
- 7。eeprom_update
- 8。eeprom_write
- 9。纯净
- 10。flashstoreandretrive
- 11。多孔保护新
示例flashstoreandretrive
调试终端输出样品
- 1。bluepill_f103c8上的eeprom_get with 64kb flash
  - 1.1。第一次开始
  - 1.2。重置后
- 2。bluepill_f103c8上的flashstoreandreterive，带有64kb闪光灯
  - 2.1。第一次开始
  - 2.2。重置后
- 3。bluepill_f103c8上的eeprom_write，带128kb flash
- 4。在Bluepill_f103c8上使用128KB闪光
  - 4.1。第一次开始
  - 4.2。重置后
- 5。flashstoreandretrieve在generic_f103rctx上，带256kb flash
  - 5.1。第一次开始
  - 5.2。重置后
常问问题
- 我可以使用一个对象存储更多东西吗？
- 每当上传新草图时，闪光灯的内容都会删除？
- 您是否建议使用闪光灯代替EEPROM？
故障排除
问题
做
完毕
贡献和感谢
贡献
执照
版权

v1.1.0的重要变化

请查看如何修复Multiple Definitions链接器错误

为什么我们需要此flashstorage_stm32f1库

特征

FlashStorage_stm32f1库受到Cristian Maglie的FlashStorage的启发，它提供了一种便利的方法，可以从STM32F1/F3的非挥发性闪存中使用模拟 - EPROM存储和检索用户的数据，包括非生机的ch32f103xx，CS32F103XX，CS32F103XX，等等。

通常用于存储固件代码的闪存也可以用来存储 /检索用户的数据更多，并且比EEPROM更快。得益于缓冲的数据编写和阅读，闪光访问时间大大减少以增加闪光灯的寿命。

目前，该库支持新的STM32 Core v2.0.0和先前的STM32 Core v1.9.0

目前支持的董事会

带有 /没有集成EEPROM的STM32F1 / F3板

STM32F1XX

nucleo_f103rb，disco_f100rb
bluepill_f103c6，bluepill_f103c8，bluepill_f103cb
BlackPill_F103C8，BlackPill_F103CB
通用STM32F1，STM32F3
vccgnd_f103zet6_mini，vccgnd_f103zet6，
HY_TINYSTM103TB，MAPLEMINI_F103CB
bluebutton_f103r8t，bluebutton_f103rbt，bluebutton_f103rct，bluebutton_f103ret
generic_f100c4tx，generic_f100c8tx，generic_f100cbtx
generic_f103c4tx，generic_f103c6tx，generic_f103c6ux，generic_f103c8tx，generic_f103cbtx，generic_f103cbux
generic_f100r8tx，generic_f100rbtx
generic_f103r4hx，generic_f103r6hx，generic_f103r4tx，generic_f103r6tx，generic_f103r8hx，generic_f103rbhx，generic_f103r8tx
generic_f103rbtx，generic_f103rctx，generic_f103rdtx，generic_f103retx，generic_f103rcyx，generic_f103rdyx，generic_f103reyxreyx
generic_f103rftx，generic_f103rgtx
generic_f103t4ux，generic_f103t6ux，generic_f103t8ux，generic_f103tbux
generic_f103v8hx，generic_f103vbhx，generic_f103v8tx，generic_f103vbtx，generic_f103vbix，generic_f103vchx，generic_f103vdhx
generic_f103vehx，generic_f103vctx，generic_f103vdtx，generic_f103vetx，generic_f103vftx，generic_f103vgtx，
generic_f103zchx，generic_f103zdhx，generic_f103zehx，generic_f103zctx，generic_f103zdtx，generic_f103zetx，generic_f103zfhx，
generic_f103zghx，generic_f103zftx，generic_f103zgtx
Malyanm200_F103CB，Afroflight_f103cb

STM32F3XX

nucleo_f302r8，nucleo_f303re，nucleo_f303k8，disco_f303vc
BlackPill_F303cc，Olimexino_stm32f3
generic_f302r6tx，generic_f302r8tx，generic_f303rbtx，generic_f303rctx，generic_f303rdtx，generic_f3033retx
generic_f303cbtx，generic_f303cctx
generic_f303k6tx，generic_f303k8tx
generic_f303vbtx，generic_f303vctx
generic_f334k4tx，generic_f334k6tx，generic_f334k8tx
sparky_f303cc

先决条件

Arduino IDE 1.8.19+ for Arduino。
Arduino Core for STM32 v2.3.0+ 。

安装

使用Arduino Library Manager

最好和最简单的方法是使用Arduino Library Manager 。搜索flashstorage_stm32f1 ，然后选择 /安装最新版本。您也可以使用此链接以获取更详细的说明。

手动安装

安装的另一种方法是：

导航到flashstorage_stm32f1页面。
下载最新版本的FlashStorage_STM32F1-main.zip 。
将zip文件提取到FlashStorage_STM32F1-main目录
将整个FlashStorage_STM32F1-main文件夹复制到arduino库的目录，例如~/Arduino/libraries/ 。

VS代码和平台

安装VS代码
安装平台
使用库管理器安装FlashStorage_stm32f1库。在Platform.io作者的库中搜索FlashStorage_stm32f1
使用示例中的Platform.ini文件包括Platform.ini文件，以确保将自动安装所有依赖的库。请访问文档以获取项目配置文件中的其他选项和示例

软件包的补丁

1。用于使用LAN8720的STM32板

对于使用LAN8720的Generic STM32F4 series板，例如STM32F407VE ，请使用STM32 Core v2.2.0作为Breaking Core v2.3.0会产生编译错误。

在某些STM32板上使用LAN8720

Nucleo-144（F429ZI，Nucleo_F746NG，nucleo_f746zg，nucleo_f756zg）
发现（Disco_f746ng）
STM32F4董事会（Black_F407VE，Black_F407VG，Black_F407Ze，Black_F407ZG，Black_F407Ve_Mini，diymore_f407vgt，fk407m1）

您必须将文件STM32F4XX_HAL_CONF_DEFAULT.H和STM32F7XX_HAL_HAL_CONF_DEFAULT.H复制到STM32 STM32 Directory（〜/.arduino15/packages/stm32/stm32/hardware/hardware/stm32/2.2.0/systep）中，以覆盖旧文件。

假设STM32 STM32核心版本为2.2.0。这些文件必须复制到目录中：

~/.arduino15/packages/STM32/hardware/stm32/2.2.0/system/STM32F4xx/stm32f4xx_hal_conf_default.h for stm32f4。
~/.arduino15/packages/STM32/hardware/stm32/2.2.0/system/STM32F7xx/stm32f7xx_hal_conf_default.h用于nucleo-144 stm32f7。

每当安装新版本时，请记住将此文件复制到新版本目录中。例如，新版本是x.yy.zz，这些文件必须复制到相应的目录中：

~/.arduino15/packages/STM32/hardware/stm32/x.yy.zz/system/STM32F4xx/stm32f4xx_hal_conf_default.h
`〜/.arduino15/packages/stm32/hardware/stm32/x.yy.zz/system/stm32f7xx/stm32f7xx_hal_hal_conf_default.h

2。使用STM32板使用Serial1

To use Serial1 on some STM32 boards without Serial1 definition (Nucleo-144 NUCLEO_F767ZI, Nucleo-64 NUCLEO_L053R8, etc.) boards , you have to copy the files STM32 variant.h into STM32 stm32 directory (~/.arduino15/packages/STM32/hardware/stm32/2.3.0).您必须修改与董事会相对应的文件，这只是一个插图。

假设STM32 STM32核心版本为2.3.0。这些文件必须复制到目录中：

~/.arduino15/packages/STM32/hardware/stm32/2.3.0/variants/NUCLEO_F767ZI/variant.h用于nucleo-144 nucleo_f767zi。
~/.arduino15/packages/STM32/hardware/stm32/2.3.0/variants/NUCLEO_L053R8/variant.h用于nucleo-64 nucleo_l053r8。

每当安装新版本时，请记住将此文件复制到新版本目录中。例如，新版本是x.yy.zz，这些文件必须复制到相应的目录中：

~/.arduino15/packages/STM32/hardware/stm32/x.yy.zz/variants/NUCLEO_F767ZI/variant.h
~/.arduino15/packages/STM32/hardware/stm32/x.yy.zz/variants/NUCLEO_L053R8/variant.h

如何修复`Multiple Definitions`链接器错误

使用xyz-Impl.h而不是标准xyz.cpp的当前库实现可能会在某些用例中创建某些Multiple Definitions链接器错误。

您可以包括此.hpp文件

 // Can be included as many times as necessary, without `Multiple Definitions` Linker Error
# include " FlashStorage_STM32F1.hpp "     // https://github.com/khoih-prog/FlashStorage_STM32F1

在许多文件中。但是，请确保仅在1 .h ， .cpp或.ino文件中使用以下.h文件（不得包含在任何其他文件中），以避免Multiple Definitions链接器错误

 // To be included only in main(), .ino with setup() to avoid `Multiple Definitions` Linker Error
# include " FlashStorage_STM32F1.h "           // https://github.com/khoih-prog/FlashStorage_STM32F1

检查HOWTO演示的新的多胎示例。

使用src_cpp或src_h lib＃80来查看不同行为的讨论

有限的写作

闪存的写周期数量有限。典型的闪光记忆可以在开始“磨损”之前，可以将大约10000个循环写入同一闪存块，并开始失去保留数据的能力。

因此，请当心：不当使用该库可以迅速而永久破坏您的微观的闪存，特别是您应该避免拨打put()或commit()函数，并确保在微观的一生中确保put()或commits（）或commit()的次数（）保持在10000的限制以下（即使是较大的数量，也可以保持较大的数量，以确保较大的数量。

用法

使用替代性EEPROM样API

包括FlashStorage_STM32F1.h ，以获得内部闪存的EEPROM仿真。

有关一个示例，请参见EmulateEprom草图。

API与众所周知的Arduino eeprom.h API非常相似，但具有4个其他功能：

如果模拟 - EPROM中的数据有效（至少由EEPROM.commit()或EEPROM.put() ）编写给flash一次的数据，则bool isValid()将返回true 。否则，模拟 - EPROM数据是“未定义的”，并且该函数返回false 。
void commit()将EEPROM数据存储在Flash中。小心地使用此功能：每个呼叫都将完整的模拟 - EPROM数据写入闪存。这将减少剩余的闪光灯循环。不要以循环方式调用此方法，否则您会尽快杀死闪光灯。
void setCommitASAP(bool value = true)设置或清除_commitASAP private变量（默认是true ）。如果_commitasap为false，则呼叫EEPROM.put()不会迫使EEPROM.commit()延长闪存寿命。您必须记住要手动调用EEPROM.commit()以将模拟 - EPROM数据保存到闪存中，否则将丢失数据。
bool getCommitASAP()返回_commitASAP的当前值。

例子

EEPROM_CLEAR
EEPROM_CRC
EEPROM_GET
EEPROM_ITERATION
EEPROM_PUT
EEPROM_READ
EEPROM_UPDATE
EEPROM_WRITE
EmulateEprom
FlashStoreanDretrieve
多机构新的

示例flashstoreandretrive

flashstorage_stm32f1/示例/flashstoreandretrieve/flashstoreandretrieve.ino

CB76B66中的第26至81行

 //使用0-2。较大以获取更多调试消息
 ＃定义flash_debug 2 
 //您可以选择另一个部门。小心不要大于（注册_number_flash_sectors -1），并且足够大，不要覆盖您的程序
 //默认值为（regenter_number_flash_sectors -1）如果您在此处未指定
 ＃定义使用_FLASH_SECTOR_NUMBER （注册_number_flash_sectors -2 ） 
 //仅包含在main（），.ino带有setup（）的.ino中以避免“多个定义”链接器错误
 ＃包括“ flashstorage_stm32f1.h ” 
 //注意：为变量保留的闪存面积为
 //每次将草图上传到板上时都会迷路。 
 void setup （） 
 { 
系列。开始（ 115200 ）; 
而（！串行）； 
延迟（ 200 ）; 
系列。打印（ f （ “  n启动flashstoreandretrive on ” ））; 
系列。 println （board_name）; 
系列。 println （flash_storage_stm32f1_version）; 
系列。打印（ “ eeprom长度： ” ）; 
系列。 println （ eeprom。length （））; 
 EEPROM。 init （）; 
 uint16_t地址= 0 ; 
 int编号； 
 //阅读模拟 -  eprom的内容
 EEPROM。获取（地址，编号）; 
 //在串行显示器上打印当前号码
系列。打印（ “ number = 0x ” ）; 
系列。 println （编号，十六进制）； 
 //保存到仿真 -  eeprom中，下一个草图的数字增加了1 
 EEPROM。 put （地址，（ int ）（编号 + 1 ））; 
如果（！eeprom。getCommitasap（） ） 
 { 
系列。 println （ “ commitasap not stele。需要commit（） ” ）; 
 EEPROM。犯罪（）; 
 } 
系列。 println （ “完成为模拟EEPROM的写作。您现在可以重置” ）； 
 } 
 void loop （） 
 { 
 //什么都不做... 
 }

调试终端输出样品

1。bluepill_f103c8上的eeprom_get with 64kb flash

以下是在sTM32F1上运行示例EEPROM_GET时的示例终端输出

1.1首次开始

Start EEPROM_get on BLUEPILL_F103C8
FlashStorage_STM32F1 v1 .1.0
EEPROM length: 1019
Start Flash Address: 0x800F800
[FLASH] REGISTERED_NUMBER_FLASH_SECTORS (KB) = 64
[FLASH] USING_FLASH_SECTOR_NUMBER =  62
EEPROM doesn ' t store valid data, writing WRITTEN_SIGNATURE and some example data
Float written to EEPROM: 123.456
Done writing custom object to EEPROM: 
===============
Field1: 3.14159
Field2: 65
Name: Working!
===============
Reset to see how you can retrieve the values by using EEPROM_get!

重置后1.2

Start EEPROM_get on BLUEPILL_F103C8
FlashStorage_STM32F1 v1 .1.0
EEPROM length: 1019
Start Flash Address: 0x800F800
[FLASH] REGISTERED_NUMBER_FLASH_SECTORS (KB) = 64
[FLASH] USING_FLASH_SECTOR_NUMBER =  62
EEPROM has valid data with WRITTEN_SIGNATURE. Now read some example data
Read float from EEPROM: 123.456
Read custom object from EEPROM: 
===============
Field1: 3.14159
Field2: 65
Name: Working!
===============

2。bluepill_f103c8上的flashstoreandreterive，带有64kb闪光灯

以下是在sTM32F1 BluePill_F103C8上运行示例flashstoreanDretrieve时的样本终端输出

2.1首次开始

Start FlashStoreAndRetrieve on BLUEPILL_F103C8
FlashStorage_STM32F1 v1 .1.0
EEPROM length: 1019
Start Flash Address: 0x800FC00
[FLASH] REGISTERED_NUMBER_FLASH_SECTORS (KB) = 64
[FLASH] USING_FLASH_SECTOR_NUMBER =  63
Number = 0x0
Done writing to emulated EEPROM. You can reset now

重置后2.2

Start FlashStoreAndRetrieve on BLUEPILL_F103C8
FlashStorage_STM32F1 v1 .1.0
EEPROM length: 1019
Start Flash Address: 0x800FC00
[FLASH] REGISTERED_NUMBER_FLASH_SECTORS (KB) = 64
[FLASH] USING_FLASH_SECTOR_NUMBER =  63
Number = 0x1
Done writing to emulated EEPROM. You can reset now

3。bluepill_f103c8上的eeprom_write，带128kb flash

以下是运行示例示例eprom_write在stm32f1 bluepill_f103c8上使用128kb flash上的示例终端输出

Start EEPROM_write on BLUEPILL_F103C8
FlashStorage_STM32F1 v1 .1.0
EEPROM length: 1019
Start Flash Address: 0x801F800
[FLASH] REGISTERED_NUMBER_FLASH_SECTORS (KB) = 128
[FLASH] USING_FLASH_SECTOR_NUMBER =  126
Done writing emulated EEPROM. Time spent (ms) = 29
Done writing emulated EEPROM. Time spent (ms) = 0
Done writing emulated EEPROM. Time spent (ms) = 0
Done writing emulated EEPROM. Time spent (ms) = 0
Done writing emulated EEPROM. Time spent (ms) = 0
Done writing emulated EEPROM. Time spent (ms) = 0

4。在Bluepill_f103c8上使用128KB闪光

以下是在运行示例启用STM32F1 BluePill_F103C8上的样本终端输出，带有128KB闪存

4.1首次开始

Start EmulatedEEPROM on BLUEPILL_F103C8
FlashStorage_STM32F1 v1 .1.0
EEPROM length: 1019
Start Flash Address: 0x801FC00
[FLASH] REGISTERED_NUMBER_FLASH_SECTORS (KB) = 128
[FLASH] USING_FLASH_SECTOR_NUMBER =  127
EEPROM is empty, writing WRITTEN_SIGNATURE and some example data:
-> 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119
Done writing to emulated EEPROM. You can reset now to test

4.2重置后

Start EmulatedEEPROM on BLUEPILL_F103C8
FlashStorage_STM32F1 v1 .1.0
EEPROM length: 1019
Start Flash Address: 0x801FC00
[FLASH] REGISTERED_NUMBER_FLASH_SECTORS (KB) = 128
[FLASH] USING_FLASH_SECTOR_NUMBER =  127
EEPROM has been written.Signature = 0xBEEFDEED
Here is the content of the next 16 bytes:
-> 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 11913
Clearing WRITTEN_SIGNATURE for next try
Done clearing signature in emulated EEPROM. You can reset now

5。flashstoreandretrieve在generic_f103rctx上，带256kb flash

以下是在sTM32F1上运行示例flashstoreandretrieve时的示例终端输出

静止	<--->	generic_f103rctx
Swclk	<--->	SWCLK / PA14
SWDIO	<--->	SWDIO / PA13
gnd	<--->	gnd
3.3V	<--->	3.3V

5.1首次开始

Start FlashStoreAndRetrieve on GENERIC_F103RCTX
FlashStorage_STM32F1 v1 .1.0
EEPROM length: 1019
Start Flash Address: 0x803F800
[FLASH] REGISTERED_NUMBER_FLASH_SECTORS (KB) = 256
[FLASH] USING_FLASH_SECTOR_NUMBER =  254
Number = 0xFFFFFFFF
Done writing to emulated EEPROM. You can reset now

重置后5.2

Start FlashStoreAndRetrieve on GENERIC_F103RCTX
FlashStorage_STM32F1 v1 .1.0
EEPROM length: 1019
Start Flash Address: 0x803F800
[FLASH] REGISTERED_NUMBER_FLASH_SECTORS (KB) = 256
[FLASH] USING_FLASH_SECTOR_NUMBER =  254
Number = 0x0
Done writing to emulated EEPROM. You can reset now

常问问题

我可以使用一个对象存储更多东西吗？

是的，您可以声明一个带有更多字段的struct ，并致电EEPROM.put()以存储整个结构。请参阅Storenameandsurname有关如何做的。

每当上传新草图时，闪光灯的内容都会删除？

不使用STM32F1/F3。

您是否建议使用闪光灯代替EEPROM？

否。如果您的董事会提供了一个集成的EPROM，则建议使用它，因为EEPROM的寿命更长，写周期数等）。

在没有集成的EPROM或其大小太小的情况下，对于您的用例来说，您可以使用此库将较小的闪存作为模拟EPROM，前提

故障排除

如果您遇到汇编错误，则通常需要安装Arduino Board的核心版本的较新版本。

有时，只有在您使用新添加的功能时，只有将板核更新为最新版本时，库才能正常工作。

问题

提交问题：flashstorage_stm32f1问题

做

搜索错误和改进。
剩余的Arduino STM32板的类似功能

完毕

STM32F1/F3的基本模拟 - EPROM。
添加支持新的STM32 Core v1.9.0
剩余的Arduino板（例如SAMD21，SAMD51）等类似的功能。
添加目录
添加支持新的STM32 Core v2.2.0+
添加EEPROM.put()和EEPROM.get()函数以读取/写入仿真 - eprom
修复multiple-definitions链接器错误。
通过减少库文件的数量来清理

贡献和感谢

非常感谢大家的错误报告，新功能建议，测试和为该库的开发做出贡献。

受克里斯蒂安·玛格丽（Cristian Maglie）的Flashstorage的启发。

_{克里斯蒂安·玛格丽（Cristian Maglie）}

贡献

如果您想为这个项目做出贡献：

报告错误和错误
要求增强
创建问题并提取请求
告诉其他人这个图书馆

执照

图书馆已根据LGPLV3许可

版权

版权（C）2021- Khoi Hoang

展开

附加信息

版本 v1.1.0 to fix `multiple-definitions` linker error and to optimize library code by using `reference-passing` instead of `value-passing`
类型 FLASH源码
更新时间 2025-04-07
大小 337.19KB
来自于 Github

	//使用0-2。较大以获取更多调试消息
	＃定义flash_debug 2

	//您可以选择另一个部门。小心不要大于（注册_number_flash_sectors -1），并且足够大，不要覆盖您的程序
	//默认值为（regenter_number_flash_sectors -1）如果您在此处未指定
	＃定义使用_FLASH_SECTOR_NUMBER （注册_number_flash_sectors -2 ）

	//仅包含在main（），.ino带有setup（）的.ino中以避免“多个定义”链接器错误
	＃包括“ flashstorage_stm32f1.h ”

	//注意：为变量保留的闪存面积为
	//每次将草图上传到板上时都会迷路。

	void setup （）
	{
	系列。开始（ 115200 ）;

	而（！串行）；

	延迟（ 200 ）;

	系列。打印（ f （ “ n启动flashstoreandretrive on ” ））;
	系列。 println （board_name）;
	系列。 println （flash_storage_stm32f1_version）;

	系列。打印（ “ eeprom长度： ” ）;
	系列。 println （ eeprom。length （））;

	EEPROM。 init （）;

	uint16_t地址= 0 ;
	int编号；

	//阅读模拟 - eprom的内容
	EEPROM。获取（地址，编号）;

	//在串行显示器上打印当前号码
	系列。打印（ “ number = 0x ” ）;
	系列。 println （编号，十六进制）；

	//保存到仿真 - eeprom中，下一个草图的数字增加了1
	EEPROM。 put （地址，（ int ）（编号 + 1 ））;

	如果（！eeprom。getCommitasap（））
	{
	系列。 println （ “ commitasap not stele。需要commit（） ” ）;
	EEPROM。犯罪（）;
	}

	系列。 println （ “完成为模拟EEPROM的写作。您现在可以重置” ）；
	}

	void loop （）
	{
	//什么都不做...
	}

FlashStorage_STM32F1