TREL

تتضمن هذه الوحدة تجريد النظام الأساسي لوصلة تغليف راديو الخيط (TREL) باستخدام واجهة IPv6 / UDP.

ملخص

المهام
`otPlatTrelUdp6HandleReceived ( otInstance aInstance, uint8_t aBuffer, uint16_t aLength)`	`void` هذه الوظيفة عبارة عن رد اتصال من النظام الأساسي لإخطار الحزمة المستلمة.
`otPlatTrelUdp6Init ( otInstance aInstance, const otIp6Address aUnicastAddress, uint16_t aUdpPort)`	`void` تعمل هذه الوظيفة على تهيئة واجهة TREL IPv6 / UDP.
`otPlatTrelUdp6SendTo ( otInstance aInstance, const uint8_t aBuffer, uint16_t aLength, const otIp6Address *aDestAddress)`	`otError` تطلب هذه الوظيفة حزمة لإرسالها إلى وجهة معينة.
`otPlatTrelUdp6SetTestMode ( otInstance *aInstance, bool aEnable)`	`otError` هذه الوظيفة الاختيارية مخصصة للاختبار فقط.
`otPlatTrelUdp6SubscribeMulticastAddress ( otInstance aInstance, const otIp6Address aMulticastAddress)`	`void` تشترك هذه الوظيفة في واجهة TREL IPv6 / UDP في عنوان الإرسال المتعدد الجديد.
`otPlatTrelUdp6UpdateAddress ( otInstance aInstance, const otIp6Address aUnicastAddress)`	`void` تقوم هذه الوظيفة بتحديث عنوان IPv6 أحادي الإرسال لواجهة TREL IPv6 / UDP.

المهام

تم استلام otPlatTrelUdp6Handle

void otPlatTrelUdp6HandleReceived(
  otInstance *aInstance,
  uint8_t *aBuffer,
  uint16_t aLength
)

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

ملاحظة: قد يتم تغيير محتوى المخزن المؤقت (حتى طوله المحدد) أثناء المعالجة بواسطة OpenThread core (على سبيل المثال ، فك التشفير في مكانه) ، لذلك يجب أن يتوقع تطبيق النظام الأساسي أنه بعد العودة من هذه الوظيفة ، قد يتم تغيير محتوى الحزمة aBuffer .

تفاصيل

المعلمات

`[in] aInstance`	بنية مثيل OpenThread.
`[in] aBuffer`	مخزن مؤقت يحتوي على الحزمة المستلمة.
`[in] aLength`	طول الحزمة (عدد البايتات).

otPlatTrelUdp6Init

void otPlatTrelUdp6Init(
  otInstance *aInstance,
  const otIp6Address *aUnicastAddress,
  uint16_t aUdpPort
)

تعمل هذه الوظيفة على تهيئة واجهة TREL IPv6 / UDP.

يتم استدعاء هذه الوظيفة قبل أي وظائف أخرى لمنصة TREL.

تفاصيل

المعلمات

`[in] aInstance`	بنية مثيل OpenThread.
`[in] aUnicastAddress`	عنوان الإرسال الأحادي المراد إضافته إلى الواجهة واستخدامه كمصدر tx ووجهة rx.
`[in] aUdpPort`	رقم منفذ UDP المراد استخدامه.

otPlatTrelUdp6 إرسال إلى

otError otPlatTrelUdp6SendTo(
  otInstance *aInstance,
  const uint8_t *aBuffer,
  uint16_t aLength,
  const otIp6Address *aDestAddress
)

تطلب هذه الوظيفة حزمة لإرسالها إلى وجهة معينة.

تفاصيل

المعلمات

`[in] aInstance`	بنية مثيل OpenThread.
`[in] aBuffer`	مؤشر إلى مخزن مؤقت يحتوي على الحزمة المراد إرسالها.
`[in] aLength`	طول الحزمة (عدد البايتات).
`[in] aDestAddress`	عنوان IPv6 الوجهة (يمكن أن يكون عنوان بث أحادي أو متعدد IPv6).

إرجاع القيم

`OT_ERROR_NONE`	تم التعامل مع طلب tx بنجاح.
`OT_ERROR_ABORT`	الواجهة غير جاهزة وتم إحباط tx

otPlatTrelUdp6SetTestMode

otError otPlatTrelUdp6SetTestMode(
  otInstance *aInstance,
  bool aEnable
)

هذه الوظيفة الاختيارية مخصصة للاختبار فقط.

يغير حالة وضع الاختبار لواجهة TREL.

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

يتم توفير تطبيق افتراضي ضعيف لهذه الطريقة بواسطة OpenThread (مع إرجاع NOT_IMPLEMENTED).

تفاصيل

المعلمات

`[in] aInstance`	بنية مثيل OpenThread.
`[in] aEnable`	يشير إلى ما إذا كان سيتم تمكين / تعطيل واجهة TREL.

إرجاع القيم

`OT_ERROR_NONE`	تم بنجاح تغيير حالة اختبار واجهة TREL (ممكّن / معطل).
`OT_ERROR_NOT_IMPLEMENTED`	لا توفر المنصة هذه الوظيفة.

otPlatTrelUdp6SubscribeMulticastAddress

void otPlatTrelUdp6SubscribeMulticastAddress(
  otInstance *aInstance,
  const otIp6Address *aMulticastAddress
)

تشترك هذه الوظيفة في واجهة TREL IPv6 / UDP في عنوان الإرسال المتعدد الجديد.

يمكن استدعاء هذه الوظيفة عدة مرات للاشتراك في عناوين مختلفة. يجب أن تقبل الواجهة / تستقبل الحزم الموجهة إلى أي عنوان إرسال متعدد مشترك مسبقًا بالإضافة إلى عنوان الإرسال الأحادي المضاف من وظيفة otPlatTrelUdp6Init() عند تهيئة الواجهة.

تفاصيل

المعلمات

`[in] aInstance`	بنية مثيل OpenThread.
`[in] aMulticastAddress`	عنوان IPv6 متعدد البث.

otPlatTrelUdp6UpdateAddress

void otPlatTrelUdp6UpdateAddress(
  otInstance *aInstance,
  const otIp6Address *aUnicastAddress
)

تعمل هذه الوظيفة على تحديث عنوان IPv6 أحادي الإرسال لواجهة TREL IPv6 / UDP.

يجب أن تحتوي الواجهة على عنوان IPv6 أحادي الإرسال. يؤدي استدعاء هذه الوظيفة إلى استبدال أي عنوان IPv6 أحادي الإرسال تم تعيينه مسبقًا (أثناء التهيئة من otPlatTrelUdp6Init أو المكالمات السابقة إلى otPlatTrelUdp6UpdateAddress() ).

تفاصيل

المعلمات

`[in] aInstance`	بنية مثيل OpenThread.
`[in] aUnicastAddress`	عنوان الإرسال الأحادي المراد إضافته إلى الواجهة واستخدامه كمصدر tx ووجهة rx.