首页>建站资源>FLASH源码
下载

flashstorage_stm32库

目录

  • v1.2.0的重要变化
  • 为什么我们需要此flashstorage_stm32库
    • 特征
    • 目前支持的董事会
  • 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。storenameandsurname
    • 12。多验新型
  • 来自其他图书馆的示例
    • 1。库wifimanager_generic_lite
    • 2。库wifimanager_nina_lite
    • 3。库以太网_MANAGER_STM32
    • 4。库ESP_AT_WM_LITE
    • 5。库Blynkethernet_stm32_wm
  • 示例Storenameandsurname
  • 调试终端输出样品
    • 1。使用LAN8720以太网和STM32Ethernet库，在Black_F407上进行以太网_STM32_LAN8720
      • 1.1。 DoubleSet检测到=>输入Config Portal
      • 1.2。配置数据保存=>正常运行
    • 2。nucleo_h743zi2上的StorenameanDername，带有16KB仿真 - EPROM
      • 2.1。第一次开始
      • 2.2。重置后
    • 3。nucleo_l552ze_q上的Storenameandsurname，带有2KB模拟 - eprom
      • 3.1。第一次开始
      • 3.2。重置后
    • 4。nucleo_f767zi上的StorenameandSurname，带有16KB模拟 - EPROM
      • 4.1。第一次开始
      • 4.2。重置后
  • 常问问题
    • 我可以使用一个对象存储更多东西吗？
    • 每当上传新草图时，闪光灯的内容都会删除？
    • 您是否建议使用闪光灯代替EEPROM？
  • 故障排除
  • 问题
  • 做
  • 完毕
  • 贡献和感谢
  • 贡献
  • 执照
  • 版权

v1.2.0的重要变化

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

为什么我们需要此flashstorage_stm32库

特征

FlashStorage_stm32库受到Cristian Maglie的FlashStorage的启发，它提供了一种使用模拟 - EPROM来存储和检索用户数据的方便方法，该方法从STM32F/L/H/H/H/G/WB/WB/MP1的非挥发性闪存中。

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

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

目前支持的董事会

  1. STM32F/L/H/G/WB/MP1板，没有/没有集成EEPROM
  • 核-144
  • 核-64
  • 核-32
  • 发现
  • 通用STM32F0，STM32F1，STM32F2，STM32F3，STM32F4，STM32F7
  • STM32L0，STM32L1，STM32L4， STM32L5
  • STM32G0，STM32G4
  • STM32H7
  • STM32WB
  • STM32MP1
  • 洛拉董事会
  • 3-D打印机板
  • 通用飞行控制器
  • 中四元委员会

先决条件

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

安装

使用Arduino Library Manager

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

手动安装

安装的另一种方法是：

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

VS代码和平台

  1. 安装VS代码
  2. 安装平台
  3. 使用库管理器安装flashstorage_stm32库。在Platform.io作者的库中搜索FlashStorage_stm32
  4. 使用示例中的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_STM32.hpp "     // https://github.com/khoih-prog/FlashStorage_STM32

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

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

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

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

有限的写作

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

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

用法

使用替代性EEPROM样API

包括FlashStorage_STM32.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的当前值。

例子

  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. EmulateEprom
  10. FlashStoreanDretrieve
  11. Storenameandsurname
  12. 多机构新的

来自其他图书馆的示例

1。库wifimanager_generic_lite

  1. stm32_wifi
  2. STM32_WIFI_MQTT

2。库wifimanager_nina_lite

  1. STM32_WIFININA
  2. STM32_WIFININA_MQTT

3。库以太网_MANAGER_STM32

  1. AM2315_ETHERNET_STM32
  2. DHT11_ETHERNET_STM32
  3. 以太网_STM32
  4. mqtt_thingstream_ethernet_stm32

4。库ESP_AT_WM_LITE

  1. STM32_ESP8266SHIELD

5。库Blynkethernet_stm32_wm

  1. bi_ethernet_blynk

  2. bi_ethernet_blynk_email

  3. bi_ethernet_wm_config

  4. lan8720_ethernet_blynk

  5. lan8720_ethernet_blynk_email

  6. lan8720_ethernet_wm_config

    ......

