Page d'accueil>Ressources de création de sites Web>Code source FLASH
Télécharger

Bibliothèque FS_NANO33BLE

Table des matières

  • Pourquoi avons-nous besoin de cette bibliothèque FS_NANO33BLE
    • Notes importantes
    • Caractéristiques
    • Boards actuellement pris en charge
  • Changelog
  • Condition préalable
  • Installation
    • Utiliser le gestionnaire de bibliothèque Arduino
    • Installation manuelle
    • Vs code et plateforme
  • Exemples
    • 1. FS_COUNTING
    • 2. FS_TEST
  • Exemple fs_test
  • Débogage des échantillons de sortie de terminal
    • 1. FS_COUNTING ON NANO 33 BLE avec Littlefs Taille 256KB
    • 2. FS_TEST sur Nano 33 BLE avec Littlefs Taille 256KB
    • 3. FS_TEST sur Nano 33 BLE avec FATFS Taille 512KB
  • Déboguer
  • Dépannage
  • Problèmes
  • FAIRE
  • FAIT
  • Contributions et merci
  • Contributif
  • Licence
  • Droit d'auteur

Pourquoi avons-nous besoin de cette bibliothèque FS_NANO33BLE

Notes importantes

Évitez d'utiliser FATFS car le problème avec le noyau ???) est OK d'utiliser uniquement avec 512KB . Veuillez utiliser le meilleur LittleFS , où vous pouvez sélectionner la taille de 64 Ko à 512 Ko.

Caractéristiques

Cette bibliothèque est juste un simple wrapper LittleFS pour faciliter votre utilisation de LittleFS pour le flash embarqué sur MBED NRF52840 Basé sur des planches telles que Nano_33_Ble, Nano_33_ble_Sense , en utilisant Arduino-Mbed Mbed_nano Core

L'accès au système de fichiers utilise des API POSIX normales ou des API de système de fichiers MBED

Boards actuellement pris en charge

  1. Des conseils basés sur MBED NRF52840 tels que Nano_33_Ble, Nano_33_BLE_Sense , etc. Utilisation d'Arduino-Mbed Mbed_nano Core
  2. Des conseils basés sur des voies de recherche NRF52840 tels que Seed_XIAO_NRF52840 et Seed_Xiao_NRF52840_Sense , etc. En utilisant le noyau de SeeDuino mbed

Condition préalable

  1. Arduino IDE 1.8.19+ pour Arduino.
  2. Arduino mbed_nano core 3.4.1+ pour Arduino (utilisez des cartes basées sur le tableau Arduino) Mbed NRF52840 tels que Nano_33_Ble, Nano_33_BLE_SENSE .
  3. Seeeduino mbed core 2.7.2+ pour les tableaux basés sur SeeDeduino NRF52840 tels que Seed_Xiao_NRF52840 et Seed_xiao_nrf52840_Sense

Installation

Utiliser le gestionnaire de bibliothèque Arduino

Le moyen le meilleur et le plus simple est d'utiliser Arduino Library Manager . Recherchez FS_NANO33BLE , puis sélectionnez / installez la dernière version. Vous pouvez également utiliser ce lien pour des instructions plus détaillées.

Installation manuelle

Une autre façon d'installer est de:

  1. Accédez à la page FS_NANO33BLE .
  2. Téléchargez la dernière version FS_Nano33BLE-main.zip .
  3. Extraire le fichier zip dans le répertoire FS_Nano33BLE-main
  4. Copiez le dossier Whole FS_Nano33BLE-main dans le répertoire des bibliothèques Arduino tels que ~/Arduino/libraries/ .

Vs code et plateforme

  1. Installer vs code
  2. Installer PlatformoIo
  3. Installez la bibliothèque FS_NANO33BLE en utilisant Library Manager. Recherchez FS_NANO33BLE dans Platform.Io Libraries de l'auteur
  4. Utilisez le fichier Platformo.ini inclus à partir d'exemples pour s'assurer que toutes les bibliothèques dépendantes seront installées automatiquement. Veuillez visiter la documentation pour les autres options et exemples dans le fichier de configuration du projet

