Различия

Здесь показаны различия между двумя версиями данной страницы.

--- doc:pos:hardware:hwbridge [15.06.2015 14:23]
rlysov
+++ doc:pos:hardware:hwbridge [13.12.2023 17:28] (текущий)
amalchenko
@@ Строка 1: / Строка 1: @@
 ====== Установка VirtualPos Hardware Bridge ======
-VirtualPos Hardware Bridge - это программа, которая позволяет веб-приложению VirtualPos общаться с торговым оборудованием.
+VirtualPos Hardware Bridge - программа позволяет браузеру, в котором запущено "Рабочее место кассира", взаимодействовать с торговым оборудованием.
-===== Инструкция по установке =====
+**Надо установить VirtualPos Hardware Bridge, если:**
+  * необходимо печатать чеки на фискальном регистраторе или принтере чеков в автоматическом режиме
+  * необходимо отображать информацию о покупке на дисплее покупателя
+  * необходимо использовать банковский терминал для приема карт
+Т.к. VirtualPos Hardware Bridge работает совместно с драйвером производителя, то для нормальной работы необходимо сначала установить "родной" драйвер оборудования.
+**Не надо устанавливать VirtualPos Hardware Bridge, если:**
+  * Вы работаете без фискального регистратора или принтера чеков (режим "Товарных чеков")
+  * Вы используете автономный фискальный регистратор, не подключенный к компьютеру
+  * Вы используете автономный банковский терминал, не подключенный к компьютеру
+===== Инструкция по установке =====
-  * Скачайте и установите VirtualPos Hardware Bridge
+  * Скачайте VirtualPos Hardware Bridge
 <WRAP center round download 60%>
 **Скачать VirtualPos Hardware Bridge**:
