الصفحة الرئيسية>موارد بناء الموقع>فلاش كود المصدر
تنزيل

مكتبة FS_NANO33BLE

جدول المحتويات

  • لماذا نحتاج إلى مكتبة FS_NANO33BLE
    • ملاحظات مهمة
    • سمات
    • المجالس المدعومة حاليا
  • Changelog
  • المتطلبات الأساسية
  • تثبيت
    • استخدم مدير مكتبة Arduino
    • تثبيت يدوي
    • مقابل الكود والمنصة
  • أمثلة
    • 1. fs_counting
    • 2. fs_test
  • مثال fs_test
  • عينات الإخراج المحطة التصحيح
    • 1. FS_COUNTIN
    • 2.
    • 3.
  • تصحيح
  • استكشاف الأخطاء وإصلاحها
  • مشاكل
  • للقيام
  • منتهي
  • مساهمات وشكر
  • المساهمة
  • رخصة
  • حقوق الطبع والنشر

لماذا نحتاج إلى مكتبة FS_NANO33BLE

ملاحظات مهمة

تجنب استخدام FATFS لأن القضية مع Core ؟؟؟) لا بأس في استخدامها مع 512KB فقط. يرجى استخدام LittleFS الأفضل ، حيث يمكنك تحديد الحجم في أي مكان من 64 كيلو بايت إلى 512 كيلو بايت.

سمات

هذه المكتبة هي مجرد غلاف LittleFS بسيط لتسهيل استخدامك لـ LittleFS للميسور على الألواح المستندة إلى NRF52840 مثل Nano_33_ble ، nano_33_ble_sense ، باستخدام Arduino-Mbed Mbed_nano Core

يستخدم الوصول إلى نظام الملفات واجهات برمجة تطبيقات POSIX العادية أو واجهات برمجة تطبيقات نظام الملفات

المجالس المدعومة حاليا

  1. الألواح المستندة إلى Mbed NRF52840 مثل nano_33_ble ، nano_33_ble_sense ، إلخ.
  2. لوحات قائمة mbed SeeDuino NRF52840 مثل SEEed_xiao_nrf52840 و SEEED_XIAO_NRF52840_SENSE ، إلخ.

المتطلبات الأساسية

  1. Arduino IDE 1.8.19+ لأردوينو.
  2. Arduino mbed_nano core 3.4.1+ لـ Arduino (استخدم Arduino Board Manager) Mbed NRF52840 مثل nano_33_ble ، nano_33_ble_sense .
  3. Seeeduino mbed core 2.7.2+ للوحات المستندة إلى SeeDuino NRF52840 مثل SEEED_XIAO_NRF52840 و SEEED_XIAO_NRF52840_SENSE

تثبيت

استخدم مدير مكتبة Arduino

أفضل وأسهل طريقة هي استخدام Arduino Library Manager . ابحث عن FS_NANO33BLE ، ثم حدد / تثبيت أحدث إصدار. يمكنك أيضًا استخدام هذا الرابط لمزيد من التعليمات التفصيلية.

تثبيت يدوي

طريقة أخرى للتثبيت هي:

  1. انتقل إلى صفحة FS_NANO33BLE .
  2. قم بتنزيل أحدث إصدار FS_Nano33BLE-main.zip .
  3. استخراج ملف الرمز البريدي إلى دليل FS_Nano33BLE-main
  4. نسخ مجلد FS_Nano33BLE-main إلى دليل مكتبات Arduino مثل ~/Arduino/libraries/ .

مقابل الكود والمنصة

  1. تثبيت VS الكود
  2. تثبيت منصة
  3. قم بتثبيت مكتبة FS_NANO33BLE باستخدام MANAGER Library. ابحث عن FS_NANO33BLE في مكتبات المؤلف.
  4. استخدم ملف platformio.ini من أمثلة لضمان تثبيت جميع المكتبات التابعة تلقائيًا. يرجى زيارة الوثائق للخيارات الأخرى والأمثلة في ملف تكوين المشروع

أمثلة

  1. fs_counting
  2. fs_test

