Описание

КВП - контрольно-весовая платформа, набор программных и аппаратных средств для защиты касс самообслуживания от краж.

Мастер-касса - основная касса, которая служит для загрузки обновлений и синхронизации данных между другими кассами в группе.

ПО КВП состоит из двух частей: MasterDataBase и SecurityScaleService.

• SecurityScaleService (SSS) устанавливается на каждую кассу с контрольно-весовой платформой.

Место расположения - /home/tc/storage/3rd-party/SecurityScaleService

• MasterDataBase (MDB) устанавливается на только на одну из касс (на мастер-кассу) и служит для синхронизации данных между кассами.

Место расположения - /home/tc/storage/3rd-party/MasterDataBase

Open

Установка

Установка служб

1. Скачайте установочные файлы:

• installSSS-0.1.18.sh

• installMDB-0.1.18.sh

2. Скопируйте скрипты в папку кассы, например: /home/tc/storage/3rd-party

• SecurityScaleService - на каждую кассу.

• MasterDataBase - на одну из касс. Остальные кассы будут подчиненными.

3. Запустите скрипт командой:

SecurityScaleService:

MasterDataBase:

4. После установки службы перезагрузите операционную систему на кассе.

Обновление прошивки контроллера КВП

Подготовка

Скачайте необходимые файлы:

• утилита FlashUpdater.exe

• прошивка 02_41_32_538_pid_5742_Cryst_Serv.hex

Основные шаги

1. Отключите USB-контроллер контрольно-весовой платформы. Перед отключением убедитесь, что контроллер подключен именно к КВП. В новой версии устройства CSI-K на контроллере КВП есть наклейка "КВП" или выполните в консоли linux команду lsusb, контроллер весов КВП должен определиться в системе с ID 0483:5742.

Open

2. Подключите USB-контроллер к ПК с операционной системой Windows 7 или выше.

3. Запустите утилиту FlashUpdater.exe → нажмите кнопку Тестирование, чтобы убедиться, что контроллер определяется – заполнятся поля информации об устройстве.

4. Нажмите кнопку Load File → выберите файл прошивки 02_41_32_538_pid_5742_Cryst_Serv.hex (актуальная для версии SET 10.3.15.0 и выше) → нажмите кнопку Программирование.

5. Дождитесь завершения прошивки → появится диалоговое окно об успешном обновлении.

6. Подключите USB-контроллер обратно.

Настройка

Включение КВП

Чтобы включить работу КВП, установите значение параметра value="modelt" в файле /home/tc/storage/crystal-cash/config/modules/sco-config.xml

Для отключения КВП установите значение параметра value="paystation"

Настройка MasterDataBase

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

Находятся в файле /home/tc/storage/3rd-party/MasterDataBase/config/main.properties

• HOST=127.0.0.1 - локальный IP-адрес, он будет передан на подчиненные кассы.

• CASHES=127.0.0.1\:55556;192.168.0.10\:55556;192.168.0.11\:55556; - IP-адрес:порт подчиненных касс. Можно указать несколько адресов через точку с запятой.

• PORT=55557 - порт для взаимодействия с сервисом.

Настройки MasterDataBase

Находятся в файле /home/tc/storage/3rd-party/MasterDataBase/config/smart.properties

• MAX_DEVIATION_HANDLING_COUNT=10 - количество итераций, в течение которых не будет изменяться вес диапазона.

• ATTEND_DEVIATION_EXTENTION_LIMIT=50 - при подтверждении помощником веса с отклонением до этого значения, диапазон будет расширен. Иначе перемещен.

• MAXIMUM_DELTA_WEIGHT=100 - максимальный предел весового диапазона.

• MINIMUM_DELTA_WEIGHT=5- минимальный предел весового диапазона.

• DEFAULT_DELTA_WEIGHT_PERCENT=3 - погрешность в % от веса товара. Этот параметр работает только для вновь обучаемых товаров. Для тех товаров, у которых уже есть запись в БД, изменение этой настройки не изменит погрешность.

