Cenaly Hardware Bridge — хардуер на обекта

Браузърът сам по себе си не може да печата касови бележки на POS принтер, да отваря чекмедже за пари или да чете тегло от везна. Тази задача се решава от Cenaly Hardware Bridge — малко безплатно приложение, което се инсталира на компютъра на касата, работи във фонов режим и свързва страницата на админ панела/касата с локалния хардуер на обекта.

Отворете: Админ панел → Хардуер (admin.cenaly.com).

Какво се свързва#

Опашка за печат#

Печатът през моста не е „изпрати и се надявай“. Мостът има собствена опашка от задачи с повторения, която преживява рестартиране: ако принтерът е изключен или хартията е свършила, задачата не се губи и ще се отпечата, когато устройството се съживи.

Заради това печатът има пет различни изхода, а не „успя/не успя“: отпечатано, прието в опашката (още няма хартия!), отпечатано от браузъра, печата фискалната каса (вижте по-долу) и не е отпечатано. В заглавната лента на касата се вижда индикатор на опашката с броя на чакащите задачи.

Задачите са идемпотентни: повторното изпращане на същия документ не дава втора хартия.

Фискалният регистратор не е резервен принтер за касови бележки. Ако на обекта няма отделен принтер за касови бележки, мостът НЕ може да отпечата нашата касова бележка през фискалната каса: фискалната касова бележка тя печата сама, а нашият документ е друга хартия. Касата в такава ситуация казва точно това: „касовата бележка се печата от самата фискална каса“. През регистратора са разрешени само тестов печат и предварителна сметка — и върху тях се отпечатва отметка, че това не е фискален документ.

Подробности, привързване на принтери към станции и кодови страници за кирилица и грузински — Печат в кухнята и в залата.

Инсталиране на моста#

Ако мостът не бъде намерен на този компютър, страницата ще предложи да го инсталирате:

1. Изтеглете версията за вашата операционна система — Windows, Linux (x64) или Linux (ARM64) (macOS — в плановете). За проверка е указан SHA-256.
2. Стартирайте приложението. Windows — двойно щракване: мостът отива във фонов режим (икона в системния трей) и отваря страницата за състояние. Linux — по-надеждно е веднага да го инсталирате като фонова услуга с един ред от страницата „Хардуер“ (curl … | sudo … bash): тя стартира при зареждане на компютъра и се рестартира сама. Ръчното стартиране на изтегления файл (chmod +x и стартиране) също работи, но мостът живее само докато терминалът е отворен и след рестартиране няма да се върне; страницата за състояние на Linux отваряйте сами — http://127.0.0.1:9100.
3. Уверете се на страницата за състояние, че мостът работи. Отворете админ панела на същия компютър, изберете нужния обект и раздел „Хардуер“: браузърът се свързва автоматично.
4. Върнете се в админ панела и натиснете „Търси отново“ — касата сама ще намери моста на този компютър и ще се свърже.

Ако Windows показва предупреждение при изтегляне/стартиране — това е очаквано: изберете „Запази“, а при стартиране „Повече информация“ → „Изпълни във всеки случай“. За Linux има инсталация с един ред като фонова услуга.

Как да премахнете моста от компютъра (Linux). Със същия един ред от страницата „Хардуер“, само с подкоманда — на страницата той е скрит под „Linux — спиране или премахване на моста“:

• … | sudo bash -s -- stop — спира услугата и я премахва от автстарт; файловете и настройките остават, включване обратно — start;
• … | sudo bash -s -- uninstall — премахва услугата и изтрива самата програма. Настройките и връзката на касата остават, и скриптът отпечатва къде се намират;
• … | sudo bash -s -- uninstall --purge — същото плюс настройките: списъка с хардуер и връзката към обекта. След това касата ще трябва да се свърже наново;
• … | sudo bash -s -- status — работи ли мостът и на кой адрес (ако 9100 е зает, мостът взема следващия свободен, до 9109).

На Windows за това има обичайното „Програми и компоненти“ (запис „Cenaly Bridge“) — деинсталаторът премахва и автстарта.

Мост на компютър, където админ панелът не се отваря (сървър в складово помещение, отделен компютър при принтерите) не може да се свърже с автоматично търсене — автоматичното свързване работи само между моста и страницата на касата на същия компютър. За такъв случай собственикът издава в админ панела еднократен код за свързване (живее 15 минути) и го въвежда на страницата за състояние на моста.

Мостът е обвързан с вашия бранд: изтеглен от чужд брандиран домейн, той няма да обслужва вашия админ панел, а ако мостът вече е свързан към друг обект на същия собственик, страницата ще покаже това и ще предложи да го свърже тук с един бутон.

Три начина за свързване#

Кодът за вход на служител от раздел „Устройства“ е отделен механизъм. Ако PIN или кодът е изтекъл, създайте нов със съответния бутон.

Управление и проверки#

Когато мостът е свързан, на страницата се вижда:

• Устройства — списък със състоянието на всяко (свързано / внимание / грешка / не е намерено);
• Проверка на хардуера — бърз тест на печат, сканиране, тегло;
• Настройки на хардуера;
• Активност — лента със събития (сканиране, тегло, печат) в реално време;
• Обновяване — ако е излязла нова версия на моста, тя може да се инсталира направо оттук.

