Sterownik MT-SICS do wag

Korzystanie z modułu MT-SICS Scale Driver

Przewodnik po sterowniku wagi MT-SICS dla platformy Tulip:::(Info) (Player Information)
This driver will only be available for Player 2.8.0 and above. Please reach out to developer@tulip.co to put this on your instance.
:::

W niniejszym artykule opisano możliwości i konfigurację sterownika wagi MT-SICS (np. Sartorius) w programie Tulip.

Przegląd

W tym artykule skupimy się na połączeniu między Tulip a wagą zgodną ze standardem MT-SICS, taką jak waga firmy Sartorius. Omówimy sposób konfiguracji połączenia, a następnie przyjrzymy się możliwościom sterownika, takim jak odczyt masy, tarowanie i zerowanie wagi. Waga musi być podłączona do komputera z systemem Windows, a w instancji Tulip musi być włączona odpowiednia opcja Feature Flag.

Konfiguracja

Aby skonfigurować wagę MT-SICS do pracy z Tulip, wykonaj poniższe kroki.

Wymagania wstępne

1. Podłącz wagę: Podłącz wagę Sartorius (lub inną wagę zgodną ze standardem MT-SICS) do komputera z systemem Windows, zazwyczaj za pomocą złącza USB lub połączenia szeregowego.
2. Konfiguracja systemu Windows: Upewnij się, że komputer z systemem Windows rozpoznaje podłączoną wagę. W przypadku połączenia szeregowego zanotuj port COM przypisany przez system Windows (chociaż sterownik może pomóc w wyświetleniu listy tych portów).

Konfiguracja odtwarzacza Tulip

Połączenie z wagą jest zarządzane za pośrednictwem odtwarzacza Tulip. Poniższe kroki zazwyczaj wykonuje się na stronie sterownika odtwarzacza w odpowiedniej aplikacji Tulip (np. w aplikacji Driver Unit Tests):

1. Przejdź do sterownika MT-SICS:
   • Otwórz program Tulip Player.
   • Przejdź do strony przeznaczonej dla sterowników urządzeń (często oznaczonej jako „Player Driver Page” lub podobnie w aplikacji testowej/narzędziowej).
   • Znajdź i wybierz przycisk lub sekcję „MT-SICS”.

{height="" width=""}2. Zidentyfikuj port COM: * Kliknij przycisk „List serial devices” (Wyświetl listę urządzeń szeregowych). Spowoduje to wysłanie zapytania do systemu i wyświetlenie dostępnych portów COM. * Zidentyfikuj port COM odpowiadający podłączonej wadze.

1. Nawiązanie połączenia:
   • Wprowadź zidentyfikowany port COM w odpowiednim polu.
   • Wprowadź szybkość transmisji. W przypadku wielu wag firmy Sartorius korzystających z MT-SICS jest to zazwyczaj 115200.
   • Kliknij przycisk „Połącz ”. Pomyślne nawiązanie połączenia powinno zostać potwierdzone komunikatem lub wskaźnikiem stanu.

Rozwiązywanie problemów

• Brak możliwości wyświetlenia listy portów COM:
  • Upewnij się, że waga jest prawidłowo podłączona do komputera i włączona.
  • Sprawdź w Menedżerze urządzeń systemu Windows, czy waga (lub jej adapter USB-serial) jest rozpoznawana i czy przypisano jej port COM.
  • Spróbuj ponownie podłączyć wagę lub uruchomić ponownie program Tulip Player.
• Błąd połączenia:
  • Sprawdź, czy wprowadzono prawidłowy port COM i szybkość transmisji.
  • Upewnij się, że żadna inna aplikacja nie korzysta obecnie z tego samego portu COM.
  • Sprawdź, czy flaga funkcji CUSTOM_EDGE_DRIVER_MT_SICS_SCALE jest aktywna.

Możliwości

Sterownik wagi MT-SICS umożliwia integrację wag podłączonych do sieci lub bezpośrednio (np. przez USB/port szeregowy) z aplikacjami Tulip za pośrednictwem programu Windows Tulip Player.

Sterownik obsługuje łączenie się z wagą, odczytywanie masy, zerowanie wagi, tarowanie wagi oraz anulowanie operacji.

Funkcje

W programie Tulip Triggers można używać następujących funkcji do interakcji z podłączoną wagą:

