Inicio>Recursos para la creación de sitios web>código fuente FLASH
Descargar

Biblioteca fs_nano33ble

Tabla de contenido

  • ¿Por qué necesitamos esta biblioteca fs_nano33ble?
    • Notas importantes
    • Características
    • Tableros de apoyo actualmente
  • Colegio de cambios
  • Requisitos previos
  • Instalación
    • Use el gerente de la biblioteca de Arduino
    • Instalación manual
    • VS Code & Platformio
  • Ejemplos
    • 1. FS_COUNTING
    • 2. FS_TEST
  • Ejemplo FS_TEST
  • Muestras de salida de terminal de depuración
    • 1. FS_Counting en nano 33 ble con littlefs tamaño de 256 kb
    • 2. Fs_test en nano 33 ble con littlefs tamaño 256kb
    • 3. FS_TEST en Nano 33 BLE con FATFS Tamaño 512kb
  • Depurar
  • Solución de problemas
  • Asuntos
  • HACER
  • HECHO
  • Contribuciones y gracias
  • Que contribuye
  • Licencia
  • Derechos de autor

¿Por qué necesitamos esta biblioteca fs_nano33ble?

Notas importantes

Evite usar FATFS porque de alguna manera (¿problemas con el núcleo?) Está bien usar solo con 512KB . Utilice el mejor LittleFS , donde puede seleccionar el tamaño de 64 kb a 512kb.

Características

Esta biblioteca es solo un simple envoltorio LittleFS para facilitar su uso de LittleFS para el flash a bordo en las tablas basadas en MBed NRF52840 como Nano_33_BLE, Nano_33_BLE_Sense , usando Arduino-Mbed MBed_nano Core

El acceso del sistema de archivos utiliza API POSIX normales o API del sistema de archivos MBed

Tableros de apoyo actualmente

  1. Tableros basados ​​en NRF52840 como nano_33_ble, nano_33_ble_sense , etc. Usando arduino-mbed mbed_nano core
  2. Boards basados ​​en Seeeduino NRF52840 como Seeed_Xiao_Nrf52840 y Seeed_Xiao_Nrf52840_Sense , etc. Usando el núcleo mbed Seeeduino

Requisitos previos

  1. Arduino IDE 1.8.19+ para Arduino.
  2. Arduino mbed_nano core 3.4.1+ para Arduino (use el Administrador de tableros de Arduino) MBed Boards basados ​​en NRF52840 como Nano_33_BLE, Nano_33_BLE_Sense .
  3. Seeeduino mbed core 2.7.2+ para los tableros basados ​​en Seeeduino NRF52840 como Seeed_Xiao_Nrf52840 y Seeed_Xiao_Nrf52840_Sense

Instalación

Use el gerente de la biblioteca de Arduino

La mejor y más fácil forma es usar Arduino Library Manager . Busque fs_nano33ble , luego seleccione / instale la última versión. También puede usar este enlace para instrucciones más detalladas.

Instalación manual

Otra forma de instalar es:

  1. Navegue a la página FS_NANO33BLE .
  2. Descargue el último lanzamiento FS_Nano33BLE-main.zip .
  3. Extraiga el archivo ZIP al directorio FS_Nano33BLE-main
  4. Copie la carpeta completa FS_Nano33BLE-main al directorio de las bibliotecas de Arduino, como ~/Arduino/libraries/ .

VS Code & Platformio

  1. Instalar VS Código
  2. Instalar plataforma
  3. Instale la biblioteca FS_NANO33BLE usando Biblioteca Manager. Busque fs_nano33ble en las bibliotecas del autor de la plataforma.
  4. Use el archivo de Platformio.ini incluido de los ejemplos para garantizar que todas las bibliotecas dependientes se instalen automáticamente. Visite la documentación para ver las otras opciones y ejemplos en el archivo de configuración del proyecto

Ejemplos

  1. FS_COUNTING
  2. FS_TEST

Ejemplo FS_TEST

Fs_nano33ble/ejemplos/fs_test/fs_test.ino

Líneas 11 a 371 en AC168D3

