Tổng quan về OpenThread CLI

Xem nguồn trên GitHub

OpenThread CLI hiển thị các API cấu hình và quản lý từ một giao diện dòng lệnh. Sử dụng OT CLI để tạo quá trình phát triển OpenThread hoặc sử dụng công cụ đó như một công cụ có mã xử lý ứng dụng bổ sung. Ví dụ: OpenThread tập lệnh kiểm thử sử dụng CLI để thực thi các trường hợp kiểm thử.

Bắt đầu

Hoàn thành Lớp học lập trình mô phỏng bằng Docker và xem lại Tài liệu tham khảo về lệnh CLI.

Chuyển đến Lớp học lập trình mô phỏng Chuyển đến Tài liệu tham khảo về lệnh CLI

Sử dụng OT CLI

Bạn có thể sử dụng OT CLI với các thiết bị OpenThread Border Router (OTBR) và Thread. CLI sẽ khác nhau tuỳ thuộc vào loại thiết bị và cờ bản dựng.

Bù giờ

Để sử dụng OT CLI với OTBR, hãy nhập thông tin sau trước mỗi lệnh:

sudo ot-ctl

Thiết bị Thread

Để sử dụng các lệnh CLI trên thiết bị Thread, hãy tham khảo tài liệu về nền tảng, lớp học lập trình hoặc tài liệu hướng dẫn. Trong nhiều ví dụ, bạn có thể bắt đầu nhập các lệnh mà không cần tiền tố:

state
router
Done

Dưới đây là một số tài nguyên giúp bạn bắt đầu:

Các ký tự đặc biệt

Ký tự khoảng trắng (' ') được dùng để phân cách tên lệnh và các đối số khác nhau, cùng với thẻ ('\t') và ký tự dòng mới ('\r', '\n').

Một số đối số có thể chứa dấu cách, ví dụ như tên mạng Thread. Người nhận gửi đối số có bao gồm dấu cách, sử dụng ký tự dấu gạch chéo ngược ('\') để dấu phân cách thoát hoặc chính dấu gạch chéo ngược:

networkname Test\ Network
Done
networkname
Test Network
Done

Liên kết đối số

OT CLI sử dụng các đối số được xác định trước tương ứng với các giá trị cấu hình API. Các ánh xạ có thể được truyền bằng lệnh CLI và cũng có thể trả về CLI cho các lệnh Dữ liệu mạng khác nhau, ví dụ: chương trình netdata.

otBorderRouterConfig

Một số lệnh (ví dụ: prefix add) yêu cầu otBorderRouterConfig giá trị. Để thiết lập các thành viên của otBorderRouterConfig từ dòng lệnh, hãy thực hiện thao tác OT CLI phân tích cú pháp một đối số chữ cái được ánh xạ cho từng thành phần. Ví dụ: đối số tổ hợp paros đặt mPreferred, mSlaac, mDefaultRoute, mOnMesh, và mStable thành viên.

Cú pháp

Trong ví dụ sau, bạn bắt buộc phải sử dụng prefix, và otBorderRouterConfig các đối số không bắt buộc, được ánh xạ dưới dạng p, a, d, c, r, o, s, n và D:

prefix add prefix [padcrosnD]

Cách sử dụng

Để sử dụng chế độ ánh xạ đối số, đừng nhập dấu cách giữa các chữ cái:

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

otRoutePreference

Để đặt otRoutePreference, sử dụng high, med hoặc low trong các lệnh OT CLI.

Cú pháp

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

Cách sử dụng

Sau đây là ví dụ về cách sử dụng otBorderRouterConfig và otRoutePreference được liên kết thông số:

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

otExternalRouteConfig

Đối với otExternalRouteConfig nên s ánh xạ tới mStable và n ánh xạ tới mNat64.

Cú pháp

publish route prefix [sn]

Cách sử dụng

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

Giá trị trả về

Hầu hết các lệnh đều trả về giá trị được yêu cầu, theo sau là Done:

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

Các lệnh khác bao gồm Dữ liệu mạng có thể trả về liên kết đối số cho các bản ghi tiền tố, tuyến và dịch vụ. Để biết thêm thông tin, hãy tham khảo Hiển thị và quản lý dữ liệu mạng bằng OT CLI.