-http://core.virtualpos.ru/updates/files/viphwbridge_setup.zip
+[[https://core.virtualpos.ru/updates/files/viphwbridge_setup.zip]]
 </WRAP>
   * Распакуйте архив в любое место и запустите файл setup.exe
+{{:doc:pos:hardware:pasted:20150615-152529.png}}
+{{:doc:pos:hardware:pasted:20150615-152544.png}}
+{{:doc:pos:hardware:pasted:20150615-152554.png}}
+{{:doc:pos:hardware:pasted:20150615-152604.png}}
+  * Если возникнет ошибка о замене файла, например такого вида:
+{{:doc:pos:hardware:pasted:20231213-172451.png}}
+нажмите **Пропустить**
   * Если используется Windows 7 и выше, то после установки необходимо вручную добавить права на запись для папки "C:\Program Files (x86)\VipHWBridge"
-===== Проверка работоспособности VirtualPos Hradware Bridge =====
+  * После установки в меню Windows появится раздел "VirtualPos Hardware Monitor":
+{{:doc:pos:hardware:pasted:20150615-152829.png}}
-Проверьте, что VirtualPos Hardware Bridge установился и готов к работе. Для этого откройте ссылку в браузере: [[http://127.0.0.1:8080/api.php?a=hello]].
+===== Установка Java =====
+Данный пункт требуется выполнять **только** для владельцев кассовых аппаратов **Viki Print**.\\
+Для работы с кассовым аппаратом Viki Print требуется установка Java версии 8. Скачать можно по [[http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html|ссылке]].\\
+Для того чтобы скачать файл, нужно нажать кнопку принять лицензионное соглашение и выбрать версию, соответствующую разрядности вашей операционной системы x86 для 32 битной, x64 для 64 битной. Описание процесса утановки не требуется, лостаточно все время нажимать кнопку **Далее**
-Вы должны увидеть страницу с примерно следующим содержанием: //{"message":"VirtualPOS Hardware Bridge","version":"1","success":true}//
+===== Проверка работоспособности VirtualPos Hardware Bridge =====
+Проверьте, что VirtualPos Hardware Bridge установился и готов к работе. Для этого в меню "Пуск" Windows выберите раздел "Все программы -> VirtualPos Hardware Monitor -> Проверить работу сервиса".
+Если сервис работает нормально, то Вы должны увидеть страницу с примерно следующим содержанием: //{"message":"VirtualPOS Hardware Bridge","version":"1","success":true}//
+{{:doc:pos:hardware:pasted:20150615-153345.png}}
+Проверить работоспособность сервиса можно вручную. Для этого откройте следующую ссылку в любом браузере: [[http://127.0.0.1:8080/api.php?a=hello]]. \\
+Проверить сервис для работы с аппаратами **Viki Print** можно по [[http://127.0.0.1:8081/api.php?a=hello|ссылке]]. Если сервис работает нормально, то Вы должны увидеть страницу с примерно следующим содержанием://{"message":"VirtualPos Hardware Bridge","version":7,"success":true}//
+====== Настройка рабочего места кассира ======
+После установки и проверки "VirtualPos Hardware Bridge" настройте "Рабочее место кассира" для взаимодействия с ним. Для этого:
+  * откройте "Рабочее место кассира"
+  * в левом меню выберите пункт "Параметры"
+  * в графе "Тип фискального рег-ра" выберите модель Вашего оборудования.
+  * В графе "IP-адрес сервера" введите значение: **127.0.0.1** (127.0.0.1:8081 для аппаратов Viki Print) Вариант сетевого использования описан ниже
+  * Укажите корректные настройки СОМ-порта.\\ Узнать COM порт можно следующим образом: для аппаратов АТОЛ и Штрих: зайти в меню запуска приложений (меню пуск), далее в Панель Управления, далее Диспетчер Устройств. Найти вкладку ''Порты (COM и LPT)'' и найти ваше устройство: аппараты АТОЛ называются ''ATOL USB DEVICE'' или ''Atol Fprint USB''; У аппаратов Штрих обыкновенно нет названия, они отображаются как ''Последовательный порт''. COM порт для аппаратов Viki Print сообщается пользователю после установки драйверов на аппарат. Узнать его можно только через утилиту fito.
+  * Дисплей покупателя и банковский терминал настраиваются аналогичным образом
+{{:doc:pos:hardware:pasted:20150615-154109.png}}
+Если вы используете в работе дравера Атол 10-й версии, необходимо выбрать **Атол USB (v.10)**
+{{:doc:pos:hardware:pasted:20210818-112915.png}}
+На этом настройка торгового оборудования завершена.
+----
 ====== Техническая информация для специалистов ======
+В данном разделе описана техническая сторона работы VirtualPos Hardware Bridge.
+===== Принцип работы VirtualPos Hardware Bridge =====
-===== Принцип работы =====
+VirtualPos Hardware Bridge представляет собой небольшой веб-сервер, который устанавливается на компьютер, к которому подключено торговое оборудование.
-VirtualPos Hardware Bridge представляет собой небольшой веб-сервер lighthttpd (http://www.lighttpd.net/), который устанавливается на компьютер, к которому подключено торговое оборудование.
+Этот веб-сервер принимает запросы от веб-браузера, в котором запущено рабочее место кассира. Запросы отправляются по стандартному протоколу http. Полученные запросы преобразуются в вызовы к "родному" драйверу оборудования. Таким образом web-страница может взаимодействовать с локальными устройствами.
-Этот веб-сервер принимает запросы от веб-браузера, в котором запущено рабочее место кассира. Запросы отправляются по стандартному протоколу http посредством технологии ajax. Полученные запросы преобразуются в вызовы к "родному" драйверу оборудования. Таким образом web-страница может взаимодействовать с локальными устройствами.
+===== Работа с VirtualPos Hardware Bridge локально или по сети =====
-===== Решение проблем =====
+VirtualPos Hardware Bridge должен быть установлен на том же компьютере, к которому подключено торговое оборудование. Но использоваться он может на любом устройстве в локальной сети. Это позволяет работать в двух режимах:
+  * **Локальный** - торговое оборудование, VirtualPos Hardware Bridge и браузер с рабочим местом кассира запускаются на одном компьютере. В этом случае в настройках оборудования в рабочем месте кассира в графе "IP-адрес сервера" надо указывать значение: 127.0.0.1
+  * **Сетевой** - торговое оборудование и VirtualPos Hardware Bridge работают на одно компьютере. А браузер с рабочим местом кассира запускается на другом компьютере в той же локальной сети.
+"Сетевой" вариант позволяет запускать рабочее место кассира на планшете с Android или на компьютере с ОС Linux. И, при этом, печатать фискальные чеки на устройствах "АТОЛ" или "ШТРИХ-М", которые подключены к другому компьютеру с ОС Windows.
+Еще один возможный сценарий использования "сетевого режима" - несколько кассовых рабочих мест могут печатать чеки на одном фискальном регистраторе.
-При возникновении проблем необходимо проверить логи работы:
+----
+Для настройки драйвера в сетевом режиме нужно отредактировать файл C:\Program Files (x86)\ViPHWBridge\StartConsole.bat следующим образом:
+<WRAP center round box 60%>
+php -S 0.0.0.0:8080 -t wwwroot
+</WRAP>
+===== Поиск и устранение проблем =====
+Порядок поиска неисправностей:
+  - Убедитесь, что сервис "VirtualPos Hardware Bridge" запущен и работает корректно
+  - Проверьте настройки "Рабочего места кассира", особенно "ip-адрес сервера" и настройки COM-порта
+  - Проверьте работу оборудования с помощью утилит производителя. Убедитесь, что настройки СОМ-порта совпадают с настройками в "Рабочем месте кассира"
+Для диагностики проблем может помочь информация из логов сервиса:
   * VirtualPos Hardware Bridge ведет лог своей работы, который доступен по пути: "C:\Program Files (x86)\ViPHWBridge\wwwroot\logs\YYYYMMDD_hwbridge.log"
   * Лог php: "C:\Program Files (x86)\ViPHWBridge\wwwroot\logs\php.log"
   * Лог веб-сервера lighthttpd: "C:\Program Files (x86)\ViPHWBridge\logs\"
+**
+ВАЖНО!**
+Если на этом же кассовом компьютере планируется использование УТМ от ФСРАР (продажа и приемка алкогольной продукции), то в параметрах конфигурационного файла необходимо поменять порт 8080 на 8093 и перезапустить службу. См. файл **StartConsole** в папке C:\Program Files (x86)\ViPHWBridge. В случае успешной настройки корректность работы сервиса VirtualPos Hardware Bridge нужно проверять по ссылке: http://127.0.0.1:8093/api.php?a=hello
+Параметры порта меняются в файле **C:\Program Files (x86)\ViPHWBridge\StartConsole.bat** следующим образом:
+<WRAP center round box 60%>
+php -S 0.0.0.0:8093 -t wwwroot
+</WRAP>
+====== Ссылки ======
+  * [[doc:pos:hardware:]]
+  * [[doc:pos:hardware:fr_atol]]
+  * [[doc:pos:hardware:fr_shtrih]]
+  * [[doc:pos:hardware:fr_viki]]
+  * [[doc:pos:hardware:diplay]]
+  * [[doc:pos:hardware:barcodereader]]
+  * [[doc:pos:hardware:scales]]
+  * [[doc:pos:]]