esp-idf/examples/bluetooth/nimble/throughput_app
Djordje Nedic facab8c5a7 tools: Increase the minimal supported CMake version to 3.16
This updates the minimal supported version of CMake to 3.16, which in turn enables us to use more CMake features and have a cleaner build system.
This is the version that provides most new features and also the one we use in our latest docker image for CI.
2022-06-01 06:35:02 +00:00
..
blecent_throughput tools: Increase the minimal supported CMake version to 3.16 2022-06-01 06:35:02 +00:00
bleprph_throughput tools: Increase the minimal supported CMake version to 3.16 2022-06-01 06:35:02 +00:00
README.md

README.md

Throughput demo Examples

There are two different example folders inside this throughput_app, bleprph_throughput and blecent_throughput. As the names suggest, both of them play role of peripheral and central respectively. These example demonstrate application throughput for NimBLE on ESP32. Two ESP32 boards are needed to run this demo. The blecent_throughput example has CLI support to select GATT operation from READ/WRITE/NOTIFY. It can also accept connection parameters at start of program, more details can be found in respective READMEs.

Using the examples

First build and flash two ESP32 boards with bleprph_throughput and blecent_throughput examples. The central automatically scans and connects to peripheral based on peripheral name string (nimble_prph). In the next step, user may choose to configure connection parameters (MTU, connection interval, latency, supervision timeout, connection event length). In the next step, user needs to specify throughput test name (read, write or notify) and test time in seconds. Below are sample numbers of different throughput test runs for 60 seconds (MTU = 512, conn itvl = 7.5msec, conn event length = 7.5msec)

GATT method Measurement time Application Throughput
NOTIFY 60 seconds ~340Kbps
READ 60 seconds ~200kbps
WRITE 60 seconds ~500kbps

The notify output is seen on bleprph_throughput console and read/write throughput are seen on blecent_throughput console.