A streaming library for esp32, esp32-wrover, esp32-s2 and esp32-s3 with a separate VS1053 codec chip.
This library plays mp3, ogg, aac, aac+ and flac files and streams and uses ESP_VS1053_Library to communicate with the decoder.
This library plays http, https (insecure mode) and chunked audio files and streams. Also plays mp3 and ogg files from sdcard.
Visit eStreamPlayer32_VS1053 for PIO to see a PlatformIO project using this library.
Install ESP_VS1053_Library and this library in your Arduino library folder.
Take care to install the master branch of the VS1053 library or at least a version from commit ba1803f or later because the getChipVersion()
call that is needed is not included in the latest release.
See #23
Use the 2.0.17 Arduino ESP32 core version.
#include <Arduino.h>
#include <SD.h>
#include <VS1053.h> /* https://github.com/baldram/ESP_VS1053_Library */
#include <ESP32_VS1053_Stream.h>
#define SPI_CLK_PIN 18
#define SPI_MISO_PIN 19
#define SPI_MOSI_PIN 23
#define VS1053_CS 5
#define VS1053_DCS 21
#define VS1053_DREQ 22
#define SDREADER_CS 26
ESP32_VS1053_Stream stream;
const char* SSID = "xxx";
const char* PSK = "xxx";
bool mountSDcard()
{
if (!SD.begin(SDREADER_CS))
{
Serial.println("Card Mount Failed");
return false;
}
uint8_t cardType = SD.cardType();
if (cardType == CARD_NONE)
{
Serial.println("No SD card attached");
return false;
}
uint64_t cardSize = SD.cardSize() / (1024 * 1024);
Serial.println("SD Card Size: %lluMB\n", cardSize);
return true;
}
void setup() {
Serial.begin(115200);
Serial.println("\n\nsimple vs1053 streaming example.\n");
Serial.printf("connecting to wifi network %s\n", SSID);
WiFi.begin(SSID, PSK);
WiFi.setSleep(false); /* important to set this right! See issue #15 */
while (!WiFi.isConnected())
delay(10);
Serial.println("wifi connected - starting spi bus");
SPI.setHwCs(true);
SPI.begin(SPI_CLK_PIN, SPI_MISO_PIN, SPI_MOSI_PIN); /* start SPI before starting decoder or sdcard*/
Serial.println("spi running - mounting sd card");
if (!mountSDcard())
{
Serial.println("sdcard not mounted - system halted");
while (1)
delay(100);
}
Serial.println("card mounted - starting vs1053");
if (!stream.startDecoder(VS1053_CS, VS1053_DCS, VS1053_DREQ) || !stream.isChipConnected())
{
Serial.println("Decoder not running - system halted");
while (1)
delay(100);
}
Serial.println("vs1053 running - starting playback");
//stream.connecttohost("http://icecast.omroep.nl/radio6-bb-mp3");
stream.connecttofile(SD, "/test.mp3");
if (!stream.isRunning())
{
Serial.println("no stream running - system halted");
while (1)
delay(100);
}
Serial.print("codec: ");
Serial.println(stream.currentCodec());
Serial.print("bitrate: ");
Serial.print(stream.bitrate());
Serial.println("kbps");
}
void loop() {
stream.loop();
//Serial.printf("Buffer status: %s\n", stream.bufferStatus());
delay(5);
}
void audio_showstation(const char* info) {
Serial.printf("showstation: %s\n", info);
}
void audio_showstreamtitle(const char* info) {
Serial.printf("streamtitle: %s\n", info);
}
void audio_eof_stream(const char* info) {
Serial.printf("eof: %s\n", info);
}
Ogg files can not be started with an offset without first playing a couple of seconds from the start of the file.
Do not forget to switch WiFi out of power save mode:
...
WiFi.begin(SSID, PSK);
WiFi.setSleep(false);
...
Early version of the esp32 have issues with the external psram cache, resulting in reboots.
Workarounds are possible depending on the hardware revision.
No workarounds are possible for this revision other than not using the psram.
On revision V1.0 psram can be used with the following build flags:
-D BOARD_HAS_PSRAM
-mfix-esp32-psram-cache-issue
-mfix-esp32-psram-cache-strategy=memw
On revision V3.0 psram can be used with the following build flag:
-D BOARD_HAS_PSRAM
Source: esp-idf api guide on external ram.
In PIO you can find out what hardware revision you have by running esptool.py flash_id
in a terminal.
In Arduino IDE go to File->Preferences
and find the Show verbose output during
option. Check the box marked upload
.
You can now see the hardware revision when you upload a sketch.
bool startDecoder(CS, DCS, DREQ)
bool isChipConnected()
bool connecttohost(url)
bool connecttohost(url, offset)
bool connecttohost(url, user, pwd)
bool connecttohost(url, user, pwd, offset)
bool connecttofile(filesystem, filename)
bool connecttofile(filesystem, filename, offset)
void stopSong()
void loop()
This function has to called every couple of ms to feed the decoder with data.
For bitrates up to 320kbps somewhere between 5-25 ms is about right.
bool isRunning()
uint8_t getVolume()
void setVolume(uint8_t volume)
Value should be between 0-100.
uint8_t rtone[4] = {toneha, tonehf, tonela, tonelf};
void setTone(rtone)
Values for rtone
:
toneha = <0..15> // Setting treble gain (0 off, 1.5dB steps)
tonehf = <0..15> // Setting treble frequency lower limit x 1000 Hz
tonela = <0..15> // Setting bass gain (0 = off, 1dB steps)
tonelf = <0..15> // Setting bass frequency lower limit x 10 Hz
const char* currentCodec()
Returns STOPPED
if no stream is running.
const char* lastUrl()
The current stream url might differ from the request url if the request url points to a playlist.
size_t size()
Returns 0
if the stream is a radio stream.
size_t position()
Returns 0
if the stream is a radio stream.
const char *bufferStatus()
Returns 0/0
if there is no buffer.
Otherwise returns something like 4096/65536
which means 4kB waiting in a 64kB buffer.
void bufferStatus(size_t &used, size_t &capacity)
This version takes two size_t
variables by reference.
Works the same as the const char *
version.
NOTE: A buffer will only be allocated if there is enough free psram.
void audio_showstation(const char* info)
void audio_showstreamtitle(const char* info)
void audio_eof_stream(const char* info)
Returns the eof url or path.
Also called if a stream or file times out/errors.
You can use this function for coding a playlist.
Use connecttohost()
or connecttofile()
inside this function to start the next item.
MIT License
Copyright (c) 2021 Cellie
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", 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 AUTHORS OR COPYRIGHT HOLDERS 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.