Настройка SecurityScaleService

Находятся в файле /home/tc/storage/3rd-party/SecurityScaleService/config/main.properties

• SYNCRONIZATION_SIZE=2 - размер пакета для синхронизации данных с MDB.

• ARTICLE_NOT_HANDLED_TIMEOUT=120 - таймаут, когда касса сбросит товар из чека, задается в секундах.

• INFO_SERVICE_PORT=8080 - порт для web службы (служебное).

• MAX_BY_PASS_WEIGHT=5 - допустимый вес для легких товаров, иначе товар не принимается.

• SCALE_ERROR=15 - точность весов, суммируется как допустимая погрешность с допуском для каждого товара, задается в граммах.

• SCALE_PLUGIN=MASSAK - модель весов (MASSAK, MTSICS, NCR_FASTLANE).

• ARTICLE_REMINDER_TIMEOUT=5 - таймаут напоминания взвесить товар.

• MAX_TARE_WEIGHT=30  - максимально допустимый вес тары для весовых товаров.

• TARE_DEVIATION=10 - аддитивный допуск для весовых товаров (начиная с версии 0.1.10).

• MIN_TARE_WEIGHT=-10 - минимальный вес тары для весовых товаров.

• MAX_WEIGHT_FOR_SENDING_SET_ZERO=32000 - настройка, от которой зависит какая команда будет отправлена весам для их тарирования. Если значение веса на весах находится в диапазоне от 0 до MAX_WEIGHT_FOR_SENDING_SET_ZERO (включительно), то будет отправлена команда CMD_SET_ZERO, если же значение веса больше MAX_WEIGHT_FOR_SENDING_SET_ZERO - будет отправлена CMD_SET_TARE

• AWAITING_LIST_SIZE=1 - количество одновременно сканируемых товаров от 1 до 3.

• MDB_IP=127.0.0.1\:55557 - адрес MasterDataBase, он меняется автоматически.

• GROUP_ITEM_WEIGHT_DEVIATION=20 - отклонение веса для группы товаров, сканируемых, например, через QR-код. Не учитываются индивидуальные диапазоны товаров, а берётся сумма средних точек всех диапазонов. Эта сумма становится центром группового диапазона, а левая и правая границы отклонения высчитываются как процент этой точки, заданных параметром в процентах.

• DEFAULT_DELTA_WEIGHT_PERCENT=5 - допуск в процентах для весовых товаров, для которых еще нет записи в БД.

• VALIDATE_DATABASE=true - создавать новую БД, если ее не существует.

• TRY_TO_TARE_TIME_OUT=10 - время в секундах, в течение которого ждём стабильного веса при тарировании. Если вес не стабилизировался - ошибка тарирования.

• ALLOWED_WEIGHT_DEVIATION=30 - максимальное отклонение веса от нуля, при котором будет выполнена автоматическое тарирование весовой платформы. Функция работает только при закрытом чеке.

• SYNCRONIZATION_PORT=55556 - порт для синхронизации с MasterDataBase, не менять.

• DELTA_WEIGHT_DEVIATION_MULTIPLIER=3 - коэффициент, влияющий на допуск при увеличении кол-ва товара. Чем больше параметр, тем меньше допуск. 0 - допуск не понижается.

• LEGAL_WEIGHT_DEVIATION=30 - допустимое отклонение веса до сканирования сканирования товара.

• MINIMAL_PRODUCT_WEIGHT_TO_ADD=15 - минимальный вес, который КВП ожидает после сканирования товара.

Настройка плагина MASSAK

Плагин используется с весовым модулем Масса-К 32 и 60 кг.

BAUD_RATE=4800 - скорость порта, для весов подключенных по "железному" кому.
WAIT_TIMEOUT=100 - пауза между опросами весов
PORT=/dev/ttyWT - порт весов
USE_BUFFER=false - включает использование буфера (игнорируется нестабильный вес)
BUFFER_SIZE=3 - размер буфера для вычисления среднего веса, чем больше, тем точнее вес, но дольше отклик
WEIGHT_BUFFER_DELTA=10 - точность вычисления среднего веса из буфера

