Google is committed to advancing racial equity for Black communities. See how.

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

تتضمن هذه الوحدة وظائف لمُحدِّث مجموعة البيانات.

ملخص

تتوفر وظائف في هذه الوحدة عندما يتم تمكين ميزة الإدراجات محدث (أي OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE ومن المقرر ان 1). علاوة على ذلك ، تتوفر هذه الميزة فقط في بنية FTD.

التعداد

otMeshcopTlvType {
OT_MESHCOP_TLV_CHANNEL = 0,
OT_MESHCOP_TLV_PANID = 1,
OT_MESHCOP_TLV_EXTPANID = 2,
OT_MESHCOP_TLV_NETWORKNAME = 3,
OT_MESHCOP_TLV_PSKC = 4,
OT_MESHCOP_TLV_NETWORKKEY = 5,
OT_MESHCOP_TLV_NETWORK_KEY_SEQUENCE = 6,
OT_MESHCOP_TLV_MESHLOCALPREFIX = 7,
OT_MESHCOP_TLV_STEERING_DATA = 8,
OT_MESHCOP_TLV_BORDER_AGENT_RLOC = 9,
OT_MESHCOP_TLV_COMMISSIONER_ID = 10,
OT_MESHCOP_TLV_COMM_SESSION_ID = 11,
OT_MESHCOP_TLV_SECURITYPOLICY = 12,
OT_MESHCOP_TLV_GET = 13,
OT_MESHCOP_TLV_ACTIVETIMESTAMP = 14,
OT_MESHCOP_TLV_COMMISSIONER_UDP_PORT = 15,
OT_MESHCOP_TLV_STATE = 16,
OT_MESHCOP_TLV_JOINER_DTLS = 17,
OT_MESHCOP_TLV_JOINER_UDP_PORT = 18,
OT_MESHCOP_TLV_JOINER_IID = 19,
OT_MESHCOP_TLV_JOINER_RLOC = 20,
OT_MESHCOP_TLV_JOINER_ROUTER_KEK = 21,
OT_MESHCOP_TLV_PROVISIONING_URL = 32,
OT_MESHCOP_TLV_VENDOR_NAME_TLV = 33,
OT_MESHCOP_TLV_VENDOR_MODEL_TLV = 34,
OT_MESHCOP_TLV_VENDOR_SW_VERSION_TLV = 35,
OT_MESHCOP_TLV_VENDOR_DATA_TLV = 36,
OT_MESHCOP_TLV_VENDOR_STACK_VERSION_TLV = 37,
OT_MESHCOP_TLV_UDP_ENCAPSULATION_TLV = 48,
OT_MESHCOP_TLV_IPV6_ADDRESS_TLV = 49,
OT_MESHCOP_TLV_PENDINGTIMESTAMP = 51,
OT_MESHCOP_TLV_DELAYTIMER = 52,
OT_MESHCOP_TLV_CHANNELMASK = 53,
OT_MESHCOP_TLV_COUNT = 54,
OT_MESHCOP_TLV_PERIOD = 55,
OT_MESHCOP_TLV_SCAN_DURATION = 56,
OT_MESHCOP_TLV_ENERGY_LIST = 57,
OT_MESHCOP_TLV_DISCOVERYREQUEST = 128,
OT_MESHCOP_TLV_DISCOVERYRESPONSE = 129,
OT_MESHCOP_TLV_JOINERADVERTISEMENT = 241
}
تعداد
يمثل هذا التعداد أنواع TLV الشبكية.

النوع

