This application uses the ZentriOS UDP client command to send UDP messages to a UDP echo server on the internet.
The UDP echo server, located on the internet at
test.zentri.com:50007, simply echoes all received data back to the ZentriOS UDP client.
Once the connection is established, stream_write is used to send data to the connection stream.
With all data sent, stream_poll is used to check for received data on the connection stream, and stream_read is used to read data waiting on the stream.
You will only need one Zentri evaluation board for this example.
Let's get started by connecting your board to a Wi-Fi network and opening the UDP connection stream. You can simply cut and paste the commands in the following table, but DON'T FORGET to replace your Wi-Fi network name and password for the defaults.
There is no need to bring up the WLAN network interface prior to making the UDP client connection. The UDP client (just like all commands that require network access) automatically connects to the network if a connection has not already been established.
The response is similar to the session shown below. The new UDP connection is assigned a stream handle, starting at 0 for the first UDP connection. Note that "connection" is used loosely here: UDP is a stateless protocol. However ZentriOS associates details of the connection with a stream, preserving some state.
|Session log when opening the UDP client connection|
Check the status of open streams before continuing. Use the stream_list command to get a list of open streams. The number in brackets appended to each line is the local port used for the UDP connection stream.
> stream_list ! # Type Info # 0 UDPC test.zentri.com:50007 (30001)
Writing data to a stream is easy using the stream_write command. Copy and paste the following commands to write data to the open stream.
Checking for Data
To check for data on any stream (or all streams at once), use the stream_poll command as shown in the following session. If you don't want to poll for data, try assigning a GPIO to a stream to indicate when data is available. The udp_client command describes how to assign a GPIO.
|Checking for data|
To read available data from any stream, use the stream_read command as shown in the following session. The following example reads up to 100 bytes from the stream.
|Checking for data|
Supporting ZentriOS Editions and Versions
|2015-Mar-31||Created from TCP client app note|