Internet radio station using an ESP32 and a VS1053 module.

Components:

• ESP32 dev board
• VS1053 module
• TFT ILI9341 screen
• XPT2046 touch controller (can be on the display module)
• IR1838 sensor

Based on https://github.com/Edzelf/Esp-radio but heavily modified.

All configuration, including station presets are hardcoded (although they can optionally be configured via MQTT). You can change default values in config.cpp.

Interaction with the radio happens via the buttons on the ILI9341's touch screen and the IR remote. You should be able to use any remote, as long as you configure the right keys.

Controls support starting, stopping, going to next or previous station.

Library assumes an external amplifier (you can get cheap PC speakers for 10$), so the volume is fixed at 90% and the volume control happens at the external amplifier. Should you require internal volume control, it should be easy enough to add it.

See http://www.internet-radio.com for suitable stations.

The following libraries are used to make this work:

• bodmer/TFT_eSPI
• PaulStoffregen/XPT2046_Touchscreen
• z3t0/IRremote
• marvinroger/async-mqtt-client
• bblanchon/ArduinoJson
• TridentTD/TridentTD_ESP32NVS

SPI bus is shared by the TFT LCD, the touch controller and the the VS1053.

Built with platform.io. Want to use it with the arduino IDE? You should be able to with slight modifications to the file structure, but you should really just use platform.io, it's far superior ;)

To get started, copy import_env.example.py to import_env.py and fill in your pin configuration.

Upload the /data folder where the fonts reside to the ESP before flashing. You can do that with pio run --target uploadfs or just use the platformio addon for vscode and click on Upload Filesystem Image.

Calibrate your screen - you will find the calibrate function within tft-ili9341.cpp file. Paste the calibration values as instructed.

Pins are fully configurable via import_env.py. Note that the SPI bus is shared, so your wiring has to reflect that.

Example wiring:

MQTT support is optionally implemented and can be enabled via MQTT_ENABLE switch (see import-env.example.py). One upstream and one downstream topic is required. ESP will periodically ping the upstream server to let it know it is available.

Communication is focused around saving configuration, not realtime control. Realtime control is left to the touch controls and the IR remote.

Server can send commands downstream in the following format:

{
  data: {
    type: 'config' | 'config-request',
    payload: { // optional
      presets: [
        "preset1.com",
        "preset2.com"
      ]
    }
  }
}

Command types:

• config-request: server requests config
• config: server sends config in payload

ESP responds upstream with the same format:

{
  data: {
    type: 'config' | 'ping',
    payload: { // optional
      presets: [
        "preset1.com",
        "preset2.com"
      ]
    }
  }
}

Types:

• config: ESP sends config upstream
• ping: ESP sends a ping