===========================================================
Консольные Linux-утилиты для управления сканерами SuperLead
===========================================================

Предварительная настройка
=========================

Перед началом работы необходимо выполнить следующие действия:

1. Установка Java Runtime Environment (JRE).

Выполните команду в терминале:

.. code-block:: bash

   sudo apt update
   sudo apt install default-jre

2. Для корректной работы всех утилит обратите внимание на папку ``jars`` в директории с утилитами. Эта папка должна содержать все необходимые JAR-библиотеки (зависимости).

 .. figure:: picture/linux1.png
   :scale: 70 %

Консольные утилиты
==================

Утилита InfoScan
----------------

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

**Команда запуска:**

.. code-block:: bash

   java -jar infoScan.jar


**Пример выполнения:**

 .. figure:: picture/linux2.png
   :scale: 73 %

**Дополнительные параметры:**

* ``-m <HID/COM>`` — конечный режим работы, в который будут переведены все обработанные устройства после получения информации.

.. code-block:: bash

   java -jar infoScan.jar [-m <режим>]

Данный параметр можно использовать для вывода сканера из HID-режима в случае, когда невозможно считать настроечный код.

 .. figure:: picture/linux3.png
   :scale: 80 %


Утилита ReadSettingsFromDevice
------------------------------

Утилита предназначена для чтения текущих настроек из сканера и сохранения их в JSON-файл.

**Команда запуска:**

.. code-block:: bash

  java -jar settingsReader.jar -f <файл_настроек>

**Пример выполнения:**

 .. figure:: picture/linux4.png
   :scale: 80 %

JSON-файл с записанными настройками:


 .. figure:: picture/linux5.png
   :scale: 70 %


**Дополнительные параметры:**

* ``-f`` —  путь к файлу, куда будут сохранены настройки, **(обязательный)**;
* ``-s`` — серийный номер устройства (если не указан, утилита работает с единственным подключенным сканером), *(необязательный)*;
* ``-m`` — конечный режим работы после чтения настроек, *(необязательный)*;
* ``-t`` — таймаут ожидания переключения режима (в миллисекундах), *(необязательный)*;
* ``-u yes|no`` — пропускать ли неподдерживаемые настройки, *(необязательный)*.


Утилита WriteSettingsToDevice
-----------------------------

Утилита предназначена для записи настроек из JSON-файла на один или несколько подключенных сканеров.

**Команда запуска:**

.. code-block:: bash

   java - sejarttingsWriter.jar -f <файл_настроек.json>

**Пример выполнения:**

 .. figure:: picture/linux6.png
  :scale: 70 %


**Дополнительные параметры** — аналогичны параметрам утилиты **ReadSettingsFromDevice**.


Утилита SuperUpgrade_CMD
------------------------

Утилита предназначена для обновления прошивки сканеров.

.. warning::
   Для каждой модели используется своя прошивка. Утилита загружает прошивку на все устройства с одинаковым VID. Если подключено неподходящее устройство, прошивка может привести к необратимому выходу сканера из строя!

.. note::
   Сканер CL 2425 (2core) **не поддерживает** обновление через данную утилиту.

**Команда запуска:**

.. code-block:: bash

   sudo SuperUpgrade_64 -p /dev/ttyACM* -b 115200 -f <файл_прошивки.sm>

**Пример выполнения:**


 .. figure:: picture/linux7.png
  :scale: 70 %


**Дополнительные параметры:**

* ``-b`` — скорость соединения (обычно 115200), **(обязательный)**;
* ``-p`` — порт устройства (например, ``/dev/ttyACM0``), **(обязательный)**;
* ``-f`` — путь к файлу прошивки, **(обязательный)**;
* ``-s`` — серийный номер (если нужно прошить только одно конкретное устройство), *(необязательный)*.


.. note::

   **Если вы не нашли ответа на свой вопрос или нуждаетесь в консультации 
   наших технических специалистов, позвоните по телефону бесплатной 
   горячей линии MERTECH 8-800-555-7783 или напишите запрос на почту** 
   support@mertech.ru

-------------

.. centered:: :guilabel:`М.П.В. 21.05.2026`