Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/xtrinch/esp-internet-radio
Internet radio station using an ESP32, VS1053 module, a TFT ILI9341 screen and an IR sensor.
https://github.com/xtrinch/esp-internet-radio
esp esp32 internet-radio radio radio-player vs1053
Last synced: 2 months ago
JSON representation
Internet radio station using an ESP32, VS1053 module, a TFT ILI9341 screen and an IR sensor.
- Host: GitHub
- URL: https://github.com/xtrinch/esp-internet-radio
- Owner: xtrinch
- Created: 2021-02-08T15:50:51.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2021-03-07T08:38:18.000Z (almost 4 years ago)
- Last Synced: 2024-10-11T13:42:21.103Z (3 months ago)
- Topics: esp, esp32, internet-radio, radio, radio-player, vs1053
- Language: C++
- Homepage:
- Size: 1.97 MB
- Stars: 7
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# ESP32-internet-radio
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 ;)
## Usage
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.
### Wiring
Pins are fully configurable via `import_env.py`.
Note that the SPI bus is shared, so your wiring has to reflect that.
Example wiring:
| ESP32 | Signal | Wired to LCD | Wired to VS1053 | Wired to the rest |
| -------- | ------ | -------------------------------- | ------------------- | --------------- |
| GPIO32 | | - | pin 1 XDCS | - |
| GPIO22 | | - | pin 2 XCS | - |
| GPIO4 | | - | pin 4 DREQ | - |
| GPIO2 | | pin 10 D/C or A0 | - | - |
| GPIO18 | SCK | pin 5 T_CLK (SCK) & pin 8 SCK | pin 5 SCK | - |
| GPIO19 | MISO | pin 6 SDO (MISO) & pin 2 T_OUT | pin 7 MISO | - |
| GPIO23 | MOSI | pin 9 SDI (MOSI) & pin 3 T_DIN | pin 6 MOSI | - |
| GPIO15 | | pin 2 CS | - | - |
| GPIO27 | | pin 4 T_CS | - | - |
| GPIO25 | - | - | - | Infrared receiver VS1838B |
| ------- | ------ | -------------------------------- | ------------------- | ---------------- |
| GND | - | pin 8 GND | pin 8 GND | Power supply GND |
| VCC 5 V | - | pin 7 BL | - | Power supply |
| VCC 5 V | - | pin 6 VCC | pin 9 5V | Power supply |
| EN | - | pin 1 RST | pin 3 XRST | - |
## Optional MQTT support
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.
### Downstream
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
### Upstream
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