yoradio/CONFIG_FILES.md

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)

# 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:

# 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:

# Wymaż całą pamięć flash
task erase

# Wgraj firmware i pliki od nowa
task full-flash

Backup konfiguracji

Przed aktualizacją firmware zawsze rób backup:

# 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"