Página Inicial>Recursos de construção de sites>Código fonte FLASH
Baixar

Biblioteca fs_nano33ble

Índice

  • Por que precisamos desta biblioteca fs_nano33ble
    • Notas importantes
    • Características
    • Placas atualmente suportadas
  • Changelog
  • Pré -requisitos
  • Instalação
    • Use o gerente da biblioteca Arduino
    • Instalação manual
    • Vs código e plataforma
  • Exemplos
    • 1. FS_COUNT
    • 2. Fs_test
  • Exemplo fs_test
  • Amostras de saída do terminal de depuração
    • 1. FS_CONTRO NANO 33 BLE com Littlefs Tamanho 256kb
    • 2.
    • 3.
  • Depurar
  • Solução de problemas
  • Problemas
  • PENDÊNCIA
  • FEITO
  • Contribuições e obrigado
  • Contribuindo
  • Licença
  • Direitos autorais

Por que precisamos desta biblioteca fs_nano33ble

Notas importantes

Evite usar FATFS porque de alguma forma (problema com o núcleo ???) Não há problema em usar apenas com 512KB . Use os melhores LittleFS , onde você pode selecionar o tamanho de 64kb a 512kb.

Características

Esta biblioteca é apenas um LittleFS simples para facilitar o uso de LittleFS a bordo do flash nas placas baseadas em nrf52840, como nano_33_ble, nano_33_ble_sense , usando arduino-mbed_nano core

O acesso ao sistema de arquivos usa APIs normais de POSIX ou MBED FileSystem APIs

Placas atualmente suportadas

  1. Placas baseadas em NRF52840 mbed como nano_33_ble, nano_33_ble_sense , etc. usando arduino-mbed mbed_nano Core
  2. Placas baseadas em mbed NRF52840, como Seeed_Xiao_NRF52840 e Seeed_Xiao_NRF52840_Sense , etc.

Pré -requisitos

  1. Arduino IDE 1.8.19+ para Arduino.
  2. Arduino mbed_nano core 3.4.1+ para Arduino (Use Arduino Board Manager) MBED NRF52840 Placas como Nano_33_ble, Nano_33_ble_sense .
  3. Seeeduino mbed core 2.7.2+ para placas baseadas em SeeDuino NRF52840, como Seeed_Xiao_NRF52840 e Seeed_Xiao_NRF52840_Sense

Instalação

Use o gerente da biblioteca Arduino

A melhor e mais fácil maneira é usar Arduino Library Manager . Pesquise fs_nano33ble e selecione / instale a versão mais recente. Você também pode usar este link para obter instruções mais detalhadas.

Instalação manual

Outra maneira de instalar é:

  1. Navegue para FS_NANO33BLE .
  2. Faça o download do lançamento mais recente FS_Nano33BLE-main.zip .
  3. Extrair o arquivo zip para FS_Nano33BLE-main Directory
  4. Copie a pasta Whole FS_Nano33BLE-main para o diretório das bibliotecas Arduino, como ~/Arduino/libraries/ .

Vs código e plataforma

  1. Instale o código vs.
  2. Instale a plataforma
  3. Instale a biblioteca fs_nano33ble usando o gerenciador de bibliotecas. Procure fs_nano33ble em plataforma.io bibliotecas do autor
  4. Use o arquivo Platformio.ini incluído dos exemplos para garantir que todas as bibliotecas dependentes sejam instaladas automaticamente. Visite a documentação para as outras opções e exemplos no arquivo de configuração do projeto

Exemplos

  1. Fs_counting
  2. Fs_test

Exemplo fs_test

Fs_nano33ble/exemplos/fs_test/fs_test.ino

Linhas 11 a 371 no AC168D3