مثال fs_test

fs_nano33ble/أمثلة/fs_test/fs_test.ino

الخطوط 11 إلى 371 في AC168D3

# define fs_nano33ble_version_min_target " fs_nano33ble v1.2.1 "
# define fs_nano33ble_version_min 1002001
# define _fs_loglevel_ 1
// min nano33ble_fs_size_kb يجب أن يكون 64 كيلو بايت. إذا تم تعريف smalller => ضبط تلقائي إلى 64 كيلو بايت
// max nano33ble_fs_size_kb يجب أن يكون 512 كيلو بايت. إذا تم تعريف أكبر => ضبط تلقائي إلى 512 كيلو بايت
# تحديد nano33ble_fs_size_kb 256
# تحديد force_reformat false
// الافتراضي باستخدام_littlefs. عدم استخدام use_littlefs => use_fatfs.
// من المستحسن عدم استخدام FATFs ، حيث يجب ضبط Nano33ble_fs_size_kb تلقائيًا إلى 512 كيلو بايت
// #define use_littlefs false
# تضمين < fs_nano33ble.h >
fileystem_mbed *myfs ؛
void readcharsfromfile ( const char * path)
{
مسلسل. print ( " readcharsfromfile: " ) ؛
مسلسل. طباعة (مسار) ؛
file *file = fopen (path ، " r " ) ؛
إذا (ملف)
{
مسلسل. println ( " => فتح موافق " ) ؛
}
آخر
{
مسلسل. println ( " => فتح الفشل " ) ؛
يعود ؛
}
شار ج.
بينما ( صحيح )
{
C = FGETC (ملف) ؛
إذا ( feof (ملف))
{
استراحة ؛
}
آخر
مسلسل. طباعة (ج) ؛
}
fclose (ملف) ؛
}
باطل القراءة ( const char * path)
{
مسلسل. طباعة ( " ملف القراءة: " ) ؛
مسلسل. طباعة (مسار) ؛
file *file = fopen (path ، " r " ) ؛
إذا (ملف)
{
مسلسل. println ( " => فتح موافق " ) ؛
}
آخر
{
مسلسل. println ( " => فتح الفشل " ) ؛
يعود ؛
}
شار ج.
uint32_t numRead = 1 ؛
بينما (numRead)
{
numRead = fread (( uint8_t *) & c ، sizeof (c) ، 1 ، file) ؛
إذا (numRead)
مسلسل. طباعة (ج) ؛
}
fclose (ملف) ؛
}
void writefile ( const char * path ، const char * message ، size_t messagesize)
{
مسلسل. طباعة ( " ملف الكتابة: " ) ؛
مسلسل. طباعة (مسار) ؛
file *file = fopen (path ، " w " ) ؛
إذا (ملف)
{
مسلسل. println ( " => فتح موافق " ) ؛
}
آخر
{
مسلسل. println ( " => فتح الفشل " ) ؛
يعود ؛
}
if ( fwrite (( uint8_t *) رسالة ، 1 ، رسائل ، ملف)))
{
مسلسل. println ( " * الكتابة موافق " ) ؛
}
آخر
{
مسلسل. println ( " * فشل الكتابة " ) ؛
}
fclose (ملف) ؛
}
appendfile void ( Const char * path ، const char * message ، size_t messagesize)
{
مسلسل. طباعة ( " ملف الإلحاق: " ) ؛
مسلسل. طباعة (مسار) ؛
file *file = fopen (path ، " a " ) ؛
إذا (ملف)
{
مسلسل. println ( " => فتح موافق " ) ؛
}
آخر
{
مسلسل. println ( " => فتح الفشل " ) ؛
يعود ؛
}
if ( fwrite (( uint8_t *) رسالة ، 1 ، رسائل ، ملف)))
{
مسلسل. println ( " * applending ok " ) ؛
}
آخر
{
مسلسل. println ( " * applending فشل " ) ؛
}
fclose (ملف) ؛
}
void deletefile ( const char * path)
{
مسلسل. طباعة ( " حذف ملف: " ) ؛
مسلسل. طباعة (مسار) ؛
إذا ( إزالة (المسار) == 0 )
{
مسلسل. println ( " => ok " ) ؛
}
آخر
{
مسلسل. println ( " => فشل " ) ؛
يعود ؛
}
}
void reamfile ( const char * path1 ، const char * path2)
{
مسلسل. طباعة ( " ملف إعادة تسمية: " ) ؛
مسلسل. طباعة (path1) ؛
مسلسل. طباعة ( " إلى: " ) ؛
مسلسل. طباعة (path2) ؛
if ( إعادة تسمية (path1 ، path2) == 0 )
{
مسلسل. println ( " => ok " ) ؛
}
آخر
{
مسلسل. println ( " => فشل " ) ؛
يعود ؛
}
}
void testfileio ( const char * path)
{
مسلسل. طباعة ( " ملف اختبار I/O مع: " ) ؛
مسلسل. طباعة (مسار) ؛
# تحديد Buff_size 512
static uint8_t buf [buff_size] ؛
file *file = fopen (path ، " w " ) ؛
إذا (ملف)
{
مسلسل. println ( " => فتح موافق " ) ؛
}
آخر
{
مسلسل. println ( " => فتح الفشل " ) ؛
يعود ؛
}
size_t i ؛
مسلسل. println ( " - الكتابة " ) ؛
uint32_t start = millis () ؛
size_t النتيجة = 0 ؛
// اكتب ملفًا فقط 1/4 من nano33ble_fs_size_kb
لـ (i = 0 ؛ i <nano33ble_fs_size_kb / 2 ؛ i ++)
{
النتيجة = fwrite (buf ، buff_size ، 1 ، ملف) ؛
إذا (النتيجة! = 1 )
{
مسلسل. طباعة ( " كتابة نتيجة = " ) ؛
مسلسل. println (نتيجة) ؛
مسلسل. print ( " كتابة خطأ ، i = " ) ؛
مسلسل. println (i) ؛
استراحة ؛
}
}
مسلسل. println ( " " ) ؛
uint32_t end = millis () - start ؛
مسلسل. طباعة (i / 2 ) ؛
مسلسل. طباعة ( " kbytes مكتوب في (MS) " ) ؛
مسلسل. println (نهاية) ؛
fclose (ملف) ؛
printline () ؛
// /////////////////////////////////////
ملف = fopen (المسار ، " r " ) ؛
ابدأ = millis () ؛
نهاية = ابدأ ؛
أنا = 0 ؛
إذا (ملف)
{
ابدأ = millis () ؛
مسلسل. println ( " - القراءة " ) ؛
النتيجة = 0 ؛
fseek (ملف ، 0 ، seek_set) ؛
// قراءة الملف فقط 1/4 من nano33ble_fs_size_kb
لـ (i = 0 ؛ i <nano33ble_fs_size_kb / 2 ؛ i ++)
{
النتيجة = fread (buf ، buff_size ، 1 ، ملف) ؛
إذا (النتيجة! = 1 )
{
مسلسل. طباعة ( " قراءة نتيجة = " ) ؛
مسلسل. println (نتيجة) ؛
مسلسل. print ( " read error ، i = " ) ؛
مسلسل. println (i) ؛
استراحة ؛
}
}
مسلسل. println ( " " ) ؛
نهاية = millis () - ابدأ ؛
مسلسل. طباعة ((i * buff_size) / 1024 ) ؛
مسلسل. print ( " kbytes قراءة في (ms) " ) ؛
مسلسل. println (نهاية) ؛
fclose (ملف) ؛
}
آخر
{
مسلسل. println ( " - فشل في فتح ملف للقراءة " ) ؛
}
}
printline void ()
{
مسلسل. println ( " ****************************************************
}
إعداد باطل ()
{
مسلسل. تبدأ ( 115200 ) ؛
بينما (! Serial && millis () < 5000 ) ؛
التأخير ( 1000 ) ؛
مسلسل. print ( " n ابدأ fs_test on " ) ؛
مسلسل. println (board_name) ؛
مسلسل. println (fs_nano33ble_version) ؛
# إذا تم تعريفه (fs_nano33ble_version_min)
if (fs_nano33ble_version_int <fs_nano33ble_version_min)
{
مسلسل. طباعة ( " تحذير. يجب استخدام هذا المثال على الإصدار متساوٍ أو آجلاً من: " ) ؛
مسلسل. println (fs_nano33ble_version_min_target) ؛
}
# Endif
مسلسل. print ( " fs_size (kb) = " ) ؛
مسلسل. println (nano33ble_fs_size_kb) ؛
مسلسل. print ( " fs_ start address = 0x " ) ؛
مسلسل. println (nano33ble_fs_start ، hex) ؛
myfs = new fileystem_mbed () ؛
if (! myfs-> init ())
{
مسلسل. println ( " FS Mount Failt " ) ؛
يعود ؛
}
char filename1 [] = mbed_fs_file_prefix " /hello1.txt " ؛
char filename2 [] = mbed_fs_file_prefix " /hello2.txt " ؛
رسالة char [] = " Hello from 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 () ؛
مسلسل. println ( " n اختبار كامل " ) ؛
}
حلقة باطلة ()
{
}

عينات الإخراج المحطة التصحيح

1. FS_COUNTIN

فيما يلي عينة الإخراج الطرفي عند تشغيل مثال fs_counting على mbed nano_33_ble باستخدام 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 على mbed nano_33_ble باستخدام 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 على mbed nano_33_ble باستخدام 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

تصحيح

تم تمكين التصحيح افتراضيًا على المسلسل.

يمكنك أيضًا تغيير مستوى تصحيح الأخطاء ( FS_Loglevel ) من 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

استكشاف الأخطاء وإصلاحها

إذا حصلت على أخطاء في التجميع ، في أكثر الأحيان ، قد تحتاج إلى تثبيت إصدار أحدث من جوهر لوحات Arduino.

في بعض الأحيان ، ستعمل المكتبة فقط إذا قمت بتحديث Core Board إلى أحدث إصدار لأنني أستخدم الوظائف المضافة حديثًا.

مشاكل

إرسال المشكلات إلى: FS_NANO33BLE قضايا

للقيام

  1. ابحث عن الخلل والتحسين.

منتهي

  1. غلاف Littlefs الأساسي للوحات المستندة إلى NRF52840 مثل nano_33_ble ، nano_33_ble_sense ، باستخدام Arduino-Mbed Mbed_nano Core
  2. أضف سلسلة الإصدار
  3. أضف جدول المحتويات
  4. إصلاح خطأ ارتباط multiple-definitions
  5. استخدم عنوان NANO33BLE_FS_START الصحيح لـ LittleFS دون إهدار مساحة الفلاش. تحقق من نصف حجم الفلاش #2
  6. أضف دعمًا إلى لوحات SeeDuino NRF52840 مثل SEEED_XIAO_NRF52840 و SEEED_XIAO_NRF52840_SENSE mbed إلخ.
  7. إضافة Astyle باستخدام نمط allman . أعد تصريح المكتبة
  8. عرض تحذير ترجمة فقط عندما _FS_LOGLEVEL_ > 3

مساهمات وشكر

شكراً جزيلاً للجميع على الإبلاغ عن الأخطاء ، ميزة جديدة تقترح واختبار ومساهمة في تطوير هذه المكتبة.

  1. بفضل Rob Probin للإبلاغ عن إصدار نصف حجم الفلاش رقم 2 يؤدي إلى V1.2.0
روبت
روب probin

المساهمة

إذا كنت تريد المساهمة في هذا المشروع:

  • الإبلاغ عن الأخطاء والأخطاء
  • اطلب تحسينات
  • إنشاء مشكلات وسحب الطلبات
  • أخبر الآخرين عن هذه المكتبة

رخصة

  • المكتبة مرخصة بموجب GPLV3

حقوق الطبع والنشر

حقوق الطبع والنشر (ج) 2021- خوي هوانغ

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل