espressif/iperf-cmd

0.1.1

uploaded 1 month ago
Iperf command based on esp-idf console

readme

# Iperf command

This repository contains `iperf` command based esp-idf console.

## Documentation

### Supported commands:

- Part of official iperf: https://iperf.fr/iperf-doc.php
- And `iperf --abort`

  ```
  iperf  [-suV] [-c <host>] [-p <port>] [-l <length>] [-i <interval>] [-t <time>] [-b <bandwidth>] [-f <format>] [--abort]
    iperf command to measure network performance, through TCP or UDP connections.
    -c, --client=<host>  run in client mode, connecting to <host>
    -s, --server  run in server mode
      -u, --udp  use UDP rather than TCP
    -p, --port=<port>  server port to listen on/connect to
    -l, --len=<length>  Set read/write buffer size
    -i, --interval=<interval>  seconds between periodic bandwidth reports
    -t, --time=<time>  time in seconds to transmit for (default 10 secs)
    -b, --bandwidth=<bandwidth>  bandwidth to send at in Mbits/sec
    -f, --format=<format>  'k' = Kbits/sec 'm' = Mbits/sec
        --abort  abort running iperf
  ```

### Installation

- To add a plugin command or any component from IDF component manager into your project, simply include an entry within the `idf_component.yml` file.

  ```yaml
  dependencies:
    espressif/iperf_cmd:
      version: "^0.1.1"
  ```
- For more details refer [IDF Component Manager](https://docs.espressif.com/projects/idf-component-manager/en/latest/)

api

# API Reference

## Header files

- [iperf_cmd.h](#file-iperf_cmdh)

## File iperf_cmd.h






## Functions

| Type | Name |
| ---: | :--- |
|  esp\_err\_t | [**app\_register\_iperf\_commands**](#function-app_register_iperf_commands) (void) <br>_Registers console commands: iperf._ |



## Functions Documentation

### function `app_register_iperf_commands`

_Registers console commands: iperf._
```c
esp_err_t app_register_iperf_commands (
    void
) 
```


**Returns:**

ESP\_OK on success

changelog

# Changelog

## [0.1.1](https://github.com/espressif/iperf-cmd/commits/v0.1.1)

### Features

- Supported `iperf` command.
- Supported specific option `--abort` to stop iperf.
- Supported register iperf hook functions - from [`espressif/iperf`]()

Links

Supports all targets

License: Apache-2.0

To add this component to your project, run:

idf.py add-dependency "espressif/iperf-cmd^0.1.1"

or download archive

Dependencies

  • espressif/iperf =0.1.1
  • ESP-IDF >=4.3

    • Examples:

    iperf

    To create a project from this example, run:

    idf.py create-project-from-example "espressif/iperf-cmd^0.1.1:iperf"

    or download archive (124 bytes)

    Stats

    • Archive size
      Archive size: 7.88 KB
    • Downloaded in total
      Downloaded in total 655 times
    • Downloaded this version
      This version: 655 times

    Badge

    espressif/iperf-cmd version: 0.1.1
    |
    report abuse