BVSControl

Поддерживаемые устройства

  • DORS PMU-820 (все модели);

  • DORS 210BA (все модели);

  • DORS 820 (все модели);

  • DORS 200;

  • DORS 200М1;

  • DORS 230М1;

  • DORS 230М2.

Установка и удаление ПО

BVSControl является портативным ПО и не требует установки. Достаточно скопировать папку DBA на локальный компьютер. Пакет поставки ПО включает в себя:

  1. Ядро ATMCheck: файлы BvsControl.exe, LocalizationStorage.dll, mfc120.dll, mfc120u.dll, sqlite.dll.

  2. Динамические библиотеки времени исполнения C++: msvcp120.dll и msvcr120.dll.

  3. Файл базы данных перевода rus.db3.

В папке DBA\RUS находится русскоязычная версия BVSControl, в папке DBA\ENG – англоязычная.

Чтобы удалить программу удалите папку DBA.

Внимание

Если запущено приложение BVS Update, то перед запуском BVSControl закройте его (основное окно и в области уведомлений).

Окно BVSControl

../_images/main_window.png

Рисунок 1. Окно BVSControl. Устройство не включено

  • Кнопка Выберите прошивку – выбрать файл прошивки.

  • Кнопка INFO – получить информацию об устройстве.

  • Кнопка POWER UP (только для DORS PMU-820) – включить устройство. Кнопка отображается, если устройство выключено и при запуске BvsControl. Кнопка блокируется на время установки прошивки.

  • Кнопка SHUTDOWN (только для DORS PMU-820) – выключить устройство. Кнопка появляется в окне BVSControl при включении устройства. Кнопка блокируется на время установки прошивки.

  • Кнопка Обновить – установить выбранную прошивку.

  • Флаг Перезаписать (только для DORS 820 и DORS PMU-820) – переустановить прошивку, если выбранная версия прошивки совпадает с уже установленной, то по нажатию кнопки Обновить удалить предыдущую прошивку с устройства и вместо нее установить новую с тем же номером версии. По умолчанию данный флаг установлен.

Цифрами на рисунке обозначены:

  1. Поле для вывода информации об устройстве и других сообщений.

  2. Индикатор выполнения операции, который показывает ход обновления прошивки.

Обновление прошивки устройства

Прошивку устройства можно обновить двумя способами:

  1. В интерактивном режиме – в графическом интерфейсе BVSControl.

  2. В «тихом» режиме – запустить BVSControl в командной строке.

Интерактивный режим

Внимание

Выключайте DORS 200 и DORS 200М1 перед обновлением прошивки.
Для обновления DORS 200 в ОС Windows 7 и Windows 10 и DORS 200M1 в ОС Windows 7 необходим программатор.

  1. Проверьте, что устройство подключено и готово к обновлению, нажав кнопку INFO.

  2. Нажмите кнопку Выберите прошивку. В открывшемся окне выберите файл с расширением dstpkg и нажмите кнопку Открыть. В поле справа появится информация о выбранной прошивке, в том числе описание ее компонентов.

    ../_images/dstpkg-files.png

    Рисунок 2. Пример окна, в котором можно выбрать файл прошивки

    ../_images/firmware_info.png

    Рисунок 3. Пример информации о выбранной прошивке

  1. Нажмите кнопку Обновить. Начнется обновление прошивки устройства. Предыдущая версия удаляется и вместо нее устанавливается новая.

    Примечание

    По умолчанию для DORS 820 и DORS PMU-820, если выбранная версия прошивки совпадает с уже установленной, то прошивка будет переустановлена (установлен флаг Перезаписать). Чтобы отлючить эту функцию перед нажатием кнопки Обновить снимите флаг Перезаписать. В этом случае после нажатия кнопки Обновить никаких действий выполнено не будет.
    При работе с DORS 210BA наличие/отсутствие флага Перезаписать игнорируется. Если выбранная версия прошивки совпадает с уже установленной, то по нажатию кнопки Обновить прошивка будет переустановлена в любом случае.
    ../_images/rewrite_in_progress.png

    Рисунок 4. Прошивка устройства обновляется

  1. Для окончания обновления устройство автоматически перезагружается. Для проверки версии установленной прошивки после перезагрузки нажмите кнопку INFO.

    ../_images/rewrite_complete.png

    Рисунок 5. Прошивка устройства успешно обновлена

