Cenaly Hardware Bridge — sprzęt lokalu

Przeglądarka sama w sobie nie potrafi drukować paragonów na drukarce POS, otwierać szuflady na pieniądze ani odczytywać wagi z wagi. To zadanie rozwiązuje Cenaly Hardware Bridge — niewielka bezpłatna aplikacja, którą instaluje się na komputerze kasy, działa w tle i łączy stronę panelu administracyjnego/kasy z lokalnym sprzętem lokalu.

Otwórz: Panel administracyjny → Sprzęt (admin.cenaly.com).

Co się podłącza#

Kolejka wydruku#

Druk przez Bridge to nie „wysłałem i licz na szczęście”. Bridge ma własną kolejkę zadań z ponowieniami, która przetrwa restart: jeśli drukarkę wyłączono lub skończył się papier, zadanie nie ginie i wydrukuje się, gdy urządzenie ożyje.

Z tego powodu druk ma pięć różnych wyników, a nie „udało się/nie udało się”: wydrukowano, przyjęto do kolejki (papieru jeszcze nie ma!), wydrukowano przez przeglądarkę, drukuje kasa fiskalna (zob. niżej) i nie wydrukowano. W nagłówku kasy widać wskaźnik kolejki z liczbą oczekujących zadań.

Zadania są idempotentne: ponowne wysłanie tego samego dokumentu nie daje drugiej kartki.

Kasa fiskalna to nie zapasowa drukarka paragonów. Jeśli w placówce nie ma osobnej drukarki paragonów, Bridge NIE zacznie drukować naszego paragonu przez kasę fiskalną: paragon fiskalny drukuje ona sama, a nasz dokument to inny papier. Kasa w takiej sytuacji mówi wprost: „paragon drukuje sama kasa fiskalna”. Przez kasę fiskalną dozwolone są tylko wydruk testowy i precheck — i na nich drukowana jest adnotacja, że to nie dokument fiskalny.

Szczegóły, przypisywanie drukarek do stacji i strony kodowe dla cyrylicy i gruzińskiego — Druk na kuchni i w sali.

Instalacja Bridge#

Jeśli Bridge nie został znaleziony na tym komputerze, strona zaproponuje jego instalację:

1. Pobierz wersję dla swojego systemu — Windows, Linux (x64) lub Linux (ARM64) (macOS — w planach). Do weryfikacji podano SHA-256.
2. Uruchom aplikację. Windows — podwójne kliknięcie: Bridge przechodzi w tło (ikona w zasobniku systemowym) i otwiera stronę stanu. Linux — pewniej od razu zainstalować jako usługę w tle jednym poleceniem ze strony „Sprzęt” (curl … | sudo … bash): uruchamia się przy starcie komputera i restartuje samodzielnie. Ręczne uruchomienie pobranego pliku (chmod +x i uruchomienie) też działa, ale Bridge żyje tylko dopóki otwarty jest terminal i po restarcie nie wróci; stronę stanu na Linux otwórz samodzielnie — http://127.0.0.1:9100.
3. Upewnij się na stronie stanu, że Bridge jest uruchomiony. Otwórz panel administracyjny na tym samym komputerze, wybierz odpowiednią placówkę i sekcję „Sprzęt”: przeglądarka połączy się automatycznie.
4. Wróć do panelu administracyjnego i naciśnij „Szukaj ponownie” — Kasa sama znajdzie Bridge na tym komputerze i połączy się.

Jeśli Windows wyświetla ostrzeżenie przy pobieraniu/uruchamianiu — jest to oczekiwane: wybierz „Zapisz”, a przy uruchamianiu „Więcej informacji” → „Uruchom mimo to”. Dla Linux dostępna jest jednoliniowa instalacja jako usługa w tle.

Jak usunąć Bridge z komputera (Linux). Tym samym jednoliniowym poleceniem ze strony „Sprzęt”, tylko z podkomendą — na stronie jest ukryte pod „Linux — zatrzymaj lub usuń Bridge”:

