يعرض سطر الأوامر لواجهة برمجة التطبيقات واجهة برمجة تطبيقات التهيئة والإدارة من واجهة سطر أوامر. استخدم سطر الأوامر OTC لإنشاء بيئة تطوير OpenThread، أو استخدمه كأداة ذات رمز تطبيق إضافي. على سبيل المثال، تستخدم النصوص البرمجية للاختبار في OpenThread واجهة سطر الأوامر لتنفيذ حالات الاختبار.
البدء
أكمِل الدرس التطبيقي حول Codelab Codelabs باستخدام Docker وراجِع مرجع أوامر CLI.
انتقِل إلى الدرس التطبيقي حول الترميز. انتقِل إلى مرجع أوامر سطر الأوامر (CLI).
استخدام سطر الأوامر (OTC)
يمكنك استخدام واجهة سطر الأوامر (OTC) مع جهاز توجيه حدود سلسلة المحادثات (OTBR) وأجهزة Thread. تختلف أوامر سطر الأوامر (CLI) بناءً على نوع جهازك وعلامات الإصدار.
OTBR
لاستخدام سطر الأوامر (OTC) مع OTBR، أدخِل البادئة التالية قبل كل أمر:
sudo ot-ctl
أجهزة سلسلة المحادثات
لاستخدام أوامر CLI على جهاز Thread، يُرجى الرجوع إلى وثائق النظام الأساسي أو الدرس التطبيقي حول الترميز أو الدليل. بالنسبة إلى العديد من الأمثلة، يمكنك بدء كتابة الأوامر بدون بادئة:
state
router
Done
وفي ما يلي بعض الموارد لمساعدتك في البدء:
- مراجعة منصّات OpenThread
- الدرس التطبيقي حول الترميز في بلدان الشمال الأوروبي
- معمل ترميز أجهزة مختبرات السيليكون
- أمثلة على المنصّات على GitHub
الأحرف الخاصة
يتم استخدام حرف المسافة البيضاء (' '
) لتحديد اسم الأمر والوسيطات المختلفة، بالإضافة إلى علامة التبويب ('\t'
) والحروف الجديدة في السطرين ('\r'
و'\n'
).
قد تحتوي بعض الوسيطات على مسافات، على سبيل المثال، اسم شبكة Thread. لإرسال الوسيطات التي تتضمن مسافات، استخدم الشرطة المائلة للخلف ('\'
) لتخطي الفواصل أو الشرطة المائلة للخلف نفسها:
networkname Test\ Network
Donenetworkname
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).