По нажатию кнопки Обновить проверяется соответствие прошивки и УИН устройства по следующим характеристикам:

  • Для моделей DORS PMU-820:

    1. Имя файла прошивки. Формируется по следующему шаблону:

      [Вариант BVS]-[Исполнение]_Finalised_[Номер контроллера]_[Номер CCM]_base_[номер базы валют]_BVS_[номер прошивки BVS].dstpkg

      Вариант BVS может принимать значения «D820F», «D820M1F», «D820M1», «D820M2».

    2. УИН устройства. Формируется по следующему шаблону:

      [Вариант BVS]-[номер рабочего места на заводе]-[серийный номер устройства]

      Вариант BVS может принимать значения «D820», «D820M1», «D820M2».

    3. Модель устройства в прошивке (поле «Device» прошивки). Может принимать значения «D820», «D820M1», «D820M2».

    Таблица 1. Возможные сочетания характиристик прошивки и УИН DORS PMU-820

    Вариант BVS в имени файла

    Вариант BVS в УИН

    Поле «Device»

    D820F

    D820

    D820

    D820M1

    D820M1

    D820M1

    D820M1F

    D820M1

    D820M1

    D820M2

    D820M2

    D820M2

    Если для выбранной прошивки и устройства не подходит ни одно из возможных соответствий, то обновление завершится с ошибкой «DEVICE_TYPE_ERROR».

  • Для моделей DORS 820:

    1. Имя файла прошивки. Вариант BVS (символы до первого дефиса в имени файла) может принимать значения «D820F», «D820M1F», «D820M1», «D820M2».

    2. УИН устройства. Вариант BVS (символы до первого дефиса в УИН) может принимать значения «D820», «D820M1», «D820M2».

    3. Модель устройства в прошивке (поле «Device» прошивки). Может принимать значения «D820», «D820M1», «D820M2».

    Возможные сочетания характиристик такие же, как для DORS PMU-820 (см. таблицу 1).

  • Для моделей DORS 210BA:

    1. УИН устройства: «D210BA» или «D210BAM2»;

    2. Наличие или отсутствие в файле прошивки строки «eGON.BT0».

    Таблица 2. Возможные сочетания характиристик прошивки и УИН DORS 210BA

    УИН

    Наличие «eGON.BT0»

    D210BA

    нет

    D210BAM2

    да

  • Для DORS 200, DORS 200M1, DORS 230М1, DORS 230М2:

    1. УИН устройства соответствует модели: «D200», «DORS 200M1», «DORS 230М1» или «DORS 230М2».

    2. Отсутствие в файле прошивки строки «eGON.BT0».

Результат работы BVSControl логируется в папку C:\BvsControl\lostlogs.

Таблица 3. Возможные результаты выполнения операции

Сообщение

Код

Описание

SUCCESS

0

операция успешно выполнена

failed to search device

2

устройство найти не удалось

device initialization error

2

ошибка инициализации устройства

switch to CCNET failure

3

ошибка подключения к CCNET

can’t open firmware file name

4

ошибка открытия файла прошивки

firmware file not found

6

прошивка не найдена

ALREADY_UPDATED

100

прошивка уже была обновлена

validation error

101

ошибка валидации прошивки

FIRMWARE_MISSING

102

прошивка не найдена

DEVICE_TYPE_ERROR

103

ошибка соответствия прошивки и устройства

DOWNLOAD_ERROR

104

ошибка обновления

RESET_ERROR

105

ошибка перезапуска устройства после обновления

CANCELLED

199

операция отменена

«Тихий» режим

Внимание

Выключайте DORS 200 и DORS 200М1 перед обновлением прошивки.
Для обновления DORS 200 в ОС Windows 7 и Windows 10 и DORS 200M1 в ОС Windows 7 необходим программатор.

Примечание

Перед запуском команды закройте окно BVSControl.

Формат запуска:

c:\BvsControl\BvsControl.exe --download --firmware "dstpkg-файл" [ключи]

