Google is committed to advancing racial equity for Black communities. See how.
ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

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)
تطلب هذه الوظيفة حزمة لإرسالها إلى وجهة معينة.
otPlatTrelUdp6SetTestMode ( otInstance *aInstance, bool aEnable)
هذه الوظيفة الاختيارية مخصصة للاختبار فقط.
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
)

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

تفاصيل
المعلمات
[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.