README.md

# esp32-ble-throughput

Test throughput of Bluetooth Low Energy (BLE) using an ATT_MTU of 517 bytes, Data
Packet Length Extension (DLE) of 251 bytes, and 2M PHY.

## Compiling

Install the dependencies:

- Rust
- cargo-espflash
- cargo-espmonitor

### Flashing

Flash the program with the following command, replacing `/dev/ttyACM0` with the
tty where your microcontroller is connected:

```sh
cargo espflash --partition-table partitions.csv --flash-size 4MB --speed 921600 --monitor /dev/ttyACM0
```

This not only flashes but also activates monitoring. If monitoring is not
desired, simply remove the `--monitor` flag.  
Building and flashing in release mode can be achieved with `--release`.

Other options should be adjusted as needed.

### Monitoring

To monitor the device and its output, use the following command, again replacing
`/dev/ttyACM0` with your microcontroller:

```sh
cargo espmonitor --chip esp32c3 --reset --speed 921600 /dev/ttyACM0
```

If automatically resetting the chip on connect is not desired, remove the
`--reset` flag.  
Monitoring the binary in release mode can be achieved with `--release`.

Other options should be adjusted as needed.

## Resources

Send patches and questions to
[~witcher/public-inbox@lists.sr.ht](https://lists.sr.ht/~witcher/public-inbox).

Instructions for preparing a patch are available at
[git-send-email.io](https://git-send-email.io/).