Exemples

  1. FS_COUNTING
  2. Fs_test

Exemple fs_test

Fs_nano33ble / exemples / fs_test / fs_test.ino

Lignes 11 à 371 dans AC168D3

# Définir FS_NANO33BLE_VERSION_MIN_TARGET " FS_NANO33BLE V1.2.1 "
# Définir FS_NANO33BLE_VERSION_MIN 1002001
# définir _fs_loglevel_ 1
// min nano33ble_fs_size_kb doit être 64KB. Si Smalller défini => Auto ajuster à 64KB
// max nano33ble_fs_size_kb doit être 512KB. Si défini, plus grand => Auto ajuster à 512KB
# définir nano33ble_fs_size_kb 256
# define Force_Reformat False
// par défaut Using_Littlefs. Décomment pour ne pas utiliser_littlefs => using_fatfs.
// Il est conseillé de ne pas utiliser les FATF, car le nano33ble_fs_size_kb doit être ajusté automatiquement à 512KB
// #define using_littlefs false
# Inclure < fs_nano33ble.h >
FileSystem_Med * MYFS;
VOID ReadcharsFromfile ( CONS CHAR * PATH)
{
En série. print ( " ReadcharsFromfile: " );
En série. imprimer (chemin);
File * file = fopen (path, " r " );
if (fichier)
{
En série. println ( " => ouvert ok " );
}
autre
{
En série. println ( " => ouvert échoué " );
retour ;
}
Char C;
tandis que ( vrai )
{
c = fGetc (fichier);
if ( feof (fichier))
{
casser ;
}
autre
En série. imprimer (c);
}
fclose (fichier);
}
void readfile ( const char * chemin)
{
En série. print ( " Fichier de lecture: " );
En série. imprimer (chemin);
File * file = fopen (path, " r " );
if (fichier)
{
En série. println ( " => ouvert ok " );
}
autre
{
En série. println ( " => ouvert échoué " );
retour ;
}
Char C;
uint32_t numRead = 1 ;
tandis que (numread)
{
numRead = Fread (( uint8_t *) & c, sizeof (c), 1 , fichier);
if (numread)
En série. imprimer (c);
}
fclose (fichier);
}
void writeFile ( CONS CHAR * PATH, const char * Message, size_t MessageSize)
{
En série. print ( " Fichier d'écriture: " );
En série. imprimer (chemin);
Fichier * file = fopen (path, " w " );
if (fichier)
{
En série. println ( " => ouvert ok " );
}
autre
{
En série. println ( " => ouvert échoué " );
retour ;
}
Message if ( fwrite (( uint8_t *), 1 , messages, fichier)))
{
En série. println ( " * écriture ok " );
}
autre
{
En série. println ( " * Écriture a échoué " );
}
fclose (fichier);
}
void appenfil ( const char * chemin, const char * message, size_t messize)
{
En série. print ( " Fichier d'appel d'appel: " );
En série. imprimer (chemin);
File * file = fopen (path, " a " );
if (fichier)
{
En série. println ( " => ouvert ok " );
}
autre
{
En série. println ( " => ouvert échoué " );
retour ;
}
Message if ( fwrite (( uint8_t *), 1 , messages, fichier)))
{
En série. println ( " * ajout ok " );
}
autre
{
En série. println ( " * amestming a échoué " );
}
fclose (fichier);
}
void DeleteFile ( CONS CHAR * PATH)
{
En série. print ( " Suppression de fichier: " );
En série. imprimer (chemin);
if ( supprimer (chemin) == 0 )
{
En série. println ( " => ok " );
}
autre
{
En série. println ( " => a échoué " );
retour ;
}
}
void RenameFile ( const char * path1, const char * path2)
{
En série. print ( " Fichier de changement de nom: " );
En série. print (path1);
En série. print ( " à: " );
En série. print (path2);
if ( renommer (path1, path2) == 0 )
{
En série. println ( " => ok " );
}
autre
{
En série. println ( " => a échoué " );
retour ;
}
}
void testfileio ( PATH CHAR *)
{
En série. print ( " Tester les E / S de fichiers avec: " );
En série. imprimer (chemin);
# définir Buff_Size 512
statique uint8_t buf [buff_size];
Fichier * file = fopen (path, " w " );
if (fichier)
{
En série. println ( " => ouvert ok " );
}
autre
{
En série. println ( " => ouvert échoué " );
retour ;
}
size_t i;
En série. println ( " - écriture " );
uint32_t start = Millis ();
size_t result = 0 ;
// Écrivez un fichier seulement 1/4 de nano33ble_fs_size_kb
pour (i = 0 ; i <nano33ble_fs_size_kb / 2 ; i ++)
{
result = fwrite (buf, buff_size, 1 , fichier);
si (résultat! = 1 )
{
En série. print ( " write result = " );
En série. println (résultat);
En série. print ( " Erreur d'écriture, i = " );
En série. println (i);
casser ;
}
}
En série. println ( " " );
uint32_t end = Millis () - start;
En série. imprimer (i / 2 );
En série. print ( " kytes écrit en (ms) " );
En série. println (fin);
fclose (fichier);
printline ();
// /////////////////////////////////////
file = fopen (path, " r " );
start = Millis ();
end = start;
i = 0 ;
if (fichier)
{
start = Millis ();
En série. println ( " - lecture " );
résultat = 0 ;
fseek (fichier, 0 , Seek_set);
// Lire le fichier seulement 1/4 de Nano33ble_FS_Size_KB
pour (i = 0 ; i <nano33ble_fs_size_kb / 2 ; i ++)
{
result = fread (buf, buff_size, 1 , fichier);
si (résultat! = 1 )
{
En série. print ( " read result = " );
En série. println (résultat);
En série. print ( " Erreur de lecture, i = " );
En série. println (i);
casser ;
}
}
En série. println ( " " );
end = Millis () - Start;
En série. print ((i * buff_size) / 1024 );
En série. print ( " kytes read in (ms) " );
En série. println (fin);
fclose (fichier);
}
autre
{
En série. println ( " - Impossible d'ouvrir le fichier pour la lecture " );
}
}
void Printline ()
{
En série. println ( " ****************************************************** " );
}
VOID SETUP ()
{
En série. commencer ( 115200 );
while (! Serial && millis () < 5000 );
retard ( 1000 );
En série. print ( " n start fs_test on " );
En série. println (board_name);
En série. println (fs_nano33ble_version);
# si défini (fs_nano33ble_version_min)
if (fs_nano33ble_version_int <fs_nano33ble_version_min)
{
En série. print ( " avertissement. doit utiliser cet exemple sur la version égale ou plus tard que: " );
En série. println (fs_nano33ble_version_min_target);
}
# endif
En série. print ( " fs_size (kb) = " );
En série. println (nano33ble_fs_size_kb);
En série. print ( " fs_ start adresse = 0x " );
En série. println (nano33ble_fs_start, hex);
myfs = new FileSystem_Mbed ();
if (! myfs-> init ())
{
En série. println ( " FS Mount a échoué " );
retour ;
}
char filename1 [] = mbed_fs_file_prefix " /hello1.txt " ;
char filename2 [] = mbed_fs_file_prefix " /hello2.txt " ;
Message char [] = " Bonjour de Nano_33_BLE n " ;
printline ();
writeFile (filename1, message, sizeof (message));
printline ();
ReadFile (FileName1);
printline ();
APPENDFILE (FILENAME1, Message, SizeOf (message));
printline ();
ReadFile (FileName1);
printline ();
RENAMEFILE (FILENAME1, FILENAME2);
printline ();
ReadcharsFromFile (FileName2);
printline ();
DeleteFile (FileName2);
printline ();
ReadFile (FileName2);
printline ();
TestFileio (FileName1);
printline ();
TestFileio (FileName2);
printline ();
DeleteFile (FileName1);
printline ();
DeleteFile (FileName2);
printline ();
En série. println ( " n test complet " );
}
VOID LOOP ()
{
}

