.. _lwip_udpecho_rtthread_nano:

lwip_udpecho_rtthread-nano
====================================================

Overview
--------

This example shows UDP echo communication on RTThread-Nano.

- PC sends UDP data frames to MCU,  and then MCU sends the data frames back to PC

Board Settings
--------------

- Connect a USB port on PC to the PWR DEBUG port on the development board with a USB Type-C cable

- Connect an Ethernet port on PC to a RGMII port or a RMII port on the development board with an Ethernet cable

Project Configurations
----------------------

- Ethernet Port Settings: Refer to :ref:`Ethernet common project settings <ethernet_port_configurations_en>`

- Ethernet DHCP Configurations

  - the configurations in the `CMakeLists.txt` as follows:

    - sdk_compile_definitions(-DLWIP_DHCP=0): Disable DHCP feature

    - sdk_compile_definitions(-DLWIP_DHCP=1): Enable DHCP feature

Run Example
-----------

- Compiling and Downloading

- Running log is shown in the serial terminal as follows:


  .. code-block:: console

     This is an ethernet demo: UDP Echo On RTThread-Nano
     LwIP Version: 2.1.2

      \ | /
     - RT -     Thread Operating System
      / | \     3.1.5 build Oct  8 2024
      2006 - 2020 Copyright by rt-thread team
     msh >Enet phy init passed !
     Link Status: Down
     Link Status: Up
     Link Speed:  1000Mbps
     Link Duplex: Full duplex
     IPv4 Address: 192.168.100.10
     IPv4 Netmask: 255.255.255.0
     IPv4 Gateway: 192.168.100.1

- Run an Ethernet debugging tool

  - Select the protocol type: UDP

  - Select the local host address and port

  - Open

  - Select the remote host address and port

  - Enter and send any characters in the edit window

  - Watch the characters echoed from MCU

    .. image:: ../../../../../samples/lwip/lwip_udpecho_rtthread-nano/doc/lwip_udpecho_rtthread-nano.png
       :alt: img