Основная информация

Важно: С июля 2011 года аппаратные контролеры BERG-KDS заменены на программное решение bergsvc.exe.


Для подключения и использования общего сетевого ресурса, устройство KDS-BERG при загрузке должно получить от DHCP-сервера рабочий адрес DNS-сервера. Если в сети не используется DHCP-сервер, нужно его настроить - либо средстами Windows либо с помощью сторонних утилит (пример бесплатного DHCP-сервера Tftpd32  http://tftpd32.jounin.net/)


Важно: Для возможности подключения сетевого ресурса на устройстве BERG-KDS (см. ниже) сервер DHCP должен поддерживать службу WINS.

Устройство "KDS-BERG" представляет универсальный контролер, который не содержит никакого установленного ПО (кроме самой прошивки) - функционал устройства полностью определяется образом, загружаемым на устройство по сети. Образ  - это бинарный файл на базе Windows CE и установленным дополнительным ПО.



Важно: Согласно лицензионной политике Microsoft каждый образ на базе Windows CE должен быть "подписан". Кроме того, каждый образ "привязан" к контроллеру и не может быть использован на другом устройстве (при попытке загрузить образ на несоответствующее устройство на экране будет виден красный квадрат в левом верхнем углу). Поэтому на фтп нет доступных для загрузки образов - их можно получить индивидуально после приобретения устройства.


Определение идентификатора устройства

Идентификатор устройства требуется для настройки загрузчика образов BootImpLoader.exe (см. ниже). Узнать его можно 2-я способами:

  1. Подключить к устройству стандартный монитор и после включения найти на экране строку типа KDSXXXXXXXXXXXX (например, KDS005A8000010F).
  2. Убедиться, что в локальной сети нет других включенных устройств, далее запустить утилиту BootImpLoader.exe с ключем -d (конфигурационный файл boots.cfg может быть пустым) и включить устройство (с обязательным подключением к локальной сети) - в окне BootImpLoader.exe появятся строки типа 15.52.39.034  Undef device name KDSXXXXXXXXXXXX, где KDSXXXXXXXXXXXX и есть искомый идентификатор устройства.




Примечание: Для успешной инициализации устройства требуется наличие в локальной сети DHCP-сервера (см. выше).


Загрузка образа

Для передачи образа на устройство используется утилита BootImpLoader.exe.


Важно: Загружаемый образ не сохраняется в памяти устройства (сохраняются только настройки, сделанные с помощью BerMon.exe).  Поэтому утилита  BootImpLoader.exe должна быть всегда запущена на сервере для загрузки образа при каждом включении устройства KDS-BERG - рекомендуется устанавливать утилиту в качестве сервиса с помощью команды BootImpLoader.exe -install.


Возможные параметры запуска BootImpLoader.exe:

BootImpLoader -install - установка сервиса
BootImpLoader -remove  - удаление сервиса
BootImpLoader -d       - запуск утилиты в качестве консоли с выводом сервисных сообщений

В конфигурационном файле boots.cfg прописываются строки вида:

KDSXXXXXXXXXXXX->IMAGE.BIN

- где:

  • KDSXXXXXXXXXXXX - уникальный идентификатор устройства (как определить, см выше)
  • IMAGE.BIN - имя образа для передачи на указанное устройство


Примечание: Каждая строка в файле boots.cfg должна заканчиваться символом "перевод строки" ("Enter")

Запуск утилиты BootImpLoader.exe возможен в качестве приложения (требуется ключ -d: BootImpLoader.exe -d) либо в качестве сервиса (установка сервиса с помощью ключа -install: BootImpLoader.exe -install).

После запуска BootImpLoader.exe с настроенным boots.cfg в окне утилиты будет строка следующего вида:

15.55.27.286  N item image list has been read.

- где N - кол-во устройств, прописанных в boots.cfg.
 
Успешная загрузка образа на устройство сопровождается следующими строками в окне BootImpLoader.exe:

Start Boot Image Server. v 1.02 (13.03.2009)
15.55.27.286  1 item image list has been read.
15.55.44.070  Start image transmitting to Dev KDS005A8000010F IP 192.168.120.121
    

  15.55.47.365  package lost
15.55.52.782  Image has been transmited





Примечание: Строка вида 15.55.47.365  package lost не является ошибкой .


После успешной загрузки образа можно переходить к настройке программной части устройства.


Программная настройка

Для настройки программной части устройства KDS-BERG используется утилита BerMon.exe.

Если устройство инициализировалось и образ был загружен успешно, после запуска BerMon.exe оно будет доступно через пункт меню File ->Station, далее подпункт с IP-адресом устройства.

После выбора конкретного устройства на экране отображается окно с тремя закладками: Parameters, Log, Win error:



На закладке Parameters определяются следующие параметры устройства:

  • Port - определяет, какой RS232-порт устройства KDS-BERG будет использоваться для подключения к блоку управления Berg
  • Exchange path - общий сетевой ресурс, который используется для обмена информацией между R-Keeper v6 и устройством KDS-BERG
  • User Name - имя пользователя для подключения общего сетевого ресурса (может быть пустым)
  • Password - пароль пользователя для подключения общего сетевого ресурса (может быть пустым)


Важно: Для возможности подключения сетевого ресурса на устройстве BERG-KDS сервер DHCP должен поддерживать службу WINS.

После заполнения параметров необходимо нажать кнопку Send - при успешной записи будет выдано соотв. сообщение.

Примечание: Параметры устройства KDS-BERG сохраняются в энергонезависимой памяти и будут считываться при каждом включении устройства.

На закладке Log можно наблюдать результат работы устройства, в том числе запись параметров:



На закладке Win error можно получить описание стандартных ошибок Windows по их коду (в случае возникновения ошибки Windows их номер будет указан на закладке Log):



Подключение устройства "BERG-KDS" к блоку управления розлива "BERG" 

Примечание: Подключение происходит через интерфейс RS232 с помощью нуль-модемного кабеля.


На устройстве "KDS-BERG" есть два порта RS232, выполненных в виде 6-ти пиновых разъемов. Нумерация портов считается от разъема Ethernet RJ45 (тот, который ближе в разъему Ethernet RJ45 является COM1,который ближе к разъемам USB - COM2)




Важно: Рекомендуется подключать устройство через COM2 (в случае подключения через COM1 может наблюдаться нестабильная работа либо отсутствие связи).


Для подключения нуль-модемного кабеля в порт устройства KDS-BERG требуется изготовление переходника с разъема RJ на DB9 (может быть в комплекте):


Схема переходника RJ 6-pin (KDS-BERG) -> RS232 (DB9 "папа")Link to Схема переходника RJ 6-pin (KDS-BERG) -> RS232 (DB9 "папа")

Разъем RJ (6-pin)Разъем DB9 ("папа")
 2 2
 3 3
 5 5


Примечание: Номера пинов в разъеме RJ считаются слева-направо, если смотреть на разъем сверху.


Проверка работоспособности

Для возможности розлива алкоголя, соотв. блюдо сперва должно быть добавлено в заказ. После добавления блюд(а) и сохранения заказа, кассовый сервер формирует текстовые файлы с расширением *.otx и записывает их в директорию, указанную в параметре BergPath  - сформированный файл содержит информацию о коде блюда, его кол-ве и другую служебную информацию.

Дальнейшую обработку выполняет устройство "KDS-BERG" - оно пытается считать файлы из директории обмена и сообщить блоку управления Berg коды блюд (напитков), разрешенных для розлива.


Важно: Обязательным условием для работы интеграции является соответствие кодов блюд R-Keeper и кодов, присвоенных соотв. электронным дозаторам.


После обработки файла *.otx, он удаляется из директории обмена. Лог работы устройства "KDS-BERG" можно наблюдать с помощью утилиты Bermon.exe (закладка Log после подключении к конкретному устройству).

Также есть возможность эмулировать работу блока управления "Berg" с помощью утилиты BergEmu.exe - это может быть полезным для предварительного тестирования работоспособности системы интеграции без наличия блока управления "Berg".

Для использования эмулятора необходимо подключить устройств "KDS-BERG" с помощью нуль-модемного кабеля в свободный COM-порт компьютера, выполнить инициализацию устройства и загрузку на него образа.

Далее запустить утилиту BergEmu.exe, указать порт компьютера, к которому подключили устройство "KDS-BERG" и нажать кнопку "Open":



Далее, сформировать заказ на кассовой станции и сохранить его. В поле Code утилиты BergEmu.exe указать код блюда, введенного в заказе и нажать кнопку "Send" - в окне утилиты будет отображаться лог обмена информацией:



Некоторые пояснения к сообщениям в логе:

Нет связи с устройством

< 02 31 33 39 39 03 03
Timeout

Блюдо с кодом 2202 запрещено для розлива

< 02 32 32 30 32 03 03
> 15 - запрещено

Блюдо с кодом 2202 разрешено для розлива

< 02 32 32 30 32 03 03
> 06 - разрешено