Google is committed to advancing racial equity for Black communities. See how.
ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

إعدادات

تتضمن هذه الوحدة تجريد النظام الأساسي للتخزين غير المتطاير للإعدادات.

ملخص

التعداد

anonymous enum {
OT_SETTINGS_KEY_ACTIVE_DATASET = 0x0001,
OT_SETTINGS_KEY_PENDING_DATASET = 0x0002,
OT_SETTINGS_KEY_NETWORK_INFO = 0x0003,
OT_SETTINGS_KEY_PARENT_INFO = 0x0004,
OT_SETTINGS_KEY_CHILD_INFO = 0x0005,
OT_SETTINGS_KEY_RESERVED = 0x0006,
OT_SETTINGS_KEY_SLAAC_IID_SECRET_KEY = 0x0007,
OT_SETTINGS_KEY_DAD_INFO = 0x0008,
OT_SETTINGS_KEY_OMR_PREFIX = 0x0009,
OT_SETTINGS_KEY_ON_LINK_PREFIX = 0x000a,
OT_SETTINGS_KEY_SRP_ECDSA_KEY = 0x000b
}
تعداد
يحدد هذا التعداد مفاتيح الإعدادات.

المهام

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 .

ملكيات
OT_SETTINGS_KEY_ACTIVE_DATASET

مجموعة البيانات التشغيلية النشطة.

OT_SETTINGS_KEY_CHILD_INFO

معلومات الطفل.

OT_SETTINGS_KEY_DAD_INFO

معلومات مكررة للكشف عن العنوان (DAD).

OT_SETTINGS_KEY_NETWORK_INFO

معلومات شبكة الموضوع.

OT_SETTINGS_KEY_OMR_PREFIX

بادئة قابلة للتوجيه خارج الشبكة (OMR).

OT_SETTINGS_KEY_ON_LINK_PREFIX

بادئة على الارتباط لارتباط البنية التحتية.

OT_SETTINGS_KEY_PARENT_INFO

معلومات الوالدين.

OT_SETTINGS_KEY_PENDING_DATASET

مجموعة البيانات التشغيلية المعلقة.

OT_SETTINGS_KEY_RESERVED

محجوز (بدء تلقائي سابق).

OT_SETTINGS_KEY_SLAAC_IID_SECRET_KEY

مفتاح SLAAC لإنشاء IID معتم لغويًا.

OT_SETTINGS_KEY_SRP_ECDSA_KEY

عميل SRP ECDSA زوج مفاتيح عام / خاص.

المهام

otPlatSettingsAdd

otError otPlatSettingsAdd(
  otInstance *aInstance,
  uint16_t aKey,
  const uint8_t *aValue,
  uint16_t aValueLength
)

يضيف قيمة إلى الإعداد.

تضيف هذه الوظيفة القيمة إلى الإعداد المحدد بواسطة مفتاح ، دون استبدال أي قيم موجودة.

لاحظ أن التنفيذ الأساسي غير مطلوب للحفاظ على ترتيب العناصر المرتبطة بمفتاح معين. يمكن إضافة القيمة المضافة إلى النهاية أو البداية أو حتى في مكان ما في الوسط. قد يتغير أيضًا ترتيب أي قيم موجودة مسبقًا.

قد يؤدي استدعاء هذه الوظيفة بنجاح إلى إعادة ترتيب الإعدادات غير ذات الصلة بقيم متعددة.

تفاصيل
العوامل
[in] aInstance
بنية مثيل OpenThread.
[in] aKey
المفتاح المرتبط بإعداد التغيير.
[in] aValue
مؤشر إلى المكان الذي يجب قراءة القيمة الجديدة للإعداد منه. يجب ألا يكون فارغًا إذا كانت قيمة aValueLength غير صفرية.
[in] aValueLength
طول البيانات المشار إليها بواسطة aValue. قد تكون صفرا.
إرجاع القيم
OT_ERROR_NONE
تمت إضافة الإعداد المحدد أو تنظيمه لإضافته.
OT_ERROR_NOT_IMPLEMENTED
لم يتم تنفيذ هذه الوظيفة على هذا النظام الأساسي.
OT_ERROR_NO_BUFS
لا توجد مساحة متبقية لتخزين الإعداد المحدد.

otPlatSettingsDeinit

void otPlatSettingsDeinit(
  otInstance *aInstance
)

يقوم بإجراء أي إلغاء تهيئة للنظام الفرعي للإعدادات ، إذا لزم الأمر.

تفاصيل
العوامل
[in] aInstance
بنية مثيل OpenThread.

otPlatSettingsDelete

otError otPlatSettingsDelete(
  otInstance *aInstance,
  uint16_t aKey,
  int aIndex
)

يزيل الإعداد من مخزن الإعداد.

تحذف هذه الوظيفة قيمة معينة من الإعداد المحدد بواسطة مفتاح من مخزن الإعدادات.

لاحظ أن التنفيذ الأساسي غير مطلوب للحفاظ على ترتيب العناصر المرتبطة بمفتاح معين.

تفاصيل
العوامل
[in] aInstance
بنية مثيل OpenThread.
[in] aKey
المفتاح المرتبط بالإعداد المطلوب.
[in] aIndex
فهرس القيمة المراد إزالتها. إذا تم التعيين على -1 ، فستتم إزالة جميع قيم هذا المفتاح.
إرجاع القيم
OT_ERROR_NONE
تم العثور على المفتاح والفهرس المحددين وإزالتهما بنجاح.
OT_ERROR_NOT_FOUND
لم يتم العثور على المفتاح أو الفهرس المحدد في مخزن الإعدادات.
OT_ERROR_NOT_IMPLEMENTED
لم يتم تنفيذ هذه الوظيفة على هذا النظام الأساسي.

