Общее описание¶
Драйвер предназначен для работы с весами с помощью последовательной коммуникации.
Перед началом работы с весами необходимо выполнить подключение (см. раздел «Подключение»). Перед каждым вызовом функции, работающей с весами, необходимо добавить все требуемые для неё параметры.
Ниже предоставлены доступные функции драйвера, поддерживаемые команды, параметры весов и коды ошибок.
Поддерживаемые функции¶
Наименование |
Описание |
|---|---|
Open |
Открыть последовательный порт |
IsOpen |
Проверка открытости последовательного порта |
Close |
Закрыть последовательный порт |
SetParam |
Установка исходящих параметров |
GetParam |
Получение входящих параметров |
ExecuteCommand |
Выполнить команду |
SetLoggingMode |
Установить режим логирования |
GetErrorCaseDescription |
Получить объяснение ошибки |
ChangeLoggingConfigFile |
Изменить конфигурационный файл логирования |
GetDataFromLogConfigFile |
Получить данные из конфигурационного файла логирования |
LoggingPath |
Получить путь к файлу логов |
CurrentVersion |
Получить текущую версию драйвера |
AddLogicDevice |
Добавить логическое устройство |
DeleteLogicDevice |
Удалить логическое устройство |
SetLogicDeviceParam |
Задать значение параметра логического устройства |
GetLogicDeviceParam |
Получить значение параметра логического устройства |
GetCurrentLogicDeviceID |
Получить ID текущего логического устройства |
SetCurrentLogicDeviceID |
Установить текущее логическое устройство с заданным ID |
GetAllSortedLogicDeviceID |
Получить отсортированный (в порядке возрастания) по ID список логических устройств |
Поддерживаемые команды¶
Наименование |
Описание |
|---|---|
SetProtocolVersion |
Установка версии протокола |
SetValueOfAutoSetToZero |
Установка диапазона слежения за нулем |
SetTimeOfAutoSetToZero |
Задание времени установки нуля |
SetAutoOff |
Установка времени автовыключения |
SetLightLevel |
Установка уровня подсветки |
SetPowerSavingMode |
Установка режима энергосбережения |
GetScalesModel |
Запрос модели весов |
GetFirmwareVersion1 |
Запрос идентификационного наименования ПО |
GetFirmwareVersion2 |
Запрос номера версии ПО |
GetProtocolVersion |
Запрос версии протокола |
GetSerialNumber |
Запрос серийного номера |
GetMaxWeight |
Запрос значения максимальной нагрузки |
GetDiscret |
Запрос значения дискретности |
GetValueOfAutoSetToZero |
Запрос диапазона слежения за нулем |
GetTimeOfAutoSetToZero |
Запрос времени установки нуля |
GetAutoOff |
Запрос времени автовыключения |
GetLightLevel |
Запрос уровня подсветки |
GetCountOfCalibration |
Запрос счетчика калибровки |
GetPowerSavingMode |
Запрос режима энергосбережения |
Reboot |
Перезагрузка |
GetProtocolAuto |
Запрос версии протокола (также для старых моделей) |
StatusOfWeightChannelAuto |
Запрос состояния весового канала (без необходимости знания протокола весов) |
StatusOfWeightChannel |
Запрос состояния весового канала |
SetZero |
Установить ноль |
SetTare |
Установить тару |
SpecifyTare |
Задать тару |
Поддерживаемые параметры¶
Наименование |
Тип |
Описание |
|---|---|---|
ScalesModel |
Строка |
Модель |
FirmwareVersion1 |
Строка |
Идентификационное наименование ПО |
FirmwareVersion2 |
Строка |
Номер версии ПО |
ProtocolVersion |
Строка |
Протокол |
SerialNumber |
Строка |
Серийный номер |
MaxWeight |
Строка |
Максимальный вес |
Discret |
Строка |
Дискретность |
ValueOfAutoSetToZero |
Строка |
Диапазон слежения за нулем |
TimeOfAutoSetToZero |
Строка |
Время установки нуля |
RangeOfAutoSetToZero |
Строка |
Диапазон первоначальной установки нуля |
RangeOfKeyToZero |
Строка |
Диапазон установки на нуль (-0-) |
RangeOfTare |
Строка |
Диапазон установки массы тары (-Т-) |
RangeOfOverloads |
Строка |
Предел показаний массы |
AutoOff |
Строка |
Время автовыключения |
LightLevel |
Строка |
Подсветка / яркость |
CountOfCalibration |
Строка |
Счетчик калибровок |
PowerSavingMode |
Строка |
Режим энергосбережения |
WeightState |
Строка |
Флаги состояния |
Weight |
Строка |
Вес |
Tare |
Строка |
Тара |
Коды ошибок¶
Код |
Наименование |
|---|---|
0 |
Успешно |
1 |
Ошибка не установлена |
2 |
Неизвестная ошибка |
3 |
Неверный аргумент |
4 |
Неизвестная ошибка последовательного порта |
5 |
Не удается открыть последовательный порт |
6 |
Неизвестная ошибка библиотеки Boost |
7 |
Тайм-аут библиотеки Boost |
8 |
Техническая проблема, данные неверны: HandleNull |
9 |
Техническая проблема, данные неверны: HandleInvalid |
10 |
Техническая проблема, данные неверны: HandleDoesNotExist |
11 |
Неизвестный тип параметра |
12 |
Параметр не поддерживается |
13 |
Параметр не установлен |
14 |
Неизвестная настройка последовательного порта |
15 |
Неподдерживаемая настройка последовательного порта |
16 |
Настройка последовательного порта не установлена |
17 |
Значение параметра неизвестно |
18 |
Значение параметра не поддерживается |
19 |
Значение параметра не установлено |
20 |
Неизвестная команда |
21 |
Kоманда не поддерживается |
22 |
Неверный формат ответа устройства |
23 |
Неожиданный ответ устройства |
24 |
Устройство вернуло ошибку |
25 |
Устройство не стабилизировано |
26 |
Возникла неизвестная ошибка |
27 |
Не удалось подключиться. Возможно, указана неверная модель или протокол |
28 |
Отсутствует JSON-ключ |
29 |
Неверное расширение JSON-файла |
30 |
JSON-файл не существует |
31 |
Проблема парсинга JSON-файла |
32 |
Неправильный аргумент командной строки |
33 |
Не удалось открыть файл |
34 |
Выбрана неправильная модель |
35 |
Нажата кнопка Escape |
36 |
Ошибка в JSON-файле логических устройств |
37 |
Логическое устройство не найдено |
38 |
Не заданы все необходимые параметры логического устройства |