• … | sudo bash -s -- stop — zatrzymać usługę i wyłączyć ją z autostartu; pliki i ustawienia pozostają, włączyć z powrotem — start;
• … | sudo bash -s -- uninstall — usunąć usługę i odinstalować sam program. Ustawienia i powiązanie Kasy pozostają, a skrypt wypisuje, gdzie się znajdują;
• … | sudo bash -s -- uninstall --purge — to samo plus ustawienia: lista sprzętu i powiązanie z placówką. Po tym Kasa będzie wymagać ponownego powiązania;
• … | sudo bash -s -- status — czy Bridge działa i pod jakim adresem (jeśli 9100 jest zajęty, Bridge zajmuje następny wolny, do 9109).

Na Windows służy do tego zwykłe „Instalowanie i usuwanie programów” (wpis „Cenaly Bridge”) — deinstalator usuwa również autostart.

Bridge na komputerze, na którym nie otwiera się panelu administracyjnego (serwer w zapleczu, osobny komputer przy drukarkach) nie można powiązać autowyszukiwaniem — autopowiązanie działa tylko między Bridge a stroną Kasy na tym samym komputerze. W takim przypadku właściciel wystawia w panelu administracyjnym jednorazowy kod powiązania (ważny 15 minut) i wprowadza go na stronie stanu Bridge.

Bridge jest powiązany z Twoją marką: pobrany z cudzej domeny brandingowej nie będzie obsługiwał Twojego panelu administracyjnego, a jeśli Bridge jest już powiązany z inną placówką tego samego właściciela, strona to pokaże i zaproponuje ponowne powiązanie go tutaj jednym przyciskiem.

Trzy sposoby połączenia#

Kod logowania pracownika z sekcji „Urządzenia” — osobny mechanizm. Jeśli PIN lub kod wygasł, utwórz nowy odpowiednim przyciskiem.

Zarządzanie i weryfikacja#

Gdy Bridge jest podłączony, na stronie widać:

• Urządzenia — lista ze stanem każdego (podłączone / uwaga / błąd / nie znaleziono);
• Test sprzętu — szybki test drukowania, skanowania, wagi;
• Ustawienia sprzętu;
• Aktywność — strumień zdarzeń (skan, waga, drukowanie) w czasie rzeczywistym;
• Aktualizacja — jeśli wyszła nowa wersja Bridge, można ją zainstalować bezpośrednio stąd.

Przy dodawaniu Drukarki wybierz jej przeznaczenie: paragonowa, kuchenna lub do etykiet. Rola jest widoczna w karcie Urządzenia. Określa przeznaczenie wewnątrz Bridge; rozdzielenie sprzętu między poszczególne stanowiska pracy — to inny poziom konfiguracji. Jeśli odczyt ustawień się nie powiódł, kreator zaproponuje powtórzenie i zachowa istniejącą listę.

Znaleziony Sprzęt można wyłączyć lub usunąć. „Wyłączyć” pozostawia Urządzenie na liście ze wszystkimi ustawieniami, ale sterownik nie jest uruchamiany: port COM jest wolny, odpytywania nie ma, rola przypada innemu Urządzeniu — włącza się z powrotem jednym przyciskiem. „Usunąć” (pod potwierdzeniem) usuwa Urządzenie na stałe, a autowykrywanie znanego Sprzętu nie przywróci go przy następnym uruchomieniu Bridge. Sprzęt, który konfigurowano wcześniej, a teraz wyszukiwanie go nie widzi, jest pokazywany w osobnej grupie — inaczej nie byłoby czym zarządzać.

Bridge na Koncie może być kilka, a każdemu przypisuje się rolę: uniwersalny, sprzęt, kamery lub telefonia. Bridge placówki są wymienione w osobnej liście — można je zmienić nazwę i ustawić Bridge domyślny.

Sprzęt całego konta i praca z chmury#

Poza mostem „tego komputera” na stronie znajduje się rejestr sprzętu konta — zbiorcza tabela wszystkich mostów, urządzeń i kamer we wszystkich placówkach sieci: widać, co gdzie stoi, czy most jest online, którym placówkom obsługuje sprzęt. Urządzenie można przenieść do innej lokalizacji, jeśli most jest w tym momencie online; przy moście offline rejestr tylko pokazuje, ale nie zmienia.

