مجموعة البيانات التشغيلية
تتضمن دوال واجهة برمجة التطبيقات التشغيلية لمجموعة البيانات.
ملخّص
بالنسبة إلى إصدارات FTD فقط، يتضمّن "أداة تعديل مجموعة البيانات" دوال لإدارة تحديثات مجموعات البيانات.
بالنسبة إلى الإصدارات FTD وMTD، تتضمّن واجهة برمجة التطبيقات التشغيلية لمجموعة البيانات وظائف لإدارة مجموعات البيانات النشطة والمعلّقة ومجموعات بيانات المتجر.
أنواع المحددات |
|
---|---|
otChannelMask
|
typedefuint32_t
يمثل قناع القناة. |
otDatasetMgmtSetCallback)(otError aResult, void *aContext)
|
typedefvoid(*
يتم استدعاء المؤشر عند تلقّي رد على طلب MGMT_SET أو انتهاء المهلة. |
otDatasetUpdaterCallback)(otError aError, void *aContext)
|
typedefvoid(*
يتم استدعاء مؤشر دالة رد الاتصال هذا عند انتهاء طلب تحديث مجموعة البيانات، أو بنجاح الإبلاغ عن حالة أو فشل طلب تحديث مجموعة البيانات. |
otExtendedPanId
|
typedefstruct otExtendedPanId
رقم تعريف رقم PAN الموسَّع |
otMeshLocalPrefix
|
typedef يمثل بادئة محلية لشبكة متشابكة. |
otMeshcopTlvType
|
typedefenum otMeshcopTlvType
يمثّل أنواع TLV. |
otNetworkKey
|
typedefstruct otNetworkKey
يمثل مفتاح شبكة Thread. |
otNetworkKeyRef
|
typedef يمثل نوع البيانات هذا Keyref إلى NetworkKey. |
otNetworkName
|
typedefstruct otNetworkName
يمثّل اسم شبكة. |
otOperationalDataset
|
typedefstruct otOperationalDataset
تمثل مجموعة بيانات تشغيلية نشطة أو معلّقة. |
otOperationalDatasetComponents
|
typedef تمثّل وجود مكوّنات مختلفة في مجموعة بيانات تشغيلية أو نشطة في انتظار المراجعة. |
otOperationalDatasetTlvs
|
typedefstruct otOperationalDatasetTlvs
تمثل مجموعة بيانات تشغيلية نشطة أو معلّقة. |
otPskc
|
typedefstruct otPskc
يمثل PSKc. |
otPskcRef
|
typedef يمثل نوع البيانات هذا Keyref إلى PSKc. |
otSecurityPolicy
|
typedefstruct otSecurityPolicy
تمثيل سياسة الأمان |
otTimestamp
|
typedefstruct otTimestamp
يمثل مكوّن الطابع الزمني لمجموعة بيانات سلسلة المحادثات. |
المتغيّرات |
|
---|---|
OT_TOOL_PACKED_END
|
OT_TOOL_PACKED_BEGIN struct otNetworkKey
|
الدوال |
|
---|---|
otDatasetConvertToTlvs(const otOperationalDataset *aDataset, otOperationalDatasetTlvs *aDatasetTlvs)
|
تحوِّل مجموعة بيانات تشغيلية معيّنة إلى
otOperationalDatasetTlvs . |
otDatasetCreateNewNetwork(otInstance *aInstance, otOperationalDataset *aDataset)
|
بالنسبة إلى بروتوكول FTD فقط، يتم إنشاء مجموعة بيانات تشغيلية جديدة لاستخدامها عند تشكيل شبكة جديدة.
|
otDatasetGeneratePskc(const char *aPassPhrase, const otNetworkName *aNetworkName, const otExtendedPanId *aExtPanId, otPskc *aPskc)
|
تنشئ PSKc من عبارة مرور معيّنة واسم شبكة ورقم تعريف PAN موسّع.
|
otDatasetGetActive(otInstance *aInstance, otOperationalDataset *aDataset)
|
الحصول على مجموعة البيانات التشغيلية النشطة
|
otDatasetGetActiveTlvs(otInstance *aInstance, otOperationalDatasetTlvs *aDataset)
|
الحصول على مجموعة البيانات التشغيلية النشطة
|
otDatasetGetDelayTimerMinimal(otInstance *aInstance)
|
uint32_t
وبالنسبة إلى FTD فقط، يتم تطبيق موقّت تأخير قصير.
|
otDatasetGetPending(otInstance *aInstance, otOperationalDataset *aDataset)
|
الحصول على مجموعة البيانات التشغيلية التي تنتظر المراجعة
|
otDatasetGetPendingTlvs(otInstance *aInstance, otOperationalDatasetTlvs *aDataset)
|
الحصول على مجموعة البيانات التشغيلية التي تنتظر المراجعة
|
otDatasetIsCommissioned(otInstance *aInstance)
|
bool
يشير إلى ما إذا كانت هناك شبكة صالحة في مجموعة البيانات التشغيلية النشطة.
|
otDatasetParseTlvs(const otOperationalDatasetTlvs *aDatasetTlvs, otOperationalDataset *aDataset)
|
يحلِّل مجموعة بيانات تشغيلية من
otOperationalDatasetTlvs . |
otDatasetSendMgmtActiveGet(otInstance *aInstance, const otOperationalDatasetComponents *aDatasetComponents, const uint8_t *aTlvTypes, uint8_t aLength, const otIp6Address *aAddress)
|
إرسال MGMT_ACTIVE_GET.
|
otDatasetSendMgmtActiveSet(otInstance *aInstance, const otOperationalDataset *aDataset, const uint8_t *aTlvs, uint8_t aLength, otDatasetMgmtSetCallback aCallback, void *aContext)
|
إرسال MGMT_ACTIVE_SET.
|
otDatasetSendMgmtPendingGet(otInstance *aInstance, const otOperationalDatasetComponents *aDatasetComponents, const uint8_t *aTlvTypes, uint8_t aLength, const otIp6Address *aAddress)
|
يتم إرسال MGMT_PENDING_GET.
|
otDatasetSendMgmtPendingSet(otInstance *aInstance, const otOperationalDataset *aDataset, const uint8_t *aTlvs, uint8_t aLength, otDatasetMgmtSetCallback aCallback, void *aContext)
|
إرسال MGMT_PENDING_SET.
|
otDatasetSetActive(otInstance *aInstance, const otOperationalDataset *aDataset)
|
ضبط مجموعة البيانات التشغيلية النشطة
|
otDatasetSetActiveTlvs(otInstance *aInstance, const otOperationalDatasetTlvs *aDataset)
|
ضبط مجموعة البيانات التشغيلية النشطة
|
otDatasetSetDelayTimerMinimal(otInstance *aInstance, uint32_t aDelayTimerMinimal)
|
بالنسبة إلى بروتوكول FTD فقط، يتم ضبط موقّت تأخير قصير.
|
otDatasetSetPending(otInstance *aInstance, const otOperationalDataset *aDataset)
|
تُحدِّد مجموعة البيانات التشغيلية في انتظار المراجعة.
|
otDatasetSetPendingTlvs(otInstance *aInstance, const otOperationalDatasetTlvs *aDataset)
|
تُحدِّد مجموعة البيانات التشغيلية في انتظار المراجعة.
|
otDatasetUpdateTlvs(const otOperationalDataset *aDataset, otOperationalDatasetTlvs *aDatasetTlvs)
|
تعديل مجموعة بيانات تشغيلية معيّنة
|
otDatasetUpdaterCancelUpdate(otInstance *aInstance)
|
void
إلغاء طلب تحديث مجموعة بيانات تشغيلية (إن وُجد)
|
otDatasetUpdaterIsUpdateOngoing(otInstance *aInstance)
|
bool
تشير إلى ما إذا كان هناك طلب تحديث "مجموعة بيانات عملية" جارٍ.
|
otDatasetUpdaterRequestUpdate(otInstance *aInstance, const otOperationalDataset *aDataset, otDatasetUpdaterCallback aCallback, void *aContext)
|
تطلب تحديث مجموعة البيانات التشغيلية.
|
otNetworkNameFromString(otNetworkName *aNetworkName, const char *aNameString)
|
لضبط مثيل
otNetworkName من سلسلة C محدّدة فارغة. |
هياكل |
|
---|---|
otExtendedPanId |
رقم تعريف رقم PAN الموسَّع |
otNetworkKey |
يمثل مفتاح شبكة Thread. |
otNetworkName |
يمثّل اسم شبكة. |
otOperaativeDataset |
تمثل مجموعة بيانات تشغيلية نشطة أو معلّقة. |
otOperaativeDatasetComponents |
تمثّل وجود مكوّنات مختلفة في مجموعة بيانات تشغيلية أو نشطة في انتظار المراجعة. |
otOperaativeDatasetTlvs |
تمثل مجموعة بيانات تشغيلية نشطة أو معلّقة. |
otPskc |
يمثل PSKc. |
otSecurityPolicy |
تمثيل سياسة الأمان |
otTimestamp |
يمثل مكوّن الطابع الزمني لمجموعة بيانات سلسلة المحادثات. |
التعدادات
otMeshcopTlvType
otMeshcopTlvType
يمثّل أنواع TLV.
أماكن إقامة | |
---|---|
OT_MESHCOP_TLV_ACTIVETIMESTAMP
|
mshcop Active الطابع الزمني TLV |
OT_MESHCOP_TLV_BORDER_AGENT_RLOC
|
mshcop Border Agent Locator TLV |
OT_MESHCOP_TLV_CHANNEL
|
قناة mshcop Channel TLV |
OT_MESHCOP_TLV_CHANNELMASK
|
قناع قناة TLV |
OT_MESHCOP_TLV_COMMISSIONER_ID
|
رقم تعريف ThcVer الخاص بالمفوضية |
OT_MESHCOP_TLV_COMMISSIONER_UDP_PORT
|
mshcop Commissioner UDP Port TLV |
OT_MESHCOP_TLV_COMM_SESSION_ID
|
معرّف جلسة ThcV لمفوضية ميسhcop |
OT_MESHCOP_TLV_COUNT
|
عدد مرات المشاهدة TLV |
OT_MESHCOP_TLV_DELAYTIMER
|
mshcop تأجيل الموقّت TLV |
OT_MESHCOP_TLV_DISCOVERYREQUEST
|
طلب TLV بشأن استكشاف المحتوى |
OT_MESHCOP_TLV_DISCOVERYRESPONSE
|
ردّ TLV على mshcop Discovery |
OT_MESHCOP_TLV_ENERGY_LIST
|
قائمة خدمات الطاقة في mshcop TLV |
OT_MESHCOP_TLV_EXTPANID
|
mshcop Extended Pan ID ID TLV |
OT_MESHCOP_TLV_GET
|
mshcop الحصول على TLV |
OT_MESHCOP_TLV_IPV6_ADDRESS_TLV
|
عنوان mshcop IPv6 TLV |
OT_MESHCOP_TLV_JOINERADVERTISEMENT
|
إعلان الانضمام إلى وسائل النقل |
OT_MESHCOP_TLV_JOINER_DTLS
|
ميسhcop وصلة DTLS Encapsulation TLV |
OT_MESHCOP_TLV_JOINER_IID
|
ميسhcopلِي معرّف TLV |
OT_MESHCOP_TLV_JOINER_RLOC
|
mshcop تضخّم جهاز التوجيه لجهاز تحديد المواقع TLV |
OT_MESHCOP_TLV_JOINER_ROUTER_KEK
|
انتقِل إلى جهاز توجيه الجهاز KEK TLV |
OT_MESHCOP_TLV_JOINER_UDP_PORT
|
ميسhcop وصلة UDP TLV |
OT_MESHCOP_TLV_MESHLOCALPREFIX
|
mshcop Mesh البادئة المحلية TLV |
OT_MESHCOP_TLV_NETWORKKEY
|
Mehcop Network Key TLV |
OT_MESHCOP_TLV_NETWORKNAME
|
mshcop Network Name TLV |
OT_MESHCOP_TLV_NETWORK_KEY_SEQUENCE
|
تسلسل علامات مفتاح الشبكة ThcV |
OT_MESHCOP_TLV_PANID
|
رقم تعريف TTV في ميسhcop Pan |
OT_MESHCOP_TLV_PENDINGTIMESTAMP
|
mshcop في انتظار الطابع الزمني TLV |
OT_MESHCOP_TLV_PERIOD
|
مسار TLV |
OT_MESHCOP_TLV_PROVISIONING_URL
|
ThV.توفير عنوان URL لإدارة الحسابات |
OT_MESHCOP_TLV_PSKC
|
mshcop PSKc TLV |
OT_MESHCOP_TLV_SCAN_DURATION
|
مدة البحث عن TlsV |
OT_MESHCOP_TLV_SECURITYPOLICY
|
سياسة أمان سياسة الخدمة TLV |
OT_MESHCOP_TLV_STATE
|
TLV (ولاية ميستشوب) |
OT_MESHCOP_TLV_STEERING_DATA
|
توجيه المكالمات TLV |
OT_MESHCOP_TLV_UDP_ENCAPSULATION_TLV
|
ميسhcop UDP TLV |
OT_MESHCOP_TLV_VENDOR_DATA_TLV
|
بيانات المورّد الجديد على mshcop |
OT_MESHCOP_TLV_VENDOR_MODEL_TLV
|
نموذج مورد TLV في ميسhcop |
OT_MESHCOP_TLV_VENDOR_NAME_TLV
|
المتوفّر اسم المورِّد TLV |
OT_MESHCOP_TLV_VENDOR_STACK_VERSION_TLV
|
إصدار TLV لحزمة المورّدين (mshcop) |
OT_MESHCOP_TLV_VENDOR_SW_VERSION_TLV
|
إصدار TLV من مورِّد mshcop للمورّد |
أنواع المحددات
قناع القناة
uint32_t otChannelMask
يمثل قناع القناة.
otDatasetMgmtSetCallback
void(* otDatasetMgmtSetCallback)(otError aResult, void *aContext)
يتم استدعاء المؤشر عند تلقّي رد على طلب MGMT_SET أو انتهاء المهلة.
التفاصيل | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||||||
قيم الإرجاع |
|
otDatasetUpdaterCallback
void(* otDatasetUpdaterCallback)(otError aError, void *aContext)
يتم استدعاء مؤشر دالة رد الاتصال هذا عند انتهاء طلب تحديث مجموعة البيانات، أو بنجاح الإبلاغ عن حالة أو فشل طلب تحديث مجموعة البيانات.
متاحة عند تفعيل OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE
.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
مرجع شبكة OotNetwork
otCryptoKeyRef otNetworkKeyRef
يمثل نوع البيانات هذا Keyref إلى NetworkKey.
الإشارة إلى المفتاح
otNetworkName
struct otNetworkName otNetworkName
يمثّل اسم شبكة.
otNetworkName
عبارة عن سلسلة C فارغة عند الإنهاء (أي يجب أن ينتهي صفيف m8
حرف الأبجدية \0
فارغًا.
مجموعة بيانات تشغيلية
struct otOperationalDataset otOperationalDataset
تمثل مجموعة بيانات تشغيلية نشطة أو معلّقة.
المكوّنات في مجموعة البيانات اختيارية. تحدِّد بنية mComponents
المكوّنات المتوفّرة في مجموعة البيانات.
مكوّنات مجموعة التشغيل
struct otOperationalDatasetComponents otOperationalDatasetComponents
تمثّل وجود مكوّنات مختلفة في مجموعة بيانات تشغيلية أو نشطة في انتظار المراجعة.
otOperaativeDatasetTlvs
struct otOperationalDatasetTlvs otOperationalDatasetTlvs
تمثل مجموعة بيانات تشغيلية نشطة أو معلّقة.
وتكون مجموعة البيانات التشغيلية مشفّرة بترميز TLV كما هو محدّد في سلسلة المحادثات.
الطابع الزمني
struct otTimestamp otTimestamp
يمثل مكوّن الطابع الزمني لمجموعة بيانات سلسلة المحادثات.
المتغيّرات
OT_TOOL_PACKED_END
OT_TOOL_PACKED_BEGIN struct otNetworkKey OT_TOOL_PACKED_END
الدوال
otDatasetConvertToTlvs
otError otDatasetConvertToTlvs( const otOperationalDataset *aDataset, otOperationalDatasetTlvs *aDatasetTlvs )
تحوِّل مجموعة بيانات تشغيلية معيّنة إلى otOperationalDatasetTlvs
.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otDatasetCreateNewNetwork
otError otDatasetCreateNewNetwork( otInstance *aInstance, otOperationalDataset *aDataset )
بالنسبة إلى بروتوكول FTD فقط، يتم إنشاء مجموعة بيانات تشغيلية جديدة لاستخدامها عند تشكيل شبكة جديدة.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otDatasetgeneratePskc
otError otDatasetGeneratePskc( const char *aPassPhrase, const otNetworkName *aNetworkName, const otExtendedPanId *aExtPanId, otPskc *aPskc )
تنشئ PSKc من عبارة مرور معيّنة واسم شبكة ورقم تعريف PAN موسّع.
يتم استخدام PSKc لإنشاء جلسة المفوّض.
التفاصيل | |||||||||
---|---|---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||||
قيم الإرجاع |
|
otDatasetGetActive
otError otDatasetGetActive( otInstance *aInstance, otOperationalDataset *aDataset )
الحصول على مجموعة البيانات التشغيلية النشطة
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otDatasetGetActiveTlvs
otError otDatasetGetActiveTlvs( otInstance *aInstance, otOperationalDatasetTlvs *aDataset )
الحصول على مجموعة البيانات التشغيلية النشطة
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otDatasetGetتأخيرTimerMinimal
uint32_t otDatasetGetDelayTimerMinimal( otInstance *aInstance )
وبالنسبة إلى FTD فقط، يتم تطبيق موقّت تأخير قصير.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
قيم الإرجاع |
|
otDatasetGetPending
otError otDatasetGetPending( otInstance *aInstance, otOperationalDataset *aDataset )
الحصول على مجموعة البيانات التشغيلية التي تنتظر المراجعة
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otDatasetGet pendingTlvs
otError otDatasetGetPendingTlvs( otInstance *aInstance, otOperationalDatasetTlvs *aDataset )
الحصول على مجموعة البيانات التشغيلية التي تنتظر المراجعة
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otDatasetIsCommissioned
bool otDatasetIsCommissioned( otInstance *aInstance )
يشير إلى ما إذا كانت هناك شبكة صالحة في مجموعة البيانات التشغيلية النشطة.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
صحيح إذا كانت هناك شبكة صالحة في مجموعة البيانات التشغيلية النشطة، أو على خطأ "خطأ" بخلاف ذلك.
|
OotDatasetParseTlvs
otError otDatasetParseTlvs( const otOperationalDatasetTlvs *aDatasetTlvs, otOperationalDataset *aDataset )
يحلِّل مجموعة بيانات تشغيلية من otOperationalDatasetTlvs
.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otDatasetSendMgmtActiveGet
otError otDatasetSendMgmtActiveGet( otInstance *aInstance, const otOperationalDatasetComponents *aDatasetComponents, const uint8_t *aTlvTypes, uint8_t aLength, const otIp6Address *aAddress )
إرسال MGMT_ACTIVE_GET.
التفاصيل | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||||||
قيم الإرجاع |
|
otDatasetSendMgmtActiveSet
otError otDatasetSendMgmtActiveSet( otInstance *aInstance, const otOperationalDataset *aDataset, const uint8_t *aTlvs, uint8_t aLength, otDatasetMgmtSetCallback aCallback, void *aContext )
إرسال MGMT_ACTIVE_SET.
التفاصيل | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||||||||
قيم الإرجاع |
|
otDatasetSendMgmtPendingGet
otError otDatasetSendMgmtPendingGet( otInstance *aInstance, const otOperationalDatasetComponents *aDatasetComponents, const uint8_t *aTlvTypes, uint8_t aLength, const otIp6Address *aAddress )
يتم إرسال MGMT_PENDING_GET.
التفاصيل | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||||||
قيم الإرجاع |
|
otDatasetSendMgmtPendingSet
otError otDatasetSendMgmtPendingSet( otInstance *aInstance, const otOperationalDataset *aDataset, const uint8_t *aTlvs, uint8_t aLength, otDatasetMgmtSetCallback aCallback, void *aContext )
إرسال MGMT_PENDING_SET.
التفاصيل | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||||||||
قيم الإرجاع |
|
otDatasetSetActive
otError otDatasetSetActive( otInstance *aInstance, const otOperationalDataset *aDataset )
ضبط مجموعة البيانات التشغيلية النشطة
وإذا كانت مجموعة البيانات لا تتضمّن طابعًا زمنيًا نشطًا، تكتمل مجموعة البيانات جزئيًا فقط.
في حال تفعيل Thread على جهاز يتضمّن مجموعة بيانات نشطة مكتملة جزئيًا، سيحاول الجهاز الإرفاق بشبكة سلسلة محادثات حالية باستخدام أي معلومات حالية في مجموعة البيانات. يلزم استخدام مفتاح شبكة Thread فقط للاتصال بإحدى الشبكات.
إذا لم يتم تضمين القناة في مجموعة البيانات، سيرسل الجهاز إعلانات MLE (الإعلان) على القنوات المختلفة للعثور على الجيران على قنوات أخرى.
في حال توصيل الجهاز بشبكة من سلاسل المحادثات بنجاح، سيسترد الجهاز مجموعة البيانات النشطة الكاملة من العنصر الرئيسي. يُرجى العلم بأنّه لن يتم نقل الجهاز الذي يتوافق مع جهاز التوجيه إلى أدوار جهاز التوجيه أو القائد إلى أن يحصل على مجموعة بيانات نشطة كاملة.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
قيم الإرجاع |
|
otDatasetSetActiveTlvs
otError otDatasetSetActiveTlvs( otInstance *aInstance, const otOperationalDatasetTlvs *aDataset )
ضبط مجموعة البيانات التشغيلية النشطة
وإذا كانت مجموعة البيانات لا تتضمّن طابعًا زمنيًا نشطًا، تكتمل مجموعة البيانات جزئيًا فقط.
في حال تفعيل Thread على جهاز يتضمّن مجموعة بيانات نشطة مكتملة جزئيًا، سيحاول الجهاز الإرفاق بشبكة سلسلة محادثات حالية باستخدام أي معلومات حالية في مجموعة البيانات. يلزم استخدام مفتاح شبكة Thread فقط للاتصال بإحدى الشبكات.
إذا لم يتم تضمين القناة في مجموعة البيانات، سيرسل الجهاز إعلانات MLE (الإعلان) على القنوات المختلفة للعثور على الجيران على قنوات أخرى.
في حال توصيل الجهاز بشبكة من سلاسل المحادثات بنجاح، سيسترد الجهاز مجموعة البيانات النشطة الكاملة من العنصر الرئيسي. يُرجى العلم بأنّه لن يتم نقل الجهاز الذي يتوافق مع جهاز التوجيه إلى أدوار جهاز التوجيه أو القائد إلى أن يحصل على مجموعة بيانات نشطة كاملة.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
قيم الإرجاع |
|
otDatasetSetتأخيرTimerMinimal
otError otDatasetSetDelayTimerMinimal( otInstance *aInstance, uint32_t aDelayTimerMinimal )
بالنسبة إلى بروتوكول FTD فقط، يتم ضبط موقّت تأخير قصير.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otDatasetSetPending في انتظار المراجعة
otError otDatasetSetPending( otInstance *aInstance, const otOperationalDataset *aDataset )
تُحدِّد مجموعة البيانات التشغيلية في انتظار المراجعة.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
قيم الإرجاع |
|
otDatasetSetPendingTlvs
otError otDatasetSetPendingTlvs( otInstance *aInstance, const otOperationalDatasetTlvs *aDataset )
تُحدِّد مجموعة البيانات التشغيلية في انتظار المراجعة.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
قيم الإرجاع |
|
otDatasetUpdateTlvs
otError otDatasetUpdateTlvs( const otOperationalDataset *aDataset, otOperationalDatasetTlvs *aDatasetTlvs )
تعديل مجموعة بيانات تشغيلية معيّنة
يحتوي الحقل aDataset
على الحقول المطلوب تعديلها وقيمتها الجديدة.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||
قيم الإرجاع |
|
otDatasetUpdaterCancelUpdate
void otDatasetUpdaterCancelUpdate( otInstance *aInstance )
إلغاء طلب تحديث مجموعة بيانات تشغيلية (إن وُجد)
متاحة عند تفعيل OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE
.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
otDatasetUpdaterIsUpdateOncontinue
bool otDatasetUpdaterIsUpdateOngoing( otInstance *aInstance )
تشير إلى ما إذا كان هناك طلب تحديث "مجموعة بيانات عملية" جارٍ.
متاحة عند تفعيل OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE
.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otDatasetUpdaterRequestUpdate
otError otDatasetUpdaterRequestUpdate( otInstance *aInstance, const otOperationalDataset *aDataset, otDatasetUpdaterCallback aCallback, void *aContext )
تطلب تحديث مجموعة البيانات التشغيلية.
متاحة عند تفعيل OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE
.
يجب أن يحتوي aDataset
على الحقول المطلوب تعديلها وقيمتها الجديدة. ويجب ألا تحتوي على حقول الطابع الزمني النشطة أو في انتظار المراجعة. يجب أن يكون حقل التأخير اختياريًا، إذا لم يتم توفير قيمة تلقائية (1000 ملي ثانية).
التفاصيل | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
المَعلمات |
|
||||||||||
قيم الإرجاع |
|
otNetworkNameFromString
otError otNetworkNameFromString( otNetworkName *aNetworkName, const char *aNameString )
لضبط مثيل otNetworkName
من سلسلة C محدّدة فارغة.
يجب أن يتّبع aNameString
ترميز UTF-8، ويجب ألا يكون طول اسم الشبكة أطول من OT_NETWORK_NAME_MAX_SIZE
.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
وحدات ماكرو
OT_CHANNEL_10_MASK
OT_CHANNEL_10_MASK (1 << 10)
القناة 10.
قناة OT_CHANNEL_11_MASK
OT_CHANNEL_11_MASK (1 << 11)
القناة 11.
OT_CHANNEL_12_MASK
OT_CHANNEL_12_MASK (1 << 12)
القناة 12.
OT_CHANNEL_13_MASK
OT_CHANNEL_13_MASK (1 << 13)
القناة 13.
OT_CHANNEL_14_MASK
OT_CHANNEL_14_MASK (1 << 14)
القناة 14.
قناة OT_CHANNEL_15_MASK
OT_CHANNEL_15_MASK (1 << 15)
القناة 15.
قناة OT_CHANNEL_16_MASK
OT_CHANNEL_16_MASK (1 << 16)
القناة 16.
OT_CHANNEL_17_MASK
OT_CHANNEL_17_MASK (1 << 17)
القناة 17.
قناة OT_CHANNEL_18_MASK
OT_CHANNEL_18_MASK (1 << 18)
القناة 18.
قناة OT_CHANNEL_19_MASK
OT_CHANNEL_19_MASK (1 << 19)
القناة 19.
قناة OT_CHANNEL_1_MAK
OT_CHANNEL_1_MASK (1 << 1)
القناة 1.
OT_CHANNEL_20_MASK
OT_CHANNEL_20_MASK (1 << 20)
القناة 20.
قناة OT_CHANNEL_21_MASK
OT_CHANNEL_21_MASK (1 << 21)
القناة 21.
OT_CHANNEL_22_MASK
OT_CHANNEL_22_MASK (1 << 22)
القناة 22.
OT_CHANNEL_23_MASK
OT_CHANNEL_23_MASK (1 << 23)
القناة 23.
OT_CHANNEL_24_MASK
OT_CHANNEL_24_MASK (1 << 24)
القناة 24.
OT_CHANNEL_25_MASK
OT_CHANNEL_25_MASK (1 << 25)
القناة 25.
OT_CHANNEL_26_MASK
OT_CHANNEL_26_MASK (1 << 26)
القناة 26.
قناة OT_CHANNEL_2_MASK
OT_CHANNEL_2_MASK (1 << 2)
القناة 2.
OT_CHANNEL_3_MASK
OT_CHANNEL_3_MASK (1 << 3)
القناة 3.
قناة OT_CHANNEL_4_MASK
OT_CHANNEL_4_MASK (1 << 4)
القناة 4.
قناة OT_CHANNEL_5_MAK
OT_CHANNEL_5_MASK (1 << 5)
القناة 5.
قناة OT_CHANNEL_6_MASK
OT_CHANNEL_6_MASK (1 << 6)
القناة 6:
قناة OT_CHANNEL_7_MAK
OT_CHANNEL_7_MASK (1 << 7)
القناة 7.
قناة OT_CHANNEL_8_MASK
OT_CHANNEL_8_MASK (1 << 8)
القناة 8.
قناة OT_CHANNEL_9_MASK
OT_CHANNEL_9_MASK (1 << 9)
القناة 9.
OT_EXT_PAN_ID_SIZE
OT_EXT_PAN_ID_SIZE 8
حجم رقم PAN PAN (بالبايت)
OT_MESH_LOCAL_RDFa_SIZE
OT_MESH_LOCAL_PREFIX_SIZE OT_IP6_PREFIX_SIZE
حجم البادئة المحلية للشبكة المتداخلة (بالبايت)
OT_NETWORK_KEY_SIZE
OT_NETWORK_KEY_SIZE 16
حجم مفتاح شبكة Thread (بالبايت)
الوقت الإضافي: OT_NETWORK_NAME_MAX_SIZE
OT_NETWORK_NAME_MAX_SIZE 16
الحد الأقصى لحجم حقل "اسم شبكة سلسلة المحادثات" (بالبايت)
الوقت الإضافي_OT_FUNCTIONIONAL_DATASET_MAX_LENGTH
OT_OPERATIONAL_DATASET_MAX_LENGTH 254
الحد الأقصى لطول مجموعة البيانات التشغيلية بالبايت.
OT_PSKC_MAX_SIZE
OT_PSKC_MAX_SIZE 16
الحد الأقصى لحجم PSKc (بايت)
الموارد
تبدأ مواضيع مراجع واجهة برمجة تطبيقات OpenThread من رمز المصدر، وهو متاح على GitHub. للحصول على مزيد من المعلومات أو للمساهمة في المستندات، يمكنك الاطّلاع على المراجع.