ESP32-audioI2S-masterを使う

更新日: 2026.04.02

概要

今回はライブラリ "ESP32-audioI2S-master" の使用レポート。 このライブラリで "Webラジオ" が非常に簡単に出来ます。

部品リストと配線

  • CPU:ESP32S3
    • ESP32(無印)でも動くのですが、SPIRAMが無い為 "MP3" しか再生出来ない。
    • ESP32S3なら "MP3" "AAC" "WAV" 等の再生が出来ます。
  • I2Sモジュール
    • "PCM5102 I2S" を使用。
    • このボードは使用する前にパッドをショートする必要が有ります。
  • SDカードソケット

これらの部品を以下の様に配線。

Schematic of ESP32-audioI2S-master

音はPCM5102のジャックにイヤフォンをつないで聞いています。

サンプルスケッチ

スケッチは "Arduino IDE 2.3" で書いています。ESP32が既に使用出来る環境として話しを進めます。 (まだの方は、"Arduino IDE 2.3 Install" を参照下さい)。

まずはライブラリーを追加します。IDE 左側のライブラリー(本のアイコン)をクリック。 表示された画面の検索欄に "ESP32-audioI2S-master" と入力してエンタ。 検索欄の下に "ESP32-audioI2S-master....." が表示されるのでそれをインストール。

Install ESP32-audioI2S-master library

これでサンプルスケッチが使える様になったのですが、IDE 1.8.19 の時に有ったスケッチが 2.3.8 では見当たりません。 そこで IDE 1.8.19 のサンプルを 2.3.8 に持って来ました。

I2Saudio.ino arduino
//********************************************************************************************************** //* audioI2S-- I2S audiodecoder for ESP32, * //********************************************************************************************************** // // first release on 11/2018 // Version 3 , Jul.02/2020 // // // THE SOFTWARE IS PROVIDED "AS IS" FOR PRIVATE USE ONLY, IT IS NOT FOR COMMERCIAL USE IN WHOLE OR PART OR CONCEPT. // FOR PERSONAL USE IT IS SUPPLIED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE // WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHOR // OR COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR // OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE // #include "Arduino.h" #include "WiFiMulti.h" #include "Audio.h" #include "SPI.h" #include "SD.h" #include "FS.h" SPIClass sd_spi(HSPI); // Digital I/O used /* #define SD_CS 5 #define SPI_MOSI 23 #define SPI_MISO 19 #define SPI_SCK 18 #define I2S_DOUT 25 #define I2S_BCLK 27 #define I2S_LRC 26 */ #define SD_CS 7 #define SPI_MOSI 15 #define SPI_MISO 17 #define SPI_SCK 16 #define I2S_DOUT 5 #define I2S_BCLK 6 #define I2S_LRC 4 Audio audio; WiFiMulti wifiMulti; String ssid = "xxxxx"; String password = "xxxxx"; void setup() { pinMode(SD_CS, OUTPUT); digitalWrite(SD_CS, HIGH); // SPI.begin(SPI_SCK, SPI_MISO, SPI_MOSI); sd_spi.begin(SPI_SCK, SPI_MISO, SPI_MOSI); SPI.setFrequency(1000000); Serial.begin(115200); // SD.begin(SD_CS); SD.begin(SD_CS, sd_spi); WiFi.mode(WIFI_STA); WiFi.setTxPower(WIFI_POWER_15dBm); wifiMulti.addAP(ssid.c_str(), password.c_str()); wifiMulti.run(); if(WiFi.status() != WL_CONNECTED){ WiFi.disconnect(true); wifiMulti.run(); } audio.setPinout(I2S_BCLK, I2S_LRC, I2S_DOUT); audio.setVolume(12); // 0...21 // audio.connecttoFS(SD, "test.wav"); // audio.connecttohost("http://www.wdr.de/wdrlive/media/einslive.m3u"); // audio.connecttohost("http://somafm.com/wma128/missioncontrol.asx"); // asx // audio.connecttohost("http://mp3.ffh.de/radioffh/hqlivestream.aac"); // 128k aac audio.connecttohost("http://mp3.ffh.de/radioffh/hqlivestream.mp3"); // 128k mp3 } void loop() { audio.loop(); if(Serial.available()){ // put streamURL in serial monitor audio.stopSong(); String r=Serial.readString(); r.trim(); if(r.length()>5) audio.connecttohost(r.c_str()); log_i("free heap=%i", ESP.getFreeHeap()); } } // optional void audio_info(const char *info){ Serial.print("info "); Serial.println(info); } void audio_id3data(const char *info){ //id3 metadata Serial.print("id3data ");Serial.println(info); } void audio_eof_mp3(const char *info){ //end of file Serial.print("eof_mp3 ");Serial.println(info); } void audio_showstation(const char *info){ Serial.print("station ");Serial.println(info); } void audio_showstreamtitle(const char *info){ Serial.print("streamtitle ");Serial.println(info); } void audio_bitrate(const char *info){ Serial.print("bitrate ");Serial.println(info); } void audio_commercial(const char *info){ //duration in sec Serial.print("commercial ");Serial.println(info); } void audio_icyurl(const char *info){ //homepage Serial.print("icyurl ");Serial.println(info); } void audio_lasthost(const char *info){ //stream URL played Serial.print("lasthost ");Serial.println(info); }

オリジナルのスケッチから以下を修正しています

  • 23行:SDカード用に "HSPI" を作成
  • 34~40行:回路に合わせてピン指定
  • 44,45行:ルータの情報を入れて下さい。/li>
  • 53行: HSPIの宣言
  • 59行: SDカードの宣言
  • 62行:WiFi出力の調整。 "ESP32S3 が WiFi に繋がらない" 参照。

IDEのパラメータを下記の様に設定してコンパイルして実行して下さい。Streamingが始まります。

Arduino IDE 2.3.4 Setup

Stream情報が表示されない

このスケッチ、Streamingが始まるとStreaming関係の情報がシリアルモニタに表示されるのですが、今回は表示されません。 調べて見ると "ESP32-audioI2S-master" のバージョンを3.4.0まで戻せば表示される事が分かりました。

10:39:36.409 -> info audioI2S Version 3.4.0[0m 10:39:36.409 -> info inputBufferSize: 655349 bytes[0m 10:39:36.409 -> info buffers freed, free Heap: 223920 bytes[0m 10:39:36.409 -> info connect to: "mp3.ffh.de" on port 80 path "/radioffh/hqlivestream.mp3"[0m 10:39:37.405 -> info Connection has been established in 1000 ms[0m 10:39:37.405 -> lasthost http://mp3.ffh.de/radioffh/hqlivestream.mp3 10:39:38.338 -> icyurl https://www.ffh.de 10:39:38.338 -> info icy-name: HIT RADIO FFH[0m 10:39:38.338 -> station HIT RADIO FFH 10:39:38.338 -> info icy-genre: [0m 10:39:38.338 -> info icy-bitrate: 128000[0m 10:39:38.338 -> bitrate 128000 10:39:38.371 -> info MP3Decoder has been initialized, free Heap: 222012 bytes , free stack 5704 DWORDs[0m 10:39:38.757 -> info stream ready[0m 10:39:38.757 -> info syncword found at pos 0[0m 10:39:38.757 -> info MPEG-2.5 Layer III[0m

現在の最新は 3.4.5 です。 3.4.0 と何が違うのでしょうか。

最後に

"ESP32-audioI2S-master" を使えば簡単にWebRadioが出来そうです。

SINCE 2026