SimplyClime to proste narzędzie pozwalające połączyć Twoją stację pogodową z
aplikacją mobilną dostępną na system Android. Zacznijmy od początku:
Pobierz aplikację SimplyClime
Stwórz konto oraz dodaj nową stację pogodową
Otrzymany unikalny kod będzie potrzebny do konfiguracji Twojego mikrokontrolera
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.
Wysyłanie 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
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:
Zewnętrznej - klucz przy zapytaniu POST temp-out
Wewnętrznej - klucz przy zapytaniu POST temp-in
Ośmiu dodatkowych temperatur o kluczach od temp1 do temp8
Przykład zapytania:
Dostępny już wkrótce
Wilgotność
Wilgotność należy wysyłać w postaci procentowej [%] i podobnie jak temperaturę możemy ją zapisywać
jako wilgotność:
Zewnętrzną - klucz przy zapytaniu POST humidity-out
Wewnętrzną - klucz przy zapytaniu POST humidity-in
Ośmiu dodatkowych wilgotności o kluczach od humidity1 do humidity8
Przykład zapytania:
Dostępny już wkrótce
Ciśnienie atmosferyczne
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ść wiatru
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
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
Opady
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
Zanieczyszczenia powietrza
Możliwy jest pomiar dwóch klas czystości powietrza - PM10, PM2,5 oraz PM1.
Dane pomiarowe należy przeliczyć do jednostki [µg/m3] oraz w takiej postaci wysłać
adresując kluczem airpollutionPM10/airpollutionPM2,5/airpollutionPM1.
Przykład zapytania:
Dostępny już wkrótce
Nasłonecznienie
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
Poziom baterii
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
Błędy
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.
Invalid apiKey
Nie można odnaleźć urządzenia związanego z tym kluczem - należy sprawdzić jego poprawność lub wygenerować nowy.
Invalid data type
Wszystkie dane powinny być wysyłane jako wartość liczbowa.
Data out of range
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
Stacje pogodowe Ecowitt
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:
Protocol: Ecowitt
Server IP/Hostname: www.api.simplyclime.pl
Path: /ecowitt/report/?apiKey=${klucz}
Port: 80
Upload interval: 300-600 seconds
gdzie: ${klucz} - należy zastąpić numerem spisanym z aplikacji mobilnej (np. /ecowitt/report/?apiKey=123).
Po pierwszym wysłaniu danych, Twoja stacja pogodowa zostanie na stałe powiązana ze stacją dodaną w aplikacji.