Przy każdej maszynie w rejestrze rozwija się karta „Szczegóły komputera”: nazwa komputera, IP i MAC, system, model, procesor, pamięć według slotów, dyski z wolnym miejscem i stanem, cały podłączony sprzęt i wszystkie porty COM — z oznaczeniem, który port jest przez kogo zajęty, a który wolny. To pierwsze miejsce, do którego warto zajrzeć, gdy „drukarka była, a teraz jej nie widać” albo na komputerze kasowym kończy się miejsce. Dane zbiera sam most; przy starej wersji mostu lista sprzętu może być pusta — wtedy wystarczy zaktualizować most.

Oprócz kanału lokalnego (przeglądarka ↔ most na tym PC) jest kanał chmurowy: polecenie trafia do mostu przez serwer, dlatego wydrukować paragon lub sprawdzić drukarkę można z innego urządzenia — na przykład kelner ze swojego telefonu drukuje na drukarkę kasową za barem. Na stronie widać to jako „połączenie chmurowe” przy moście i osobny przycisk chmurowego wydruku testowego.

Druk na drukarce sąsiedniego komputera. Jeśli drukarka jest fizycznie podłączona do innego PC, nie trzeba jej „udostępniać” w sieci ani ciągnąć kabla. Działanie „Drukuj z innego PC” w rejestrze tworzy na tej maszynie odwołanie do cudzej drukarki: wybiera się komputer-właściciela, placówkę i nazwę, dalej wiersz jest oznaczony „przez chmurę → PC-właściciel”, a zadania są drukowane kolejką tamtego komputera. Wspólny folder, VPN i bezpośrednia widoczność maszyn nie są potrzebne — wystarczy, aby oba mosty obsługiwały jedną placówkę.

Zdalny ekran kasy. Z tej samej strony (i przez zaproszenie z czatu roboczego) można spojrzeć na ekran komputera kasowego — na przykład, aby zobaczyć na własne oczy, co pokazuje kasa. Decyduje zawsze druga strona: dopóki jej właściciel nie włączy u siebie zdalnego dostępu, przycisku połączenia nie ma, a każda sesja wymaga jego osobnej zgody — „nie pytaj więcej” celowo nie istnieje. Podgląd i sterowanie to dwa różne uprawnienia, a zamknięcie okna gwarantowanie kończy sesję.

Powiązane sekcje#

• Kasa (POS) — gdzie wykorzystuje się druk paragonów i szufladę na pieniądze
• Paragony i zwroty — druk i ponowny wydruk paragonów
• Fiskalizacja — drukarki fiskalne i kasy online
• Druk w kuchni i na sali — stanowiska, naklejki, kolejka i strony kodowe
• Towar na wagę i etykiety — praca z wagami, jednostki miary i etykiety na półkę
• Sprzęt: co się podłącza — przegląd klas sprzętu i minimalne zestawy według formatów
• Telefonia: własna centrala — telefony i bramy nie wymagają mostu sprzętowego i działają we własnym obwodzie
• Kontrola strat — klipy wideo niebezpiecznych operacji z kamery mostu

Częste pytania#

Czy trzeba wpisywać kod do powiązania?#

Zwykle nie: most uruchamia się na tym samym PC, na którym otwiera się kasę, a ona znajduje go sama przyciskiem „Szukaj ponownie”. Kod jest potrzebny tylko dla mostu na komputerze, na którym nie otwiera się panelu administracyjnego — wtedy właściciel wystawia jednorazowy kod i wpisuje go na stronie mostu.

Na jakich systemach działa most?#

Windows i Linux (x64 i ARM64). Wersja dla macOS jest w planach.

Sprzętu nie widać — co sprawdzić?#

Upewnij się, że most jest uruchomiony (strona stanu), i naciśnij „Szukaj ponownie”. Stan każdego urządzenia i szybkie testy są dostępne na stronie „Sprzęt”. Jeśli urządzenie się nie pojawiło, otwórz w rejestrze sprzętu kartę „Szczegóły komputera” tej maszyny: widać tam cały sprzęt, który widzi sam komputer, i wszystkie porty COM z oznaczeniem, przez kogo port jest zajęty — to zwykle wystarcza, aby zrozumieć, czy problem tkwi w kablu, w porcie czy w cudzym programie, który trzyma port.