example

Example of the component espp/socket v1.1.1
# Socket Example

This example now acts as both a usage demo and a lightweight regression test for
the `socket` component. It runs a sequence of UDP and TCP scenarios and prints a
pass/fail summary at the end.

The covered scenarios include:

* UDP unicast client/server messaging with scope-based teardown
* UDP request/response with a larger payload
* UDP multicast request/response
* UDP response timeout when no server is listening
* UDP blocked-receive teardown
* TCP unicast client/server messaging with scope-based teardown
* TCP request/response followed by reconnect
* TCP blocked-accept teardown
* TCP connect failure to an unused port

At startup the example creates a small open Wi-Fi AP so the network stack is
initialized, but the actual test traffic stays local to the device using
loopback (`127.0.0.1`) and a local multicast group (`239.1.1.1`). No second
device or external server is required.

## How to use example

### 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
```

(Replace PORT with the name of the serial port to use.)

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

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

## Example Output

The serial log shows each scenario as it starts, a per-scenario pass/fail line,
and a final summary such as `Socket example summary: 9/9 scenarios passed`.

To create a project from this example, run:

idf.py create-project-from-example "espp/socket=1.1.1:example"

or download archive (~5.77 KB)