Настройка плагина MTSICS

Плагин используется с контрольными весами DN Spider (КСО Diebold Nixdorf)

Файл /home/tc/storage/3rd-party/SecurityScaleService/config/scalePluginMettlerToledo.properties

WAIT_TIMEOUT=0 - пауза между опросами весов
BUFFER_SIZE=2 - размер буфера весов, чем больше - тем точнее, чем меньше - тем быстрее отклик.
PORT=/dev/ttyS1 - порт весового модуля
WEIGHT_BUFFER_DELTA=15 - точность вычисления среднего веса из буфера

Настройка плагина NCR_FASTLANE

Плагин работает с контрольно-весовой платформой NCR R5, R6Lite

Файл /home/tc/storage/3rd-party/SecurityScaleService/config/scalePluginNcrFastLane.properties

PRODUCT_ID=0x0225 и VENDOR_ID=0x0404 - указываются в шестнадцатеричном формате. Значение зависит от ревизии весового контроллера. Посмотреть список доступных usb устройств можно командой lsusb в консоли linux.

WAIT_TIMEOUT=250 - пауза между опросами, в миллисекундах.

BUFFER_SIZE=2 - размер фильтрующего буфера, по которому определяется средний вес с весов. Чем больше, тем точнее вес, но дольше длится опрос.

WEIGHT_BUFFER_DELTA=16 - точность вычисления веса.

CALIBRATION_COEFFICIENT=0.1 - коэффициент, который используется для пересчёта сырых данных с весов в граммы по формуле "weight (gramm) = scale_data * calibration_coefficient". Индивидуальный для каждой инсталляции весов.

Копирование весовой базы данных из одного магазина в другой

1. Подключитесь к кассе, на которой есть заполненная весовая база данных → выполните команду для создания резервной копии базы данных mdb.

2. Перейдите в папку /home/tc/storage → скачайте файл mdb.dump.

3. Загрузите файл mdb.dump в папку /home/tc/storage на мастер-кассу в новом магазине.

4. Подключитесь к мастер-кассе в новом магазине → выполните команды для восстановления весовой базы из резервной копии.

Мастер-касса автоматически синхронизирует данные между остальными кассами в магазине. Время синхронизации зависит от объема данных.

Обновление ПО

Версия 0.1.23

1. Обновите прошивку весового модуля по инструкции (локально на кассе) до версии 02_41_32 (если версия еще не обновлена).

   1. файл прошивки 02_41_32_538_pid_5742_Cryst_Serv.hex

2. Установите службы или обновите до последней версии:

   1. MasterDataBase: ;

   2. SecurityScaleService: ;

   3. wcs web install: .

Все версии служб.

Для весовых служб можно использовать параметры-модификаторы для установки и обновления.

Два варианта их использования:

1. как параметр, с которым запускается инсталлятор
   например installSSS.sh dn

2. как параметр, прописанный в теле инсталлятора
   например modifiers="fix" # параметры-модификаторы через пробел

Параметры запуска installMDB:

• fix - настройки службы будут приведены к рекомендуемым, допуски товаров в весовой БД будут скорректированы к рекомендуемым;

• update - будет обновлена только ранее установленная служба (проверка по наличию файлов и запущенному процессу).

Параметры запуска installSSS:

• fix - настройки службы будут приведены к рекомендуемым;

• dn - при первичной установке будет установлен весовой модуль DN;

• ncr - при первичной установке будет установлен весовой модуль NCR;

• update - будет обновлена только ранее установленная служба (проверка по наличию файлов и запущенному процессу).

Изменения в версиях

0.1.23

• [SCOC-1366] КВП. Обновление Legal_weight при скане товара.

• [SCOC-1368] КВП. Случайный отрицательный вес после скана товара создает ошибку.

• [SCOC-1370] КВП. Разрешить скан товара при нестабильном весе.

• [SCOC-1239] SetSCO не синхронизируется БД, между MDB и SCO