还有更多图书馆来了。

示例Storenameandsurname

flashstorage_stm32/示例/storenameandsurname/storenameansurname.ino

BB0DD71中的第15至106行

//演示如何将flashstorage_stm32与类似于EEPROM库的API使用以存储和检索结构化数据。
//仅包含在main（），.ino带有setup（）的.ino中以避免“多个定义”链接器错误
＃包括< flashstorage_stm32.h >
const int witder_signature = 0xbeefdeed ;
//创建一个足够大以包含名称的结构
//和姓氏。一旦将“有效”变量设置为“ true”
//结构首次填充了实际数据。
Typedef结构
{
char名称[ 100 ];
char姓氏[ 100 ];
} 人;
void setup （）
{
系列。开始（ 115200 ）;
而（！串行）；
延迟（ 200 ）;
系列。打印（ f （ “ n启动storenameandsurname on ” ））;
系列。 println （board_name）;
系列。 println （flash_storage_stm32_version）;
系列。打印（ “ eeprom长度： ” ）;
系列。 println （ eeprom。length （））;
//在地址0检查签名0
int签名；
//创建“人”变量并将其称为“所有者”
uint16_t storedAddress = 0 ;
人所有者；
EEPROM。获取（storedaddress，签名）；
//如果eeprom是空的，则没有书面_signature
if （签名==书面_signature）
{
EEPROM。 get （storedaddress + sizeof （签名），所有者）;
//向返回的用户打个招呼！
系列。打印（ “ hi ” ）;
系列。打印（所有者。名称）;
系列。打印（ ” ” ）;
系列。打印（所有者。姓氏）;
系列。 println （ “ ，很高兴再次见到你:-) ” ）;
系列。 println （ “下一个尝试的清除书面_signature ” ）;
EEPROM。放（ 0，0 ）;
系列。 println （ “完成模拟的EEPROM中的清除签名。您现在可以重置” ）；
}
别的
{
系列。 println （ “ eeprom是空的，书面_signature和一些示例数据： ” ）;
EEPROM。 put （storedAddress，书面_signature）;
// ...在这种情况下，我们询问用户数据。
系列。 Settimeout （ 30000 ）;
系列。打印（ “插入您的名字： ” ）;
字符串名称=序列。 ReadStringuntil （ ' n ' ）;
系列。 println （name）;
系列。打印（ “插入您的姓氏： ” ）;
字符串姓氏=序列。 ReadStringuntil （ ' n ' ）;
系列。 println （姓氏）;
//用用户输入的数据填充“所有者”结构...
姓名。 Tochararray （所有者。名称， 100 ）;
姓。 Tochararray （所有者。姓氏， 100 ）;
// ...最后将所有内容保存到模拟 - eprom中
EEPROM。 put （storedaddress + sizeof （签名），所有者）;
//打印插入数据的确认。
系列。打印（ “ <<您的名字： ” ）;
系列。打印（所有者。名称）;
系列。打印（ “ 。您的姓氏： ” ）;
系列。打印（所有者。姓氏）;
系列。 println （ “ >>已保存。谢谢！ ” ）;
}
}
void loop （）
{
//什么都不做...
}

调试终端输出样品

1。使用LAN8720以太网和STM32Ethernet库，在Black_F407上进行以太网_STM32_LAN8720

以下是使用STM32F4的STM32F4 Black_F407VE在使用STM32Ethernet库的STM32F4 Black_F407VE上运行示例终端输出。

1.1检测到DoubleSet =>输入配置门户

Start Ethernet_STM32_LAN8720 on BLACK_F407VE
Ethernet Shield type : LAN8720 Ethernet & STM32Ethernet Library
Ethernet_Manager_STM32 v1 .3.2
DoubleResetDetector_Generic v1 .8.1

