---
title: "Sterownik Banner PTL"
slug: "how-to-use-the-banner-ptl-driver"
status: "new"
updated: 2026-10-22T12:50:34Z
published: 2026-10-22T12:50:34Z
canonical: "support.tulip.co/how-to-use-the-banner-ptl-driver"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.tulip.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Sterownik Banner PTL

## Korzystanie ze sterownika Banner PTL

*Przewodnik po sterowniku Banner Pick-to-Light (PTL) dla platformy Tulip*

W niniejszym artykule opisano możliwości i konfigurację sterownika Banner PTL w Tulip.

              Note

              

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.

## Przegląd

W tym artykule skupimy się na połączeniu między Tulip a urządzeniem Banner PTL. Omówimy sposób konfiguracji połączenia, a następnie przyjrzymy się możliwościom sterownika, takim jak zmiana kolorów świateł, wyświetlanie komunikatów tekstowych w różnych trybach oraz sterowanie animacjami świateł. Konieczne jest podłączenie urządzenia PTL do komputera z systemem Windows oraz włączenie odpowiedniego znacznika funkcji w instancji Tulip.

---

## Konfiguracja

Aby skonfigurować urządzenie Banner PTL do pracy z Tulip, wykonaj poniższe kroki.

### Wymagania wstępne

1. **Podłącz urządzenie**: Podłącz urządzenie Banner PTL do komputera z systemem Windows, zazwyczaj za pomocą złącza USB lub połączenia szeregowego zapewniającego port COM.
2. **Konfiguracja systemu Windows**: Upewnij się, że komputer z systemem Windows rozpoznaje podłączone urządzenie PTL i przypisuje mu port COM.

### Konfiguracja odtwarzacza Tulip

Połączenie i konfiguracja urządzenia Banner PTL są zarządzane za pośrednictwem odtwarzacza Tulip Player, zazwyczaj w ramach dedykowanej aplikacji do testowania sterowników.

1. **Przejdź do sterownika Banner PTL**:
  - Otwórz program Tulip Player.
  - Przejdź do aplikacji „Driver Unit tests” lub podobnej aplikacji zawierającej stronę „Player Driver”.
  - Kliknij przycisk „BannerPTL” lub przejdź do odpowiedniej sekcji.
2. **Zidentyfikuj port COM**:
  - Kliknij przycisk **„List serial devices** ”. Spowoduje to wysłanie zapytania do systemu i wyświetlenie dostępnych portów COM.
  - Zidentyfikuj port COM odpowiadający podłączonemu urządzeniu Banner PTL.

![Screenshot 2025-05-28 at 11.10.05 AM.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Screenshot%202025-05-28%20at%2011.10.05%20AM.png)

1. **Rejestracja i konfiguracja urządzenia**:

*(Miejsce na obrazek przedstawiający interfejs połączenia Banner PTL w programie Tulip Player, z polami ścieżki (port COM), prędkości transmisji, identyfikatora urządzenia oraz przyciskami „Register RTU” i „Setup”).*
  - W aplikacji do testowania urządzenia (lub w interfejsie Twojej aplikacji dla tego sterownika):
    - W polu **„ścieżka** ” wprowadź zidentyfikowany port COM.
    - Ustaw **szybkość transmisji** na `19200`.
    - Ustaw **identyfikator urządzenia** na `1` (lub odpowiedni dla konfiguracji urządzenia PTL).
  - Kliknij przycisk **„Zarejestruj RTU** ”. Spowoduje to nawiązanie komunikacji z określonym urządzeniem.
  - Po pomyślnej rejestracji kliknij przycisk **„Setup** ”, aby zakończyć inicjalizację urządzenia.

### Rozwiązywanie problemów

- **Nie można wyświetlić listy portów COM**:
  - Upewnij się, że urządzenie Banner PTL jest prawidłowo podłączone do komputera i włączone.
  - Sprawdź w Menedżerze urządzeń systemu Windows, czy urządzenie (lub jego adapter USB-serial) jest rozpoznawane i czy przypisano mu port COM.
  - Spróbuj ponownie podłączyć urządzenie lub uruchomić ponownie program Tulip Player.
- **Błąd rejestracji lub konfiguracji**:
  - Sprawdź, czy wprowadzono prawidłowy port COM (`ścieżkę`), szybkość transmisji (`19200`) oraz `identyfikator urządzenia`.
  - Upewnij się, że żadna inna aplikacja nie korzysta obecnie z tego samego portu COM.
  - Sprawdź, czy flaga funkcji `CUSTOM_EDGE_DRIVER_BANNER_PTL` jest aktywna.
  - Zapoznaj się z dokumentacją urządzenia Banner PTL, aby poznać szczegółowe wymagania dotyczące konfiguracji lub trybu pracy.

---

## Możliwości

Sterownik Banner PTL umożliwia aplikacjom Tulip integrację z urządzeniami Banner Pick-to-Light podłączonymi do odtwarzacza Tulip Player w systemie Windows. Umożliwia to korzystanie z takich funkcji, jak sterowanie kolorami świateł, wyświetlanie komunikatów oraz zarządzanie animacjami służącymi do wizualnego prowadzenia operatora.

![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28910%29.png)

### Funkcje

W Tulip Triggers można używać następujących funkcji do interakcji z podłączonym urządzeniem Banner PTL:

