UpdateCashcodeFirmware

Общие сведения

Утилита UpdateCashcodeFirmware входит в состав системы управления терминалами и предназначена для обновления прошивки купюроприемника. Утилита выполняет следующие функции:

  • проверяет наличие купюроприемника, подключенного к COM-порту, указанному в параметрах. Если COM-порт отсутствует в параметрах, утилита определяет к какомуCOM-порту подключен купюроприемник;

  • проверяет наличие файла прошивки, путь к которому указан в параметрах, либо ищет в директории, в которой находится утилита, файл с прошивкой;

  • перепрошивает купюроприемник.

Поддерживаемые модели

Поддерживаются модели купюроприемников CashCode, работающие по протоколу CCNET:

  • CashCode FL;

  • CashCode FLS;

  • CashCode GX;

  • CashCode SM.

Системные требования

Программные требования:

  • Поддерживается работа в операционных системах MS Windows XP SP3, Windows 7 SP1.

Дополнительные требованиия:

  • Для моделей SM и FL – наличие карточки NDEG или SSC в купюроприемнике.

  • Файл прошивки должен находиться в той же директории, где находится утилита либо указан параметр запуска -p (см. ниже п.4).

  • У прошивки должно быть расширение hex (карты типа NDEG) или ssf (карты типа SSC) или cf2 (модель устройства GX).

  • Логи должны записываться в ту же директорию, где находится утилита.

Запуск утилиты

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

Для запуска утилиты рекомендуется использовать cmd-файл, сформированный в кодировке OEM 866. В случае использования cmd-файла, сформированного в кодировке Win 1251, необходимо перед запуском утилиты UpdateCashcodeFirmware установить корректное значение текущей кодовой страницы: chcp 1251. Параметры запуска указываются через пробел.

Принципы работы утилиты

Система управления терминалами Заказчика запускает файл UpdateCashcodeFirmware.exe, при необходимости используя ключи:

  • --port, -p, – имя COM-порта, к которому подключено устройство.

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

  • --progress, -r – вывод индикатора завершения в ходе обновления прошивки устройства. Возможные значения: 0``(запретить), ``1 (разрешить вывод прогресса в консоль). Значение по умолчанию: 1.

В случае отсутствия одного из параметров ( -p или -f) будет произведен автоматический поиск файла прошивки или COM-порта.

В случае запуска утилиты без параметров, будет произведен автоматический поиск файла прошивки с расширением cf2, hex или ssf в текущей директории, а также COM-порта купюроприемника среди подключенных устройств.

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

Пример запуска:

UpdateCashcodeFirmware.exe -p COM1 -f "C:\FL-RU 13 37.hex" -r 1

Результат работы утилиты

Результат работы утилиты (купюроприемник прошит/не прошит) можно узнать по коду ошибки. Получить код можно следующим образом:

  1. Код ошибки выводится в консоль.

  2. Код фиксируется в переменной среды errorlevel (этой переменной присваивается значение кода).

  3. Сообщение об ошибке, которое выводится в консоль, дублируется в логах.

Список кодов ошибок с расшифровкой:

  • 0 – Успешное выполнение прошивки: «Прошивка устройства с серийным номером „NNN“ была успешно обновлена на версию „FFF“»

  • -9 – Некорректные аргументы вызова.

  • -8 – Не удалось обнаружить купюроприемник.

  • -1 – Не удалось получить значения входных параметров или указанный файл не найден.

  • 1 – Файл с прошивкой не обнаружен.

  • 3 – Файл пустой или длина файла превышает 512 Мб или ошибка прочтения файла с прошивкой.

  • 5 – Не удалось подключиться к COM-порту.

  • 6 – Ошибка прочтения серийного номера и версии прошивки устройства.

  • 7 – Не удалось перепрошить устройство.

  • 9 – Не удалось идентифицировать устройство после обновления прошивки.

  • 10 – После выполнения прошивки изменился серийный номер устройства.

  • 11 – После выполнения прошивки номер версии прошивки не изменился.

  • 12 – После выполнения прошивки устройство не вышло в работоспособное состояние.

  • 21 – Не удалось начать операцию перепрошивки устройства. Возможно, устройство не оборудовано картой NDEG/SSC.

  • 22 – Не удалось определить тип файла: NDEG/SSC.

  • 23 – Файл с прошивкой не совместим с устройством.

  • 26 – Не удалось определить тип карты памяти: NDEG/SSC.

  • 27 – Вероятно, прошивка не предназначена для данной NDEG-карты.

Примечание

Если при обновлении версии прошивок совпадают, то операция завершится с кодом возврата «11», но в логе консоли будет выведен успешный результат.