# Definir fs_nano33ble_version_min_target " fs_nano33ble v1.2.1 "
# Definir fs_nano33ble_version_min 1002001
# defina _fs_loglevel_ 1
// min nano33ble_fs_size_kb deve ser 64kb. Se definido Smalller => Ajuste automático para 64kb
// max nano33ble_fs_size_kb deve ser 512kb. Se definido maior => ajuste automático para 512kb
# Definir nano33ble_fs_size_kb 256
# define force_reformat false
// padrão usando_littlefs. Uncommentamento em não usar_littlefs => usando_fatfs.
// é aconselhável não usar os GAFs, pois o Nano33ble_fs_size_kb deve ser ajustado automaticamente para 512kb
// #define usando_littlefs false
# inclua < fs_nano33ble.h >
Filesystem_mbed *myfs;
void readcharsfromfile ( const char * caminho)
{
Serial. print ( " readcharsFromFile: " );
Serial. impressão (caminho);
Arquivo *arquivo = fopen (caminho, " r " );
if (arquivo)
{
Serial. println ( " => aberto ok " );
}
outro
{
Serial. println ( " => aberto falhou " );
retornar ;
}
char c;
enquanto ( verdadeiro )
{
c = fgetc (arquivo);
if ( feof (arquivo))
{
quebrar ;
}
outro
Serial. impressão (c);
}
fclose (arquivo);
}
Void ReadFile ( Const Char * Path)
{
Serial. print ( " Arquivo de leitura: " );
Serial. impressão (caminho);
Arquivo *arquivo = fopen (caminho, " r " );
if (arquivo)
{
Serial. println ( " => aberto ok " );
}
outro
{
Serial. println ( " => aberto falhou " );
retornar ;
}
char c;
uint32_t numread = 1 ;
while (numread)
{
numread = fret (( uint8_t *) & c, sizeof (c), 1 , arquivo);
if (numread)
Serial. impressão (c);
}
fclose (arquivo);
}
void writefile ( const char * caminho, const char * mensagem, size_t mensagense)
{
Serial. print ( " Escrevendo o arquivo: " );
Serial. impressão (caminho);
Arquivo *arquivo = fopen (caminho, " w " );
if (arquivo)
{
Serial. println ( " => aberto ok " );
}
outro
{
Serial. println ( " => aberto falhou " );
retornar ;
}
if ( fwrite (( uint8_t *) mensagem, 1 , mensagens, arquivo))
{
Serial. println ( " * escrevendo ok " );
}
outro
{
Serial. println ( " * escrita falhou " );
}
fclose (arquivo);
}
Void AppendFile ( const char * caminho, const char * mensagem, size_t mensagense)
{
Serial. print ( " arquivo de anexos: " );
Serial. impressão (caminho);
Arquivo *arquivo = fopen (caminho, " a " );
if (arquivo)
{
Serial. println ( " => aberto ok " );
}
outro
{
Serial. println ( " => aberto falhou " );
retornar ;
}
if ( fwrite (( uint8_t *) mensagem, 1 , mensagens, arquivo))
{
Serial. println ( " * Anexando OK " );
}
outro
{
Serial. println ( " * Appender falhou " );
}
fclose (arquivo);
}
Void DeleteFile ( Const Char * Path)
{
Serial. print ( " Excluindo arquivo: " );
Serial. impressão (caminho);
if ( remove (caminho) == 0 )
{
Serial. println ( " => ok " );
}
outro
{
Serial. println ( " => falhou " );
retornar ;
}
}
Void RenameFile ( const char * path1, const char * path2)
{
Serial. print ( " Renomear arquivo: " );
Serial. impressão (path1);
Serial. print ( " para: " );
Serial. impressão (path2);
if ( renomear (path1, path2) == 0 )
{
Serial. println ( " => ok " );
}
outro
{
Serial. println ( " => falhou " );
retornar ;
}
}
Void testfileio ( const char * caminho)
{
Serial. print ( " Testando o arquivo de E/S com: " );
Serial. impressão (caminho);
# Definir buff_size 512
estático uint8_t buf [buff_size];
Arquivo *arquivo = fopen (caminho, " w " );
if (arquivo)
{
Serial. println ( " => aberto ok " );
}
outro
{
Serial. println ( " => aberto falhou " );
retornar ;
}
size_t i;
Serial. println ( " - escrita " );
uint32_t start = millis ();
size_t resultado = 0 ;
// Escreva um arquivo apenas 1/4 de nano33ble_fs_size_kb
for (i = 0 ; i <nano33ble_fs_size_kb / 2 ; i ++)
{
resultado = fwrite (buf, buff_size, 1 , arquivo);
if (resultado! = 1 )
{
Serial. print ( " escreva resultado = " );
Serial. println (resultado);
Serial. print ( " Erro de gravação, i = " );
Serial. println (i);
quebrar ;
}
}
Serial. println ( " " );
uint32_t end = millis () - start;
Serial. impressão (i / 2 );
Serial. print ( " kbytes escritos em (ms) " );
Serial. println (final);
fclose (arquivo);
printline ();
// ///////////////////////////////////////////////////////////////
arquivo = fopen (caminho, " r " );
start = millis ();
end = start;
i = 0 ;
if (arquivo)
{
start = millis ();
Serial. println ( " - leitura " );
resultado = 0 ;
fseek (arquivo, 0 , Seek_set);
// Leia apenas o arquivo 1/4 de nano33ble_fs_size_kb
for (i = 0 ; i <nano33ble_fs_size_kb / 2 ; i ++)
{
resultado = fret (buf, buff_size, 1 , arquivo);
if (resultado! = 1 )
{
Serial. print ( " Leia resultado = " );
Serial. println (resultado);
Serial. print ( " Leia o erro, i = " );
Serial. println (i);
quebrar ;
}
}
Serial. println ( " " );
end = millis () - start;
Serial. imprimir ((i * buff_size) / 1024 );
Serial. print ( " Kbytes leia em (ms) " );
Serial. println (final);
fclose (arquivo);
}
outro
{
Serial. println ( " - falhou ao abrir o arquivo para leitura " );
}
}
Void PrintLine ()
{
Serial. println ( " **************************************************** " );
}
configuração void ()
{
Serial. começar ( 115200 );
while (! Serial && Millis () < 5000 );
atraso ( 1000 );
Serial. print ( " n Iniciar fs_test on " );
Serial. println (board_name);
Serial. println (fs_nano33ble_version);
# se definido (fs_nano33ble_version_min)
if (fs_nano33ble_version_int <fs_nano33ble_version_min)
{
Serial. print ( " Aviso. Deve usar este exemplo na versão igual ou posterior a: " );
Serial. println (fs_nano33ble_version_min_target);
}
# endif
Serial. print ( " fs_size (kb) = " );
Serial. println (nano33ble_fs_size_kb);
Serial. print ( " fs_ start endereço = 0x " );
Serial. println (nano33ble_fs_start, hex);
myfs = new FileSystem_Mbed ();
if (! myfs-> init ())
{
Serial. println ( " fs de montagem fs falhou " );
retornar ;
}
char filename1 [] = mbed_fs_file_prefix " /hello1.txt " ;
char filename2 [] = mbed_fs_file_prefix " /hello2.txt " ;
Char message [] = " Olá de nano_33_ble n " ;
printline ();
writefile (filename1, mensagem, sizeof (mensagem));
printline ();
readfile (nome do arquivo1);
printline ();
ApndendFile (FileName1, Mensagem, Sizeof (Mensagem));
printline ();
readfile (nome do arquivo1);
printline ();
renamefile (FILENAME1, FILENAME2);
printline ();
readcharsFromFile (FileName2);
printline ();
DeleteFile (FileName2);
printline ();
ReadFile (FileName2);
printline ();
testfileio (nome do arquivo1);
printline ();
testfileio (nome do arquivo2);
printline ();
deletefile (nome do arquivo1);
printline ();
DeleteFile (FileName2);
printline ();
Serial. println ( " n teste completo " );
}
Void Loop ()
{
}

