eksis - документация. Акционерное общество Экологические сенсоры и системы (эксис)
 Скачать 4.28 Mb.
|
|
Приложение F. Устранение проблем Если программа работает некорректно, изучите этот раздел. Здесь описаны наиболее часто возникающие проблемы при работе с программой и способы их устранения. Первое, что нужно сделать при возникновении неисправности – обновить программу с помощью функции автообновления (см. соответствующую главу). Над Eksis Visual Lab постоянно идѐт работа, и вполне возможно, что ошибка уже исправлена. Если Launcher не обнаружит новых версий, см. таблицу. Таблица неисправностей и решений Проблема Возможное решение Программа закрывается с ошибкой при первом запуске после ввода ключа Возникает ошибка о невозможности записи на диск Возникает ошибка SQL Проверьте права пользователя на компьютере. Программе необходимы права администратора для записи информации на диск. Нажмите правой кнопкой по программе и выберете «Запустить от имени администратора». Установите необходимые права пользователя или позовите системного администратора. Отсутствует связь с прибором (индикатор напротив прибора горит красным) Проверьте соединение прибора с компьютером и состояние прибора. Он должен быть включен и корректно отображать показания измерений. Проверьте, что установленные в программе COM-порт и технологический номер корректны. Технологический номер – это 8 цифр на штрих-коде прибора, начинающиеся с цифры «1». Если прибор подключѐн по USB, он будет всегда доступен также и по номеру «99999999». Проверьте, что установленные в программе скорость связи и сетевой адрес прибора совпадают (как это сделать описано в паспорте прибора). В случае USB убедитесь, что подключаете прибор не через USB-хаб. Некоторые типы приборов не работают в случае подключения по USB-хабу. Проверьте, нужен ли прибору драйвер виртуального com-порта (VCP). Для установки драйвера см. соответствующую главу. Статистика из прибора не загружается или загружается неправильно В случае, если прибор только вышел из производства или был длительный перерыв в его эксплутации, в нѐм может быть установлено неправильное время или выключена функция записи статистики. Настройте прибор в следующем порядке: 164 синхронизируйте время, установите требуемый период записи и сбросьте статистику. Через некоторое время загрузите статистику и убедитесь, что она загрузилась корректно. Показания в программе не соответствуют показаниям на приборе Прибор в программе выглядит некорректно Убедитесь, что правильно выбрали тип прибора. Сравните название прибора в Eksis Visual Lab и паспорте прибора, они должны совпадать. Индикатор прибора горит зелѐным, каналов – красным Убедитесь, что правильно выбрали тип прибора. Сравните название прибора в Eksis Visual Lab и паспорте прибора, они должны совпадать. Отсутствует связь между измерительными преобразователями и прибором. Проверьте соединение. Если соединение исправно, может иметь место неисправность преобразователей. Обмен данными с прибором, подключѐнным по USB, периодически пропадает Windows может отключать питание USB- интерфейсу в случае, если прибор покажется ей неактивным. Нажмите правой кнопкой по «Мой компьютер», далее откройте «Диспетчер устройств» (для Win7 – на панели слева, для WinXP – во вкладке «Оборудование». Далее откройте ветку «Контроллеры USB». Откройте свойства каждого пункта (правой кнопкой). В случае, если в открывшемся окне присутствует вкладка «Управление электропитанием», снимите флаг «Разрешить отключение этого устройства для экономии энергии». Прежде, чем обратиться в техподдержку Если неисправности нет в таблице или возможное решение не дало результатов, обратитесь за помощью в техподдержку по телефону или электронной почте (см. главу с контактной инофрмацией). Подготовьте следующую информацию: 1. Тип прибора по паспорту 2. Технологический номер прибора (на штрих-коде) 3. Тип операционной системы, еѐ разрядность 4. Версия EVL («Помощь» -> «О программе») 5. При каких действиях возникает ошибка В некоторых случаях для быстрого решения проблемы специалисты техподдержки могут настроить программу удалѐнно или продиагностировать приборы с помощью программы удалѐнного доступа TeamViewer версии 12 ( https://www.eksis.ru/technical-support/remote-tech- support.php ). Часто задаваемые вопросы Q. Какое максимальное количество приборов поддерживает программа? A. Количество поддерживаемых приборов не ограничено. Вы можете подключать приборы по одной RS-485 линии, назначая им разные сетевые адреса. У приборов с USB-интерфейсом разделение происходит по их уникальному восьмизначному технологическому адресу. 165 Q. Каким образом можно работать с накопленной статистикой? A. Просмотр и экспорт статистики возможен как в текстовой, так и в графической формах. Вы можете выводить статистику из базы данных за любой период. Для удобство просмотра существуют вспомогательные опции, вроде подсветки нарушенных порогов, отображения максимальных/минимальных значений и т.д. EVL также может автоматически проанализировать статистику на предмет различных событий и вывести краткий отчѐт. Q. У меня много приборов. Могу ли я выводить их параметры на одном графике? A. EVL позволяет отображать любое количество параметров с различных приборов на любом количестве графиков. Q. Мне требуется обновлять данные с прибора каждые 5 секунд, но при просмотре статистики такое количество данных является излишним и мешает. Можно ли избежать такой ситуации? A. Для каждого прибора можно настроить разные периоды обновления данных и записи в БД. Данные могут обновляться раз в 5 секунд, но при этом запись в БД будет происходить каждые 5 минут. Кроме этого, при выводе статистики вы можете выводить лишь каждую N-ую запись. Q. Можно ли использовать программу для мониторинга в реальном времени? A. EVL позволяет гибко конфигурировать представление данных на экране. Вы можете создать и настроить различные элементы мониторинга (линейный индикатор, стрелочный индикатор, текст и т.д.). Вы можете задать их размер, чтобы их было видно на расстоянии. Вы можете загрузить план помещения и распределить по ней элементы, таким образом получая более полное визуальное представление о текущем состоянии. Q. Каким образом и о каким событиях EVL оповещает пользователя? A. Вы можете настроить по 4 реакции на два события: нарушение заданных порогов и обрыв связи с прибором. Возможные реакции: звуковой сигнал, отправка смс, отправка email и запуск файла с параметрами. Q. Обязательно ли постоянно держать прибор подключѐнным к компьютеру, а программу включѐнной? A. У большинства наших приборов присутствует возможность автономной записи статистики. Настроив параметры этой функции (период записи, внутреннее время в приборое), вы можете выключить программу и отсоединить прибор. В следующий раз просто выгрузите статистику из внутренней памяти прибора - и она окажется доступна в Eksis Visual Lab. Q. На сколько времени хватает внутренней памяти прибора? A. Зависит от типа прибора, периода записи статистики и некоторых других параметров. При периоде записи в 5 минут, памяти обычно хватает чтобы покрыть достаточно длительный период времени (пара месяцев). Q. Существует ли возможность защитить изменения конфигурации? A. Вы можете установить пароль на изменение различных настроек программы (добавление/изменение/удаление приборов, окон мониторинга, окон просмотра статистики и т.д.). Q. Приборы подключены к компьютеру в локальной сети. Есть ли способ получить доступ к их показаниям и статистики? A. Существует несколько способов удалѐнного взаимодействия. Вы можете получить доступ через web-interface с помощью любого браузера. Вы можете использовать Eksis Visual Lab в связке 166 клиент-сервер. Вы можете использовать протокол TCP/IP для получения текущих данных и статистики в CSV-формате (для интеграции с вашими программами). Q. Как осуществить удалѐнный доступ к программе через браузер? A. В EVL существует настраиваемый web-interface. Вы можете включить его и, при желании, установить пароль. Через web-interface вы можете отслеживать данные измерений и состояние приборов в реальном времени, а также загружать и просматривать статистику как в тестовом, так и в графическом виде. Q. Я использую свою программу для анализа измерений, их статистики и событий. Можно ли интегрировать мою программу с EVL? A. Да, можно. Есть несколько способов, с помощью которых другая программа может получить данные из Eksis Visual Lab. Получить текущие измерения или статистику можно по протоколу TCP/IP (как локально, так и удалѐнно). Также можно настроить автоматическую выгрузку статистики в CSV-файл, который будет обрабатывать ваша программа. Получить информацию о событиях можно также с помощью TCP/IP протоколу, либо настроить оповещения в программе на запуск стороннего файла. Тогда при наступлении события программа будет запускать выбранный файл (*.exe, *.bat, и т.д.) с параметрами-информацией. Q. Могу ли я автоматизировать экспорт статистики? A. Да, вы можете задать различные параметры (период, формат и т.д.) для каждого прибора. Можно экспортировать статистику одновременно в текстовой и графической формах, высылать еѐ по электронной почте и сохранять в выбранную папку локально. Q. Могу ли я подключить ваш прибор в свою программу? A. У всех наших приборов открытый и задокументированный протокол обмена данными. Представлена динамическая библиотека с набором функций обмена для 32-x и 64-х битных ОС Windows. Кроме этого, для некоторых наших приборов существуют OPC DA сервера. Ознакомиться с протоколом обмена, скачать библиотеку обмена вы можете на нашем сайте. Q. Могу ли я подключить свой прибор в вашу программу? A. В случае, если ваш прибор поддерживает обмен данными по протоколу, вы можете интегрировать его в Eksis Visual Lab (появится в обновлении 2.7). Q. В программе нет необходимой нам функции. Можете ли вы еѐ добавить? A. Да. Если эта функция может быть полезна не только вам, то мы бесплатно добавим еѐ в следующей версии программы. 167 Приложение G. Сетевой JSON-протокол обмена данными Eksis Visual Lab поддерживает обмен данными по сетевым протоколам UDP/IP и TCP/IP через 14554 порт. Любая программа может отправить EVL запрос и получить ответ, что может быть использовано для интерграции EVL с другими решениями. Для проверки этой функции можно воспользоваться любой программой-терминалом, например Hercules. Данные передаются посредством строк в кодировке UTF-8 в формате JSON (как развѐрнутом, так и минимизированном – EVL всегда отвечает минимизированным вариантом). При подключении по TCP/IP в конце строки запроса необходимо передавать символ конца строки с кодом 0x0A. Формат запроса и ответа В каждом запросе обязательно должен присутствовать ключ request со строковым значением, определяющим тип запроса. В каждом ответе обязательно присутствует ключ success с булевым значением, определяющим результат выполнения запроса. Если запрос был выполнен успешно, то success будет иметь значение true, а в ответе может присутствовать ключ data со значением-структурой с результатом выполнения запроса. Если во время выполнения запроса произошла ошибка, то success будет иметь значение false, а в структуре ответа будет присутствовать ключ error со строковым значением с описанием ошибки. Запрос списка приборов Программа вернѐт список всех добавленных приборов. Пример запроса: { "request": "list" } Пример ответа: { "success": true, "data": { "devices": [ { "id": 3066559972, "name": "ИВТМ-7 М1", "techNumber": "00000004" }, { "id": 2994372015, "name": "ИВТМ-7 М2", "techNumber": "00000013", "stopped": true } ] } } Значение ключа id содержит уникальный идентификатор прибора (четырѐхбайтное беззнаковое целое число). Возможно присутствие ключей с булевым значение inactive (флаг активности прибора в программе) и stopped (состояние обмена данными), а также ключа со строковым значением error (присутствие и расшифровка ошибки прибора). 168 Запрос текущих данных измерений Программа вернѐт состояние прибора и последние полученные из него данные измерений. Пример запроса: { "request": "data", "type": "full", "device": "00000004" } Ключ type со строковым значением определяет насколько подробными будут возвращѐнные данные. Возможны 3 варианта (от наиболее подробного до сжатого): full, short, tiny. Ключ device должен содержать технологический номер прибора, данные которого будут возвращены в ответе. Пример ответа: { "success": true, "data": { "id": 3066559972, "name": "ИВТМ-7 М1", "timestamp": 1611672930, "channels": [ { "id": 196641965, "name": "Канал 1", "parameters": [ { "id": 565740866, "value": 23.9295806884766, "name": "Температура", "units": "°C", "decimal": 1 }, { "id": 4249621549, "value": 21.2103462219238, "name": "Влажность", "units": "%", "decimal": 1 } ] } ] } } Ключ timestamp содержит UNIX-метку времени данных измерений. Структура channels содержит массив каналов прибора, элементы которого в свою очередь содержат массив параметров канала. В структуре каждого параметра присутствуют его значение (value) или информация об ошибке (error), название измеряемого параметра (name) и его единицы измерения (units), а также количество значащих цифр после запятой (decimal). 169 Если заданы пороговые значения, то они будут присутствовать в ключах с названиями lowAttention (нижний порог типа «Внимание), lowAlarm (нижний порог типа «Тревога»), highAttention (верхний «Внимание») и highAlarm (верхний «Тревога»). В структурах прибора, каналов и параметров могут присутствовать информация об их активности (inactive) и ошибках (error). В структуре параметров может присутствовать дополнительная информация об измерямом параметра (ключ description со строковым значением). Запрос архивных данных измерений Программа вернѐт собранные данные измерений за указанный период. Пример запроса: { "request": "statistic", "action": "get", "type": "tiny", "device": "00000004", "begin": 1611619200, "end": 1611705599 } Ключи begin и end должны содержать начало и конец интересующего периода в формате UNIX-timestamp. Пример ответа (первая JSON-структура): { "success": true, "data": { "status": "Query ready", "count": 6 } } В структуре ключа data содержится информация о количестве измерений, содержащихся в выборке. Пример ответа (последующие JSON-структуры): { "success": true, "data": { "id": 3066559972, "timestamp": 1611673111, "channels": [ { "id": 196641965, "parameters": [ { "id": 565740866, "value": 24.0 }, { "id": 4249621549, "value": 20.8 170 } ] } ] } } Параметры и каналы могут быть идентифицированы по ключам id (их тип и значения совпадают с одноимѐнными ключами из ответа на запрос текущих данных измерений прибора). Отсутствие ключа value означает, что в тот момент была ошибка вычитывания этого параметра (неисправность на приборе или обрыв связи с ним). 171 Приложение H. Формат CSV-отчѐта Первая строка файла csv-отчѐта содержит информацию о версии формата отчѐта, технологическом номере прибора, для которого был сгенерирован отчѐт, имени этого прибора, а также количестве строк с данными измерений. Пример: ##EVL CSV 2.0|TechNum=10085463|Name=ИВТМ-7-/2 С|DataCount=19## Вторая строка файла отчѐта содержит заголовки столбцов. Первый столбец – дата и время, остальные – индекс параметра (для радиомодема с приборами-каналами – адрес прибора), символ измеряемого параметра и единицы его измерения. Пример: Datetime,"[0] T, °C","[0] H, %","[0] T, °C","[1] H, %" Далее идут данные измерений через запятую, которые предваряет дата и время их фиксации. Пример: 1588246111,21.6,46.4,25.3,42.4 Формат даты и времени – стандартный формат unix-time (количество секунд, прошедших с полуночи 1 января 1970 года). Файлы csv-отчѐта выгружается в кодировке Windows-1251. 172 Приложение I. Политика модернизации Eksis Visual Lab Программный комплекс EVL многофункционален, но некоторые потребности пользователей могли остаться незамеченными. Если вам необходимо добавить/оптимизировать какую-либо функцию, исправить ошибку, то обязательно свяжитесь с нами (см. раздел «Контактная информация»). Если предлагаемое изменение будет полезно всем пользователям (например, добавление популярных форматов экспорта статистики или расширение набора команд протокола сетевого обмена), то они могут быть реализованы бесплатно. Если изменение довольно специфично или сильно рушит архитектуру программы, то оно может быть внесено отдельной версией за отдельную плату. Мы заинтересованы в постоянном развитии нашего программного обеспечения и будем благодарны за любые отзывы и предложения. 173 Приложение J. Контактная информация АО «ЭКСИС» mail: eksis@eksis.ru сайт: www.eksis.ru адрес: 124460, Москва, Зеленоград, а/я 146 АО «Практик-НЦ» mail: pnc@pnc.ru сайт: www.pnc.ru адрес: 124460, Москва, Зеленоград, а/я 13 тел.: 8 (800) 222-97-07, 8 (800) 707-75-45, +7 (495) 506-40-21, +7 (495) 506-58-35, +7 (495) 505-42- 22, +7 (495) 531-68-28. По вопросам программного обеспечения обращайтесь на software@pnc.ru |