esp-idf/examples/peripherals/i2s/i2s_basic/i2s_std
2022-11-08 17:05:33 +08:00
..
main esp32h2: renaming esp32h2 to esp32h4 2022-11-08 17:05:33 +08:00
CMakeLists.txt i2s: add basic examples for STD/TDM/PDM mode 2022-07-21 15:52:39 +08:00
pytest_i2s_std.py i2s: add basic examples for STD/TDM/PDM mode 2022-07-21 15:52:39 +08:00
README.md ci: Enable esp32c6 example, test_apps, and unit tests CI build stage 2022-11-01 11:23:21 +08:00
sdkconfig.defaults i2s: add basic examples for STD/TDM/PDM mode 2022-07-21 15:52:39 +08:00

Supported Targets ESP32 ESP32-C3 ESP32-C6 ESP32-S2 ESP32-S3

I2S Basic Standard Mode Example

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

This example is going to show how to use the standard mode in simplex mode or full-duplex mode.

How to Use Example

Hardware Required

  • A development board with any one of ESP32, ESP32-S2, ESP32-C3 or ESP32-S3 SoC
  • A USB cable for power supply and programming

Configure the Project

There are simplex mode and duplex mode can be chosen in this example, you can choose the mode in the menuconfig or just setting EXAMPLE_I2S_DUPLEX_MODE derectly, when EXAMPLE_I2S_DUPLEX_MODE is 0 the example will adopt the simplex mode, otherwise it will adopt the full-duplex mode.

Note that ESP32-S2 simplex mode is not available because this example requires both TX & RX channels, however, ESP32-S2 has only one I2S controller and the simplex TX & RX channels can't coexist in a same controller. By the way, the simplex TX & RX channels can't coexist on ESP32 as well, but ESP32 has two I2S controllers so the simplex TX & RX channels can be registered on the different I2S controllers.

Build and Flash

Build the project and flash it to the board, then run monitor tool to view serial output:

idf.py -p PORT build flash monitor

(To exit the serial monitor, type Ctrl-].)

See the Getting Started Guide for full steps to configure and use ESP-IDF to build projects.

Example Output

While EXAMPLE_I2S_DUPLEX_MODE is set to 1, then you can see the following log:

Write Task: i2s write 2048 bytes
Read Task: i2s read 2048 bytes
-----------------------------------
[0] 12 [1] 34 [2] 56 [3] 78
[4] 9a [5] bc [6] de [7] f0

Write Task: i2s write 2048 bytes
Read Task: i2s read 2048 bytes
-----------------------------------
[0] 12 [1] 34 [2] 56 [3] 78
[4] 9a [5] bc [6] de [7] f0
...

While EXAMPLE_I2S_DUPLEX_MODE is set to 0, you can see the receiving data is always 0 because no signal inputted:

Write Task: i2s write 2048 bytes
Read Task: i2s read 2048 bytes
-----------------------------------
[0] 0 [1] 0 [2] 0 [3] 0
[4] 0 [5] 0 [6] 0 [7] 0

Write Task: i2s write 2048 bytes
Read Task: i2s read 2048 bytes
-----------------------------------
[0] 0 [1] 0 [2] 0 [3] 0
[4] 0 [5] 0 [6] 0 [7] 0
...

Troubleshooting

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