EEPROM size = 16384 , start = 0
Flag read = 0xd0d04321
No doubleResetDetected
SetFlag write = 0xd0d01234
[ETM] EEPROMsz: 4096
[ETM] EEPROM Length ():16384
[ETM] CCSum=0xaed,RCSum=0x4d385471
[ETM] ChkCrR:CrCCsum=0x21dd,CrRCsum=0x3338
[ETM] InitCfgFile,sz=60
[ETM] SaveEEPROM,Sz=16384,DataSz=0,WCSum=0x569
[ETM] CrCCSum=0xc30
[ETM] Start connectEthernet using DHCP
[ETM] MAC:FE-98-FC-DD-D9-BA
[ETM] Dynamic IP OK, connected
[ETM] IP:192.168.2.169
[ETM] bg: isForcedConfigPortal = false
[ETM] bg:Stay forever in CP:No ConfigDat
Connected! IP address: 192.168.2.169

Your stored Credentials :
MQTT Server = blank
Port = blank
MQTT UserName = blank
MQTT PWD = blank
Subs Topics = blank
Pubs Topics = blank
HStop doubleResetDetecting
ClearFlag write = 0xd0d04321
HHHHH[ETM] h:Updating EEPROM. Please wait for reset
[ETM] SaveEEPROM,Sz=16384,DataSz=0,WCSum=0x729
[ETM] CrCCSum=0x1087
[ETM] h:Rst

1.2配置数据保存=>正常运行

Start Ethernet_STM32_LAN8720 on BLACK_F407VE
Ethernet Shield type : LAN8720 Ethernet & STM32Ethernet Library
Ethernet_Manager_STM32 v1 .3.2
DoubleResetDetector_Generic v1 .8.1

EEPROM size = 16384 , start = 0
Flag read = 0xd0d04321
No doubleResetDetected
SetFlag write = 0xd0d01234
[ETM] EEPROMsz: 4096
[ETM] EEPROM Length ():16384
[ETM] CCSum=0x729,RCSum=0x729
[ETM] ChkCrR:CrCCsum=0x1087,CrRCsum=0x1087
[ETM] CrCCSum=1087,CrRCSum=1087
[ETM] Valid Stored Dynamic Data
[ETM] ======= Start Stored Config Data =======
[ETM] Header=STM32, BoardName=Black_V407VE
[ETM] StaticIP=blank
[ETM] Start connectEthernet using DHCP
[ETM] MAC:FE-98-FD-D6-DA-BA
[ETM] Dynamic IP OK, connected
[ETM] IP:192.168.2.170
[ETM] begin:Ethernet Connected.
Connected! IP address: 192.168.2.170

Your stored Credentials :
MQTT Server = mqtt_server
Port = 1883
MQTT UserName = mqtt_user
MQTT PWD = mqtt_pass
Subs Topics = Subs
Pubs Topics = Pubs
HStop doubleResetDetecting
ClearFlag write = 0xd0d04321
HSetFlag write = 0xd0d01234
[ETM] EEPROMsz:4096
[ETM] EEPROM Length():16384
[ETM] CCSum=0x729,RCSum=0x729
[ETM] ChkCrR:CrCCsum=0x1087,CrRCsum=0x1087
[ETM] CrCCSum=1087,CrRCSum=1087
[ETM] Valid Stored Dynamic Data
[ETM] ======= Start Stored Config Data =======
[ETM] Header=STM32, BoardName=Black_V407VE
[ETM] StaticIP=blank
[ETM] Start connectEthernet using DHCP
[ETM] MAC:FE-98-FD-D6-DB-BA
[ETM] Dynamic IP OK, connected
[ETM] IP:192.168.2.149
[ETM] begin:Ethernet Connected.
Connected! IP address: 192.168.2.149

Your stored Credentials :
MQTT Server = mqtt_server
Port = 1883
MQTT UserName = mqtt_user
MQTT PWD = mqtt_pass
Subs Topics = Subs
Pubs Topics = Pubs
HStop doubleResetDetecting
ClearFlag write = 0xd0d04321
HHHHHHHHH HHHHHHHHHH HHHHHHHHHH HHHHHHHHHH HHHHHHHHHH HHHHHHHHHH HHHHHHHHHH HHHHHHHHHH
HHHHHHHHHH HHHHHHHHHH HHHHHHHHHH HHHHHHHHHH HHHHHHHHHH HHHHHHHHHH HHHHHHHHHH HHHHHHHHHH
HHHHHHHHHH HHHHHHHHHH HHHHHHHHHH HHHHHHHHHH HHHHHHHHHH HHHHHHHHHH HHHHHHHHHH HHHHHHHHHH
HHHHHHHHHH HHHHHHHHHH HHHHHHHHHH H

