Различия

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

Ссылка на это сравнение

Предыдущая версия справа и слева Предыдущая версия
Следующая версия
Предыдущая версия
doc:pos:hardware:hwbridge [15.06.2015 15:21]
rlysov
doc:pos:hardware:hwbridge [13.12.2023 17:28] (текущий)
amalchenko
Строка 1: Строка 1:
 ====== Установка VirtualPos Hardware Bridge ====== ====== Установка VirtualPos Hardware Bridge ======
  
-VirtualPos Hardware Bridge - это ​программа, которая ​позволяет веб-приложению VirtualPos ​общаться с торговым оборудованием. ​+VirtualPos Hardware Bridge - программа позволяет ​браузеру, ​в котором запущено "Рабочее место кассира", взаимодействовать с торговым оборудованием. ​
  
-Вам ​**надо** установить VirtualPos Hardware Bridge, если: +**Надо установить VirtualPos Hardware Bridge, если:** 
-  * необходимо печатать чеки на фискальным регистратором (принтере чековв автоматическом режиме+  * необходимо печатать чеки на фискальном регистраторе или ​принтере чеков в автоматическом режиме
   * необходимо отображать информацию о покупке на дисплее покупателя   * необходимо отображать информацию о покупке на дисплее покупателя
   * необходимо использовать банковский терминал для приема карт   * необходимо использовать банковский терминал для приема карт
Строка 10: Строка 10:
 Т.к. VirtualPos Hardware Bridge работает совместно с драйвером производителя,​ то для нормальной работы необходимо сначала установить "​родной"​ драйвер оборудования. Т.к. VirtualPos Hardware Bridge работает совместно с драйвером производителя,​ то для нормальной работы необходимо сначала установить "​родной"​ драйвер оборудования.
  
-Установить VirtualPos Hardware Bridge ​**не надо**, если: +**Не надо устанавливать VirtualPos Hardware Bridge, если:** 
-  * Вы работаете без фискального регистратора или принтера чеков+  * Вы работаете без фискального регистратора или принтера чеков ​(режим "​Товарных чеков"​)
   * Вы используете автономный фискальный регистратор,​ не подключенный к компьютеру   * Вы используете автономный фискальный регистратор,​ не подключенный к компьютеру
   * Вы используете автономный банковский терминал,​ не подключенный к компьютеру   * Вы используете автономный банковский терминал,​ не подключенный к компьютеру
Строка 18: Строка 18:
 ===== Инструкция по установке ===== ===== Инструкция по установке =====
  
-  * Скачайте и установите VirtualPos Hardware Bridge+  * Скачайте VirtualPos Hardware Bridge
 <WRAP center round download 60%> <WRAP center round download 60%>
 **Скачать VirtualPos Hardware Bridge**: **Скачать VirtualPos Hardware Bridge**:
  
-http://​core.virtualpos.ru/​updates/​files/​viphwbridge_setup.zip+[[https://​core.virtualpos.ru/​updates/​files/​viphwbridge_setup.zip]]
 </​WRAP>​ </​WRAP>​
    
   * Распакуйте архив в любое место и запустите файл setup.exe   * Распакуйте архив в любое место и запустите файл 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"​   * Если используется Windows 7 и выше, то после установки необходимо вручную добавить права на запись для папки "​C:​\Program Files (x86)\VipHWBridge"​
  
 +  * После установки в меню Windows появится раздел "​VirtualPos Hardware Monitor":​
  
-===== Проверка работоспособности VirtualPos Hradware Bridge =====+{{:​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/​), который устанавливается на компьютер,​ к которому подключено торговое оборудование. ​+VirtualPos Hardware Bridge представляет собой небольшой веб-сервер,​ который устанавливается на компьютер,​ к которому подключено торговое оборудование. ​
  
-Этот веб-сервер принимает запросы от веб-браузера,​ в котором запущено рабочее место кассира. Запросы отправляются по стандартному протоколу http посредством технологии ajax. Полученные запросы преобразуются в вызовы к "​родному"​ драйверу оборудования. Таким образом web-страница может взаимодействовать с локальными устройствами.+Этот веб-сервер принимает запросы от веб-браузера,​ в котором запущено рабочее место кассира. Запросы отправляются по стандартному протоколу http. Полученные запросы преобразуются в вызовы к "​родному"​ драйверу оборудования. Таким образом web-страница может взаимодействовать с локальными устройствами.
  
-===== Работа с VirtualPos Hardware Bridge по сети =====+===== Работа с VirtualPos Hardware Bridge ​локально или ​по сети =====
  
 VirtualPos Hardware Bridge должен быть установлен на том же компьютере,​ к которому подключено торговое оборудование. Но использоваться он может на любом устройстве в локальной сети. Это позволяет работать в двух режимах:​ VirtualPos Hardware Bridge должен быть установлен на том же компьютере,​ к которому подключено торговое оборудование. Но использоваться он может на любом устройстве в локальной сети. Это позволяет работать в двух режимах:​
Строка 51: Строка 99:
    
 "​Сетевой"​ вариант позволяет запускать рабочее место кассира на планшете с Android или на компьютере с ОС Linux. И, при этом, печатать фискальные чеки на устройствах "​АТОЛ"​ или "​ШТРИХ-М",​ которые подключены к другому компьютеру с ОС Windows. ​ "​Сетевой"​ вариант позволяет запускать рабочее место кассира на планшете с 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" ​   * VirtualPos Hardware Bridge ведет лог своей работы,​ который доступен по пути: "​C:​\Program Files (x86)\ViPHWBridge\wwwroot\logs\YYYYMMDD_hwbridge.log" ​
   * Лог php: "​C:​\Program Files (x86)\ViPHWBridge\wwwroot\logs\php.log" ​   * Лог php: "​C:​\Program Files (x86)\ViPHWBridge\wwwroot\logs\php.log" ​
   * Лог веб-сервера lighthttpd: "​C:​\Program Files (x86)\ViPHWBridge\logs\" ​   * Лог веб-сервера 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:​]] ​