otChannelMask typedef
uint32_t
يمثل هذا النوع قناع القناة.
otDatasetMgmtSetCallback )(otError aResult, void *aContext) typedef
void(*
يتم استدعاء مؤشر الوظيفة هذا عند تلقي استجابة لطلب MGMT_SET أو انتهاء مهلتها.
otDatasetUpdaterCallback )(otError aError, void *aContext) typedef
void(*
يتم استدعاء مؤشر وظيفة رد الاتصال هذا عند انتهاء طلب تحديث مجموعة البيانات ، والإبلاغ عن حالة النجاح أو الفشل لطلب تحديث مجموعة البيانات.
otExtendedPanId typedef
تمثل هذه البنية معرف PAN الموسع.
otMeshLocalPrefix typedef
يمثل هذا الهيكل البادئة المحلية المعشقة.
otMeshcopTlvType typedef
يمثل هذا التعداد أنواع TLV الشبكية.
otNetworkKey typedef
struct otNetworkKey
يمثل هذا الهيكل مفتاح شبكة الموضوع.
otNetworkKeyRef typedef
يمثل نوع البيانات هذا KeyRef إلى NetworkKey.
otNetworkName typedef
تمثل هذه البنية اسم الشبكة.
otOperationalDataset typedef
يمثل هذا الهيكل مجموعة بيانات تشغيلية نشطة أو معلقة.
otOperationalDatasetComponents typedef
يمثل هذا الهيكل وجود مكونات مختلفة في مجموعة البيانات التشغيلية النشطة أو المعلقة.
otOperationalDatasetTlvs typedef
يمثل هذا الهيكل مجموعة بيانات تشغيلية نشطة أو معلقة.
otPskc typedef
struct otPskc
يمثل هذا الهيكل PSKc.
otPskcRef typedef
يمثل نوع البيانات هذا KeyRef إلى PSKc.
otSecurityPolicy typedef
تمثل هذه البنية نهج الأمان.

المتغيرات

OT_TOOL_PACKED_END

المهام

otDatasetCreateNewNetwork ( otInstance *aInstance, otOperationalDataset *aDataset)
تنشئ هذه الطريقة مجموعة بيانات تشغيلية جديدة لاستخدامها عند تكوين شبكة جديدة.
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
احصل على الحد الأدنى من مؤقت التأخير.
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)
ضبط الحد الأدنى من تأخير الموقت.
otDatasetSetPending ( otInstance *aInstance, const otOperationalDataset *aDataset)
تحدد هذه الوظيفة مجموعة البيانات التشغيلية المعلقة.
otDatasetSetPendingTlvs ( otInstance *aInstance, const otOperationalDatasetTlvs *aDataset)
تحدد هذه الوظيفة مجموعة البيانات التشغيلية المعلقة.
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

يمثل هذا الهيكل مفتاح شبكة الموضوع.

otNetworkName

تمثل هذه البنية اسم الشبكة.

otOperationalDataset

يمثل هذا الهيكل مجموعة بيانات تشغيلية نشطة أو معلقة.

otOperational DataComponents

يمثل هذا الهيكل وجود مكونات مختلفة في مجموعة البيانات التشغيلية النشطة أو المعلقة.

otOperationalDatasetTlvs

يمثل هذا الهيكل مجموعة بيانات تشغيلية نشطة أو معلقة.

otPskc

يمثل هذا الهيكل PSKc.

otSecurityPolicy

تمثل هذه البنية نهج الأمان.

التعداد

otMeshcopTlvType

 otMeshcopTlvType

يمثل هذا التعداد أنواع TLV الشبكية.

الخصائص
OT_MESHCOP_TLV_ACTIVETIMESTAMP

meshcop نشط الطابع الزمني TLV

OT_MESHCOP_TLV_BORDER_AGENT_RLOC

meshcop وكيل الحدود محدد TLV

OT_MESHCOP_TLV_CHANNEL

قناة meshcop TLV

OT_MESHCOP_TLV_CHANNELMASK

قناع قناة meshcop TLV

OT_MESHCOP_TLV_COMMISSIONER_ID

هوية مفوض الشبكة المشبكية TLV

OT_MESHCOP_TLV_COMMISSIONER_UDP_PORT

مشكوب مفوض UDP ميناء TLV

OT_MESHCOP_TLV_COMM_SESSION_ID

رقم تعريف جلسة مفوض شبكة meshcop TLV

OT_MESHCOP_TLV_COUNT

شبكة عد شبكة TLV

OT_MESHCOP_TLV_DELAYTIMER

meshcop تأخير الموقت TLV

OT_MESHCOP_TLV_DISCOVERYREQUEST

طلب اكتشاف الشبكة المشبكية TLV

