FlashStorage_SAMD
v1.3.2 to make compatible with old libraries and codes
Multiple Definitions Erro do vinculador Por favor, dê uma olhada no como corrigir Multiple Definitions erro de vinculador
A biblioteca flashstorage_samd, baseada e modificada no FlashStorage de Cristian Maglie, fornece uma maneira conveniente de armazenar e recuperar os dados do usuário usando a EEPROM EMULELED-EEPROM, a partir da memória flash não volátil das placas SAMD21/SAMD51.
A memória flash, geralmente usada para armazenar o código do firmware, também pode ser usada para armazenar / recuperar mais dados do usuário e mais rápido que a EEPROM. Graças à redação e leitura de dados em buffer , o tempo de acesso flash é bastante reduzido para aumentar a vida útil do flash .
Arduino IDE 1.8.19+ para Arduino.Arduino SAMD core 1.8.13+ para placas SAMD ARM Cortex-M0+.Adafruit SAMD core 1.7.11+ para samd córtex-m0+ e m4 placas (nano 33 IoT, etc.).Seeeduino SAMD core 1.8.3+ para placas SAMD21/SAMD51 (XIAO M0, WIO Terminal, etc.).IndustruinoSAMD core 1.0.3+ para placas SAMD21 (Indunuino DG21, etc.).IndustruinoSAML core 1.0.0+ para placas SAML21 (Indunuino 420maker, etc.).Sparkfun SAMD core 1.8.4+ para placas SAMD21/SAMD51 (Sparkfun_redboard_turbo, Sparkfun_samd51_thing_plus, etc.). A melhor e mais fácil maneira é usar Arduino Library Manager . Pesquise flashstorage_samd e selecione / instale a versão mais recente.
Outra maneira de instalar é:
FlashStorage_SAMD-master.zip .FlashStorage_SAMD-master diretórioFlashStorage_SAMD-master Pasta para o diretório das bibliotecas Arduino, como ~/Arduino/libraries/ .Para poder compilar sem erro e detectar e exibir automaticamente o Board_name nas placas Arduino SAMD (Nano-33-IIT, etc) , você deve copiar todo o diretório Arduino SAMD Packages_patches no diretório Arduino SAMD (~/.UNINOIN15/PACAGES/ARDUINOINO/SAMDDRO/SAMD/SAMD/SAMD/SAMD (~/.arino15/)/arduino/hardware/samd/samd (~.
Supondo que a versão Arduino SAMD seja 1.8.13. Agora, apenas um arquivo deve ser copiado no diretório:
~/.arduino15/packages/arduino/hardware/samd/1.8.13/platform.txtSempre que uma nova versão estiver instalada, lembre -se de copiar esses arquivos no novo diretório da versão. Por exemplo, uma nova versão é x.yy.zz
Este arquivo deve ser copiado no diretório:
~/.arduino15/packages/arduino/hardware/samd/x.yy.zz/platform.txtSupondo que a versão Arduino SAMD seja 1.8.9. Esses arquivos devem ser copiados no diretório:
~/.arduino15/packages/arduino/hardware/samd/1.8.9/platform.txt~/.arduino15/packages/arduino/hardware/samd/1.8.9/cores/arduino/Arduino.hSempre que uma nova versão estiver instalada, lembre -se de copiar esses arquivos no novo diretório de versão. Por exemplo, uma nova versão é x.yy.z
Esses arquivos devem ser copiados no diretório:
~/.arduino15/packages/arduino/hardware/samd/x.yy.z/platform.txt~/.arduino15/packages/arduino/hardware/samd/x.yy.z/cores/arduino/Arduino.hIsso é obrigatório para corrigir o notório erro do compilador SAMD Arduino . Veja Melhorar a compatibilidade do Arduino com o STL (Min e Max Macro)
...arm-none-eabiincludec++7.2.1bitsstl_algobase.h:243:56: error: macro "min" passed 3 arguments, but takes just 2
min(const _Tp& __a, const _Tp& __b, _Compare __comp)
Sempre que o problema de erro do compilador acima mencionado é corrigido com a nova versão do Arduino SAMD, você não precisa mais copiar o arquivo Arduino.h .
Para poder compilar sem erro e detectar e exibir automaticamente as placas Board_name nas placas Adafruit SAMD (Itsy-Bitsy M4, etc.) , você deve copiar os arquivos no Adafruit SAMD Packages_patches no diretório samd Adafruit (~/.arino15/pacotes/Adafruit/hardware/samd/1.7.1.11.
Supondo que a versão Adafruit SAMD Core seja 1.7.11. Este arquivo deve ser copiado no diretório:
~/.arduino15/packages/adafruit/hardware/samd/1.7.11/platform.txt~/.arduino15/packages/adafruit/hardware/samd/1.7.11/cores/arduino/Print.h~/.arduino15/packages/adafruit/hardware/samd/1.7.11/cores/arduino/Print.cppSempre que uma nova versão estiver instalada, lembre -se de copiar esse arquivo no novo diretório de versão. Por exemplo, uma nova versão é x.yy.zz Este arquivo deve ser copiado no diretório:
~/.arduino15/packages/adafruit/hardware/samd/x.yy.zz/platform.txt~/.arduino15/packages/adafruit/hardware/samd/x.yy.zz/cores/arduino/Print.h~/.arduino15/packages/adafruit/hardware/samd/x.yy.zz/cores/arduino/Print.cppPara poder compilar sem erro e detectar e exibir automaticamente Board_name nas placas Seeeduino SAMD (Xiao M0, WIO, etc.) , você deve copiar os arquivos nos pacotes Samd SeeDuino_patches no diretório SAMD SeeDuino/.
Supondo que a versão Core Samd SeeDuino seja 1.8.3. Este arquivo deve ser copiado no diretório:
~/.arduino15/packages/Seeeduino/hardware/samd/1.8.3/platform.txt~/.arduino15/packages/Seeeduino/hardware/samd/1.8.3/cores/arduino/Arduino.h~/.arduino15/packages/Seeeduino/hardware/samd/1.8.3/cores/arduino/Print.h~/.arduino15/packages/Seeeduino/hardware/samd/1.8.3/cores/arduino/Print.cppSempre que uma nova versão estiver instalada, lembre -se de copiar esse arquivo no novo diretório de versão. Por exemplo, uma nova versão é x.yy.zz Este arquivo deve ser copiado no diretório:
~/.arduino15/packages/Seeeduino/hardware/samd/x.yy.zz/platform.txt~/.arduino15/packages/Seeeduino/hardware/samd/x.yy.zz/cores/arduino/Arduino.h~/.arduino15/packages/Seeeduino/hardware/samd/x.yy.zz/cores/arduino/Print.h~/.arduino15/packages/Seeeduino/hardware/samd/x.yy.zz/cores/arduino/Print.cppPara poder compilar sem erro e detectar e exibir automaticamente Board_name no Sparkfun SAMD (xiao sparkfun_redboard_turbo, sparkfun_samd51_thing_plus, etc) placas , você deve copiar o arquivo SPARKFUN SAMD Packages_Patches em Sparkfun Samd/Diretory (~/..
Supondo que a versão Core Sparkfun SAMD seja 1.8.3. Este arquivo deve ser copiado no diretório:
~/.arduino15/packages/SparkFun/hardware/samd/1.8.3/cores/arduino/Print.h~/.arduino15/packages/SparkFun/hardware/samd/1.8.3/cores/arduino/Print.cpp~/.arduino15/packages/SparkFun/hardware/samd/1.8.3/cores/arduino51/Print.h~/.arduino15/packages/SparkFun/hardware/samd/1.8.3/cores/arduino51/Print.cppSempre que uma nova versão estiver instalada, lembre -se de copiar esse arquivo no novo diretório de versão. Por exemplo, uma nova versão é x.yy.zz Este arquivo deve ser copiado no diretório:
~/.arduino15/packages/SparkFun/hardware/samd/x.yy.zz/cores/arduino/Print.h~/.arduino15/packages/SparkFun/hardware/samd/x.yy.zz/cores/arduino/Print.cpp~/.arduino15/packages/SparkFun/hardware/samd/x.yy.zz/cores/arduino51/Print.h~/.arduino15/packages/SparkFun/hardware/samd/x.yy.zz/cores/arduino51/Print.cppMultiple Definitions Erro do vinculador A implementação atual da biblioteca, usando xyz-Impl.h em vez de padrão xyz.cpp , possivelmente cria certos erros de linker Multiple Definitions em certos casos de uso.
Você pode incluir este arquivo .hpp
// Can be included as many times as necessary, without `Multiple Definitions` Linker Error
# include " FlashStorage_SAMD.hpp " // https://github.com/khoih-prog/FlashStorage_SAMD em muitos arquivos. Mas não deixe de usar o seguinte arquivo .h em apenas 1 .h , .cpp ou .ino arquivo , que não deve ser incluído em nenhum outro arquivo , para evitar o erro Multiple Definitions do vinculador
// To be included only in main(), .ino with setup() to avoid `Multiple Definitions` Linker Error
# include " FlashStorage_SAMD.h " // https://github.com/khoih-prog/FlashStorage_SAMD Verifique o novo exemplo do MultifileProject para uma demonstração HOWTO .
Dê uma olhada na discussão em comportamentos diferentes usando o src_cpp ou src_h lib #80
A memória flash tem uma quantidade limitada de ciclos de gravação. As memórias flash típicas podem executar cerca de 10000 gravações de ciclos para o mesmo bloco de flash antes de começar a "desgastar" e começar a perder a capacidade de reter dados.
Assim , cuidado: o uso inadequado desta biblioteca pode destruir de maneira rápida e permanentemente a memória flash do seu micro , em particular você deve evitar chamar a função write() com muita frequência e verifique se, em toda a vida do micro o número de chamadas para write bem abaixo do limite acima de 10000 (é uma boa regra de tempo para manter esse número em mente, mesmo que o fabricante do micro-garantia
A mesma cautela deve ser tomada se você estiver usando a emulação da API EEPROM (veja abaixo) com a função EEPROM.commit() .
Antes de tudo, você deve declarar um objeto global FlashStorage para cada dados que você pretende armazenar na memória flash.
Por exemplo, se você deseja armazenar a idade de uma pessoa, deve declarar um age_storage como este:
FlashStorage (age_storage, int ); Esta instrução significa "Crie um FlashStorage para armazenar uma variável int e chamá -lo de age_storage ". Agora você pode usar age_storage como um local para armazenar com segurança um número inteiro:
void readAndStoreUserAge ()
{
Serial. println ( " Please enter your age: " );
String age = Serial. readStringUntil ( ' n ' );
age_storage. write (age. toInt ()); // <-- save the age
}Após uma redefinição do microcontrolador para recuperar a idade armazenada que você pode usar:
int user_age = age_storage.read(); Inclua FlashStorage_SAMD.h para obter uma emulação EEPROM com a memória flash interna.
Veja o esboço EmulareeProm para um exemplo.
A API é muito semelhante à conhecida API da Biblioteca Arduino EEPROM, mas com 4 funções adicionais:
bool isValid() retorna true se os dados na eeprom emulada forem válidos (os dados gravados para flash pelo menos uma vez por EEPROM.commit() ou EEPROM.put() ). Caso contrário, os dados emulados-eeprom são "indefinidos" e a função retorna false .void commit() Armazene os dados da EEPROM no Flash. Use isso com cuidado: cada chamada grava os dados completos da EEPROM emulada para piscar. Isso reduzirá os restantes ciclos flash-write. Não chame esse método em um loop ou você matará seu flash em breve.void setCommitASAP(bool value = true) para definir ou limpar a variável privada _commitASAP (o padrão é true para ser seguro). Se _Commitasap for falso, a chamada para EEPROM.put() não forçará o EEPROM.commit() a prolongar a vida útil do flash. Você precisará se lembrar de ligar para EEPROM.commit() para salvar manualmente os dados emulados-eeprom em flash ou dados serão perdidos.bool getCommitASAP() para retornar o valor atual de _commitASAP .FlashStorage_samd/Exemplos/storenameandsurname/storenameandsurname.ino
Linhas 26 a 128 em 102E13E
A seguir, é apresentado a saída do terminal de amostra ao executar o exemplo w5500_blynk no Adafruit SAMD51 ItsyBitsy_m4 usando o W5500 Ethernet Shield
Start W5500_Blynk on ITSYBITSY_M4
[ 936 ] ChkCrR:CrCCSum= 0xaf50 ,CrRCSum= 0xffffffff
[ 936 ] CCSum= 0x0 ,RCSum= 0x0
[ 936 ] Invalid Stored Dynamic Data. Load default from Sketch
[ 937 ] SaveEEPROM,Sz= 1024 ,DataSz= 0 ,WCSum= 0x1d4d
[ 944 ] CrCCSum= 0x29a6
[ 944 ] MAC:FE-A8- 80 -C6-CE-A3
_pinCS = 0
W5100 init, using SS_PIN_DEFAULT = 10 , new ss_pin = 10 , W5100Class::ss_pin = 1
W5100::init: W5500, SSIZE = 8192
[ 2632 ] IP: 192.168.2.153
[ 2633 ] b:Stay in CfgPortal:No CfgDat
[ 2633 ] CfgIP= 192.168.2.153
F
Your stored Credentials :
MQTT Server = default -mqtt-server
Port = 1883
MQTT UserName = default -mqtt-username
MQTT PWD = default -mqtt-password
Subs Topics = default -mqtt-SubTopic
Pubs Topics = default -mqtt-PubTopic
FFFFF
[ 339285 ] SaveEEPROM,Sz= 1024 ,DataSz= 0 ,WCSum= 0x2e89
[ 339292 ] CrCCSum= 0x219f Save => Reiniciar Start W5500_Blynk on ITSYBITSY_M4
[ 1547 ] ChkCrR:CrCCSum= 0x219f ,CrRCSum= 0x219f
[ 1547 ] CCSum= 0x0 ,RCSum= 0x0
[ 1548 ] CrCCSum= 0x219f ,CrRCSum= 0x219f
[ 1548 ] ======= Start Stored Config Data =======
[ 1548 ] Hdr=W5X00,BName=Seeeduino_W5500_BlynkWM
[ 1548 ] Svr=account.duckdns.org,Tok=new_token1
[ 1549 ] Svr1=account.ddns.net,Tok1=new_token2
[ 1549 ] Prt= 8080 ,SIP= 192.168.2.220
[ 1549 ] connectEthernet: Use static_IP= 192.168.2.220
[ 1549 ] MAC:FE-A1-D4-BC- E8 -CB
W5100 init, using SS_PIN_DEFAULT = 10 , new ss_pin = 10 , W5100Class::ss_pin = 1
W5100::init: W5500, SSIZE = 8192
[ 3131 ] IP: 192.168.2.220
[ 3131 ] bg:ECon.TryB
[ 3131 ]
___ __ __
/ _ )/ /_ _____ / /__
/ _ / / // / _ / '_/
/____/_/_, /_ // _/_/_
/___/ v0.6.1 on Arduino Zero
[ 3132 ] BlynkArduinoClient.connect: Connecting to account.duckdns.org: 8080
[ 3244 ] Ready (ping: 6ms).
[ 3311 ] Connected to BlynkServer=account.duckdns.org,Token=new_token1
[ 3311 ] bg:EBCon
Conn2Blynk: server = account.duckdns.org, port = 8080
Token = new_token1, IP = 192.168.2.220
B
Your stored Credentials :
MQTT Server = new -mqtt-server
Port = 1883
MQTT UserName = new -mqtt-username
MQTT PWD = new -mqtt-password
Subs Topics = new -mqtt-SubTopic
Pubs Topics = new -mqtt-PubTopic
BBBBBBBBB BBBBBBBBBB BBBBBBBBBB BBBBBBBBBB BBBBBBBBBB BBBBBBBBBB BBBBBBBBBBStart StoreNameAndSurname on SEEED_XIAO_M0
FlashStorage_SAMD v1 .3.2
EEPROM length: 1024
EEPROM is empty, writing WRITTEN_SIGNATURE and some example data:
Insert your name : John
Insert your surname : Doe
<< Your name: John. Your surname: Doe >> have been saved. Thank you!
You can reset to check emulated-EEPROM data retention.Start StoreNameAndSurname on SEEED_XIAO_M0
FlashStorage_SAMD v1 .3.2
EEPROM length: 1024
Hi John Doe, nice to see you again :-)
Clearing WRITTEN_SIGNATURE for next try
Done clearing signature in emulated EEPROM. You can reset nowStart EEPROM_Clear on SEEED_XIAO_M0
FlashStorage_SAMD v1 .3.2
Emulated EEPROM length (bytes) = 1024
Done clearing emulated EEPROM. Time spent (ms) = 11
Start EEPROM_Clear on SEEED_XIAO_M0
FlashStorage_SAMD v1 .3.2
Emulated EEPROM length (bytes) = 2048
Done clearing emulated EEPROM. Time spent (ms) = 22Start EEPROM_Clear on SEEED_XIAO_M0
FlashStorage_SAMD v1 .3.2
Emulated EEPROM length (bytes) = 4096
Done clearing emulated EEPROM. Time spent (ms) = 42Start EEPROM_get on SEEED_XIAO_M0
FlashStorage_SAMD v1 .3.2
EEPROM length: 1024
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! Start EEPROM_get on SEEED_XIAO_M0
FlashStorage_SAMD v1 .3.2
EEPROM length: 1024
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!
=============== Sim, você pode declarar uma struct com mais campos e chamar um EEPROM.put() para armazenar toda a estrutura. Veja o StorenameandSurname para como fazê -lo.
Sim, toda vez que você carrega um novo esboço, o conteúdo anterior do FlashStorage é apagado.
Não. Se a sua placa fornecer uma e-mail integrada, é aconselhável usar isso porque a EEPROM tem uma vida útil mais longa, número de ciclos de gravação etc.).
Na ausência de uma prome integrada ou seu tamanho é muito pequeno para o seu caso de uso, você pode usar esta biblioteca para usar uma pequena porção de memória flash como emulada-eeprom, desde que você tenha em mente os limites, como no número limitado de gravações
Se você receber erros de compilação, na maioria das vezes, pode ser necessário instalar uma versão mais recente do núcleo para as placas Arduino.
Às vezes, a biblioteca só funcionará se você atualizar o núcleo da placa para a versão mais recente, porque estou usando funções recém -adicionadas.
Envie questões para: FlashStorage_Samd Issues
EEPROM.put() e EEPROM.get() para ler/escrever toda a estrutura na eeprom emuladamultiple-definitions .SAMD21E1xA , SAMD21G1xA e SAMD21J1xA Cristian Maglie |
Se você deseja contribuir com este projeto:
