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