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

تشتمل هذه الوحدة على وظائف تتحكم في تنفيذ حزمة Thread.

ملخّص

تحديدات النوع
otNcpDelegateAllowPeekPoke)(uint32_t aAddress, uint16_t aCount)	typedef bool(* تحدد هذه السمة نوع التفويض (مؤشر دالة) للتحكم في سلوك التشغيل الخاطف/الخاطفة.
otNcpHdlcSendCallback)(const uint8_t *aBuf, uint16_t aBufLength)	typedef int(* يتم استدعاء المؤشر لإرسال بيانات NCP مشفّرة بدقة عالية.

الدوال
otNcpHdlcInit(otInstance *aInstance, otNcpHdlcSendCallback aSendCallback)	void تهيئة NCP استنادًا إلى إطارات HDLC
otNcpHdlcInitMulti(otInstance **aInstance, uint8_t aCount, 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 باستخدام otNcpStreamWrite.
otNcpRegisterPeekPokeDelegates(otNcpDelegateAllowPeekPoke aAllowPeekDelegate, otNcpDelegateAllowPeekPoke aAllowPokeDelegate)	void لتسجيل وظائف التفويض الخاطفة/الخاطفة مع وحدة NCP.
otNcpSpiInit(otInstance *aInstance)	void إعداد NCP استنادًا إلى إطارات واجهة SPI.
otNcpStreamWrite(int aStreamId, const uint8_t *aDataPtr, int aDataLen)	otError إرسال البيانات إلى المضيف من خلال مصدر بيانات محدّد

تحديدات النوع

otNcpDelegateAllowPeekPoke

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

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

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

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

otNcpHdlcSendCallback

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

يتم استدعاء المؤشر لإرسال بيانات NCP مشفّرة بدقة عالية.

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

الدوال

otNcpHdlcInit

void otNcpHdlcInit(
  otInstance *aInstance,
  otNcpHdlcSendCallback aSendCallback
)

تهيئة NCP استنادًا إلى إطارات HDLC

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

otNcpHdlcInitMulti

void otNcpHdlcInitMulti(
  otInstance **aInstance,
  uint8_t aCount,
  otNcpHdlcSendCallback aSendCallback
)

تهيئة NCP استنادًا إلى إطارات HDLC

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

otNcpHdlcReceive

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 باستخدام otNcpStreamWrite.

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

otNcpRegisterPeekPokeDelegates

void otNcpRegisterPeekPokeDelegates(
  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 غير صفرية، يجب ألا تكون هذه المعلَمة فارغة. [in] aDataLen عدد وحدات بايت البيانات من aDataPtr المطلوب إرسالها.
قيم الإرجاع	OT_ERROR_NONE تمت إضافة البيانات إلى قائمة الانتظار للتسليم إلى المضيف. OT_ERROR_BUSY لا تتوفّر موارد كافية لإكمال هذا الطلب. عادة ما تكون هذه حالة مؤقتة. OT_ERROR_INVALID_ARGS قيمة aStreamId المحددة غير صالحة.

المراجِع

تنشأ المواضيع المرجعية لواجهة برمجة تطبيقات OpenThread من رمز المصدر المتاح على GitHub. للحصول على مزيد من المعلومات أو للمساهمة في مستنداتنا، يمكنك الاطّلاع على المراجع.