otPlatSettingsGet

otError otPlatSettingsGet(
  otInstance *aInstance,
  uint16_t aKey,
  int aIndex,
  uint8_t *aValue,
  uint16_t *aValueLength
)

يجلب قيمة الإعداد.

تقوم هذه الوظيفة بجلب قيمة الإعداد المحدد بواسطة مفتاح وكتابتها في الذاكرة المشار إليها بواسطة aValue. ثم يكتب الطول إلى العدد الصحيح المشار إليه بـ aValueLength. القيمة الأولية لـ aValueLength هي الحد الأقصى لعدد وحدات البايت التي يجب كتابتها في aValue.

يمكن استخدام هذه الوظيفة للتحقق من وجود مفتاح دون إحضار القيمة عن طريق تعيين aValue و aValueLength على NULL. يمكنك أيضًا التحقق من طول الإعداد دون جلبه عن طريق تعيين قيمة فقط على NULL.

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

تفاصيل
العوامل
[in] aInstance
بنية مثيل OpenThread.
[in] aKey
المفتاح المرتبط بالإعداد المطلوب.
[in] aIndex
فهرس العنصر المحدد الذي تريد الحصول عليه.
[out] aValue
مؤشر إلى مكان كتابة قيمة الإعداد. يمكن تعيينه على NULL إذا كان مجرد اختبار لوجود أو طول الإعداد.
[in,out] aValueLength
مؤشر لطول القيمة. عند الاستدعاء ، يجب أن يشير هذا المؤشر إلى عدد صحيح يحتوي على الحد الأقصى لحجم القيمة التي يمكن كتابتها إلى aValue. عند العودة ، تتم كتابة الطول الفعلي للإعداد. قد يتم تعيين هذا على NULL في حالة إجراء فحص التواجد.
إرجاع القيم
OT_ERROR_NONE
تم العثور على الإعداد المحدد وجلبه بنجاح.
OT_ERROR_NOT_FOUND
لم يتم العثور على الإعداد المحدد في مخزن الإعدادات.
OT_ERROR_NOT_IMPLEMENTED
لم يتم تنفيذ هذه الوظيفة على هذا النظام الأساسي.

otPlatSettingsInit

void otPlatSettingsInit(
  otInstance *aInstance
)

يقوم بأي تهيئة للنظام الفرعي للإعدادات ، إذا لزم الأمر.

تفاصيل
العوامل
[in] aInstance
بنية مثيل OpenThread.

otPlatSettingsSet

otError otPlatSettingsSet(
  otInstance *aInstance,
  uint16_t aKey,
  const uint8_t *aValue,
  uint16_t aValueLength
)

يضبط أو يستبدل قيمة أحد الإعدادات.

تقوم هذه الوظيفة بتعيين أو استبدال قيمة الإعداد المحدد بواسطة مفتاح. إذا كان هناك أكثر من قيمة مرتبطة مسبقًا بـ aKey ، فسيتم حذفها جميعًا واستبدالها بهذا الإدخال الفردي.

قد يؤدي استدعاء هذه الوظيفة بنجاح إلى إعادة ترتيب الإعدادات غير ذات الصلة بقيم متعددة.

تفاصيل
العوامل
[in] aInstance
بنية مثيل OpenThread.
[in] aKey
المفتاح المرتبط بإعداد التغيير.
[in] aValue
مؤشر إلى المكان الذي يجب قراءة القيمة الجديدة للإعداد منه. يجب ألا يكون فارغًا إذا كانت قيمة aValueLength غير صفرية.
[in] aValueLength
طول البيانات المشار إليها بواسطة aValue. قد تكون صفرا.
إرجاع القيم
OT_ERROR_NONE
تم تغيير الإعداد المحدد أو تنظيمه.
OT_ERROR_NOT_IMPLEMENTED
لم يتم تنفيذ هذه الوظيفة على هذا النظام الأساسي.
OT_ERROR_NO_BUFS
لا توجد مساحة متبقية لتخزين الإعداد المحدد.

otPlatSettingsSetCriticalKeys

void otPlatSettingsSetCriticalKeys(
  otInstance *aInstance,
  const uint16_t *aKeys,
  uint16_t aKeysLength
)

تحدد هذه الوظيفة المفاتيح الهامة التي يجب تخزينها في المنطقة الآمنة.

لاحظ أنه يجب عدم تحرير الذاكرة المشار إليها بواسطة aKeys قبل aInstance .

تفاصيل
العوامل
[in] aInstance
بنية مثيل OpenThread.
[in] aKeys
مؤشر إلى مصفوفة تحتوي على قائمة بالمفاتيح الهامة.
[in] aKeysLength
عدد الإدخالات في صفيف aKeys .

otPlatSettings مسح

void otPlatSettingsWipe(
  otInstance *aInstance
)

يزيل جميع الإعدادات من مخزن الإعدادات.

تحذف هذه الوظيفة جميع الإعدادات من متجر الإعدادات ، وتعيد تعيينها إلى حالة المصنع الأولية.

تفاصيل
العوامل
[in] aInstance
بنية مثيل OpenThread.