OT_MESHCOP_TLV_DISCOVERYRESPONSE

شبكة استجابة اكتشاف الشبكة TLV

OT_MESHCOP_TLV_ENERGY_LIST

قائمة الطاقة meshcop TLV

OT_MESHCOP_TLV_EXTPANID

meshcop الموسعة عموم معرف TLV

OT_MESHCOP_TLV_GET

meshcop احصل على TLV

OT_MESHCOP_TLV_IPV6_ADDRESS_TLV

عنوان meshcop IPv6 TLV

OT_MESHCOP_TLV_JOINERADVERTISEMENT

إعلان شبكة نجار TLV

OT_MESHCOP_TLV_JOINER_DTLS

تغليف شبكة النجار DTLS TLV

OT_MESHCOP_TLV_JOINER_IID

نجار meshcop IID TLV

OT_MESHCOP_TLV_JOINER_RLOC

meshcop Joiner Router Locator TLV

OT_MESHCOP_TLV_JOINER_ROUTER_KEK

راوتر meshcop Joiner Router KEK TLV

OT_MESHCOP_TLV_JOINER_UDP_PORT

meshcop النجار منفذ UDP TLV

OT_MESHCOP_TLV_MESHLOCALPREFIX

meshcop Mesh البادئة المحلية TLV

OT_MESHCOP_TLV_NETWORKKEY

Meshcop Network Key TLV

OT_MESHCOP_TLV_NETWORKNAME

اسم شبكة meshcop TLV

OT_MESHCOP_TLV_NETWORK_KEY_SEQUENCE

تسلسل مفتاح شبكة meshcop TLV

OT_MESHCOP_TLV_PANID

Meshcop Pan ID TLV

OT_MESHCOP_TLV_PENDINGTIMESTAMP

meshcop في انتظار الطابع الزمني TLV

OT_MESHCOP_TLV_PERIOD

فترة meshcop TLV

OT_MESHCOP_TLV_PROVISIONING_URL

شبكة تزويد شبكة عنوان URL TLV

OT_MESHCOP_TLV_PSKC

meshcop PSKc TLV

OT_MESHCOP_TLV_SCAN_DURATION

مدة المسح الشبكي TLV

OT_MESHCOP_TLV_SECURITYPOLICY

سياسة الأمان meshcop TLV

OT_MESHCOP_TLV_STATE

حالة meshcop TLV

OT_MESHCOP_TLV_STEERING_DATA

بيانات التوجيه meshcop TLV

OT_MESHCOP_TLV_UDP_ENCAPSULATION_TLV

meshcop UDP تغليف TLV

OT_MESHCOP_TLV_VENDOR_DATA_TLV

شبكة بيانات بائع الشبكة TLV

OT_MESHCOP_TLV_VENDOR_MODEL_TLV

نموذج بائع meshcop TLV

OT_MESHCOP_TLV_VENDOR_NAME_TLV

اسم بائع meshcop TLV

OT_MESHCOP_TLV_VENDOR_STACK_VERSION_TLV

نسخة مكدس البائع من meshcop TLV

OT_MESHCOP_TLV_VENDOR_SW_VERSION_TLV

نسخة TLV من meshcop البائع SW

النوع

otChannelMask

uint32_t otChannelMask

يمثل هذا النوع قناع القناة.

otDatasetMgmtSetCallback

void(* otDatasetMgmtSetCallback)(otError aResult, void *aContext)

يتم استدعاء مؤشر الوظيفة هذا عند تلقي استجابة لطلب MGMT_SET أو انتهاء مهلتها.

تفاصيل
العوامل
[in] aResult
نتيجة العملية.
[in] aContext
مؤشر إلى سياق خاص بالتطبيق.
إرجاع القيم
OT_ERROR_NONE
تم قبول الطلب من قبل الزعيم.
OT_ERROR_REJECTED
تم رفض الطلب من قبل الزعيم.
OT_ERROR_PARSE
حدث خطأ أثناء تحليل الاستجابة.
OT_ERROR_ABORT
تمت إعادة تعيين الطلب بواسطة النظير.
OT_ERROR_RESPONSE_TIMEOUT
لم يتم استلام أي رد أو إقرار خلال فترة المهلة.

