The OpenThread UDP APIs may be invoked via the OpenThread CLI.
Form a network with at least two devices.
On node 1, open and bind the example UDP socket.
> udp open > udp bind :: 1234
The ::
specifies the IPv6 Unspecified Address.
On node 2, open the example UDP socket and send a simple message.
> udp open > udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 hello
On node 1, you should see a print out similar to below:
5 bytes from fdde:ad00:beef:0:dac3:6792:e2e:90d8 49153 hello
List the UDP CLI commands.
> udp help help bind close connect open send Done
Assigns a name (i.e. IPv6 address and port) to the example socket.
-u
: unspecified network interface.-b
: Backbone network interface.::
).> udp bind :: 1234 Done > udp bind -u :: 1234 Done > udp bind -b :: 1234 Done
Closes the example socket.
> udp close Done
Specifies the peer with which the socket is to be associated.
> udp connect fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 Done
Indicates whether the link security is enabled or disabled.
> udp linksecurity Enabled Done
Enable link security.
> udp linksecurity enable Done
Disable link security.
> udp linksecurity disable Done
Opens the example socket.
> udp open Done
Send a UDP message.
> udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 hello Done
Send a few bytes over UDP.
-t
: text payload in the value
, same as without specifying the type.-s
: autogenerated payload with specified length indicated in the value
.-x
: binary data in hexadecimal representation in the value
.> 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
Send a UDP message on a connected socket.
> udp send hello Done
Send a few bytes over UDP.
-t
: text payload in the value
, same as without specifying the type.-s
: autogenerated payload with specified length indicated in the value
.-x
: binary data in hexadecimal representation in the value
.> udp send -t hello Done > udp send -x 68656c6c6f Done > udp send -s 800 Done