إعدادات
تتضمن هذه الوحدة تجريد النظام الأساسي للتخزين غير المتطاير للإعدادات.
ملخص
التعداد | |
---|---|
anonymous enum { | تعداد يحدد هذا التعداد مفاتيح الإعدادات. |
المهام | |
---|---|
otPlatSettingsAdd ( otInstance *aInstance, uint16_t aKey, const uint8_t *aValue, uint16_t aValueLength) | يضيف قيمة إلى الإعداد. |
otPlatSettingsDeinit ( otInstance *aInstance) | void يقوم بإجراء أي إلغاء تهيئة للنظام الفرعي للإعدادات ، إذا لزم الأمر. |
otPlatSettingsDelete ( otInstance *aInstance, uint16_t aKey, int aIndex) | يزيل الإعداد من مخزن الإعداد. |
otPlatSettingsGet ( otInstance *aInstance, uint16_t aKey, int aIndex, uint8_t *aValue, uint16_t *aValueLength) | يجلب قيمة الإعداد. |
otPlatSettingsInit ( otInstance *aInstance) | void يقوم بأي تهيئة للنظام الفرعي للإعدادات ، إذا لزم الأمر. |
otPlatSettingsSet ( otInstance *aInstance, uint16_t aKey, const uint8_t *aValue, uint16_t aValueLength) | يضبط أو يستبدل قيمة أحد الإعدادات. |
otPlatSettingsSetCriticalKeys ( otInstance *aInstance, const uint16_t *aKeys, uint16_t aKeysLength) | void تحدد هذه الوظيفة المفاتيح الهامة التي يجب تخزينها في المنطقة الآمنة. |
otPlatSettingsWipe ( otInstance *aInstance) | void يزيل جميع الإعدادات من مخزن الإعدادات. |
التعداد
تعداد مجهول
anonymous enum
يحدد هذا التعداد مفاتيح الإعدادات.
ملاحظة: عند إضافة مفتاح ضبط جديد ، إذا كانت الإعدادات المقابلة للمفتاح تحتوي على معلومات حساسة للأمان ، يجب على المطور إضافة المفتاح إلى المصفوفة kCriticalKeys
.
المهام
otPlatSettingsAdd
otError otPlatSettingsAdd( otInstance *aInstance, uint16_t aKey, const uint8_t *aValue, uint16_t aValueLength )
يضيف قيمة إلى الإعداد.
تضيف هذه الوظيفة القيمة إلى الإعداد المحدد بواسطة مفتاح ، دون استبدال أي قيم موجودة.
لاحظ أن التنفيذ الأساسي غير مطلوب للحفاظ على ترتيب العناصر المرتبطة بمفتاح معين. يمكن إضافة القيمة المضافة إلى النهاية أو البداية أو حتى في مكان ما في الوسط. قد يتغير أيضًا ترتيب أي قيم موجودة مسبقًا.
قد يؤدي استدعاء هذه الوظيفة بنجاح إلى إعادة ترتيب الإعدادات غير ذات الصلة بقيم متعددة.
تفاصيل | |||||||||
---|---|---|---|---|---|---|---|---|---|
العوامل |
| ||||||||
إرجاع القيم |
|
otPlatSettingsDeinit
void otPlatSettingsDeinit( otInstance *aInstance )
يقوم بإجراء أي إلغاء تهيئة للنظام الفرعي للإعدادات ، إذا لزم الأمر.
تفاصيل | |||
---|---|---|---|
العوامل |
|
otPlatSettingsDelete
otError otPlatSettingsDelete( otInstance *aInstance, uint16_t aKey, int aIndex )
يزيل الإعداد من مخزن الإعداد.
تحذف هذه الوظيفة قيمة معينة من الإعداد المحدد بواسطة مفتاح من مخزن الإعدادات.
لاحظ أن التنفيذ الأساسي غير مطلوب للحفاظ على ترتيب العناصر المرتبطة بمفتاح معين.
تفاصيل | |||||||
---|---|---|---|---|---|---|---|
العوامل |
| ||||||
إرجاع القيم |
|
otPlatSettingsGet
otError otPlatSettingsGet( otInstance *aInstance, uint16_t aKey, int aIndex, uint8_t *aValue, uint16_t *aValueLength )
يجلب قيمة الإعداد.
تقوم هذه الوظيفة بجلب قيمة الإعداد المحدد بواسطة مفتاح وكتابتها في الذاكرة المشار إليها بواسطة aValue. ثم يكتب الطول إلى العدد الصحيح المشار إليه بـ aValueLength. القيمة الأولية لـ aValueLength هي الحد الأقصى لعدد وحدات البايت التي يجب كتابتها في aValue.
يمكن استخدام هذه الوظيفة للتحقق من وجود مفتاح دون إحضار القيمة عن طريق تعيين aValue و aValueLength على NULL. يمكنك أيضًا التحقق من طول الإعداد دون جلبه عن طريق تعيين قيمة فقط على NULL.
لاحظ أن تنفيذ التخزين الأساسي غير مطلوب للحفاظ على ترتيب الإعدادات بقيم متعددة. قد يتغير ترتيب هذه القيم بعد أي عملية كتابة إلى المخزن.
تفاصيل | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
العوامل |
| ||||||||||
إرجاع القيم |
|
otPlatSettingsInit
void otPlatSettingsInit( otInstance *aInstance )
يقوم بأي تهيئة للنظام الفرعي للإعدادات ، إذا لزم الأمر.
تفاصيل | |||
---|---|---|---|
العوامل |
|
otPlatSettingsSet
otError otPlatSettingsSet( otInstance *aInstance, uint16_t aKey, const uint8_t *aValue, uint16_t aValueLength )
يضبط أو يستبدل قيمة أحد الإعدادات.
تقوم هذه الوظيفة بتعيين أو استبدال قيمة الإعداد المحدد بواسطة مفتاح. إذا كان هناك أكثر من قيمة مرتبطة مسبقًا بـ aKey ، فسيتم حذفها جميعًا واستبدالها بهذا الإدخال الفردي.
قد يؤدي استدعاء هذه الوظيفة بنجاح إلى إعادة ترتيب الإعدادات غير ذات الصلة بقيم متعددة.
تفاصيل | |||||||||
---|---|---|---|---|---|---|---|---|---|
العوامل |
| ||||||||
إرجاع القيم |
|
otPlatSettingsSetCriticalKeys
void otPlatSettingsSetCriticalKeys( otInstance *aInstance, const uint16_t *aKeys, uint16_t aKeysLength )
تحدد هذه الوظيفة المفاتيح الهامة التي يجب تخزينها في المنطقة الآمنة.
لاحظ أنه يجب عدم تحرير الذاكرة المشار إليها بواسطة aKeys
قبل aInstance
.
تفاصيل | |||||||
---|---|---|---|---|---|---|---|
العوامل |
|
otPlatSettings مسح
void otPlatSettingsWipe( otInstance *aInstance )
يزيل جميع الإعدادات من مخزن الإعدادات.
تحذف هذه الوظيفة جميع الإعدادات من متجر الإعدادات ، وتعيد تعيينها إلى حالة المصنع الأولية.
تفاصيل | |||
---|---|---|---|
العوامل |
|