Cenaly Hardware Bridge — оборудование заведения
Браузер сам по себе не умеет печатать чеки на POS-принтере, открывать денежный ящик или читать вес с весов. Эту задачу решает Cenaly Hardware Bridge — небольшое бесплатное приложение, которое ставится на компьютер кассы, работает в фоне и связывает страницу админки/кассы с локальным оборудованием заведения.
Открыть: Админ-панель → Оборудование (admin.cenaly.ge).
Что подключается#
| Устройство | Для чего |
|---|---|
| Принтер чеков (POS-принтер) | чек продажи и возврата, пречек, X/Z-отчёт, манифест пакета |
| Кухонный принтер | тикеты по станциям и стикеры 60×40 — см. Печать на кухне и в зале |
| Денежный ящик | открытие по продаже и вручную |
| Сканер штрихкодов | приёмка, продажа, маркировка |
| Весы | вес товара при приёмке и вес блюда на раздаче |
| Дисплей покупателя | показать гостю сумму и состав |
| Банковский терминал | оплата картой, сверка итогов и закрытие дня |
| Фискальный регистратор | фискальные чеки по стране — см. Фискализация |
| ЕГАИС (РФ) | обмен с универсальным транспортным модулем |
| Камера | короткие видеоклипы к опасным операциям кассы — см. Контроль потерь |
Очередь печати#
Печать через мост — не «отправил и надейся». У моста своя очередь заданий с повторами, которая переживает перезапуск: если принтер выключили или кончилась бумага, задание не теряется и напечатается, когда устройство оживёт.
Из-за этого у печати пять разных исходов, а не «получилось/не получилось»: напечатано, принято в очередь (бумаги ещё нет!), напечатано браузером, печатает фискальная касса (см. ниже) и не напечатано. В шапке кассы виден индикатор очереди с числом ожидающих заданий.
Задания идемпотентны: повторная отправка того же документа не даёт вторую бумажку.
Фискальный регистратор — не запасной чековый принтер. Если на точке нет отдельного чекового принтера, мост НЕ станет печатать наш чек через фискальную кассу: фискальный чек она печатает сама, а наш документ — это другая бумага. Касса в такой ситуации так и говорит: «чек печатает сама фискальная касса». Через регистратор разрешены только тестовая печать и пречек — и на них печатается пометка, что это не фискальный документ.
Подробности, привязка принтеров к станциям и кодовые страницы для кириллицы и грузинского — Печать на кухне и в зале.
Установка моста#
Если мост не найден на этом ПК, страница предложит его установить:
- Скачайте версию под вашу ОС — Windows, Linux (x64) или Linux (ARM64) (macOS — в планах). Для проверки указан SHA-256.
- Запустите приложение. Windows — двойной клик: мост уходит в фон (значок в трее) и открывает страницу состояния. Linux — надёжнее сразу поставить фоновой службой однострочником со страницы «Оборудование» (
curl … | sudo … bash): она стартует при загрузке ПК и перезапускается сама. Запуск скачанного файла руками (chmod +xи запуск) тоже работает, но мост живёт только пока открыт терминал и после перезагрузки не вернётся; страницу состояния на Linux открывайте сами —http://127.0.0.1:9100. - Убедитесь на странице состояния, что мост запущен. Откройте админку на этом же ПК, выберите нужную точку и раздел «Оборудование»: браузер подключается автоматически.
- Вернитесь в админку и нажмите «Искать снова» — касса сама найдёт мост на этом ПК и подключится.
Если 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») — деинсталлятор убирает и автозапуск.
Пакет для Ubuntu. На Ubuntu 22.04, 24.04 и 26.04 мост ставится ещё и пакетом cenaly-bridge — .deb для amd64 и arm64 со страницы установки или командой curl -fsSL https://cdn.cenaly.com/linux/install.sh | sudo bash -s -- bridge (для аккаунта на cenaly.ru — cdn.cenaly.ru). Пакет подключает репозиторий Cenaly, и мост обновляется вместе с обычными обновлениями Ubuntu; удалить — sudo apt remove cenaly-bridge. Прежняя установка однострочником подхватывается: настройки и привязка остаются, служба одна. Подробно — Установка приложений на Ubuntu.
Мост на компьютере, где админку не открывают (сервер в подсобке, отдельный ПК у принтеров), привязать автопоиском нельзя — автопривязка работает только между мостом и страницей кассы на том же компьютере. Для такого случая владелец выписывает в админке одноразовый код привязки (живёт 15 минут) и вводит его на странице состояния моста.
Мост привязан к вашему бренду: скачанный с чужого брендингового домена он вашу админку обслуживать не будет, а если мост уже привязан к другой точке того же владельца, страница покажет это и предложит перепривязать его сюда одной кнопкой.
Три способа подключения#
| Что подключаете | Что сделать |
|---|---|
| Браузер на ПК с мостом | Открыть нужную точку в «Оборудовании». Локальная пара создаётся автоматически. |
| Мост на другом ПК | Владелец нажимает «Подключить мост на другом компьютере», затем на том ПК вводит код в «Аккаунты и точки → Подключить по коду». Код действует 15 минут. |
| Android-приложение в той же сети | На странице моста открыть «Устройства по Wi-Fi» и нажать «Сопрячь устройство». Ввести PIN в приложении; для доступа к терминалу сверить отпечаток. PIN действует 10 минут. |
Код входа сотрудника из раздела «Устройства» — отдельный механизм. Если PIN или код истёк, создайте новый соответствующей кнопкой.
Управление и проверки#
Когда мост подключён, на странице видно:
- Устройства — список с состоянием каждого (подключено / внимание / ошибка / не найдено);
- Проверка оборудования — быстрый тест печати, сканирования, веса;
- Настройки оборудования;
- Активность — лента событий (скан, вес, печать) в реальном времени;
- Обновление — если вышла новая версия моста, её можно поставить прямо отсюда.
При добавлении принтера выберите его назначение: чековый, кухонный или для этикеток. Роль видна в карточке устройства. Она задаёт назначение внутри моста; распределение оборудования между отдельными рабочими местами — другой уровень настройки. Если чтение настроек не удалось, мастер предложит повторить и сохранит существующий список.
Найденное оборудование можно отключить или удалить. «Отключить» оставляет устройство в списке со всеми настройками, но драйвер не поднимается: COM-порт свободен, опроса нет, роль достаётся другому устройству — включается обратно одной кнопкой. «Удалить» (под подтверждением) убирает устройство насовсем, и автоподхват знакомого оборудования его больше не возвращает при следующем запуске моста. Оборудование, которое настраивали раньше, а сейчас поиск его не видит, показывается отдельной группой — иначе управлять им было бы нечем.
Мостов на аккаунт может быть несколько, и каждому задаётся роль: универсальный, оборудование, камеры или телефония. Мосты точки перечислены отдельным списком — их можно переименовать и назначить мост по умолчанию.
Оборудование всего аккаунта и работа из облака#
Кроме моста «этого компьютера» на странице есть реестр оборудования аккаунта — сквозная таблица всех мостов, устройств и камер по всем точкам сети: видно, что где стоит, онлайн ли мост, каким точкам он обслуживает оборудование. Устройство можно перенести в другую локацию, если мост в этот момент онлайн; у офлайн-моста реестр только показывает, но не меняет.
У каждой машины в реестре раскрывается карточка «Детали ПК»: имя компьютера, IP и MAC, система, модель, процессор, память по слотам, накопители со свободным местом и состоянием, всё подключённое оборудование и все COM-порты — с пометкой, какой порт кем занят, а какой свободен. Это первое, куда стоит заглянуть, когда «принтер был, а теперь его не видно» или на кассовом ПК кончается место. Данные собирает сам мост; у старой версии моста список оборудования может быть пуст — тогда достаточно обновить мост.
Помимо локального канала (браузер ↔ мост на этом ПК) есть облачный: команда уходит мосту через сервер, поэтому напечатать чек или проверить принтер можно с другого устройства — например, официант со своего телефона печатает на кассовый принтер за стойкой. На странице это видно как «облачная привязка» у моста и отдельная кнопка облачной тестовой печати.
Печать на принтер соседнего компьютера. Если принтер физически подключён к другому ПК, его не обязательно «расшаривать» по сети или тянуть кабель. Действие «Печатать с другого ПК» в реестре заводит на этой машине ссылку на чужой принтер: выбираются компьютер-владелец, точка и имя, дальше строка помечена «через облако → ПК-владелец», а задания печатаются очередью того компьютера. Общая папка, VPN и прямая видимость машин не нужны — достаточно, чтобы оба моста обслуживали одну точку.
Удалённый экран кассы. С той же страницы (и по приглашению из рабочего чата) можно посмотреть на экран кассового компьютера — например, чтобы увидеть глазами, что там показывает касса. Решает всегда та сторона: пока её владелец не включил удалённый доступ у себя, кнопки подключения нет, а каждый сеанс требует его отдельного согласия — «больше не спрашивать» нет намеренно. Просмотр и управление — два разных разрешения, а закрытие окна гарантированно завершает сеанс.
Требует внимания и пора обновить: все устройства сети#
Над реестром оборудования стоит блок «⚠️ Требует внимания» — проблемы устройств всех точек аккаунта одним списком, чтобы не обходить точки по очереди. В строке — точка, устройство (и через какой мост оно видно), что случилось и с какого времени. Сверху ошибки, ниже предупреждения; дольше всего сломанное — выше.
В список попадает:
- мост без связи — вместе с ним недоступны его принтеры, касса и весы (у строки написано, сколько устройств за ним);
- принтер, касса, весы с ошибкой, «не подключено» или предупреждением — с текстом причины, как его видит человек у кассы («нет чековой ленты», «принтер не отвечает»);
- камера не на связи и устройство на ПК без рабочего драйвера;
- касса или экран кухни давно не выходили на связь с облаком, а также касса с записями, исход которых неизвестен;
- рекламный экран перестал выходить на связь или сообщает об ошибке показа.
Порог молчания. Устройство, которое замолчало недавно (перезагрузили компьютер, ночь), проблемой не считается: в поле «Молчит дольше, чем» выберите 15 минут, 2 часа (по умолчанию), 12 или 24 часа — выбор запоминается в этом браузере. На живые сообщения моста («ошибка», «не подключено») порог не влияет. Устройство, снятое с работы кнопкой «Отключить», и касса, которая ещё ни разу не выходила на связь, в список не попадают. Фильтры «Ошибки» / «Предупреждения» и выбор точки сужают список.
Вкладка «Пора обновить» показывает версию каждого моста рядом с последней опубликованной: «Актуальна», «Пора обновить» или «Неизвестно». Мосты обновляются сами, пока на связи, — отставший обычно был выключен, когда вышло обновление, или на этом ПК выключено автообновление; тогда откройте страницу моста на том компьютере и нажмите «Обновить» или переустановите мост. Мост старше версии 0.31.0 свою версию облаку не сообщает — он помечен «Старый мост — версию не сообщает». Там же видны рекламные экраны, плеер которых не может перейти на новую сборку.
В той же вкладке — кассы и экраны кухни, подготовленные к работе без интернета. Приложение на Android, Windows и Linux сообщает облаку свою версию, когда выходит на связь (при входе на кассе, при обновлении документов экрана кухни), и сводка сравнивает её с последним выпуском для этой платформы. В строке видно платформу, установленную версию и — если пора обновить — номер последней. Как обновить:
- Android — приложение, установленное с сайта, обновляется само; установленное из Google Play — через Play;
- Windows и Linux — скачайте новую версию со страницы загрузок и установите поверх старой (настройки и данные кассы сохранятся).
Веб-касса и веб-экран кухни помечены «Веб-приложение — обновляется при загрузке страницы» — им ничего делать не нужно. «Старая сборка приложения — версию не сообщает» значит, что на устройстве версия приложения старше той, что умеет сообщать о себе, — обновите её, и строка покажет номер. Касса, которая ни разу не выходила на связь после подготовки, помечена «Ни разу не выходил на связь».
Блок не создаёт новых проверок — он собирает то, что мосты, кассы и экраны уже присылают. Если какая-то точка не ответила, над списком появится «Часть точек не ответила — список может быть неполным».
Связанные разделы#
- Касса (POS) — где используется печать чеков и денежный ящик
- Чеки и возвраты — печать и повтор чеков
- Фискализация — фискальные принтеры и онлайн-кассы
- Печать на кухне и в зале — станции, стикеры, очередь и кодовые страницы
- Весовой товар и этикетки — работа с весами, единицы измерения и этикетки на полку
- Оборудование: что подключается — обзор классов железа и минимальные комплекты по форматам
- Телефония: своя АТС — телефоны и шлюзы моста оборудования не требуют и настраиваются отдельно
- Контроль потерь — видеоклипы опасных операций с камеры моста
Частые вопросы#
Нужно ли вводить код для привязки?#
Обычно нет: мост запускается на том же ПК, где открывают кассу, и она находит его сама по кнопке «Искать снова». Код нужен только для моста на компьютере, где админку не открывают, — тогда владелец выписывает одноразовый код и вводит его на странице моста.
На каких ОС работает мост?#
Windows и Linux (x64 и ARM64). Версия для macOS в планах.
Оборудование не видно — что проверить?#
Убедитесь, что мост запущен (страница состояния), и нажмите «Искать снова». Состояние каждого устройства и быстрые проверки доступны на странице «Оборудование». Если устройство не появилось, откройте в реестре оборудования карточку «Детали ПК» этой машины: там видно всё железо, которое видит сам компьютер, и все COM-порты с пометкой, кем порт занят, — этого обычно хватает, чтобы понять, дело в кабеле, в порте или в чужой программе, которая держит порт.