otDatasetUpdater

void(* otDatasetUpdaterCallback)(otError aError, void *aContext)

يتم استدعاء مؤشر وظيفة رد الاتصال هذا عند انتهاء طلب تحديث مجموعة البيانات ، والإبلاغ عن حالة النجاح أو الفشل لطلب تحديث مجموعة البيانات.

تفاصيل
العوامل
[in] aError
حالة الخطأ. يشير OT_ERROR_NONE إلى تحديث ناجح لمجموعة البيانات. يشير OT_ERROR_INVALID_STATE إلى الفشل بسبب حالة غير صالحة (يتم تعطيل MLE). يشير OT_ERROR_ALREADY إلى فشل بسبب طلب جهاز آخر داخل الشبكة تحديثًا متضاربًا لمجموعة البيانات.
[in] aContext
مؤشر إلى سياق التعسفي (التي يقدمها المستخدم في otDatasetUpdaterRequestUpdate() ).

otExtendedPanId

struct otExtendedPanId otExtendedPanId

تمثل هذه البنية معرف PAN الموسع.

otMeshLocalPrefix

otIp6NetworkPrefix otMeshLocalPrefix

يمثل هذا الهيكل البادئة المحلية المعشقة.

otMeshcopTlvType

enum otMeshcopTlvType otMeshcopTlvType

يمثل هذا التعداد أنواع TLV الشبكية.

otNetworkKey

struct otNetworkKey otNetworkKey

يمثل هذا الهيكل مفتاح شبكة الموضوع.

otNetworkKeyRef

otCryptoKeyRef otNetworkKeyRef

يمثل نوع البيانات هذا KeyRef إلى NetworkKey.

إشارة إلى المفتاح

otNetworkName

struct otNetworkName otNetworkName

تمثل هذه البنية اسم الشبكة.

و otNetworkName هو باطل إنهاء C سلسلة (أي m8 شار مجموعة MUST نهاية مع لاغية شار \0 ).

otOperationalDataset

struct otOperationalDataset otOperationalDataset

يمثل هذا الهيكل مجموعة بيانات تشغيلية نشطة أو معلقة.

المكونات في مجموعة البيانات اختيارية. mComponets يحدد هيكل التي هي موجودة في مجموعة بيانات المكونات.

otOperational DataComponents

struct otOperationalDatasetComponents otOperationalDatasetComponents

يمثل هذا الهيكل وجود مكونات مختلفة في مجموعة البيانات التشغيلية النشطة أو المعلقة.

otOperationalDatasetTlvs

struct otOperationalDatasetTlvs otOperationalDatasetTlvs

يمثل هذا الهيكل مجموعة بيانات تشغيلية نشطة أو معلقة.

تم ترميز مجموعة البيانات التشغيلية TLV كما هو محدد بواسطة مؤشر الترابط.

otPskc

struct otPskc otPskc

يمثل هذا الهيكل PSKc.

otPskcRef

otCryptoKeyRef otPskcRef

يمثل نوع البيانات هذا KeyRef إلى PSKc.

إشارة إلى المفتاح

otSecurityPolicy

struct otSecurityPolicy otSecurityPolicy

تمثل هذه البنية نهج الأمان.

المتغيرات

OT_TOOL_PACKED_END

OT_TOOL_PACKED_BEGIN struct otNetworkKey OT_TOOL_PACKED_END

المهام

otDatasetCreateNewNetwork

otError otDatasetCreateNewNetwork(
  otInstance *aInstance,
  otOperationalDataset *aDataset
)

تنشئ هذه الطريقة مجموعة بيانات تشغيلية جديدة لاستخدامها عند تكوين شبكة جديدة.

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
[out] aDataset
مجموعة البيانات التشغيلية.
إرجاع القيم
OT_ERROR_NONE
تم إنشاء مجموعة بيانات تشغيلية جديدة بنجاح.
OT_ERROR_FAILED
فشل إنشاء قيم عشوائية للمعلمات الجديدة.

otDatasetGeneratePskc