При добавяне на принтер изберете неговото предназначение: касов, кухненски или за етикети. Ролята се вижда в картата на устройството. Тя задава предназначението вътре в моста; разпределението на хардуера между отделните работни места е друго ниво на настройка. Ако четенето на настройките не успее, съветникът ще предложи да опитате отново и ще запази съществуващия списък.

Намереният хардуер може да се изключи или изтрие. „Изключване“ оставя устройството в списъка с всички настройки, но драйверът не се вдига: COM портът е свободен, няма опит, ролята се дава на друго устройство — включва се обратно с един бутон. „Изтриване“ (под потвърждение) премахва устройството завинаги и автоматичното прихващане на познат хардуер вече няма да го върне при следващото стартиране на моста. Хардуер, който е бил настроен по-рано, а сега търсенето не го вижда, се показва в отделна група — иначе нямаше с какво да се управлява.

Мостове на акаунт може да има няколко, и на всеки се задава роля: универсален, хардуер, камери или телефония. Мостовете на обекта са изброени в отделен списък — те могат да се преименуват и да се зададе мост по подразбиране.

Хардуер на целия акаунт и работа от облака#

Освен моста „на този компютър“ на страницата има регистър на хардуера на акаунта — насквозь таблица на всички мостове, устройства и камери по всички обекти в мрежата: вижда се какво къде стои, онлайн ли е мостът, на кои обекти обслужва хардуер. Едно устройство може да се премести в друг обект, ако мостът в този момент е онлайн; при офлайн мост регистърът само показва, но не променя.

За всяка машина в регистъра се разгъва карта „Детайли на компютъра“: име на компютъра, IP и MAC, система, модел, процесор, памет по слотове, накопители със свободно място и състояние, целият свързан хардуер и всички COM портове — с отбелязване кой порт от кого е зает и кой е свободен. Това е първото място, където си струва да погледнете, когато „принтерът беше там, а сега не се вижда“ или на касовия компютър свършва мястото. Данните се събират от самия мост; при стара версия на моста списъкът с хардуер може да е празен — тогава е достатъчно да обновите моста.

Освен локалния канал (браузър ↔ мост на този компютър) има и облачен: командата отива към моста през сървъра, затова може да отпечатате касова бележка или да проверите принтер от друго устройство — например сервитьор от телефона си печата на касовия принтер зад щанда. На страницата това се вижда като „облачна връзка“ при моста и отделен бутон за облачен тестов печат.

Печат на принтер на съседен компютър. Ако принтерът е физически свързан към друг компютър, не е задължително да го „споделяте“ по мрежата или да опъвате кабел. Действието „Печат от друг компютър“ в регистъра създава на тази машина връзка към чуждия принтер: избират се компютърът собственик, обектът и името, след което редът е отбелязан „през облака → компютър собственик“, а задачите се печатат от опашката на онзи компютър. Обща папка, VPN и пряка видимост между машините не са нужни — достатъчно е двата моста да обслужват един и същ обект.

Отдалечен екран на касата. От същата страница (и по покана от работния чат) може да погледнете екрана на касовия компютър — например за да видите с очите си какво показва касата. Решава винаги другата страна: докато нейният собственик не включи отдалечен достъп при себе си, бутон за свързване няма, а всяка сесия изисква отделното му съгласие — „повече да не пита“ няма нарочно. Гледането и управлението са две различни разрешения, а затварянето на прозореца гарантирано прекратява сесията.

Свързани раздели#

• Каса (POS) — къде се използват печат на касови бележки и чекмедже за пари
• Касови бележки и връщания — печат и повторение на касови бележки
• Фискализация — фискални принтери и онлайн каси
• Печат в кухнята и в залата — станции, стикери, опашка и кодови страници
• Стоки на тегло и етикети — работа с везни, мерни единици и етикети за рафта
• Хардуер: какво се свързва — преглед на класовете желязо и минимални комплекти по формати
• Телефония: собствена АТС — телефоните и шлюзовете не изискват мост за хардуер и живеят в свой контур
• Контрол на загубите — видеоклипове на опасни операции от камерата на моста

Често задавани въпроси#

Трябва ли да се въвежда код за свързване?#

Обикновено не: мостът се стартира на същия компютър, където се отваря касата, и тя го намира сама с бутона „Търси отново“. Код е нужен само за мост на компютър, където не се отваря админ панелът — тогава собственикът издава еднократен код и го въвежда на страницата на моста.

На какви операционни системи работи мостът?#

Windows и Linux (x64 и ARM64). Версия за macOS е в плановете.

Хардуерът не се вижда — какво да проверите?#

Уверете се, че мостът е стартиран (страница за състояние), и натиснете „Търси отново“. Състоянието на всяко устройство и бързите проверки са достъпни на страницата „Хардуер“. Ако устройството не се появи, отворете в регистъра на хардуера картата „Детайли на компютъра“ на тази машина: там се вижда целият хардуер, който самият компютър вижда, и всички COM портове с отбелязване кой заема порта — това обикновено е достатъчно, за да се разбере дали проблемът е в кабела, в порта или в чужда програма, която държи порта.