Amostras de saída do terminal de depuração

1. FS_CONTRO NANO 33 BLE com Littlefs Tamanho 256kb

A seguir, é apresentado a saída do terminal de amostra ao executar o exemplo fs_counting em 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.

A seguir, é apresentado a saída do terminal de amostra ao executar o exemplo fs_test no 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.

A seguir, é apresentado a saída do terminal de amostra ao executar o exemplo fs_test no mbed nano_33_ble usando os gordos 

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

A depuração é ativada por padrão no Serial.

Você também pode alterar o nível de depuração ( fs_loglevel ) de 0 para 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

Solução de problemas

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.

Problemas

Envie questões para: FS_NANO33BLE Issues

PENDÊNCIA

  1. Procure por bug e melhoria.

FEITO

  1. Wrapper Basic Littlefs para placas baseadas em mbed nrf52840, como nano_33_ble, nano_33_ble_sense , usando arduino-mbed_nano core
  2. Adicione a string de versão
  3. Adicione o índice
  4. Corrija o erro do vinculador multiple-definitions
  5. Use o endereço correto NANO33BLE_FS_START para LittleFS sem desperdiçar espaço flash. Verifique a metade do tamanho do flash #2
  6. Adicione suporte às placas baseadas em SeeDuino NRF52840, como Seeed_Xiao_NRF52840 e Seeed_Xiao_NRF52840_Sense , etc. Usando o SeeDuino mbed Core
  7. Adicione astyle usando o estilo allman . Restyle a biblioteca
  8. Exiba o aviso de compilação apenas quando _FS_LOGLEVEL_ > 3

Contribuições e obrigado

Muito obrigado a todos pela reportagem de bugs, novos recursos sugerindo, testando e contribuindo para o desenvolvimento desta biblioteca.

  1. Agradecemos a Rob Probin para relatar a edição de meio tamanho do Flash #2, levando à v1.2.0
Robzed
Rob Probin

Contribuindo

Se você deseja contribuir com este projeto:

  • Relatar bugs e erros
  • Peça aprimoramentos
  • Crie problemas e puxe solicitações
  • Conte a outras pessoas sobre esta biblioteca

Licença

  • A biblioteca está licenciada sob GPLV3

Direitos autorais

Copyright (C) 2021- Khoi Hoang

Expandir
Informações adicionais
Aplicativos Relacionados
Recomendado para você
Informações Relacionadas Todos