Files
yoradio/CONFIG_FILES.md
Aleksander Cynarski 7ba365cad9 Add ESP32-S3 configuration for yoRadio with Polish character support
- 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
2026-02-22 13:52:17 +01:00

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"