Ключи:

  • --download – обновить прошивку устройства.

  • --firmware – путь к файлу прошивки с расширением dstpkg.

  • --rewrite (только для DORS 820 и DORS PMU-820) – если версия прошивки совпадает с уже установленной, то удалить предыдущую прошивку и установить новую с тем же номером версии.

  • --console – выводить ход выполнения операции в окно командной строки.

  • --pause – не закрывать окно командной строки после выполнения операции.

  • --ccnet – для устройств, совместимых с протоколом CCNET.

  • --duration – продолжительность автоматического поиска устройства в минутах. Если этот ключ не указан, то поиск длится 1 минуту. Если устройство не найдено, то загрузка прошивки завершается с ошибкой. Если указан ключ --port, то автоматический поиск устройства не выполняется и ключ --duration игнорируется.

  • --port – номер порта к которому подключено устройство (например, -- port "COM15").

Пример команды:

C:\BvsControl\BvsControl.exe --download --firmware "C:\!PMU_FW\D820F-PMU_M1_Finalised_1_3_3883_1148.dstpkg" --rewrite --console --pause --port "COM15"

Также как и в интерактивном режиме, проверяется соответствие прошивки и УИН устройства. Если для выбранной прошивки и устройства, то обновление завершится с ошибкой «DEVICE_TYPE_ERROR». Результат работы BVSControl логируется в папку C:\BvsControl\lostlogs. Возможные результаты выполнения см. в таблице 3.

Получение информации об устройстве

Получить информацию об устройстве можно двумя способами:

  1. В интерактивном режиме – в графическом интерфейсе BVSControl.

  2. В «тихом» режиме – запустить BVSControl в командной строке.

Интерактивный режим

В окне BVSControl нажмите кнопку INFO. В поле справа появится следующая информация об устройстве:

  • Модель – модель устройства;

  • UIN – УИН устройства;

  • Serial Number – серийный номер устройства;

  • NoteBase Version – версия базы валют;

  • Hardware Version – версия аппаратуры валидатора;

  • Software Version – версия валидатора;

  • Controller Version – версия контроллера;

  • CCM Version – версия модуля ССМ («0.0.0» – если нет модуля ССМ или не удалось получить информацию);

  • Текущая конфигурация – число в шестнадцатиричном формате, текущая конфигурация DORS 210BA M2.

Возможные значения конфигурации DORS 210BA M2:

  • «0x41» – DORS 210BA M2 встраивается в АДМ. Устройство без кассеты и без укладчика принудительного складирования.

  • «0x42» – DORS 210BA M2 встраивается в АДМ. Устройство оснащено мешком для складирования купюр и оснащено укладчиком принудительного складирования.

  • «0x43» – DORS 210BA M2 встраивается в АДМ. Устройство оснащено кассетой для складирования купюр и оснащено укладчиком принудительного складирования.

  • «0x44» – DORS 210BA M2 встраивается в ИПТ. Устройство оснащено кассетой для складирования купюр и без укладчика принудительного складирования.

Если какая-либо версия равна 0 (0.0.0, 000000), то это означает, что прошивка устройства не поддерживает получение данной информации или версию получить не удалось.

../_images/info.png

Рисунок 6. Пример информации об устройстве

Если команду выполнить не удалось, то в поле справа появится сообщение о неисправности, например:

Устройство не подсоединено

«Тихий» режим

Примечание

Перед запуском команды закройте окно BVSControl.

Формат запуска:

c:\BvsControl\BvsControl.exe --info --console --pause

Ключи:

  • --info– запросить информацию об устройстве;

  • --console – вывести информацию в окно командной строки;

  • --pause – не закрывать окно командной строки после выполнения операции.

Пример вывода информации об устройстве (номера версий указаны в скобках):

Model = D210BAM2;
UIN = 33554933 (D210BAM2-002-00000501);
Serial Number = 0 (000000);
NoteBase Version = 1500 (0.5.220);
Hardware Version = 1 (0.0.1);
Software Version = 16973879 (1.3.55);
Controller Version = 0 (0.0.0);
CCM Version = 0 (0.0.0);
Current configuration: 0x44

  • Model – модель устройства;

  • UIN – УИН устройства;

  • Serial Number – серийный номер устройства;

  • NoteBase Version – версия базы валют;

  • Hardware Version – версия аппаратуры валидатора;

  • Software Version – версия валидатора;

  • Controller Version – версия контроллера;

  • CCM Version – версия модуля ССМ («0.0.0» – если нет модуля ССМ или не удалось получить информацию);

  • Current configuration – число в шестнадцатиричном формате, текущая конфигурация DORS 210BA M2.