Débogage des échantillons de sortie de terminal

1. FS_COUNTING ON NANO 33 BLE avec Littlefs Taille 256KB

Ce qui suit est l'exemple de sortie de terminal lors de l'exécution de l'exemple FS_COUNTING sur mbed nano_33_ble en utilisant Littlefs 

Start FS_Test on Nano 33 BLE
LittleFS_Nano33BLE v1 .2.1
FS_size (KB) = 256
FS_ Start Address = 0xC0000
[FS] LittleFS size (KB) = 256
[LFS] LittleFS Mount OK
Deleting file: /littlefs/counts.txt => OK
Times have been run = 1
 => Open to write OK

Start FS_Test on Nano 33 BLE
LittleFS_Nano33BLE v1.2.1
[LFS] LittleFS size (KB) = 256
[LFS] LittleFS Mount OK
 => Open to read OK
Times have been run = 2
 => Open to write OK

Start FS_Test on Nano 33 BLE
LittleFS_Nano33BLE v1.2.1
[LFS] LittleFS size (KB) = 256
[LFS] LittleFS Mount OK
 => Open to read OK
Times have been run = 3
 => Open to write OK

2. FS_TEST sur Nano 33 BLE avec Littlefs Taille 256KB

Ce qui suit est l'exemple de sortie de terminal lors de l'exécution de l'exemple FS_TEST sur mbed nano_33_ble en utilisant Littlefs 

