Tổng quan về CLI của OpenThread

Xem nguồn trên GitHub

OpenThread CLI hiển thị các API cấu hình và quản lý từ giao diện dòng lệnh. Sử dụng OT CLI để tạo môi trường phát triển OpenThread hoặc sử dụng công cụ này làm công cụ cùng với mã xử lý ứng dụng bổ sung. Ví dụ: các tập lệnh kiểm thử OpenThread 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 của chúng tôi 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 qua các bộ định tuyến đường viền OpenThread (OTBR) và luồng Thread. Các lệnh CLI sẽ khác nhau tuỳ thuộc vào loại thiết bị và cờ bản dựng.

Thêm giờ

Để sử dụng OT CLI bằng OTBR, hãy nhập tiền tố sau đây trước mỗi lệnh:

sudo ot-ctl

Thiết bị theo chuỗi

Để sử dụng các lệnh CLI trên thiết bị luồng, hãy tham khảo tài liệu về nền tảng, lớp học lập trình hoặc hướng dẫn. Để xem nhiều ví dụ, bạn có thể bắt đầu nhập các lệnh không có 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 (' ') dùng để phân biệt tên lệnh và các đối số khác nhau, cùng với thẻ ('\t') và các ký tự dòng mới ('\r', '\n').

Một số đối số có thể bao gồm dấu cách, chẳng hạn như tên mạng Chuỗi. Để gửi các đối số bao gồm dấu cách, hãy sử dụng ký tự dấu gạch chéo ngược ('\') để thoát khỏi dấu phân tách hoặc 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 mục ánh xạ này có thể được truyền bằng lệnh CLI, đồng thời có thể quay lại bảng điều khiển CLI cho nhiều lệnh Data Network, chẳng hạn như netdata show.

otBorderRouterConfig

Một số lệnh, chẳng hạn như prefix add, yêu cầu giá trị otBorderRouterConfig. Để đặt thành viên otBorderRouterConfig từ dòng lệnh, OT CLI sẽ phân tích cú pháp một đối số chữ cái đã liên kết cho mỗi thành viên. Ví dụ: tổ hợp đối số paros đặt các thành phần mpreferred, mSlaac, mDefaultRoute, mOnMesh và mStable liên tiếp.

Cú pháp

Trong ví dụ sau, prefix là bắt buộc và các đối số otBorderRouterConfig là không bắt buộc, được liên kết dưới dạng p, a, d, c, r, o, s, n và D:

prefix add prefix [padcrosnD]

Mức sử dụng

Để sử dụng tính năng ánh xạ đối số, bạn không được nhập dấu cách giữa các chữ cái:

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

otRoutePreference

Để đặt otRoutePreference, hãy 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]

Mức sử dụng

Dưới đây là ví dụ về cách sử dụng các tham số otBorderRouterConfig và otRoutePreference đã ánh xạ:

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

otExternalRouteConfig

Đối với các giá trị otExternalRouteConfig, s liên kết tới mStable và n ánh xạ tới mNat64.

Cú pháp

publish route prefix [sn]

Mức 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 đường và dịch vụ. Để biết thêm thông tin, hãy tham khảo bài viết Hiển thị và quản lý dữ liệu mạng bằng OT CLI.