OPOS Scale Mertech POS-2M
====================================================
## **Введение**

OPOS-драйвер (OLE for Retail POS) — это стандартный интерфейс, который позволяет программному обеспечению взаимодействовать с периферийными устройствами, такими как весы, принтеры, сканеры и т.д. Драйверы OPOS обеспечивают единый интерфейс для работы с различными устройствами, что упрощает интеграцию и тестирование.

## **Назначение драйвера**


OPOS-драйвер для весов предназначен для:

- Обеспечения связи между программным обеспечением и весами.

- Позволяет программам считывать данные о весе и управлять функциями весов.




- Упрощения процесса разработки и тестирования приложений, использующих весы.

## **Состав драйвера**

OPOS-драйвер для весов состоит из следующих компонентов:

- Динамической библиотеки (DLL), которая содержит реализацию функций драйвера.
  
- Программное обеспечение для тестирования: утилита от Штрих-М, которая позволяет тестировщикам проверять функциональность драйвера.

## **Платформа**

- **Минимальная версия ОС**: Windows 7-11 (x86, x64).
- **Разрядность библиотеки**: x86.

---

## **Предварительные требования**

Перед началом тестирования выполните следующие шаги:

1. **Установите необходимые компоненты**:
   - Убедитесь, что .NET Framework установлен на вашем компьютере. Скачать его можно по следующей ссылке:  
`Скачать .NET Framework`_.

.. _`Скачать .NET Framework`: https://dotnet.microsoft.com/download/dotnet-framework

.. figure:: ../Весы_интерфейсные/picture/installation_image.png
      :scale: 100 %
      :align: center
      :alt: .NET Framework

      Пример установки OposTest.
- После установки .Net Framework необходимо установить OposTest.

- Установите OposTest от имени администратора, следуя инструкциям установки.

.. figure:: ../Весы_интерфейсные/picture/oposstart.png
      :scale: 100 %
      :align: center
      :alt: .NET Framework

      Пример установки OposTest.
1. **Установите драйверы OPOS версии 1.16**:

   - Удалите все имеющиеся OPOS-драйверы.
  
   - Скачайте архив с драйверами по ссылке:  
  
   `OPOS Driver 1.16`_.

.. _`OPOS Driver 1.16`: https://example.com/oposdriver116.zip


- Распакуйте архив и запустите **Install_CCOandPIA_116.bat** от имени администратора.

1. **Подключите весы**:

   - Подключите весы к компьютеру через соответствующий интерфейс (USB, COM-порт и т.д.).
  
   - Убедитесь, что весы включены и работают корректно.

---

## **Как пользоваться драйвером**

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

`Driver`_.

.. _`Driver`: https://drive.google.com/file/d/13by203WgANAC1xAOJNf9eoIZlwjOpAFP/view?usp=sharing

1. **Запуск тестового приложения**:
   
Запустите от имени администратора `OposConfig.exe` для выбора порта и скорости.
  
  
.. figure:: ../Весы_интерфейсные/picture/oposConfig.jpg
      :scale: 100 %
      :align: center

      OposConfig
  
- Откройте тестовое приложение `OposTest.exe`, расположенное в `C:\Program Files (x86)\OPOS\SHTRIH-M\Bin\`.

   .. warning::
      Не запускайте `OposConfig.exe` из папки с `OposTest.exe`. Используйте оригинальный файл из архива.

1. **Инициализация драйвера**:

   - В тестовом приложении выберите опцию инициализации драйвера, чтобы установить связь с весами.
  
   - Перейдите во вкладку `Scale`, выберите `OposScaleDriver` в списке `DeviceName` и нажмите `Open`.

   .. note::
      Статус `OPOS_SUCCESS` в поле `OpenResult` свидетельствует об успешности инициализации драйвера, но не гарантирует подключения к реальному оборудованию.

2. **Проверка функциональности**:

   Успешность каждой операции можно увидеть внизу экрана в окошке Result.

Основные ошибки, с которыми можно столкнуться в процессе тестирования.

OPOS_SUCCESS – операция успешна

OPOS_E_TIMEOUT – превышения таймаута

OPOS_E_FAILURE – ошибка операции

OPOS_E_CLOSED – оборудование не подключено

OPOS_E_CLAIMED – оборудование уже подключено

OPOS_E_NOHARDWARE – оборудование отсутствует


- Основные команды:
  
- Claim – фактическое подключение к реальному оборудованию
  
- DeviceEnabled – разрешение на получение данных и отправку команд оборудованию
  
Прим.: Только после успешности операций Claim и Device возможно использование полноценное использование функционала весов

- ZeroValid – активация данного свойства означает, что значение 0, получаемой в качестве веса, не будет расцениваться как ошибка либо ожидание получение данных. Активируйте это свойство для дальнейшей работы.

- ZeroScale – установка нуля. Для этого убедитесь, что на весах ничего не лежит и они откалиброваны должным образом. 
  
- ReadWeight – получение реального веса. Положите что-нибудь на весы и нажмите кнопку.

- TareWeight - установка веса тары. После ввода значения Тары нажать Set. Последующие измерения будут производиться с учётом весы тары.



## **Логирование**

Логи сохраняются в следующей директории:  

**C:\Users\<Имя пользователя>\AppData\Roaming\OposScaleDriverLog**



## **Удаление драйвера**

Для удаления драйвера выполните следующие действия:
- Запустите `Register.exe` от имени администратора и нажмите `Unregister`.
- Если файл `OposScaleDriver.dll` отсутствует в текущей директории, вам будет предложено его указать.



## **Заключение**

Тестирование OPOS-драйвера для весов — это важный этап в обеспечении надежной работы программного обеспечения в торговых точках. Следуя данной инструкции, вы сможете эффективно протестировать драйвер и убедиться в его корректной работе.



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

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

.. centered:: :guilabel:`Р.А.Ю. 19.11.2024`