• Wyświetlanie listy urządzeń szeregowych:
  • Opis: Wysyła zapytanie do komputera z programem Windows Player i wyświetla listę dostępnych portów szeregowych (COM). Przydatne do zidentyfikowania właściwego portu dla wagi.
  • Dane wejściowe: Brak.
  • Wyniki: Lista dostępnych portów COM.
• Połącz:
  • Opis: Nawiązuje połączenie z wagą MT-SICS.
  • Dane wejściowe:
    • Port COM: Port szeregowy, do którego podłączona jest waga (np. „COM3”).
    • Szybkość transmisji: Szybkość komunikacji dla połączenia szeregowego (np. 115200).
  • Wyniki: Status próby nawiązania połączenia (powodzenie/niepowodzenie).
• Pobierz wagę:
  • Opis: Żądanie aktualnej wagi od wagi. Sterownik zazwyczaj wygeneruje wówczas zdarzenie WeightData zawierające odczyt.
  • Dane wejściowe: Brak (zakłada się, że połączenie jest aktywne).
  • Wyniki: Wywołuje zdarzenie WeightData. Upewnij się, że Twoja aplikacja jest skonfigurowana do odbierania i wyświetlania tej wartości (np. w zmiennej „Aktualna waga”).
• Wyzerowanie:
  • Opis: Wysyła polecenie zerowania wagi. Powinno to również zostać odzwierciedlone na wyświetlaczu wagi.
  • Dane wejściowe: Brak.
  • Wyjścia: Wywołuje zdarzenie OperationStatus (powodzenie/niepowodzenie).
• Natychmiastowe zerowanie:
  • Opis: Wysyła polecenie natychmiastowego wyzerowania wagi.
  • Dane wejściowe: Brak.
  • Wyjścia: Wywołuje zdarzenie OperationStatus (powodzenie/niepowodzenie).
• Tara:
  • Opis: Wyzerowuje wagę z uwzględnieniem aktualnej masy na wadze. Wyświetlacz wagi powinien pokazywać zero. Polecenie to może zakończyć się niepowodzeniem, jeśli masa jest zbyt duża lub wykracza poza limity tarowania.
  • Dane wejściowe: Brak (wykorzystuje aktualną masę znajdującą się na wadze).
  • Wyniki: Wywołuje zdarzenie OperationStatus (powodzenie/niepowodzenie).
• Natychmiastowa tarowanie:
  • Opis: Wysyła polecenie natychmiastowego wyzerowania wagi z uwzględnieniem aktualnej masy na niej znajdującej się.
  • Dane wejściowe: Brak.
  • Wyniki: Wywołuje zdarzenie OperationStatus (powodzenie/niepowodzenie).
• Anuluj:
  • Opis: Próbuje anulować wszelką trwającą komunikację lub polecenie wysyłane do wagi. Może to również zatrzymać ciągłą aktualizację wagi, jeśli sterownik ją przesyłał.
  • Dane wejściowe: Brak.
  • Wyjścia: Wywołuje zdarzenie OperationStatus (powodzenie). Aktualizacje „Aktualnej wagi” mogą zostać wstrzymane.
• Rozłącz:
  • Opis: Zamyka połączenie z wagą MT-SICS.
  • Dane wejściowe: Brak.
  • Wyjścia: Status próby rozłączenia.

Zdarzenia

W modułach Tulip Triggers można wykorzystać następujące zdarzenia w celu reagowania na informacje lub zmiany stanu pochodzące ze sterownika wagi:

• Błąd:
  • Opis: Wskazuje na problem ze sterownikiem lub komunikacją z wagą.
  • Dane użytkowe: Zawierają komunikat opisujący błąd.
• Dane o wadze:
  • Opis: Wyzwalane po otrzymaniu nowych informacji o wadze z wagi, zazwyczaj po wydaniu polecenia „Get weight” lub jeśli sterownik jest ustawiony na strumieniowe przesyłanie danych o wadze.
  • Dane: Zawierają wagę (wartość liczbową) oraz jednostkę (np. „g”, „kg”). Należy je zapisać w zmiennej Tulip, aby wyświetlić „Aktualną wagę”.
• OperationStatus:
  • Opis: Wskazuje wynik wykonanego polecenia (np. zerowanie, tarowanie, anulowanie).
  • Dane użytkowe:
    • status: „success” lub „failure”.
    • message: Dodatkowe informacje o wyniku operacji (np. „Tara zakończona sukcesem”, „Tara nie powiodła się: przeciążenie”).