otError otDatasetGeneratePskc(
  const char *aPassPhrase,
  const otNetworkName *aNetworkName,
  const otExtendedPanId *aExtPanId,
  otPskc *aPskc
)

تنشئ هذه الوظيفة PSKc من عبارة مرور معينة واسم شبكة ومعرف PAN موسع.

يستخدم PSKc لتأسيس جلسة المفوض.

تفاصيل
العوامل
[in] aPassPhrase
عبارة مرور التكليف.
[in] aNetworkName
اسم الشبكة لحساب PSKc.
[in] aExtPanId
معرف PAN الممتد لحساب PSKc.
[out] aPskc
مؤشر إلى متغير لإخراج PSKc الذي تم إنشاؤه.
إرجاع القيم
OT_ERROR_NONE
تم إنشاء PSKc بنجاح.
OT_ERROR_INVALID_ARGS
إذا كانت أي من وسائط الإدخال غير صالحة.

otDatasetGetActive

otError otDatasetGetActive(
  otInstance *aInstance,
  otOperationalDataset *aDataset
)

تحصل هذه الوظيفة على مجموعة البيانات التشغيلية النشطة.

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
[out] aDataset
مؤشر إلى المكان الذي سيتم فيه وضع مجموعة البيانات التشغيلية النشطة.
إرجاع القيم
OT_ERROR_NONE
نجح في استرداد مجموعة البيانات التشغيلية النشطة.
OT_ERROR_NOT_FOUND
لا توجد قيمة مقابلة في مخزن الإعداد.

otDatasetGetActiveTlvs

otError otDatasetGetActiveTlvs(
  otInstance *aInstance,
  otOperationalDatasetTlvs *aDataset
)

تحصل هذه الوظيفة على مجموعة البيانات التشغيلية النشطة.

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
[out] aDataset
مؤشر إلى المكان الذي سيتم فيه وضع مجموعة البيانات التشغيلية النشطة.
إرجاع القيم
OT_ERROR_NONE
نجح في استرداد مجموعة البيانات التشغيلية النشطة.
OT_ERROR_NOT_FOUND
لا توجد قيمة مقابلة في مخزن الإعداد.

otDatasetGetDelayTimer الحد الأدنى

uint32_t otDatasetGetDelayTimerMinimal(
  otInstance *aInstance
)

احصل على الحد الأدنى من مؤقت التأخير.

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
إرجاع القيم
the
قيمة الحد الأدنى من مؤقت التأخير (بالمللي ثانية).

otDatasetGetPending

otError otDatasetGetPending(
  otInstance *aInstance,
  otOperationalDataset *aDataset
)

تحصل هذه الوظيفة على مجموعة البيانات التشغيلية المعلقة.

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
[out] aDataset
مؤشر إلى مكان وضع مجموعة البيانات التشغيلية المعلقة.
إرجاع القيم
OT_ERROR_NONE
تم بنجاح استرداد مجموعة البيانات التشغيلية المعلقة.
OT_ERROR_NOT_FOUND
لا توجد قيمة مقابلة في مخزن الإعداد.

otDatasetGetPendingTlvs

otError otDatasetGetPendingTlvs(
  otInstance *aInstance,
  otOperationalDatasetTlvs *aDataset
)

تحصل هذه الوظيفة على مجموعة البيانات التشغيلية المعلقة.

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
[out] aDataset
مؤشر إلى مكان وضع مجموعة البيانات التشغيلية المعلقة.
إرجاع القيم
OT_ERROR_NONE
تم بنجاح استرداد مجموعة البيانات التشغيلية المعلقة.
OT_ERROR_NOT_FOUND
لا توجد قيمة مقابلة في مخزن الإعداد.

otDatasetIsCommissioned

bool otDatasetIsCommissioned(
  otInstance *aInstance
)

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

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
عائدات
تكون القيمة TRUE في حالة وجود شبكة صالحة في مجموعة بيانات التشغيل النشطة ، وإلا فستكون خطأ.

otDatasetParseTlvs

otError otDatasetParseTlvs(
  const otOperationalDatasetTlvs *aDatasetTlvs,
  otOperationalDataset *aDataset
)