*(Miejsce na ogólny obrazek ilustrujący działania wyzwalaczy Tulip dla sterownika urządzenia.)*

- **Lista urządzeń szeregowych**:
  - **Opis**: Wysyła zapytanie do komputera z programem Windows Player i wyświetla listę dostępnych portów szeregowych (COM).
  - **Dane wejściowe**: Brak.
  - **Wyniki**: Lista dostępnych portów COM.
- **Rejestracja RTU**:
  - **Opis**: Rejestruje urządzenie PTL w sterowniku przy użyciu jego parametrów komunikacyjnych. Jest to warunek konieczny do dalszej interakcji.
  - **Dane wejściowe**:
    - `path`: Port COM, do którego podłączone jest urządzenie PTL (np. „COM3”).
    - `baudRate`: Szybkość transmisji, zazwyczaj `19200` dla urządzenia Banner PTL.
    - `deviceID`: Unikalny identyfikator urządzenia PTL (np. `1`).
  - **Wyniki**: Stan próby rejestracji (wywołuje zdarzenie `OperationStatus` ).
- **Konfiguracja**:
  - **Opis**: Przeprowadza wstępną konfigurację zarejestrowanego urządzenia PTL. Należy wywołać tę metodę po pomyślnym wykonaniu `metody Register RTU`.
  - **Dane wejściowe**: Brak (zakłada się, że urządzenie jest zarejestrowane).
  - **Wyniki**: Stan próby konfiguracji (wywołuje zdarzenie `OperationStatus` ).
- **Ustaw kolor 1**:
  - **Opis**: Zmienia główny kolor wyświetlany przez urządzenie PTL.
  - **Dane wejściowe**:
    - `colorValue`: Żądany kolor (np. „Red”, „Green”, „Blue” lub konkretny kod obsługiwany przez urządzenie).
  - **Wyjścia**: Wywołuje zdarzenie `OperationStatus`. Wizualne potwierdzenie na urządzeniu PTL.
- **Ustaw kolor 2**:
  - **Opis**: Zmienia kolor dodatkowy wyświetlany przez urządzenie PTL (jeśli jest obsługiwany).
  - **Dane wejściowe**:
    - `colorValue`: Żądany kolor.
  - **Wyjścia**: Wywołuje zdarzenie `OperationStatus`. Potwierdzenie wizualne na urządzeniu PTL.
- **Ustaw tryb ASCII**:
  - **Opis**: Przełącza wyświetlacz urządzenia PTL w tryb oczekiwania na ciągi znaków ASCII.
  - **Dane wejściowe**: Brak.
  - **Wyniki**: Wywołuje zdarzenie `OperationStatus`.
- **Zapis ciągów znaków**:
  - **Opis**: Wysyła ciąg tekstowy, który ma zostać wyświetlony na urządzeniu PTL. Urządzenie musi zazwyczaj znajdować się w trybie ASCII. Urządzenie PTL może wyświetlać ten ciąg jako tekst przewijany lub statyczny (np. „Hello”).
  - **Dane wejściowe**:
    - `inputString`: Tekst do wyświetlenia (np. „Hello”).
  - **Wyjścia**: Wywołuje zdarzenie `OperationStatus`. Wizualne potwierdzenie na urządzeniu PTL.
- **Ustaw tryb surowy**:
  - **Opis**: Przełącza wyświetlacz urządzenia PTL w tryb surowy lub numeryczny. Wyświetlenie w tym trybie ciągu znaków ASCII, takiego jak „Hello”, może spowodować wyświetlenie na urządzeniu jego reprezentacji numerycznej/bajtowej.
  - **Dane wejściowe**: Brak.
  - **Wyniki**: Wywołuje zdarzenie `OperationStatus`.
- **Ustaw tryb animacji**:
  - **Opis**: Zmienia wzór animacji światełek na urządzeniu PTL.
  - **Dane wejściowe**:
    - `animationMode`: Identyfikator żądanej animacji (np. „Flash”, „Pulse”, „Scroll” lub konkretny kod).
  - **Wyjścia**: Wywołuje zdarzenie `OperationStatus`. Wizualne potwierdzenie zmiany animacji na urządzeniu PTL.
- **Odłączanie / wyrejestrowanie**:
  - **Opis**: (Zakładając, że istnieje funkcja zwalniająca urządzenie) Odłącza lub wyrejestrowuje urządzenie PTL ze sterownika.
  - **Dane wejściowe**: `deviceID` (opcjonalnie, w przypadku zarządzania wieloma urządzeniami).
  - **Wyniki**: Stan odłączenia (wywołuje zdarzenie `OperationStatus` ).

### Zdarzenia

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

- **Błąd**:
  - **Opis**: Wskazuje problem ze sterownikiem, komunikacją lub urządzeniem.
  - **Dane**: Zawierają `komunikat` opisujący błąd.
- **OperationStatus**:
  - **Opis**: Wskazuje wynik wykonanego polecenia (np. „Register RTU”, „Set Color”, „Write Input String”).
  - **Dane**:
    - `polecenie`: Nazwa funkcji, która została wykonana (np. „RegisterRTU”, „SetColor1”).
    - `status`: „success” lub „failure”.
    - `komunikat`: Dodatkowe informacje dotyczące wyniku operacji.

---