khoá tạm thời ba
Cho biết liệu khoá tạm thời có đang hoạt động hay không.
Cần có OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE
.
Tham số
Không có tham số.
Ví dụ
ba ephemeralkey
active
Done
Tài liệu tham khảo về CLI và API
lệnh gọi lại ba Tạm thời (bật, tắt)
Đặt hàm callback mà Tác nhân biên giới sử dụng để thông báo mọi thay đổi liên quan đến việc sử dụng khoá tạm thời.
Cần có OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE
.
Lệnh gọi tiếp theo đến hàm này sẽ thay thế bất kỳ lệnh gọi lại nào đã đặt trước đó.
Tham số
Không có tham số.
Ví dụ
ba ephemeralkey callback enable
Done
ba ephemeralkey set W10X1 5000 49155
Done
BorderAgent callback: Ephemeral key active, port:49155
BorderAgent callback: Ephemeral key inactive
Tài liệu tham khảo về CLI và API
xoá khoá tạm thời
Huỷ khoá tạm thời đang sử dụng.
Cần có OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE
.
Có thể dùng để huỷ một khoá tạm thời đã đặt trước đó trước khi hết thời gian chờ. Nếu Tác nhân biên giới không chạy hoặc không có khoá tạm thời nào được sử dụng, thì việc gọi hàm này sẽ không có tác dụng.
Nếu một cố vấn được kết nối bằng khoá tạm thời và đang hoạt động, thì việc gọi hàm này sẽ không thay đổi trạng thái của hàm. Trong trường hợp này,
otBorderAgentIsEphemeralKeyActive()
sẽ tiếp tục trả về TRUE
cho đến khi uỷ viên huỷ kết nối.
Tham số
Không có tham số.
Ví dụ
ba ephemeralkey clear
Done
Tài liệu tham khảo về CLI và API
tập hợp khoá tạm thời [timeout-in-msec] [port]
Đặt khoá tạm thời cho một khoảng thời gian chờ nhất định.
Cần có OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE
.
Bạn có thể đặt khoá tạm thời khi Tác nhân biên giới đang chạy và hiện không được kết nối với bất kỳ uỷ viên bên ngoài nào (tức là khoá đang ở trạng thái OT_BORDER_AGENT_STATE_STARTED
). Nếu không, hàm sẽ trả về OT_ERROR_INVALID_STATE
.
aKeyString
đã cho được dùng trực tiếp làm PSK tạm thời (ngoại trừ ký tự \0
rỗng ở cuối). Độ dài của aKeyString
phải nằm trong khoảng từ OT_BORDER_AGENT_MIN_EPHEMERAL_KEY_LENGTH
đến OT_BORDER_AGENT_MAX_EPHEMERAL_KEY_LENGTH
.
Việc đặt lại khoá tạm thời trước khi khoá đã đặt trước đó hết thời gian chờ sẽ thay thế khoá đã đặt trước đó và đặt lại thời gian chờ.
Khi khoảng thời gian chờ có hiệu lực, khoá tạm thời chỉ có thể được ủy viên bên ngoài sử dụng một lần để kết nối. Sau khi nhân viên hỗ trợ ngắt kết nối, khoá tạm thời sẽ bị xoá và Border Agent sẽ quay lại sử dụng PSKc.
Tham số
Không có tham số.
Ví dụ
ba ephemeralkey set Z10X20g3J15w1000P60m16 5000 1234
Done
Tài liệu tham khảo về CLI và API
ba id (get,set)
Lấy hoặc đặt mã bộ định tuyến đường viền 16 byte. Mã này có thể xác định duy nhất thiết bị trong số nhiều BR.
Tham số
ba id [border-agent-id]
Dùng đối số border-agent-id
(không bắt buộc) để đặt mã nhận dạng tác nhân đường viền (Border Agent ID).
Ví dụ
ba id
cb6da1e0c0448aaec39fa90f3d58f45c
Done
ba id 00112233445566778899aabbccddeeff
Done
Tài liệu tham khảo về CLI và API
cổng ba
Lấy cổng UDP của dịch vụ Thread Border Agent.
Tham số
Không có tham số.
Ví dụ
ba port
49153
Done
Tài liệu tham khảo về CLI và API
trạng thái ba
Lấy otBorderAgentState của vai trò Thread Border Agent.
Tham số
Không có tham số.
Ví dụ
ba state
Started
Done
Tài liệu tham khảo về CLI và API
bbr
Trả về thông tin hiện tại của Bộ định tuyến đường xương chính cho thiết bị Thread.
Tham số
Không có tham số.
Ví dụ
bbr
BBR Primary:
server16: 0xE400
seqno: 10
delay: 120 secs
timeout: 300 secs
Done
bbr
BBR Primary: None
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
cấu hình bbr (set)
Thiết lập cấu hình cục bộ cho Bộ định tuyến xương sống otBackboneRouterConfig.
Thông báo Yêu cầu dữ liệu máy chủ SRV_DATA.ntf
được khởi tạo tự động nếu Tập dữ liệu BBR thay đổi cho Bộ định tuyến xương trục chính.
Có sẵn khi bạn bật OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
.
bbr register
phải được phát hành một cách rõ ràng để đăng ký dịch vụ Backbone Router cho Leader đối với Primary Backbone Router (Bộ định tuyến xương sống phụ).
Tham số
bbr config [seqno seqno] [delay delay] [timeout timeout]
Ví dụ
bbr config seqno 20 delay 30
Done
Tài liệu tham khảo về CLI và API
cấu hình bbr
Lấy cấu hình Bộ định tuyến xương sống cục bộ.
Có sẵn khi bạn bật OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
.
Tham số
Không có tham số.
Ví dụ
bbr config
seqno: 10
delay: 120 secs
timeout: 300 secs
Done
Tài liệu tham khảo về CLI và API
tắt bbr
Bật hoặc tắt chức năng Backbone.
Nếu bạn bật chế độ này, thông báo Yêu cầu dữ liệu máy chủ SRV_DATA.ntf
sẽ được kích hoạt cho thiết bị đính kèm nếu không có Dịch vụ bộ định tuyến trục chính trong Dữ liệu mạng Thread.
Nếu bạn tắt, SRV_DATA.ntf
sẽ được kích hoạt nếu Bộ định tuyến trục chính đang ở trạng thái Chính.
Có sẵn khi bạn bật OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
.
Tham số
Không có tham số.
Ví dụ
bbr disable
Done
Tài liệu tham khảo về CLI và API
bật bbr
Bật hoặc tắt chức năng Backbone.
Nếu bạn bật chế độ này, thông báo Yêu cầu dữ liệu máy chủ SRV_DATA.ntf
sẽ được kích hoạt cho thiết bị đính kèm nếu không có Dịch vụ bộ định tuyến trục chính trong Dữ liệu mạng Thread.
Nếu bạn tắt, SRV_DATA.ntf
sẽ được kích hoạt nếu Bộ định tuyến trục chính đang ở trạng thái Chính.
Có sẵn khi bạn bật OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
.
Tham số
Không có tham số.
Ví dụ
bbr enable
Done
Tài liệu tham khảo về CLI và API
bbr jitter (lấy,đặt)
Lấy hoặc đặt dao động (tính bằng giây) để đăng ký Bộ định tuyến xương sống.
Có sẵn khi bạn bật OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
.
Tham số
bbr jitter [jitter]
Ví dụ
bbr jitter
20
Done
bbr jitter 10
Done
Tài liệu tham khảo về CLI và API
quản lý bbr
Khi có meshLocalIid
, lệnh này sẽ định cấu hình trạng thái phản hồi cho lần đăng ký DUA tiếp theo. Nếu không có meshLocalIid
, hãy phản hồi DUA.req tiếp theo bằng status
hoặc coap-code
được chỉ định.
Có sẵn khi bạn bật OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
.
Tham số
bbr mgmt dua status|coap-code [meshLocalIid]
Đối với status
hoặc coap-code
, hãy sử dụng:
- 0: ST_DUA_OLD
- 1: ST_DUA_REREGISTER
- 2: ST_DUA_INVALID
- 3: ST_DUA_DUPLICATE
- 4: ST_DUA_NO_TÀI NGUYÊN
- 5: ST_DUA_BBR_NOT_PRIMARY
- 6: ST_DUA_FAILURE_FAILURE
- 160: Mã COAP 5.00
Ví dụ
bbr mgmt dua 1 2f7c235e5025a2fd
Done
bbr mgmt dua 160
Done
Tài liệu tham khảo về CLI và API
Thêm trình nghe quản lý bbr mlr
Thêm một Trình nghe đa hướng có giá trị thời gian chờ, tính bằng giây.
Truyền 0
để sử dụng thời gian chờ MLR mặc định.
Có sẵn khi OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
, OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE
và OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
được bật.
Tham số
bbr mgmt mlr listener add ipaddress [timeout-seconds]
Ví dụ
bbr mgmt mlr listener add ff04::1
Done
bbr mgmt mlr listener add ff04::2 300
Done
Tài liệu tham khảo về CLI và API
bbr quản lý trình nghe mlr
Trả về Trình nghe đa hướng với otBackboneRouterMulticastListenerInfomTimeout
sau vài giây.
Có sẵn khi bạn bật OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
và OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE
.
Tham số
Không có tham số.
Ví dụ
bbr mgmt mlr listener
ff04:0:0:0:0:0:0:abcd 3534000
ff04:0:0:0:0:0:0:eeee 3537610
Done
Tài liệu tham khảo về CLI và API
xoá trình nghe mlr trong bbr mgmt
Xoá Trình nghe đa hướng.
Có sẵn khi OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
, OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE
và OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
được bật.
Tham số
Không có tham số.
Ví dụ
bbr mgmt mlr listener clear
Done
Tài liệu tham khảo về CLI và API
phản hồi mlr của quản lý bbr
Định cấu hình trạng thái phản hồi cho lần đăng ký trình nghe đa hướng tiếp theo.
Có sẵn khi OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
, OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE
và OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
được bật.
Tham số
bbr mgmt mlr response status-code
Đối với status-code
, hãy sử dụng:
- 0: ST_MLR_CITY
- 2: ST_MLR_INVALID
- 3: ST_MLR_NO_PERSISTENT
- 4: ST_MLR_NO_TÀI NGUYÊN
- 5: ST_MLR_BBR_NOT_PRIMARY
- 6: ST_MLR_ Now_FAILURE
Ví dụ
bbr mgmt mlr response 2
Done
Tài liệu tham khảo về CLI và API
thanh ghi bbr
Đăng ký rõ ràng cấu hình Bộ định tuyến xương sống cục bộ.
Thông báo Yêu cầu dữ liệu máy chủ SRV_DATA.ntf
được kích hoạt cho thiết bị đính kèm.
Có sẵn khi bạn bật OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
.
Tham số
Không có tham số.
Ví dụ
bbr register
Done
Tài liệu tham khảo về CLI và API
trạng thái bbr
Tải Backbone Router otBackboneRouterState.
Có sẵn khi bạn bật OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
.
Tham số
Không có tham số.
Ví dụ
bbr state
Disabled
Done
bbr state
Primary
Done
bbr state
Secondary
Done
Tài liệu tham khảo về CLI và API
tắt br
Tắt Trình quản lý định tuyến đường viền.
Tham số
Không có tham số.
Ví dụ
br disable
Done
Tài liệu tham khảo về CLI và API
bật br
Bật Trình quản lý định tuyến biên.
Tham số
Không có tham số.
Ví dụ
br enable
Done
Tài liệu tham khảo về CLI và API
br init
Khởi chạy Trình quản lý định tuyến đường viền.
Tham số
br init infrastructure-network-index is-running
Ví dụ
br init 2 1
Done
Tài liệu tham khảo về CLI và API
tiền tố br nat64
Cho ra cả tiền tố NAT64 cục bộ và tiền tố ưu tiên.
Tham số
Không có tham số.
Ví dụ
br nat64prefix
Local: fd14:1078:b3d5:b0b0:0:0::/96
Favored: fd14:1078:b3d5:b0b0:0:0::/96 prf:low
Done
Tài liệu tham khảo về CLI và API
tiền tố br nat64 được ưu tiên
Lấy tiền tố NAT64 hiện được ưa dùng.
Bạn có thể phát hiện tiền tố NAT64 được ưu tiên qua đường liên kết đến cơ sở hạ tầng hoặc có thể là tiền tố NAT64 cục bộ của thiết bị này.
Tham số
Không có tham số.
Ví dụ
br nat64prefix favored
fd14:1078:b3d5:b0b0:0:0::/96 prf:low
Done
Tài liệu tham khảo về CLI và API
tiền tố br nat64 bản địa
Lấy tiền tố NAT64 cục bộ của Bộ định tuyến biên.
Tiền tố NAT64 có thể không được quảng cáo trong mạng Thread.
Bạn phải bật OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE
.
Tham số
Không có tham số.
Ví dụ
br nat64prefix local
fd14:1078:b3d5:b0b0:0:0::/96
Done
Tài liệu tham khảo về CLI và API
tiền tố br
Xuất ra cả tiền tố OMR cục bộ lẫn tiền tố OMR ưu tiên.
Tham số
Không có tham số.
Ví dụ
br omrprefix
Local: fdfc:1ff5:1512:5622::/64
Favored: fdfc:1ff5:1512:5622::/64 prf:low
Done
Tài liệu tham khảo về CLI và API
CANNOT TRANSLATE
Nhận tiền tố Off-Mesh-Routable (OMR) hiện đang được ưa chuộng.
Tiền tố OMR ưu tiên có thể được phát hiện từ Dữ liệu mạng hoặc có thể là tiền tố OMR cục bộ của thiết bị này.
Tham số
Không có tham số.
Ví dụ
br omrprefix favored
fdfc:1ff5:1512:5622::/64 prf:low
Done
Tài liệu tham khảo về CLI và API
tiền tố địa phương br omrprefix
Lấy tiền tố Off-Mesh-Routable (OMR) cục bộ, ví dụ: fdfc:1ff5:1512:5622::/64
.
Tiền tố OMR là tiền tố 64 bit được tạo ngẫu nhiên và được xuất bản trong mạng Thread nếu chưa có tiền tố OMR. Bạn có thể kết nối với tiền tố này từ mạng Wi-Fi hoặc Ethernet cục bộ.
Tham số
Không có tham số.
Ví dụ
br omrprefix local
fdfc:1ff5:1512:5622::/64
Done
Tài liệu tham khảo về CLI và API
tiền tố br onlink
Cho ra cả tiền tố cục bộ và tiền tố trên đường liên kết được ưu tiên.
Tham số
Không có tham số.
Ví dụ
br onlinkprefix
Local: fd41:2650:a6f5:0::/64
Favored: 2600::0:1234:da12::/64
Done
Tài liệu tham khảo về CLI và API
ưu tiên br onlinkprefix
Nhận tiền tố On-Link hiện được ưa dùng.
Tiền tố được ưu tiên là tiền tố trên đường liên kết được tìm thấy trong đường liên kết đến cơ sở hạ tầng hoặc tiền tố cục bộ trên đường liên kết.
Tham số
Không có tham số.
Ví dụ
br onlinkprefix favored
2600::0:1234:da12::/64
Done
Tài liệu tham khảo về CLI và API
bản địa hoá của br onlinkprefix
Lấy tiền tố cục bộ trên đường liên kết cho đường liên kết của cơ sở hạ tầng liền kề.
Tiền tố cục bộ trên đường liên kết là tiền tố 64 bit được quảng cáo trên đường liên kết đến cơ sở hạ tầng nếu chưa có tiền tố hữu dụng trên đường liên kết đang được quảng cáo trên đường liên kết đó.
Tham số
Không có tham số.
Ví dụ
br onlinkprefix local
fd41:2650:a6f5:0::/64
Done
Tài liệu tham khảo về CLI và API
br PD (bật,tắt)
Bật / Tắt tính năng uỷ quyền tiền tố DHCPv6.
Bạn phải bật OPENTHREAD_CONFIG_BORDER_ROUTING_DHCP6_PD_ENABLE
.
Tham số
br pd enable|disable
Ví dụ
br pd enable
Done
br pd disable
Done
Tài liệu tham khảo về CLI và API
tiền tố br PD
Nhận tiền tố Uỷ quyền tiền tố (PD) DHCPv6 được cung cấp ngoài lưới-định tuyến (OMR).
Chỉ các trường mPrefix, mValidLifetime và mPreferenceLifetime được sử dụng trong thông tin về tiền tố trả về.
Bạn phải bật OPENTHREAD_CONFIG_BORDER_ROUTING_DHCP6_PD_ENABLE
.
Tham số
Không có tham số.
Ví dụ
br pd omrprefix
2001:db8:cafe:0:0/64 lifetime:1800 preferred:1800
Done
Tài liệu tham khảo về CLI và API
trạng thái br PD
Xem trạng thái hiện tại của tính năng Uỷ quyền tiền tố DHCPv6.
Bạn cần bật OPENTHREAD_CONFIG_BORDER_ROUTING_DHCP6_PD_ENABLE
.
Tham số
Không có tham số.
Ví dụ
br pd state
running
Done
Tài liệu tham khảo về CLI và API
bạn bè ngang hàng
Lấy danh sách các BR ngang hàng có trong mục Dữ liệu mạng. Phải nhập thông tin vào trường OPENTHREAD_CONFIG_BORDER_ROUTING_TRACK_PEER_BR_INFO_ENABLE
. BR ngang hàng là các thiết bị khác trong lưới Thread cung cấp kết nối IP bên ngoài. Một thiết bị được coi là cung cấp kết nối IP bên ngoài nếu đáp ứng ít nhất một trong các điều kiện sau đây liên quan đến các mục nhập Dữ liệu mạng của thiết bị đó:
- Hệ thống đã thêm ít nhất một mục nhập tuyến đường bên ngoài.
- Lớp này đã thêm ít nhất một mục nhập tiền tố có đặt cả cờ tuyến đường mặc định và cờ trên lưới.
- Công cụ này đã thêm ít nhất một tiền tố miền (đã thiết lập cả cờ miền và cờ trên lưới). Danh sách các Brazil ngang hàng sẽ loại trừ riêng thiết bị hiện tại, ngay cả khi bản thân thiết bị đó chỉ có vai trò là một Brazil. Thông tin cho mỗi mục nhập Brazil:
- rlOC16 của Brazil
- Độ tuổi là khoảng thời gian kể từ khi Brazil xuất hiện trong Dữ liệu mạng. Thuộc tính này được định dạng là
{hh}:{mm}:{ss}
cho giờ, phút, giây nếu thời lượng dưới 24 giờ. Nếu thời lượng từ 24 giờ trở lên thì định dạng sẽ là{dd}d.{hh}:{mm}:{ss}
cho ngày, giờ, phút, giây.
Tham số
Không có tham số.
Ví dụ
br peers
rloc16:0x5c00 age:00:00:49
rloc16:0xf800 age:00:01:51
Done
Tài liệu tham khảo về CLI và API
số lượng ứng dụng ngang hàng br
Trả về số lượng BR ngang hàng có trong Dữ liệu mạng.
Cần có OPENTHREAD_CONFIG_BORDER_ROUTING_TRACK_PEER_BR_INFO_ENABLE
.
BR ngang hàng là các thiết bị khác trong lưới Thread cung cấp kết nối IP bên ngoài. Một thiết bị được coi là cung cấp kết nối IP bên ngoài nếu đáp ứng ít nhất một trong các điều kiện sau đây liên quan đến các mục nhập Dữ liệu mạng của thiết bị đó:
- Hệ thống đã thêm ít nhất một mục nhập tuyến đường bên ngoài.
- Lớp này đã thêm ít nhất một mục nhập tiền tố có đặt cả cờ tuyến đường mặc định và cờ trên lưới.
- Công cụ này đã thêm ít nhất một tiền tố miền (đã thiết lập cả cờ miền và cờ trên lưới).
Danh sách các Brazil ngang hàng sẽ loại trừ riêng thiết bị hiện tại, ngay cả khi thiết bị đó chỉ đóng vai trò là một Brazil.
Tham số
Không có tham số.
Ví dụ
br peers count
2 min-age:00:00:47
Done
Tài liệu tham khảo về CLI và API
bảng tiền tố br
Lấy các tiền tố do Trình quản lý định tuyến biên giới phát hiện trên đường liên kết cơ sở hạ tầng. Thông tin cho mỗi mục nhập tiền tố:
- Tiền tố
- Tiền tố đó là trên đường liên kết hay tuyến đường
- Mili giây kể từ lần gần đây nhất nhận được Quảng cáo liên quan đến bộ định tuyến có chứa tiền tố này
- Thời gian tồn tại của tiền tố tính bằng giây
- Thời gian tồn tại ưu tiên chỉ tính bằng giây nếu tiền tố là trên đường liên kết
- Lựa chọn ưu tiên về tuyến đường (thấp, trung bình, cao) chỉ khi tiền tố là tuyến đường (không phải trên đường liên kết)
- Địa chỉ IPv6 của bộ định tuyến quảng cáo tiền tố này
- Cờ trong tiêu đề Quảng cáo bộ định tuyến đã nhận:
- M: Cờ Cấu hình địa chỉ được quản lý
- O: Cờ Cấu hình khác
- Stub: Cờ bộ định tuyến mã giả lập (cho biết bộ định tuyến có phải là bộ định tuyến giả lập hay không)
Tham số
Không có tham số.
Ví dụ
br prefixtable
prefix:fd00:1234:5678:0::/64, on-link:no, ms-since-rx:29526, lifetime:1800, route-prf:med,
router:ff02:0:0:0:0:0:0:1 (M:0 O:0 Stub:1)
prefix:1200:abba:baba:0::/64, on-link:yes, ms-since-rx:29527, lifetime:1800, preferred:1800,
router:ff02:0:0:0:0:0:0:1 (M:0 O:0 Stub:1)
Done
Tài liệu tham khảo về CLI và API
br raoptions (set,clear)
Đặt các tuỳ chọn bổ sung để nối ở cuối thông báo Quảng cáo cho bộ định tuyến (RA) đã phát.
Nội dung của aOptions
được sao chép nội bộ nên có thể là vùng đệm tạm thời (ví dụ: mảng được phân bổ ngăn xếp).
Các lệnh gọi tiếp theo của hàm này sẽ ghi đè giá trị đã đặt trước đó.
Tham số
br raoptions options|clear
br raoptions clear
chuyển nullptr
đến otBorderRoutingSetExtraRouterAdvertOptions. Nếu không, bạn có thể truyền byte options
dưới dạng dữ liệu hex.
Ví dụ
br raoptions 0400ff00020001
Done
br raoptions clear
Done
Tài liệu tham khảo về CLI và API
br rioprf (cao,trung bình,thấp)
Đặt rõ ràng lựa chọn ưu tiên để sử dụng khi quảng cáo Tuỳ chọn thông tin tuyến đường (RIO) trong các thông báo Quảng cáo liên quan đến bộ định tuyến được gửi qua đường liên kết cơ sở hạ tầng.
Sau khi gọi hàm này, BR sẽ sử dụng lựa chọn ưu tiên đã cho cho tất cả các RIO được quảng cáo. Bạn có thể xoá lựa chọn ưu tiên bằng cách gọi
otBorderRoutingClearRouteInfoOptionPreference()
.
Tham số
br rioprf [high|med|low]
Ví dụ
br rioprf low
Done
Tài liệu tham khảo về CLI và API
br rioprf
Lấy lựa chọn ưu tiên hiện tại được dùng khi quảng cáo Tuỳ chọn thông tin tuyến đường (RIO) trong các thông báo Quảng cáo cho bộ định tuyến được gửi qua đường liên kết cơ sở hạ tầng.
Tuỳ chọn RIO được xác định như sau:
- Nếu người dùng đặt rõ ràng bằng cách gọi
otBorderRoutingSetRouteInfoOptionPreference()
, thì lựa chọn ưu tiên nhất định sẽ được sử dụng. - Nếu không, vai trò này được xác định dựa trên vai trò hiện tại của thiết bị: Lựa chọn ưu tiên trung bình khi giữ vai trò bộ định tuyến/người lãnh đạo và ưu tiên thấp khi giữ vai trò con.
Tham số
Không có tham số.
Ví dụ
br rioprf
med
Done
Tài liệu tham khảo về CLI và API
br rioprf rõ ràng
Xoá giá trị lựa chọn ưu tiên đã đặt trước đó cho Lựa chọn về thông tin tuyến đường được quảng cáo.
Sau khi được gọi đến chức năng này, BR sẽ sử dụng vai trò của thiết bị để xác định lựa chọn ưu tiên RIO: Lựa chọn ưu tiên trung bình khi giữ vai trò bộ định tuyến/lãnh đạo và ưu tiên thấp khi giữ vai trò con.
Tham số
Không có tham số.
Ví dụ
br rioprf clear
Done
Tài liệu tham khảo về CLI và API
br tuyếnprf (cao,trung bình,thấp)
Đặt lựa chọn ưu tiên về các tuyến đã xuất bản trong Dữ liệu mạng một cách rõ ràng.
Sau khi gọi hàm này, BR sẽ sử dụng tuỳ chọn đã cho. Bạn có thể xoá lựa chọn ưu tiên bằng cách gọi
otBorderRoutingClearRoutePreference()
.
Tham số
br routeprf [high|med|low]
Ví dụ
br routeprf low
Done
Tài liệu tham khảo về CLI và API
br tuyến đường
Lấy lựa chọn ưu tiên hiện tại được dùng cho các tuyến đã xuất bản trong Dữ liệu mạng.
Lựa chọn ưu tiên được xác định như sau:
- Nếu người dùng đặt rõ ràng bằng cách gọi
otBorderRoutingSetRoutePreference()
, thì lựa chọn ưu tiên nhất định sẽ được sử dụng. - Nếu không, yếu tố này sẽ được
RoutingManager
tự động xác định dựa trên vai trò của thiết bị và chất lượng đường liên kết.
Tham số
Không có tham số.
Ví dụ
br routeprf
med
Done
Tài liệu tham khảo về CLI và API
br tuyến đường rõ ràng
Xoá giá trị lựa chọn ưu tiên đã đặt trước đó cho các tuyến đường đã xuất bản trong Dữ liệu mạng.
Sau khi gọi đến chức năng này, Brazil sẽ tự động xác định lựa chọn ưu tiên dựa trên vai trò của thiết bị và chất lượng liên kết (với thiết bị mẹ khi hoạt động như thiết bị cuối).
Tham số
Không có tham số.
Ví dụ
br routeprf clear
Done
Tài liệu tham khảo về CLI và API
bộ định tuyến br
Nhận danh sách các bộ định tuyến được phát hiện bằng Trình quản lý định tuyến biên giới trên đường liên kết cơ sở hạ tầng. Thông tin theo bộ định tuyến:
- Địa chỉ IPv6 của bộ định tuyến
- Cờ trong tiêu đề Quảng cáo bộ định tuyến đã nhận:
- M: Cờ Cấu hình địa chỉ được quản lý
- O: Cờ Cấu hình khác
- Stub: Cờ bộ định tuyến mã giả lập (cho biết bộ định tuyến có phải là bộ định tuyến giả lập hay không)
- Mili giây kể từ tin nhắn nhận được gần đây nhất từ bộ định tuyến này
- Cờ về phạm vi kết nối: Bộ định tuyến được đánh dấu là không kết nối được nếu không phản hồi với nhiều thăm dò Gây quỹ lân cận.
- Thời gian tồn tại: Khoảng thời gian kể từ lần đầu phát hiện bộ định tuyến này. Thuộc tính này được định dạng là
{hh}:{mm}:{ss}
cho giờ, phút, giây nếu thời lượng dưới 24 giờ. Nếu thời lượng từ 24 giờ trở lên thì định dạng sẽ là{dd}d.{hh}:{mm}:{ss}
cho ngày, giờ, phút, giây. (this BR)
sẽ được thêm vào khi bộ định tuyến chính là thiết bị cục bộ.(peer BR)
được thêm vào khi bộ định tuyến có thể là một BR ngang hàng kết nối với cùng một lưới Thread. Thao tác này yêu cầuOPENTHREAD_CONFIG_BORDER_ROUTING_TRACK_PEER_BR_INFO_ENABLE
.
Tham số
Không có tham số.
Ví dụ
br routers
ff02:0:0:0:0:0:0:1 (M:0 O:0 Stub:1) ms-since-rx:1505 reachable:yes age:00:18:13
Done
Tài liệu tham khảo về CLI và API
trạng thái br
Lấy trạng thái hiện tại của Trình quản lý định tuyến biên.
Tham số
Không có tham số.
Ví dụ
br state
running
Tài liệu tham khảo về CLI và API
bufferinfo
Lấy thông tin về vùng đệm thư hiện tại.
total
cho thấy tổng số vùng đệm thông báo trong nhóm.free
cho thấy số lượng vùng đệm tin nhắn miễn phí.max-used
cho thấy đồng thời số lượng vùng đệm tối đa đã sử dụng kể từ lần khởi chạy ngăn xếp OT hoặcbufferinfo reset
gần đây nhất.
Tiếp theo, CLI hiện thông tin về các hàng đợi khác nhau mà ngăn xếp OpenThread sử dụng, ví dụ như 6lo send
. Mỗi dòng sau hàng đợi biểu thị thông tin về một hàng đợi:
- Số đầu tiên hiển thị các thông báo số trong hàng đợi.
- Số thứ hai cho biết số vùng đệm mà tất cả thông báo trong hàng đợi sử dụng.
- Số thứ ba cho biết tổng số byte của tất cả thư trong hàng đợi.
Tham số
Không có tham số.
Ví dụ
bufferinfo
total: 40
free: 40
max-used: 5
6lo send: 0 0 0
6lo reas: 0 0 0
ip6: 0 0 0
mpl: 0 0 0
mle: 0 0 0
coap: 0 0 0
coap secure: 0 0 0
application coap: 0 0 0
Done
Tài liệu tham khảo về CLI và API
đặt lại thông tin vùng đệm
Đặt lại bộ đếm thông tin Vùng đệm thư theo dõi số vùng đệm tối đa được sử dụng cùng một lúc.
Thao tác này sẽ đặt lại mMaxUsedBuffers
trong
otBufferInfo
.
Tham số
Không có tham số.
Ví dụ
bufferinfo reset
Done
Tài liệu tham khảo về CLI và API
ccathreshold (lấy,đặt)
Lấy hoặc thiết lập ngưỡng CCA tính bằng dBm được đo tại đầu nối ăng-ten theo mục 10.1.4 của IEEE 802.15.4 – 2015.
Tham số
ccathreshold [CCA-threshold-dBm]
Dùng đối số CCA-threshold-dBm
(không bắt buộc) để đặt ngưỡng CCA.
Ví dụ
ccathreshold
-75 dBm
Done
ccathreshold -62
Done
Tài liệu tham khảo về CLI và API
kênh (lấy,đặt)
Lấy hoặc thiết lập giá trị Kênh IEEE 802.15.4.
Tham số
channel [channel-num]
Sử dụng channel-num
để đặt kênh.
Ví dụ
channel
11
Done
channel 11
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
trình quản lý kênh tự động
Bật hoặc tắt chức năng tự động chọn kênh cho kênh mạng.
Khi được bật, ChannelManager
sẽ định kỳ gọi một RequestChannelSelect(false)
. Bạn có thể đặt khoảng thời gian bằng
otChannelManagerSetAutoChannelSelectionInterval()
.
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
hoặc OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
và OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
là bắt buộc.
Tham số
channel manager auto enable
1
là boolean cho enable
.
Ví dụ
channel manager auto 1
channel manager auto 1
Done
Tài liệu tham khảo về CLI và API
thay đổi người quản lý kênh
Yêu cầu thay đổi kênh của mạng Thread.
Mạng chuyển sang kênh nhất định sau một độ trễ nhất định (xem otChannelManagerSetDelay()). Việc thay đổi kênh được thực hiện bằng cách cập nhật Tập dữ liệu hoạt động đang chờ xử lý.
Cuộc gọi tiếp theo sẽ huỷ yêu cầu thay đổi kênh đang diễn ra trước đó.
Phải nhập thông tin vào trường OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
.
Tham số
channel manager change channel-num
Ví dụ
channel manager change 11
channel manager change 11
Done
Tài liệu tham khảo về CLI và API
người quản lý kênh
Xem trạng thái của người quản lý kênh. Bạn phải nhập OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
hoặc OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
.
Tham số
Không có tham số.
Ví dụ
channel manager
channel: 11
auto: 1
delay: 120
interval: 10800
supported: { 11-26}
favored: { 11-26}
Done
Tài liệu tham khảo về CLI và API
độ trễ của người quản lý kênh
Đặt độ trễ (tính bằng giây) dùng để thay đổi kênh mạng.
Chỉ có trên FTD. Độ trễ tốt nhất phải dài hơn khoảng thời gian tối đa khi thăm dò ý kiến dữ liệu mà tất cả Thiết bị cuối ở trạng thái ngủ trong mạng Thread sử dụng.
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
và OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
là bắt buộc.
Tham số
channel manager delay delay-seconds
Ví dụ
channel manager delay 120
channel manager delay 120
Done
Tài liệu tham khảo về CLI và API
người quản lý kênh ưu tiên
Đặt mặt nạ kênh được yêu thích.
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
hoặc OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
và OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
là bắt buộc.
Tham số
channel manager favored mask
Ví dụ
channel manager favored 0x7fffc00
channel manager favored 0x7fffc00
Done
Tài liệu tham khảo về CLI và API
khoảng thời gian từ người quản lý kênh
Đặt khoảng thời gian (tính bằng giây) mà chức năng tự động chọn kênh sử dụng.
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
hoặc OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
và OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
là bắt buộc.
Tham số
channel manager interval interval-seconds
Ví dụ
channel manager interval 10800
channel manager interval 10800
Done
Tài liệu tham khảo về CLI và API
người quản lý kênh chọn
Yêu cầu ChannelManager
kiểm tra và chọn một kênh mới, đồng thời bắt đầu quá trình thay đổi kênh.
Không giống như
otChannelManagerRequestChannelChange()
, trong đó kênh phải được cung cấp dưới dạng tham số, hàm này yêu cầu ChannelManager
tự chọn một kênh (dựa trên thông tin chất lượng kênh đã thu thập).
Sau khi được gọi, Trình quản lý kênh sẽ thực hiện 3 bước sau:
1) ChannelManager
quyết định xem việc thay đổi kênh có hữu ích hay không. Bạn có thể bỏ qua bước kiểm tra này nếu đặt aSkipQualityCheck
thành true (bắt buộc phải chọn kênh và bỏ qua bước kiểm tra chất lượng). Bước này sử dụng các chỉ số chất lượng đường liên kết đã thu thập trên thiết bị (chẳng hạn như tỷ lệ lỗi CCA, tỷ lệ lỗi khung hình và tin nhắn của mỗi nhóm, v.v.) để xác định xem chất lượng kênh hiện tại có đạt đến mức chứng minh cho sự thay đổi của kênh hay không.
2) Nếu bước đầu tiên vượt qua, thì ChannelManager
sẽ chọn một kênh có tiềm năng tốt hơn. Mô-đun này sử dụng dữ liệu chất lượng kênh được thu thập bằng mô-đun ChannelMonitor
. Các kênh được hỗ trợ và ưu tiên sẽ được sử dụng ở bước này. (xem
otChannelManagerSetSupportedChannels()
và
otChannelManagerSetFavoredChannels()
).
3) Nếu kênh mới chọn khác với kênh hiện tại, ChannelManager
sẽ yêu cầu/bắt đầu quá trình thay đổi kênh (gọi RequestChannelChange()
trong nội bộ).
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
hoặc OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
và OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
là bắt buộc.
Tham số
channel manager select skip-quality-check
Sử dụng 1
hoặc 0
cho giá trị boolean skip-quality-check
.
Ví dụ
channel manager select 1
channel manager select 1
Done
Tài liệu tham khảo về CLI và API
có hỗ trợ người quản lý kênh
Đặt mặt nạ kênh được hỗ trợ.
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
hoặc OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
và OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
là bắt buộc.
Tham số
channel manager supported mask
Ví dụ
channel manager supported 0x7fffc00
channel manager supported 0x7fffc00
Done
Tài liệu tham khảo về CLI và API
ngưỡng của người quản lý kênh
Đặt ngưỡng tỷ lệ lỗi của CCA.
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
hoặc OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
và OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
là bắt buộc.
Tham số
channel manager threshold threshold-percent
Sử dụng giá trị hex cho threshold-percent
. 0
ánh xạ tới 0% và 0xffff
ánh xạ tới 100%.
Ví dụ
channel manager threshold 0xffff
channel manager threshold 0xffff
Done
Tài liệu tham khảo về CLI và API
giám sát kênh
Xem trạng thái giám sát kênh và tỷ lệ người dùng hiện tại của kênh. Phải nhập thông tin vào trường OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
.
Tham số
Không có tham số.
Ví dụ
channel monitor
enabled: 1
interval: 41000
threshold: -75
window: 960
count: 10552
occupancies:
ch 11 (0x0cb7) 4.96% busy
ch 12 (0x2e2b) 18.03% busy
ch 13 (0x2f54) 18.48% busy
ch 14 (0x0fef) 6.22% busy
ch 15 (0x1536) 8.28% busy
ch 16 (0x1746) 9.09% busy
ch 17 (0x0b8b) 4.50% busy
ch 18 (0x60a7) 37.75% busy
ch 19 (0x0810) 3.14% busy
ch 20 (0x0c2a) 4.75% busy
ch 21 (0x08dc) 3.46% busy
ch 22 (0x101d) 6.29% busy
ch 23 (0x0092) 0.22% busy
ch 24 (0x0028) 0.06% busy
ch 25 (0x0063) 0.15% busy
ch 26 (0x058c) 2.16% busy
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
bắt đầu giám sát kênh
Khởi động giám sát kênh. OT CLI gửi giá trị boolean của true
đến otChannelMonitorSetEnabled. OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
là trường bắt buộc.
Tham số
Không có tham số.
Ví dụ
channel monitor start
channel monitor start
Done
Tài liệu tham khảo về CLI và API
ngừng giám sát kênh
Dừng giám sát kênh. OT CLI gửi giá trị boolean của false
đến otChannelMonitorSetEnabled. OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
là trường bắt buộc.
Tham số
Không có tham số.
Ví dụ
channel monitor stop
channel monitor stop
Done
Tài liệu tham khảo về CLI và API
kênh được ưu tiên
Lấy mặt nạ kênh ưu tiên đài phát thanh mà thiết bị muốn tạo.
Tham số
Không có tham số.
Ví dụ
channel preferred
0x7fff800
Done
Tài liệu tham khảo về CLI và API
kênh được hỗ trợ
Lấy mặt nạ kênh hỗ trợ đài phát thanh mà thiết bị được phép bật.
Tham số
Không có tham số.
Ví dụ
channel supported
0x7fff800
Done
Tài liệu tham khảo về CLI và API
con (mã nhận dạng)
Lấy thông tin chẩn đoán cho một Cấp độ con được đính kèm theo Mã nhận dạng trẻ em hoặc rlOC16.
Tham số
child child-id
Ví dụ
child 1
Child ID: 1
Rloc: 9c01
Ext Addr: e2b3540590b0fd87
Mode: rn
CSL Synchronized: 1
Net Data: 184
Timeout: 100
Age: 0
Link Quality In: 3
RSSI: -20
Done
Tài liệu tham khảo về CLI và API
danh sách con
Trả về danh sách Mã con đính kèm.
Tham số
Không có tham số.
Ví dụ
child list
1 2 3 6 7 8
Done
Tài liệu tham khảo về CLI và API
bảng con
In một bảng gồm các phần tử con đính kèm.
Tham số
Không có tham số.
Ví dụ
child table
| ID | RLOC16 | Timeout | Age | LQ In | C_VN |R|D|N|Ver|CSL|QMsgCnt| Extended MAC |
+-----+--------+------------+------------+-------+------+-+-+-+---+---+-------+------------------+
| 1 | 0xc801 | 240 | 24 | 3 | 131 |1|0|0| 3| 0 | 0 | 4ecede68435358ac |
| 2 | 0xc802 | 240 | 2 | 3 | 131 |0|0|0| 3| 1 | 0 | a672a601d2ce37d8 |
Done
Tài liệu tham khảo về CLI và API
CANNOT TRANSLATE
Lấy danh sách địa chỉ IP lưu trữ cho nhà xuất bản con MTD.
Tham số
Không có tham số.
Ví dụ
childip
3401: fdde:ad00:beef:0:3037:3e03:8c5f:bc0c
Done
Tài liệu tham khảo về CLI và API
conip max (đặt)
Thiết lập hoặc khôi phục số lượng địa chỉ IP tối đa mà mỗi nhà xuất bản con MTD có thể đăng ký với thiết bị này với vai trò là mạng gốc.
Truyền 0
để xoá chế độ cài đặt và khôi phục chế độ mặc định.
Có sẵn khi bạn bật OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
.
Tham số
childip max count
Ví dụ
childip max 2
Done
Tài liệu tham khảo về CLI và API
CANNOT TRANSLATE
Lấy số lượng địa chỉ IP tối đa mà mỗi nhà xuất bản con MTD có thể đăng ký với thiết bị này với vai trò là thiết bị mẹ.
Tham số
Không có tham số.
Ví dụ
childip max
4
Done
Tài liệu tham khảo về CLI và API
CANNOT TRANSLATE
Đặt số lượng phần tử con tối đa hiện được phép.
Bạn chỉ có thể đặt tham số này khi ngừng hoạt động đối với giao thức Thread.
Tham số
childmax count
Ví dụ
childmax 2
Done
Tài liệu tham khảo về CLI và API
CANNOT TRANSLATE
Xem số lượng trẻ tối đa hiện được cho phép.
Tham số
Không có tham số.
Ví dụ
childmax
5
Done
Tài liệu tham khảo về CLI và API
đường liên kết dành cho trẻ em (lấy,đặt)
Lấy hoặc đặt giá trị MLE_CHILD_ROUTER_LINKS.
Tham số
childrouterlinks [links]
Ví dụ
childrouterlinks
16
Done
childrouterlinks 16
Done
Tài liệu tham khảo về CLI và API
giờ trả phòng giám sát trẻ em (nhóm)
Đặt khoảng thời gian chờ kiểm tra tính năng giám sát (tính bằng giây) đối với nhà xuất bản con.
Tham số
childsupervision checktimeout timeout-seconds
Ví dụ
childsupervision checktimeout 30
Done
Tài liệu tham khảo về CLI và API
thời gian trả phòng giám sát trẻ em
Lấy khoảng thời gian chờ kiểm tra tính năng giám sát (tính bằng giây) đối với trẻ.
Nếu thiết bị ở trạng thái ngủ và không nhận được phản hồi từ cấp độ gốc trong thời gian chờ kiểm tra được chỉ định, thì thiết bị sẽ bắt đầu quá trình đính kèm lại (trao đổi phản hồi/Yêu cầu cập nhật con MLE với cấp độ gốc).
Tham số
Không có tham số.
Ví dụ
childsupervision checktimeout
30
Done
Tài liệu tham khảo về CLI và API
khoảng thời gian giám sát trẻ (đặt)
Đặt khoảng thời gian giám sát trẻ (tính bằng giây) đối với trẻ.
Tham số
childsupervision interval interval-seconds
Ví dụ
childsupervision interval 30
Done
Tài liệu tham khảo về CLI và API
khoảng thời gian giám sát trẻ
Xem khoảng thời gian Giám sát trẻ em (tính bằng giây) đối với trẻ.
Tính năng Giám sát trẻ em cung cấp cơ chế để cha mẹ đảm bảo gửi thông báo đến mỗi trẻ đang ngủ trong khoảng thời gian giám sát. Nếu không có hoạt động truyền tải nào đến trẻ trong khoảng thời gian giám sát, OpenThread sẽ thêm vào hàng đợi và gửi một Thông báo giám sát dành cho trẻ em cho trẻ.
Tham số
Không có tham số.
Ví dụ
childsupervision interval
30
Done
Tài liệu tham khảo về CLI và API
thời gian chờ trẻ em (đã đặt)
Đặt Thời gian chờ con của luồng (tính bằng giây) được sử dụng khi hoạt động ở vai trò Con.
Tham số
childtimeout timeout-seconds
Ví dụ
childtimeout 300
Done
Tài liệu tham khảo về CLI và API
tạm biệt trẻ em
Lấy Thời gian chờ con của luồng (tính bằng giây) được dùng khi hoạt động ở vai trò Con.
Tham số
Không có tham số.
Ví dụ
childtimeout
300
Done
Tài liệu tham khảo về CLI và API
hủy coap
Huỷ gói thuê bao quan sát hiện có cho một tài nguyên từ xa trên máy chủ CoAP.
Tham số
Không có tham số.
Ví dụ
coap cancel
Done
Tài liệu tham khảo về CLI và API
coap xoá
Xoá tài nguyên CoAP đã chỉ định.
Tham số
coap delete address uri-path [type] [payload]
address
: Địa chỉ IPv6 của máy chủ CoAP.uri-path
: Đường dẫn URI của tài nguyên.type
:con
: Có thể xác nhậnnon-con
: Không thể xác nhận (mặc định)
payload
: Chuỗi tải trọng CoAP. Ví dụ:hellothere
.
Ví dụ
coap delete fdde:ad00:beef:0:2780:9423:166c:1aac test-resource con hellothere
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
coap get
Lấy thông tin về tài nguyên CoAP được chỉ định trên máy chủ CoAP.
Tham số
coap get address uri-path [type]
address
: Địa chỉ IPv6 của máy chủ CoAP.uri-path
: Đường dẫn URI của tài nguyên.type
:con
: Có thể xác nhậnnon-con
: Không thể xác nhận (mặc định)block-
: Sử dụng tuỳ chọn này, theo sau là giá trị chặn, nếu phản hồi phải được truyền theo khối. Các giá trị hợp lệ là:block-16
,block-32
,block-64
,block-128
,block-256
,block-512
hoặcblock-1024
.
Ví dụ
coap get fdde:ad00:beef:0:2780:9423:166c:1aac test-resource
Done
coap get fdde:ad00:beef:0:2780:9423:166c:1aac test-resource block-1024
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
coap quan sát
Kích hoạt yêu cầu thuê bao để cho phép ứng dụng CoAP quan sát tài nguyên được chỉ định trên máy chủ CoAP để biết những thay đổi có thể xảy ra về trạng thái.
Tham số
coap observe address uri-path [type]
address
: Địa chỉ IPv6 của máy chủ CoAP.uri-path
: Đường dẫn URI của tài nguyên.type
:con
: Có thể xác nhậnnon-con
: Không thể xác nhận (mặc định).
Ví dụ
coap observe fdde:ad00:beef:0:2780:9423:166c:1aac test-resource
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
tham số coap(lấy,đặt)
Lấy các giá trị tham số CoAP hiện tại nếu chạy lệnh không có tham số không bắt buộc.
Đặt tham số CoAP thành giá trị mặc định hoặc giá trị mà bạn chỉ định, tuỳ thuộc vào cú pháp đã chọn.
Tham số
coap parameters type [default | ack_timeout ack_random_factor_numerator ack_random_factor_denominator max_retransmit]
type
:request
đối với các yêu cầu CoAP hoặcresponse
đối với phản hồi CoAP. Nếu không có tham số nào được cung cấp, lệnh này sẽ in cấu hình hiện tại.default
: Thiết lập tham số truyền thành các giá trị mặc định sau:ack_timeout
: 2000 mili giâyack_random_factor_numerator
: 3ack_random_factor_denominator
: 2max_retransmit
: 4
ack_timeout
:ACK_TIMEOUT
(0-UINT32_MAX) tính bằng mili giây. Tham khảo RFC7252.ack_random_factor_numerator
: tử sốACK_RANDOM_FACTOR
, với các giá trị có thể từ 0 đến 255. Tham khảo RFC7252.ack_random_factor_denominator
: Mẫu sốACK_RANDOM_FACTOR
, với các giá trị có thể từ 0 đến 255. Tham khảo RFC7252.max_retransmit
:MAX_RETRANSMIT
(0-255). Tham khảo RFC7252.
Ví dụ
coap parameters request
Transmission parameters for request:
ACK_TIMEOUT=1000 ms, ACK_RANDOM_FACTOR=255/254, MAX_RETRANSMIT=2
Done
coap parameters request default
Transmission parameters for request:
default
Done
coap parameters request 1000 255 254 2
Transmission parameters for request:
ACK_TIMEOUT=1000 ms, ACK_RANDOM_FACTOR=255/254, MAX_RETRANSMIT=2
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
bài đăng của đội ngũ cố vấn
Tạo tài nguyên CoAP đã chỉ định. Để biết thêm thông tin, hãy tham khảo bài viết Kiểm tra khả năng kết nối với tài nguyên Giao thức ứng dụng bị ràng buộc (CoAP) bằng OT CLI.
Tham số
coap post address uri-path [type] [payload]
address
: Địa chỉ IPv6 của máy chủ CoAP.uri-path
: Đường dẫn URI của tài nguyên.type
:con
: Có thể xác nhậnnon-con
: Không thể xác nhận (mặc định)block-
: Sử dụng tuỳ chọn này, theo sau là giá trị từng khối, để gửi các khối với số byte được tạo ngẫu nhiên cho tải trọng. Các giá trị hợp lệ là:block-16
,block-32
,block-64
,block-128
,block-256
,block-512
hoặcblock-1024
.
payload
: Yêu cầu tải trọng CoAP, nếu được sử dụng sẽ là một chuỗi hoặc một số nguyên, tuỳ thuộc vàotype
. Nếutype
làcon
hoặcnon-con
, tham sốpayload
là không bắt buộc. Nếu bạn bỏ qua tham sốpayload
, thì một tải trọng trống sẽ được gửi. Tuy nhiên, nếu bạn sử dụng tham sốpayload
, thì giá trị của tham số này phải là một chuỗi, chẳng hạn nhưhellothere
. Nếutype
làblock-
, thì giá trị của tham sốpayload
phải là một số nguyên chỉ định số lượng khối cần gửi. Loạiblock-
yêu cầu phải đặtOPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE
.
Ví dụ
coap post fdde:ad00:beef:0:2780:9423:166c:1aac test-resource con hellothere
Done
coap post fdde:ad00:beef:0:2780:9423:166c:1aac test-resource block-1024 10
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
CANNOT TRANSLATE
Sửa đổi tài nguyên CoAP được chỉ định. Để biết thêm thông tin, hãy tham khảo bài viết Kiểm tra khả năng kết nối với tài nguyên Giao thức ứng dụng bị ràng buộc (CoAP) bằng OT CLI.
Tham số
coap put address uri-path [type] [payload]
address
: Địa chỉ IPv6 của máy chủ CoAP.uri-path
: Đường dẫn URI của tài nguyên.type
:con
: Có thể xác nhậnnon-con
: Không thể xác nhận (mặc định)block-
: Sử dụng tuỳ chọn này, theo sau là giá trị từng khối, để gửi các khối với số byte được tạo ngẫu nhiên cho tải trọng. Các giá trị hợp lệ là:block-16
,block-32
,block-64
,block-128
,block-256
,block-512
hoặcblock-1024
.
payload
: Yêu cầu tải trọng CoAP, nếu được sử dụng sẽ là một chuỗi hoặc một số nguyên, tuỳ thuộc vàotype
. Nếutype
làcon
hoặcnon-con
, tham sốpayload
là không bắt buộc. Nếu bạn bỏ qua tham sốpayload
, thì một tải trọng trống sẽ được gửi. Tuy nhiên, nếu bạn sử dụng tham sốpayload
, thì giá trị của tham số này phải là một chuỗi, chẳng hạn nhưhellothere
. Nếutype
làblock-
, thì giá trị của tham sốpayload
phải là một số nguyên chỉ định số lượng khối cần gửi. Loạiblock-
yêu cầu phải đặtOPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE
.
Ví dụ
coap put fdde:ad00:beef:0:2780:9423:166c:1aac test-resource con hellothere
Done
coap put fdde:ad00:beef:0:2780:9423:166c:1aac test-resource block-1024 10
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
tài nguyên coap (lấy,đặt)
Lấy hoặc thiết lập đường dẫn URI của tài nguyên máy chủ CoAP.
Tham số
coap resource [uri-path]
Ví dụ
coap resource test-resource
Done
coap resource
test-resource
Done
Tài liệu tham khảo về CLI và API
bộ coap
Thiết lập nội dung do tài nguyên trên máy chủ CoAP gửi. Nếu một ứng dụng CoAP đang quan sát tài nguyên, thì một thông báo sẽ được gửi đến ứng dụng đó.
Tham số
coap set new-content
Ví dụ
coap set Testing123
Done
Tài liệu tham khảo về CLI và API
bắt đầu coap
Khởi động máy chủ CoAP. Để biết thêm thông tin, hãy tham khảo bài viết Kiểm tra khả năng kết nối với tài nguyên Giao thức ứng dụng bị ràng buộc (CoAP) bằng OT CLI.
Tham số
Không có tham số.
Ví dụ
coap start
Done
Tài liệu tham khảo về CLI và API
dừng cao tốc
Dừng máy chủ CoAP.
Tham số
Không có tham số.
Ví dụ
coap stop
Done
Tài liệu tham khảo về CLI và API
kết nối với coaps
Khởi chạy phiên Bảo mật tầng truyền tải Datagram (DTLS) với một ứng dụng ngang hàng. Để biết thêm thông tin, hãy tham khảo bài viết Kiểm tra khả năng kết nối với tài nguyên bảo mật giao thức ứng dụng (CoAPS) bị ràng buộc bằng OT CLI.
Tham số
coaps connect address
Tham số address
là địa chỉ IPv6 của ứng dụng ngang hàng.
Ví dụ
coaps connect fdde:ad00:beef:0:9903:14b:27e0:5744
Done
coaps connected
Tài liệu tham khảo về CLI và API
xoá loạt video
Chuỗi tải trọng CoAPS cần xoá.
Tham số
coaps delete uri-path [type] [payload]
uri-path
: Đường dẫn URI của tài nguyên.type
:con
: Có thể xác nhậnnon-con
: Không thể xác nhận (mặc định)
payload
: Yêu cầu tải trọng CoAPS.
Ví dụ
coaps delete test-resource con hellothere
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
CANNOT TRANSLATE
Dừng phiên DTLS.
Tham số
Không có tham số.
Ví dụ
coaps disconnect
coaps disconnected
Done
Tài liệu tham khảo về CLI và API
coa nhận được
Lấy thông tin về tài nguyên CoAPS được chỉ định trên máy chủ CoAPS. Để biết thêm thông tin, hãy tham khảo bài viết Kiểm tra khả năng kết nối với tài nguyên bảo mật giao thức ứng dụng (CoAPS) bị ràng buộc bằng OT CLI.
Tham số
coaps get uri-path [type]
uri-path
: Đường dẫn URI của tài nguyên.type
:con
: Có thể xác nhậnnon-con
: Không thể xác nhận (mặc định)block-
: Sử dụng tuỳ chọn này, theo sau là giá trị chặn, nếu phản hồi phải được truyền theo khối. Các giá trị hợp lệ là:block-16
,block-32
,block-64
,block-128
,block-256
,block-512
hoặcblock-1024
.
Ví dụ
coaps get test-resource
Done
coaps get test-resource block-1024
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
coa đã đóng
Cho biết dịch vụ CoAP Secure đã bị đóng hay chưa. Để biết thêm thông tin, hãy tham khảo bài viết Kiểm tra khả năng kết nối với tài nguyên bảo mật giao thức ứng dụng (CoAPS) bị ràng buộc bằng OT CLI.
Tham số
Không có tham số.
Ví dụ
coaps isclosed
no
Done
Tài liệu tham khảo về CLI và API
coa không hoạt động
Cho biết kết nối dịch vụ CoAP Secure có đang hoạt động (đã được kết nối hoặc đang trong quá trình thiết lập kết nối). Để biết thêm thông tin, hãy tham khảo bài viết Kiểm tra khả năng kết nối với tài nguyên bảo mật giao thức ứng dụng (CoAPS) bị ràng buộc bằng OT CLI.
Tham số
Không có tham số.
Ví dụ
coaps isconnactive
yes
Done
Tài liệu tham khảo về CLI và API
coaps đã được kết nối
Cho biết dịch vụ CoAP Secure đã được kết nối chưa. Để biết thêm thông tin, hãy tham khảo bài viết Kiểm tra khả năng kết nối với tài nguyên bảo mật giao thức ứng dụng (CoAPS) bị ràng buộc bằng OT CLI.
Tham số
Không có tham số.
Ví dụ
coaps isconnected
yes
Done
Tài liệu tham khảo về CLI và API
bài đăng trên coop
Tạo tài nguyên CoAPS được chỉ định. Để biết thêm thông tin, hãy tham khảo bài viết Kiểm tra khả năng kết nối với tài nguyên bảo mật giao thức ứng dụng (CoAPS) bị ràng buộc bằng OT CLI.
Tham số
uri-path [type] [payload]
uri-path
: Đường dẫn URI của tài nguyên.type
:con
: Có thể xác nhậnnon-con
: Không thể xác nhận (mặc định)block-
: Sử dụng tuỳ chọn này, theo sau là giá trị từng khối, để gửi các khối với số byte được tạo ngẫu nhiên cho tải trọng. Các giá trị hợp lệ là:block-16
,block-32
,block-64
,block-128
,block-256
,block-512
hoặcblock-1024
.
payload
: Yêu cầu tải trọng CoAPS, nếu được sử dụng là một chuỗi hoặc một số nguyên, tuỳ thuộc vàotype
. Nếutype
làcon
hoặcnon-con
, thì bạn không bắt buộc phải sử dụng tham số tải trọng. Nếu bạn bỏ qua thông số tải trọng, thì một tải trọng trống sẽ được gửi. Tuy nhiên, nếu bạn sử dụng tham số tải trọng, thì giá trị của tham số đó phải là một chuỗi, chẳng hạn nhưhellothere
. Nếutype
làblock-
, thì giá trị của thông số tải trọng phải là một số nguyên chỉ định số khối cần gửi. Loạiblock-
yêu cầu phải đặtOPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE
.
Ví dụ
coaps post test-resource con hellothere
Done
coaps post test-resource block-1024 10
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
coa psk
Đặt khoá được chia sẻ trước (PSK) và bộ thuật toán mật mã DTLS_PSK_WITH_AES_128_CCM_8.
Tham số
coaps psk psk-value psk-id
psk-value
: Khoá được chia sẻ trướcpsk-id
: Giá trị nhận dạng khoá được chia sẻ trước.
Ví dụ
coaps psk 1234 key1
Done
Tài liệu tham khảo về CLI và API
CANNOT TRANSLATE
Sửa đổi tài nguyên CoAPS được chỉ định. Để biết thêm thông tin, hãy tham khảo bài viết Kiểm tra khả năng kết nối với tài nguyên bảo mật giao thức ứng dụng (CoAPS) bị ràng buộc bằng OT CLI.
Tham số
uri-path [type] [payload]
uri-path
: Đường dẫn URI của tài nguyên.type
:con
: Có thể xác nhậnnon-con
: Không thể xác nhận (mặc định)block-
: Sử dụng tuỳ chọn này, theo sau là giá trị từng khối, để gửi các khối với số byte được tạo ngẫu nhiên cho tải trọng. Các giá trị hợp lệ là:block-16
,block-32
,block-64
,block-128
,block-256
,block-512
hoặcblock-1024
.
payload
: Yêu cầu tải trọng CoAPS, nếu được sử dụng là một chuỗi hoặc một số nguyên, tuỳ thuộc vàotype
. Nếutype
làcon
hoặcnon-con
, thì bạn không bắt buộc phải sử dụng tham số tải trọng. Nếu bạn bỏ qua thông số tải trọng, thì một tải trọng trống sẽ được gửi. Tuy nhiên, nếu bạn sử dụng tham số tải trọng, thì giá trị của tham số đó phải là một chuỗi, chẳng hạn nhưhellothere
. Nếutype
làblock-
, thì giá trị của thông số tải trọng phải là một số nguyên chỉ định số khối cần gửi. Loạiblock-
yêu cầu phải đặtOPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE
.
Ví dụ
coaps put test-resource con hellothere
Done
coaps put test-resource block-1024 10
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
tài nguyên coaps (lấy,đặt)
Lấy hoặc thiết lập đường dẫn URI của tài nguyên máy chủ CoAPS. Để biết thêm thông tin, hãy tham khảo bài viết Kiểm tra khả năng kết nối với tài nguyên bảo mật giao thức ứng dụng (CoAPS) bị ràng buộc bằng OT CLI.
Tham số
coaps resource [uri-path]
Ví dụ
coaps resource test-resource
Done
coaps resource
test-resource
Done
Tài liệu tham khảo về CLI và API
bộ coa
Thiết lập nội dung do tài nguyên trên máy chủ CoAPS gửi. Để biết thêm thông tin, hãy tham khảo bài viết Kiểm tra khả năng kết nối với tài nguyên bảo mật giao thức ứng dụng (CoAPS) bị ràng buộc bằng OT CLI.
Tham số
coaps set new-content
Ví dụ
coaps set Testing123
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
bắt đầu coa
Khởi động dịch vụ CoAP Secure. Để biết thêm thông tin, hãy tham khảo bài viết Kiểm tra khả năng kết nối với tài nguyên bảo mật giao thức ứng dụng (CoAPS) bị ràng buộc bằng OT CLI.
Tham số
coaps start [check-peer-cert | max-conn-attempts]
Tham số check-peer-cert
xác định xem tính năng kiểm tra chứng chỉ ngang hàng được bật (mặc định) hay tắt. Tham số max-conn-attempts
thiết lập số lần thử tối đa được phép, thành công hay không thành công, để kết nối với máy chủ CoAP Secure. Giá trị mặc định của tham số này là 0
, nghĩa là không có giới hạn về số lần thử. Tham số check-peer-cert
và max-conn-attempts
phối hợp với nhau trong các cách kết hợp sau đây, mặc dù bạn chỉ có thể chỉ định một đối số:
- Không có đối số nào được chỉ định: Sử dụng giá trị mặc định.
- Đặt
check-peer-cert
thànhtrue
: Có tác dụng tương tự như bỏ qua đối số, đó là giá trịcheck-peer-cert
làtrue
và giá trịmax-conn-attempts
bằng 0. - Đặt
check-peer-cert
thànhfalse
: giá trịcheck-peer-cert
làfalse
và giá trịmax-conn-attempts
là 0. - Chỉ định một số:
check-peer-cert
làtrue
và giá trịmax-conn-attempts
là số được chỉ định trong đối số.
Ví dụ
coaps start
Done
coaps start false
Done
coaps start 8
Done
Tài liệu tham khảo về CLI và API
dừng coa
Dừng dịch vụ CoAP Secure. Để biết thêm thông tin, hãy tham khảo bài viết Kiểm tra khả năng kết nối với tài nguyên bảo mật giao thức ứng dụng (CoAPS) bị ràng buộc bằng OT CLI.
Tham số
Không có tham số.
Ví dụ
coaps stop
Done
Tài liệu tham khảo về CLI và API
coa-x509
Đặt chứng chỉ X509 của thiết bị cục bộ bằng khoá riêng tư tương ứng cho phiên DTLS bằng DTLS_ECDHE_ECDSA_WITH_AES_128_CCM_8
.
Tham số
Không có tham số.
Ví dụ
coaps x509
Done
Tài liệu tham khảo về CLI và API
thông báo của ủy viên hội đồng
Gửi thông báo Bắt đầu thông báo.
Tham số
commissioner announce mask count period destination
mask
: Bitmask xác định các kênh gửi thông báo MLEAnnounce
.count
: Số lượt truyềnAnnounce
MLE trên mỗi kênh.period
: Số mili giây giữa các lần truyền MLEAnnounce
liên tiếp.destination
: Địa chỉ IPv6 đích cho thông báo. Thông báo có thể ở dạng đa hướng.
Ví dụ
commissioner announce 0x00050000 2 32 fdde:ad00:beef:0:0:ff:fe00:c00
Done
Tài liệu tham khảo về CLI và API
năng lượng ủy viên
Gửi thông báo Truy vấn quét năng lượng. Kết quả lệnh sẽ được in ngay khi nhận được.
Tham số
commissioner energy mask count period scanDuration destination
mask
: Bitmask xác định các kênh để thực hiện quét năng lượng IEEE 802.15.4.count
: Số lần quét năng lượng IEEE 802.15.4 trên mỗi kênh.period
: Số mili giây giữa các lần quét năng lượng IEEE 802.15.4 liên tiếp.scanDuration
: Thời lượng quét tính bằng mili giây để sử dụng khi quét năng lượng theo chuẩn IEEE 802.15.4.destination
: Địa chỉ IPv6 đích cho thông báo. Thông báo có thể ở dạng đa hướng.
Ví dụ
commissioner energy 0x00050000 2 32 1000 fdde:ad00:beef:0:0:ff:fe00:c00
Done
Energy: 00050000 0 0 0 0
Tài liệu tham khảo về CLI và API
mã nhận dạng bên thứ ba (get,set)
Lấy hoặc đặt tên mã uỷ quyền OpenThread.
Tham số
commissioner id name
Ví dụ
commissioner id OpenThread Commissioner
Done
commissioner id
OpenThread Commissioner
Done
Tài liệu tham khảo về CLI và API
CANNOT TRANSLATE
Thêm một mục nhập trình kết hợp.
Tham số
commissioner joiner add eui64|discerner pksd [timeout]
eui64
: IEEE EUI-64 của Người tham gia. Để khớp với bất kỳ trình kết hợp nào, hãy sử dụng*
.discerner
: Người tham gia ở định dạngnumber/length
.pksd
: Khoá được chia sẻ trước dành cho người tham gia.timeout
: Thời gian chờ của Trình tham gia tính bằng giây.
Ví dụ
commissioner joiner add d45e64fa83f81cf7 J01NME
Done
commissioner joiner add 0xabc/12 J01NME
Done
Tài liệu tham khảo về CLI và API
CANNOT TRANSLATE
Xoá một mục Tham gia.
Tham số
commissioner joiner remove eui64|discerner
eui64
: IEEE EUI-64 của đơn vị tham gia. Để khớp với bất kỳ trình kết hợp nào, hãy sử dụng*
.discerner
: Máy phân loại máy ghép ở định dạngnumber/length
.
Ví dụ
commissioner joiner remove d45e64fa83f81cf7
Done
commissioner joiner remove 0xabc/12
Done
Tài liệu tham khảo về CLI và API
bảng cố định kết hợp
Liệt kê tất cả các mục Joiner ở định dạng bảng.
Tham số
Không có tham số.
Ví dụ
commissioner joiner table
| ID | PSKd | Expiration |
+-----------------------+----------------------------------+------------+
| * | J01NME | 81015 |
| d45e64fa83f81cf7 | J01NME | 101204 |
| 0x0000000000000abc/12 | J01NME | 114360 |
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
quản lý ủy viên
Gửi thông báo MGMT_GET
(nhận Quản lý) cho Trưởng nhóm. Hệ thống sẽ trả về các giá trị biến đã đặt bằng lệnh commissioner mgmtset
.
Tham số
commissioner mgmtget [locator] [sessionid] [steeringdata] [joinerudpport] [-x TLVs]
locator
: Bộ định tuyến đường viền rlOC16.sessionid
: Mã phiên của Uỷ viên.steeringdata
: Dữ liệu về tay lái.joinerudpport
: Cổng UDP trình kết hợp.TLVs
: Tập hợp các TLV cần truy xuất.
Ví dụ
commissioner mgmtget locator sessionid
Done
Tài liệu tham khảo về CLI và API
bộ quản lý uỷ quyền
Gửi thông báo MGMT_SET
(Nhóm quản lý) cho Trưởng nhóm và đặt biến thành giá trị được chỉ định.
Tham số
commissioner mgmtset [locator locator] [sessionid sessionid] [steeringdata steeringdata] [joinerudpport joinerudpport] [-x TLVs]
locator
: Bộ định tuyến đường viền rlOC16.sessionid
: Mã phiên của Uỷ viên.steeringdata
: Dữ liệu về tay lái.joinerudpport
: Cổng UDP trình kết hợp.TLVs
: Tập hợp các TLV cần truy xuất.
Ví dụ
commissioner mgmtset joinerudpport 9988
Done
Tài liệu tham khảo về CLI và API
panid cố vấn
Gửi truy vấn về mã PAN. Kết quả lệnh được trả về khi thiết bị nhận được kết quả.
Tham số
commissioner panid panid mask destination
paind
: Mã PAN để dùng để kiểm tra xem có xung đột không.mask
; Bitmask xác định các kênh thực hiện Quét chủ động IEEE 802.15.4.destination
: Địa chỉ đích IPv6 cho thông báo. Thông báo có thể ở dạng đa hướng.
Ví dụ
commissioner panid 0xdead 0x7fff800 fdde:ad00:beef:0:0:ff:fe00:c00
Done
Conflict: dead, 00000800
Tài liệu tham khảo về CLI và API
url cấp phép của uỷ viên
Thiết lập URL cấp phép của Uỷ viên.
Tham số
commissioner provisioningurl provisioningurl
Ví dụ
commissioner provisioningurl http://github.com/openthread/openthread
Done
Tài liệu tham khảo về CLI và API
mã phiên của cố vấn
Lấy mã phiên hiện tại của Uỷ viên.
Tham số
Không có tham số.
Ví dụ
commissioner sessionid
0
Done
Tài liệu tham khảo về CLI và API
bắt đầu cấp ủy viên
Bắt đầu vai trò Ủy viên luồng.
Tham số
Không có tham số.
Ví dụ
commissioner start
Commissioner: petitioning
Done
Commissioner: active
Tài liệu tham khảo về CLI và API
trạng thái của ủy viên hội đồng
Trả về trạng thái hiện tại của Uỷ viên. Các giá trị có thể là active
, disabled
hoặc petition
(yêu cầu trở thành Ủy viên).
Tham số
Không có tham số.
Ví dụ
commissioner state
active
Done
Tài liệu tham khảo về CLI và API
điểm dừng của cố vấn
Ngừng vai trò Ủy viên luồng.
Tham số
Không có tham số.
Ví dụ
commissioner stop
Done
Tài liệu tham khảo về CLI và API
dùng lại bối cảnh (lấy,đặt)
Lấy hoặc đặt giá trị CONTEXT_ID_REUSE_DELAY
.
Tham số
contextreusedelay delay
Dùng đối số delay
(không bắt buộc) để thiết lập CONTEXT_ID_REUSE_DELAY
.
Ví dụ
contextreusedelay
11
Done
contextreusedelay 11
Done
Tài liệu tham khảo về CLI và API
bộ đếm (mac)
Lấy bộ đếm lớp MAC.
Tham số
counters mac
Ví dụ
counters mac
TxTotal: 10
TxUnicast: 3
TxBroadcast: 7
TxAckRequested: 3
TxAcked: 3
TxNoAckRequested: 7
TxData: 10
TxDataPoll: 0
TxBeacon: 0
TxBeaconRequest: 0
TxOther: 0
TxRetry: 0
TxErrCca: 0
TxErrBusyChannel: 0
RxTotal: 2
RxUnicast: 1
RxBroadcast: 1
RxData: 2
RxDataPoll: 0
RxBeacon: 0
RxBeaconRequest: 0
RxOther: 0
RxAddressFiltered: 0
RxDestAddrFiltered: 0
RxDuplicated: 0
RxErrNoFrame: 0
RxErrNoUnknownNeighbor: 0
RxErrInvalidSrcAddr: 0
RxErrSec: 0
RxErrFcs: 0
RxErrOther: 0
Done
Tài liệu tham khảo về CLI và API
bộ đếm (mle)
Lấy bộ đếm Thread MLE.
Tham số
counters mle
Ví dụ
counters mle
Role Disabled: 0
Role Detached: 1
Role Child: 0
Role Router: 0
Role Leader: 1
Attach Attempts: 1
Partition Id Changes: 1
Better Partition Attach Attempts: 0
Parent Changes: 0
Done
Tài liệu tham khảo về CLI và API
bộ đếm
Lấy tên bộ đếm được hỗ trợ.
Tham số
Không có tham số.
Ví dụ
counters
ip
mac
mle
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
IP bộ đếm
Lấy bộ đếm IPv6.
Tham số
counters ip
Ví dụ
counters ip
TxSuccess: 10
TxFailed: 0
RxSuccess: 5
RxFailed: 0
Done
Tài liệu tham khảo về CLI và API
đặt lại ip bộ đếm
Đặt lại bộ đếm IPv6.
Tham số
counters ip reset
Ví dụ
counters ip reset
Done
Tài liệu tham khảo về CLI và API
đặt lại bộ đếm trên mac
Đặt lại bộ đếm lớp MAC.
Tham số
counters mac reset
Ví dụ
counters mac reset
Done
Tài liệu tham khảo về CLI và API
đặt lại bộ đếm mle
Đặt lại bộ đếm MLE Thread.
Tham số
counters mle reset
Ví dụ
counters mle reset
Done
Tài liệu tham khảo về CLI và API
kênh csl
Thiết lập kênh CSL.
Tham số
csl channel channel
Ví dụ
csl channel 20
Done
Tài liệu tham khảo về CLI và API
csl
Lấy cấu hình CSL.
Tham số
Không có tham số.
Ví dụ
csl
Channel: 11
Period: 160000us
Timeout: 1000s
Done
Tài liệu tham khảo về CLI và API
khoảng thời gian csl
Đặt khoảng thời gian CSL tính bằng micrô giây.
Tắt CSL bằng cách đặt thông số này thành 0
.
Kỳ CSL PHẢI là bội số của OT_LINK_CSL_PERIOD_TEN_SYMBOLS_UNIT_IN_USEC
, nếu không, hàm sẽ trả về OT_ERROR_INVALID_ARGS
.
Tham số
csl period period
Ví dụ
csl period 3000000
Done
Tài liệu tham khảo về CLI và API
hết thời gian chờ csl
Đặt thời gian chờ CSL tính bằng giây.
Tham số
csl timeout timeout
Ví dụ
cls timeout 10
Done
Tài liệu tham khảo về CLI và API
tập dữ liệu đang hoạt động
Lấy tập dữ liệu hoạt động đang hoạt động.
OT CLI sử dụng các thành phần otOperationalDataset để trả về các giá trị của tập dữ liệu cho bảng điều khiển.
Tham số
dataset active [-x]
Đối số -x
không bắt buộc in các giá trị Tập dữ liệu hoạt động đang hoạt động dưới dạng TLV được mã hoá theo hệ thập lục phân.
Ví dụ
dataset active
Active Timestamp: 1
Channel: 13
Channel Mask: 0x07fff800
Ext PAN ID: d63e8e3e495ebbc3
Mesh Local Prefix: fd3d:b50b:f96d:722d::/64
Network Key: dfd34f0f05cad978ec4e32b0413038ff
Network Name: OpenThread-8f28
PAN ID: 0x8f28
PSKc: c23a76e98f1a6483639b1ac1271e2e27
Security Policy: 0, onrcb
Done
dataset active -x
0e08000000000001000000030000103506000...3023d82c841eff0e68db86f35740c030000ff
Done
Tài liệu tham khảo về CLI và API
dấu thời gian hoạt động của tập dữ liệu (lấy, đặt)
Lấy hoặc đặt otOperationalDataset::mActiveTimestamp.
Tham số
dataset activetimestamp [timestamp]
Truyền đối số timestamp
(không bắt buộc) để thiết lập dấu thời gian hoạt động.
Ví dụ
dataset activetimestamp
123456789
Done
dataset activetimestamp 123456789
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
kênh tập dữ liệu (lấy,đặt)
Lấy hoặc đặt otOperationalDataset::mChannel.
Tham số
dataset channel [channel-num]
Dùng đối số channel-num
(không bắt buộc) để thiết lập kênh.
Ví dụ
dataset channel
12
Done
dataset channel 12
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
mặt nạ kênh tập dữ liệu (lấy,đặt)
Lấy hoặc đặt otOperationalDataset::mChannelMask
Tham số
dataset channelmask [channel-mask]
Dùng đối số channel-mask
(không bắt buộc) để đặt mặt nạ kênh.
Ví dụ
dataset channelmask
0x07fff800
Done
dataset channelmask 0x07fff800
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
xoá tập dữ liệu
Đặt lại vùng đệm Tập dữ liệu hoạt động.
Tham số
Không có tham số.
Ví dụ
dataset clear
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
xác nhận tập dữ liệu đang hoạt động
Xác nhận vùng đệm Tập dữ liệu hoạt động vào Tập dữ liệu hoạt động đang hoạt động.
Tham số
Không có tham số.
Ví dụ
dataset commit active
Done
Tài liệu tham khảo về CLI và API
đang chờ xác nhận tập dữ liệu
Xác nhận vùng đệm Tập dữ liệu hoạt động vào Tập dữ liệu hoạt động đang chờ xử lý.
Tham số
Không có tham số.
Ví dụ
dataset commit pending
Done
Tài liệu tham khảo về CLI và API
độ trễ của tập dữ liệu (get,set)
Lấy hoặc tập hợp otOperationalDataset::mDelay.
Tham số
dataset delay [delay]
Dùng đối số delay
không bắt buộc để đặt giá trị bộ tính giờ trễ.
Ví dụ
dataset delay
1000
Done
dataset delay 1000
Done
Tài liệu tham khảo về CLI và API
extpanid tập dữ liệu (get,set)
Lấy hoặc đặt otOperationalDataset::mExtendedPanId.
Tham số
dataset extpanid [extpanid]
Dùng đối số extpanid
(không bắt buộc) để đặt mã nhận dạng Extended Personal Area Network.
Ví dụ
dataset extpanid
000db80123456789
Done
dataset extpanid 000db80123456789
Done
Tài liệu tham khảo về CLI và API
trợ giúp về tập dữ liệu
Lấy danh sách các lệnh CLI dataset
. Để biết thêm thông tin, hãy tham khảo bài viết Hiển thị và quản lý tập dữ liệu bằng OT CLI.
Tham số
Không có tham số.
Ví dụ
dataset help
help
active
activetimestamp
channel
channelmask
clear
commit
delay
extpanid
init
meshlocalprefix
mgmtgetcommand
mgmtsetcommand
networkkey
networkname
panid
pending
pendingtimestamp
pskc
securitypolicy
set
tlvs
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
tập dữ liệu init (đang hoạt động,mới,đang chờ xử lý,tlvs)
OT CLI sẽ kiểm tra active
, pending
hoặc tlvs
và trả về các giá trị tương ứng. Nếu không, OT CLI sẽ tạo một mạng mới, ngẫu nhiên và trả về một tập dữ liệu mới.
Tham số
dataset init {active|new|pending|tlvs} [hex-encoded-tlvs]
Dùng new
để khởi tạo một tập dữ liệu mới, sau đó nhập lệnh dataset commit active
. Sử dụng tlvs
cho các TLV được mã hoá theo hệ thập lục phân.
Ví dụ
dataset init new
Done
Tài liệu tham khảo về CLI và API
tập dữ liệu Gridlocalprefix (get,set)
Lấy hoặc đặt otOperationalDataset::mMeshLocalPrefix.
Tham số
dataset meshlocalprefix [meshlocalprefix]
Sử dụng đối số meshlocalprefix
không bắt buộc để đặt Tiền tố Mesh-Local.
Ví dụ
dataset meshlocalprefix
fd00:db8:0:0::/64
Done
dataset meshlocalprefix fd00:db8:0:0::
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
tập dữ liệu mgmtgetcommand đang hoạt động
Gửi MGMT_ACTIVE_GET.
OT CLI sẽ gửi MGMT_ACTIVE_GET với các đối số có liên quan. Để tìm hiểu thêm về các tham số và cách ánh xạ đối số này, hãy tham khảo bài viết Hiển thị và quản lý tập dữ liệu bằng OT CLI.
Tham số
dataset mgmtgetcommand active [address leader-address] [dataset-components] [-x tlv-list]
- Sử dụng
address
để chỉ định đích đến IPv6; nếu không, ALOC của nhà lãnh đạo sẽ được dùng theo mặc định. - Đối với
dataset-components
, bạn có thể truyền bất kỳ tổ hợp otOperationalDatasetComponents nào, ví dụ:activetimestamp
,pendingtimestamp
hoặcnetworkkey
. - Đối số
-x
không bắt buộc chỉ định các TLV thô cần được yêu cầu.
Ví dụ
dataset mgmtgetcommand active address fdde:ad00:beef:0:558:f56b:d688:799 activetimestamp securitypolicy
Done
dataset mgmtgetcommand active networkname
Done
Tài liệu tham khảo về CLI và API
- otDatasetSendMgmtActiveGet
- dataset mgmtgetcommand đang chờ xử lý
- dataset mgmtsetcommand đang hoạt động
- dataset mgmtsetcommand đang chờ xử lý
tập dữ liệu mgmtgetcommand đang chờ xử lý
Gửi MGMT_PENDING_GET.
Tham số
dataset mgmtgetcommand pending [address leader-address] [dataset-components] [-x tlv-list]
Để tìm hiểu thêm về các tham số và cách ánh xạ đối số này, hãy tham khảo bài viết Hiển thị và quản lý tập dữ liệu bằng OT CLI.
Ví dụ
dataset mgmtgetcommand pending address fdde:ad00:beef:0:558:f56b:d688:799 activetimestamp securitypolicy
Done
dataset mgmtgetcommand pending networkname
Done
Tài liệu tham khảo về CLI và API
- otDatasetSendMgmtPendingGet
- dataset mgmtgetcommand đang hoạt động
- dataset mgmtsetcommand đang hoạt động
- dataset mgmtsetcommand đang chờ xử lý
tập dữ liệu mgmtsetcommand đang hoạt động
Gửi MGMT_ACTIVE_SET.
Tham số
dataset mgmtsetcommand active [dataset-components] [-x tlv-list]
Để tìm hiểu thêm về các tham số và cách ánh xạ đối số này, hãy tham khảo bài viết Hiển thị và quản lý tập dữ liệu bằng OT CLI.
Ví dụ
dataset mgmtsetcommand active activetimestamp 123 securitypolicy 1 onrcb
Done
Tài liệu tham khảo về CLI và API
- otDatasetSendMgmtActiveSet
- dataset mgmtgetcommand đang hoạt động
- dataset mgmtgetcommand đang chờ xử lý
- dataset mgmtsetcommand đang chờ xử lý
tập dữ liệu mgmtsetcommand đang chờ xử lý
Gửi MGMT_PENDING_SET.
Tham số
dataset mgmtsetcommand pending [dataset-components] [-x tlv-list]
Để tìm hiểu thêm về các tham số và cách ánh xạ đối số này, hãy tham khảo bài viết Hiển thị và quản lý tập dữ liệu bằng OT CLI.
Ví dụ
dataset mgmtsetcommand pending activetimestamp 123 securitypolicy 1 onrcb
Done
Tài liệu tham khảo về CLI và API
- otDatasetSendMgmtPendingSet
- dataset mgmtgetcommand đang hoạt động
- dataset mgmtgetcommand đang chờ xử lý
- dataset mgmtsetcommand đang hoạt động
khoá mạng tập dữ liệu (lấy,đặt)
Lấy hoặc tập hợp otOperationalDataset::mNetworkKey.
Tham số
dataset networkkey [key]
Dùng đối số key
không bắt buộc để đặt Khoá mạng.
Ví dụ
dataset networkkey
00112233445566778899aabbccddeeff
Done
dataset networkkey 00112233445566778899aabbccddeeff
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
tên mạng của tập dữ liệu (lấy,đặt)
Lấy hoặc tập hợp otOperationalDataset::mNetworkName.
Tham số
dataset networkname [name]
Sử dụng đối số name
không bắt buộc để đặt Tên mạng.
Ví dụ
dataset networkname
OpenThread
Done
dataset networkname OpenThread
Done
Tài liệu tham khảo về CLI và API
panid tập dữ liệu (lấy,đặt)
Lấy hoặc đặt otOperationalDataset::mPanId.
Tham số
dataset panid [panid]
Sử dụng đối số panid
(không bắt buộc) để đặt mã PAN.
Ví dụ
dataset panid
0x1234
Done
dataset panid 0x1234
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
dấu thời gian đang chờ xử lý của tập dữ liệu (lấy,đặt)
Lấy hoặc đặt otOperationalDataset::mPendingTimestamp.
Tham số
dataset pendingtimestamp [timestamp]
Dùng đối số timestamp
(không bắt buộc) để thiết lập số giây trong dấu thời gian đang chờ xử lý.
Ví dụ
dataset pendingtimestamp
123456789
Done
dataset pendingtimestamp 123456789
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
tập dữ liệu pskc (get,set)
Lấy hoặc tập hợp otOperationalDataset::mPskc.
Tham số
dataset pskc [-p passphrase] | [key]
Chỉ dành cho FTD, hãy sử dụng -p
với đối số passphrase
. -p
tạo một pskc từ passphrase
được mã hoá UTF-8 mà bạn cung cấp, cùng với tên mạng và mã PAN mở rộng. Nếu được đặt, -p
sẽ sử dụng vùng đệm tập dữ liệu; nếu không, nó sẽ sử dụng ngăn xếp hiện tại. Ngoài ra, bạn có thể đặt pskc thành key
(định dạng thập lục phân).
Ví dụ
dataset pskc
67c0c203aa0b042bfb5381c47aef4d9e
Done
dataset pskc -p 123456
Done
dataset pskc 67c0c203aa0b042bfb5381c47aef4d9e
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
chính sách bảo mật tập dữ liệu (lấy,đặt)
Lấy hoặc thiết lập chính sách bảo mật Tập dữ liệu.
Tham số
dataset securitypolicy [rotationtime [onrcCepR]]
- Sử dụng
rotationtime
chothrKeyRotation
, theo đơn vị giờ. - Các lệnh trong Chính sách bảo mật sử dụng các liên kết đối số
onrcCepR
để tải và đặt các thành phần otSecurityPolicy, chẳng hạn nhưo
đại diện cho otSecurityPolicy::mObtainNetworkKeyEnabled. Để biết thêm thông tin, hãy tham khảo bài viết Hiển thị và quản lý tập dữ liệu bằng OT CLI.
Ví dụ
dataset securitypolicy
672 onrc
Done
dataset securitypolicy 672 onrc
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
tập dữ liệu (đang hoạt động,đang chờ xử lý)
Đặt tập dữ liệu hoạt động đang hoạt động.
Nếu tập dữ liệu không bao gồm Dấu thời gian hoạt động, thì tập dữ liệu chỉ hoàn chỉnh một phần.
Nếu bạn bật Thread trên một thiết bị có Tập dữ liệu đang hoạt động hoàn chỉnh một phần, thì thiết bị sẽ tìm cách đính kèm vào một mạng Thread hiện có bằng cách sử dụng mọi thông tin hiện có trong tập dữ liệu. Bạn chỉ cần có Khoá mạng Thread để đính kèm vào mạng.
Nếu kênh không có trong tập dữ liệu, thì thiết bị sẽ gửi tin nhắn Thông báo MLE trên nhiều kênh để tìm kết nối trên các kênh khác.
Nếu kết nối thành công với một mạng Thread, thì thiết bị sẽ truy xuất toàn bộ Tập dữ liệu đang hoạt động từ Tập dữ liệu mẹ. Lưu ý rằng một thiết bị hỗ trợ bộ định tuyến sẽ không chuyển đổi sang vai trò Bộ định tuyến hoặc Người lãnh đạo cho đến khi có Tập dữ liệu hoạt động hoàn chỉnh.
Hàm này trả về OT_ERROR_NONE
một cách nhất quán và có thể được coi là có loại dữ liệu trả về void
một cách hiệu quả. Trước đây, các lỗi khác (ví dụ: OT_ERROR_NOT_IMPLEMENTED
) được cho phép vì các lý do cũ. Tuy nhiên, vì bộ nhớ không biến động giờ đây là bắt buộc đối với hoạt động Thread, nên bất kỳ lỗi nào không lưu tập dữ liệu sẽ kích hoạt xác nhận. Kiểu dữ liệu trả về otError
được giữ lại để có khả năng tương thích ngược.
Lệnh dataset set
CLI thiết lập Tập dữ liệu hoạt động đang hoạt động bằng cách sử dụng các TLV được mã hoá theo hệ thập lục phân.
Tham số
dataset set {active|pending} tlvs
Ví dụ
dataset set active 0e08000000000001000000030000103506000...3023d82c841eff0e68db86f35740c030000ff
Done
dataset set pending 0e08000000000001000000030000103506000...3023d82c841eff0e68db86f35740c030000ff
Done
Tài liệu tham khảo về CLI và API
tập dữ liệu, tlvs
Chuyển đổi một Tập dữ liệu toán tử cho trước thành
otOperationalDatasetTlvs
.
Tham số
Không có tham số.
Ví dụ
dataset tlvs
0e080000000000010000000300001635060004001fffe0020...f7f8
Done
Tài liệu tham khảo về CLI và API
huỷ trình cập nhật tập dữ liệu
Huỷ yêu cầu cập nhật Tập dữ liệu hoạt động đang diễn ra (nếu có).
Có sẵn khi bạn bật OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE
.
Tham số
Không có tham số.
Ví dụ
@dataset updater cancel
Done
Tài liệu tham khảo về CLI và API
trình cập nhật tập dữ liệu
Cho biết liệu có yêu cầu cập nhật Tập dữ liệu hoạt động đang diễn ra hay không.
Có sẵn khi bạn bật OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE
.
Tham số
Không có tham số.
Ví dụ
dataset updater
Enabled
Done
Tài liệu tham khảo về CLI và API
bắt đầu trình cập nhật tập dữ liệu
Yêu cầu cập nhật Tập dữ liệu hoạt động.
Có sẵn khi bạn bật OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE
.
aDataset
phải chứa các trường cần cập nhật và giá trị mới của các trường đó. URL này không được chứa trường Dấu thời gian đang hoạt động hoặc Đang chờ xử lý. Trường Độ trễ là không bắt buộc, nếu không được cung cấp thì giá trị mặc định (1000 mili giây) sẽ được sử dụng.
Tham số
Không có tham số.
Ví dụ
channel
19
Done
dataset clear
Done
dataset channel 15
Done
dataset
Channel: 15
Done
dataset updater start
Done
dataset updater
Enabled
Done
Dataset update complete: OK
channel
15
Done
Tài liệu tham khảo về CLI và API
gỡ lỗi
Thực thi một loạt các lệnh CLI để thu thập thông tin về thiết bị và mạng luồng. Mục đích của việc này là gỡ lỗi. Kết quả sẽ hiển thị từng lệnh CLI đã thực thi theo sau $
, theo sau là đầu ra đã tạo của lệnh tương ứng. Kết quả được tạo bao gồm những thông tin sau:
- Phiên bản
- Trạng thái hiện tại
- rlOC16, địa chỉ MAC mở rộng
- Danh sách địa chỉ IPv6 Unicast và multicast
- Kênh
- Mã PAN và mã PAN mở rộng
- Dữ liệu mạng
- Mã phân vùng
- Dữ liệu về nhà lãnh đạo
Nếu thiết bị đang hoạt động ở chế độ FTD:
- Bảng con và bảng hàng xóm
- Bảng bộ định tuyến và thông tin hop tiếp theo
- Bảng bộ nhớ đệm của địa chỉ
- Địa chỉ IPv6 con MTD đã đăng ký
- Thuộc tính của thiết bị
Nếu thiết bị hỗ trợ và hoạt động như một ứng dụng SRP:
- Trạng thái ứng dụng SRP
- Dịch vụ khách hàng SRP và thông tin máy chủ lưu trữ
Nếu thiết bị hỗ trợ và hoạt động như một máy chủ SRP:
- Trạng thái máy chủ SRP và chế độ địa chỉ
- Máy chủ lưu trữ và dịch vụ đã đăng ký SRP
Nếu thiết bị hỗ trợ TREL:
- Trạng thái TREL và bảng ngang hàng
Nếu thiết bị hỗ trợ và hoạt động như một bộ định tuyến biên:
- Tiểu bang ở Brazil
- Tiền tố BR (OMR, on-link, NAT64)
- Đã tìm ra bảng tiền tố
Tham số
Không có tham số.
Ví dụ
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
thời gian trễ tối thiểu (đã đặt)
Đặt bộ tính giờ trễ tối thiểu (tính bằng giây).
Tham số
delaytimermin delaytimermin
Ví dụ
delaytimermin 60
Done
Tài liệu tham khảo về CLI và API
thời gian trễ tối thiểu
Nhận đồng hồ hẹn giờ trễ tối thiểu (tính bằng giây).
Tham số
Không có tham số.
Ví dụ
delaytimermin
30
Done
Tài liệu tham khảo về CLI và API
tách chế độ không đồng bộ
Bắt đầu quá trình tách một cách linh hoạt tương tự như lệnh detach
mà không cần chặn và chờ lệnh gọi lại cho biết quá trình tách đã hoàn tất.
Tham số
Không có tham số.
Ví dụ
detach async
Done
Tài liệu tham khảo về CLI và API
tách
Bắt đầu quá trình tách riêng biệt bằng cách thông báo trước cho các nút khác (gửi bản phát hành địa chỉ nếu hoạt động như một bộ định tuyến hoặc đặt giá trị Thời gian chờ của con thành 0 trên thư mục mẹ nếu đóng vai trò là thành phần con) rồi dừng thao tác giao thức Thread.
Tham số
Không có tham số.
Ví dụ
detach
Finished detaching
Done
Tài liệu tham khảo về CLI và API
thiết bị (set)
Thiết lập các thuộc tính của thiết bị.
Tham số
deviceprops powerSupply isBr supportsCcm isUnstable weightAdjustment
powerSupply
: phải là "pin", "bên ngoài", "ổn định bên ngoài", "ổn định bên ngoài".
Ví dụ
deviceprops battery 0 0 0 -5
Done
deviceprops
PowerSupply : battery
IsBorderRouter : no
SupportsCcm : no
IsUnstable : no
WeightAdjustment : -5
Done
Tài liệu tham khảo về CLI và API
deviceprops
Lấy các thuộc tính hiện tại của thiết bị.
Cần có OPENTHREAD_CONFIG_MLE_DEVICE_PROPERTY_LEADER_WEIGHT_ENABLE
.
Tham số
Không có tham số.
Ví dụ
deviceprops
PowerSupply : external
IsBorderRouter : yes
SupportsCcm : no
IsUnstable : no
WeightAdjustment : 0
Done
Tài liệu tham khảo về CLI và API
discover
Thực hiện thao tác Khám phá MLE.
Tham số
discover [channel]
channel
: Kênh để khám phá. Nếu bạn không cung cấp kênh nào, thì dữ liệu khám phá sẽ bao gồm mọi kênh hợp lệ.
Ví dụ
discover
| J | Network Name | Extended PAN | PAN | MAC Address | Ch | dBm | LQI |
+---+------------------+------------------+------+------------------+----+-----+-----+
| 0 | OpenThread | dead00beef00cafe | ffff | f1d92a82c8d8fe43 | 11 | -20 | 0 |
Done
Tài liệu tham khảo về CLI và API
khám phá lệnh gọi lại yêu cầu (bật,tắt)
Đặt lệnh gọi lại để nhận dữ liệu Yêu cầu khám phá MLE.
Tham số
discover reqcallback enable|disable
Ví dụ
discover reqcallback enable
Done
Tài liệu tham khảo về CLI và API
duyệt qua DNS
Gửi một truy vấn DNS duyệt qua (liệt kê thực thể dịch vụ) để lấy danh sách dịch vụ cho tên dịch vụ đã cho
Các tham số sau service-name
là không bắt buộc. Mọi giá trị chưa chỉ định (hoặc bằng 0) cho các tham số không bắt buộc này sẽ được thay thế bằng giá trị trong cấu hình mặc định hiện tại (dns config
).
Tham số
dns browse service-name [dns-server-IP] [dns-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean]
Ví dụ
dns browse _service._udp.example.com
DNS browse response for _service._udp.example.com.
inst1
Port:1234, Priority:1, Weight:2, TTL:7200
Host:host.example.com.
HostAddress:fd00:0:0:0:0:0:0:abcd TTL:7200
TXT:[a=6531, b=6c12] TTL:7300
instance2
Port:1234, Priority:1, Weight:2, TTL:7200
Host:host.example.com.
HostAddress:fd00:0:0:0:0:0:0:abcd TTL:7200
TXT:[a=1234] TTL:7300
Done
dns browse _airplay._tcp.default.service.arpa
DNS browse response for _airplay._tcp.default.service.arpa.
Mac mini
Port:7000, Priority:0, Weight:0, TTL:10
Host:Mac-mini.default.service.arpa.
HostAddress:fd97:739d:386a:1:1c2e:d83c:fcbe:9cf4 TTL:10
Done
Tài liệu tham khảo về CLI và API
Nén dns (bật,tắt)
Đặt "nén tên DNS" .
Tính năng nén tên DNS được bật theo mặc định. Khi bạn tắt chế độ này, tên DNS sẽ được thêm vào dưới dạng đầy đủ và không bao giờ được nén. Cách này áp dụng cho các mô-đun máy khách/máy chủ DNS và SRP của OpenThread." Phải nhập thông tin vào trường OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
.
Tham số
dns compression [enable|disable]
Ví dụ
dns compression enable
Enabled
dns compression disable
Done
dns compression
Disabled
Done
Tài liệu tham khảo về CLI và API
nén dns
Cho biết liệu tính năng "nén tên DNS" đã được bật hay chưa.
Tính năng này chỉ dành cho mục đích kiểm thử và bạn có thể sử dụng khi cấu hình OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
được bật.
Tính năng nén tên DNS được bật theo mặc định. Khi bạn tắt chế độ này, tên DNS sẽ được thêm vào dưới dạng đầy đủ và không bao giờ được nén. Cách này áp dụng cho các mô-đun máy khách/máy chủ DNS và SRP của OpenThread." Phải nhập thông tin vào trường OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
.
Tham số
dns compression [enable|disable]
Ví dụ
dns compression
Enabled
Tài liệu tham khảo về CLI và API
cấu hình dns (đã đặt)
Đặt cấu hình truy vấn mặc định trên ứng dụng DNS.
Trong một aConfig
không phải là NULL, phương thức gọi có thể chọn không chỉ định một số trường trong thực thể
otDnsQueryConfig
(giá trị bằng 0). Các trường chưa chỉ định được thay thế bằng các định nghĩa tuỳ chọn cấu hình OT tương ứng OPENTHREAD_CONFIG_DNS_CLIENTDEFAULT{}
để tạo thành cấu hình truy vấn mặc định.
Khi bạn bật OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_SERVER_ADDRESS_AUTO_SET_ENABLE
, địa chỉ IPv6 của máy chủ trong cấu hình mặc định sẽ được ứng dụng DNS tự động đặt và cập nhật. Việc này chỉ được thực hiện khi người dùng không đặt hoặc chỉ định rõ ràng. Hành vi này yêu cầu bạn phải bật ứng dụng SRP và tính năng tự động bắt đầu của ứng dụng đó. Sau đó, máy khách SRP sẽ giám sát Thread Network Data (Dữ liệu mạng Thread) cho các mục nhập Dịch vụ DNS/SRP để chọn một máy chủ SRP. Địa chỉ máy chủ SRP đã chọn cũng được đặt làm địa chỉ máy chủ DNS trong cấu hình mặc định.
Chúng ta có thể không chỉ định một số trường (hoặc sử dụng giá trị bằng 0). Các trường chưa chỉ định được thay thế bằng các định nghĩa tuỳ chọn cấu hình OT tương ứng OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT
để tạo thành cấu hình truy vấn mặc định. OPENTHREAD_CONFIG_DNS_CLIENT_ENABLE
là trường bắt buộc.
Tham số
dns config [dns-server-IP] [dns-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean] [service-mode] [protocol]
Ví dụ
dns config fd00::1 1234 5000 2 0
Done
dns config
Server: [fd00:0:0:0:0:0:0:1]:1234
ResponseTimeout: 5000 ms
MaxTxAttempts: 2
RecursionDesired: no
ServiceMode: srv_txt_opt
Nat64Mode: allow
TransportProtocol: udp
Done
dns config fd00::2
Done
dns config
Server: [fd00:0:0:0:0:0:0:2]:53
ResponseTimeout: 6000 ms
MaxTxAttempts: 3
RecursionDesired: yes
ServiceMode: srv_txt_opt
Nat64Mode: allow
TransportProtocol: udp
Done
Tài liệu tham khảo về CLI và API
cấu hình DNS
Lấy cấu hình truy vấn mặc định hiện tại mà ứng dụng DNS sử dụng.
Khi ngăn xếp OpenThread bắt đầu, cấu hình truy vấn DNS mặc định được xác định từ một tập hợp các tuỳ chọn cấu hình OT, chẳng hạn như OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_SERVER_IP6_ADDRESS
, _DEFAULT_SERVER_PORT
, _DEFAULT_RESPONSE_TIMEOUT
, v.v. (xem config/dns_client.h
để biết tất cả các tuỳ chọn cấu hình liên quan).
Cấu hình này bao gồm địa chỉ và cổng IPv6 của máy chủ, thời gian chờ phản hồi tính bằng mili giây (thời gian chờ để phản hồi rx), số lần tx tối đa trước khi báo cáo lỗi, cờ boolean để cho biết máy chủ có thể phân giải truy vấn theo cách đệ quy hay không. Phải nhập thông tin vào trường OPENTHREAD_CONFIG_DNS_CLIENT_ENABLE
.
Tham số
Không có tham số.
Ví dụ
dns config
Server: [fd00:0:0:0:0:0:0:1]:1234
ResponseTimeout: 5000 ms
MaxTxAttempts: 2
RecursionDesired: no
ServiceMode: srv
Nat64Mode: allow
Done
Tài liệu tham khảo về CLI và API
phân giải DNS
Gửi truy vấn DNS phân giải địa chỉ cho (các) bản ghi AAAA(IPv6) đối với một tên máy chủ lưu trữ cụ thể.
aConfig
có thể là giá trị NULL. Trong trường hợp này, cấu hình mặc định (từ
otDnsClientGetDefaultConfig()
) sẽ được dùng làm cấu hình cho truy vấn này. Trong một aConfig
không phải là giá trị NULL, bạn có thể không chỉ định một số trường (giá trị bằng 0). Sau đó, các trường chưa chỉ định sẽ được thay thế bằng các giá trị từ cấu hình mặc định.
Gửi truy vấn DNS để lấy địa chỉ IPv6 cho tên máy chủ đã cho.
Các tham số sau tên máy chủ là không bắt buộc. Mọi giá trị chưa chỉ định (hoặc bằng 0) cho các tham số không bắt buộc này sẽ được thay thế bằng giá trị trong cấu hình mặc định hiện tại (cấu hình dns).
IP của máy chủ DNS có thể là một địa chỉ IPv4, địa chỉ này sẽ được tổng hợp thành địa chỉ IPv6 bằng cách sử dụng tiền tố NAT64 được ưu tiên trong dữ liệu mạng.
Tham số
dns resolve hostname [dns-server-IP] [dns-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean]
Ví dụ
dns resolve ipv6.google.com
DNS response for ipv6.google.com - 2a00:1450:401b:801:0:0:0:200e TTL: 300
dns resolve example.com 8.8.8.8
Synthesized IPv6 DNS server address: fdde:ad00:beef:2:0:0:808:808
DNS response for example.com. - fd4c:9574:3720:2:0:0:5db8:d822 TTL:20456
Done
Tài liệu tham khảo về CLI và API
dịch vụ DNS
Bắt đầu quá trình phân giải phiên bản dịch vụ DNS cho một phiên bản dịch vụ cụ thể.
Có sẵn khi OPENTHREAD_CONFIG_DNS_CLIENT_SERVICE_DISCOVERY_ENABLE
được bật.
aConfig
có thể là giá trị NULL. Trong trường hợp này, cấu hình mặc định (từ
otDnsClientGetDefaultConfig()
) sẽ được dùng làm cấu hình cho truy vấn này. Trong một aConfig
không phải là giá trị NULL, bạn có thể không chỉ định một số trường (giá trị bằng 0). Sau đó, các trường chưa chỉ định sẽ được thay thế bằng các giá trị từ cấu hình mặc định.
Hàm này sẽ gửi truy vấn đối với các bản ghi SRV và/hoặc TXT đối với phiên bản dịch vụ cụ thể. Trường mServiceMode
trong
otDnsQueryConfig
xác định bản ghi nào cần truy vấn (chỉ SRV, chỉ TXT hoặc cả SRV và TXT) và cách thực hiện truy vấn (cùng một thông báo, song song riêng biệt hoặc ở chế độ tối ưu hoá, trong đó ứng dụng sẽ thử cùng một thông báo trước rồi tách riêng nếu không nhận được phản hồi).
Bản ghi SRV cung cấp thông tin về cổng dịch vụ, mức độ ưu tiên và trọng lượng cùng với tên máy chủ lưu trữ liên kết với phiên bản dịch vụ. Hàm này KHÔNG thực hiện quá trình phân giải địa chỉ cho tên máy chủ lưu trữ được phát hiện từ bản ghi SRV. Máy chủ/trình giải quyết có thể cung cấp(các) bản ghi AAAA/A cho tên máy chủ lưu trữ trong phần Dữ liệu bổ sung của phản hồi cho truy vấn SRV/TXT và thông tin này có thể được truy xuất bằng
otDnsServiceResponseGetServiceInfo()
trong otDnsServiceCallback
. Người dùng API này KHÔNG ĐƯỢC giả định rằng địa chỉ máy chủ sẽ luôn dùng được từ
otDnsServiceResponseGetServiceInfo()
.
Gửi truy vấn DNS phân giải phiên bản dịch vụ cho một phiên bản dịch vụ cụ thể. Nhãn phiên bản dịch vụ được cung cấp trước, theo sau là tên dịch vụ (lưu ý rằng nhãn phiên bản dịch vụ có thể chứa ký tự dấu chấm '.').
Các tham số sau service-name
là không bắt buộc. Mọi giá trị chưa chỉ định (hoặc bằng 0) cho các tham số không bắt buộc này sẽ được thay thế bằng giá trị trong cấu hình mặc định hiện tại (dns config
).
Tham số
dns service service-instance-label service-name [DNS-server-IP] [DNS-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean]
Ví dụ
Tài liệu tham khảo về CLI và API
máy chủ dịch vụ dns
Bắt đầu quá trình phân giải phiên bản dịch vụ DNS cho một phiên bản dịch vụ cụ thể, với hoạt động phân giải địa chỉ tiếp theo có thể áp dụng cho tên máy chủ lưu trữ được phát hiện cho phiên bản dịch vụ đó.
Có sẵn khi OPENTHREAD_CONFIG_DNS_CLIENT_SERVICE_DISCOVERY_ENABLE
được bật.
aConfig
có thể là giá trị NULL. Trong trường hợp này, cấu hình mặc định (từ
otDnsClientGetDefaultConfig()
) sẽ được dùng làm cấu hình cho truy vấn này. Trong một aConfig
không phải là giá trị NULL, bạn có thể không chỉ định một số trường (giá trị bằng 0). Sau đó, các trường chưa chỉ định sẽ được thay thế bằng các giá trị từ cấu hình mặc định. Không thể dùng hàm này với mServiceMode
trong cấu hình DNS được đặt thành OT_DNS_SERVICE_MODE_TXT
(tức là chỉ truy vấn bản ghi TXT) và sẽ trả về OT_ERROR_INVALID_ARGS
.
Hoạt động tương tự như việc
otDnsClientResolveService()
gửi truy vấn đối với các bản ghi SRV và TXT. Tuy nhiên, nếu máy chủ/trình giải quyết không cung cấp bản ghi AAAA/A cho tên máy chủ lưu trữ trong phản hồi truy vấn SRV (trong phần Dữ liệu bổ sung), thì máy chủ đó sẽ thực hiện quá trình phân giải tên máy chủ lưu trữ (gửi truy vấn AAAA) cho tên máy chủ lưu trữ được phát hiện từ bản ghi SRV. Lệnh gọi lại aCallback
được gọi khi đã nhận được phản hồi cho tất cả truy vấn (tức là đã hoàn tất quá trình phân giải địa chỉ dịch vụ và máy chủ).
Gửi truy vấn DNS phân giải thực thể dịch vụ cho một phiên bản dịch vụ cụ thể có khả năng phân giải tên máy chủ lưu trữ tiếp theo. Nhãn phiên bản dịch vụ được cung cấp trước, theo sau là tên dịch vụ (lưu ý rằng nhãn phiên bản dịch vụ có thể chứa ký tự dấu chấm '.').
Các tham số sau service-name
là không bắt buộc. Mọi giá trị chưa chỉ định (hoặc bằng 0) cho các tham số không bắt buộc này sẽ được thay thế bằng giá trị trong cấu hình mặc định hiện tại (dns config
).
Tham số
dns servicehost service-instance-label service-name [DNS-server-IP] [DNS-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean]
Ví dụ
Tài liệu tham khảo về CLI và API
tên miền (đã đặt)
Đặt tên miền của luồng.
Chỉ thành công khi giao thức Thread bị tắt.
Tham số
domainname name
Sử dụng backslash
để thoát không gian.
Ví dụ
domainname Test\ Thread
Done
Tài liệu tham khảo về CLI và API
tên miền
Lấy tên miền của luồng.
Tham số
Không có tham số.
Ví dụ
domainname
Thread
Done
Tài liệu tham khảo về CLI và API
dua iid (đặt,xoá)
Thiết lập hoặc xoá Giá trị nhận dạng giao diện được chỉ định theo cách thủ công cho Địa chỉ Unicast của miền luồng.
Có sẵn khi bạn bật OPENTHREAD_CONFIG_DUA_ENABLE
.
Tham số
dua iid iid|clear
dua iid clear
chuyển nullptr
đến otThreadSetFixedDuaInterfaceIdentifier. Nếu không, bạn có thể truyền iid
.
Ví dụ
dua iid 0004000300020001
Done
dua iid clear
Done
Tài liệu tham khảo về CLI và API
CANNOT TRANSLATE
Lấy giá trị nhận dạng giao diện được chỉ định theo cách thủ công cho địa chỉ Unicast của miền luồng.
Có sẵn khi bạn bật OPENTHREAD_CONFIG_DUA_ENABLE
.
Tham số
Không có tham số.
Ví dụ
dua iid
0004000300020001
Done
Tài liệu tham khảo về CLI và API
eidcache
Trả về các mục bộ nhớ đệm từ EID đến rlOC.
Tham số
Không có tham số.
Ví dụ
eidcache
fd49:caf4:a29f:dc0e:97fc:69dd:3c16:df7d 2000 cache canEvict=1 transTime=0 eid=fd49:caf4:a29f:dc0e:97fc:69dd:3c16:df7d
fd49:caf4:a29f:dc0e:97fc:69dd:3c16:df7f fffe retry canEvict=1 timeout=10 retryDelay=30
Done
Tài liệu tham khảo về CLI và API
eui64
Lấy tiêu chuẩn IEEE EUI-64 do nhà máy chỉ định cho giao diện này.
Tham số
Không có tham số.
Ví dụ
eui64
0615aae900124b00
Done
Tài liệu tham khảo về CLI và API
extaddr (set)
Thiết lập địa chỉ mở rộng IEEE 802.15.4.
Tham số
extaddr extaddr
Ví dụ
extaddr dead00beef00cafe
dead00beef00cafe
Done
Tài liệu tham khảo về CLI và API
extaddr
Lấy địa chỉ mở rộng IEEE 802.15.4.
Tham số
Không có tham số.
Ví dụ
extaddr
dead00beef00cafe
Done
Tài liệu tham khảo về CLI và API
extpanid (đã đặt)
Thiết lập mã PAN mở rộng của IEEE 802.15.4.
Tham số
extpanid extpanid
Ví dụ
extpanid dead00beef00cafe
Done
Tài liệu tham khảo về CLI và API
ngoại tuyến
Lấy mã PAN mở rộng theo chuẩn IEEE 802.15.4.
Tham số
Không có tham số.
Ví dụ
extpanid
dead00beef00cafe
Done
Tài liệu tham khảo về CLI và API
đặt lại về trạng thái ban đầu
Xoá tất cả chế độ cài đặt được lưu trữ trên bộ nhớ không biến động, sau đó kích hoạt quá trình đặt lại nền tảng.
Tham số
Không có tham số.
Ví dụ
factoryreset
Tài liệu tham khảo về CLI và API
giả mạo (a,an)
Gửi tin nhắn Chuỗi giả mạo.
Có sẵn khi bạn bật OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
.
Tham số
fake /a/an dst-ipaddr target meshLocalIid
Ví dụ
fake /a/an fdde:ad00:beef:0:0:ff:fe00:a800 fd00:7d03:7d03:7d03:55f2:bb6a:7a43:a03b 1111222233334444
Done
Tài liệu tham khảo về CLI và API
bạn gái
Lấy các tham số FEM bên ngoài.
Tham số
Không có tham số.
Ví dụ
fem
LNA gain 11 dBm
Done
Tài liệu tham khảo về CLI và API
fem lnPlayback (lấy)
Lấy mức tăng Rx LNA của FEM bên ngoài tính bằng dBm.
Tham số
Không có tham số.
Ví dụ
fem lnagain
11
Done
Tài liệu tham khảo về CLI và API
l n t l n (set)
Đặt mức tăng Rx LNA của FEM bên ngoài tính bằng dBm.
Tham số
Không có tham số.
Ví dụ
fem lnagain 8
Done
Tài liệu tham khảo về CLI và API
lịch sử ipaddr
Hiển thị lịch sử địa chỉ IPv6 unicast ở định dạng bảng hoặc danh sách.
Mỗi mục nhập trong bảng hoặc danh sách cung cấp:
- Độ tuổi: Thời gian đã trôi qua kể từ khi lệnh được đưa ra và được cung cấp ở định dạng:
hours
:minutes
:seconds
:milliseconds
- Sự kiện: Giá trị có thể là
Added
hoặcRemoved
. - Độ dài địa chỉ/tiền tố: Địa chỉ Unicast với độ dài tiền tố (tính bằng bit).
- Nguồn gốc: Giá trị có thể là
thread
,slaac
,dhcp6
hoặcmanual
. - Phạm vi: Phạm vi địa chỉ IPv6.
- P: Cờ ưu tiên.
- V: Cờ hợp lệ.
- rlOC (R): Cờ này cho biết địa chỉ IPv6 có phải là bộ định vị định tuyến hay không.
Tham số
history ipaddr [list] [num-entries]
- Sử dụng tuỳ chọn
list
để hiển thị kết quả ở định dạng danh sách. Nếu không, kết quả sẽ hiển thị ở định dạng bảng. - Sử dụng tuỳ chọn
num-entries
để giới hạn kết quả ở số lượng mục nhập gần đây nhất được chỉ định. Nếu bạn không sử dụng tuỳ chọn này, tất cả các mục đã lưu trữ sẽ hiện trong dữ liệu đầu ra.
Ví dụ
history ipaddr
| Age | Event | Address / Prefix Length | Origin |Scope| P | V | R |
+----------------------+---------+---------------------------------------------+--------+-----+---+---+---+
| 00:00:04.991 | Removed | 2001:dead:beef:cafe:c4cb:caba:8d55:e30b/64 | slaac | 14 | Y | Y | N |
| 00:00:44.647 | Added | 2001:dead:beef:cafe:c4cb:caba:8d55:e30b/64 | slaac | 14 | Y | Y | N |
| 00:01:07.199 | Added | fd00:0:0:0:0:0:0:1/64 | manual | 14 | Y | Y | N |
| 00:02:17.885 | Added | fdde:ad00:beef:0:0:ff:fe00:fc00/64 | thread | 3 | N | Y | N |
| 00:02:17.885 | Added | fdde:ad00:beef:0:0:ff:fe00:5400/64 | thread | 3 | N | Y | Y |
| 00:02:20.107 | Removed | fdde:ad00:beef:0:0:ff:fe00:5400/64 | thread | 3 | N | Y | Y |
| 00:02:21.575 | Added | fdde:ad00:beef:0:0:ff:fe00:5400/64 | thread | 3 | N | Y | Y |
| 00:02:21.575 | Added | fdde:ad00:beef:0:ecea:c4fc:ad96:4655/64 | thread | 3 | N | Y | N |
| 00:02:23.904 | Added | fe80:0:0:0:3c12:a4d2:fbe0:31ad/64 | thread | 2 | Y | Y | N |
Done
history ipaddr list 5
00:00:20.327 -> event:Removed address:2001:dead:beef:cafe:c4cb:caba:8d55:e30b prefixlen:64 origin:slaac scope:14 preferred:yes valid:yes rloc:no
00:00:59.983 -> event:Added address:2001:dead:beef:cafe:c4cb:caba:8d55:e30b prefixlen:64 origin:slaac scope:14 preferred:yes valid:yes rloc:no
00:01:22.535 -> event:Added address:fd00:0:0:0:0:0:0:1 prefixlen:64 origin:manual scope:14 preferred:yes valid:yes rloc:no
00:02:33.221 -> event:Added address:fdde:ad00:beef:0:0:ff:fe00:fc00 prefixlen:64 origin:thread scope:3 preferred:no valid:yes rloc:no
00:02:33.221 -> event:Added address:fdde:ad00:beef:0:0:ff:fe00:5400 prefixlen:64 origin:thread scope:3 preferred:no valid:yes rloc:yes
Done
Tài liệu tham khảo về CLI và API
lịch sử ipmaddr
Hiển thị lịch sử địa chỉ IPv6 đa hướng ở định dạng bảng hoặc danh sách.
Mỗi mục nhập trong bảng hoặc danh sách cung cấp:
- Độ tuổi: Thời gian đã trôi qua kể từ khi lệnh được đưa ra và được cung cấp ở định dạng:
hours
:minutes
:seconds
:milliseconds
- Sự kiện: Giá trị có thể là
Subscribed
hoặcUnsubscribed
. - Địa chỉ phát đa hướng
- Nguồn gốc: Giá trị có thể là
Thread
hoặcManual
.
Tham số
history ipmaddr [list] [num-entries]
- Sử dụng tuỳ chọn
list
để hiển thị kết quả ở định dạng danh sách. Nếu không, kết quả sẽ hiển thị ở định dạng bảng. - Sử dụng tuỳ chọn
num-entries
để giới hạn kết quả ở số lượng mục nhập gần đây nhất được chỉ định. Nếu bạn không sử dụng tuỳ chọn này, tất cả các mục đã lưu trữ sẽ hiện trong dữ liệu đầu ra.
Ví dụ
history ipmaddr
| Age | Event | Multicast Address | Origin |
+----------------------+--------------+-----------------------------------------+--------+
| 00:00:08.592 | Unsubscribed | ff05:0:0:0:0:0:0:1 | Manual |
| 00:01:25.353 | Subscribed | ff05:0:0:0:0:0:0:1 | Manual |
| 00:01:54.953 | Subscribed | ff03:0:0:0:0:0:0:2 | Thread |
| 00:01:54.953 | Subscribed | ff02:0:0:0:0:0:0:2 | Thread |
| 00:01:59.329 | Subscribed | ff33:40:fdde:ad00:beef:0:0:1 | Thread |
| 00:01:59.329 | Subscribed | ff32:40:fdde:ad00:beef:0:0:1 | Thread |
| 00:02:01.129 | Subscribed | ff03:0:0:0:0:0:0:fc | Thread |
| 00:02:01.129 | Subscribed | ff03:0:0:0:0:0:0:1 | Thread |
| 00:02:01.129 | Subscribed | ff02:0:0:0:0:0:0:1 | Thread |
Done
history ipmaddr list
00:00:25.447 -> event:Unsubscribed address:ff05:0:0:0:0:0:0:1 origin:Manual
00:01:42.208 -> event:Subscribed address:ff05:0:0:0:0:0:0:1 origin:Manual
00:02:11.808 -> event:Subscribed address:ff03:0:0:0:0:0:0:2 origin:Thread
00:02:11.808 -> event:Subscribed address:ff02:0:0:0:0:0:0:2 origin:Thread
00:02:16.184 -> event:Subscribed address:ff33:40:fdde:ad00:beef:0:0:1 origin:Thread
00:02:16.184 -> event:Subscribed address:ff32:40:fdde:ad00:beef:0:0:1 origin:Thread
00:02:17.984 -> event:Subscribed address:ff03:0:0:0:0:0:0:fc origin:Thread
00:02:17.984 -> event:Subscribed address:ff03:0:0:0:0:0:0:1 origin:Thread
00:02:17.984 -> event:Subscribed address:ff02:0:0:0:0:0:0:1 origin:Thread
Done
Tài liệu tham khảo về CLI và API
CANNOT TRANSLATE
Hiển thị lịch sử hàng xóm ở định dạng bảng hoặc danh sách.
Mỗi mục nhập trong bảng hoặc danh sách cung cấp:
- Độ tuổi: Thời gian đã trôi qua kể từ khi lệnh được đưa ra và được cung cấp ở định dạng:
hours
:minutes
:seconds
:milliseconds
- Nhập:
Child
hoặcRouter
. - Sự kiện: Các giá trị có thể là
Added
,Removed
hoặcChanged
. - Địa chỉ mở rộng
- RLOC16
- Chế độ: Chế độ liên kết MLE. Các giá trị có thể có:
-
: chưa đặt cờ nào (rx-off-when-idle, thiết bị Thread tối thiểu, dữ liệu mạng ổn định).r
: rx-on-when-idled
: Thiết bị luồng đầy đủ.n
: Dữ liệu mạng đầy đủ
- Ave RSS: Số khung hình trung bình (tính bằng dBm) nhận được từ thiết bị lân cận tại thời điểm mục nhập được ghi lại.
Tham số
history neighbor [list] [num-entries]
- Sử dụng tuỳ chọn
list
để hiển thị kết quả ở định dạng danh sách. Nếu không, kết quả sẽ hiển thị ở định dạng bảng. - Sử dụng tuỳ chọn
num-entries
để giới hạn kết quả ở số lượng mục nhập gần đây nhất được chỉ định. Nếu bạn không sử dụng tuỳ chọn này, tất cả các mục đã lưu trữ sẽ hiện trong dữ liệu đầu ra.
Ví dụ
history neighbor
| Age | Type | Event | Extended Address | RLOC16 | Mode | Ave RSS |
+----------------------+--------+-----------+------------------+--------+------+---------+
| 00:00:29.233 | Child | Added | ae5105292f0b9169 | 0x8404 | - | -20 |
| 00:01:38.368 | Child | Removed | ae5105292f0b9169 | 0x8401 | - | -20 |
| 00:04:27.181 | Child | Changed | ae5105292f0b9169 | 0x8401 | - | -20 |
| 00:04:51.236 | Router | Added | 865c7ca38a5fa960 | 0x9400 | rdn | -20 |
| 00:04:51.587 | Child | Removed | 865c7ca38a5fa960 | 0x8402 | rdn | -20 |
| 00:05:22.764 | Child | Changed | ae5105292f0b9169 | 0x8401 | rn | -20 |
| 00:06:40.764 | Child | Added | 4ec99efc874a1841 | 0x8403 | r | -20 |
| 00:06:44.060 | Child | Added | 865c7ca38a5fa960 | 0x8402 | rdn | -20 |
| 00:06:49.515 | Child | Added | ae5105292f0b9169 | 0x8401 | - | -20 |
Done
history neighbor list
00:00:34.753 -> type:Child event:Added extaddr:ae5105292f0b9169 rloc16:0x8404 mode:- rss:-20
00:01:43.888 -> type:Child event:Removed extaddr:ae5105292f0b9169 rloc16:0x8401 mode:- rss:-20
00:04:32.701 -> type:Child event:Changed extaddr:ae5105292f0b9169 rloc16:0x8401 mode:- rss:-20
00:04:56.756 -> type:Router event:Added extaddr:865c7ca38a5fa960 rloc16:0x9400 mode:rdn rss:-20
00:04:57.107 -> type:Child event:Removed extaddr:865c7ca38a5fa960 rloc16:0x8402 mode:rdn rss:-20
00:05:28.284 -> type:Child event:Changed extaddr:ae5105292f0b9169 rloc16:0x8401 mode:rn rss:-20
00:06:46.284 -> type:Child event:Added extaddr:4ec99efc874a1841 rloc16:0x8403 mode:r rss:-20
00:06:49.580 -> type:Child event:Added extaddr:865c7ca38a5fa960 rloc16:0x8402 mode:rdn rss:-20
00:06:55.035 -> type:Child event:Added extaddr:ae5105292f0b9169 rloc16:0x8401 mode:- rss:-20
Done
Tài liệu tham khảo về CLI và API
nhật ký netinfo
Hiển thị lịch sử thông tin mạng ở định dạng bảng hoặc danh sách.
Mỗi mục nhập trong bảng hoặc danh sách cung cấp:
- Độ tuổi: Thời gian đã trôi qua kể từ khi lệnh được đưa ra và được cung cấp ở định dạng:
hours
:minutes
:seconds
:milliseconds
- Vai trò: Vai trò trên thiết bị. Các giá trị có thể là
router
,child
,detached
hoặcdisabled
. - Chế độ: Chế độ liên kết MLE. Các giá trị có thể có:
-
: chưa đặt cờ nào (rx-off-when-idle, thiết bị Thread tối thiểu, dữ liệu mạng ổn định).r
: rx-on-when-idled
: Thiết bị luồng đầy đủ.n
: Dữ liệu mạng đầy đủ
- RLOC16
- Mã phân vùng.
Tham số
history netinfo [list] [num-entries]
- Sử dụng tuỳ chọn
list
để hiển thị kết quả ở định dạng danh sách. Nếu không, kết quả sẽ hiển thị ở định dạng bảng. - Sử dụng tuỳ chọn
num-entries
để giới hạn kết quả ở số lượng mục nhập gần đây nhất được chỉ định. Nếu bạn không sử dụng tuỳ chọn này, tất cả các mục đã lưu trữ sẽ hiện trong dữ liệu đầu ra.
Ví dụ
history netinfo
| Age | Role | Mode | RLOC16 | Partition ID |
+----------------------+----------+------+--------+--------------+
| 00:00:10.069 | router | rdn | 0x6000 | 151029327 |
| 00:02:09.337 | child | rdn | 0x2001 | 151029327 |
| 00:02:09.338 | child | rdn | 0x2001 | 151029327 |
| 00:07:40.806 | child | - | 0x2001 | 151029327 |
| 00:07:42.297 | detached | - | 0x6000 | 0 |
| 00:07:42.968 | disabled | - | 0x6000 | 0 |
Done
history netinfo list
00:00:59.467 -> role:router mode:rdn rloc16:0x6000 partition-id:151029327
00:02:58.735 -> role:child mode:rdn rloc16:0x2001 partition-id:151029327
00:02:58.736 -> role:child mode:rdn rloc16:0x2001 partition-id:151029327
00:08:30.204 -> role:child mode:- rloc16:0x2001 partition-id:151029327
00:08:31.695 -> role:detached mode:- rloc16:0x6000 partition-id:0
00:08:32.366 -> role:disabled mode:- rloc16:0x6000 partition-id:0
Done
history netinfo 2
| Age | Role | Mode | RLOC16 | Partition ID |
+----------------------+----------+------+--------+--------------+
| 00:02:05.451 | router | rdn | 0x6000 | 151029327 |
| 00:04:04.719 | child | rdn | 0x2001 | 151029327 |
Done
Tài liệu tham khảo về CLI và API
tiền tố lịch sử
Hiện dữ liệu mạng cho nhật ký tiền tố lưới ở định dạng bảng hoặc danh sách.
Mỗi mục nhập trong bảng hoặc danh sách cung cấp:
- Độ tuổi: Thời gian đã trôi qua kể từ khi lệnh được đưa ra và được cung cấp ở định dạng:
hours
:minutes
:seconds
:milliseconds
- Sự kiện: Giá trị có thể là
Added
hoặcRemoved
. - Tiền tố
- Cờ/ý nghĩa:
p
: Cờ ưu tiêna
: Cờ tự động định cấu hình địa chỉ IPv6 không trạng thái.d
: Cờ cấu hình địa chỉ IPv6 trong DHCPv6.c
: Cờ cấu hình khác DHCPv6.r
: Cờ tuyến đường mặc định.o
: Trên cờ lưới.s
: Cờ ổn định.n
: Cờ Dns nd.D
: Cờ tiền tố miền.
- Ưu tiên: Tuỳ chọn. Giá trị có thể là
high
,med
hoặclow
. - RLOC16
Tham số
history prefix [list] [num-entries]
- Sử dụng tuỳ chọn
list
để hiển thị kết quả ở định dạng danh sách. Nếu không, kết quả sẽ hiển thị ở định dạng bảng. - Sử dụng tuỳ chọn
num-entries
để giới hạn kết quả ở số lượng mục nhập gần đây nhất được chỉ định. Nếu bạn không sử dụng tuỳ chọn này, tất cả các mục đã lưu trữ sẽ hiện trong dữ liệu đầu ra.
Ví dụ
history prefix
| Age | Event | Prefix | Flags | Pref | RLOC16 |
+----------------------+---------+---------------------------------------------+-----------+------+--------+
| 00:00:10.663 | Added | fd00:1111:2222:3333::/64 | paro | med | 0x5400 |
| 00:01:02.054 | Removed | fd00:dead:beef:1::/64 | paros | high | 0x5400 |
| 00:01:21.136 | Added | fd00:abba:cddd:0::/64 | paos | med | 0x5400 |
| 00:01:45.144 | Added | fd00:dead:beef:1::/64 | paros | high | 0x3c00 |
| 00:01:50.944 | Added | fd00:dead:beef:1::/64 | paros | high | 0x5400 |
| 00:01:59.887 | Added | fd00:dead:beef:1::/64 | paros | med | 0x8800 |
Done
history prefix list
00:04:12.487 -> event:Added prefix:fd00:1111:2222:3333::/64 flags:paro pref:med rloc16:0x5400
00:05:03.878 -> event:Removed prefix:fd00:dead:beef:1::/64 flags:paros pref:high rloc16:0x5400
00:05:22.960 -> event:Added prefix:fd00:abba:cddd:0::/64 flags:paos pref:med rloc16:0x5400
00:05:46.968 -> event:Added prefix:fd00:dead:beef:1::/64 flags:paros pref:high rloc16:0x3c00
00:05:52.768 -> event:Added prefix:fd00:dead:beef:1::/64 flags:paros pref:high rloc16:0x5400
00:06:01.711 -> event:Added prefix:fd00:dead:beef:1::/64 flags:paros pref:med rloc16:0x8800
Done
Tài liệu tham khảo về CLI và API
tuyến đường lịch sử
Hiển thị lịch sử định tuyến bên ngoài dữ liệu mạng ở định dạng bảng hoặc danh sách.
Mỗi mục nhập trong bảng hoặc danh sách cung cấp:
- Độ tuổi: Thời gian đã trôi qua kể từ khi lệnh được đưa ra và được cung cấp ở định dạng:
hours
:minutes
:seconds
:milliseconds
- Sự kiện: Giá trị có thể là
Added
hoặcRemoved
. - Tuyến đường
- Cờ/ý nghĩa:
s
: Cờ ổn định.n
: Cờ NAT64.
- Ưu tiên: Tuỳ chọn. Giá trị có thể là
high
,med
hoặclow
. - RLOC16
Tham số
history route [list] [num-entries]
- Sử dụng tuỳ chọn
list
để hiển thị kết quả ở định dạng danh sách. Nếu không, kết quả sẽ hiển thị ở định dạng bảng. - Sử dụng tuỳ chọn
num-entries
để giới hạn kết quả ở số lượng mục nhập gần đây nhất được chỉ định. Nếu bạn không sử dụng tuỳ chọn này, tất cả các mục đã lưu trữ sẽ hiện trong dữ liệu đầu ra.
Ví dụ
history route
| Age | Event | Route | Flags | Pref | RLOC16 |
+----------------------+---------+---------------------------------------------+-----------+------+--------+
| 00:00:05.456 | Removed | fd00:1111:0::/48 | s | med | 0x3c00 |
| 00:00:29.310 | Added | fd00:1111:0::/48 | s | med | 0x3c00 |
| 00:00:42.822 | Added | fd00:1111:0::/48 | s | med | 0x5400 |
| 00:01:27.688 | Added | fd00:aaaa:bbbb:cccc::/64 | s | med | 0x8800 |
Done
history route list 2
00:00:48.704 -> event:Removed route:fd00:1111:0::/48 flags:s pref:med rloc16:0x3c00
00:01:12.558 -> event:Added route:fd00:1111:0::/48 flags:s pref:med rloc16:0x3c00
Done
Tài liệu tham khảo về CLI và API
bộ định tuyến nhật ký
Hiển thị lịch sử bảng định tuyến ở định dạng bảng hoặc danh sách.
Mỗi mục nhập trong bảng hoặc danh sách cung cấp:
- Độ tuổi: Thời gian đã trôi qua kể từ khi lệnh được đưa ra và được cung cấp ở định dạng:
hours
:minutes
:seconds
:milliseconds
- Sự kiện: Các giá trị có thể là
Added
,Removed
,NextHopChanged
hoặcCostChanged
. - ID (rlOC16): ID bộ định tuyến và rlOC16 của bộ định tuyến.
- Next Hop: ID bộ định tuyến và rlOC16 của hop tiếp theo. Nếu không có chặng tiếp theo,
none
sẽ được hiển thị. - Chi phí đường dẫn: chi phí cũ là
->
chi phí mới. Giá trịinf
cho biết chi phí đường dẫn vô hạn.
Tham số
history router [list] [num-entries]
- Sử dụng tuỳ chọn
list
để hiển thị kết quả ở định dạng danh sách. Nếu không, kết quả sẽ hiển thị ở định dạng bảng. - Sử dụng tuỳ chọn
num-entries
để giới hạn kết quả ở số lượng mục nhập gần đây nhất được chỉ định. Nếu bạn không sử dụng tuỳ chọn này, tất cả các mục đã lưu trữ sẽ hiện trong dữ liệu đầu ra.
Ví dụ
history router
| Age | Event | ID (RLOC16) | Next Hop | Path Cost |
+----------------------+----------------+-------------+-------------+------------+
| 00:00:05.258 | NextHopChanged | 7 (0x1c00) | 34 (0x8800) | inf -> 3 |
| 00:00:08.604 | NextHopChanged | 34 (0x8800) | 34 (0x8800) | inf -> 2 |
| 00:00:08.604 | Added | 7 (0x1c00) | none | inf -> inf |
| 00:00:11.931 | Added | 34 (0x8800) | none | inf -> inf |
| 00:00:14.948 | Removed | 59 (0xec00) | none | inf -> inf |
| 00:00:14.948 | Removed | 54 (0xd800) | none | inf -> inf |
| 00:00:14.948 | Removed | 34 (0x8800) | none | inf -> inf |
| 00:00:14.948 | Removed | 7 (0x1c00) | none | inf -> inf |
| 00:00:54.795 | NextHopChanged | 59 (0xec00) | 34 (0x8800) | 1 -> 5 |
| 00:02:33.735 | NextHopChanged | 54 (0xd800) | none | 15 -> inf |
| 00:03:10.915 | CostChanged | 54 (0xd800) | 34 (0x8800) | 13 -> 15 |
| 00:03:45.716 | NextHopChanged | 54 (0xd800) | 34 (0x8800) | 15 -> 13 |
| 00:03:46.188 | CostChanged | 54 (0xd800) | 59 (0xec00) | 13 -> 15 |
| 00:04:19.124 | CostChanged | 54 (0xd800) | 59 (0xec00) | 11 -> 13 |
| 00:04:52.008 | CostChanged | 54 (0xd800) | 59 (0xec00) | 9 -> 11 |
| 00:05:23.176 | CostChanged | 54 (0xd800) | 59 (0xec00) | 7 -> 9 |
| 00:05:51.081 | CostChanged | 54 (0xd800) | 59 (0xec00) | 5 -> 7 |
| 00:06:48.721 | CostChanged | 54 (0xd800) | 59 (0xec00) | 3 -> 5 |
| 00:07:13.792 | NextHopChanged | 54 (0xd800) | 59 (0xec00) | 1 -> 3 |
| 00:09:28.681 | NextHopChanged | 7 (0x1c00) | 34 (0x8800) | inf -> 3 |
| 00:09:31.882 | Added | 7 (0x1c00) | none | inf -> inf |
| 00:09:51.240 | NextHopChanged | 54 (0xd800) | 54 (0xd800) | inf -> 1 |
| 00:09:54.204 | Added | 54 (0xd800) | none | inf -> inf |
| 00:10:20.645 | NextHopChanged | 34 (0x8800) | 34 (0x8800) | inf -> 2 |
| 00:10:24.242 | NextHopChanged | 59 (0xec00) | 59 (0xec00) | inf -> 1 |
| 00:10:24.242 | Added | 34 (0x8800) | none | inf -> inf |
| 00:10:41.900 | NextHopChanged | 59 (0xec00) | none | 1 -> inf |
| 00:10:42.480 | Added | 3 (0x0c00) | 3 (0x0c00) | inf -> inf |
| 00:10:43.614 | Added | 59 (0xec00) | 59 (0xec00) | inf -> 1 |
Done
history router list 20
00:00:06.959 -> event:NextHopChanged router:7(0x1c00) nexthop:34(0x8800) old-cost:inf new-cost:3
00:00:10.305 -> event:NextHopChanged router:34(0x8800) nexthop:34(0x8800) old-cost:inf new-cost:2
00:00:10.305 -> event:Added router:7(0x1c00) nexthop:none old-cost:inf new-cost:inf
00:00:13.632 -> event:Added router:34(0x8800) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:59(0xec00) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:54(0xd800) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:34(0x8800) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:7(0x1c00) nexthop:none old-cost:inf new-cost:inf
00:00:56.496 -> event:NextHopChanged router:59(0xec00) nexthop:34(0x8800) old-cost:1 new-cost:5
00:02:35.436 -> event:NextHopChanged router:54(0xd800) nexthop:none old-cost:15 new-cost:inf
00:03:12.616 -> event:CostChanged router:54(0xd800) nexthop:34(0x8800) old-cost:13 new-cost:15
00:03:47.417 -> event:NextHopChanged router:54(0xd800) nexthop:34(0x8800) old-cost:15 new-cost:13
00:03:47.889 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:13 new-cost:15
00:04:20.825 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:11 new-cost:13
00:04:53.709 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:9 new-cost:11
00:05:24.877 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:7 new-cost:9
00:05:52.782 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:5 new-cost:7
00:06:50.422 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:3 new-cost:5
00:07:15.493 -> event:NextHopChanged router:54(0xd800) nexthop:59(0xec00) old-cost:1 new-cost:3
00:09:30.382 -> event:NextHopChanged router:7(0x1c00) nexthop:34(0x8800) old-cost:inf new-cost:3
Done
Tài liệu tham khảo về CLI và API
nhật ký rx
Hiển thị lịch sử RX của tin nhắn IPv6 ở định dạng bảng hoặc danh sách.
Mỗi mục nhập trong bảng hoặc danh sách cung cấp:
- Độ tuổi: Thời gian đã trôi qua kể từ khi lệnh được đưa ra và được cung cấp ở định dạng:
hours
:minutes
:seconds
:milliseconds
- Loại:
- Loại thông báo IPv6, chẳng hạn như
UDP
,TCP
,HopOpts
vàICMP6
(cùng loại thông báo phụ). src
: Số cổng và địa chỉ IPv6 nguồn.dst
: Địa chỉ IPv6 đích và số cổng (số cổng hợp lệ đối với UDP/TCP, nếu không thì số cổng là 0).
- Loại thông báo IPv6, chẳng hạn như
- Len: Độ dài tải trọng IPv6 (không bao gồm tiêu đề IPv6).
- Chksum: Giá trị tổng kiểm của thông báo (có hiệu lực cho các thông báo UDP, TCP hoặc ICMP6).
- Sec: Cho biết liệu cơ chế bảo mật lớp liên kết có được sử dụng hay không.
- Mức độ ưu tiên: Mức độ ưu tiên của thư. Các giá trị có thể là
low
,norm
,high
hoặcnet
(đối với thông báo kiểm soát chuỗi). - RSS: Cường độ tín hiệu đã nhận (tính bằng dBm), được tính trung bình trên tất cả các khung mảnh nhận được tạo nên thông báo. Trong nhật ký TX,
NA
(không áp dụng) sẽ xuất hiện. - Dir: Cho biết tin nhắn được gửi (
TX
) hay đã nhận (RX
). Lỗi truyền không thành công được biểu thị bằngTX-F
ở định dạng bảng hoặctx-success:no
ở định dạng danh sách. Một số ví dụ về quá trình truyền không thành công bao gồm việctx
bị huỷ và không nhận đượcack
từ ứng dụng ngang hàng đối với bất kỳ mảnh thông báo nào. - Người hàng xóm: Địa chỉ ngắn (rlOC16) của người hàng xóm nhận tin nhắn được gửi/nhận. Nếu khung đã được truyền tin, thì khung đó sẽ hiển thị dưới dạng
bcast
ở định dạng bảng hoặc0xffff
ở định dạng danh sách. Nếu không có địa chỉ ngắn của thành phần lân cận, thì địa chỉ này sẽ hiện dưới dạngunknwn
ở định dạng bảng hoặc0xfffe
ở định dạng danh sách. - Đài: Đường liên kết vô tuyến nơi thư được gửi/nhận (hữu ích khi bật
OPENTHREAD_CONFIG_MULTI_RADIO
). Có thể là15.4
,trel
hoặcall
(nếu được gửi trên tất cả các đường liên kết chọn lọc).
Tham số
history rx [list] [num-entries]
- Sử dụng tuỳ chọn
list
để hiển thị kết quả ở định dạng danh sách. Nếu không, kết quả sẽ hiển thị ở định dạng bảng. - Sử dụng tuỳ chọn
num-entries
để giới hạn kết quả ở số lượng mục nhập gần đây nhất được chỉ định. Nếu bạn không sử dụng tuỳ chọn này, tất cả các mục đã lưu trữ sẽ hiện trong dữ liệu đầu ra.
Ví dụ
history rx
| Age | Type | Len | Chksum | Sec | Prio | RSS |Dir | Neighb | Radio |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0xbd26 | no | net | -20 | RX | 0x4800 | 15.4 |
| 00:00:07.640 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | HopOpts | 44 | 0x0000 | yes | norm | -20 | RX | 0x4800 | 15.4 |
| 00:00:09.263 | src: [fdde:ad00:beef:0:0:ff:fe00:4800]:0 |
| | dst: [ff03:0:0:0:0:0:0:2]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 12 | 0x3f7d | yes | net | -20 | RX | 0x4800 | 15.4 |
| 00:00:09.302 | src: [fdde:ad00:beef:0:0:ff:fe00:4800]:61631 |
| | dst: [fdde:ad00:beef:0:0:ff:fe00:4801]:61631 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | ICMP6(EchoReqst) | 16 | 0x942c | yes | norm | -20 | RX | 0x4800 | 15.4 |
| 00:00:09.304 | src: [fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0 |
| | dst: [fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | HopOpts | 44 | 0x0000 | yes | norm | -20 | RX | 0x4800 | 15.4 |
| 00:00:09.304 | src: [fdde:ad00:beef:0:0:ff:fe00:4800]:0 |
| | dst: [ff03:0:0:0:0:0:0:2]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0x2e37 | no | net | -20 | RX | 0x4800 | 15.4 |
| 00:00:21.622 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0xe177 | no | net | -20 | RX | 0x4800 | 15.4 |
| 00:00:26.640 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 165 | 0x82ee | yes | net | -20 | RX | 0x4800 | 15.4 |
| 00:00:30.000 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
| | dst: [fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 93 | 0x52df | no | net | -20 | RX | unknwn | 15.4 |
| 00:00:30.480 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
| | dst: [fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0x5ccf | no | net | -20 | RX | unknwn | 15.4 |
| 00:00:30.772 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
Done
history rx list 4
00:00:13.368
type:UDP len:50 checksum:0xbd26 sec:no prio:net rss:-20 from:0x4800 radio:15.4
src:[fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788
dst:[ff02:0:0:0:0:0:0:1]:19788
00:00:14.991
type:HopOpts len:44 checksum:0x0000 sec:yes prio:norm rss:-20 from:0x4800 radio:15.4
src:[fdde:ad00:beef:0:0:ff:fe00:4800]:0
dst:[ff03:0:0:0:0:0:0:2]:0
00:00:15.030
type:UDP len:12 checksum:0x3f7d sec:yes prio:net rss:-20 from:0x4800 radio:15.4
src:[fdde:ad00:beef:0:0:ff:fe00:4800]:61631
dst:[fdde:ad00:beef:0:0:ff:fe00:4801]:61631
00:00:15.032
type:ICMP6(EchoReqst) len:16 checksum:0x942c sec:yes prio:norm rss:-20 from:0x4800 radio:15.4
src:[fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0
dst:[fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0
Done
Tài liệu tham khảo về CLI và API
lịch sử rxtx
Hiển thị nhật ký RX và TX của thông báo IPv6 kết hợp ở định dạng bảng hoặc danh sách.
Mỗi mục nhập trong bảng hoặc danh sách cung cấp:
- Độ tuổi: Thời gian đã trôi qua kể từ khi lệnh được đưa ra và được cung cấp ở định dạng:
hours
:minutes
:seconds
:milliseconds
- Loại:
- Loại thông báo IPv6, chẳng hạn như
UDP
,TCP
,HopOpts
vàICMP6
(cùng loại thông báo phụ). src
: Số cổng và địa chỉ IPv6 nguồn.dst
: Địa chỉ IPv6 đích và số cổng (số cổng hợp lệ đối với UDP/TCP, nếu không thì số cổng là 0).
- Loại thông báo IPv6, chẳng hạn như
- Len: Độ dài tải trọng IPv6 (không bao gồm tiêu đề IPv6).
- Chksum: Giá trị tổng kiểm của thông báo (có hiệu lực cho các thông báo UDP, TCP hoặc ICMP6).
- Sec: Cho biết liệu cơ chế bảo mật lớp liên kết có được sử dụng hay không.
- Mức độ ưu tiên: Mức độ ưu tiên của thư. Các giá trị có thể là
low
,norm
,high
hoặcnet
(đối với thông báo kiểm soát chuỗi). - RSS: Cường độ tín hiệu đã nhận (tính bằng dBm), được tính trung bình trên tất cả các khung mảnh nhận được tạo nên thông báo. Trong nhật ký TX,
NA
(không áp dụng) sẽ xuất hiện. - Dir: Cho biết tin nhắn được gửi (
TX
) hay đã nhận (RX
). Lỗi truyền không thành công được biểu thị bằngTX-F
ở định dạng bảng hoặctx-success:no
ở định dạng danh sách. Một số ví dụ về quá trình truyền không thành công bao gồm việctx
bị huỷ và không nhận đượcack
từ ứng dụng ngang hàng đối với bất kỳ mảnh thông báo nào. - Người hàng xóm: Địa chỉ ngắn (rlOC16) của người hàng xóm nhận tin nhắn được gửi/nhận. Nếu khung đã được truyền tin, thì khung đó sẽ hiển thị dưới dạng
bcast
ở định dạng bảng hoặc0xffff
ở định dạng danh sách. Nếu không có địa chỉ ngắn của thành phần lân cận, thì địa chỉ này sẽ hiện dưới dạngunknwn
ở định dạng bảng hoặc0xfffe
ở định dạng danh sách. - Đài: Đường liên kết vô tuyến nơi thư được gửi/nhận (hữu ích khi bật
OPENTHREAD_CONFIG_MULTI_RADIO
). Có thể là15.4
,trel
hoặcall
(nếu được gửi trên tất cả các đường liên kết chọn lọc).
Tham số
history rxtx [list] [num-entries]
- Sử dụng tuỳ chọn
list
để hiển thị kết quả ở định dạng danh sách. Nếu không, kết quả sẽ hiển thị ở định dạng bảng. - Sử dụng tuỳ chọn
num-entries
để giới hạn kết quả ở số lượng mục nhập gần đây nhất được chỉ định. Nếu bạn không sử dụng tuỳ chọn này, tất cả các mục đã lưu trữ sẽ hiện trong dữ liệu đầu ra.
Ví dụ
history rxtx
| Age | Type | Len | Chksum | Sec | Prio | RSS |Dir | Neighb | Radio |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | HopOpts | 44 | 0x0000 | yes | norm | -20 | RX | 0x0800 | 15.4 |
| 00:00:09.267 | src: [fdde:ad00:beef:0:0:ff:fe00:800]:0 |
| | dst: [ff03:0:0:0:0:0:0:2]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 12 | 0x6c6b | yes | net | -20 | RX | 0x0800 | 15.4 |
| 00:00:09.290 | src: [fdde:ad00:beef:0:0:ff:fe00:800]:61631 |
| | dst: [fdde:ad00:beef:0:0:ff:fe00:801]:61631 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | ICMP6(EchoReqst) | 16 | 0xc6a2 | yes | norm | -20 | RX | 0x0800 | 15.4 |
| 00:00:09.292 | src: [fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0 |
| | dst: [fdde:ad00:beef:0:af4c:3644:882a:3698]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | ICMP6(EchoReply) | 16 | 0xc5a2 | yes | norm | NA | TX | 0x0800 | 15.4 |
| 00:00:09.292 | src: [fdde:ad00:beef:0:af4c:3644:882a:3698]:0 |
| | dst: [fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0xaa0d | yes | net | NA | TX | 0x0800 | 15.4 |
| 00:00:09.294 | src: [fdde:ad00:beef:0:0:ff:fe00:801]:61631 |
| | dst: [fdde:ad00:beef:0:0:ff:fe00:800]:61631 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | HopOpts | 44 | 0x0000 | yes | norm | -20 | RX | 0x0800 | 15.4 |
| 00:00:09.296 | src: [fdde:ad00:beef:0:0:ff:fe00:800]:0 |
| | dst: [ff03:0:0:0:0:0:0:2]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0xc1d8 | no | net | -20 | RX | 0x0800 | 15.4 |
| 00:00:09.569 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0x3cb1 | no | net | -20 | RX | 0x0800 | 15.4 |
| 00:00:16.519 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0xeda0 | no | net | -20 | RX | 0x0800 | 15.4 |
| 00:00:20.599 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788 |
| | dst: [ff02:0:0:0:0:0:0:1]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 165 | 0xbdfa | yes | net | -20 | RX | 0x0800 | 15.4 |
| 00:00:21.059 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788 |
| | dst: [fe80:0:0:0:8893:c2cc:d983:1e1c]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 64 | 0x1c11 | no | net | NA | TX | 0x0800 | 15.4 |
| 00:00:21.062 | src: [fe80:0:0:0:8893:c2cc:d983:1e1c]:19788 |
| | dst: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 93 | 0xedff | no | net | -20 | RX | unknwn | 15.4 |
| 00:00:21.474 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788 |
| | dst: [fe80:0:0:0:8893:c2cc:d983:1e1c]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 44 | 0xd383 | no | net | NA | TX | bcast | 15.4 |
| 00:00:21.811 | src: [fe80:0:0:0:8893:c2cc:d983:1e1c]:19788 |
| | dst: [ff02:0:0:0:0:0:0:2]:19788 |
Done
history rxtx list 5
00:00:02.100
type:UDP len:50 checksum:0xd843 sec:no prio:net rss:-20 from:0x0800 radio:15.4
src:[fe80:0:0:0:54d9:5153:ffc6:df26]:19788
dst:[ff02:0:0:0:0:0:0:1]:19788
00:00:15.331
type:HopOpts len:44 checksum:0x0000 sec:yes prio:norm rss:-20 from:0x0800 radio:15.4
src:[fdde:ad00:beef:0:0:ff:fe00:800]:0
dst:[ff03:0:0:0:0:0:0:2]:0
00:00:15.354
type:UDP len:12 checksum:0x6c6b sec:yes prio:net rss:-20 from:0x0800 radio:15.4
src:[fdde:ad00:beef:0:0:ff:fe00:800]:61631
dst:[fdde:ad00:beef:0:0:ff:fe00:801]:61631
00:00:15.356
type:ICMP6(EchoReqst) len:16 checksum:0xc6a2 sec:yes prio:norm rss:-20 from:0x0800 radio:15.4
src:[fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0
dst:[fdde:ad00:beef:0:af4c:3644:882a:3698]:0
00:00:15.356
type:ICMP6(EchoReply) len:16 checksum:0xc5a2 sec:yes prio:norm tx-success:yes to:0x0800 radio:15.4
src:[fdde:ad00:beef:0:af4c:3644:882a:3698]:0
dst:[fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0
Done
Tài liệu tham khảo về CLI và API
nhật ký tx
Hiển thị lịch sử TX của tin nhắn IPv6 ở định dạng bảng hoặc danh sách.
Mỗi mục nhập trong bảng hoặc danh sách cung cấp:
- Độ tuổi: Thời gian đã trôi qua kể từ khi lệnh được đưa ra và được cung cấp ở định dạng:
hours
:minutes
:seconds
:milliseconds
- Loại:
- Loại thông báo IPv6, chẳng hạn như
UDP
,TCP
,HopOpts
vàICMP6
(cùng loại thông báo phụ). src
: Số cổng và địa chỉ IPv6 nguồn.dst
: Địa chỉ IPv6 đích và số cổng (số cổng hợp lệ đối với UDP/TCP, nếu không thì số cổng là 0).
- Loại thông báo IPv6, chẳng hạn như
- Len: Độ dài tải trọng IPv6 (không bao gồm tiêu đề IPv6).
- Chksum: Giá trị tổng kiểm của thông báo (có hiệu lực cho các thông báo UDP, TCP hoặc ICMP6).
- Sec: Cho biết liệu cơ chế bảo mật lớp liên kết có được sử dụng hay không.
- Mức độ ưu tiên: Mức độ ưu tiên của thư. Các giá trị có thể là
low
,norm
,high
hoặcnet
(đối với thông báo kiểm soát chuỗi). - RSS: Cường độ tín hiệu đã nhận (tính bằng dBm), được tính trung bình trên tất cả các khung mảnh nhận được tạo nên thông báo. Trong nhật ký TX,
NA
(không áp dụng) sẽ xuất hiện. - Dir: Cho biết tin nhắn được gửi (
TX
) hay đã nhận (RX
). Lỗi truyền không thành công được biểu thị bằngTX-F
ở định dạng bảng hoặctx-success:no
ở định dạng danh sách. Một số ví dụ về quá trình truyền không thành công bao gồm việctx
bị huỷ và không nhận đượcack
từ ứng dụng ngang hàng đối với bất kỳ mảnh thông báo nào. - Người hàng xóm: Địa chỉ ngắn (rlOC16) của người hàng xóm nhận tin nhắn được gửi/nhận. Nếu khung đã được truyền tin, thì khung đó sẽ hiển thị dưới dạng
bcast
ở định dạng bảng hoặc0xffff
ở định dạng danh sách. Nếu không có địa chỉ ngắn của thành phần lân cận, thì địa chỉ này sẽ hiện dưới dạngunknwn
ở định dạng bảng hoặc0xfffe
ở định dạng danh sách. - Đài: Đường liên kết vô tuyến nơi thư được gửi/nhận (hữu ích khi bật
OPENTHREAD_CONFIG_MULTI_RADIO
). Có thể là15.4
,trel
hoặcall
(nếu được gửi trên tất cả các đường liên kết chọn lọc).
Tham số
history tx [list] [num-entries]
- Sử dụng tuỳ chọn
list
để hiển thị kết quả ở định dạng danh sách. Nếu không, kết quả sẽ hiển thị ở định dạng bảng. - Sử dụng tuỳ chọn
num-entries
để giới hạn kết quả ở số lượng mục nhập gần đây nhất được chỉ định. Nếu bạn không sử dụng tuỳ chọn này, tất cả các mục đã lưu trữ sẽ hiện trong dữ liệu đầu ra.
Ví dụ
history tx
| Age | Type | Len | Chksum | Sec | Prio | RSS |Dir | Neighb | Radio |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | ICMP6(EchoReply) | 16 | 0x932c | yes | norm | NA | TX | 0x4800 | 15.4 |
| 00:00:18.798 | src: [fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0 |
| | dst: [fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 50 | 0xce87 | yes | net | NA | TX | 0x4800 | 15.4 |
| 00:00:18.800 | src: [fdde:ad00:beef:0:0:ff:fe00:4801]:61631 |
| | dst: [fdde:ad00:beef:0:0:ff:fe00:4800]:61631 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 64 | 0xf7ba | no | net | NA | TX | 0x4800 | 15.4 |
| 00:00:39.499 | src: [fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788 |
| | dst: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
| | UDP | 44 | 0x26d4 | no | net | NA | TX | bcast | 15.4 |
| 00:00:40.256 | src: [fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788 |
| | dst: [ff02:0:0:0:0:0:0:2]:19788 |
Done
history tx list
00:00:23.957
type:ICMP6(EchoReply) len:16 checksum:0x932c sec:yes prio:norm tx-success:yes to:0x4800 radio:15.4
src:[fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0
dst:[fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0
00:00:23.959
type:UDP len:50 checksum:0xce87 sec:yes prio:net tx-success:yes to:0x4800 radio:15.4
src:[fdde:ad00:beef:0:0:ff:fe00:4801]:61631
dst:[fdde:ad00:beef:0:0:ff:fe00:4800]:61631
00:00:44.658
type:UDP len:64 checksum:0xf7ba sec:no prio:net tx-success:yes to:0x4800 radio:15.4
src:[fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788
dst:[fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788
00:00:45.415
type:UDP len:44 checksum:0x26d4 sec:no prio:net tx-success:yes to:0xffff radio:15.4
src:[fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788
dst:[ff02:0:0:0:0:0:0:2]:19788
Done
Tài liệu tham khảo về CLI và API
ifconfig (lên,xuống)
Đưa giao diện IPv6 lên hoặc xuống.
Gọi lệnh này để bật hoặc tắt giao tiếp IPv6.
Tham số
ifconfig up|down
Ví dụ
ifconfig up
Done
ifconfig down
Done
Tài liệu tham khảo về CLI và API
ifconfig
Cho biết giao diện IPv6 có hoạt động hay không.
Tham số
Không có tham số.
Ví dụ
ifconfig
down
Done
ifconfig
up
Done
Tài liệu tham khảo về CLI và API
instanceid
Lấy giá trị nhận dạng thực thể.
Giá trị nhận dạng thực thể được đặt thành một giá trị ngẫu nhiên khi thực thể được tạo. Sau đó, giá trị của giá trị này sẽ không thay đổi sau khi khởi tạo.
Tham số
Không có tham số.
Ví dụ
instanceid
468697314
Done
Tài liệu tham khảo về CLI và API
Thêm ipaddr
Thêm địa chỉ giao diện mạng vào giao diện Thread.
Thực thể đã truyền aAddress
được sao chép bởi giao diện Thread. Giao diện Thread chỉ hỗ trợ một số lượng cố định các địa chỉ unicast được thêm bên ngoài. Vui lòng xem OPENTHREAD_CONFIG_IP6_MAX_EXT_UCAST_ADDRS
.
Tham số
ipaddr add aAddress
Ví dụ
ipaddr add 2001::dead:beef:cafe
Done
Tài liệu tham khảo về CLI và API
ipaddr del
Xoá địa chỉ giao diện mạng khỏi giao diện Thread.
Tham số
ipaddr del aAddress
Ví dụ
ipaddr del 2001::dead:beef:cafe
Done
Tài liệu tham khảo về CLI và API
ipaddr
Lấy danh sách các địa chỉ IPv6 được chỉ định cho giao diện Thread.
Tham số
ipaddr [-v]
Sử dụng -v
để nhận thông tin chi tiết hơn về địa chỉ:
origin
: có thể làthread
,slaac
,dhcp6
,manual
và cho biết điểm khởi hành của địa chỉplen
: độ dài tiền tốpreferred
: cờ ưu tiên (boolean)valid
: cờ hợp lệ (boolean)
Ví dụ
ipaddr
fdde:ad00:beef:0:0:ff:fe00:0
fdde:ad00:beef:0:558:f56b:d688:799
fe80:0:0:0:f3d9:2a82:c8d8:fe43
Done
ipaddr -v
fd5e:18fa:f4a5:b8:0:ff:fe00:fc00 origin:thread plen:64 preferred:0 valid:1
fd5e:18fa:f4a5:b8:0:ff:fe00:dc00 origin:thread plen:64 preferred:0 valid:1
fd5e:18fa:f4a5:b8:f8e:5d95:87a0:e82c origin:thread plen:64 preferred:0 valid:1
fe80:0:0:0:4891:b191:e277:8826 origin:thread plen:64 preferred:1 valid:1
Done
Tài liệu tham khảo về CLI và API
ipaddr linklocal
Lấy địa chỉ IPv6 liên kết cục bộ trên Thread.
Địa chỉ cục bộ Thread link được bắt nguồn bằng cách sử dụng địa chỉ mở rộng IEEE802.15.4 làm mã nhận dạng giao diện.
Tham số
Không có tham số.
Ví dụ
ipaddr linklocal
fe80:0:0:0:f3d9:2a82:c8d8:fe43
Done
Tài liệu tham khảo về CLI và API
ipaddr mleid
Lấy địa chỉ EID cục bộ của lưới.
Tham số
Không có tham số.
Ví dụ
ipaddr mleid
fdde:ad00:beef:0:558:f56b:d688:799
Done
Tài liệu tham khảo về CLI và API
khối ipaddr rloc
Lấy địa chỉ Bộ định vị luồng (rlOC).
Tham số
Không có tham số.
Ví dụ
ipaddr rloc
fdde:ad00:beef:0:0:ff:fe00:0
Done
Tài liệu tham khảo về CLI và API
Thêm ipmaddr
Đăng ký giao diện Thread với một địa chỉ đa hướng giao diện mạng.
Thực thể đã truyền aAddress
sẽ được giao diện Thread sao chép. Giao diện Thread chỉ hỗ trợ một số lượng địa chỉ đa hướng cố định được thêm vào bên ngoài. Vui lòng xem OPENTHREAD_CONFIG_IP6_MAX_EXT_MCAST_ADDRS
.
Tham số
ipmaddr add aAddress
Ví dụ
ipmaddr add ff05::1
Done
Tài liệu tham khảo về CLI và API
Hàm ipmaddr del
Huỷ đăng ký giao diện Thread đến một Địa chỉ đa hướng giao diện mạng.
Tham số
ipmaddr del aAddress
Ví dụ
ipmaddr del ff05::1
Done
Tài liệu tham khảo về CLI và API
ipmaddr
Lấy danh sách các địa chỉ phát đa hướng IPv6 đã đăng ký giao diện Thread.
Tham số
Không có tham số.
Ví dụ
ipmaddr
ff05:0:0:0:0:0:0:1
ff33:40:fdde:ad00:beef:0:0:1
ff32:40:fdde:ad00:beef:0:0:1
Done
Tài liệu tham khảo về CLI và API
ipmaddr llatn
Lấy địa chỉ đa hướng Thread Link-Local All Thread Nodes (Liên kết luồng-Local).
Địa chỉ này là một Địa chỉ đa hướng dựa trên tiền tố Unicast cục bộ [RFC 3306], với:
- flgs được đặt thành 3 (P = 1 và T = 1)
- đặt scop thành 2
- đặt thành 64
- tiền tố mạng được đặt thành Tiền tố cục bộ lưới
- đã đặt mã nhóm thành 1
Tham số
Không có tham số.
Ví dụ
ipmaddr llatn
ff32:40:fdde:ad00:beef:0:0:1
Done
Tài liệu tham khảo về CLI và API
Hàm ipmaddr rlatn
Lấy địa chỉ đa hướng Thread Realm-Local All Thread Nodes (Tất cả các nút luồng Threads).
Địa chỉ này là một Địa chỉ đa hướng dựa trên tiền tố Unicast cục bộ [RFC 3306], trong đó:
- flgs được đặt thành 3 (P = 1 và T = 1)
- đặt scop thành 3
- đặt thành 64
- tiền tố mạng được đặt thành Tiền tố cục bộ lưới
- đã đặt mã nhóm thành 1
Tham số
Không có tham số.
Ví dụ
ipmaddr rlatn
ff33:40:fdde:ad00:beef:0:0:1
Done
Tài liệu tham khảo về CLI và API
máy phân loại ghép nối (nhóm)
Thiết lập Joiner Discerner.
Tham số
joiner discerner discerner
- Sử dụng
{number}/{length}
để đặtdiscerner
. joiner discerner clear
đặtaDiscerner
thànhnullptr
.
Ví dụ
joiner discerner 0xabc/12
Done
Tài liệu tham khảo về CLI và API
CANNOT TRANSLATE
Xoá bộ nhận diện Joiner.
Tham số
Không có tham số.
Ví dụ
joiner discerner clear
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
chuyên gia ghép nối
Tìm hiểu về Joiner Discerner.
Để biết thêm thông tin, vui lòng tham khảo otJoinerSetDiscerner.
Tham số
Không có tham số.
Ví dụ
joiner discerner
0xabc/12
Done
Tài liệu tham khảo về CLI và API
trợ giúp trình kết hợp
In trình đơn trợ giúp joiner
.
Tham số
Không có tham số.
Ví dụ
joiner help
help
id
start
state
stop
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
mã trình kết hợp
Lấy Mã tham gia.
Nếu một Joiner Discerner không được thiết lập, Joiner ID là 64 bit đầu tiên của kết quả tính toán SHA-256 trên IEEE EUI-64 được chỉ định của nhà máy. Nếu không, Joiner ID sẽ được tính từ giá trị Joiner Discerner.
Joiner ID cũng được sử dụng làm Địa chỉ mở rộng IEEE 802.15.4 của thiết bị trong quá trình vận hành.
Tham số
Không có tham số.
Ví dụ
joiner id
d65e64fa83f81cf7
Done
Tài liệu tham khảo về CLI và API
CANNOT TRANSLATE
Bật vai trò Trình kết hợp chuỗi.
Tham số
joiner start joining-device-credential [provisioning-url]
joining-device-credential
: Cụm mật khẩu kết hợp. Phải là một chuỗi gồm tất cả các ký tự chữ-số viết hoa (0-9 và A-Y, ngoại trừ I, O, Q và Z để dễ đọc), với độ dài từ 6 đến 32 ký tự.provisioning-url
: URL cấp phép cho Trình tham gia (không bắt buộc).
Ví dụ
joiner start J01NM3
Done
Tài liệu tham khảo về CLI và API
trạng thái tham gia
Lấy Trạng thái tham gia.
Trả về một trong các trạng thái sau:
-
Idle
-
Discover
-
Connecting
-
Connected
-
Entrust
-
Joined
Tham số
Không có tham số.
Ví dụ
joiner state
Idle
Done
Tài liệu tham khảo về CLI và API
CANNOT TRANSLATE
Tắt vai trò Trình kết hợp chuỗi.
Tham số
Không có tham số.
Ví dụ
joiner stop
Done
Tài liệu tham khảo về CLI và API
cổng nối (bộ)
Thiết lập Cổng UDP cho người tham gia.
Tham số
joinerport udp-port
Ví dụ
joinerport 1000
Done
Tài liệu tham khảo về CLI và API
sân ghép
Lấy cổng UDP Joiner.
Tham số
Không có tham số.
Ví dụ
joinerport
1000
Done
Tài liệu tham khảo về CLI và API
bộ đếm keyequence (đã đặt)
Thiết lập thrKeySequenceCounter.
Tham số
keysequence counter counter
Ví dụ
keysequence counter 10
Done
Tài liệu tham khảo về CLI và API
bộ đếm keyequence
Lấy thrKeySequenceCounter.
Tham số
Không có tham số.
Ví dụ
keysequence counter
10
Done
Tài liệu tham khảo về CLI và API
thời gian bảo vệ phím tắt (đã đặt)
Đặt thrKeySwitchGuardTime (theo giờ).
Tham số
keysequence guardtime guardtime-hours
Hãy sử dụng 0
cho Thread Key Switch
ngay lập tức nếu có kết quả trùng khớp trong chỉ mục chính.
Ví dụ
keysequence guardtime 0
Done
Tài liệu tham khảo về CLI và API
thời gian bảo vệ phím
Lấy thrKeySwitchGuardTime (theo giờ).
Tham số
Không có tham số.
Ví dụ
keysequence guardtime
0
Done
Tài liệu tham khảo về CLI và API
dữ liệu lãnh đạo
Lấy dữ liệu về Thread Leader.
Tham số
Không có tham số.
Ví dụ
leaderdata
Partition ID: 1077744240
Weighting: 64
Data Version: 109
Stable Data Version: 211
Leader Router ID: 60
Done
Tài liệu tham khảo về CLI và API
dẫn đầu (set)
Đặt trọng số cho Thread Leader Weight được dùng khi hoạt động ở vai trò Leader (Người lãnh đạo).
Trực tiếp đặt Trọng số của người dẫn đầu thành giá trị mới, thay thế giá trị trước đó (có thể đã được xác định từ
otDeviceProperties
hiện tại).
Tham số
leaderweight weight
Ví dụ
leaderweight 128
Done
Tài liệu tham khảo về CLI và API
trọng số hàng đầu
Lấy Trọng số của trưởng nhóm luồng được dùng khi thao tác ở vai trò Trưởng nhóm.
Tham số
Không có tham số.
Ví dụ
leaderweight
128
Done
Tài liệu tham khảo về CLI và API
xoá xác nhận nâng cao cấu hình linkmetric
Gửi Yêu cầu quản lý chỉ số đường liên kết để xoá hoạt động thăm dò dựa trên ACK nâng cao.
Tham số
linkmetrics config [async] peer-ipaddr enhanced-ack clear
async
: Sử dụng chế độ không chặn.peer-ipaddr
phải là địa chỉ Liên kết cục bộ của thiết bị lân cận.
Ví dụ
linkmetrics config fe80:0:0:0:3092:f334:1455:1ad2 enhanced-ack clear
Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: Success
Done
Tài liệu tham khảo về CLI và API
thanh ghi nâng cao cấu hình linkmetric
r
bổ sung là không bắt buộc và chỉ dùng cho các thiết bị tham chiếu. Khi tuỳ chọn này được chỉ định, Enum Loại/Trung bình của mỗi Cờ loại mã nhận dạng sẽ được đặt thành dành riêng. Thông tin này dùng để xác minh rằng Chủ thể thăm dò xử lý đúng cách các cờ cho mã loại không hợp lệ và chỉ dùng được khi bạn bật OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
.
Gửi Yêu cầu quản lý chỉ số đường liên kết để đăng ký thăm dò dựa trên ACK nâng cao.
Tham số
linkmetrics config [async] peer-ipaddr enhanced-ack register [qmr][r]
async
: Sử dụng chế độ không chặn.- [
q
,m
vàr
] liên kết với otLinkMetricsValues. Theo quy cách 4.11.3.4.4.6, bạn chỉ có thể sử dụng tối đa hai lựa chọn cùng một lúc, ví dụ:q
hoặcqm
.q
: LQI lớp 2.m
: Lợi nhuận liên kết.r
: RSSI.
Ví dụ
linkmetrics config fe80:0:0:0:3092:f334:1455:1ad2 enhanced-ack register qm
Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: Success
Done
> linkmetrics config fe80:0:0:0:3092:f334:1455:1ad2 enhanced-ack register qm r
Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: Cannot support new series
Done
Tài liệu tham khảo về CLI và API
chuyển tiếp cấu hình linkmetric
Gửi Yêu cầu quản lý chỉ số đường liên kết MLE để định cấu hình hoặc xoá Chuỗi theo dõi chuyển tiếp.
Tham số
linkmetrics config [async] peer-ipaddr forward series-id [ldraX][pqmr]
async
: Sử dụng chế độ không chặn.peer-ipaddr
: Địa chỉ ngang hàng.series-id
: Mã bộ sách.- [
l
,d
,r
vàa
] liên kết với otLinkMetricsSeriesFlags.X
không biểu thị bất kỳ giá trị nào trong sốotLinkMetricsSeriesFlags
và dừng tính toán cũng như xoá chuỗi dữ liệu.l
: Đầu dò đường liên kết MLE.d
: Dữ liệu MAC.r
: Yêu cầu dữ liệu MAC.a
: MAC Ack.X
: Chỉ sử dụng được mà không có cờ nào khác.
- [
p
,q
,m
vàr
] liên kết với otLinkMetricsValues.p
: Số lượng PDU lớp 2 đã nhận được.q
: LQI lớp 2.m
: Lợi nhuận liên kết.r
: RSSI.
Ví dụ
linkmetrics config fe80:0:0:0:3092:f334:1455:1ad2 forward 1 dra pqmr
Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: SUCCESS
Done
Tài liệu tham khảo về CLI và API
thăm dò linkmetric
Gửi tin nhắn thăm dò đường liên kết MLE.
Tham số
linkmetrics probe peer-ipaddr series-id length
peer-ipaddr
: Địa chỉ ngang hàng.series-id
: Mã loạt chương trình mà thông báo Điều tra này nhắm đến.length
: Độ dài của thông báo từ Probe. Phạm vi hợp lệ là [0, 64].
Ví dụ
linkmetrics probe fe80:0:0:0:3092:f334:1455:1ad2 1 10
Done
Tài liệu tham khảo về CLI và API
chuyển tiếp yêu cầu linkmetric
Thực hiện truy vấn Chỉ số về đường liên kết (Loạt nội dung theo dõi chuyển tiếp).
Tham số
linkmetrics query [async] peer-ipaddr forward series-id
async
: Sử dụng chế độ không chặn.peer-ipaddr
: Địa chỉ ngang hàng.series-id
: Mã bộ sách.
Ví dụ
linkmetrics request fe80:0:0:0:3092:f334:1455:1ad2 forward 1
Received Link Metrics Report from: fe80:0:0:0:3092:f334:1455:1ad2
- PDU Counter: 2 (Count/Summation)
- LQI: 76 (Exponential Moving Average)
- Margin: 82 (dB) (Exponential Moving Average)
- RSSI: -18 (dBm) (Exponential Moving Average)
Done
Tài liệu tham khảo về CLI và API
yêu cầu linkmetric duy nhất
Thực hiện truy vấn Chỉ số đường liên kết (Một thăm dò).
Tham số
linkmetrics request [async] peer-ipaddr single [pqmr]
async
: Sử dụng chế độ không chặn.peer-ipaddr
: Địa chỉ ngang hàng.- [
p
,q
,m
vàr
] liên kết với otLinkMetrics.p
: Số lượng PDU lớp 2 đã nhận được.q
: LQI lớp 2.m
: Lợi nhuận liên kết.r
: RSSI.
Ví dụ
linkmetrics request fe80:0:0:0:3092:f334:1455:1ad2 single qmr
Received Link Metrics Report from: fe80:0:0:0:3092:f334:1455:1ad2
- LQI: 76 (Exponential Moving Average)
- Margin: 82 (dB) (Exponential Moving Average)
- RSSI: -18 (dBm) (Exponential Moving Average)
Done
Tài liệu tham khảo về CLI và API
linkmetricmgr (bật,tắt)
Bật hoặc tắt Trình quản lý chỉ số liên kết.
Tham số
linkmetricsmgr enable|disable
Ví dụ
linkmetricmgr enable
Done
linkmetricmgr disable
Done
Tài liệu tham khảo về CLI và API
chương trình linkmetricmgr
Nhận dữ liệu Chỉ số liên kết của hàng xóm theo địa chỉ mở rộng.
Tham số
Không có tham số.
Ví dụ
linkmetricsmgr show
ExtAddr:827aa7f7f63e1234, LinkMargin:80, Rssi:-20
Done
Tài liệu tham khảo về CLI và API
định vị (đặt)
Xác định vị trí đích gần nhất của một địa chỉ bất kỳ (tức là tìm EID cục bộ lưới của đích đến và rlOC16).
Điểm đến gần nhất được xác định dựa trên bảng định tuyến hiện tại và chi phí đường dẫn trong lưới Thread.
Có sẵn khi bạn bật OPENTHREAD_CONFIG_TMF_ANYCAST_LOCATOR_ENABLE
.
Tham số
locate anycastaddr
Ví dụ
locate fdde:ad00:beef:0:0:ff:fe00:fc00
fdde:ad00:beef:0:d9d3:9000:16b:d03b 0xc800
Done
Tài liệu tham khảo về CLI và API
định vị
Lấy trạng thái hiện tại (In Progress
hoặc Idle
) của trình định vị bất kỳ.
Có sẵn khi bạn bật OPENTHREAD_CONFIG_TMF_ANYCAST_LOCATOR_ENABLE
.
Tham số
Không có tham số.
Ví dụ
locate
Idle
Done
locate fdde:ad00:beef:0:0:ff:fe00:fc10
locate
In Progress
Done
Tài liệu tham khảo về CLI và API
tên tệp nhật ký
Chỉ định tên tệp để thu thập các thông báo
otPlatLog()
, hữu ích khi gỡ lỗi các tập lệnh kiểm thử tự động trên Linux khi việc ghi nhật ký làm gián đoạn các tập lệnh kiểm thử tự động.
Cần có OPENTHREAD_CONFIG_LOG_OUTPUT == OPENTHREAD_CONFIG_LOG_OUTPUT_DEBUG_UART
và OPENTHREAD_POSIX
.
Tham số
log filename filename
Ví dụ
Tài liệu tham khảo về CLI và API
cấp độ nhật ký (đã đặt)
Đặt cấp độ nhật ký.
Tham số
log level level
Ví dụ
log level 4
Done
Tài liệu tham khảo về CLI và API
cấp độ nhật ký
Lấy cấp độ nhật ký.
Tham số
Không có tham số.
Ví dụ
log level
1
Done
Tài liệu tham khảo về CLI và API
mac thử lại trực tiếp (get,set)
Lấy hoặc thiết lập số lần thử lại TX trực tiếp trên lớp MAC.
Tham số
mac retries direct [number]
Sử dụng đối số number
không bắt buộc để thiết lập số lần thử lại TX trực tiếp.
Ví dụ
mac retries direct
3
Done
mac retries direct 5
Done
Tài liệu tham khảo về CLI và API
mac thử lại gián tiếp (get,set)
Lấy hoặc thiết lập số lần thử lại TX gián tiếp trên lớp MAC.
Tham số
mac retries indirect [number]
Sử dụng đối số number
(không bắt buộc) để đặt số lần thử lại Tx gián tiếp.
Ví dụ
mac retries indirect
3
Done
max retries indirect 5
Done
Tài liệu tham khảo về CLI và API
gửi qua mac
Hướng dẫn thiết bị Rx-Off-When-Idle
gửi khung MAC đến thành phần mẹ. Lệnh này dùng để chứng nhận và chỉ dùng được khi bật OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
.
Tham số
mac send datarequest | emptydata
Bạn phải chọn một trong hai đối số sau:
datarequest
: Xếp một thông báo Yêu cầu dữ liệu của IEEE 802.15.4 vào hàng đợi để truyền.emptydata
: Hướng dẫn thiết bị gửi một khung dữ liệu IEEE 802.15.4 trống.
Ví dụ
mac send datarequest
Done
mac send emptydata
Done
Tài liệu tham khảo về CLI và API
Thêm địa chỉ macfilter
Chỉ có sẵn khi cấu hình OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
được bật.
Thêm một địa chỉ mở rộng IEEE 802.15.4 vào danh sách bộ lọc MAC. Nếu bạn chỉ định đối số rss
không bắt buộc, thì thao tác này sẽ sửa cường độ tín hiệu nhận được cho các thư từ địa chỉ này. Nếu bạn không sử dụng tuỳ chọn rss
, địa chỉ sẽ sử dụng giá trị mặc định mà bạn đã đặt. Nếu bạn chưa đặt giá trị mặc định, cường độ tín hiệu sẽ là tín hiệu không dây.
Tham số
macfilter addr add extaddr [rss]
Ví dụ
macfilter addr add 0f6127e33af6b403 -95
Done
macfilter addr add 0f6127e33af6b402
Done
Tài liệu tham khảo về CLI và API
danh sách cho phép địa chỉ macfilter
Bật chế độ bộ lọc MAC allowlist
, nghĩa là chỉ các địa chỉ MAC trong danh sách bộ lọc MAC mới được phép truy cập.
Tham số
Không có tham số.
Ví dụ
macfilter addr allowlist
Done
Tài liệu tham khảo về CLI và API
macfilter addr xoá
Có sẵn khi cấu hình OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
được bật.
Lệnh này xoá tất cả địa chỉ mở rộng khỏi danh sách bộ lọc MAC.
Tham số
Không có tham số.
Ví dụ
macfilter addr clear
Done
Tài liệu tham khảo về CLI và API
danh sách từ chối macfilter addr
Bật chế độ bộ lọc MAC denylist
, nghĩa là tất cả các địa chỉ MAC trong danh sách bộ lọc MAC sẽ bị từ chối truy cập.
Tham số
Không có tham số.
Ví dụ
macfilter addr denylist
Done
Tài liệu tham khảo về CLI và API
tắt macfilter addr vô hiệu hoá
Tắt chế độ lọc MAC.
Tham số
Không có tham số.
Ví dụ
macfilter addr disable
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
địa chỉ macfilter
Có sẵn khi cấu hình OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
được bật.
Cung cấp các thông tin sau:
- Chế độ hiện tại của danh sách bộ lọc MAC:
AllowList
,DenyList,
hoặcDisabled
- Danh sách tất cả địa chỉ mở rộng trong bộ lọc. Cường độ tín hiệu nhận được (RSS) và chỉ báo chất lượng đường liên kết (kotlin) được liệt kê bên cạnh địa chỉ nếu các giá trị này đã được đặt khác với các giá trị mặc định.
Tham số
Không có tham số.
Ví dụ
macfilter addr
Allowlist
0f6127e33af6b403 : rss -95 (lqi 1)
0f6127e33af6b402
Done
Tài liệu tham khảo về CLI và API
xoá địa chỉ macfilter
Có sẵn khi cấu hình OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
được bật.
Lệnh này sẽ xoá địa chỉ mở rộng được chỉ định khỏi danh sách bộ lọc MAC.
Tham số
macfilter addr remove extaddr
Ví dụ
macfilter addr remove 0f6127e33af6b402
Done
Tài liệu tham khảo về CLI và API
Macfilter
Cung cấp các thông tin sau:
Address Mode
: Chế độ hiện tại của bộ lọc MAC:AllowList
,DenyList,
hoặcDisabled
- Danh sách tất cả các địa chỉ mở rộng trong danh sách bộ lọc MAC. Cường độ tín hiệu nhận được (RSS) và chỉ báo chất lượng đường liên kết (kotlin) được liệt kê bên cạnh địa chỉ nếu các giá trị này đã được đặt khác với các giá trị mặc định.
- Một danh sách riêng (
RssIn List
) hiển thị tất cả các địa chỉ mở rộng màrss
đã được đặt khác với giá trị mặc định. Default rss
: Cho thấy các giá trị mặc định (nếu có) cho chế độ cài đặtrss
vàlqi
.
Tham số
Không có tham số.
Ví dụ
macfilter
Address Mode: Allowlist
0f6127e33af6b403 : rss -95 (lqi 1)
0f6127e33af6b402
RssIn List:
0f6127e33af6b403 : rss -95 (lqi 1)
Default rss: -50 (lqi 3)
Done
Tài liệu tham khảo về CLI và API
Thêm macfilter
Thêm Địa chỉ mở rộng đã chỉ định vào danh sách RssIn
(hoặc sửa đổi một địa chỉ hiện có trong danh sách RssIn
) và thiết lập mục cường độ tín hiệu đã nhận (tính bằng dBm) cho các thông báo từ địa chỉ đó.
Tham số
macfilter rss add extaddr rss
Để đặt giá trị mặc định cho cường độ tín hiệu nhận được đối với tất cả tin nhắn nhận được, hãy dùng *
cho đối số extaddr
.
Ví dụ
macfilter rss add * -50
Done
macfilter rss add 0f6127e33af6b404 -85
Done
Tài liệu tham khảo về CLI và API
macfilter bổ sung thêm-chính thức
Thêm Địa chỉ mở rộng đã chỉ định vào danh sách RssIn
(hoặc sửa đổi một địa chỉ có trong danh sách RssIn
) và đặt chỉ báo chất lượng đường liên kết cố định cho các thư gửi từ địa chỉ đó. Địa chỉ mở rộng không nhất thiết phải nằm trong bộ lọc address allowlist/denylist
để đặt lqi
.
Bạn chỉ có thể sử dụng tính năng này khi bật cấu hình OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
.
Tham số
macfilter rss add-lqi extaddr lqi
Để đặt giá trị mặc định cho chỉ báo chất lượng đường liên kết cho tất cả tin nhắn đã nhận, hãy dùng *
cho đối số extaddr
. Phạm vi cho phép là từ 0 đến 3.
Ví dụ
macfilter rss add-lqi * 3
Done
macfilter rss add-lqi 0f6127e33af6b404 2
Done
Tài liệu tham khảo về CLI và API
rõ ràng macfilter
Xoá tất cả mục nhập cường độ tín hiệu đã nhận (rss
) và chỉ báo chất lượng liên kết (lqi
) (bao gồm cả giá trị mặc định) khỏi danh sách RssIn
.
Thực hiện tác vụ này có nghĩa là tất cả Địa chỉ mở rộng sẽ sử dụng tín hiệu trực tuyến.
Có sẵn khi cấu hình OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
được bật.
Tham số
Không có tham số.
Ví dụ
macfilter rss clear
Done
Tài liệu tham khảo về CLI và API
RSS macfilter
Cung cấp các thông tin sau:
- Danh sách tất cả các địa chỉ mở rộng mà cường độ tín hiệu nhận được (
rss
) đã được đặt khác với giá trị mặc định. Chỉ báo chất lượng của đường liên kết (lqi
) cũng sẽ xuất hiện. Chế độ cài đặtrss
vàlqi
liên kết với nhau. Nếu bạn đặt một giá trị, giá trị còn lại sẽ được đặt tự động. Danh sách địa chỉ này được gọi làRssIn List
. Việc đặtrsi
hoặclqi
sẽ thêm địa chỉ mở rộng tương ứng vào danh sáchRssIn
. Default rss
: Cho thấy các giá trị mặc định (nếu có) cho chế độ cài đặtrss
vàlqi
.
Tham số
Không có tham số.
Ví dụ
macfilter rss
0f6127e33af6b403 : rss -95 (lqi 1)
Default rss: -50 (lqi 3)
Done
Tài liệu tham khảo về CLI và API
xóa macfilter RSS
Xoá Địa chỉ mở rộng đã chỉ định khỏi danh sách RssIn
.
Sau khi bị xóa khỏi danh sách RssIn
, địa chỉ MAC này sẽ sử dụng các chế độ cài đặt rss
và lqi
mặc định, giả sử bạn đã đặt các giá trị mặc định. (Nếu bạn chưa đặt giá trị mặc định, tín hiệu không dây sẽ được sử dụng.)
Có sẵn khi cấu hình OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
được bật.
Sẽ không có hành động nào được thực hiện nếu không có mục nhập nào trong danh sách RssIn
khớp với Địa chỉ mở rộng đã chỉ định.
Tham số
macfilter rss remove extaddr
Nếu bạn muốn xoá chế độ cài đặt mặc định về chỉ báo chất lượng của đường liên kết và cường độ tín hiệu đã nhận, hãy sử dụng *
làm extaddr
. Thao tác này sẽ không đặt giá trị mặc định nhưng không xoá các mục khỏi danh sách RssIn
.
Ví dụ
macfilter rss remove *
Done
macfilter rss remove 0f6127e33af6b404
Done
Tài liệu tham khảo về CLI và API
Mega chẩn đoán childip6
Gửi truy vấn đến một nhà xuất bản mẹ để truy xuất địa chỉ IPv6 của tất cả nhà xuất bản con MTD.
Tham số
meshdiag childip6 parent-rloc16
Ví dụ
meshdiag childip6 0xdc00
child-rloc16: 0xdc02
fdde:ad00:beef:0:ded8:cd58:b73:2c21
fd00:2:0:0:c24a:456:3b6b:c597
fd00:1:0:0:120b:95fe:3ecc:d238
child-rloc16: 0xdc03
fdde:ad00:beef:0:3aa6:b8bf:e7d6:eefe
fd00:2:0:0:8ff8:a188:7436:6720
fd00:1:0:0:1fcf:5495:790a:370f
Done
Tài liệu tham khảo về CLI và API
bảng chẩn đoán lưới cho trẻ em
Bắt đầu truy vấn bảng con của bộ định tuyến bằng rlOC16 cho sẵn. Kết quả liệt kê tất cả các mục nhập con. Thông tin cho mỗi trẻ:
- RLOC16
- Địa chỉ MAC mở rộng
- Phiên bản luồng
- Thời gian chờ (tính bằng giây)
- Độ tuổi (số giây kể từ lần nghe gần đây nhất)
- Khoảng thời gian giám sát (tính bằng giây)
- Số tin nhắn đã xếp hàng đợi (trong trường hợp trẻ buồn ngủ)
- Chế độ thiết bị
- RSS (trung bình và cuối cùng)
- Tỷ lệ lỗi: khung tx (tại lớp MAC), thông báo IPv6 tx (trên MAC)
- Thời gian kết nối (giây kể từ khi thiết lập đường liên kết ở định dạng
{dd}d.{hh}:{mm}:{ss}
) - Thông tin CSL:
- Nếu đã đồng bộ hoá
- Kỳ (theo đơn vị 10 ký hiệu-thời gian)
- Thời gian chờ (tính bằng giây)
Tham số
Không có tham số.
Ví dụ
meshdiag childtable 0x6400
rloc16:0x6402 ext-addr:8e6f4d323bbed1fe ver:4
timeout:120 age:36 supvn:129 q-msg:0
rx-on:yes type:ftd full-net:yes
rss - ave:-20 last:-20 margin:80
err-rate - frame:11.51% msg:0.76%
conn-time:00:11:07
csl - sync:no period:0 timeout:0 channel:0
rloc16:0x6403 ext-addr:ee24e64ecf8c079a ver:4
timeout:120 age:19 supvn:129 q-msg:0
rx-on:no type:mtd full-net:no
rss - ave:-20 last:-20 margin:80
err-rate - frame:0.73% msg:0.00%
conn-time:01:08:53
csl - sync:no period:0 timeout:0 channel:0
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
bộ định tuyến Grid chẩn đoán lân cận
Bắt đầu truy vấn bảng lân cận bộ định tuyến của bộ định tuyến bằng rlOC16 cho sẵn. Đầu ra liệt kê tất cả các mục nhập lân cận của bộ định tuyến. Thông tin cho mỗi mục nhập:
- RLOC16
- Địa chỉ MAC mở rộng
- Phiên bản luồng
- RSS (trung bình và cuối cùng) và lề của đường liên kết
- Tỷ lệ lỗi, tx khung (tại lớp MAC), thông báo IPv6 tx (trên MAC)
- Thời gian kết nối (giây kể từ khi thiết lập đường liên kết ở định dạng
{dd}d.{hh}:{mm}:{ss}
)
Tham số
meshdiag routerneighbortable router-rloc16
Ví dụ
meshdiag routerneighbortable 0x7400
rloc16:0x9c00 ext-addr:764788cf6e57a4d2 ver:4
rss - ave:-20 last:-20 margin:80
err-rate - frame:1.38% msg:0.00%
conn-time:01:54:02
rloc16:0x7c00 ext-addr:4ed24fceec9bf6d3 ver:4
rss - ave:-20 last:-20 margin:80
err-rate - frame:0.72% msg:0.00%
conn-time:00:11:27
Done
Tài liệu tham khảo về CLI và API
cấu trúc liên kết chẩn đoán lưới
Khám phá cấu trúc liên kết mạng (danh sách bộ định tuyến và kết nối của chúng). Thông số là không bắt buộc và cho biết các mục bổ sung cần khám phá. Có thể thêm vào theo thứ tự bất kỳ.
ip6-addrs
để khám phá danh sách địa chỉ IPv6 của mọi bộ định tuyến.children
để khám phá bảng con của mọi bộ định tuyến.
Thông tin theo từng bộ định tuyến:
- Mã bộ định tuyến
- RLOC16
- Địa chỉ MAC mở rộng
- Phiên bản luồng (nếu biết)
- Liệu bộ định tuyến có phải là chính thiết bị này hay không (
me
) - Liệu bộ định tuyến có phải là cha mẹ của thiết bị này hay không khi thiết bị là con (
parent
) - Bộ định tuyến có phải là
leader
hay không - Liệu bộ định tuyến có hoạt động như một bộ định tuyến biên cung cấp kết nối bên ngoài hay không (
br
) - Danh sách bộ định tuyến mà bộ định tuyến này có liên kết:
3-links
: Mã bộ định tuyến mà bộ định tuyến này có đường liên kết đến có chất lượng đường liên kết là 32-links
: Mã bộ định tuyến mà bộ định tuyến này có đường liên kết đến có chất lượng đường liên kết là 21-links
: Mã bộ định tuyến mà bộ định tuyến này có đường liên kết đến có chất lượng đường liên kết là 1- Nếu một danh sách trống thì danh sách đó sẽ bị bỏ qua ở phần bên ngoài.
- Nếu là
ip6-addrs
, danh sách các địa chỉ IPv6 của bộ định tuyến - Nếu là
children
, hãy liệt kê tất cả thành phần con của bộ định tuyến. Thông tin cho mỗi trẻ:- RLOC16
- Chất lượng đường liên kết đến theo quan điểm giữa nhà xuất bản mẹ với nhà xuất bản con (số 0 cho biết không xác định)
- Chế độ Thiết bị con (
r
rx-on-when-idle,d
Thiết bị chuỗi đầy đủ,n
Dữ liệu mạng đầy đủ,-
chưa đặt cờ nào) - Liệu trẻ có phải là chính thiết bị này hay không (
me
) - Liệu thành phần con có đóng vai trò là bộ định tuyến biên cung cấp kết nối bên ngoài hay không (
br
)
Tham số
meshdiag topology [ip6-addrs] [children]
Ví dụ
meshdiag topology
id:02 rloc16:0x0800 ext-addr:8aa57d2c603fe16c ver:4 - me - leader
3-links:{ 46 }
id:46 rloc16:0xb800 ext-addr:fe109d277e0175cc ver:4
3-links:{ 02 51 57 }
id:33 rloc16:0x8400 ext-addr:d2e511a146b9e54d ver:4
3-links:{ 51 57 }
id:51 rloc16:0xcc00 ext-addr:9aab43ababf05352 ver:4
3-links:{ 33 57 }
2-links:{ 46 }
id:57 rloc16:0xe400 ext-addr:dae9c4c0e9da55ff ver:4
3-links:{ 46 51 }
1-links:{ 33 }
Done
Tài liệu tham khảo về CLI và API
cây mleadvimax
Lấy giá trị Tối đa khoảng thời gian hiện tại được bộ tính giờ nhỏ giọt Quảng cáo sử dụng.
API này yêu cầu phải có OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
và chỉ dành cho mục đích kiểm thử.
Tham số
Không có tham số.
Ví dụ
mleadvimax
12000
Done
Tài liệu tham khảo về CLI và API
mliid
Đặt IID cục bộ của lưới (cho mục đích thử nghiệm).
Cần có OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
.
Bạn phải dùng phương thức này trước khi bật ngăn xếp luồng.
Chỉ dành cho thiết bị thử nghiệm/thiết bị tham chiếu.
Tham số
mliid iid
Ví dụ
mliid 1122334455667788
Done
Tài liệu tham khảo về CLI và API
CANNOT TRANSLATE
Đăng ký trình nghe đa hướng (multicast) cho bộ định tuyến đường trục chính.
Bạn phải bật OPENTHREAD_CONFIG_TMF_PROXY_MLR_ENABLE
và OPENTHREAD_CONFIG_COMMISSIONER_ENABLE
.
Bỏ qua thời gian chờ để sử dụng thời gian chờ MLR mặc định trên Bộ định tuyến xương trục chính.
Sử dụng timeout = 0 để huỷ đăng ký Trình nghe đa hướng.
Tham số
mlr reg ipaddr [timeout]
Ví dụ
mlr reg ff04::1
status 0, 0 failed
Done
mlr reg ff04::1 ff04::2 ff02::1
status 2, 1 failed
ff02:0:0:0:0:0:0:1
Done
mlr reg ff04::1 ff04::2 1000
status 0, 0 failed
Done
mlr reg ff04::1 ff04::2 0
status 0, 0 failed
Done
Tài liệu tham khảo về CLI và API
chế độ (lấy,đặt)
Đặt cấu hình Chế độ liên kết MLE.
Tham số
mode [rdn]
-
: chưa đặt cờ nào (rx-off-when-idle, thiết bị Thread tối thiểu, dữ liệu mạng ổn định)r
: rx-on-when-idled
: Thiết bị luồng đầy đủn
: Dữ liệu mạng đầy đủ
Ví dụ
mode rdn
Done
mode -
Done
Tài liệu tham khảo về CLI và API
đa đài
Lấy danh sách các đường liên kết radio được hỗ trợ theo thiết bị.
Lệnh này luôn dùng được, ngay cả khi thiết bị chỉ hỗ trợ một đài.
Tham số
Không có tham số.
Ví dụ
multiradio
[15.4, TREL]
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
danh sách hàng xóm của multiradio
Lấy thông tin nhiều đường liên kết vô tuyến liên kết với một thành phần lân cận có Địa chỉ mở rộng cụ thể.
Bạn phải bật OPENTHREAD_CONFIG_MULTI_RADIO
.
Tham số
Không có tham số.
Ví dụ
multiradio neighbor list
ExtAddr:3a65bc38dbe4a5be, RLOC16:0xcc00, Radios:[15.4(255), TREL(255)]
ExtAddr:17df23452ee4a4be, RLOC16:0x1300, Radios:[15.4(255)]
Done
Tài liệu tham khảo về CLI và API
CANNOT TRANSLATE
Lấy thông tin nhiều đường liên kết vô tuyến liên kết với một thành phần lân cận có Địa chỉ mở rộng cụ thể.
Bạn phải bật OPENTHREAD_CONFIG_MULTI_RADIO
.
Tham số
multiradio neighbor ext-address
Ví dụ
multiradio neighbor 3a65bc38dbe4a5be
[15.4(255), TREL(255)]
Done
Tài liệu tham khảo về CLI và API
nat64 (bật,tắt)
Bật hoặc tắt các hàm NAT64.
Khi bạn bật OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
, việc tắt chế độ cài đặt này thành true sẽ đặt lại bảng liên kết trong trình biên dịch.
Có sẵn khi bạn bật OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
hoặc OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE
.
Tham số
nat64 enable|disable
Ví dụ
nat64 enable
Done
nat64 disable
Done
Tài liệu tham khảo về CLI và API
rượu táo nat64
Tham số
Không có tham số.
Ví dụ
nat64 cidr 192.168.255.0/24
Done
Tài liệu tham khảo về CLI và API
rượu táo nat64
Lấy CIDR IPv4 được định cấu hình trong trình dịch NAT64.
Có sẵn khi bạn bật OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
.
Tham số
Không có tham số.
Ví dụ
nat64 cidr
192.168.255.0/24
Done
Tài liệu tham khảo về CLI và API
bộ đếm nat64
Lấy gói trình dịch NAT64 và bộ đếm lỗi.
Có sẵn khi bạn bật OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
.
Tham số
Không có tham số.
Ví dụ
nat64 counters
| | 4 to 6 | 6 to 4 |
+---------------+-------------------------+-------------------------+
| Protocol | Pkts | Bytes | Pkts | Bytes |
+---------------+----------+--------------+----------+--------------+
| Total | 11 | 704 | 11 | 704 |
| TCP | 0 | 0 | 0 | 0 |
| UDP | 0 | 0 | 0 | 0 |
| ICMP | 11 | 704 | 11 | 704 |
| Errors | Pkts | Pkts |
+---------------+-------------------------+-------------------------+
| Total | 8 | 4 |
| Illegal Pkt | 0 | 0 |
| Unsup Proto | 0 | 0 |
| No Mapping | 2 | 0 |
Done
Tài liệu tham khảo về CLI và API
ánh xạ nat64
Lấy thông tin AddressMapping tiếp theo (sử dụng biến lặp).
Có sẵn khi bạn bật OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
.
Tham số
Không có tham số.
Ví dụ
nat64 mappings
| | Address | | 4 to 6 | 6 to 4 |
+----------+---------------------------+--------+--------------+--------------+
| ID | IPv6 | IPv4 | Expiry | Pkts | Bytes | Pkts | Bytes |
+----------+------------+--------------+--------+------+-------+------+-------+
| 00021cb9 | fdc7::df79 | 192.168.64.2 | 7196s | 6 | 456 | 11 | 1928 |
| | TCP | 0 | 0 | 0 | 0 |
| | UDP | 1 | 136 | 16 | 1608 |
| | ICMP | 5 | 320 | 5 | 320 |
Tài liệu tham khảo về CLI và API
trạng thái nat64
Lấy trạng thái của các hàm NAT64.
Trạng thái PrefixManager
sẽ có sẵn khi bạn bật OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE
. Trạng thái Translator
sẽ có sẵn khi bạn bật OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
.
Khi OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE
được bật, PrefixManager
sẽ trả về một trong các trạng thái sau:
Disabled
: Trình quản lý tiền tố NAT64 đã bị tắt.NotRunning
: Trình quản lý tiền tố NAT64 đã được bật nhưng hiện không chạy. Điều này có thể có nghĩa là trình quản lý định tuyến đã bị tắt.Idle
: Trình quản lý tiền tố NAT64 đã được bật và đang chạy nhưng không xuất bản tiền tố NAT64. Điều này có thể xảy ra khi có một bộ định tuyến biên khác xuất bản tiền tố NAT64 có mức độ ưu tiên cao hơn.Active
: Trình quản lý tiền tố NAT64 đã được bật, chạy và xuất bản tiền tố NAT64.
Khi OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
được bật, Translator
sẽ trả về một trong các trạng thái sau:
Disabled
: Trình dịch NAT64 đã bị tắt.NotRunning
: Trình dịch NAT64 đã được bật nhưng không dịch gói. Điều này có nghĩa là Trình biên dịch không được định cấu hình bằng tiền tố NAT64 hoặc CIDR cho NAT64.Active
: Trình dịch NAT64 đã được bật và đang dịch gói.
Tham số
Không có tham số.
Ví dụ
nat64 state
PrefixManager: Active
Translator: Active
Done
Tài liệu tham khảo về CLI và API
danh sách liên kết với hàng xóm
In thời gian kết nối và tuổi của các thành viên lân cận. Lệnh này tương tự như neighbor conntime
nhưng hiển thị thông tin ở định dạng danh sách. Tuổi và thời gian kết nối đều được hiển thị theo giây.
Tham số
Không có tham số.
Ví dụ
neighbor conntime list
0x8401 1a28be396a14a318 age:63 conn-time:644
0x5c00 723ebf0d9eba3264 age:23 conn-time:852
0xe800 ce53628a1e3f5b3c age:23 conn-time:180
Done
Tài liệu tham khảo về CLI và API
CANNOT TRANSLATE
In thời gian kết nối và tuổi của các thành viên lân cận. Thông tin của mỗi hàng xóm:
- RLOC16
- MAC mở rộng
- Lần nghe gần đây nhất (Độ tuổi): Số giây kể từ lần nghe gần đây nhất từ người hàng xóm.
- Thời gian kết nối: Số giây kể từ khi thiết lập liên kết với mục hàng lân cận. Khoảng thời gian sẽ được định dạng là
{hh}:{mm}:{ss}
cho giờ, phút và giây nếu khoảng thời gian đó ngắn hơn một ngày. Nếu thời lượng dài hơn một ngày, thì định dạng sẽ là{dd}d.{hh}:{mm}:{ss}
.
Tham số
Không có tham số.
Ví dụ
neighbor conntime
| RLOC16 | Extended MAC | Last Heard (Age) | Connection Time |
+--------+------------------+------------------+------------------+
| 0x8401 | 1a28be396a14a318 | 00:00:13 | 00:07:59 |
| 0x5c00 | 723ebf0d9eba3264 | 00:00:03 | 00:11:27 |
| 0xe800 | ce53628a1e3f5b3c | 00:00:02 | 00:00:15 |
Done
Tài liệu tham khảo về CLI và API
chất lượng đường liên kết của hàng xóm
In thông tin chất lượng liên kết về tất cả các thành phần lân cận.
Tham số
Không có tham số.
Ví dụ
neighbor linkquality
| RLOC16 | Extended MAC | Frame Error | Msg Error | Avg RSS | Last RSS | Age |
+--------+------------------+-------------+-----------+---------+----------+-------+
| 0xe800 | 9e2fa4e1b84f92db | 0.00 % | 0.00 % | -46 | -48 | 1 |
| 0xc001 | 0ad7ed6beaa6016d | 4.67 % | 0.08 % | -68 | -72 | 10 |
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
danh sách hàng xóm
Liệt kê rlOC16 của mỗi hàng xóm.
Tham số
Không có tham số.
Ví dụ
neighbor list
0xcc01 0xc800 0xf000
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
bảng hàng xóm
In thông tin về tất cả các thành phần lân cận ở định dạng bảng.
Đối với Role
, các giá trị duy nhất có thể có cho bảng này là C
(Con) hoặc R
(Bộ định tuyến).
Các cột sau đây cung cấp thông tin về chế độ thiết bị của các thành phần lân cận. Mỗi cột có giá trị 0
(tắt) hoặc 1
(bật).
R
: RX bật khi không hoạt độngD
: Thiết bị Thread Full ThreadN
: Dữ liệu mạng đầy đủ
Tham số
Không có tham số.
Ví dụ
neighbor table
| Role | RLOC16 | Age | Avg RSSI | Last RSSI |R|D|N| Extended MAC |
+------+--------+-----+----------+-----------+-+-+-+------------------+
| C | 0xcc01 | 96 | -46 | -46 |1|1|1| 1eb9ba8a6522636b |
| R | 0xc800 | 2 | -29 | -29 |1|1|1| 9a91556102c39ddb |
| R | 0xf000 | 3 | -28 | -28 |1|1|1| 0ad7ed6beaa6016d |
Done
Tài liệu tham khảo về CLI và API
netdata đầy
In "có" hoặc "no" cho biết liệu "dữ liệu ròng đã đầy" hay chưa đã gọi lệnh gọi lại kể từ khi bắt đầu thao tác Thread hoặc kể từ lần gần nhất netdata full reset
được dùng để đặt lại cờ. Lệnh này cần có OPENTHREAD_CONFIG_BORDER_ROUTER_SIGNAL_NETWORK_DATA_FULL
. "Dữ liệu ròng đầy" lệnh gọi lại được gọi bất cứ khi nào:
- Thiết bị đóng vai trò là thiết bị hàng đầu và nhận được đăng ký Dữ liệu mạng từ Bộ định tuyến biên (BR) mà thiết bị không thể thêm vào Dữ liệu mạng (hết dung lượng).
- Thiết bị này đang hoạt động như một Brazil và không thể thêm các mục nhập mới vào Dữ liệu mạng cục bộ của thiết bị.
- Thiết bị này hoạt động như một BR và cố gắng đăng ký các mục nhập Dữ liệu mạng cục bộ với trưởng nhóm, nhưng xác định rằng các mục nhập dữ liệu cục bộ của thiết bị sẽ không phù hợp.
Tham số
Không có tham số.
Ví dụ
netdata full
no
Done
Tài liệu tham khảo về CLI và API
đặt lại toàn bộ netdata
Đặt lại theo dõi cờ cho dù "dữ liệu ròng đã đầy" đã được gọi.
Tham số
Không có tham số.
Ví dụ
netdata full reset
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
độ dài dữ liệu mạng
Lấy độ dài hiện tại (số byte) của Dữ liệu mạng luồng của Phân vùng.
Tham số
Không có tham số.
Ví dụ
netdata length
23
Done
Tài liệu tham khảo về CLI và API
độ dài tối đa của dữ liệu net
Lấy độ dài tối đa quan sát được của Dữ liệu mạng luồng kể từ khi khởi chạy ngăn xếp OT hoặc kể từ lệnh gọi gần đây nhất đến
otNetDataResetMaxLength()
.
Tham số
Không có tham số.
Ví dụ
netdata maxlength
40
Done
Tài liệu tham khảo về CLI và API
đặt lại độ dài tối đa của netdata
Đặt lại độ dài tối đa được theo dõi của Thread Network Data (Dữ liệu mạng Thread).
Tham số
Không có tham số.
Ví dụ
netdata maxlength reset
Done
Tài liệu tham khảo về CLI và API
netdata xuất bản dnssrp Anycast
Xuất bản một địa chỉ Anycast dịch vụ DNS/SRP kèm theo số thứ tự. Mọi mục nhập Dịch vụ DNS/SRP hiện tại đang được xuất bản từ lệnh publish dnssrp{anycast|unicast}
trước đó sẽ bị xoá và thay thế bằng các đối số mới.
Bạn phải bật OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE
.
Tham số
netdata publish dnssrp anycast seq-num
Ví dụ
netdata publish dnssrp anycast 1
Done
Tài liệu tham khảo về CLI và API
- netdata xuất bản dnssrp unicast (addr,port)
- netdata xuất bản dnssrp unicast (mle)
- otNetDataPublishDnsSrpServiceAnycast
netdata xuất bản dnssrp unicast (addr,port)
Xuất bản một địa chỉ Unicast của dịch vụ DNS/SRP có địa chỉ và số cổng. Thông tin về địa chỉ và cổng có trong dữ liệu TLV của dịch vụ. Mọi mục nhập Dịch vụ DNS/SRP hiện tại đang được xuất bản từ lệnh publish dnssrp{anycast|unicast}
trước đó sẽ bị xoá và thay thế bằng các đối số mới.
Bạn phải bật OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE
.
Tham số
netdata publish dnssrp unicast address port
Ví dụ
netdata publish dnssrp unicast fd00::1234 51525
Done
Tài liệu tham khảo về CLI và API
- netdata xuất bản dnssrp unicast (mle)
- netdata xuất bản dnssrp Anycast
- otNetDataPublishDnsSrpServiceUnicast
netdata xuất bản dnssrp unicast (mle)
Xuất bản EID Mesh-Local của thiết bị kèm theo số cổng. MLE và thông tin cổng có trong dữ liệu TLV máy chủ. Để sử dụng một địa chỉ Unicast khác, hãy dùng lệnh netdata publish dnssrp unicast (addr,port)
.
Mọi mục nhập Dịch vụ DNS/SRP hiện tại đang được xuất bản từ lệnh publish dnssrp{anycast|unicast}
trước đó sẽ bị xoá và thay thế bằng các đối số mới.
Bạn phải bật OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE
.
Tham số
netdata publish dnssrp unicast port
Ví dụ
netdata publish dnssrp unicast 50152
Done
Tài liệu tham khảo về CLI và API
- netdata xuất bản dnssrp unicast (addr,port)
- netdata xuất bản dnssrp Anycast
- otNetDataPublishDnsSrpServiceUnicastMeshLocalEid
tiền tố xuất bản netdata
Xuất bản một mục tiền tố trên lưới. Để 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.
Tham số
netdata publish prefix prefix [padcrosnD] [high|med|low]
OT CLI sử dụng các đối số đã ánh xạ để định cấu hình các giá trị otBorderRouterConfig. Để biết thêm thông tin, hãy tham khảo bài viết Tổng quan về OpenThread CLI.
Ví dụ
netdata publish prefix fd00:1234:5678::/64 paos med
Done
Tài liệu tham khảo về CLI và API
netdata xuất bản thay thế
Thay thế mục nhập tuyến đường bên ngoài đã xuất bản trước đây. Để 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.
Tham số
netdata publish replace oldprefix prefix [sn] [high|med|low]
OT CLI sử dụng các đối số đã ánh xạ để định cấu hình các giá trị otExternalRouteConfig. Để biết thêm thông tin, hãy tham khảo bài viết Tổng quan về OpenThread CLI.
Ví dụ
netdata publish replace ::/0 fd00:1234:5678::/64 s high
Done
Tài liệu tham khảo về CLI và API
tuyến xuất bản netdata
Xuất bản một mục nhập tuyến đường bên ngoài. Để 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.
Tham số
publish route prefix [sn] [high|med|low]
OT CLI sử dụng các đối số đã ánh xạ để định cấu hình các giá trị otExternalRouteConfig. Để biết thêm thông tin, hãy tham khảo bài viết Tổng quan về OpenThread CLI.
Ví dụ
netdata publish route fd00:1234:5678::/64 s high
Done
Tài liệu tham khảo về CLI và API
thanh ghi netdata
Đăng ký các tiền tố, tuyến và dịch vụ đã định cấu hình với Thủ lĩnh.
Quá trình kiểm tra CLI của OT cho OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE
. Nếu OTBR được bật, máy chủ này sẽ đăng ký Dữ liệu mạng cục bộ với Trưởng nhóm. Nếu không, hàm này sẽ gọi hàm CLI otServerRegister
. Để 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.
Tham số
Không có tham số.
Ví dụ
netdata register
Done
Tài liệu tham khảo về CLI và API
kiểm tra dữ liệu chỉ đạo netdata (công cụ phân loại)
Kiểm tra xem dữ liệu lái xe có bao gồm một Người tham gia có một giá trị trình phân biệt nhất định hay không.
Tham số
netdata steeringdata check discerner
discerner
: Người tham gia ở định dạng{number}/{length}
.
Ví dụ
netdata steeringdata check 0xabc/12
Done
netdata steeringdata check 0xdef/12
Error 23: NotFound
Tài liệu tham khảo về CLI và API
kiểm tra dữ liệu chỉ đạo netdata (eui64)
Kiểm tra xem dữ liệu lái xe có bao gồm một yếu tố Joiner hay không.
Tham số
netdata steeringdata check eui64
eui64
: IEEE EUI-64 của Tham gia.
Ví dụ
netdata steeringdata check d45e64fa83f81cf7
Done
Tài liệu tham khảo về CLI và API
netdata chưa xuất bản (tiền tố)
Hủy xuất bản Tiền tố tuyến đường bên ngoài hoặc On-Mesh đã xuất bản trước đây.
Bạn phải bật OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE
.
Để 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.
Tham số
netdata unpublish prefix
Ví dụ
netdata unpublish fd00:1234:5678::/64
Done
Tài liệu tham khảo về CLI và API
netdata huỷ xuất bản dnssrp
Huỷ xuất bản mọi mục nhập Dịch vụ DNS/SRP (Anycast hoặc Unicast) đã thêm trước đó từ Thread Network Data (Dữ liệu mạng Thread).
Bạn phải bật OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE
.
Tham số
Không có tham số.
Ví dụ
netdata unpublish dnssrp
Done
Tài liệu tham khảo về CLI và API
thống kê netstat
Lấy phần đầu của danh sách được liên kết của Cổng UDP.
Tham số
Không có tham số.
Ví dụ
netstat
| Local Address | Peer Address |
+-------------------------------------------------+-------------------------------------------------+
| [0:0:0:0:0:0:0:0]:49153 | [0:0:0:0:0:0:0:0]:0 |
| [0:0:0:0:0:0:0:0]:49152 | [0:0:0:0:0:0:0:0]:0 |
| [0:0:0:0:0:0:0:0]:61631 | [0:0:0:0:0:0:0:0]:0 |
| [0:0:0:0:0:0:0:0]:19788 | [0:0:0:0:0:0:0:0]:0 |
Done
Tài liệu tham khảo về CLI và API
nhận thông tin chẩn đoán mạng
Gửi yêu cầu chẩn đoán mạng để truy xuất Giá trị độ dài loại (TLV) được chỉ định cho(các) địa chỉ được chỉ định.
Tham số
networkdiagnostic get addr type(s)
Đối với addr
, địa chỉ unicast sẽ kích hoạt Diagnostic Get
. Địa chỉ phát đa hướng sẽ kích hoạt Diagnostic Query
. Các giá trị TLV mà bạn có thể chỉ định (phân tách bằng dấu cách nếu bạn chỉ định nhiều TLV):
0
: Bản tóm tắt địa chỉ mở rộng MAC1
: Address16 TLV2
: Chế độ TLV3
: TLV hết thời gian chờ (khoảng thời gian thăm dò tối đa cho các SED)4
: Tóm tắt kết nối5
: TLV Route646
: Tóm tắt dữ liệu về nhà lãnh đạo7
: Tóm tắt dữ liệu mạng8
: TLV danh sách địa chỉ IPv69
: Tóm tắt bộ đếm MAC14
: Tóm tắt mức pin15
: TLV điện áp cung cấp16
: Tóm tắt về bảng con17
: Tóm tắt về trang kênh19
: TLV thời gian chờ tối đa của trẻ23
: EUI64 TLV24
: Phiên bản TLV (số phiên bản cho các giao thức và tính năng)25
: Tóm tắt tên nhà cung cấp26
: Tóm tắt mô hình nhà cung cấp27
: Bản tóm tắt phiên bản phần mềm của nhà cung cấp28
: TLV phiên bản ngăn xếp chuỗi (giá trị nhận dạng phiên bản dưới dạng chuỗi UTF-8 cho cơ sở mã/commit/phiên bản của ngăn xếp luồng)29
: TLV con34
: Bộ đếm MLE35
: Tóm tắt URL ứng dụng của nhà cung cấp
Ví dụ
networkdiagnostic get fdde:ad00:beef:0:0:ff:fe00:fc00 0 1 6 23
DIAG_GET.rsp/ans: 00080e336e1c41494e1c01020c000608640b0f674074c503
Ext Address: 0e336e1c41494e1c
Rloc16: 0x0c00
Leader Data:
PartitionId: 0x640b0f67
Weighting: 64
DataVersion: 116
StableDataVersion: 197
LeaderRouterId: 0x03
EUI64: 18b4300000000004
Done
networkdiagnostic get ff02::1 0 1
DIAG_GET.rsp/ans: 00080e336e1c41494e1c01020c00
Ext Address: '0e336e1c41494e1c'
Rloc16: 0x0c00
Done
DIAG_GET.rsp/ans: 00083efcdb7e3f9eb0f201021800
Ext Address: 3efcdb7e3f9eb0f2
Rloc16: 0x1800
Done
Tài liệu tham khảo về CLI và API
đặt lại tính năng chẩn đoán mạng
Gửi yêu cầu chẩn đoán mạng để đặt lại Giá trị độ dài loại (TLV) được chỉ định trên(các) địa chỉ đã chỉ định. Lệnh này chỉ hỗ trợ các giá trị TLV sau: 9
(Bộ đếm MAC TLV) hoặc 34
(TLV Bộ đếm MLE)
Tham số
networkdiagnostic reset addr type(s)
Ví dụ
networkdiagnostic reset fd00:db8::ff:fe00:0 9
Done
Tài liệu tham khảo về CLI và API
thời gian chờ mạng (lấy,đặt)
Lấy hoặc đặt tham số NETWORK_ID_TIMEOUT
.
Tham số
networkidtimeout [timeout]
Dùng đối số timeout
(không bắt buộc) để đặt giá trị cho tham số NETWORK_ID_TIMEOUT
.
Ví dụ
networkidtimeout 120
Done
networkidtimeout
120
Done
Tài liệu tham khảo về CLI và API
khoá mạng (khoá)
Đặt Thread Network Key (Khoá mạng luồng).
Chỉ thành công khi giao thức Thread bị tắt. Lệnh gọi thành công đến hàm này sẽ làm mất hiệu lực của Tập dữ liệu hoạt động đang hoạt động và đang chờ xử lý trong bộ nhớ bất biến.
Tham số
networkkey key
Ví dụ
networkkey 00112233445566778899aabbccddeeff
Done
Tài liệu tham khảo về CLI và API
khoá mạng
Lấy khoá mạng Thread.
Tham số
Không có tham số.
Ví dụ
networkkey
00112233445566778899aabbccddeeff
Done
Tài liệu tham khảo về CLI và API
tên mạng (tên)
Đặt tên mạng Thread.
Chỉ thành công khi giao thức Thread bị tắt. Lệnh gọi thành công đến hàm này sẽ làm mất hiệu lực của Tập dữ liệu hoạt động đang hoạt động và đang chờ xử lý trong bộ nhớ bất biến.
Tham số
networkname name
Ví dụ
networkname OpenThread
Done
Tài liệu tham khảo về CLI và API
tên mạng
Lấy tên mạng Thread.
Tham số
Không có tham số.
Ví dụ
networkname
OpenThread
Done
Tài liệu tham khảo về CLI và API
thời gian mạng (đặt)
Đặt thông số đồng bộ hoá thời gian.
timesyncperiod
: Khoảng thời gian đồng bộ hoá thời gian, tính bằng giây.xtalthreshold
: Ngưỡng chính xác XTAL để một thiết bị trở thành thiết bị hỗ trợ bộ định tuyến, tính theo PPM.
Tham số
networktime timesyncperiod xtalthreshold
Ví dụ
networktime 100 300
Done
Tài liệu tham khảo về CLI và API
thời gian mạng
Lấy thời gian mạng Thread và tham số đồng bộ hoá thời gian.
Tham số
Không có tham số.
Ví dụ
networktime
Network Time: 21084154us (synchronized)
Time Sync Period: 100s
XTAL Threshold: 300ppm
Done
Tài liệu tham khảo về CLI và API
nexthop (lấy)
Lấy chi phí lộ trình và lộ trình tiếp theo hướng tới một đích đến rlOC16 nhất định.
Có thể sử dụng với aNextHopRloc16
hoặc aPathCost
là giá trị NULL (Rỗng) cho biết phương thức gọi không muốn nhận giá trị.
Tham số
nexthop rloc16
Ví dụ
nexthop 0xc000
0xc000 cost:0
Done
nexthop 0x8001
0x2000 cost:3
Done
Tài liệu tham khảo về CLI và API
nexthop
Bảng đầu ra gồm các mã bộ định tuyến được phân bổ cũng như chi phí đường dẫn và chặng tiếp theo hiện tại của mỗi bộ định tuyến.
Tham số
Không có tham số.
Ví dụ
nexthop
| ID |NxtHop| Cost |
+------+------+------+
| 9 | 9 | 1 |
| 25 | 25 | 0 |
| 30 | 30 | 1 |
| 46 | - | - |
| 50 | 30 | 3 |
| 60 | 30 | 2 |
Done
Tài liệu tham khảo về CLI và API
panid (panid)
Thiết lập mã PAN theo chuẩn IEEE 802.15.4.
Chỉ thành công khi giao thức Thread bị tắt. Lệnh gọi thành công đến hàm này cũng làm mất hiệu lực của Tập dữ liệu hoạt động đang hoạt động và đang chờ xử lý trong bộ nhớ bất biến.
Tham số
panid panid
Ví dụ
panid 0xdead
Done
Tài liệu tham khảo về CLI và API
hoảng loạn
Lấy mã PAN theo IEEE 802.15.4.
Tham số
Không có tham số.
Ví dụ
panid
0xdead
Done
Tài liệu tham khảo về CLI và API
mẹ
Nhận thông tin chẩn đoán cho Bộ định tuyến luồng với tư cách là cha mẹ.
Khi hoạt động như một Bộ định tuyến luồng (Thread Router) khi đang bật lựa chọn lựa chọn Open mời người dùng cho thành phần kết hợp, lệnh này sẽ trả về thông tin đã lưu trong bộ nhớ đệm từ thời điểm trước đó thiết bị đã được đính kèm làm thành phần con Thread. Cần trả lại thông tin được lưu trong bộ nhớ đệm để hỗ trợ Khai thác kiểm thử luồng - Trường hợp kiểm thử 8.2.x yêu cầu địa chỉ MAC mẹ (tức là của Bộ định tuyến tham gia) trước đây ngay cả khi thiết bị đã được thăng cấp lên bộ định tuyến.
Tham số
Không có tham số.
Ví dụ
parent
Ext Addr: be1857c6c21dce55
Rloc: 5c00
Link Quality In: 3
Link Quality Out: 3
Age: 20
Version: 4
Done
Tài liệu tham khảo về CLI và API
tìm kiếm cha mẹ
Bắt đầu quá trình để con tìm kiếm cha mẹ phù hợp hơn trong khi vẫn giữ liên lạc với cha mẹ hiện tại.
Phải được sử dụng khi thiết bị được đính kèm ở dạng trẻ em.
Tham số
Không có tham số.
Ví dụ
parent search
Done
Tài liệu tham khảo về CLI và API
cha mẹ ưu tiên (lấy,đặt)
Lấy hoặc thiết lập giá trị ưu tiên cha mẹ được chỉ định: 1, 0, -1 hoặc -2. -2 có nghĩa là chưa được chỉ định.
Tham số
parentpriority [parentpriority]
Ví dụ
parentpriority
1
Done
parentpriority 1
Done
Tài liệu tham khảo về CLI và API
partitionid
Lấy mã phân vùng mạng Thread.
Tham số
Không có tham số.
Ví dụ
partitionid
4294967295
Done
Tài liệu tham khảo về CLI và API
phân vùng được ưu tiên (get,set)
Phải nhập thông tin vào trường OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
.
Tham số
partitionid preferred partitionid
Ví dụ
partitionid preferred
4294967295
Done
partitionid preferred 0xffffffff
Done
Tài liệu tham khảo về CLI và API
platform
In nền tảng hiện tại
Tham số
Không có tham số.
Ví dụ
platform
NRF52840
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
thời gian thăm dò ý kiến (lấy,đặt)
Nhận hoặc thiết lập khoảng thời gian thăm dò dữ liệu tuỳ chỉnh của thiết bị cuối không hoạt động (mili giây). Chỉ dành cho mục đích kiểm thử cấp chứng chỉ.
Tham số
Không có tham số.
Ví dụ
pollperiod
0
Done
pollperiod 10
Done
Tài liệu tham khảo về CLI và API
ưu tiên định tuyến
Chỉ định mã bộ định tuyến ưu tiên mà trưởng nhóm sẽ cung cấp khi được yêu cầu.
Tham số
preferrouterid routerid
Ví dụ
preferrouterid 16
Done
Tài liệu tham khảo về CLI và API
thêm tiền tố
Thêm tiền tố hợp lệ vào Dữ liệu mạng.
Tham số
prefix add prefix [padcrosnD] [high|med|low]
OT CLI sử dụng các đối số đã ánh xạ để định cấu hình các giá trị otBorderRouterConfig. Để biết thêm thông tin, hãy tham khảo bài viết Tổng quan về OpenThread CLI.
Ví dụ
prefix add 2001:dead:beef:cafe::/64 paros med
Done
prefix add fd00:7d03:7d03:7d03::/64 prosD low
Done
Tài liệu tham khảo về CLI và API
tiền tố Gridlocal
Lấy tiền tố cục bộ của lưới.
Tham số
Không có tham số.
Ví dụ
prefix meshlocal
fdde:ad00:beef:0::/64
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
tiền tố
Lấy danh sách tiền tố trong Dữ liệu mạng cục bộ.
Để biết thêm thông tin về cờ otBorderRouterConfig, hãy tham khảo Tổng quan về OpenThread CLI.
Tham số
Không có tham số.
Ví dụ
prefix
2001:dead:beef:cafe::/64 paros med
- fd00:7d03:7d03:7d03::/64 prosD med
Done
Tài liệu tham khảo về CLI và API
xoá tiền tố
Xoá cấu hình bộ định tuyến biên khỏi dữ liệu mạng cục bộ.
Tham số
Không có tham số.
Ví dụ
prefix remove 2001:dead:beef:cafe::/64
Done
Tài liệu tham khảo về CLI và API
hỗn tạp (bật,tắt)
Bật hoặc tắt chế độ hỗn tạp lớp liên kết.
Tham số
promiscuous enable|disable
Ví dụ
promiscuous enable
Done
promiscuous disable
Done
Tài liệu tham khảo về CLI và API
hỗn tạp
Cho biết chế độ hỗn tạp có được bật tại lớp liên kết hay không.
Tham số
Không có tham số.
Ví dụ
promiscuous
Disabled
Done
Tài liệu tham khảo về CLI và API
pskc (tập hợp)
Đặt pskc ở định dạng thập lục phân.
Tham số
pskc key
Ví dụ
pskc 67c0c203aa0b042bfb5381c47aef4d9e
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
Pskc-p
Tạo pskc từ cụm mật khẩu (được mã hoá UTF-8), cùng với tên mạng hiện tại và ID PAN mở rộng.
Tham số
pskc -p passphrase
Ví dụ
pskc -p 123456
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
đội bóng thành công
Lấy Thread PSKc.
Tham số
Không có tham số.
Ví dụ
pskc
67c0c203aa0b042bfb5381c47aef4d9e
Done
Tài liệu tham khảo về CLI và API
pskcref (nhóm)
Đặt Tham chiếu khoá thành Thread PSKc.
Yêu cầu bật tính năng thời gian xây dựng OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE
.
Sẽ chỉ thành công khi giao thức Thread bị tắt. Khi thành công, thao tác này cũng sẽ vô hiệu hoá Tập dữ liệu hoạt động đang hoạt động và đang chờ xử lý trong bộ nhớ bất biến.
Tham số
pskc keyref
Ví dụ
pskc 0x20017
Done
Tài liệu tham khảo về CLI và API
pskcref
Lấy tham chiếu khoá đến Thread PSKc được lưu trữ.
Yêu cầu bật tính năng thời gian xây dựng OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE
.
Tham số
Không có tham số.
Ví dụ
pskcref
0x80000000
Done
Tài liệu tham khảo về CLI và API
đài (bật,tắt)
Bật hoặc tắt đài.
Tham số
radio enable|disable
Ví dụ
radio enable
Done
radio disable
Done
Tài liệu tham khảo về CLI và API
xóa số liệu thống kê radio
Đặt lại số liệu thống kê radio.
Tất cả thời gian được đặt lại về 0.
Tham số
Không có tham số.
Ví dụ
radio stats clear
Done
Tài liệu tham khảo về CLI và API
số liệu thống kê về đài phát thanh
Lấy số liệu thống kê về đài phát thanh.
Số liệu thống kê về đài phát thanh bao gồm cả thời gian khi đài ở trạng thái TX/RX/Ngủ. Những thời gian này được tính bằng đơn vị micrô giây. Tất cả thời gian đều được tính từ lần đặt lại số liệu thống kê về đài phát thanh gần đây nhất.
Tham số
Không có tham số.
Ví dụ
radio stats
Radio Statistics:
Total Time: 67.756s
Tx Time: 0.022944s (0.03%)
Rx Time: 1.482353s (2.18%)
Sleep Time: 66.251128s (97.77%)
Disabled Time: 0.000080s (0.00%)
Done
Tài liệu tham khảo về CLI và API
phiên bản RCp
Lấy chuỗi phiên bản đài phát.
Tham số
Không có tham số.
Ví dụ
rcp version
OPENTHREAD/20191113-00825-g82053cc9d-dirty; SIMULATION; Jun 4 2020 17:53:16
Done
Tài liệu tham khảo về CLI và API
khu vực (nhóm)
Đặt mã vùng.
Định dạng vùng vô tuyến là biểu diễn ASCII 2 byte của mã ISO 3166 alpha-2.
Việc thay đổi chế độ cài đặt này có thể ảnh hưởng đến giới hạn công suất truyền.
Tham số
Không có tham số.
Ví dụ
region US
Done
Tài liệu tham khảo về CLI và API
region
Lấy mã vùng.
Định dạng vùng vô tuyến là biểu diễn ASCII 2 byte của mã ISO 3166 alpha-2.
Tham số
Không có tham số.
Ví dụ
region
US
Done
Tài liệu tham khảo về CLI và API
số định tuyến phát hành (bộ định tuyến)
Giải phóng mã bộ định tuyến đã được thiết bị phân bổ trong vai trò Thủ lĩnh.
Tham số
releaserouterid [routerid]
Ví dụ
releaserouterid 16
Done
Tài liệu tham khảo về CLI và API
rloc16
Tải rlOC16.
Tham số
Không có tham số.
Ví dụ
rloc16
0xdead
Done
Tài liệu tham khảo về CLI và API
thêm tuyến đường
Đối với các tham số, hãy sử dụng:
- s: Cờ ổn định
- n: cờ NAT64
- prf: Lựa chọn ưu tiên về bộ định tuyến mặc định, [high, med, low].
Thêm một tuyến bên ngoài hợp lệ vào Dữ liệu mạng.
Tham số
route add prefix [sn] [high|med|low]
Ví dụ
route add 2001:dead:beef:cafe::/64 s med
Done
Tài liệu tham khảo về CLI và API
xoá tuyến đường
Xoá cấu hình tuyến bên ngoài khỏi dữ liệu mạng cục bộ.
Tham số
route remove [prefix]
Ví dụ
route remove 2001:dead:beef:cafe::/64
Done
Tài liệu tham khảo về CLI và API
tuyến đường
Lấy danh sách tuyến bên ngoài trong Dữ liệu mạng cục bộ.
Tham số
Không có tham số.
Ví dụ
route
2001:dead:beef:cafe::/64 s med
Done
Tài liệu tham khảo về CLI và API
bộ định tuyến (id)
Hàm này giữ lại thông tin chẩn đoán cho một Bộ định tuyến luồng nhất định.
In thông tin chẩn đoán cho Bộ định tuyến luồng. Mã này có thể là Mã bộ định tuyến hoặc rlOC16.
Tham số
router [id]
Ví dụ
router 50
Alloc: 1
Router ID: 50
Rloc: c800
Next Hop: c800
Link: 1
Ext Addr: e2b3540590b0fd87
Cost: 0
Link Quality In: 3
Link Quality Out: 3
Age: 3
Done
router 0xc800
Alloc: 1
Router ID: 50
Rloc: c800
Next Hop: c800
Link: 1
Ext Addr: e2b3540590b0fd87
Cost: 0
Link Quality In: 3
Link Quality Out: 3
Age: 7
Done
Tài liệu tham khảo về CLI và API
danh sách bộ định tuyến
Liệt kê mã bộ định tuyến được phân bổ.
Tham số
Không có tham số.
Ví dụ
router list
8 24 50
Done
Tài liệu tham khảo về CLI và API
bảng bộ định tuyến
In danh sách bộ định tuyến theo định dạng bảng.
Tham số
Không có tham số.
Ví dụ
router table
| ID | RLOC16 | Next Hop | Path Cost | LQ In | LQ Out | Age | Extended MAC | Link |
+----+--------+----------+-----------+-------+--------+-----+------------------+------+
| 22 | 0x5800 | 63 | 0 | 0 | 0 | 0 | 0aeb8196c9f61658 | 0 |
| 49 | 0xc400 | 63 | 0 | 3 | 3 | 0 | faa1c03908e2dbf2 | 1 |
Done
Tài liệu tham khảo về CLI và API
đánh giá hạ cấp bộ định tuyến (get,set)
Lấy hoặc đặt giá trị ROUTER_DOWN Đại_ cấp cho chúng ta.
Tham số
routerdowngradethreshold [threshold]
Ví dụ
routerdowngradethreshold
23
Done
routerdowngradethreshold 23
Done
Tài liệu tham khảo về CLI và API
đủ điều kiện cho bộ định tuyến (bật,tắt)
Bật hoặc tắt vai trò đối với bộ định tuyến.
Tham số
routereligible [enable|disable]
Ví dụ
routereligible enable
Done
routereligible disable
Done
Tài liệu tham khảo về CLI và API
đủ điều kiện đối với bộ định tuyến
Cho biết vai trò của bộ định tuyến được bật hay tắt.
Tham số
Không có tham số.
Ví dụ
routereligible
Enabled
Done
Tài liệu tham khảo về CLI và API
routerselectionjitter
Lấy hoặc đặt giá trị ROUTER_SELECTION_JITTER.
Tham số
routerselectionjitter [jitter]
Ví dụ
routerselectionjitter
120
Done
routerselectionjitter 120
Done
Tài liệu tham khảo về CLI và API
ngưỡng nâng cấp bộ định tuyến (lấy,đặt)
Lấy hoặc đặt giá trị ROUTER_ NỀN_NƯỚC.
Tham số
routerupgradethreshold [threshold]
Ví dụ
routerupgradethreshold
16
Done
routerupgradethreshold 16
Done
Tài liệu tham khảo về CLI và API
quét năng lượng
Thực hiện quét năng lượng IEEE 802.15.4 và hiển thị thời gian tính bằng mili giây để sử dụng để quét từng kênh. Tất cả các kênh đều hiển thị trừ phi bạn chỉ định một kênh nhất định bằng cách sử dụng tuỳ chọn kênh.
Tham số
scan energy [duration] [channel]
Ví dụ
scan energy 10
| Ch | RSSI |
+----+------+
| 11 | -59 |
| 12 | -62 |
| 13 | -67 |
| 14 | -61 |
| 15 | -87 |
| 16 | -86 |
| 17 | -86 |
| 18 | -52 |
| 19 | -58 |
| 20 | -82 |
| 21 | -76 |
| 22 | -82 |
| 23 | -74 |
| 24 | -81 |
| 25 | -88 |
| 26 | -71 |
Done
scan energy 10 20
| Ch | RSSI |
+----+------+
| 20 | -82 |
Done
Tài liệu tham khảo về CLI và API
quét
Thực hiện quét IEEE 802.15.4 đang hoạt động. Quá trình quét bao gồm tất cả các kênh nếu không có kênh nào được chỉ định; nếu không thì span chỉ bao gồm kênh được chỉ định.
Tham số
scan [channel]
Ví dụ
scan
| PAN | MAC Address | Ch | dBm | LQI |
+------+------------------+----+-----+-----+
| ffff | f1d92a82c8d8fe43 | 11 | -20 | 0 |
Done
Tài liệu tham khảo về CLI và API
thêm dịch vụ
Thêm dịch vụ vào dữ liệu mạng.
- enterpriseNumber: Mã số doanh nghiệp IANA
- serviceData: Dữ liệu dịch vụ nhị phân được mã hoá theo hệ thập lục phân
- serverData: Dữ liệu máy chủ nhị phân được mã hoá theo hệ thập lục phân (trống nếu không được cung cấp)
Tham số
service add enterpriseNumber serviceData [serverData]
Ví dụ
service add 44970 112233 aabbcc
Done
netdata register
Done
Tài liệu tham khảo về CLI và API
xoá dịch vụ
Xoá dịch vụ khỏi dữ liệu mạng.
- enterpriseNumber: Mã số doanh nghiệp IANA
- serviceData: Dữ liệu dịch vụ nhị phân được mã hoá theo hệ thập lục phân
Tham số
service remove enterpriseNumber serviceData
Ví dụ
service remove 44970 112233
Done
netdata register
Done
Tài liệu tham khảo về CLI và API
singleton
Cho biết liệu một nút có phải là bộ định tuyến duy nhất trên mạng hay không. Trả về true
hoặc false
.
Tham số
Không có tham số.
Ví dụ
singleton
true
Done
Tài liệu tham khảo về CLI và API
truy vấn sntp
Gửi truy vấn SNTP để lấy thời gian bắt đầu của hệ thống Unix hiện tại (từ ngày 1 tháng 1 năm 1970).
- Địa chỉ IP mặc định của máy chủ SNTP:
2001:4860:4806:8::
(Máy chủ NTP Google IPv6) - Cổng mặc định của máy chủ SNTP:
123
Tham số
sntp query [SNTP server IP] [SNTP server port]
Ví dụ
sntp query
SNTP response - Unix time: 1540894725 (era: 0)
Done
sntp query 64:ff9b::d8ef:2308
SNTP response - Unix time: 1540898611 (era: 0)
Done
Tài liệu tham khảo về CLI và API
Tự động bắt đầu ứng dụng srp (nhận)
Cho biết trạng thái hiện tại của chế độ tự động bắt đầu (bật hoặc tắt). Để biết thêm thông tin, hãy tham khảo bài viết Thiết lập giao thức đăng ký dịch vụ (SRP) kết nối máy chủ-ứng dụng với OT CLI.
Tham số
Không có tham số.
Ví dụ
srp client autostart
Disabled
Done
Tài liệu tham khảo về CLI và API
tắt tính năng tự động bắt đầu của ứng dụng srp
Tắt chế độ tự bắt đầu.
Việc tắt chế độ tự động bắt đầu sẽ không dừng một ứng dụng đang chạy. Tuy nhiên, ứng dụng SRP sẽ ngừng theo dõi dữ liệu mạng Thread.
Tham số
Không có tham số.
Ví dụ
srp client autostart disable
Done
Tài liệu tham khảo về CLI và API
bật tính năng tự động bắt đầu máy khách srp
Bật chế độ tự động bắt đầu.
Khi tính năng tự động bắt đầu được bật, ứng dụng SRP sẽ giám sát dữ liệu mạng Thread để khám phá các máy chủ SRP, để chọn máy chủ ưu tiên, cũng như để tự động bắt đầu và dừng ứng dụng khi phát hiện thấy một máy chủ SRP.
Ba loại mục nhập dữ liệu mạng cho biết sự có mặt của máy chủ SRP và được ưu tiên theo thứ tự sau:
- Mục nhập Unicast, trong đó địa chỉ máy chủ được đưa vào dữ liệu dịch vụ. Nếu có nhiều lựa chọn, lựa chọn có địa chỉ IPv6 dạng số thấp nhất sẽ được ưu tiên.
- Mục nhập Anycast mà mỗi mục đều có số thứ tự. Ưu tiên số thứ tự lớn nhất theo quy định của Logic số học số sê-ri trong RFC-1982.
- Mục nhập Unicast trong đó thông tin địa chỉ máy chủ được đưa vào cùng với dữ liệu máy chủ. Nếu có nhiều lựa chọn, lựa chọn có địa chỉ IPv6 dạng số thấp nhất sẽ được ưu tiên.
Tham số
Không có tham số.
Ví dụ
srp client autostart enable
Done
Tài liệu tham khảo về CLI và API
Lệnh gọi lại ứng dụng srp (get,enable,disable)
Nhận hoặc bật/tắt các sự kiện gọi lại in từ ứng dụng SRP. Để biết thêm thông tin, hãy tham khảo bài viết Thiết lập giao thức đăng ký dịch vụ (SRP) kết nối máy chủ-ứng dụng với OT CLI.
Tham số
srp client callback [enable|disable]
Ví dụ
srp client callback enable
Done
srp client callback
Enabled
Done
Tài liệu tham khảo về CLI và API
địa chỉ máy chủ máy khách srp (nhận)
Cho biết liệu chế độ địa chỉ tự động có được bật hay không. Nếu bạn chưa bật chế độ địa chỉ tự động, thì danh sách địa chỉ máy chủ máy khách SRP sẽ được trả về. Để biết thêm thông tin, hãy tham khảo bài viết Thiết lập giao thức đăng ký dịch vụ (SRP) kết nối máy chủ-ứng dụng với OT CLI.
Tham số
Không có tham số.
Ví dụ
srp client host address
auto
Done
srp client host address
fd00:0:0:0:0:0:0:1234
fd00:0:0:0:0:0:0:beef
Done
Tài liệu tham khảo về CLI và API
địa chỉ máy chủ máy khách srp (đã đặt)
Bật chế độ địa chỉ máy chủ lưu trữ tự động hoặc đặt danh sách địa chỉ máy chủ lưu trữ một cách rõ ràng. Để biết thêm thông tin, hãy tham khảo bài viết Thiết lập giao thức đăng ký dịch vụ (SRP) kết nối máy chủ-ứng dụng với OT CLI.
Tham số
srp client host address [auto|address...]
- Dùng tham số
auto
để bật chế độ địa chỉ máy chủ tự động. Khi được bật, ứng dụng sẽ tự động sử dụng tất cả các địa chỉ unicastnetif
ưu tiên, ngoại trừ các địa chỉ liên kết cục bộ và lưới cục bộ. Nếu không có địa chỉ hợp lệ, địa chỉ EID cục bộ dạng lưới sẽ được thêm. Ứng dụng SRP tự động đăng ký lại nếu các địa chỉ trên Luồngnetif
được thêm vào hoặc bị xoá hoặc được đánh dấu là không được ưu tiên. - Chỉ định rõ danh sách địa chỉ máy chủ, phân tách từng địa chỉ bằng một dấu cách. Bạn có thể đặt danh sách này khi ứng dụng đang chạy. Thao tác này cũng sẽ tắt chế độ địa chỉ máy chủ tự động.
Ví dụ
srp client host address auto
Done
srp client host address fd00::cafe
Done
Tài liệu tham khảo về CLI và API
máy chủ máy khách srp xoá
Xoá mọi thông tin về máy chủ lưu trữ và mọi dịch vụ.
Tham số
Không có tham số.
Ví dụ
srp client host clear
Done
Tài liệu tham khảo về CLI và API
tên máy chủ của ứng dụng srp (get,set)
Lấy hoặc đặt tên máy chủ lưu trữ của ứng dụng SRP. Để biết thêm thông tin, hãy tham khảo bài viết Thiết lập giao thức đăng ký dịch vụ (SRP) kết nối máy chủ-ứng dụng với OT CLI.
Tham số
srp client host name [name]
Để đặt tên máy chủ lưu trữ ứng dụng khi máy chủ lưu trữ đã bị xoá hoặc chưa được đăng ký với máy chủ, hãy sử dụng tham số name
.
Ví dụ
srp client host name dev4312
Done
srp client host name
dev4312
Done
Tài liệu tham khảo về CLI và API
xoá máy chủ máy khách srp
Xoá thông tin máy chủ ứng dụng SRP và tất cả dịch vụ khỏi máy chủ SRP. Để biết thêm thông tin, hãy tham khảo bài viết Thiết lập giao thức đăng ký dịch vụ (SRP) kết nối máy chủ-ứng dụng với OT CLI.
Tham số
srp client host remove [removekeylease] [sendunregtoserver]
- Tham số
removekeylease
là một giá trị boolean không bắt buộc, cho biết liệu có nên xoá hợp đồng thuê khoá máy chủ lưu trữ hay không (mặc định làfalse
). - Tham số
sendunregtoserver
là giá trị boolean không bắt buộc, cho biết liệu máy chủ lưu trữ ứng dụng có cần gửi một "cập nhật" hay không thông báo đến máy chủ ngay cả khi thông tin máy chủ lưu trữ ứng dụng khách chưa được đăng ký với máy chủ (mặc định làfalse
). Bạn chỉ có thể chỉ định tham số này nếu tham sốremovekeylease
được chỉ định trước trong lệnh.
Ví dụ
srp client host remove 1
Done
Tài liệu tham khảo về CLI và API
máy chủ máy khách srp
Lấy thông tin về máy chủ lưu trữ.
Tham số
Không có tham số.
Ví dụ
srp client host
name:"dev4312", state:Registered, addrs:[fd00:0:0:0:0:0:0:1234, fd00:0:0:0:0:0:0:beef]
Done
Tài liệu tham khảo về CLI và API
trạng thái máy chủ của máy khách srp
Trả về trạng thái của máy chủ ứng dụng SRP. Các trạng thái có thể có:
ToAdd
: Mục sẽ được thêm/đăng ký.Adding
: Mặt hàng đang được thêm/đăng ký.ToRefresh
: Mục cần được làm mới để gia hạn thời gian thuê.Refreshing
: Mục được làm mới.ToRemove
: Mục cần xoá.Removing
: Mục đang bị xoá.Registered
: Mục đã được đăng ký với máy chủ.Removed
: Mục đã bị xoá.
Tham số
Không có tham số.
Ví dụ
srp client host state
Registered
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
keyleaseinterval máy khách srp (lấy,đặt)
Lấy hoặc đặt khoảng thời gian thuê khoá tính bằng giây.
Tham số
srp client keyleaseinterval [interval]
Ví dụ
srp client keyleaseinterval 864000
Done
srp client keyleaseinterval
864000
Done
Tài liệu tham khảo về CLI và API
thời gian thuê máy khách srp (lấy,đặt)
Lấy hoặc đặt khoảng thời gian thuê tính bằng giây.
Tham số
srp client leaseinterval [interval]
Ví dụ
srp client leaseinterval 3600
Done
srp client leaseinterval
3600
Done
Tài liệu tham khảo về CLI và API
địa chỉ máy chủ máy khách srp
Trả về địa chỉ IPv6 của máy chủ.
Tham số
Không có tham số.
Ví dụ
srp client server address
fd00:0:0:0:d88a:618b:384d:e760
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
cổng máy chủ máy khách srp
Trả về số cổng của máy chủ.
Tham số
Không có tham số.
Ví dụ
srp client server port
4724
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
máy chủ srp
Lấy địa chỉ ổ cắm (địa chỉ IPv6 và số cổng) của máy chủ SRP mà ứng dụng SRP đang sử dụng. Nếu ứng dụng không chạy thì địa chỉ không được chỉ định (tất cả đều bằng 0) với số cổng là 0. Để biết thêm thông tin, hãy tham khảo bài viết Thiết lập giao thức đăng ký dịch vụ (SRP) kết nối máy chủ-ứng dụng với OT CLI.
Tham số
Không có tham số.
Ví dụ
srp client server
[fd00:0:0:0:d88a:618b:384d:e760]:4724
Done
Tài liệu tham khảo về CLI và API
thêm dịch vụ khách hàng srp
Thêm một dịch vụ có tên thực thể, tên dịch vụ và số cổng cho sẵn. Để biết thêm thông tin, hãy tham khảo bài viết Thiết lập giao thức đăng ký dịch vụ (SRP) kết nối máy chủ-ứng dụng với OT CLI.
Tham số
srp client service add instancename servicename port [priority] [weight] [txt]
Tham số servicename
có thể tuỳ ý bao gồm danh sách các nhãn loại dịch vụ phụ được phân tách bằng dấu phẩy. Các ví dụ ở đây sử dụng cách đặt tên chung. Tham số priority
và weight
(cả hai đều là giá trị uint16_t
) là không bắt buộc và nếu không được cung cấp, giá trị 0 sẽ được sử dụng. Tham số txt
(không bắt buộc) thiết lập dữ liệu TXT liên kết với dịch vụ. Giá trị txt
phải ở định dạng chuỗi hex và được coi là trình tự byte dữ liệu TXT đã mã hoá.
Ví dụ
srp client service add ins1 _test1._udp 777
Done
srp client service add ins2 _test2._udp,_sub1,_sub2 111 1 1
Done
Tài liệu tham khảo về CLI và API
Khoá dịch vụ ứng dụng srp (get,set)
Lấy hoặc thiết lập chế độ đưa bản ghi khoá dịch vụ vào ứng dụng SRP. Lệnh này chỉ dành cho mục đích kiểm thử và yêu cầu bạn phải bật OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
. Để biết thêm thông tin, hãy tham khảo bài viết Thiết lập giao thức đăng ký dịch vụ (SRP) kết nối máy chủ-ứng dụng với OT CLI.
Tham số
Không có tham số.
Ví dụ
srp client service key enable
Done
srp client service key
Enabled
Done
Tài liệu tham khảo về CLI và API
Xoá tên dịch vụ khách hàng srp
Xoá một dịch vụ, ngay lập tức xoá dịch vụ đó khỏi danh sách dịch vụ ứng dụng mà không cần tương tác với máy chủ SRP.
Tham số
srp client service clear instancename servicename
Ví dụ
srp client service clear ins2 _test2._udp
Done
Tài liệu tham khảo về CLI và API
xoá dịch vụ khách hàng srp
Yêu cầu huỷ đăng ký một dịch vụ với máy chủ SRP.
Tham số
srp client service remove instancename servicename
Ví dụ
srp client service remove ins2 _test2._udp
Done
Tài liệu tham khảo về CLI và API
dịch vụ khách hàng srp
Lấy danh sách dịch vụ đang được khách hàng quản lý.
Tham số
Không có tham số.
Ví dụ
srp client service
instance:"ins2", name:"_test2._udp,_sub1,_sub2", state:Registered, port:111, priority:1, weight:1
instance:"ins1", name:"_test1._udp", state:Registered, port:777, priority:0, weight:0
Done
Tài liệu tham khảo về CLI và API
phần bắt đầu của ứng dụng srp
Bắt đầu thao tác máy khách SRP. Để biết thêm thông tin, hãy tham khảo bài viết Thiết lập giao thức đăng ký dịch vụ (SRP) kết nối máy chủ-ứng dụng với OT CLI.
Tham số
srp client start serveraddr serverport
Ví dụ
srp client start fd00::d88a:618b:384d:e760 4724
Done
Tài liệu tham khảo về CLI và API
trạng thái máy khách srp
Cho biết ứng dụng SRP có đang chạy hay không.
Tham số
Không có tham số.
Ví dụ
srp client state
Enabled
Done
Tài liệu tham khảo về CLI và API
dừng máy khách srp
Dừng hoạt động của ứng dụng SRP.
Ngừng mọi tương tác thêm với máy chủ SRP. Xin lưu ý rằng ứng dụng này không xoá hoặc thông tin máy chủ lưu trữ và/hoặc danh sách dịch vụ. Thao tác này đánh dấu tất cả các dịch vụ sẽ được thêm/xoá lại sau khi khách hàng bắt đầu (lại) bắt đầu.
Tham số
Không có tham số.
Ví dụ
srp client stop
Done
Tài liệu tham khảo về CLI và API
ttl ứng dụng srp (lấy,đặt)
Lấy hoặc đặt giá trị ttl
(thời gian tồn tại) tính bằng giây.
Tham số
srp client ttl [value]
Ví dụ
srp client ttl 3600
Done
srp client ttl
3600
Done
Tài liệu tham khảo về CLI và API
máy chủ srp (bật,tắt)
Bật hoặc tắt máy chủ SRP. Để biết thêm thông tin, hãy tham khảo bài viết Thiết lập giao thức đăng ký dịch vụ (SRP) kết nối máy chủ-ứng dụng với OT CLI.
Tham số
srp server [enable|disable]
Ví dụ
srp server disable
Done
Tài liệu tham khảo về CLI và API
srp server addrmode (get,set)
Lấy hoặc thiết lập chế độ địa chỉ mà máy chủ SRP sử dụng.
Chế độ địa chỉ cho máy chủ SRP biết cách xác định địa chỉ và số cổng của dịch vụ này, sau đó được xuất bản trong dữ liệu mạng Thread.
Tham số
srp server addrmode [anycast|unicast]
Ví dụ
srp server addrmode anycast
Done
srp server addrmode
anycast
Done
Tài liệu tham khảo về CLI và API
máy chủ srp tự động (bật,tắt)
Bật hoặc tắt chế độ tự động bật trên máy chủ SRP.
Khi chế độ này được bật, Trình quản lý định tuyến biên giới sẽ kiểm soát việc bật hoặc tắt máy chủ SRP có và không.
Lệnh này yêu cầu bạn phải bật OPENTHREAD_CONFIG_BORDER_ROUTING_ENABLE
. Để biết thêm thông tin, hãy tham khảo bài viết Thiết lập giao thức đăng ký dịch vụ (SRP) kết nối máy chủ-ứng dụng với OT CLI.
Tham số
srp server auto [enable|disable]
Ví dụ
srp server auto enable
Done
srp server auto
Enabled
Done
Tài liệu tham khảo về CLI và API
miền máy chủ srp (get,set)
Lấy hoặc đặt tên miền của máy chủ SRP.
Tham số
srp server domain [domain-name]
Ví dụ
srp server domain thread.service.arpa.
Done
srp server domain
thread.service.arpa.
Done
Tài liệu tham khảo về CLI và API
máy chủ lưu trữ srp
Trả về thông tin về tất cả máy chủ lưu trữ đã đăng ký. Để biết thêm thông tin, hãy tham khảo bài viết Thiết lập giao thức đăng ký dịch vụ (SRP) kết nối máy chủ-ứng dụng với OT CLI.
Tham số
Không có tham số.
Ví dụ
srp server host
srp-api-test-1.default.service.arpa.
deleted: false
addresses: [fdde:ad00:beef:0:0:ff:fe00:fc10]
srp-api-test-0.default.service.arpa.
deleted: false
addresses: [fdde:ad00:beef:0:0:ff:fe00:fc10]
Done
Tài liệu tham khảo về CLI và API
Cho thuê máy chủ srp (get,set)
Lấy hoặc đặt giá trị thuê máy chủ SRP theo số giây.
Tham số
srp server lease [min-lease max-lease min-key-lease max-key-lease]
Ví dụ
srp server lease 1800 7200 86400 1209600
Done
srp server lease
min lease: 1800
max lease: 7200
min key-lease: 86400
max key-lease: 1209600
Done
Tài liệu tham khảo về CLI và API
trình tự thứ tự của máy chủ srp (lấy,đặt)
Lấy hoặc đặt số thứ tự dùng với chế độ địa chỉ bất kỳ. Số thứ tự có trong "Địa chỉ Anycast dịch vụ DNS/SRP" được xuất bản trong Dữ liệu mạng.
Tham số
srp server seqnum [seqnum]
Ví dụ
srp server seqnum 20
Done
srp server seqnum
20
Done
Tài liệu tham khảo về CLI và API
dịch vụ máy chủ srp
Trả về thông tin về các dịch vụ đã đăng ký.
Bản ghi TXT
hiển thị dưới dạng một mảng các mục nhập. Nếu mục chứa khoá, khoá đó sẽ được in ở định dạng ASCII. Phần giá trị được in bằng byte thập lục phân. Để biết thêm thông tin, hãy tham khảo bài viết Thiết lập giao thức đăng ký dịch vụ (SRP) kết nối máy chủ-ứng dụng với OT CLI.
Tham số
Không có tham số.
Ví dụ
srp server service
srp-api-test-1._ipps._tcp.default.service.arpa.
deleted: false
subtypes: (null)
port: 49152
priority: 0
weight: 0
ttl: 7200
lease: 7200
key-lease: 1209600
TXT: [616263, xyz=585960]
host: srp-api-test-1.default.service.arpa.
addresses: [fdde:ad00:beef:0:0:ff:fe00:fc10]
srp-api-test-0._ipps._tcp.default.service.arpa.
deleted: false
subtypes: _sub1,_sub2
port: 49152
priority: 0
weight: 0
ttl: 3600
lease: 3600
key-lease: 1209600
TXT: [616263, xyz=585960]
host: srp-api-test-0.default.service.arpa.
addresses: [fdde:ad00:beef:0:0:ff:fe00:fc10]
Done
Tài liệu tham khảo về CLI và API
- otSrpServerServiceGetInstanceName
- otSrpServerServiceGetServiceName
- otSrpServerServiceGetSubTypeServiceNameAt
trạng thái máy chủ srp
Trả về một trong các trạng thái sau đây của máy chủ SRP:
disabled
: Máy chủ SRP chưa được bật.stopped
: Máy chủ SRP đã được bật nhưng không hoạt động do các máy chủ SRP hiện có đang hoạt động trong mạng Thread. Máy chủ SRP có thể sẽ hoạt động khi các máy chủ SRP hiện có không còn hoạt động trong mạng Thread.running
: Máy chủ SRP đang hoạt động và có thể xử lý các yêu cầu đăng ký dịch vụ.
Để biết thêm thông tin, hãy tham khảo bài viết Thiết lập giao thức đăng ký dịch vụ (SRP) kết nối máy chủ-ứng dụng với OT CLI.
Tham số
Không có tham số.
Ví dụ
srp server state
running
Done
Tài liệu tham khảo về CLI và API
tiểu bang
Trả về vai trò hiện tại của thiết bị Thread hoặc thay đổi vai trò theo chỉ định bằng một trong các tuỳ chọn. Các giá trị có thể được trả về khi hỏi về vai trò trên thiết bị:
child
: Thiết bị này đang hoạt động như một thành phần con Thread.router
: Thiết bị hiện đang hoạt động như bộ định tuyến Thread.leader
: Thiết bị này đang hoạt động với vai trò là trưởng nhóm luồng.detached
: Thiết bị hiện không tham gia vào phân vùng/mạng Thread.disabled
: Ngăn xếp Thread hiện đang tắt.
Việc sử dụng một trong các tuỳ chọn cho phép bạn thay đổi vai trò hiện tại của thiết bị, đồng thời loại trừ việc thay đổi sang hoặc từ trạng thái disabled
.
Tham số
state [child|router|leader|detached]
Ví dụ
state
child
Done
state leader
Done
Tài liệu tham khảo về CLI và API
- otThreadGetDeviceRole
- otThreadBecomeChild
- otThreadBecomeRouter
- otThreadBecomeLeader
- otThreadBecomeDetached
huỷ tcp
Kết thúc đột ngột kết nối TCP được liên kết với điểm cuối TCP mẫu, chuyển điểm cuối của TCP sang trạng thái đóng.
Tham số
Không có tham số.
Ví dụ
tcp abort
TCP: Connection reset
Done
Tài liệu tham khảo về CLI và API
kết quả điểm chuẩn tcp
Hiện kết quả mới nhất của phép kiểm thử điểm chuẩn TCP. Các giá trị trạng thái có thể có:
- Đang diễn ra
- Ðã hoàn tất
- Chưa được thử nghiệm
Lệnh này chủ yếu dùng để tạo các tập lệnh tự động hoá việc kiểm tra điểm chuẩn TCP.
Tham số
Không có tham số.
Ví dụ
tcp benchmark result
TCP Benchmark Status: Ongoing
Done
tcp benchmark result
TCP Benchmark Status: Completed
TCP Benchmark Complete: Transferred 73728 bytes in 7056 milliseconds
TCP Goodput: 83.592 kb/s
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
chạy phép đo điểm chuẩn tcp
Chuyển số byte được chỉ định bằng kết nối TCP hiện được liên kết với điểm cuối TCP mẫu do CLI tcp
cung cấp.
Tham số
tcp benchmark run [size]
Dùng tham số size
để chỉ định số byte cần gửi cho điểm chuẩn. Nếu bạn không sử dụng tham số size
, hệ thống sẽ sử dụng giá trị mặc định (OPENTHREAD_CONFIG_CLI_TCP_DEFAULT_BENCHMARK_SIZE
).
Ví dụ
tcp benchmark run
Done
TCP Benchmark Complete: Transferred 73728 bytes in 7233 milliseconds
TCP Goodput: 81.546 kb/s
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
liên kết tcp
Liên kết một địa chỉ IPv6 và một cổng với điểm cuối TCP mẫu do CLI tcp
cung cấp. Việc liên kết điểm cuối TCP với địa chỉ IPv6 và cổng được gọi là "đặt tên cho điểm cuối TCP". Thao tác này sẽ liên kết điểm cuối dùng để giao tiếp. Để biết thêm thông tin, hãy tham khảo bài viết Kiểm thử chức năng TCP bằng OT CLI.
Tham số
tcp bind ip port
ip
: địa chỉ IPv6 cần liên kết. Nếu bạn muốn ngăn xếp TCP/IPv6 gán địa chỉ IPv6 liên kết, hãy sử dụng địa chỉ IPv6 chưa chỉ định:::
.port
: Số cổng TCP để liên kết.
Ví dụ
tcp bind :: 30000
Done
Tài liệu tham khảo về CLI và API
kết nối tcp
Thiết lập kết nối với ứng dụng ngang hàng đã chỉ định.
Nếu thiết lập kết nối thành công, kết nối TCP thu được sẽ được liên kết với điểm cuối TCP mẫu. Để biết thêm thông tin, hãy tham khảo bài viết Kiểm thử chức năng TCP bằng OT CLI.
Tham số
tcp connect ip port [fastopen]
ip
: Địa chỉ IP của ứng dụng ngang hàng Địa chỉ này có thể là địa chỉ IPv4, được tổng hợp thành địa chỉ IPv6 bằng cách sử dụng tiền tố NAT64 ưu tiên từ dữ liệu mạng. Lệnh này trả vềInvalidState
khi không có tiền tố NAT64 ưu tiên.port
: Số cổng TCP của ứng dụng ngang hàng.fastopen
: Tham số này là không bắt buộc. Nếu bạn đặt chính sách này thànhfast
, thì TCP Fast Open sẽ bật cho kết nối này. Ngược lại, nếu tham số này được đặt thànhslow
hoặc không được sử dụng, thì TCP Fast Open sẽ bị tắt.
Ví dụ
tcp connect fe80:0:0:0:a8df:580a:860:ffa4 30000
Done
TCP: Connection established
tcp connect 172.17.0.1 1234
Connecting to synthesized IPv6 address: fdde:ad00:beef:2:0:0:ac11:1
Done
Tài liệu tham khảo về CLI và API
deinit tcp
Huỷ khởi động điểm cuối TCP này.
Điều này có nghĩa là OpenThread không còn theo dõi điểm cuối TCP này và phân bổ tất cả tài nguyên nó đã phân bổ nội bộ cho điểm cuối TCP này. Ứng dụng có thể sử dụng lại bộ nhớ sao lưu điểm cuối TCP khi thấy phù hợp.
Nếu tương ứng với một kết nối TCP đang hoạt động, thì kết nối sẽ bị chấm dứt một cách bất thường (như trong otTcpAbort()). Mọi tài nguyên mà ứng dụng đã cung cấp cho điểm cuối TCP này (vùng đệm liên kết cho vùng đệm gửi, bộ nhớ cho vùng đệm nhận, chính cấu trúc aEndpoint
, v.v.) đều được trả về ngay lập tức cho ứng dụng.
Tham số
Không có tham số.
Ví dụ
tcp deinit
Done
Tài liệu tham khảo về CLI và API
khởi tạo tcp
Khởi chạy trình nghe TCP mẫu và điểm cuối TCP mẫu do CLI tcp
cung cấp.
Tham số
tcp init [mode] [size]
mode
có thể có ba giá trị:tls
: Chỉ định rằng kết nối TCP giữa 2 nút cũng phải sử dụng giao thức TLS ở trên TCP. Khi hai nút giao tiếp qua TCP, cả hai nút phải sử dụng TLS hoặc không nút nào được dùng TLS vì một điểm cuối không phải TLS không thể giao tiếp với một điểm cuối TLS.linked
hoặccircular
: Một trong hai lựa chọn này có nghĩa là không nên sử dụng TLS và loại lưu vào bộ đệm được chỉ định sẽ được dùng để lưu vào bộ đệm TCP. Hành vi củalinked
vàcircular
là giống hệt nhau. Kiểm tra mã về sự khác biệt giữa hai kiểu lưu vào bộ đệm này. Không bắt buộc phải có hai điểm cuối của kết nối TCP để sử dụng cùng một kiểu lưu vào bộ đệm.
- Tham số
size
thiết lập kích thước của vùng đệm nhận để liên kết với điểm cuối TCP mẫu. Nếu bạn không chỉ định, kích thước tối đa sẽ được sử dụng. Kích thước tối đa được đặt bằngOPENTHREAD_CONFIG_CLI_TCP_RECEIVE_BUFFER_SIZE
.
Ví dụ
tcp init tls
Done
Tài liệu tham khảo về CLI và API
tcp nghe
Sử dụng trình nghe TCP mẫu để theo dõi các kết nối đến trên cổng và địa chỉ IPv6 được chỉ định. Để biết thêm thông tin, hãy tham khảo bài viết Kiểm thử chức năng TCP bằng OT CLI.
Tham số
tcp listen ip port
Các tham số sau đây là bắt buộc:
ip
: Địa chỉ IPv6 hoặc địa chỉ IPv6 không xác định (::
) của trình nghe TCP mẫu do CLItcp
cung cấp.port
: cổng TCP của trình nghe TCP mẫu. Nếu không có kết nối TCP nào được liên kết với điểm cuối TCP mẫu, thì mọi kết nối đến khớp với địa chỉ và cổng IPv6 đã chỉ định đều được chấp nhận và được liên kết với điểm cuối của TCP mẫu.
Ví dụ
tcp listen :: 30000
Done
Tài liệu tham khảo về CLI và API
gửi tcp
Gửi dữ liệu qua kết nối TCP liên kết với điểm cuối TCP mẫu được cung cấp cùng với CLI tcp
. Để biết thêm thông tin, hãy tham khảo bài viết Kiểm thử chức năng TCP bằng OT CLI.
Tham số
tcp send message
Tham số message
chứa thông báo mà bạn muốn gửi đến điểm cuối TCP từ xa.
Ví dụ
tcp send hello
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
Gửi tin nhắn tcp
Gửi lời nhắc "kết thúc sự kiện phát trực tiếp" tín hiệu qua kết nối TCP liên kết với điểm cuối TCP mẫu do CLI tcp
cung cấp. Thao tác này sẽ cảnh báo ứng dụng ngang hàng rằng ứng dụng đó sẽ không nhận được thêm dữ liệu nào qua kết nối TCP này.
Tham số
Không có tham số.
Ví dụ
tcp sendend
Done
Tài liệu tham khảo về CLI và API
ngừng nghe tcp
Hướng dẫn trình nghe TCP mẫu dừng theo dõi các kết nối TCP đến.
Tham số
Không có tham số.
Ví dụ
tcp stoplistening
Done
Tài liệu tham khảo về CLI và API
thử nghiệm tmforiginfilter
Bật hoặc tắt bộ lọc để xoá thông báo TMF UDP từ nguồn không đáng tin cậy.
Theo mặc định, bộ lọc loại bỏ thông báo TMF UDP từ nguồn không đáng tin cậy sẽ được bật. Khi bạn tắt chính sách này, thông báo UDP được gửi tới cổng TMF bắt nguồn từ nguồn không đáng tin cậy (chẳng hạn như máy chủ, CLI hoặc nút IPv6 bên ngoài) sẽ được cho phép.
Tham số
test tmforiginfilter [enable|disable]
Ví dụ
test tmforiginfilter
Enabled
test tmforiginfilter enable
Done
test tmforiginfilter disable
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
đầu chuỗi
Bắt đầu thao tác đối với giao thức Thread.
Tham số
Không có tham số.
Ví dụ
thread start
Done
Tài liệu tham khảo về CLI và API
dừng chuỗi
Dừng hoạt động của giao thức Thread.
Tham số
Không có tham số.
Ví dụ
thread stop
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
phiên bản chuỗi
Lấy phiên bản giao thức Thread.
Hằng số OT_THREADVERSION*
xác định giá trị phiên bản số.
Tham số
Không có tham số.
Ví dụ
thread version
2
Done
Tài liệu tham khảo về CLI và API
tối đa trong hàng đợi thời gian
Lấy thời gian tối đa trong hàng đợi cho các thư trong hàng đợi TX.
Cần có OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE
.
Thời gian trong hàng đợi chỉ được theo dõi cho các lần truyền trực tiếp và được đo bằng khoảng thời gian từ khi một tin nhắn được thêm vào hàng đợi truyền cho đến khi tin nhắn đó được truyền đến lớp MAC để truyền hoặc thả.
Bạn có thể đặt lại số liệu thống kê đã thu thập bằng cách gọi
otThreadResetTimeInQueueStat()
.
Tham số
Không có tham số.
Ví dụ
timeinqueue max
281
Done
Tài liệu tham khảo về CLI và API
đặt lại danh sách chờ thời gian
Đặt lại thống kê thời gian trong hàng đợi TX.
Cần có OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE
.
Tham số
Không có tham số.
Ví dụ
timeinqueue reset
Done
Tài liệu tham khảo về CLI và API
timeinqueue
Lấy biểu đồ thời gian trong hàng đợi cho các thư trong hàng đợi TX.
Cần có OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE
.
Biểu đồ thời gian trong hàng đợi của các tin nhắn trong hàng đợi truyền được thu thập. Thời gian trong hàng đợi chỉ được theo dõi cho các lần truyền trực tiếp và được đo bằng khoảng thời gian từ khi một tin nhắn được thêm vào hàng đợi truyền cho đến khi tin nhắn đó được truyền đến lớp MAC để truyền hoặc thả.
Biểu đồ được trả về dưới dạng một mảng các giá trị uint32_t
với các mục nhập aNumBins
. Mục nhập đầu tiên trong mảng (tại chỉ mục 0) biểu thị số lượng thông báo có thời gian trong hàng đợi nhỏ hơn aBinInterval
. Mục nhập thứ hai biểu thị số lượng thư có thời gian trong hàng đợi lớn hơn hoặc bằng aBinInterval
, nhưng nhỏ hơn 2 * aBinInterval
. Và tương tự như vậy. Mục nhập cuối cùng biểu thị số lượng thư có thời gian trong hàng đợi lớn hơn hoặc bằng (aNumBins - 1) * aBinInterval
.
Bạn có thể đặt lại số liệu thống kê đã thu thập bằng cách gọi
otThreadResetTimeInQueueStat()
. Thông tin biểu đồ được thu thập kể từ khi phiên bản OpenThread được khởi chạy hoặc kể từ lần đặt lại số liệu thống kê gần đây nhất bằng cách gọi
otThreadResetTimeInQueueStat()
.
Con trỏ aNumBins
và aBinInterval
KHÔNG ĐƯỢC là giá trị NULL.
Tham số
Không có tham số.
Ví dụ
timeinqueue
| Min | Max |Msg Count|
+------+------+---------+
| 0 | 9 | 1537 |
| 10 | 19 | 156 |
| 20 | 29 | 57 |
| 30 | 39 | 108 |
| 40 | 49 | 60 |
| 50 | 59 | 76 |
| 60 | 69 | 88 |
| 70 | 79 | 51 |
| 80 | 89 | 86 |
| 90 | 99 | 45 |
| 100 | 109 | 43 |
| 110 | 119 | 44 |
| 120 | 129 | 38 |
| 130 | 139 | 44 |
| 140 | 149 | 35 |
| 150 | 159 | 41 |
| 160 | 169 | 34 |
| 170 | 179 | 13 |
| 180 | 189 | 24 |
| 190 | 199 | 3 |
| 200 | 209 | 0 |
| 210 | 219 | 0 |
| 220 | 229 | 2 |
| 230 | 239 | 0 |
| 240 | 249 | 0 |
| 250 | 259 | 0 |
| 260 | 269 | 0 |
| 270 | 279 | 0 |
| 280 | 289 | 0 |
| 290 | 299 | 1 |
| 300 | 309 | 0 |
| 310 | 319 | 0 |
| 320 | 329 | 0 |
| 330 | 339 | 0 |
| 340 | 349 | 0 |
| 350 | 359 | 0 |
| 360 | 369 | 0 |
| 370 | 379 | 0 |
| 380 | 389 | 0 |
| 390 | 399 | 0 |
| 400 | 409 | 0 |
| 410 | 419 | 0 |
| 420 | 429 | 0 |
| 430 | 439 | 0 |
| 440 | 449 | 0 |
| 450 | 459 | 0 |
| 460 | 469 | 0 |
| 470 | 479 | 0 |
| 480 | 489 | 0 |
| 490 | inf | 0 |
Done
Tài liệu tham khảo về CLI và API
trel (bật,vô hiệu hoá)
Bật hoặc tắt hoạt động radio TREL.
Tham số
trel enable|disable
Ví dụ
trel enable
Done
trel disable
Done
Tài liệu tham khảo về CLI và API
đã đặt lại bộ đếm nhịp
Đặt lại bộ đếm TREL.
Tham số
Không có tham số.
Ví dụ
trel counters reset
Done
Tài liệu tham khảo về CLI và API
bộ đếm trel
Lấy bộ đếm TREL.
Tham số
Không có tham số.
Ví dụ
trel counters
Inbound: Packets 32 Bytes 4000
Outbound: Packets 4 Bytes 320 Failures 1
Done
Tài liệu tham khảo về CLI và API
bộ lọc dựa trên giá trị (bật,tắt)
Bật hoặc tắt chế độ bộ lọc TREL.
Tham số
trel filter enable|disable
Ví dụ
trel filter enable
Done
trel filter disable
Done
Tài liệu tham khảo về CLI và API
bộ lọc dữ liệu tổng hợp
Cho biết liệu chế độ bộ lọc TREL có được bật hay không.
Khi chế độ bộ lọc được bật, tất cả lưu lượng truy cập Rx và Tx được gửi qua giao diện TREL sẽ tự động bị loại bỏ.
Tham số
Không có tham số.
Ví dụ
trel filter
Disabled
Done
Tài liệu tham khảo về CLI và API
ứng dụng ngang hàng
Lấy bảng ngang hàng TREL ở định dạng bảng hoặc danh sách.
Tham số
trel peers [list]
Ví dụ
trel peers
| No | Ext MAC Address | Ext PAN Id | IPv6 Socket Address |
+-----+------------------+------------------+--------------------------------------------------+
| 1 | 5e5785ba3a63adb9 | f0d9c001f00d2e43 | [fe80:0:0:0:cc79:2a29:d311:1aea]:9202 |
| 2 | ce792a29d3111aea | dead00beef00cafe | [fe80:0:0:0:5c57:85ba:3a63:adb9]:9203 |
Done
trel peers list
001 ExtAddr:5e5785ba3a63adb9 ExtPanId:f0d9c001f00d2e43 SockAddr:[fe80:0:0:0:cc79:2a29:d311:1aea]:9202
002 ExtAddr:ce792a29d3111aea ExtPanId:dead00beef00cafe SockAddr:[fe80:0:0:0:5c57:85ba:3a63:adb9]:9203
Done
Tài liệu tham khảo về CLI và API
vòng quay
Cho biết liệu hoạt động TREL có được bật hay không.
Tham số
Không có tham số.
Ví dụ
trel
Enabled
Done
Tài liệu tham khảo về CLI và API
tvcheck (bật,tắt)
Bật hoặc tắt tính năng kiểm tra phiên bản Luồng khi nâng cấp lên bộ định tuyến hoặc trưởng nhóm. Chế độ kiểm tra này sẽ bật theo mặc định.
Tham số
Không có tham số.
Ví dụ
tvcheck enable
Done
tvcheck disable
Done
Tài liệu tham khảo về CLI và API
txpower (lấy,đặt)
Lấy (hoặc tập hợp bằng cách sử dụng đối số txpower
không bắt buộc) công suất truyền tải tính bằng dBm.
Tham số
txpower [txpower]
Ví dụ
txpower -10
Done
txpower
-10 dBm
Done
Tài liệu tham khảo về CLI và API
liên kết udp
Chỉ định một địa chỉ IPv6 và một cổng cho một ổ cắm mở, kết nối ổ cắm đó để giao tiếp. Việc chỉ định địa chỉ IPv6 và cổng được gọi là đặt tên cho ổ cắm. Để biết thêm thông tin, hãy tham khảo bài viết Kiểm thử chức năng UDP có giao thức OT CLI.
Tham số
udp bind [netif] ip port
netif
: Giao diện mạng liên kết, được xác định như sau:- Không có giá trị (bỏ qua tham số này khỏi lệnh): Giao diện mạng luồng được sử dụng.
-u
: Giao diện mạng chưa được chỉ định, nghĩa là ngăn xếp UDP/IPv6 xác định giao diện mạng nào sẽ liên kết với ổ cắm.-b
: Đang sử dụng giao diện mạng trục chính.
ip
: Địa chỉ IPv6 Unicast để liên kết. Nếu muốn ngăn xếp UDP/IPv6 chỉ định địa chỉ IPv6 liên kết hoặc nếu muốn liên kết với địa chỉ IPv6 đa hướng, thì bạn có thể dùng giá trị sau để dùng địa chỉ IPv6 không xác định:::
. Mỗi ví dụ sử dụng địa chỉ IPv6 không xác định.port
: Số cổng UDP để liên kết. Mỗi ví dụ đều sử dụng số cổng 1234.
Ví dụ
udp bind :: 1234
Done
udp bind -u :: 1234
Done
udp bind -b :: 1234
Done
Tài liệu tham khảo về CLI và API
udp đóng
Đóng cổng UDP/IPv6.
Tham số
Không có tham số.
Ví dụ
udp close
Done
Tài liệu tham khảo về CLI và API
kết nối udp
Kết nối cổng UDP/IPv6.
Tham số
udp connect ip port
Các tham số sau đây là bắt buộc:
ip
: Địa chỉ IP của ứng dụng ngang hàng.port
: Số cổng UDP của ứng dụng ngang hàng. Địa chỉ này có thể là địa chỉ IPv4, được tổng hợp thành địa chỉ IPv6 bằng cách sử dụng tiền tố NAT64 được ưa thích từ dữ liệu mạng. Lệnh này trả vềInvalidState
khi không có tiền tố NAT64 ưu tiên.
Ví dụ
udp connect fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234
Done
udp connect 172.17.0.1 1234
Connecting to synthesized IPv6 address: fdde:ad00:beef:2:0:0:ac11:1
Done
Tài liệu tham khảo về CLI và API
udp linksecurity (bật,tắt)
Bật hoặc tắt tính năng bảo mật đường liên kết.
Tham số
Không có tham số.
Ví dụ
udp linksecurity enable
Done
udp linksecurity disable
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
bảo mật liên kết udp
Cho biết tính năng bảo mật đường liên kết được bật hay tắt.
Tham số
Không có tham số.
Ví dụ
udp linksecurity
Enabled
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
udp đang mở
Mở cổng UDP/IPv6.
Tham số
Không có tham số.
Ví dụ
udp open
Done
Tài liệu tham khảo về CLI và API
gửi udp
Gửi thông báo UDP bằng ổ cắm. Để biết thêm thông tin, hãy tham khảo bài viết Kiểm thử chức năng UDP có giao thức OT CLI.
Tham số
udp send [ip port] [type] value
ip
và port
không bắt buộc phải là một cặp, nhưng nếu chỉ định một cặp thì bạn phải chỉ định cái còn lại. Nếu bạn không chỉ định ip
và port
, thì địa chỉ ngang hàng của ổ cắm sẽ được dùng từ udp connect
.
ip
: Địa chỉ điểm đến. Địa chỉ này có thể là địa chỉ IPv4 hoặc IPv6, Một địa chỉ IPv4 được tổng hợp thành địa chỉ IPv6 với tiền tố NAT64 được ưu tiên từ dữ liệu mạng. (Nếu không có tiền tố NAT64 ưu tiên, thì lệnh sẽ trả vềInvalidState
).port
: Cổng đích UDP.type
/value
kiểu kết hợp:-t
: Tải trọng trong tham sốvalue
được xử lý dưới dạng văn bản. Nếu bạn không nhập giá trịtype
, thì tải trọng trong thông sốvalue
cũng được xử lý dưới dạng văn bản.-s
: Tải trọng được tạo tự động có độ dài được chỉ định trong tham sốvalue
.-x
: Dữ liệu nhị phân ở dạng biểu diễn hệ thập lục phân được cung cấp trong tham sốvalue
.
Ví dụ
udp send hello
Done
udp send -t hello
Done
udp send -x 68656c6c6f
Done
udp send -s 800
Done
udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 hello
Done
udp send 172.17.0.1 1234 hello
Sending to synthesized IPv6 address: fdde:ad00:beef:2:0:0:ac11:1
Done
udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 -t hello
Done
udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 -x 68656c6c6f
Done
udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 -s 800
Done
Tài liệu tham khảo về CLI và API
tải không an toàn
Liệt kê tất cả các cổng trong danh sách cổng không an toàn được phép.
Tham số
Không có tham số.
Ví dụ
unsecure get
1234
Done
Tài liệu tham khảo về CLI và API
thêm không bảo mật
Thêm một cổng vào danh sách cổng không an toàn được cho phép.
Tham số
unsecureport add port
Ví dụ
unsecureport add 1234
Done
Tài liệu tham khảo về CLI và API
xóa không bảo mật
Xoá một cổng đã chỉ định hoặc tất cả các cổng khỏi danh sách cổng không an toàn được phép.
Tham số
unsecureport remove port|all
Ví dụ
unsecureport remove 1234
Done
unsecureport remove all
Done
Tài liệu tham khảo về CLI và API
thời gian hoạt động (mili giây)
Trả về thời gian hoạt động của thực thể hiện tại (tính bằng mili giây).
Bạn cần bật OPENTHREAD_CONFIG_UPTIME_ENABLE
.
Thời gian hoạt động được cung cấp dưới dạng số mili giây kể từ khi phiên bản OpenThread được khởi tạo.
Tham số
Không có tham số.
Ví dụ
uptime ms
426238
Done
Tài liệu tham khảo về CLI và API
thời gian hoạt động
Trả về thời gian hoạt động của thực thể hiện tại dưới dạng chuỗi mà con người có thể đọc được.
Bạn cần bật OPENTHREAD_CONFIG_UPTIME_ENABLE
.
Chuỗi này theo định dạng "
Nếu chuỗi thu được không vừa với aBuffer
(trong phạm vi ký tự aSize
), thì chuỗi đó sẽ bị cắt bớt nhưng chuỗi được xuất ra sẽ luôn kết thúc bằng kết thúc rỗng.
Tham số
Không có tham số.
Ví dụ
uptime
12:46:35.469
Done
Tài liệu tham khảo về CLI và API
appurl của nhà cung cấp (đặt)
Đặt chuỗi URL ứng dụng của nhà cung cấp.
Cần có OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE
.
aVendorAppUrl
phải là UTF8 với độ dài tối đa là 64 ký tự (MAX_VENDOR_APPL_URL_TLV_LENGTH
). Độ dài tối đa không bao gồm ký tự \0
rỗng.
Tham số
vendor appurl url
Ví dụ
vendor appurl http://www.example.com
Done
Tài liệu tham khảo về CLI và API
url ứng dụng của nhà cung cấp
Lấy chuỗi URL ứng dụng của nhà cung cấp.
Tham số
Không có tham số.
Ví dụ
vendor appurl
http://www.example.com
Done
Tài liệu tham khảo về CLI và API
mô hình nhà cung cấp (nhóm)
Đặt chuỗi mô hình nhà cung cấp.
Cần có OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE
.
aVendorModel
phải là UTF8 với độ dài tối đa là 32 ký tự (MAX_VENDOR_MODEL_TLV_LENGTH
). Độ dài tối đa không bao gồm ký tự \0
rỗng.
Tham số
vendor model name
Ví dụ
vendor model Hub\ Max
Done
Tài liệu tham khảo về CLI và API
mô hình của nhà cung cấp
Lấy chuỗi mô hình nhà cung cấp.
Tham số
Không có tham số.
Ví dụ
vendor model
Hub Max
Done
Tài liệu tham khảo về CLI và API
tên nhà cung cấp (nhóm)
Đặt chuỗi tên nhà cung cấp.
Cần có OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE
.
aVendorName
phải là UTF8 với độ dài tối đa là 32 ký tự (MAX_VENDOR_NAME_TLV_LENGTH
). Độ dài tối đa không bao gồm ký tự \0
rỗng.
Tham số
vendor name name
Ví dụ
vendor name nest
Done
Tài liệu tham khảo về CLI và API
tên nhà cung cấp
Lấy chuỗi tên nhà cung cấp.
Tham số
Không có tham số.
Ví dụ
vendor name
nest
Done
Tài liệu tham khảo về CLI và API
xoay vòng của nhà cung cấp (đã đặt)
Đặt chuỗi phiên bản phần mềm của nhà cung cấp.
Cần có OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE
.
aVendorSwVersion
phải là UTF8 với độ dài tối đa là 16 ký tự(MAX_VENDOR_SW_VERSION_TLV_LENGTH
). Độ dài tối đa không bao gồm ký tự \0
rỗng.
Tham số
vendor swversion version
Ví dụ
vendor swversion Marble3.5.1
Done
Tài liệu tham khảo về CLI và API
xoay của nhà cung cấp
Lấy chuỗi phiên bản phần mềm của nhà cung cấp.
Tham số
Không có tham số.
Ví dụ
vendor swversion
Marble3.5.1
Done
Tài liệu tham khảo về CLI và API
tính toán của verhoeff
Tính giá trị tổng kiểm Verhoeff cho một chuỗi thập phân cho trước.
Cần có OPENTHREAD_CONFIG_VERHOEFF_CHECKSUM_ENABLE
.
Tham số
verhoeff calculate decimalstring
Ví dụ
verhoeff calculate 30731842
1
Done
Tài liệu tham khảo về CLI và API
xác thực verhoeff
Kiểm tra giá trị tổng kiểm Verhoeff cho một chuỗi số thập phân cho trước.
Cần có OPENTHREAD_CONFIG_VERHOEFF_CHECKSUM_ENABLE
.
Tham số
verhoeff validate decimalstring
Ví dụ
verhoeff validate 307318421
Done
Tài liệu tham khảo về CLI và API
API phiên bản
In số phiên bản API.
Tham số
Không có tham số.
Ví dụ
version api
28
Done
Tài liệu tham khảo về CLI và API
- Không có API nào được liên kết
version
Lấy chuỗi phiên bản OpenThread.
Tham số
Không có tham số.
Ví dụ
version
OPENTHREAD/gf4f2f04; Jul 1 2016 17:00:09
Done