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ą:

  1. 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.).

  2. Urządzenie z Bluetooth:

    • komputer, laptop, tablet lub smartfon z włączonym modułem Bluetooth.

  3. Urządzenie pomiarowe:

    • kompatybilne urządzenie FLOW TEST FT-IoT.

  4. 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

  1. Otwórz stronę:
    https://flow-test.pl/webFLOW/webFLOW_IOT.html

  2. Na górze strony widoczny jest tytuł webFLOW oraz informacja:

    • SN urządzenia: — – przed połączeniem numer seryjny nie jest jeszcze wyświetlany.

  3. 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:

  1. pobiera aktualne ciśnienie dynamiczne P z urządzenia (lub z trybu DEMO),

  2. wykorzystuje wybrany współczynnik K,

  3. 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

  1. 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.

  2. Brak odczytu ciśnienia dynamicznego

    • Zweryfikuj, czy połączenie BLE jest aktywne.

    • Sprawdź log zdarzeń, czy nie pojawił się komunikat o błędzie.

  3. 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.