espressif/esp_gmf_io

readme

# ESP-GMF-IO

- [中文版](./README_CN.md)

ESP GMF IO is a collection of GMF input and output streams. IO streams have two data flow directions: reading and writing. The input type is readable, and the output type is writable. IO streams classify data transmission types into byte access and block access types. In general, byte access involves copying the source data before transferring, while block access only transfers the source data address without copy overhead. Additionally, IO streams provide optional thread configuration, allowing some IO streams to establish their own independent threads. The currently supported IO streams are listed in the table below:

| Name | Data flow direction | Thread | Data Type| Dependent Components  | Notes |
| :----: | :----: | :----: | :----: | :----: |:----: |
|  File | RW  |  NO |  Byte  |NA  | NA |
|  HTTP |  RW | YES | Block | NA  | Not support HTTP Live Stream |
|  Codec Dev IO |  RW | NO | Byte | [ESP codec dev](https://components.espressif.com/components/espressif/esp_codec_dev/versions/1.3.1)  | NA |
|  Embed Flash |  R | NO | Byte | NA  | NA |
|  I2S PDM |  RW | NO | Byte | NA  | NA |

## Usage
ESP GMF IO is typically used in combination with GMF Elements to form a pipeline, but it can also be used independently. In a pipeline, the IO stream is connected to the GMF Element's Port, and when used independently, the IO stream is accessed through the ESP_GMF_IO interface. For example code, please refer to [test_app](../test_apps/main/elements/gmf_audio_play_el_test.c)。