هذه الوظيفة بتوزيع مجموعة البيانات التشغيلية من otOperationalDatasetTlvs .

تفاصيل
العوامل
[in] aDatasetTlvs
مؤشر لمجموعة البيانات TLVs.
[out] aDataset
مؤشر إلى المكان الذي سيتم وضع مجموعة البيانات فيه.
إرجاع القيم
OT_ERROR_NONE
وضع بنجاح aDataset من aDatasetTlvs .
OT_ERROR_INVALID_ARGS
aDatasetTlvs غير صالح.

otDatasetSendMgmtActiveGet

otError otDatasetSendMgmtActiveGet(
  otInstance *aInstance,
  const otOperationalDatasetComponents *aDatasetComponents,
  const uint8_t *aTlvTypes,
  uint8_t aLength,
  const otIp6Address *aAddress
)

ترسل هذه الوظيفة MGMT_ACTIVE_GET.

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aDatasetComponents
مؤشر إلى بنية مكونات مجموعة البيانات يحدد المكونات المطلوب طلبها.
[in] aTlvTypes
سيتم طلب مؤشر إلى مصفوفة تحتوي على أنواع TLV خام إضافية.
[in] aLength
طول aTlvTypes .
[in] aAddress
مؤشر إلى وجهة IPv6 ، إذا كانت NULL ، سيستخدم Leader ALOC كافتراضي.
إرجاع القيم
OT_ERROR_NONE
أرسل الأمر meshcop dataset بنجاح.
OT_ERROR_NO_BUFS
مساحة المخزن المؤقت غير كافية للإرسال.

otDatasetSendMgmtActiveSet

otError otDatasetSendMgmtActiveSet(
  otInstance *aInstance,
  const otOperationalDataset *aDataset,
  const uint8_t *aTlvs,
  uint8_t aLength,
  otDatasetMgmtSetCallback aCallback,
  void *aContext
)

ترسل هذه الوظيفة MGMT_ACTIVE_SET.

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aDataset
مؤشر لمجموعة البيانات التشغيلية.
[in] aTlvs
مؤشر إلى TLVs.
[in] aLength
طول TLVs.
[in] aCallback
مؤشر لوظيفة يتم استدعاؤها عند استقبال الاستجابة أو انتهاء المهلة.
[in] aContext
مؤشر إلى سياق التطبيق محددة ل aCallback .
إرجاع القيم
OT_ERROR_NONE
أرسل الأمر meshcop dataset بنجاح.
OT_ERROR_NO_BUFS
مساحة المخزن المؤقت غير كافية للإرسال.
OT_ERROR_BUSY
طلب سابق مستمر.

otDatasetSendMgmtPendingGet

otError otDatasetSendMgmtPendingGet(
  otInstance *aInstance,
  const otOperationalDatasetComponents *aDatasetComponents,
  const uint8_t *aTlvTypes,
  uint8_t aLength,
  const otIp6Address *aAddress
)

ترسل هذه الوظيفة MGMT_PENDING_GET.

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aDatasetComponents
مؤشر إلى بنية مكونات مجموعة البيانات يحدد المكونات المطلوب طلبها.
[in] aTlvTypes
سيتم طلب مؤشر إلى مصفوفة تحتوي على أنواع TLV خام إضافية.
[in] aLength
طول aTlvTypes .
[in] aAddress
مؤشر إلى وجهة IPv6 ، إذا كانت NULL ، سيستخدم Leader ALOC كافتراضي.
إرجاع القيم
OT_ERROR_NONE
أرسل الأمر meshcop dataset بنجاح.
OT_ERROR_NO_BUFS
مساحة المخزن المؤقت غير كافية للإرسال.

otDatasetSendMgmtPendingSet

otError otDatasetSendMgmtPendingSet(
  otInstance *aInstance,
  const otOperationalDataset *aDataset,
  const uint8_t *aTlvs,
  uint8_t aLength,
  otDatasetMgmtSetCallback aCallback,
  void *aContext
)