# Define fs_nano33ble_version_min_target " fs_nano33ble v1.2.1 "
# Define fs_nano33ble_version_min 1002001
# Defina _fs_loglevel_ 1
// min nano33ble_fs_size_kb debe ser 64kb. Si se define smalller => ajuste automático a 64 kb
// max nano33ble_fs_size_kb debe ser 512kb. Si se define más grande => Auto ajuste a 512kb
# Define nano33ble_fs_size_kb 256
# Define Force_Reformat False
// predeterminado usando_littlefs. Descomnación a no usar_littlefs => usando_fatfs.
// es aconsejable no usar FATFS, ya que el nano33ble_fs_size_kb debe ajustarse automáticamente a 512kb
// #define usando_littlefs falso
# incluir < fs_nano33ble.h >
Filesystem_mbed *myfs;
Void ReadCharsFromFile ( ruta const char *)
{
De serie. imprimir ( " ReadcharsFromFile: " );
De serie. imprimir (ruta);
Archivo *file = fopen (ruta, " r " );
if (archivo)
{
De serie. println ( " => abrir OK " );
}
demás
{
De serie. println ( " => abrir fallido " );
devolver ;
}
char c;
mientras ( verdadero )
{
c = fgetc (archivo);
if ( FEOF (archivo))
{
romper ;
}
demás
De serie. imprimir (c);
}
fclose (archivo);
}
Void Readfile ( const char * ruta)
{
De serie. imprimir ( " Archivo de lectura: " );
De serie. imprimir (ruta);
Archivo *file = fopen (ruta, " r " );
if (archivo)
{
De serie. println ( " => abrir OK " );
}
demás
{
De serie. println ( " => abrir fallido " );
devolver ;
}
char c;
uint32_t numread = 1 ;
while (numread)
{
numread = fread (( uint8_t *) & c, sizeof (c), 1 , archivo);
if (numread)
De serie. imprimir (c);
}
fclose (archivo);
}
void writeFile ( const char * ruta, const char * Mensaje, size_t Messagesize)
{
De serie. imprimir ( " Escribir archivo: " );
De serie. imprimir (ruta);
Archivo *file = fopen (ruta, " w " );
if (archivo)
{
De serie. println ( " => abrir OK " );
}
demás
{
De serie. println ( " => abrir fallido " );
devolver ;
}
if ( fwrite (( uint8_t *) mensaje, 1 , mensajes, archivo))
{
De serie. println ( " * escribiendo bien " );
}
demás
{
De serie. println ( " * escritura fallida " );
}
fclose (archivo);
}
Void appendFile ( const char * ruta, const char * mensaje, size_t Messagesize)
{
De serie. imprimir ( " archivo de agregado: " );
De serie. imprimir (ruta);
Archivo *file = fopen (ruta, " A " );
if (archivo)
{
De serie. println ( " => abrir OK " );
}
demás
{
De serie. println ( " => abrir fallido " );
devolver ;
}
if ( fwrite (( uint8_t *) mensaje, 1 , mensajes, archivo))
{
De serie. println ( " * Añadir OK " );
}
demás
{
De serie. println ( " * apagar fallido " );
}
fclose (archivo);
}
Void DeleteFile ( ruta const char *)
{
De serie. imprimir ( " Eliminar archivo: " );
De serie. imprimir (ruta);
if ( eliminar (ruta) == 0 )
{
De serie. println ( " => ok " );
}
demás
{
De serie. println ( " => fallido " );
devolver ;
}
}
void renameFile ( const char * path1, const char * path2)
{
De serie. imprimir ( " Archivo de cambio de nombre: " );
De serie. imprimir (ruta1);
De serie. imprimir ( " a: " );
De serie. imprimir (Path2);
if ( rename (Path1, Path2) == 0 )
{
De serie. println ( " => ok " );
}
demás
{
De serie. println ( " => fallido " );
devolver ;
}
}
nulo testFileio ( ruta const char *)
{
De serie. imprimir ( " Probar el archivo de E/S con: " );
De serie. imprimir (ruta);
# Define buff_size 512
static uint8_t buf [buff_size];
Archivo *file = fopen (ruta, " w " );
if (archivo)
{
De serie. println ( " => abrir OK " );
}
demás
{
De serie. println ( " => abrir fallido " );
devolver ;
}
size_t i;
De serie. println ( " - Writing " );
uint32_t start = millis ();
size_t result = 0 ;
// Escribir un archivo solo 1/4 de nano33ble_fs_size_kb
para (i = 0 ; i <nano33ble_fs_size_kb / 2 ; i ++)
{
resultado = fwrite (buf, buff_size, 1 , archivo);
if (resultado! = 1 )
{
De serie. imprimir ( " escribir resultado = " );
De serie. println (resultado);
De serie. imprimir ( " Error de escritura, i = " );
De serie. println (i);
romper ;
}
}
De serie. println ( " " );
uint32_t end = Millis () - inicio;
De serie. imprimir (i / 2 );
De serie. imprimir ( " kbytes escritos en (ms) " );
De serie. println (final);
fclose (archivo);
printline ();
// ///////////////////////////
file = fopen (ruta, " r " );
inicio = Millis ();
final = inicio;
i = 0 ;
if (archivo)
{
inicio = Millis ();
De serie. println ( " - lectura " );
resultado = 0 ;
fseek (archivo, 0 , Seek_set);
// Leer el archivo solo 1/4 de nano33ble_fs_size_kb
para (i = 0 ; i <nano33ble_fs_size_kb / 2 ; i ++)
{
resultado = fread (buf, buff_size, 1 , archivo);
if (resultado! = 1 )
{
De serie. imprimir ( " Leer resultado = " );
De serie. println (resultado);
De serie. imprimir ( " Leer error, i = " );
De serie. println (i);
romper ;
}
}
De serie. println ( " " );
end = Millis () - Inicio;
De serie. print ((i * buff_size) / 1024 );
De serie. imprimir ( " kbytes leídos en (ms) " );
De serie. println (final);
fclose (archivo);
}
demás
{
De serie. println ( " - no se pudo abrir el archivo para la lectura " );
}
}
Void Printline ()
{
De serie. println ( " ************************************************ " );
}
Configuración vacía ()
{
De serie. comenzar ( 115200 );
while (! Serial && millis () < 5000 );
retraso ( 1000 );
De serie. imprimir ( " n inicio fs_test en " );
De serie. println (board_name);
De serie. println (fs_nano33ble_version);
# si se define (fs_nano33ble_version_min)
if (fs_nano33ble_version_int <fs_nano33ble_version_min)
{
De serie. imprimir ( " advertencia. Debe usar este ejemplo en la versión igual o posterior a: " );
De serie. println (fs_nano33ble_version_min_target);
}
# endif
De serie. print ( " fs_size (kb) = " );
De serie. println (nano33ble_fs_size_kb);
De serie. print ( " FS_ Start Dirección = 0x " );
De serie. println (nano33ble_fs_start, hex);
myfs = new Filesystem_mbed ();
if (! myfs-> init ())
{
De serie. println ( " fallado de montaje FS " );
devolver ;
}
char filename1 [] = mbed_fs_file_prefix " /hello1.txt " ;
char filename2 [] = mbed_fs_file_prefix " /hello2.txt " ;
Mensaje de char [] = " Hello de Nano_33_Ble n " ;
printline ();
WriteFile (FileName1, Mensaje, SizeOf (Mensaje));
printline ();
readfile (nombre de archivo1);
printline ();
appendFile (FileName1, Mensaje, sizeof (mensaje));
printline ();
readfile (nombre de archivo1);
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 ();
De serie. println ( " n prueba completa " );
}
bucle vacío ()
{
}