2。nucleo_h743zi2上的StorenameanDername，带有16KB仿真 - EPROM

以下是在STM32H7 Nucleo-144 nucleo_h743zi2上运行示例StorenameanDsurname时的样品终端输出

2.1首次开始

Start StoreNameAndSurname on NUCLEO_H743ZI2
FlashStorage_STM32 v1 .2.0
EEPROM length: 16384
EEPROM is empty, writing WRITTEN_SIGNATURE and some example data:
Insert your name : My_Name

Insert your surname : My_Surname

<< Your name: My_Name
. Your surname: My_Surname
 >> have been saved. Thank you!

重置后2.2 

Start StoreNameAndSurname on NUCLEO_H743ZI2
FlashStorage_STM32 v1 .2.0
EEPROM length: 16384
Hi My_Name
 My_Surname
, nice to see you again :-)
Clearing WRITTEN_SIGNATURE for next try
Done clearing signature in emulated EEPROM. You can reset now

3。nucleo_l552ze_q上的Storenameandsurname，带有2KB模拟 - eprom

以下是在STM32L5 Nucleo-144 nucleo_l552ze_q上运行示例StorenameanDsurname时的样品终端输出

3.1首次开始

Start StoreNameAndSurname on NUCLEO_L552ZE_Q
FlashStorage_STM32 v1 .2.0
EEPROM length: 2048
EEPROM is empty, writing WRITTEN_SIGNATURE and some example data:
Insert your name : My_Name

Insert your surname : My_Surname

<< Your name: My_Name
. Your surname: My_Surname
 >> have been saved. Thank you!

3.2重置后

Start StoreNameAndSurname on NUCLEO_L552ZE_Q
FlashStorage_STM32 v1 .2.0
EEPROM length: 2048
Hi My_Name
 My_Surname
, nice to see you again :-)
Clearing WRITTEN_SIGNATURE for next try
Done clearing signature in emulated EEPROM. You can reset now

4。nucleo_f767zi上的StorenameandSurname，带有16KB模拟 - EPROM

以下是在STM32F7 nucleo-144 nucleo_f767zi上运行示例StorenameanDermame时的样品终端输出

4.1首次开始

Start StoreNameAndSurname on NUCLEO_F767ZI
FlashStorage_STM32 v1 .2.0
EEPROM length: 16384
EEPROM is empty, writing WRITTEN_SIGNATURE and some example data:
Insert your name : My_Name

Insert your surname : My_Surname

<< Your name: My_Name
. Your surname: My_Surname
 >> have been saved. Thank you!

4.2重置后

Start StoreNameAndSurname on NUCLEO_F767ZI
FlashStorage_STM32 v1 .2.0
EEPROM length: 16384
Hi My_Name
 My_Surname
, nice to see you again :-)
Clearing WRITTEN_SIGNATURE for next try
Done clearing signature in emulated EEPROM. You can reset now

常问问题

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

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

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

不使用STM32。

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

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

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

故障排除

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

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

问题

提交问题：flashstorage_stm32问题

做

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

完毕

  1. STM32F/L/H/G/WB/MP1的基本仿真 - EPROM。
  2. 添加支持新的STM32 Core v1.9.0
  3. 剩余的Arduino板（例如SAMD21，SAMD51）等类似的功能。
  4. 添加目录
  5. 添加支持新的STM32 Core v2.2.0+
  6. 修复multiple-definitions链接器错误。
  7. 使用allman样式添加ASTYLE。库图书馆

贡献和感谢

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

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

贡献

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

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

执照

  • 图书馆在麻省理工学院获得许可

版权

版权（C）2021- Khoi Hoang

展开
附加信息
相关应用
为您推荐
相关资讯 全部