ATMOS

Bateryjna stacja pogodowa e-paper z konfiguracją Wi-Fi przez captive portal.

Spis treści

1. Wprowadzenie

ATMOS wyświetla prognozę pogody i łączy ją z pomiarami temperatury, wilgotności i ciśnienia w pomieszczeniu z wbudowanego czujnika BME280. Po konfiguracji działa samodzielnie: wybudza się, pobiera dane, odświeża ekran e-paper i wraca do deep sleep.

Obsługiwane języki to English, Deutsch, Čeština, Polski i Slovenčina.

2. Pierwsze uruchomienie

1. Po włączeniu pojawi się ekran startowy ATMOS.
2. Jeśli urządzenie nie ma jeszcze zapisanej domowej sieci Wi-Fi, utworzy własny hotspot.
3. Na wyświetlaczu zobaczysz komunikat i kod QR dla sieci ATMOS-XXXXXXXXXXXX.
4. Po podłączeniu klienta strona konfiguracji będzie dostępna pod adresem 192.168.4.1.

3. Konfiguracja Wi-Fi i lokalizacji

W interfejsie webowym uzupełnij te pola:

Nie musisz ręcznie wpisywać współrzędnych ani wysokości. Firmware pobierze je automatycznie po zapisaniu ustawień.

Po wysłaniu formularza konfiguracja zostanie zapisana w pamięci ESP32, stacja połączy się z Wi-Fi i zacznie pobierać dane pogodowe.

4. Co pokazuje ekran

Ekran jest podzielony na kilka poziomych bloków, ułożonych od góry do dołu:

Nagłówek (czarny pasek)

• Numer dnia — duża cyfra po lewej.
• Nazwa dnia — pełna nazwa dnia tygodnia (np. Poniedziałek) nad linią przerywaną.
• Miesiąc i rok — pod linią przerywaną.
• Imieniny — po prawej stronie pod linią przerywaną.
• Lokalizacja — nazwa miasta z czerwoną kropką w prawym górnym rogu.
• Ikony statusu — prawy górny róg: czas ostatniego pobrania, interwał następnej aktualizacji, siła sygnału Wi-Fi (wypełnione słupki) i poziom baterii.

Aktualna pogoda (sekcja główna)

• Ikona pogody — duża ikona po lewej, czerwona podczas deszczu/śniegu.
• Temperatura — duża liczba z °C po prawej, czerwona poniżej zera.
• Opis warunków — tekst aktualnej pogody wyśrodkowany pod ikoną.
• Temperatura odczuwalna — po prawej stronie tego samego wiersza.
• Wiatr — na dole po lewej: strzałka kierunku i prędkość w km/h.
• Słońce / Księżyc — na dole po prawej: w dzień wschód i zachód słońca z ikonami; w nocy ikona fazy księżyca, nazwa fazy i procent oświetlenia.

Pasek z poradą (czarny pasek)

• Dwuwierszowa wskazówka pogodowa na podstawie aktualnych warunków (np. „Weź parasol" lub „Świetna pogoda na spacer"). Wiersze są oddzielone linią przerywaną.

Wykres godzinowy / Radar pogodowy

• Wykres godzinowy — 24-godzinna krzywa temperatury (czarna) ze słupkami opadów (czerwone). Lewa oś pokazuje temperaturę w °C, prawa oś opady w mm. Minima i maksima są podświetlone dymkami z wartością i godziną. Na dolnej osi etykiety czasowe.
• Radar pogodowy — gdy w najbliższych godzinach prognozowane są opady, wykres jest automatycznie zastępowany mapą radarową na żywo. Mapa pokazuje Twoją lokalizację w centrum czerwoną kropką, granice państw i regionów, nazwy miast oraz intensywność opadów na czerwono (rzadsze = lekki deszcz, gęstsze = silny deszcz).

Prognoza 5-dniowa