Muestras de salida de terminal de depuración

1. FS_Counting en nano 33 ble con littlefs tamaño de 256 kb

La siguiente es la salida del terminal de muestra cuando se ejecuta el ejemplo FS_COUNTING en MBED nano_33_ble usando 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 en nano 33 ble con littlefs tamaño 256kb

La siguiente es la salida del terminal de muestra cuando se ejecuta el ejemplo FS_TEST en mBed nano_33_ble usando 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 en Nano 33 BLE con FATFS Tamaño 512kb

La siguiente es la salida del terminal de muestra cuando se ejecuta el ejemplo FS_TEST en mBed nano_33_ble usando 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

Depurar

La depuración está habilitada de forma predeterminada en Serial.

También puede cambiar el nivel de depuración ( FS_Loglevel ) de 0 a 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

Solución de problemas

Si recibe errores de compilación, la mayoría de las veces, es posible que deba instalar una versión más nueva del núcleo para las tablas Arduino.

A veces, la biblioteca solo funcionará si actualiza el núcleo del tablero a la última versión porque estoy usando funciones recientemente agregadas.

Asuntos

Enviar problemas a: fs_nano33ble temas

HACER

  1. Buscar errores y mejoras.

HECHO

  1. Wrapper básico de LittleFS para tableros basados ​​en NRF52840 como nano_33_ble, nano_33_ble_sense , usando arduino-mbed mbed_nano nore
  2. Agregar cadena de versión
  3. Agregar tabla de contenido
  4. Corrige un error de enlazador multiple-definitions
  5. Use la dirección correcta NANO33BLE_FS_START para LittleFS sin desperdiciar espacio flash. Verifique la mitad del tamaño de Flash #2
  6. Agregue soporte a los tableros basados ​​en Seeeduino NRF52840 como Seeed_Xiao_Nrf52840 y Seeed_xiao_Nrf52840_sense , etc. Usando el núcleo mbed de Seeeduino
  7. Agregue Astyle usando allman Style. Restile la biblioteca
  8. Mostrar advertencia de compilación solo cuando _FS_LOGLEVEL_ > 3

Contribuciones y gracias

Muchas gracias por todos por los informes de errores, una nueva función que sugieren, pruebas y contribuyen al desarrollo de esta biblioteca.

  1. Gracias a Rob Probin para informar el tamaño de la mitad de Flash #2 que conduce a V1.2.0
robado
Rob Probin

Que contribuye

Si desea contribuir a este proyecto:

  • Informar errores y errores
  • Solicitar mejoras
  • Crear problemas y extraer solicitudes
  • Cuéntale a otras personas sobre esta biblioteca

Licencia

  • La biblioteca tiene licencia bajo GPLV3

Derechos de autor

Copyright (c) 2021- Khoi Hoang

Expandir
Información adicional
Aplicaciones relacionadas
Recomendado para ti
Información relacionada Todo