https://github.com/allangallop/mini-web-radio
A small simple to use internet radio based around the ESP32
https://github.com/allangallop/mini-web-radio
Last synced: 2 months ago
JSON representation
A small simple to use internet radio based around the ESP32
- Host: GitHub
- URL: https://github.com/allangallop/mini-web-radio
- Owner: AllanGallop
- Created: 2022-05-05T10:20:57.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2023-09-10T16:42:18.000Z (over 1 year ago)
- Last Synced: 2025-03-25T01:41:30.433Z (3 months ago)
- Language: C++
- Size: 3.75 MB
- Stars: 54
- Watchers: 4
- Forks: 8
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
> [Version 2](https://github.com/AllanGallop/mini-web-radio-2) now Available!
# Mini Web Radio
Originally designed as a charity project, the MWR is a simple single-station battery powered internet radio. The design features a combined power-volume dial and 3.5mm headphone socket, utilising a 3D printed case and is based around:
* WeMos Lolin32 Lite (ESP32)
* MAX98357A I2S DAC Amplifier
* 18650 Lithium Battery
**This project has now largely been replaced by [Version 2](https://github.com/AllanGallop/mini-web-radio-2)** which introduces multiple channels, stereo audio and a single board design. However if you prefer to use off the shelf components then stick with Version 1!
## Documents
* [User Guide](Documentation/MWR_User_Guide.pdf)
* [Technical Guide](Documentation/MWR_Technical_Guide.pdf)
* [Bill Of Materials](Documentation/BOM.pdf)
## Construction
> Hardware assembly instructions available via [Instructables](https://www.instructables.com/Mini-Web-Radio-ESP32)
## Configuration
The MWR has built-in browser based configuration which allows you to define the Hostname, Wireless network credentials and the playback URL.
> Enable Configuration mode
1. Switch Off MWR
2. Open Faceplate
3. Install jumper (2.54mm) or short pins 13 and 15
4. Turn On MWR
5. Connect to `MWR-WIFI-SETUP` network
6. Remove Jumper
6. Navigate browser to `192.168.1.1`
7. Enter configuration Details and select `Save`
8. The MWR will automatically restart into radio mode and begin playback
> **Use SPIFF Files** Alternatively you can enter configuration details directly into the configuration files (host, ssid, pass, url) located in the _data_ directory, this is preferred when mulitiple units require setup.
## Firmware
Code for both the Arduino IDE and Plaform.io are included under the firmare directory
### Arduino IDE
> For Arduino 2.x & ESP32 2.x make sure to update line 65 of MWR.ino, EDIT: Don't use IDE 2.x, the ESPAsyncWebsever library has issues with it and lacks a SPIFFS upload tool
> **Build team**: please use Arduino IDE _1.8.16_ with ESP32 lib _1.0.6_
1. Download and install the following libaries:
* [ESPAsyncWebServer](https://github.com/me-no-dev/ESPAsyncWebServer)
* [AsyncTCP](https://github.com/me-no-dev/AsyncTCP) (Required for ESPAsyncWebServer)
* [ESP32-AudioI2S](https://github.com/schreibfaul1/ESP32-audioI2S)
2. Download and install the following Tools:
* [ESPTool_py](https://github.com/me-no-dev/arduino-esp32fs-plugin/releases/)
3. Add the _Additional Board URL_ to the IDE properties (File > Preferences)
```https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json```
4. Using the _Board Manager_ add the board **esp32 - by Expressif Systems** (Tools > Board Manager)
5. Select the board: **Lolin32 Lite**
## Enclosure
Files for 3D printing the shell, face and dial are provided in the [CAD](CAD) directory. The enclosure uses a snaplock design to secure the face to the shell which can be difficult to lock into place initially, a small screw driver or spudger can make it easier to pry it open and closed.
**Print Settings:**
> These are just the settings that have worked for me, your milage may differ
* 0.4mm Nozzle
* 0.2mm Layer Height
* 5% Infill
* 1.75mm PLA+ Filament
## Battery Initialisation
> Applies only to v1.0 hardware using DW01A battery protection
The protection module is tpyically set to "tripped" state from factory, requiring user to provide power first before the battery is usable. Connecting the USB cable while the volume dial is in the ON state will reset the module.
## Schematic
