webFLOW IoT - instrukcja obsługi
Instrukcja obsługi aplikacji webFLOW IoT
1. Przeznaczenie aplikacji
Aplikacja webFLOW IoT służy do obsługi pomiarów hydrantów (zewnętrznych i wewnętrznych) z wykorzystaniem urządzeń pomiarowych FLOW TEST FT IoT.
Umożliwia m.in.:
-
odczyt ciśnienia dynamicznego z urządzenia,
-
ręczne wprowadzenie ciśnienia statycznego,
-
wybór współczynnika dyszy K,
-
automatyczne obliczenie wydajności Q [l/s],
-
zapis wyników do pliku CSV,
-
dodanie komentarza oraz współrzędnych GPS do pomiaru.
2. Wymagania techniczne
Aby korzystać z pełnej funkcjonalności aplikacji (w tym połączenia BLE), potrzebne są:
-
Przeglądarka internetowa:
-
Google Chrome lub Microsoft Edge
(funkcja Web Bluetooth nie działa w Firefox ani Safari – w tych przeglądarkach dostępne są tylko funkcje bez Bluetooth: komentarz, zapis CSV, tryb DEMO, itp.).
-
-
Urządzenie z Bluetooth:
-
komputer, laptop, tablet lub smartfon z włączonym modułem Bluetooth.
-
-
Urządzenie pomiarowe:
-
kompatybilne urządzenie FLOW TEST FT-IoT.
-
-
Opcjonalnie:
-
dostęp do internetu (do wygodnego pobierania plików i pracy w chmurze),
-
włączone usługi lokalizacji (jeśli chcesz zapisywać współrzędne GPS).
-
3. Pierwsze uruchomienie
-
Otwórz stronę:
https://flow-test.pl/webFLOW/webFLOW_IOT.html -
Na górze strony widoczny jest tytuł webFLOW oraz informacja:
-
SN urządzenia: — – przed połączeniem numer seryjny nie jest jeszcze wyświetlany.
-
-
Pod spodem znajdują się główne przyciski sterujące aplikacją.
4. Opis głównych przycisków
4.1. ???? Włącz lokalizację
-
Po kliknięciu przeglądarka może poprosić o zgodę na dostęp do lokalizacji.
-
Po jej wyrażeniu aplikacja pozyska współrzędne GPS, które mogą być zapisywane razem z wynikami pomiarów.
-
Możesz wybrać później, w jakim formacie będą zapisywane współrzędne (patrz rozdział 7).
4.2. ???? Połącz przez BLE
-
Uruchamia procedurę połączenia Bluetooth z urządzeniem pomiarowym.
-
Przeglądarka wyświetli listę dostępnych urządzeń BLE – wybierz swoje urządzenie z listy.
-
Po poprawnym połączeniu:
-
status u dołu zmieni się z „Nie połączono” na informację o połączeniu,
-
aplikacja zacznie odczytywać ciśnienie dynamiczne z urządzenia (odświeżanie ok. co 1 s).
-
Uwaga: jeśli przeglądarka nie obsługuje Web Bluetooth, funkcja nie będzie działać – patrz komunikat na stronie.
4.3. ⏏️ Rozłącz
-
Rozłącza aktywne połączenie BLE z urządzeniem pomiarowym.
-
Po rozłączeniu:
-
odczyt ciśnienia dynamicznego zostaje zatrzymany,
-
status wraca do „Nie połączono”.
-
4.4. ???? Tryb DEMO on/off
-
Włącza / wyłącza tryb demonstracyjny.
-
Tryb DEMO pozwala zasymulować działanie aplikacji bez realnego połączenia BLE – przydatne do szkoleń, prezentacji i testów interfejsu.
5. Sekcje pomiarowe
5.1. Ciśnienie dynamiczne
Nagłówek: „Ciśnienie dynamiczne”
Opis na stronie: „Wartość (bar) – odświeżanie ~1 s”
-
Po nawiązaniu połączenia z urządzeniem, w tej sekcji wyświetlana jest aktualna wartość ciśnienia dynamicznego P [bar].
-
Wartość jest odświeżana mniej więcej raz na sekundę.
-
To ciśnienie wykorzystywane jest w obliczeniu wydajności Q.
5.2. Ciśnienie statyczne
Nagłówek: „Ciśnienie statyczne”
Opis: „Wartość (bar) – wpisz ręcznie. Klient wpisuje zmierzone ciśnienie statyczne.”
-
W tym polu ręcznie wpisujesz ciśnienie statyczne zmierzone na obiekcie (np. manometrem na hydrancie wewnętrznym/zewnętrznym).
-
Wartość podajesz w bar.
-
Ciśnienie statyczne nie bierze bezpośredniego udziału w obliczeniu Q, ale może być zapisywane razem z wynikiem pomiaru w CSV jako informacja uzupełniająca.
5.3. Współczynnik dyszy K
Nagłówek: „Współczynnik dyszy K”
Opis: „Wybierz K [l/min·√bar]”
Lista przykładowych pozycji:
-
DN25-K22
-
DN25-K42
-
DN25-33-K45
-
DN33-K64
-
DN52-K85
-
DN52-K105
-
DN80JS-K300
-
DN80-K424,3
-
DN100-K636,4
-
DN150-K848,5
Instrukcja:
-
Wybierz z listy taki współczynnik K, który odpowiada dyszy pomiarowej użytej w danym zestawie.
-
Oznaczenie DN informuje o średnicy nominalnej (np. DN25, DN52).
-
Wartość K podawana jest w jednostkach [l/min·√bar].
-
Możesz zmieniać K w trakcie pomiaru – aplikacja przeliczy wynik Q dla nowej wartości K.
6. Komentarz do pomiaru
Sekcja „Komentarz:”
-
Wpisz tutaj dowolne informacje opisowe, np.:
-
typ hydrantu (wewnętrzny/zewnętrzny),
-
numer hydrantu na obiekcie,
-
lokalizacja w budynku,
-
uwagi z przeglądu.
-
-
Komentarz jest zapisywany razem z pomiarem i później widoczny w pliku CSV.
7. Wydajność Q
Nagłówek: „Wydajność Q”
Na stronie wyświetlany jest wynik:
-
liczba (np. 0.00) oraz jednostka l/s.
Podany jest także wzór:
Q = K · √P / 60
gdzie:
-
Q – wydajność strumienia wody [l/s],
-
K – współczynnik dyszy [l/min·√bar],
-
P – ciśnienie dynamiczne [bar].
Aplikacja automatycznie:
-
pobiera aktualne ciśnienie dynamiczne P z urządzenia (lub z trybu DEMO),
-
wykorzystuje wybrany współczynnik K,
-
przelicza wynik i wyświetla Q w l/s.
8. Zapisywanie wyników do CSV
Nagłówek: „Zapisywanie wyników do CSV”
Dostępne przyciski:
-
„Zapisz wynik” – dodaje aktualny pomiar do wewnętrznej listy wyników:
-
zapisywane są m.in. bieżące wartości (P, K, Q), komentarz, lokalizacja (jeśli włączona), ciśnienie statyczne itp.
-
-
„⬇️ Pobierz WYNIKI” – generuje i pobiera plik CSV z zapisanymi pomiarami.
Taki plik CSV możesz później:
-
otworzyć w Excelu / LibreOffice,
-
zaimportować do programu serwisowego,
-
dołączyć do protokołu przeglądu hydrantów.
9. Format współrzędnych GPS
Na stronie widoczny jest wybór:
-
Przecinkowy (HYDROSERWIS)
-
Kropkowy (np. 49.123456,19.123456)
Instrukcja:
-
Wybierz format, który jest zgodny z systemem, w którym później wykorzystasz dane:
-
„Przecinkowy (HYDROSERWIS)” – format dopasowany do oprogramowania HYDROSERWIS (oddzielanie wartości przecinkami w sposób zgodny z tym programem),
-
„Kropkowy” – standardowy zapis współrzędnych z kropką jako separatorem części dziesiętnej.
-
10. Tryb zapisu danych
Sekcja: „Tryb zapisu danych”
Dostępne opcje:
-
RAM (tymczasowy) – dane przechowywane są tylko w pamięci bieżącej:
-
po odświeżeniu strony lub zamknięciu przeglądarki wyniki zostaną utracone,
-
-
localStorage (trwały) – dane zapisywane są w pamięci przeglądarki:
-
po zamknięciu i ponownym otwarciu strony wyniki nadal są dostępne na tym samym urządzeniu,
-
-
„Wyczyść localStorage” – usuwa wszystkie lokalnie przechowywane wyniki pomiarów.
11. Log zdarzeń
Nagłówek: „Log zdarzeń”
-
W tej sekcji aplikacja wyświetla historię działań, np.:
-
nawiązanie/utrata połączenia BLE,
-
zapis wyniku,
-
zmiana trybu, błędy itp.
-
-
Log ułatwia diagnostykę pracy aplikacji i ewentualnych problemów.
12. Rozwiązywanie typowych problemów
-
Brak możliwości połączenia przez BLE
-
Sprawdź, czy używasz Chrome lub Edge.
-
Upewnij się, że Bluetooth w urządzeniu jest włączony.
-
Sprawdź, czy urządzenie pomiarowe jest zasilane i w trybie gotowości do połączenia.
-
-
Brak odczytu ciśnienia dynamicznego
-
Zweryfikuj, czy połączenie BLE jest aktywne.
-
Sprawdź log zdarzeń, czy nie pojawił się komunikat o błędzie.
-
-
Brak lokalizacji GPS w wynikach
-
Upewnij się, że kliknięto „Włącz lokalizację” i przyznano uprawnienia w przeglądarce.
-
Sprawdź ustawienia lokalizacji w systemie operacyjnym.
-