Pierwsze kroki
Wysyłanie danych
Temperatura
Wilgotność
Ciśnienie atmosferyczne
Prędkość wiatru
Kierunek wiatru
Opady
Zanieczyszczenia powietrza
Nasłonecznienie
Poziom baterii
Błędy
Ecowitt
SimplyClime to proste narzędzie pozwalające połączyć Twoją stację pogodową z aplikacją mobilną dostępną na system Android. Zacznijmy od początku:
Konieczny będzie dostęp stacji pogodowej do sieci. Poniżej przykład połączenia oraz wysłania testowego zapytania w celu sprawdzenia poprawności konfiguracji stacji opartej na platformie Arduino, wyposażonego w moduł WiFi.
Dostępny już wkrótce
W przypadku prawidłowej konfiguracji w monitorze portu szeregowego powinien pokazać się napis "Wszystko w porządku". Teraz możemy przejść dalej, do wysyłania danych pomiarowych.
Ty decydujesz jakie dane będzie zbierała Twoja stacja pogodowa oraz które z nich chcesz kontrolować z poziomu aplikacji więc wszystkie poniższe pola są opcjonalne (możliwy jest pomiar np. tylko temperatury).
Wyniki pomiarów należy wysyłać nie częściej niż co 15 minut. W wypadku częstszej próby wysyłania danych będzie zwracany błąd, a dane nie zostaną zapisywane. Przy ciągłych próbach dostarczenia danych częściej niż 15 minut przyjmowanie danych będzie dla tej stacji będzie blokowane na okres 4 godzin.
Dane należy wysyłać zapytaniem POST pod adres www.api.simplyclime.pl/weather/device/{api_key}
Temperatura może być wysyłana w jednostkach Kelvina, Fahrenheit'a oraz Celsjusza. Wyboru można dokonać tylko przy dodawaniu stacji z poziomu aplikacji. Możliwy jest zapis temperatury:
Przykład zapytania:
Dostępny już wkrótce
Wilgotność należy wysyłać w postaci procentowej [%] i podobnie jak temperaturę możemy ją zapisywać jako wilgotność:
Przykład zapytania:
Dostępny już wkrótce
Mierzone za pomocą czujnika ciśnienie należy przeliczyć do jednostki hektopaskali [hPa], a następnie zaadresować je w zapytaniu POST kluczem pressure.
Przykład zapytania:
Dostępny już wkrótce
Prędkość wiejącego wiatru możemy mierzyć i wysyłać w wybranej jednostce ([km/h], [m/s], [mph]), przy czym należy zaznaczyć odpowiednią opcję w aplikacji, a następnie zaadresować je w zapytaniu POST kluczem windspeed.
Przykład zapytania:
Dostępny już wkrótce
Kierunek wiatru należy mierzyć i wysyłać jako azymutm a następnie zaadresować go w zapytaniu POST kluczem winddir.
Przykład zapytania:
Dostępny już wkrótce
Wartość pomiaru czujnika opadów należy przeliczyć na wartość procentową [%] oraz wysłać zapytaniem POST z kluczem rainfall.
Przykład zapytania
Dostępny już wkrótce
Możliwy jest pomiar dwóch klas czystości powietrza - PM10 oraz PM2,5. Dane pomiarowe należy przeliczyć do jednostki [µg/m3] oraz w takiej postaci wysłać adresując kluczem airpollution-PM10 lub airpollution-PM2,5.
Przykład zapytania:
Dostępny już wkrótce
Aplikacja wykorzystuje te dane do wyświetlania odpowiedniej ikonki słońca bądź chmurki - złe umiejscowienie czujnika spowoduje błędny dobór ikonek. Wartość nasłonecznienia należy wysyłać w postaci procentowej [%] używając klucza insolation.
Przykładowe zapytanie:
Dostępny już wkrótce
Wartość procentową należy zaadresować kluczem batterylvl. W opcjach urządzenia w aplikacji możliwe jest włączenie powiadamiania o niskim poziomie baterii.
Przykładowe zapytanie:
Dostępny już wkrótce
W odpowiedzi na każde zapytanie zwracana jest wiadomość tekstowa o ewentualnym błędzie lub OK jeśli wszystko przebiegło pomyślnie. Poniżej znajdziesz wszystkie możliwe błędy.
Nie można odnaleźć urządzenia związanego z tym kluczem - należy sprawdzić jego poprawność lub wygenerować nowy.
Wszystkie dane powinny być wysyłane jako wartość liczbowa.
Wysłana wartość pomiaru nie mieści się w dostępnym zakresie. Poniżej znajdują się przedziały możliwych wartości:
Typ | Min | Max |
Temperatura [K][°C][°F] | -460 | 2000 |
Wilgotność [%] | 0 | 100 |
Ciśnienie atmosferyczne [hPa] | 0 | 2000 |
Opady [%] | 0 | 100 |
Zanieczyszczenia powietrza [µg/m3] | 0 | 2000 |
Nasłonecznienie [%] | 0 | 100 |
Poziom baterii [%] | 0 | 100 |
W celu konfiguracji stacji pogodowej należy dodać stację w aplikacji zaznaczając "stacja Ecowitt". Następnie przechodząc do ustawień dodanej stacji w aplikacji, spisz numer podany w polu "API Key" i przejdź do ustawień stacji pogodowej. Podaj następujące dane: