![]() |
||
---|---|---|
.. | ||
main | ||
CMakeLists.txt | ||
README.md | ||
pytest_i2s_es8311.py | ||
sdkconfig.ci | ||
sdkconfig.ci.bsp | ||
sdkconfig.defaults |
README.md
Supported Targets | ESP32 | ESP32-C3 | ESP32-C6 | ESP32-H2 | ESP32-S2 | ESP32-S3 |
---|
I2S ES8311 Example
(See the README.md file in the upper level 'examples' directory for more information about examples.)
In this example, you can choose music mode or echo mode in menuconfig. In music mode, the example will play a piece of music in 'canon.pcm', and in echo mode, you can hear what you said in earphone.
ES8311 brief
ES8311 low power mono audio codec features:
- High performance and low power multi-bit delta-sigma audio ADC and DAC
- I2S/PCM master or slave serial data port
- I2C interface for configuration
- ADC: 24-bit, 8 to 96 kHz sampling frequency
- ADC: 100 dB signal to noise ratio, -93 dB THD+N
- DAC: 24-bit, 8 to 96 kHz sampling frequency
- DAC: 110 dB signal to noise ratio, -80 dB THD+N
For more details, see ES8311 datasheet
How to Use Example
Hardware Required
- A development board with any supported Espressif SOC chip (see
Supported Targets
table above)- The example can be preconfigured for ESP-BOX, ESP32-S2-Kaluga-kit and ESP32-S3-LCD-EV-board. More information is in 'Configure the Project' section.
- A USB cable for power supply and programming.
- A board with ES8311 codec, mic and earphone interface(e.g. ESP-LyraT-8311A extension board).
Connection
┌─────────────────┐ ┌──────────────────────────┐
│ ESP │ │ ES8311 │
│ │ │ │
│ I2S_MCK_IO├──────────►│PIN2-MCLK │
│ │ │ │ ┌─────────┐
│ I2S_BCK_IO├──────────►│PIN6-BCLK PIN12-OUTP├───────────┤ │
│ │ │ │ │ EARPHONE│
│ I2S_WS_IO├──────────►│PIN8-LRCK PIN13-OUTN├───────────┤ │
│ │ │ │ └─────────┘
│ I2S_DO_IO├──────────►│PIN9-SDIN │
│ │ │ │
│ I2S_DI_IO│◄──────────┤PIN7-SDOUT │
│ │ │ │ ┌─────────┐
│ │ │ PIN18-MIC1P├───────────┤ │
│ I2C_SCL_IO├──────────►│PIN1 -CCLK │ │ MIC │
│ │ │ PIN17-MIC1N├───────────┤ │
│ I2C_SDA_IO│◄─────────►│PIN19-CDATA │ └─────────┘
│ │ │ │
│ VCC 3.3├───────────┤VCC │
│ │ │ │
│ GND├───────────┤GND │
└─────────────────┘ └──────────────────────────┘
Note: Since ESP32-C3 & ESP32-H2 board does not have GPIO 16/17, you can use other available GPIOs instead. In this example, we set GPIO 6/7 as I2C pins for ESP32-C3 and GPIO 8/9 ESP32-H2 and GPIO 16/17 for other chips, same as GPIO 18/19, we use GPIO 2/3 instead.
Dependency
This example is based on es8311 component
The component can be installed by IDF Component Manager. This example already includes it. If you want to install es8311 component separately in your project, you can input the following command:
idf.py add-dependency "espressif/es8311^1.0.0"
If the dependency is added, you can check idf_component.yml
for more detail. When building this example or other projects with managed components, the component manager will search for the required components online and download them into the managed_components
folder.
Configure the Project
idf.py menuconfig
You can find configurations for this example in 'Example Configuration' tag.
-
In 'Example mode' subtag, you can set the example mode to 'music' or 'echo'. You can hear a piece of music in 'music' mode and echo the sound sampled by mic in 'echo' mode. You can also customize you own music to play as shown below.
-
In 'Set MIC gain' subtag, you can set the mic gain for echo mode.
-
In 'Voice volume', you can set the volume between 0 to 100.
-
In 'Enable Board Support Package (BSP) support' you can enable support for BSP. You can pick specific BSP in idf_component.yml.
Build and Flash
Build the project and flash it to the board, then run monitor tool to view serial output:
idf.py -p PORT 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
Running this example in music mode, you can hear a piece of music (canon), the log is shown as follow:
I (348) I2S: DMA Malloc info, datalen=blocksize=1200, dma_desc_num=6
I (348) I2S: DMA Malloc info, datalen=blocksize=1200, dma_desc_num=6
I (358) I2S: I2S0, MCLK output by GPIO0
I (368) DRV8311: ES8311 in Slave mode
I (378) gpio: GPIO[10]| InputEn: 0| OutputEn: 1| OpenDrain: 0| Pullup: 0| Pulldown: 0| Intr:0
I (3718) i2s_es8311: I2S music played, 213996 bytes are written.
I (7948) i2s_es8311: I2S music played, 213996 bytes are written.
......
Running this example in echo mode, you can hear the sound in earphone that collected by mic.
I (312) I2S: DMA Malloc info, datalen=blocksize=1200, dma_desc_num=6
I (312) I2S: DMA Malloc info, datalen=blocksize=1200, dma_desc_num=6
I (322) I2S: I2S0, MCLK output by GPIO0
I (332) DRV8311: ES8311 in Slave mode
I (342) gpio: GPIO[10]| InputEn: 0| OutputEn: 1| OpenDrain: 0| Pullup: 0| Pulldown: 0| Intr:0
If you have a logic analyzer, you can use a logic analyzer to grab GPIO signal directly. The following table describes the pins we use by default (Note that you can also use other pins for the same purpose).
pin name | function | gpio_num |
---|---|---|
MCLK | module clock | GPIO_NUM_0 |
BCLK | bit clock | GPIO_NUM_4 |
WS | word select | GPIO_NUM_5 |
SDOUT | serial data out | GPIO_NUM_18/2 |
SDIN | serial data in | GPIO_NUM_19/3 |
Customize your own music
The example have contained a piece of music in canon.pcm, if you want to play your own music, you can follow these steps:
- Choose the music in any format you want to play (e.g. a.mp3)
- Install 'ffmpeg' tool
- Check your music format using
ffprobe a.mp3
, you can get the stream format (e.g. Stream #0.0: Audio: mp3, 44100Hz, stereo, s16p, 64kb/s) - Cut your music since there is no enough space for the whole piece of music.
ffmpeg -i a.mp3 -ss 00:00:00 -t 00:00:20 a_cut.mp3
- Transfer the music format into .pcm.
ffmpeg -i a_cut.mp3 -f s16ls -ar 16000 -ac -1 -acodec pcm_s16le a.pcm
- Move 'a.pcm' under 'main' directory
- Replace 'canon.pcm' with 'a.pcm' in 'CMakeLists.txt' under 'main' directory
- Replace '_binary_canon_pcm_start' and '_binary_canon_pcm_end' with '_binary_a_pcm_start' and '_binary_a_pcm_end' in
i2s_es8311_example.c
- Download the example and enjoy your own music
Troubleshooting
-
Program upload failure
- Hardware connection is not correct: run
idf.py -p PORT monitor
, and reboot your board to see if there are any output logs. - The baud rate for downloading is too high: lower your baud rate in the
menuconfig
menu, and try again.
- Hardware connection is not correct: run
For any technical queries, please open an issue on GitHub. We will get back to you soon.