ترسل هذه الوظيفة MGMT_PENDING_SET.

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aDataset
مؤشر لمجموعة البيانات التشغيلية.
[in] aTlvs
مؤشر إلى TLVs.
[in] aLength
طول TLVs.
[in] aCallback
مؤشر لوظيفة يتم استدعاؤها عند استقبال الاستجابة أو انتهاء المهلة.
[in] aContext
مؤشر إلى سياق التطبيق محددة ل aCallback .
إرجاع القيم
OT_ERROR_NONE
أرسل الأمر meshcop dataset بنجاح.
OT_ERROR_NO_BUFS
مساحة المخزن المؤقت غير كافية للإرسال.
OT_ERROR_BUSY
طلب سابق مستمر.

otDatasetSetActive

otError otDatasetSetActive(
  otInstance *aInstance,
  const otOperationalDataset *aDataset
)

تحدد هذه الوظيفة مجموعة البيانات التشغيلية النشطة.

إذا لم تتضمن مجموعة البيانات طابعًا زمنيًا نشطًا ، فستكون مجموعة البيانات مكتملة جزئيًا فقط.

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

إذا لم يتم تضمين القناة في مجموعة البيانات ، فسيرسل الجهاز رسائل إعلان MLE عبر قنوات مختلفة للعثور على الجيران على القنوات الأخرى.

إذا نجح الجهاز في الاتصال بشبكة مؤشرات الترابط ، فسيقوم الجهاز بعد ذلك باسترداد مجموعة البيانات النشطة الكاملة من أصله. لاحظ أن الجهاز الذي يدعم جهاز التوجيه لن ينتقل إلى أدوار جهاز التوجيه أو القائد حتى يكون لديه مجموعة بيانات نشطة كاملة.

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

otDatasetSetActiveTlvs

otError otDatasetSetActiveTlvs(
  otInstance *aInstance,
  const otOperationalDatasetTlvs *aDataset
)

تحدد هذه الوظيفة مجموعة البيانات التشغيلية النشطة.

إذا لم تتضمن مجموعة البيانات طابعًا زمنيًا نشطًا ، فستكون مجموعة البيانات مكتملة جزئيًا فقط.

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

إذا لم يتم تضمين القناة في مجموعة البيانات ، فسيرسل الجهاز رسائل إعلان MLE عبر قنوات مختلفة للعثور على الجيران على القنوات الأخرى.

إذا نجح الجهاز في الاتصال بشبكة مؤشرات الترابط ، فسيقوم الجهاز بعد ذلك باسترداد مجموعة البيانات النشطة الكاملة من أصله. لاحظ أن الجهاز الذي يدعم جهاز التوجيه لن ينتقل إلى أدوار جهاز التوجيه أو القائد حتى يكون لديه مجموعة بيانات نشطة كاملة.

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

otDatasetSetDelayTimer الحد الأدنى

otError otDatasetSetDelayTimerMinimal(
  otInstance *aInstance,
  uint32_t aDelayTimerMinimal
)

ضبط الحد الأدنى من تأخير الموقت.

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aDelayTimerMinimal
قيمة الحد الأدنى من مؤقت التأخير (بالمللي ثانية).
إرجاع القيم
OT_ERROR_NONE
تم بنجاح تعيين الحد الأدنى من مؤقت التأخير.
OT_ERROR_INVALID_ARGS
إذا aDelayTimerMinimal غير صالحة.

otDatasetSet معلق

otError otDatasetSetPending(
  otInstance *aInstance,
  const otOperationalDataset *aDataset
)

تحدد هذه الوظيفة مجموعة البيانات التشغيلية المعلقة.

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

otDatasetSetPendingTlvs

otError otDatasetSetPendingTlvs(
  otInstance *aInstance,
  const otOperationalDatasetTlvs *aDataset
)

تحدد هذه الوظيفة مجموعة البيانات التشغيلية المعلقة.

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

otDatasetUpdaterCancelUpdate

void otDatasetUpdaterCancelUpdate(
  otInstance *aInstance
)

تلغي هذه الوظيفة طلب تحديث مجموعة البيانات التشغيلية (إن وجد).

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.

otDatasetUpdaterIsUpdateOning

bool otDatasetUpdaterIsUpdateOngoing(
  otInstance *aInstance
)

