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

مكتبة معلمة فلاش المستخدم للتوت PI PICO

ملخص

  • تخزين معلمات المستخدم في الجزء النهائي من ذاكرة الفلاش لـ RP2040
  • السماح للمعلمة أن يكون لها نوع واحد من أنواع بدائية مختلفة
  • ما يصل إلى إجمالي 1024 بايت المتاحة للمعلمات
  • توفير القيمة الافتراضية لإعادة تعيين المصنع
  • توفير حساب تلقائي عنوان فلاش ، وإلا السماح بتعيين عنوان فلاش محكوم
  • خدمة Setter مباشرة و Getter مرتبطة بنوع المعلمة
  • تخدم أيضًا Access Setter و Getter بواسطة ID ، والذي يتطلب تحديد النوع الصحيح

الاستخدام

إعلان فئة معلمة المستخدم

  • قم بإعداد رأس فئة بين الفئة من FlashParamns :: Flashparam كـ Singleton (على سبيل المثال conflipparam.h )
  • تحديد معلمات المستخدم مع قالب مع النوع البدائي
    • الأنواع المدعومة: bool ، uint8_t ، uint16_t ، uint32_t ، uint64_t ، int8_t ، int16_t ، int32_t ، int64_t ، float ، double ، و std :: string 
 #pragma once

#include "FlashParam.h"

struct ConfigParam : FlashParamNs::FlashParam {
    static ConfigParam& instance()  // Singleton
    {
        static ConfigParam instance;
        return instance;
    }
    static constexpr uint32_t ID_BASE = FlashParamNs::CFG_ID_BASE;
    // Parameter<T>                      instance      id            name          default    size
    FlashParamNs::Parameter<std::string> P_CFG_STRING {ID_BASE + 0,  "CFG_STRING", "abcdefg", 16};  // std::string needs size
    FlashParamNs::Parameter<bool>        P_CFG_BOOL   {ID_BASE + 1,  "CFG_BOOL",   false};
    FlashParamNs::Parameter<uint8_t>     P_CFG_UINT8  {ID_BASE + 2,  "CFG_UINT8",  23};
    FlashParamNs::Parameter<uint16_t>    P_CFG_UINT16 {ID_BASE + 3,  "CFG_UINT16", 4096};
    FlashParamNs::Parameter<uint32_t>    P_CFG_UINT32 {ID_BASE + 4,  "CFG_UINT32", 65535*4};
    FlashParamNs::Parameter<uint64_t>    P_CFG_UINT64 {ID_BASE + 5,  "CFG_UINT64", 1ULL<<40};
    FlashParamNs::Parameter<int8_t>      P_CFG_INT8   {ID_BASE + 6,  "CFG_INT8",   -16};
    FlashParamNs::Parameter<int16_t>     P_CFG_INT16  {ID_BASE + 7,  "CFG_INT16",  -2047};
    FlashParamNs::Parameter<int32_t>     P_CFG_INT32  {ID_BASE + 8,  "CFG_INT32",  -65536*5};
    FlashParamNs::Parameter<int64_t>     P_CFG_INT64  {ID_BASE + 9,  "CFG_INT64",  -(1LL<<35)};
    FlashParamNs::Parameter<float>       P_CFG_FLOAT  {ID_BASE + 10, "CFG_FLOAT",  3.326f};
    FlashParamNs::Parameter<double>      P_CFG_DOUBLE {ID_BASE + 11, "CFG_DOUBLE", -1.056e-8};
};

مثيل

  • Configparam هو Singleton 
 ConfigParam cfgParam& = ConfigParam.instance();

تهيئة

  • تحميل جميع المعلمات من الفلاش
  • إذا كان الفلاش فارغًا أو يبدو أن تنسيق الفلاش قد تم تغييره ، فسيتم تحميل القيم الافتراضية 
 cfgParam.initialize();

الانتهاء

  • تخزين جميع المعلمات للفلاش 
 cfgParam.finalize();

تحميل القيمة الافتراضية

  • إجبار جميع المعلمات على تحميل القيمة الافتراضية 
 cfgParam.loadDefault();

معلومات الطباعة

  • طباعة المعلومات على منطقة فلاش المستخدم ورسم خرائط المعلمات 
 cfgParam.printInfo();
  • مثال الإخراج 
 === UserFlash ===
