- Add Taskfile.yml for automated build/upload/monitor tasks - Add platformio.ini configured for ESP32-S3-DevKitC-1 with USB CDC support - Add myoptions.h with hardware configuration: * ILI9341 display (320x240, 3.2") * I2S audio pins (DOUT=16, BCLK=17, LRC=15) * Two rotary encoders * IR receiver support * Russian language mode for Polish characters support - Modify utf8Rus.cpp to support Polish characters: ąćęłńóśźż ĄĆĘŁŃÓŚŹŻ - Add CONFIG_FILES.md with WiFi and playlist configuration guide - Add KONFIGURACJA.md with complete hardware and software documentation - Update examples/myoptions.h with ILI9341 display and encoder configuration
159 lines
3.4 KiB
Markdown
159 lines
3.4 KiB
Markdown
# Pliki konfiguracyjne yoRadio dla ESP32-S3
|
|
|
|
## Lokalizacja plików
|
|
Wszystkie pliki konfiguracyjne znajdują się w katalogu:
|
|
```
|
|
yoRadio/data/data/
|
|
```
|
|
|
|
## 1. wifi.csv - Konfiguracja WiFi
|
|
|
|
### Format
|
|
```
|
|
SSID<TAB>PASSWORD
|
|
```
|
|
|
|
### Przykład
|
|
```
|
|
MojaWiFi mojehaslo123
|
|
SiecGoscinna guest12345
|
|
```
|
|
|
|
### Instrukcja
|
|
1. Edytuj plik `yoRadio/data/data/wifi.csv`
|
|
2. Każda linia to jedna sieć WiFi
|
|
3. SSID i hasło oddzielone **tabulatorem** (TAB)
|
|
4. ESP32 będzie próbował łączyć się z sieciami po kolei
|
|
|
|
## 2. playlist.csv - Lista stacji radiowych
|
|
|
|
### Format
|
|
```
|
|
NAZWA<TAB>URL<TAB>VOLUME
|
|
```
|
|
|
|
### Przykład
|
|
```
|
|
RMF FM http://195.150.20.242:8000/rmf_fm 0
|
|
Radio ZET http://zt.cdn.eurozet.pl:8400/zet.mp3 0
|
|
TOK FM http://zt.cdn.eurozet.pl:8400/tok.mp3 0
|
|
```
|
|
|
|
### Instrukcja
|
|
1. Edytuj plik `yoRadio/data/data/playlist.csv`
|
|
2. Każda linia to jedna stacja radiowa
|
|
3. Pola oddzielone **tabulatorem** (TAB):
|
|
- **NAZWA** - nazwa wyświetlana (max 30 znaków)
|
|
- **URL** - adres streamu (HTTP/HTTPS)
|
|
- **VOLUME** - głośność 0-100 (0 = domyślna)
|
|
|
|
## Wgrywanie plików na ESP32
|
|
|
|
### Metoda 1: Upload przez PlatformIO (ZALECANE)
|
|
```bash
|
|
# Wgraj tylko pliki konfiguracyjne
|
|
task upload-fs
|
|
|
|
# Lub pełny flash (firmware + pliki)
|
|
task full-flash
|
|
```
|
|
|
|
### Metoda 2: Przez interfejs webowy
|
|
1. Połącz się z ESP32:
|
|
- WiFi AP: `yoRadioAP`
|
|
- Hasło: `12345987`
|
|
- IP: `http://192.168.4.1/`
|
|
2. Przejdź do sekcji upload
|
|
3. Wgraj pliki `wifi.csv` i `playlist.csv`
|
|
|
|
### Metoda 3: Edycja online
|
|
1. Po połączeniu z WiFi, wejdź na IP ESP32
|
|
2. W interfejsie webowym możesz dodawać/usuwać stacje
|
|
3. Pliki zostaną automatycznie zapisane w SPIFFS
|
|
|
|
## Przykładowe polskie stacje radiowe
|
|
|
|
W pliku `playlist.csv` znajdują się następujące stacje:
|
|
- RMF FM
|
|
- Radio ZET
|
|
- TOK FM
|
|
- Radio Maryja
|
|
- Radio Kraków
|
|
- Radio Wrocław
|
|
- Polskie Radio 24
|
|
|
|
Oraz międzynarodowe:
|
|
- Chillout Lounge Radio
|
|
- Jazz Radio
|
|
- SomaFM Groove Salad
|
|
|
|
## Znajdowanie nowych stacji
|
|
|
|
### Źródła URL streamów:
|
|
1. **Radio Browser** - https://www.radio-browser.info/
|
|
2. **TuneIn** - https://tunein.com/
|
|
3. **SHOUTcast** - https://directory.shoutcast.com/
|
|
4. **Icecast** - https://dir.xiph.org/
|
|
|
|
### Testowanie URL:
|
|
```bash
|
|
# Test czy stream działa
|
|
curl -I <URL_STREAMU>
|
|
|
|
# Lub w przeglądarce - VLC
|
|
vlc <URL_STREAMU>
|
|
```
|
|
|
|
## Resetowanie konfiguracji
|
|
|
|
Jeśli ESP32 nie startuje lub chcesz zacząć od nowa:
|
|
|
|
```bash
|
|
# Wymaż całą pamięć flash
|
|
task erase
|
|
|
|
# Wgraj firmware i pliki od nowa
|
|
task full-flash
|
|
```
|
|
|
|
## Backup konfiguracji
|
|
|
|
Przed aktualizacją firmware zawsze rób backup:
|
|
|
|
```bash
|
|
# Pobierz pliki z ESP32 przez przeglądarkę:
|
|
http://<ESP32_IP>/data/wifi.csv
|
|
http://<ESP32_IP>/data/playlist.csv
|
|
```
|
|
|
|
## Troubleshooting
|
|
|
|
### ESP32 nie łączy się z WiFi
|
|
1. Sprawdź format pliku `wifi.csv` - musi być TAB, nie spacje
|
|
2. Upewnij się że WiFi działa i jest w zasięgu
|
|
3. Sprawdź czy hasło jest poprawne
|
|
4. Zobacz logi przez: `task monitor`
|
|
|
|
### Stacje nie grają
|
|
1. Sprawdź URL w przeglądarce
|
|
2. Niektóre stacje wymagają HTTPS (ESP32-S3 wspiera)
|
|
3. Sprawdź format playlist.csv - TAB separator
|
|
4. Zobacz logi audio przez: `task monitor`
|
|
|
|
### Jak edytować pliki CSV
|
|
**UWAGA:** Używaj edytora tekstu, nie Excel!
|
|
|
|
Dobry edytor:
|
|
- VS Code
|
|
- Sublime Text
|
|
- Notepad++
|
|
- nano/vim
|
|
|
|
Excel często zamienia TAB na spacje!
|
|
|
|
## Format końca linii
|
|
|
|
Pliki powinny mieć Unix line endings (LF), nie Windows (CRLF).
|
|
|
|
W VS Code: dolny prawy róg -> kliknij "CRLF" -> wybierz "LF"
|