Возможные значения конфигурации DORS 210BA M2:

  • «0x41» – DORS 210BA M2 встраивается в АДМ. Устройство без кассеты и без укладчика принудительного складирования.

  • «0x42» – DORS 210BA M2 встраивается в АДМ. Устройство оснащено мешком для складирования купюр и оснащено укладчиком принудительного складирования.

  • «0x43» – DORS 210BA M2 встраивается в АДМ. Устройство оснащено кассетой для складирования купюр и оснащено укладчиком принудительного складирования.

  • «0x44» – DORS 210BA M2 встраивается в ИПТ. Устройство оснащено кассетой для складирования купюр и без укладчика принудительного складирования.

Если какое-либо значение равно 0 (0.0.0, 000000), то это означает, что информацию о версии ПО получить не удалось.

Если команду выполнить не удалось, то в окне командной строки появится сообщение о неисправности. Например, если открыто окно BVSControl и устройство выключено, то выполнение команды завершится с ошибкой «device initialization error».

Изменение конфигурации DORS 210BA M2

Примечание

Выполняется в «тихом» режиме. Перед запуском команды закройте окно BVSControl.

Примечание

Под конфигурацией устройства понимается набор алгоритмов управления датчиками и моторами, которые определяются режимом эксплуатации (кассета или мешок, оснащение укладчиком, принудительное складирование и прочее). Будьте внимательны при изменении.

Формат запуска:

c:\BvsControl\BvsControl.exe --set_config <конфигурация> --console --pause

Ключи:

  • --set_config – число в шестнадцатиричном формате, новая конфигурация DORS 210BA M2;

  • --console – вывести информацию в окно командной строки;

  • --pause – не закрывать окно командной строки после выполнения операции.

Возможные значения конфигурации:

  • «0x41» – DORS 210BA M2 встраивается в АДМ. Устройство без кассеты и без укладчика принудительного складирования.

  • «0x42» – DORS 210BA M2 встраивается в АДМ. Устройство оснащено мешком для складирования купюр и оснащено укладчиком принудительного складирования.

  • «0x43» – DORS 210BA M2 встраивается в АДМ. Устройство оснащено кассетой для складирования купюр и оснащено укладчиком принудительного складирования.

  • «0x44» – DORS 210BA M2 встраивается в ИПТ. Устройство оснащено кассетой для складирования купюр и без укладчика принудительного складирования.

Примечание

Допускается использование любого шестнадцатиричного числа, не превышающего одного байта. В случае использования значений, отличных от указанных возможных, будет установлен соответсвующий номер конфигурации, но устройство будет работать как «0x41».

Пример вывода при успешном выполнении команды:

Текущая конфигурация устройства: 0x41
Конфигурация устройства успешно установлена: 0x42
Операция успешно завершена. Можно закрыть окно.

Коды возврата:

  • 30 – Операция успешно завершена.

  • 31 – Ошибка: задано недопустимое значение параметра –set_config.

  • 32 – Ошибка: устройство не подключено.

  • 33 – Ошибка: не удалось получить конфигурпацию устройства.

  • 34 – Ошибка: не удалось установить конфигурацию устройства.

  • 35 – Ошибка: неизвестная ошибка установки конфигурации.

Включение DORS PMU-820

  1. В окне BVSControl нажмите кнопку POWER UP. В поле справа появится сообщение:

    Включаемся... Пожалуйста, подождите...

    Если устройво уже включено, то появится сообщение:

    Устройство включено

  2. Дождитесь включения устройства. Если устройство включилось, то в поле появится информация об устройстве (см. рис. 6).

Выключение DORS PMU-820

  1. В окне BVSControl нажмите кнопку SHUTDOWN. В поле справа появится сообщение:

    Выключаемся... Пожалуйста, подождите...

  2. Дождитесь выключения устройства. В поле справа появится сообщение:

    Устройство выключилось.