FlashSize: 0x200000 (2097152d)
SectorSize: 0x1000 (4096d)
PageSize: 0x100 (256d)
UserReqSize: 0x400 (1024d)
EraseSize: 0x1000 (4096d)
PageProgSize: 0x400 (1024d)
UserFlashOfs: 0x1ff000
UserFlashReadAddr: 0x101ff000
=== FlashParam ===
0x0000 CFG_MAP_HASH: 3015833569d (0xb3c1f7e1)
0x0004 CFG_STORE_COUNT: 67d (0x43)
0x0008 CFG_STRING: abcdefg
0x0018 CFG_BOOL: false
0x0019 CFG_UINT8: 23d (0x17)
0x001a CFG_UINT16: 4096d (0x1000)
0x001c CFG_UINT32: 262140d (0x3fffc)
0x0020 CFG_UINT64: 1099511627776d (0x10000000000)
0x0028 CFG_INT8: 240d (0xf0)
0x0029 CFG_INT16: -2047d (0xf801)
0x002b CFG_INT32: -327680d (0xfffb0000)
0x002f CFG_INT64: -34359738368d (0xfffffff800000000)
0x0037 CFG_FLOAT:  3.3260 (3.3260e+00)
0x003b CFG_DOUBLE: -0.0000 (-1.0560e-08)

getter/setter عن طريق الوصول المباشر

  • الوصول المباشر المتاح دون تعيين نوعه
  • على سبيل المثال ، تصبح القيمة uint16_t في الحالة التالية
  • لاحظ أن قيمة المعلمة تحديثات set() ، ومع ذلك ، لم يتم تخزينها بعد إلى الفلاش حتى يتم استدعاء () 
 cfgParam.P_CFG_UINT16.set(0x89abcdef);
const auto& value = cfgParam.P_CFG_UINT16.get();

getter/setter عن طريق الوصول إلى المعرف

  • للوصول إلى المعرف ، يجب تعيين نوع القالب لتلبية نوع المعلمة
  • لاحظ أن قيمة المعلمة تحديث setValue<T>() ، ومع ذلك ، لم يتم تخزينها بعد حتى يتم استدعاءها حتى يتم استدعاء () 
 cfgParam.setValue<uint16_t>(cfgParam.ID_BASE + 3, 0x0123);
const auto& value = cfgParam.getValue<uint16_t>(cfgParam.ID_BASE + 3);

معلمات مدمجة

هناك نوعان من المعلمات في المكتبة. عادةً ما يتم إنشاء هذه القيم تلقائيًا أو تحديثها في المكتبة.

CFG_MAP_HASH

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

cfg_store_count

  • عدد متاجر فلاش. يبدأ من الصفر عندما تكون مساحة الفلاش المستهدفة فارغة ويتم زيادة في كل مرة يتم فيها تخزين القيم إلى الفلاش عن طريق finalize() .

تعمل مع برنامج متعدد الأزواج

  • كجمهور ، يجب أن يتم تشغيل الفلاش من Core0 فقط
  • حتى في هذه الحالة ، يجب استدعاء flash_safe_execute_core_init() من Core1 لإخطار حالة آمنة للبرمجة
  • خلاف ذلك ، سيفشل cfgParam.finalize() بسبب faulure of UserFlash::program()
  • انظر multicore_test 
 ...
#include "pico/flash.h"
#include "pico/multicore.h"

static void core1_process() {
    flash_safe_execute_core_init();  // notify core0 that there's no access to flash on core1
    ...
}

int main() {
    ...
    multicore_launch_core1(core1_process);
    ...
}

كيفية بناء مشاريع العينة

  • انظر "البدء مع Raspberry Pi Pico"
  • ضع "Pico-SDK" و "Pico-Examples" و "Pico-Extras" على نفس المستوى مع مجلد المشروع هذا.
  • تعيين المتغيرات البيئية لـ PICO_SDK_PATH و PICO_EXTRAS_PATH و PICO_EXAMPLES_PATH
  • أكد مع Pico SDK 2.0.0 
 > git clone -b 2.0.0 https://github.com/raspberrypi/pico-sdk.git
> cd pico-sdk
> git submodule update -i
> cd ..
> git clone -b sdk-2.0.0 https://github.com/raspberrypi/pico-examples.git
>
> git clone -b sdk-2.0.0 https://github.com/raspberrypi/pico-extras.git
> 
> git clone -b main https://github.com/elehobica/pico_user_flash.git
> cd pico_user_flash
> cd samplesxxxxx  # target sample project
> cd ..

النوافذ

  • تم تأكيد Build مع موجه أوامر Developer لـ VS 2022 ورمز Visual Studio على بيئة Windows
  • أكد مع CMake-3.27.2-Windows-X86_64 و GCC-ARM-NONE-OEBI-10.3-2021.10-Win32
  • Lanuch "موجه أوامر المطور لـ VS 2022" 
 > mkdir build && cd build
> cmake -G "NMake Makefiles" ..
> nmake
  • ضع "*.uf2" على محرك RPI-RP2

Linux

  • تم تأكيد Build مع Pico-SDK-DOCKER: SDK-2.0.0-1.0.0
  • أكد مع CMake-3.22.1 و ARM-NONE-OEBI-GCC (15: 10.3-2021.07-4) 10.3.1 
 $ mkdir build && cd build
$ cmake ..
$ make -j4
  • تنزيل "*.uf2" على محرك RPI-RP2

أمثلة

مشاريع عينة تمثيلية

  • Simple_test
  • wifi_ssid_password
  • multicore_test

التطبيقات الخارجية

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