تشير هذه الوظيفة إلى ما إذا كان هناك طلب جارٍ لتحديث مجموعة بيانات التشغيل.

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
إرجاع القيم
TRUE
هناك تحديث مستمر.
FALSE
لا يوجد تحديث مستمر.

otDatasetUpdaterRequestUpdate

otError otDatasetUpdaterRequestUpdate(
  otInstance *aInstance,
  const otOperationalDataset *aDataset,
  otDatasetUpdaterCallback aCallback,
  void *aContext
)

تطلب هذه الوظيفة تحديثًا لمجموعة البيانات التشغيلية.

aDataset يجب أن يحتوي على الحقول ليتم تحديثه والقيمة الجديدة. يجب ألا يحتوي على حقول الطابع الزمني النشطة أو المعلقة. حقل التأخير اختياري ، إذا لم يتم توفيره ، فسيتم استخدام قيمة افتراضية (1000 مللي ثانية).

تفاصيل
العوامل
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aDataset
مؤشر لمجموعة البيانات يحتوي على الحقول المطلوب تغييرها.
[in] aCallback
رد اتصال للإشارة إلى وقت انتهاء طلب تحديث مجموعة البيانات.
[in] aContext
تم تمرير سياق تعسفي إلى رد الاتصال.
إرجاع القيم
OT_ERROR_NONE
بدأت مجموعة بيانات التحديث بنجاح ( aCallback سيتم استدعاؤه على الانتهاء).
OT_ERROR_INVALID_STATE
الجهاز معطل (تم تعطيل MLE).
OT_ERROR_INVALID_ARGS
و aDataset غير صالح (يحتوي على نشطة أو قيد الطابع الزمني).
OT_ERROR_BUSY
لا يمكن بدء التحديث ، التحديث السابق مستمر.
OT_ERROR_NO_BUFS
تعذر تخصيص المخزن المؤقت لحفظ مجموعة البيانات.

otNetworkNameFromString

otError otNetworkNameFromString(
  otNetworkName *aNetworkName,
  const char *aNameString
)

تحدد هذه الدالة على otNetworkName المثال من لاغية نظرا إنهاء C سلسلة.

يؤكد هذه الوظيفة أيضا أن تعطى aNameString يلي UTF-8 ترميز وطوله لا يزيد عن OT_NETWORK_NAME_MAX_SIZE .

تفاصيل
العوامل
[out] aNetworkName
مؤشر إلى otNetworkName لتعيين.
[in] aNameString
سلسلة اسم ج.
إرجاع القيم
OT_ERROR_NONE
وضع بنجاح aNetworkName من aNameString .
OT_ERROR_INVALID_ARGS
aNameStrng غير صالح (طويل جدا أو لا يتبع UTF-8 الترميز).

وحدات الماكرو

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_MASK

 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_MASK

 OT_CHANNEL_5_MASK (1 << 5)

القناة 5.

OT_CHANNEL_6_MASK

 OT_CHANNEL_6_MASK (1 << 6)

القناة 6.

OT_CHANNEL_7_MASK

 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 لمؤشر الترابط (بايت)

OT_MESH_LOCAL_PREFIX_SIZE

 OT_MESH_LOCAL_PREFIX_SIZE OT_IP6_PREFIX_SIZE

حجم بادئة الشبكة المحلية (بايت)

OT_NETWORK_KEY_SIZE

 OT_NETWORK_KEY_SIZE 16

حجم مفتاح شبكة مؤشر الترابط (بايت)

OT_NETWORK_NAME_MAX_SIZE

 OT_NETWORK_NAME_MAX_SIZE 16

الحد الأقصى لحجم حقل اسم شبكة مؤشر الترابط (بايت)

OT_OPERATIONAL_DATASET_MAX_LENGTH

 OT_OPERATIONAL_DATASET_MAX_LENGTH 254

الحد الأقصى لطول مجموعة البيانات التشغيلية بالبايت.

OT_PSKC_MAX_SIZE

 OT_PSKC_MAX_SIZE 16

الحد الأقصى لحجم PSKc (بايت)