• Pięć kolumn, jedna na dzień. Każda kolumna pokazuje: skrót dnia (niedziela na czerwono), ikonę pogody, temperaturę maksymalną (dużą), temperaturę minimalną (mniejszą) i jednostkę °C. Kolumny są oddzielone przerywanymi liniami pionowymi.
• Dzisiejsza kolumna jest wyróżniona odwróconymi kolorami (biały na czarnym) z czerwonym paskiem na dole.
• Gdy oczekiwany jest deszcz, przy ikonie pogody pojawia się czerwona plakietka z prawdopodobieństwem procentowym.

Czujniki wewnętrzne (wyświetlane przy podłączonym BME280)

• Trzy kolumny: Temperatura wewnętrzna (°C ze strzałką trendu i zmianą), Wilgotność (% z oceną komfortu i punktem rosy), Ciśnienie (hPa ze stanem i trendem).
• Wartości trendów są wyświetlane na czerwono przy zmianie, na czarno przy stabilności.

5. Codzienna praca

• W ciągu dnia ATMOS odświeża się co pełną godzinę.
• W nocy używa dłuższych odstępów, żeby oszczędzać baterię.
• Gdy prognozowane są opady, interwał skraca się do 15 minut, aby mapa radarowa była aktualna.
• Po każdym odświeżeniu przerysowuje ekran e-paper i wraca do deep sleep.
• Jeśli Wi-Fi chwilowo nie działa, może nadal pokazywać dane z cache i spróbuje ponownie po 5 minutach.
• Po pięciu nieudanych próbach połączenia wraca do trybu konfiguracji.

6. Zmiana ustawień później

1. Naciśnij przycisk RESET.
2. Stacja uruchomi się ponownie, pobierze dane i tymczasowo udostępni serwisowy interfejs webowy.
3. Na ekranie zobaczysz zarówno własny hotspot, jak i lokalny adres IP w sieci domowej.
4. Możesz połączyć się z hotspotem ATMOS albo otworzyć pokazany adres IP w przeglądarce.

Tymczasowy interfejs serwisowy pozostaje aktywny przez około 5 minut.

7. Reset fabryczny

Firmware używa potwierdzonej sekwencji resetu, aby przypadkowo nie skasować konfiguracji.

1. Naciśnij RESET raz.
2. Podczas ekranu startowego, mniej więcej w ciągu kolejnych 5 sekund, naciśnij RESET ponownie.
3. Przy następnym starcie zapisane ustawienia i lokalny cache zostaną usunięte.

8. Bateria i zasilanie

• Poziom baterii jest mierzony wewnętrznie przez ADC i pokazywany w procentach.
• Przy niskim poziomie baterii stacja poprosi o podłączenie ładowarki.
• Poniżej około 10% urządzenie przechodzi w sen, aby chronić baterię i stabilność pracy.
• Do pierwszej konfiguracji, dłuższego serwisu albo testów używaj zewnętrznego zasilania.

9. Firmware i serwis

Aktualizacje firmware odbywają się automatycznie. Wystarczy nacisnąć przycisk RESET — podczas startu stacja łączy się z Wi-Fi, sama sprawdza, czy dostępna jest nowsza wersja firmware, i w razie potrzeby ją instaluje.

Aktualizacje uruchamiają się tylko przy odpowiednio naładowanej baterii (powyżej 90 %). Dla pewności podłącz ładowarkę przed aktualizacją.

10. Rozwiązywanie problemów

11. Parametry techniczne

• MCU: ESP32, 16 MB flash
• Wyświetlacz: 7.5" BWR 800x480 fizycznie, obrócony do 480x800 w pionie; opcjonalnie 10.2" 960x640
• Czujniki: BME280 dla temperatury, wilgotności i ciśnienia w pomieszczeniu
• Radar pogodowy: RainViewer (publiczne API), wyświetlany automatycznie przy prognozie opadów; mapa wektorowa z granicami państw i regionów
• Geokodowanie: Nominatim (OpenStreetMap)
• Lokalny cache: LittleFS
• Języki: EN, DE, CS, PL, SK