W tym artykule omówimy działanie i przykład wykorzystania widgetu Slider. Widok ten umożliwia nam zmianę domyślnej wartości punktu pomiarowego poprzez przesunięcie suwaka w odpowiednią pozycję. Konfiguracja naszego suwaka pozwala nam wybrać zakres minimum i maksimum oraz wartość skoku o jaki przesuwać się będzie suwak.
Przejdźmy do stworzenia nowego punktu pomiarowego, który będzie przechowywał wartość z widgetu slider. Ważne jest aby punkt pomiarowy posiadał zdefiniowaną wartość domyślną w przeciwnym wypadku suwak nie będzie działał prawidłowo. Dodajmy wobec tego nowy punkt pomiarowy przechowujący wartość numeryczną oraz zdefiniowaną wartość domyślną jako 0.
Po dodaniu punktu pomiarowego przejdźmy do stworzenia nowego widgetu wybierając z listy opcję "Slider". Możemy skorzystać z istniejącego już dashboardu lub stworzyć nowy.
Okno konfiguracji widoku zawiera podstawowe opcje jak nazwa i rozmiar, a znaczące rożnice znajdują się w oknie dodania nowego punktu pomiarowego. Dodajmy wobec tego nowy punkt pomiarowy :
Naszym oczom ukażą się trzy nowe pola do wypełnienia. Wartości Min i Max odpowiadają za początek i koniec zakresu w jakim będziemy się poruszać w obrębie naszego suwaka, a wartość Przesuwanie jest najmniejszą wartością o jaką zmienia się nasza liczba wraz z przesuwaniem suwaka. Na potrzeby tego artykułu stwórzmy slider o zakresie od 0 do 100 z minimalnym przesunięciem równym 5.
Po ustawieniu nazwy naszego widgetu i dodaniu nowego punktu pomiarowego, ukaże nam się gotowy do działania suwak wyświetlający aktualną wartość domyślną naszego punktu pomiarowego czyli w tym przypadku 0.
Napiszmy teraz krótki kod, który wyświetli nam aktualną wartość domyślną naszego punktu pomiarowego.
Stwórzmy nowy szkic w środowisku Arduino IDE i uzupełnijmy go o następujący kod pamiętając o wpisaniu odpowiednich parametrów WiFi i tokenu.
#include <ADEAS.h>
/**** SETUP ****/
void setup()
{
ADEAS::serialMode(true);
ADEAS::setup("WIFI_SSID", "WIFI_PASS", "TOKEN");
}
String wartosc = "";
void loop()
{
ADEAS::process();
if (API::isReady())
{
wartosc = API::getLastSet("suwak");
Serial.println(wartosc);
}
}
Przeanalizujmy najistotniejsze zmiany w naszym kodzie:
ADEAS::serialMode(true);
Włączenie monitora portu szeregowego.
String wartosc = "";
Inicjalizacja zmiennej do przechowywania aktualnej wartości suwaka.
if (API::isReady())
{
wartosc = API::getLastSet("suwak");
Serial.println(wartosc);
}
Jeżeli Web API jest gotowe do działania, to przypisz do zmiennej wartość aktualną wartość domyślną zmiennej "suwak", a następnie wyświetl ją na monitorze portu szeregowego.
Jeżeli nie wiesz jak skorzystać z monitora portu szeregowego, zapraszam Cię do artykułu Funkcja Wysyłania i Odbierania danych na serwer gdzie zostało to szerzej omówione. Wgrajmy nasz kod i po krótkiej chwili zacznijmy rusząc naszym suwakiem obserwując jednocześnie informacje wyświetlane na monitorze portu szeregowego. Jeżeli wszystkie kroki wykonalismy poprawnie, wyświetlane informacje powinny odpowiadać aktualnemu wskazaniu suwaka.