Start FS_Test on Nano 33 BLE
LittleFS_Nano33BLE v1 .2.1
FS_size (KB) = 256
FS_ Start Address = 0xC0000
[FS] LittleFS size (KB) = 256
[LFS] LittleFS Mount Fail
[LFS] Formatting... 
[LFS] 
FS Format OK. Mounting
====================================================
Writing file: /fs/hello1.txt => Open OK
* Writing OK
====================================================
Reading file: /fs/hello1.txt => Open OK
Hello from Nano_33_BLE
====================================================
Appending file: /fs/hello1.txt => Open OK
* Appending OK
====================================================
Reading file: /fs/hello1.txt => Open OK
Hello from Nano_33_BLE
Hello from Nano_33_BLE
====================================================
Renaming file: /fs/hello1.txt to: /fs/hello2.txt => OK
====================================================
readCharsFromFile: /fs/hello2.txt => Open OK
Hello from Nano_33_BLE
Hello from Nano_33_BLE
====================================================
Deleting file: /fs/hello2.txt => OK
====================================================
Reading file: /fs/hello2.txt => Open Failed
====================================================
Testing file I/O with: /fs/hello1.txt => Open OK
- writing

64 Kbytes written in (ms) 2461
====================================================
- reading

64 Kbytes read in (ms) 7
====================================================
Testing file I/O with: /fs/hello2.txt => Open OK
- writing

64 Kbytes written in (ms) 2460
====================================================
- reading

64 Kbytes read in (ms) 7
====================================================
Deleting file: /fs/hello1.txt => OK
====================================================
Deleting file: /fs/hello2.txt => OK
====================================================

Test complete

3. FS_TEST sur Nano 33 BLE avec FATFS Taille 512KB

Ce qui suit est l'exemple de sortie de terminal lors de l'exécution de l'exemple FS_TEST sur mbed nano_33_ble en utilisant les FATFS 

