mirror of https://github.com/espressif/esp-idf.git synced 2024-10-05 20:47:46 -04:00

History

xuxiao a397d31162 fix(wifi): add comments for the new API and fix code comments		2024-07-26 10:50:55 +08:00
..
main	all: Removes unnecessary newline character in logs	2023-06-09 03:31:21 +08:00
CMakeLists.txt	tools: Increase the minimal supported CMake version to 3.16	2022-06-01 06:35:02 +00:00
README.md	fix(wifi): add comments for the new API and fix code comments	2024-07-26 10:50:55 +08:00
sdkconfig.defaults	fix(ci): disable WiFi IRAM option for bleprph_wifi_coex example	2023-10-20 11:02:05 +08:00
sdkconfig.defaults.esp32	change(examples): Update example configurations for FreeRTOS v10.5.1	2023-10-21 04:39:16 +08:00

README.md

Supported Targets	ESP32	ESP32-C2	ESP32-C3	ESP32-C5	ESP32-C6	ESP32-S3

BLE Peripheral with ICMP Echo-Reply

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

This example aims to run ping network utility along with BLE GATT server simultaneously using NimBLE host stack. It is a combination of 2 examples in IDF: bluetooth/nimble/bleprph and protocols/icmp_echo. See the README.md files of these examples to know more about them.

BLE peripheral

This example creates GATT server and then starts advertising, waiting to be connected to a GATT client.

It uses ESP32's Bluetooth controller and NimBLE stack based BLE host.

ICMP Echo-Reply

Ping is a useful network utility used to test if a remote host is reachable on the IP network. It measures the round-trip time for messages sent from the source host to a destination target that are echoed back to the source.

Ping operates by sending Internet Control Message Protocol (ICMP) echo request packets to the target host and waiting for an ICMP echo reply.

Notes: Currently this example only supports IPv4.

How to Use Example

Before project configuration and build, be sure to set the correct chip target using:

idf.py set-target <chip_name>

Configure the project

Open the project configuration menu:

idf.py menuconfig

In the Example Configuration menu:

Enter SSID and password of known Wi-Fi AP with connectivity to internet.
Enter desired ping IP Address. Default is set to 93.184.216.34 ( This is the IP address of https://example.com ).
Enter other related parameters like count of ping and maximum numbers of retry.

Testing

To test this demo, any BLE scanner app and a WiFi access point with internet connectivity can be used.

Build and Flash

Run idf.py -p PORT flash monitor to build, flash and monitor the project.

(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

For any technical queries, please open an issue on GitHub. We will get back to you soon.