Repository navigation
2. Obecnie zaimplementowane
Na ten moment zaimplementowana została komunikacja z API OpenWeather, integracja z czujnikami BME280, MCP9808, BH1750, AS7262 oraz wyświetlanie otrzymanych informacji. Dokładny opis modułów znajdujących się już w projekcie został umieszczony poniżej.
Plik konfiguracji Api, wraz z plikiem nagłówkowym, zawierają składnię zapytania stworzonego celu uzyskania danych o pogodzie w danym mieście. Zgodnie z informacją zawartą w pliku README projekt opiera się na API pogodowym Openweather. Każde zapytanie musi zawierać koordynaty danego miasta, w przypadku przykładowym jest to Londyn - LAT tj. szerokość = 51.5085, LON tj. długość geograficzna = -0.1257. Zmienić je można w pliku ApiConfig.h (w repozytorium znajduje się plik przykładowy ApiConfig.example.h)
Konfiguracja wyświetlacza opiera się na podstawowej bibliotece Adafruit Display - więcej informacji dostępnych jest na stronie Adafruit
Odpowiedź serwera zawiera dużo niepotrzebnych w projekcie danych, więc obsługiwane są jedynie parametry konieczne do funkcjonowania stacji pogodowej. W module JsonParser.cpp zawarte są funkcje odpowiedzialne za zapis otrzymanej temperatury, temperatury odczuwalnej, ciśnienia i wilgotności, oraz dopasowanie strefy czasowej, godziny oraz daty.
Aby stacja mogła poprawnie pobierać dane konieczny jest ustawienie nazwy - WIFI_SSID - oraz hasła - WIFI_PASS. Umożliwione jest to w pliku WifiConfig.h (w repozytorium znajduje się plik przykładowy WiFiConfig.example.h).
Jeżeli Wi-FI zostało skonfigurowane poprawnie, to za pomocą funkcji WiFiSetup opisanej w WebClient.cpp ustawione zostanie połączenie umożliwiające komunikację. Status połączenia można uzyskać za pomocą funkcji PrintWiFiStatus, która wyświetli niewrażliwe dane na temat sieci.Zapytanie API odbywa się poprzez funkcję ApiRequest, która podejmuje próbę uzyskania danych pogodowych OpenWeather. Na każdym etapie koneksji użytkownik będzie informowany w przypadku wystąpienia nieprawidłowości połączenia, zapytania bądź odpowiedzi serwera.
Działanie stacji opiera się na wyświetlaniu danych pogodowych poprzez rozpoczęcie połączenia z siecią Wi-FI oraz wyświetlaczem i wysłania zapytania do serwerów OpenWeather. Stacja wysyła zapytanie cyklicznie. Ręczne odświeżanie informacji odbywa się za pomocą naciśnięciu przycisku A, który wymusza wysłanie ponownego zapytania. Wszystkie otrzymane dane wyświetlane są zarówno w terminalu jak i na wyświetlaczu. Wciśnięcie przycisku A spowoduje wysłanie zapytania o dane pogodowe dla kolejnego miasta oraz spowoduje wyświetlanie danych dla kolejnego miasta z listy. Lista obejmuje miasta takie jak Warszawa, Gdańsk oraz Kraków.
Za pomocą pozostałych przycisków można wykonać odczyt lokalny. Przycisk B wywołuje odczyt i wyświetlenie temperatury, wilgotności i ciśnienia z czujnika BME 280, a przycisk C spektrum światła widzialnego z czujnika AS7262 oraz poziom światła z czujnika BH1750. Dane wyświetlane są przez kilka sekund, po czym ekran wygasza się. W przypadku błędnego podłączenia któregoś z czujników, na wyświetlaczu wyświetli się informacja o braku połączenia z danym czujnikiem -"Error! Check wiring!".