نظرة عامة على واجهة برمجة تطبيقات واجهة برمجة تطبيقات OpenThread

عرض المصدر على GitHub

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

البدء

أكمِل الدرس التطبيقي حول Codelab Codelabs باستخدام Docker وراجِع مرجع أوامر CLI.

انتقِل إلى الدرس التطبيقي حول الترميز. انتقِل إلى مرجع أوامر سطر الأوامر (CLI).

استخدام سطر الأوامر (OTC)

يمكنك استخدام واجهة سطر الأوامر (OTC) مع جهاز توجيه حدود سلسلة المحادثات (OTBR) وأجهزة Thread. تختلف أوامر سطر الأوامر (CLI) بناءً على نوع جهازك وعلامات الإصدار.

OTBR

لاستخدام سطر الأوامر (OTC) مع OTBR، أدخِل البادئة التالية قبل كل أمر:

sudo ot-ctl

أجهزة سلسلة المحادثات

لاستخدام أوامر CLI على جهاز Thread، يُرجى الرجوع إلى وثائق النظام الأساسي أو الدرس التطبيقي حول الترميز أو الدليل. بالنسبة إلى العديد من الأمثلة، يمكنك بدء كتابة الأوامر بدون بادئة:

state
router
Done

وفي ما يلي بعض الموارد لمساعدتك في البدء:

الأحرف الخاصة

يتم استخدام حرف المسافة البيضاء (' ') لتحديد اسم الأمر والوسيطات المختلفة، بالإضافة إلى علامة التبويب ('\t') والحروف الجديدة في السطرين ('\r' و'\n').

قد تحتوي بعض الوسيطات على مسافات، على سبيل المثال، اسم شبكة Thread. لإرسال الوسيطات التي تتضمن مسافات، استخدم الشرطة المائلة للخلف ('\') لتخطي الفواصل أو الشرطة المائلة للخلف نفسها:

networkname Test\ Network
Done
networkname
Test Network
Done

تعيينات الوسيطة

يستخدم OT CLI وسيطات محددة مسبقًا تتوافق مع قيم تهيئة واجهة برمجة التطبيقات. يمكن تمرير عمليات التعيين هذه باستخدام أوامر واجهة سطر الأوامر، وقد تعود أيضًا إلى وحدة تحكم سطر الأوامر لأوامر بيانات الشبكة المتنوعة، على سبيل المثال، netdata show.

otBorderRouterConfig

تتطلب بعض الأوامر، على سبيل المثال prefix add، قيم otBorderRouterConfig. لضبط otBorderRouterConfig عضو من سطر الأوامر، يحلّل OTCLI وسيطة حرف معيّنة لكل عضو. على سبيل المثال، تُعين مجموعة الوسيطات paros الأعضاء المفضّلين mPreference وmSlaac وmDefaultRoute وMMMesh وMStable على التوالي.

البنية

في المثال التالي، prefix مطلوب، والوسيطات otBorderRouterConfig اختيارية وتم تعيينها على أنها p وa وd وc وr وo وs وn وD:

prefix add prefix [padcrosnD]

الاستخدام

لاستخدام تعيينات الوسيطات، لا تدخل مسافات بين الأحرف:

prefix add 2001:dead:beef:cafe::/64 paros

otRoutePreference

لضبط otRoutePreference، استخدم high أو med أو low في أوامر OT CLI.

البنية

prefix add prefix [padcrosnD] [high|med|low]

الاستخدام

في ما يلي مثال على استخدام المَعلمتَين otBorderRouterConfig وotRoutePreference اللذين تم ربطهما:

prefix add 2001:dead:beef:cafe::/64 paros med
Done

otExternalRouteConfig

بالنسبة إلى قيم otExternalRouteConfig، يتم ربط s بخريطة mStable وn إلى mNat64.

البنية

publish route prefix [sn]

الاستخدام

route add 2001:dead:beef:cafe::/64 s
Done

عرض القيم

تعرض معظم الأوامر القيمة المطلوبة، متبوعةً بـ Done:

br onlinkprefix
fd41:2650:a6f5:0::/64
Done

قد تعرض الأوامر الأخرى التي تتضمن بيانات الشبكة تعيينات الوسيطات لسجلات البادئة والمسار والخدمة. لمزيد من المعلومات، يُرجى الرجوع إلى عرض بيانات الشبكة وإدارتها باستخدام سطر الأوامر (OTC).