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

المعالج المساعد للشبكة

تتضمن هذه الوحدة الوظائف التي تتحكم في تنفيذ مكدس الخيط.

ملخص

النوع

otNcpDelegateAllowPeekPoke )(uint32_t aAddress, uint16_t aCount) typedef
bool(*
يحدد نوع المفوض (مؤشر الوظيفة) للتحكم في سلوك عملية نظرة خاطفة / نقرة.
otNcpHandlerJoinLegacyNode )(const otExtAddress *aExtAddress) typedef
void(*
يحدد نوع المعالج (مؤشر الوظيفة) لبدء عملية الانضمام.
otNcpHandlerSetLegacyUlaPrefix )(const uint8_t *aUlaPrefix) typedef
void(*
يحدد نوع المعالج (مؤشر الوظيفة) لتعيين بادئة ULA القديمة.
otNcpHandlerStartLegacy )(void) typedef
void(*
يحدد نوع المعالج (مؤشر الوظيفة) لبدء الشبكة القديمة.
otNcpHandlerStopLegacy )(void) typedef
void(*
يحدد نوع المعالج (مؤشر الوظيفة) لإيقاف الشبكة القديمة.
otNcpHdlcSendCallback )(const uint8_t *aBuf, uint16_t aBufLength) typedef
int(*
يتم استدعاء مؤشر الوظيفة هذا لإرسال بيانات NCP المشفرة لـ HDLC.
otNcpLegacyHandlers typedef
يعرّف بنية تحتوي على جميع المعالجات القديمة (مؤشرات الوظيفة).

المهام

otNcpHandleDidReceiveNewLegacyUlaPrefix (const uint8_t *aUlaPrefix)
void
يتم استدعاء رد الاتصال هذا بواسطة المكدس القديم للإبلاغ عن تغيير بادئة ULA القديمة.
otNcpHandleLegacyNodeDidJoin (const otExtAddress *aExtAddr)
void
يتم استدعاء رد الاتصال هذا بواسطة المكدس القديم للإبلاغ عن انضمام عقدة قديمة جديدة إلى الشبكة.
otNcpHdlcInit ( otInstance *aInstance, otNcpHdlcSendCallback aSendCallback)
void
قم بتهيئة NCP استنادًا إلى تأطير HDLC.
otNcpHdlcReceive (const uint8_t *aBuf, uint16_t aBufLength)
void
تسمى هذه الوظيفة بعد تلقي بيانات NCP المشفرة بواسطة HDLC.
otNcpHdlcSendDone (void)
void
يتم استدعاء هذه الوظيفة بعد انتهاء إرسال NCP.
otNcpPlatLogv ( otLogLevel aLogLevel, otLogRegion aLogRegion, const char *aFormat, va_list aArgs)
void
يكتب OpenThread Log باستخدام otNcpStreamWrite .
otNcpRegisterLegacyHandlers (const otNcpLegacyHandlers *aHandlers)
void
تسجل هذه الطريقة مجموعة من المعالجات القديمة باستخدام NCP.
otNcpRegisterPeekPokeDelagates ( otNcpDelegateAllowPeekPoke aAllowPeekDelegate, otNcpDelegateAllowPeekPoke aAllowPokeDelegate)
void
تسجل هذه الطريقة وظائف مندوب نظرة خاطفة / نقرة باستخدام الوحدة النمطية NCP.
otNcpSpiInit ( otInstance *aInstance)
void
قم بتهيئة NCP استنادًا إلى تأطير SPI.
otNcpStreamWrite (int aStreamId, const uint8_t *aDataPtr, int aDataLen)
إرسال البيانات إلى المضيف عبر دفق معين.

الهياكل

otNcpLegacyHandlers

يعرّف بنية تحتوي على جميع المعالجات القديمة (مؤشرات الوظيفة).

النوع

otNcpDelegateAllowPeekPoke

bool(* otNcpDelegateAllowPeekPoke)(uint32_t aAddress, uint16_t aCount)

يحدد نوع المفوض (مؤشر الوظيفة) للتحكم في سلوك عملية نظرة خاطفة / نقرة.

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

تفاصيل
المعلمات
[in] aAddress
بدء عنوان منطقة الذاكرة.
[in] aCount
عدد البايت المطلوب إلقاء نظرة خاطفة عليه أو إلقاء نظرة خاطفة عليه.
عائدات
TRUE للسماح بإلقاء نظرة خاطفة / نقرة على منطقة الذاكرة المحددة ، وإلا فالخطأ.

otNcpHandlerJoinLegacyNode

void(* otNcpHandlerJoinLegacyNode)(const otExtAddress *aExtAddress)

يحدد نوع المعالج (مؤشر الوظيفة) لبدء عملية الانضمام.

تم استدعاؤه لبدء إجراء ربط قديم لأي عقدة أو عقدة معينة.

تفاصيل
المعلمات
[in] aExtAddress
مؤشر إلى العنوان الممتد للعقدة للانضمام أو NULL إذا رغبت في الانضمام إلى أي عقدة مجاورة.

otNcpHandlerSetLegacyUlaPrefix

void(* otNcpHandlerSetLegacyUlaPrefix)(const uint8_t *aUlaPrefix)

يحدد نوع المعالج (مؤشر الوظيفة) لتعيين بادئة ULA القديمة.

تم الاستدعاء لتعيين بادئة ULA القديمة.

تفاصيل
المعلمات
[in] aUlaPrefix
مؤشر إلى المخزن المؤقت الذي يحتوي على بادئة ULA القديمة.

otNcpHandlerStartLegacy

void(* otNcpHandlerStartLegacy)(void)

يحدد نوع المعالج (مؤشر الوظيفة) لبدء الشبكة القديمة.

تم الاستدعاء لبدء الشبكة القديمة.

otNcpHandlerStopLegacy

void(* otNcpHandlerStopLegacy)(void)

يحدد نوع المعالج (مؤشر الوظيفة) لإيقاف الشبكة القديمة.

تم استدعاؤه لإيقاف الشبكة القديمة.

otNcpHdlcSendCallback

int(* otNcpHdlcSendCallback)(const uint8_t *aBuf, uint16_t aBufLength)

يتم استدعاء مؤشر الوظيفة هذا لإرسال بيانات NCP المشفرة لـ HDLC.

تفاصيل
المعلمات
[in] aBuf
مؤشر إلى مخزن مؤقت مع إخراج.
[in] aBufLength
طول بيانات الإخراج المخزنة في المخزن المؤقت.
عائدات
عدد البايتات التي تمت معالجتها بواسطة رد الاتصال.

otNcpLegacyHandlers

struct otNcpLegacyHandlers otNcpLegacyHandlers

يعرّف بنية تحتوي على جميع المعالجات القديمة (مؤشرات الوظيفة).

المهام

otNcpHandleDidReceiveNewLegacyUlaPrefix

void otNcpHandleDidReceiveNewLegacyUlaPrefix(
  const uint8_t *aUlaPrefix
)

يتم استدعاء رد الاتصال هذا بواسطة المكدس القديم للإبلاغ عن تغيير بادئة ULA القديمة.

تفاصيل
المعلمات
[in] aUlaPrefix
مؤشر إلى بادئة ULA المستلمة.

otNcpHandleLegacyNodeDidJoin

void otNcpHandleLegacyNodeDidJoin(
  const otExtAddress *aExtAddr
)

يتم استدعاء رد الاتصال هذا بواسطة المكدس القديم للإبلاغ عن انضمام عقدة قديمة جديدة إلى الشبكة.

تفاصيل
المعلمات
[in] aExtAddr
مؤشر إلى العنوان الممتد للعقدة المنضمة.

otNcpHdlcInit

void otNcpHdlcInit(
  otInstance *aInstance,
  otNcpHdlcSendCallback aSendCallback
)

قم بتهيئة NCP استنادًا إلى تأطير HDLC.

تفاصيل
المعلمات
[in] aInstance
بنية مثيل OpenThread.
[in] aSendCallback
مؤشر الوظيفة المستخدم لإرسال بيانات NCP.

otNcpHdlc تلقي

void otNcpHdlcReceive(
  const uint8_t *aBuf,
  uint16_t aBufLength
)

تسمى هذه الوظيفة بعد تلقي بيانات NCP المشفرة بواسطة HDLC.

تفاصيل
المعلمات
[in] aBuf
مؤشر إلى المخزن المؤقت.
[in] aBufLength
طول البيانات المخزنة في المخزن المؤقت.

otNcpHdlcSendDone

void otNcpHdlcSendDone(
  void
)

يتم استدعاء هذه الوظيفة بعد انتهاء إرسال NCP.

otNcpPlatLogv

void otNcpPlatLogv(
  otLogLevel aLogLevel,
  otLogRegion aLogRegion,
  const char *aFormat,
  va_list aArgs
)

يكتب OpenThread Log باستخدام otNcpStreamWrite .

تفاصيل
المعلمات
[in] aLogLevel
مستوى السجل.
[in] aLogRegion
منطقة السجل.
[in] aFormat
مؤشر لسلسلة التنسيق.
[in] aArgs
va_list مطابقة تنسيق.

otNcpRegisterLegacyHandlers

void otNcpRegisterLegacyHandlers(
  const otNcpLegacyHandlers *aHandlers
)

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

يتم استخدام مجموعة المعالجات التي يوفرها aHandlers بواسطة كود NCP لبدء / إيقاف الشبكة القديمة. يمكن أن تكون aHandlers فارغة لتعطيل الدعم القديم على NCP. يمكن أيضًا أن تكون المعالجات الفردية في بنية المعالجات المحددة فارغة.

تفاصيل
المعلمات
[in] aHandlers
مؤشر إلى هيكل معالج.

otNcpRegisterPeekPokeDelagates

void otNcpRegisterPeekPokeDelagates(
  otNcpDelegateAllowPeekPoke aAllowPeekDelegate,
  otNcpDelegateAllowPeekPoke aAllowPokeDelegate
)

تسجل هذه الطريقة وظائف مندوب نظرة خاطفة / نقرة باستخدام الوحدة النمطية NCP.

يتم استدعاء وظائف المندوب بواسطة وحدة NCP لتحديد ما إذا كان سيتم السماح بإلقاء نظرة خاطفة أو نقرة لمنطقة ذاكرة معينة. إذا تم تعيين مؤشر المفوض على NULL ، فإنه يسمح بعملية نظرة خاطفة / نقرة لأي عنوان.

تفاصيل
المعلمات
[in] aAllowPeekDelegate
تفويض مؤشر الوظيفة لعملية نظرة خاطفة.
[in] aAllowPokeDelegate
تفويض مؤشر الوظيفة لعملية الوخز.

otNcpSpiInit

void otNcpSpiInit(
  otInstance *aInstance
)

قم بتهيئة NCP استنادًا إلى تأطير SPI.

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

otNcpStreamWrite

otError otNcpStreamWrite(
  int aStreamId,
  const uint8_t *aDataPtr,
  int aDataLen
)

إرسال البيانات إلى المضيف عبر دفق معين.

تحاول هذه الوظيفة إرسال البيانات المعطاة إلى المضيف باستخدام aStreamId المحدد. هذا مفيد للإبلاغ عن رسائل الخطأ ، وتنفيذ وحدات تحكم التصحيح / التشخيص ، وربما أنواع أخرى من داتاستريم.

إما أن يتم قبول الكتابة بالكامل أو رفضها. لم تتم محاولة الكتابة الجزئية.

تفاصيل
المعلمات
[in] aStreamId
معرّف رقمي للتدفق المراد الكتابة إليه. إذا تم التعيين على "0" ، فسيتم تعيينه افتراضيًا على تدفق التصحيح.
[in] aDataPtr
مؤشر إلى البيانات المراد إرسالها في الدفق. إذا كانت aDataLen ليست صفرية ، فيجب ألا تكون هذه المعلمة NULL.
[in] aDataLen
عدد وحدات بايت البيانات المراد إرسالها من aDataPtr.
إرجاع القيم
OT_ERROR_NONE
تم وضع البيانات في قائمة الانتظار لتسليمها إلى المضيف.
OT_ERROR_BUSY
لا توجد موارد كافية لإكمال هذا الطلب. عادة ما تكون هذه حالة مؤقتة.
OT_ERROR_INVALID_ARGS
aStreamId المحدد غير صالح.

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

OT_NCP_LEGACY_ULA_PREFIX_LENGTH

 OT_NCP_LEGACY_ULA_PREFIX_LENGTH 8

حجم ULA القديم (بالبايت)