Start FS_Test on Nano 33 BLE
FATFS_Nano33BLE v1 .2.1
FS_size (KB) = 512
FS_ Start Address = 0x80000
[FS] LittleFS size (KB) = 512
[LFS] FATFS Mount OK
====================================================
Writing file: /fs/hello1.txt => Open OK
* Writing OK
====================================================
Reading file: /fs/hello1.txt => Open OK
Hello from Nano_33_BLE
====================================================
Appending file: /fs/hello1.txt => Open OK
* Appending OK
====================================================
Reading file: /fs/hello1.txt => Open OK
Hello from Nano_33_BLE
Hello from Nano_33_BLE
====================================================
Renaming file: /fs/hello1.txt to: /fs/hello2.txt => OK
====================================================
readCharsFromFile: /fs/hello2.txt => Open OK
Hello from Nano_33_BLE
Hello from Nano_33_BLE
====================================================
Deleting file: /fs/hello2.txt => OK
====================================================
Reading file: /fs/hello2.txt => Open Failed
====================================================
Testing file I/O with: /fs/hello1.txt => Open OK
- writing

64 Kbytes written in (ms) 4374
====================================================
- reading

64 Kbytes read in (ms) 15
====================================================
Testing file I/O with: /fs/hello2.txt => Open OK
- writing

64 Kbytes written in (ms) 4374
====================================================
- reading

64 Kbytes read in (ms) 15
====================================================
Deleting file: /fs/hello1.txt => OK
====================================================
Deleting file: /fs/hello2.txt => OK
====================================================

Test complete

Déboguer

Debug est activé par défaut sur série.

Vous pouvez également modifier le niveau de débogage ( fs_loglevel ) de 0 à 4 

# define FS_DEBUG_OUTPUT    Serial

// These define's must be placed at the beginning before #include "FS_Nano33BLE.h"
// _FS_LOGLEVEL_ from 0 to 4
# define _FS_LOGLEVEL_      0

Dépannage

Si vous obtenez des erreurs de compilation, le plus souvent, vous devrez peut-être installer une version plus récente du noyau pour les tableaux Arduino.

Parfois, la bibliothèque ne fonctionnera que si vous mettez à jour le noyau de la carte vers la dernière version car j'utilise des fonctions nouvellement ajoutées.

Problèmes

Soumettre des problèmes à: FS_NANO33BLE

FAIRE

  1. Recherchez un bogue et une amélioration.

FAIT

  1. Emballage Littlefs de base pour les conseils basés sur MBED NRF52840 tels que Nano_33_Ble, Nano_33_BLE_Sense , en utilisant Arduino-Mbed Mbed_nano Core
  2. Ajouter la chaîne de version
  3. Ajouter une table des matières
  4. Correction de l'erreur de linker multiple-definitions
  5. Utilisez une adresse NANO33BLE_FS_START correcte pour LittleFS sans gaspiller un espace flash. Vérifiez la moitié de la taille du flash # 2
  6. Ajoutez une prise en charge aux conseils basés sur SeeDeduino NRF52840 tels que Seed_xiao_NRF52840 et Seed_Xiao_NRF52840_Sense mbed etc.
  7. Ajoutez l'astyle en utilisant le style allman . Restyle la bibliothèque
  8. Afficher la compilation d'avertissement uniquement lorsque _FS_LOGLEVEL_ > 3

Contributions et merci

Merci beaucoup pour tous les rapports de bogues, une nouvelle fonctionnalité suggérant, testé et contribuant au développement de cette bibliothèque.

  1. Merci à Rob Probin pour signaler la moitié du problème de la taille du flash # 2 menant à la V1.2.0
robzé
Rob Probin

Contributif

Si vous souhaitez contribuer à ce projet:

  • Signaler des bogues et des erreurs
  • Demandez des améliorations
  • Créer des problèmes et extraire les demandes
  • Parlez à d'autres personnes de cette bibliothèque

Licence

  • La bibliothèque est autorisée sous GPLV3

Droit d'auteur

Copyright (C) 2021- Khoi Hoang

Développer
Informations supplémentaires
Applications connexes
Recommandé pour vous
Actualités connexes Tout