mirror of https://github.com/espressif/esp-idf.git synced 2025-08-08 12:10:59 +00:00

Files

Frantisek Hrbata 1c92945f59 change(examples): switch examples to use a minimal build

Currently, several example dependencies rely on the fact that all
registered components are added to the build, along with components
specified in common requirements. This results in longer build times
because even unused components must be built. Switch all examples to use
idf_minimal_build to compile only the components actually required by
the example.

Signed-off-by: Frantisek Hrbata <frantisek.hrbata@espressif.com>

2024-11-20 20:14:40 +01:00

main

change(examples): explicitly specify component dependencies for examples

2024-11-20 14:11:24 +01:00

CMakeLists.txt

change(examples): switch examples to use a minimal build

2024-11-20 20:14:40 +01:00

pytest_tcp_client.py

ci(esp_eth): enabled build and test for c61 in eth/proto examples

2024-09-18 08:44:58 +02:00

README.md

ci(esp_eth): enabled build and test for c61 in eth/proto examples

2024-09-18 08:44:58 +02:00

sdkconfig.ci

CI: update test cases to use different environment variables

2022-07-15 01:16:35 +08:00

sdkconfig.defaults

tcp_client example: support for Linux target.

2022-08-16 23:48:18 +05:30

README.md

Supported Targets	ESP32	ESP32-C2	ESP32-C3	ESP32-C5	ESP32-C6	ESP32-C61	ESP32-H2	ESP32-P4	ESP32-S2	ESP32-S3

TCP Client example

(See the README.md file in the upper level 'examples' directory for more information about examples.)

The application creates a TCP socket and tries to connect to the server with predefined IP address and port number. When a connection is successfully established, the application sends message and waits for the answer. After the server's reply, application prints received reply as ASCII text, waits for 2 seconds and sends another message.

Configure the project

This example can be configured to run on ESP32 and Linux target to communicate over IPv4 and IPv6.

idf.py menuconfig

Set following parameters under Example Configuration Options:

Set IP version of example to be IPV4 or IPV6.
Set IPV4 Address in case your chose IP version IPV4 above.
Set IPV6 Address in case your chose IP version IPV6 above.
- For IPv6 there's an additional option for Interface selection.
- Enter the name of the interface to explicitly establish communication over a specific interface.
- On selecting Auto the example will find the first interface with an IPv6 address and use it.
Set Port number that represents remote port the example will connect to.

Configure Wi-Fi or Ethernet under "Example Connection Configuration" menu. See "Establishing Wi-Fi or Ethernet Connection" section in examples/protocols/README.md for more details.

Note: please replace 192.168.0.167 3333 with desired IPV4/IPV6 address (displayed in monitor console) and port number in the following command.

How to use example:

In order to create TCP server that communicates with TCP Client example, choose one of the following options.

There are many host-side tools which can be used to interact with the UDP/TCP server/client. One command line tool is netcat which can send and receive many kinds of packets.

Ref to the upper level README for more information.

TCP server using netcat

nc -l 192.168.0.167 3333

Hardware Required

This example can be run on any commonly available ESP32 development board. This example can also run on any Linux environment.

Build and Flash

Build the project and flash it to the board, then run monitor tool to view serial output:

idf.py -p PORT flash monitor

(To exit the serial monitor, type Ctrl-].)

See the Getting Started Guide for full steps to configure and use ESP-IDF to build projects.

Troubleshooting

Start server first, to receive data sent from the client (application).