KCSLogger

Материал из TekonWiki
Перейти к: навигация, поиск

 


Введение

Внимание! Важно!
При обновлении программы на версию 8.0.5.19 (и выше) следует учитывать, 
что для квартирных 3-х фазных ЭЩ теперь используются драйверы EXT, а не EXT-2.
В случае, если ранее квартирные 3-х фазные ЭЩ использовали EXT-2, следует
в настройках установить флаг "Исп. для кварт. 3-х фазных ЭЩ  драйвер EXT-2"
Последняя актуальная версия драйверов устройств может быть загружено в обновлении KCSLogger на странице загрузок https://www.tekon.ru
При использовании в Tekon OPC-сервере драйвера KCSLogger в версиях АСУД.SCADA до 2.6.0, не следует выполнять обновление KCSLogger до версии 8.0.10.41 от 30-01-2019 или выше (подбробнее см. в разделе Опрос ОРС-сервером)

Версии программы

8.0.11.6 от 29-10-2020

  • Меркурий 23х (исправлено чтение профилей мощности)
  • КИР-RS (тип данных значений интеграторов исправлен на беззнаковый целый)
  • Прочие драйверы (коррекция типов Int -> UInt)

8.0.11.5 от 26-10-2020

  • Исправления драйверов Modbus RTU(TCP), SonoSafe: типы INT64, DOUBLE
  • Принудительная проверка настроек интерфейса КЦС-IPM перед опросом, если на разных интерфейсах концентратора подключены устройства с одинаковым RS-адресом
  • Уменьшено время ожидания после перенастройки интерфейса КЦС-IPM до c 3 до 1 с.

8.0.11.4 от 10-10-2020

  • Версия сборки 2.6.3. Несовместима с предыдущими версиями SCADA 
  • Изменена логики работы с Драйвер EXT-модуля
  • Возможность запроса драйверов на ключе, подключенном к другому АРМ

_________________________________________

ВЕРСИИ СБОРКИ ДЛЯ АСУД.SCADA  ДО 2.6.3

8.0.10.5 от 26-10-2020

  • аналог сборки 8.0.11.5
  • все следующие версии это аналог сборки 8.0.11.х

8.0.10.3 от 04-08-2020

  • В версиях .10.1 - .10.2 (АСУД.SCADA 2.6.2) -  драйвер KCSLogger в ОРС-сервере работал с ошибкой 801 (в окне Статистика для устройств с Упр.=OPC отображалась ошибка 801)
  • При указании номера конкретного концентратора в окне Настройки \ Разрешенные ID, могли загружаться несколько концентраторов (с похожими номерами)
  • При указании в окне Настройки \ Разрешенные ID  несуществующего ID, окно статистики вызывало ошибку

8.0.10.2 от 20-07-2020

  • Получасовые профили мощности для эщ Меркурий 23х
  • Энергомера СЕ-102R5.1

8.0.10.1 от 02-06-2020

  • Возможность опроса в режиме пуско-наладки только указанных номеров концентраторов и/или типов устройств
  • Модернизированное окно трассировки
  • Ускорена загрузка/выгрузка настроек больших объектов
  • Много мелких исправлений

8.0.9.44 от 03-03-2020

  • Исправлен опрос приборов ТВ-7, DIO-99, AVEKTRA, SonoSafe - ошибка код  = 101 (в окне Статистика)  в версиях  KCSLogger    х.10.39 - х.10.43

8.0.9.43 от 02-03-2020

  • Исправления в драйвере устройств Меркурий 23х.  Могла не читаться запись помесячного расхода за Январь месяц. 

8.0.9.42 от 12-02-2019

  • Исправлена ошибка с закрытием TCP-сокетов (версии 8.0.10.41) при выгрузке программы и тестовом опросе из ASUDBase 

8.0.9.41 от 30-01-2019

  • Совместимость со сборкой АСУД 2.6.0 при использовании в  Tekon OPC-сервер драйвера  KCSLogger
  • Изменения в системе логирования (новый параметр в конфигурации: Логировать только указанный IP)

8.0.9.40 от 22-01-2019

  • В версиях драйверов  x.9.38, x.9.39  была ошибка, приводящая к появлению сообщения "Privelege instructiuon"  при открытии меню Настройка \ Регистрация   в программе ASUDBase

8.0.9.39 от 14-01-2019

  • Устранена ошибка в разборе ответа устройств KCSLogger в OPC-сервере (в окне Статистика, было указано Ошибка в ответе ОРС-сервера)

8.0.9.38 от 10-01-2019

  • Ошибка при Ping-е мастер-устройства приводит к увеличению параметра ErrCnt
  • В случае ошибок в опросе время блокировки составляет треть интервала опроса (раньше было 30 минут)

8.0.9.37 от 17-12-2019

  • Изменено масштабирование окон

8.0.9.36 от 18-09-2019

  • Работа с регистраторами импульсов Пульсар-2,4,6,10,16
  • Ускорен опрос устройств

8.0.9.35 от 05-09-2019

  • Тестовая версия.

8.0.9.34 от 12-08-2019

  • Несколько изменено отображение окна доступных EXT-драйверов
  • В случае неполного чтения архива общедомовых приборов последующее чтение могло проходить с задержкой в 30 минут (исправлено)

8.0.9.33 от 10-06-2019

  • В версии 8.0.9.31 - 32 некорректно отображалось значение запрошенных драйверов в окне статистики.

8.0.9.32 от 30-05-2019

  • В версии 8.0.9.31 некорректно отображалось значение запрошенных драйверов в окне статистики.
  • Допольнительная настройка ограничения опроса по IP и номеру интерфейса (для тестового режима чтения) 

8.0.9.31 от 11-04-2019

  • Автоматический перезапуск KCSLogger в случае необходимости при закрытии конфигуратора Tekon OPC-севера.

8.0.9.30 от 22-03-2019

  • Интеграция опроса устройств с Tekon OPC-сервер

8.0.9.29 от 03-03-2019

  • Изменен параметр настройки: "Потоков опроса" (подробнее см. ниже)

8.0.9.28 от 25-02-2019

8.0.9.27 от 18-02-2019

  • Исправлен длительный старт программы при большом числе приборов в отсутствии необходимого числа лицензий на ключе

8.0.9.26 от 12-12-2018

  • Исправлен тестовый опрос устройств в ASUBase (кнопка Опрос) с параметрами интерфейса 8-N-2

8.0.8.25 от 15-11-2018

  • Дополнительные настройки программы
  • Поддержка КИР-16 исп. TL-RS

8.0.7.24 от 19-06-2018

  • Квартирный Modbus-счетчик как Драйвер-EXT

8.0.6.23 от 13-02-2018

  • Возможность сохранять первое значение Modbus-устройств на начало суток
  • Добавлены информационные столбцы в окно Статистики

8.0.5.23 от 28-12-2017

  • Возможность сохранять первое значение Modbus-устройства на начало суток - реализация некорректна

8.0.5.21 от 13-12-2017

  • Корректная сортировка по полю Адрес с учетом номера квартиры
  • Убрана неточность в отображении КИР-RS с привязкой к квартирам (один концентратор отображался несколько раз)
  • Скорректировано условие определения времени первоначального опроса устройства после перезапуска программы
  • Отображение версии в заголовке окна

8.0.5.20 от 25-10-2017

  • Улучшена интеграция с АSUDBаse для выполнения (из ASUDBase) тестового опроса выбранного устройства.
  • В окне Статистики
    • отображается Корпус, Строение в адресной строке
    • фильтрация по IP-адресу
    • возможность опросить все устройства повторно

8.0.5.19 от 25-08-2017

8.0.4.18 от 25-07-2017

  • Если прибор учета не передает часовой или посуточный архивы (например: Меркурий 200), можно сохранять первую запись мгновенных значений, как значение на начало суток (при этом в БД будет создаваться виртуальный посуточный архив).
  • Интеграция с ASUDBаse для выполнения (из ASUDBase) тестового опроса выбранного устройства

8.0.3.17 от 06-07-2017

  • Добавлен анализ времени последнего опроса устройства при старте программы
  • После запуска не опрашиваются устройства, которые недавно уже были опрошены (раньше после перезапуска программы принудительно опрашивались все устройства)
  • Изменено время блокировки опроса устройств (на 30 минут), с которыми нет связи
  • Убран флажок Блокировать опрос IP-адреса
  • Добавлена возможность фильтрации отображаемой информации в окне Статистики
  • Добавлен параметр Качество RS-линии связи в окне Статистики
  • Исправлена сортировка в столбцах окна Статистики

8.0.2.17 от 26-06-2017

  • Устройства с интервалом опроса = 0, расцениваются как "Быстрые устройства"

8.0.1.9 от 19-08-2015

  •  

7.0.0.8 от 03-02-2015

Обновление ПО

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

При настройке нового объекта всегда используйте последние версии программ: KCSLogger и ASUDBase.

Назначение

КСSLogger - программа расположенная в папке Tekon \ OPC Server \, и выполняющая опрос приборов учета и других устройств сторонних производителей, подключенных к концентраторам КЦС-IPM (КУН-IP) или доступных напрямую по компьютерной сети.

В общем случае устройство, подключаемое к системе АСУД-248, опрашивается KCSLogger, если оно регистрируется в ASUDBase, например:

  • прибор учета или контроллер, зарегистрированный в программе ASUDBase

В тоже время все, что зарегистрировано в конфигураторе ОРС-сервера, например: 

  • DA Tekon \ КЦС-IPM \ КСЛ-RS - опрашивается программой OPC-сервер

 

Внимание!

На один и тот же IP-концентратор могут быть подключены устройства опрашиваемые и OPC-сервером и KCSLogger, например в данной конфигурации:

КЦС-IPM

  • Интерфейс RS-485(1)
    • КСЛ-RS
    • УПСЛ
  • Интерфейс RS-485(2)
    • Теплосчетчик ВИС.Т

Начиная с версии 8.0.9.30 KCSLogger допускает опрос устройств зарегистрированных в ASUDBase непосредственно ОРС-сервером (версии 2.5.0 или выше).
Это позволяет физически подключать на IP-концентраторы, как RS-концентраторы, опрашиваемые ОРС-сервером, так и приборы учета (и/или контроллеры), опрос которых раньше выполнялся только KCSLogger.
Для этого в конфигурацию Tekon OPC-сервер добавляется драйвер-устройство KCSLogger (подбробнее см. документацию на ОРС-сервер).

Запуск программы

Первый запуск программы следует выполнить под пользователем с административными правами. При установке флажка Запускать при старте Windows - программа будет впоследствии запускаться автоматически после запуска Windows (и автоматически будет запускаться опрос приборов).

Для запуска опроса зарегистрированных приборов следует нажать кнопку Запуск.

Работа программы

Задания опроса читаются из БД OPC Server \ original.gdb

Настройка БД осуществляется с помощью программы ASUDBase (документация на программу представлена на сайте tekon.ru).

Опрос выполняется последовательно для каждого устройства подключенного к первому КЦС-IPM, затем ко второму КЦС-IPM и так далее.

Если в процессе опроса устройства возникает ошибка, то следующая  попытка опроса будет предпринята через 1 минуту. 

Если ошибка повторяется несколько раз подряд, то:

  • если ошибка связана с ошибкой сети (код 901), то последующий опрос произойдет через30 минут
  • если ошибка иного рода, то последующий опрос произойдет через время равное трети интервала опроса  (но не быстрее чем через 30 минут).

Результаты опроса аккумулируются в базе данных OPC Server \ original.gdb

Затем данные опроса могут быть визуализированы в SCADA с помощью дополнительных примитивов типа Прибор учета  или путем создания тегов в ОРС-сервере с помощью драйвере Database.

Статистика работы

Статистика работы (процесс опроса) отображаются в окне Статистики (кнопка Статистика).

В окне отображается состояние опроса всех устройств, как опрашиваемых программой KCSLogger так и ОРС-сервером.

KCSLogger2.PNG

Поля таблицы:

  • № - номер сквозной нумерации
  • Адрес - адрес установки концентратора (устройства) с указанием квартиры
  • Конц. - номер концентратора из БД (или 0 если запись прочитана из настроек ОРС-сервера)
  • Тип - тип подключения устройства (через КЦС-IPM, КУН-IPM или прямое-IP).
  • IP- ip-адрес концентратора (или устройства, если используется прямое IP подключение)
  • Порт - номер порта.
  • Интерф.- интерфейс подключения и RS-идентификатор устройства
  • Устройство - тип устройства (если вместо названия отображается числовое значение, то драйвер устройства не найден).
  • Ист. - источник записи (БД или файл настроек ОРС-сервере (для КИР-RS или КДД-RS))
  • Упр. - программа, выполняющая опрос устройства.
    • ОРС - ОРС-сервер, при этом информация о статусе опроса будет отображаться в данном окне
    • KLOG - KCSLogger
  • Оц-ка - оценка опроса устройства ( 0 - ошибка доступа к устройству или устройство еще не опрашивалось, > 0 - успешный опрос устройства)
  • Пред. опрос - время предыдущего опроса устройства.
  • След. опрос - дата и время следующего опроса устройства. Для Упр = ОРС - отображается только для случая Ошибка = 0, иначе время опроса определяется ОРС-сервером, подробнее см. ниже.
  • Ошибка - код последней ошибки (0 - нет ошибки, для расшифровки ошибки следует выделить строку и навести мышкой на код ошибки).
  • ErrCNT - число ошибок опроса прибора (опрос не удался) с момента старта программы
  • Ext - число запрошенных драйверов EXT
  • Ext-2 - число запрошенных драйверов EXT-2
  • Инт-л - интервал опроса устройства в минутах
  • Инт-л* - реальный интервал опроса устройства в минутах
  • Линия RS (%) - условно усредненный параметр качества линии связи RS-485(232), определяется как отношение числа успешных обменов данными к общему числу обменов.

Внимание! Важно! Относительно параметра Оценка.

Парамерт оценка не всегда может совпадать со значением параметра Code (Оценка) в программе ASUDBase и в данных DBMonitoring

Например, при старте KCSLogger все зарегистрированные устройсва получают бузесловную оценку 1, в то же время в  ASUDBase устройства, которые имели положительную оценку до закрытия программы KCSLogger получает значение оценки 10, а прочие - 0. 

Фильтр устройств позволяет указать набор отображаемых данных:

  • ВСЕ - все устройства
  • Опрашиваемые сейчас - устройства, опрашиваемые в настоящее время
  • С ошибками - устройства, последний опрос с которыми был завершен с ошибкой
  • Без ошибок - устройства, последний опрос с которыми был завершен без ошибки
  • Упр=ОРС - устройства, опрашиваемые ОРС-сервером
  • Упр=KLOG - устройства, опрашиваемые данной программой
  • По типу выбранного устройства

Установив флажок Опросить всех сейчас, можно принудительно запустить повторный опрос устройств (для устройств с полем Ошибка = 0, время Следующего опроса будет скорректировано). Можно сбросить время опроса ВСЕХ устройств, или предварительно выбрав нужный IP-адрес в фильтре устройств. Данная опция действует только на устройства Упр=KLOG.

Установив временно флажок Блокировать обновление таблицы, вы можете выполнить сортировку по столбцам путем клика мышкой на названии столбца

В этом же окне отображается общее число устройств сторонних производителей (Драйверов EXT-модулей), которые могут быть визуализированы в ПО АСУД.SCADA (которые будут опрашиваться программой KCSLogger).


Информация по EXT-драйверам

Начиная с версии 8.0.11.4 в работу с EXT-драйверами были внесены измнения.

Теперь драйверы, записанные на ключ защиты не используются программой KCSLogger в монопольном режиме.

Подробнее об изменениях смотри в статье Обновление по работе с драйверами 2020

В окне статистики в данных о доступных драйверах, теперь отображается не общее число драйверов, записанных на USB-ключ защиты, а число драйверов доступных программе KCSLogger (т.е. число  число драйверов, записанных на USB-ключ защиты, минус число драйверов, используемое другими программами, например: Tekon OPC-сервер).

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

В связи с нововведениями KCSLogger версий  8.0.11.4 и выше совместим только с версиями SCADA 2.6.3 и выше.
При устновке обновления KCSLogger  на предыдущую версию SCADA, информация по EXT-драйверам окажется недоступна.

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

Замечания KCSLogger - ОРС-сервер

Рекомендуется настраивать опрос устройств ОРС-сервером, только когда на одном IP-концентраторе подключены RS-концентраторы (не регистрируемые в БД original.gdb) и приборы учета (контроллеры), регистрируемые в БД original.gdb  В этом случае вы регистрируете в OPC-сервере, например: КЦС-IPM, и подключенные RS-концентраторы +  добавляеете драйвер KCSLogger (информируя сервер о том, что на данном концентраторе также будут подключены устройства, зарегистрированные в БД).

В других случаях рекомендуем настраивать систему так, чтобы опрос осуществлялся только программой KCSLogger. Это удобно, с точки зрения, независимой работы (и настройки) системы диспетчеризации и учета.
В ОРС-сервере при этом можно зарегистрировать только сам IP-концентратор, например: КЦС-IPM, для возможности отображения в SCADA  состояния концентратора.

Если устройства БД опрашиваются ОРС-сервером (через драйвер KCSLoggger), то в случае ошибки время следующего опроса будет определено:

  • для устройств с интервалом опроса < 10 с. будет выполнено 10 попыток опроса с интервалом в 30 секунд
  • для прочих устройств - 3 попытки опроса с Интервалом = Интервал опроса / 5, и далее следующий опрос через интервал опроса.

Внимание! С версией АСУД.SCADA 2.6.0 (при использовании в ОРС-сервере драйвера KCSLogger) совместимы версии программы KCSLogger  8.0.10.41 и выше.
Версии 8.0.10.41 и выше  не совметимы с АСУД.SCADA 2.5.х  (при использовании в ОРС-сервере драйвера KCSLogger)

Если в окне статистики программы KCSLogger у вас в столбце Упр. везде указано ОРС - т.е. фактически весь опрос осуществляется ОРС-сервером, то программа KCSlogger по сути никакой работы не выполняет кроме отображения статистики и может быть закрыта. 
За исключением одного НО.   Если вы планируете выполнять команды, т.е. записывать значения из SCADA на подключенные устройства (обычно Modbus-контроллеры), то программа KCSLogger должна быть запущена всегда, как обычно.  Обработка команд централизованно осуществляется программой KCSLogger, даже если все устройства опрашиваются из OPC-сервера.

Настройка программы

Настройки влияют и на программу KCSLogger и на драйвер KCSLogger (если используется)  в ОРС-сервере.

Настройки перечитываются при перезапуске ПО.

Настройка программы:

  • Лог-файл - вести или нет файл протокола работы
    • OPC Server \ log \ kcs_ip.log  - для устройств опрашиваемых программой
    • OPC Server \ log \ kcs_ip_opc.log  - для устройств опрашиваемых OPC-сервером
  • Период обновления статистики - период обновления окна статистики (изменять не рекомендуется)
  • Потоков опроса - число потоков опроса. При протоколировании работы (включенном лог файле) или в случае ошибок рекомендуется установить в 1 иначе установить в 0 (программа сама определит оптимальное число).
  • Медленных устройств в опросе - сколько "медленных устройств" следует опросить за одно обращение к КЦС-IPM. По умолчанию 0 (не использовать ограничений в опросе устройств).
  • Разрывать соединения для IP - указать IP-адреса (через ;), для которых надо закрывать IP-соединение после обмена данными (по умолчанию - пусто). Может потребоваться для некоторых типов приборов.
  • Записывать первые мгновенные ... (с версии 8.0.4.18) - если прибор учета передает только помесячный архив, можно сохранять первую запись мгновенных значений как значение на начало суток (при этом в БД будет создаваться виртуальный посуточный архив).  - Обычно следует включить данную опцию.
  • Исп. для кварт. 3-х фазных ЭЩ драйвер EXT-2 - учитывать для данных электросчетчиков драйвер EXT-2, а не EXT, как это делается по умолчанию в новой версии программы.

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

Работа с программой в период пуско-наладки

В период проведения пуско-наладочных работы вы можете воспользоваться следующими специальными возможностями программы.

Ограничение списка загружаемых устройств

Возможно ограничить список устройств подгружаемых для опроса из БД. Для этого в меню Настройки программы можно указать один или несколько дополнительных параметров

  • Разрешенные IP - указать перечень IP-адресов (через ;), опрос которых будет выполняться программой.
  • Разрешенные ID - указать ID-драйверов приборов (через ;) или ID-концентраторов, опрос которых будет выполняться программой
    • 1201; 901; 902  - загружать только устройства Modbus-TCP (Id = 1201)  и концентраторы номер 901 и 902
    • 901 - загрузить только концентратор номер 901
  • Log только для WorkID - выполнять логирование данных только для указанного ID работы. ID-работы можете посмотреть в лог-файле log \  kcs_ip.log (параметр  - WID: )

С версии программы 8.0.9.32 в Разрешенные IP адреса можно также указывать тип интерфейса, например: 192.168.1.200:0;

Где:

  • 0 – интерфейс RS-232
  • 1 – интерфейс RS-485-0 (A0_B0)
  • 2 – интерфейс RS-485-1 (A1_B1)

Соответственно,  192.168.1.200:0 - будут опрашиваться только приборы с IP 192.168.1.200, подключенные на интерфейс RS-232.

Трассировка

Трассировку удобно использовать для поиска проблем с опросом устройста(в)  без необходимости включения Лог-файла.

Трассировка доступна только для  устройств Упр. = KLOG. Для логгирования устройств, опрашиваемых ОРС-сервером, возможно использовать только Лог-файл, возможно с включенной опцией "Log только для WorkID"  в Настройках приложения.

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

В открывшемся окне будет отображаться информация по обмену данными со всеми устройства, подключенными на тот же IP-адрес, что и выбранное устройство. 

Kcslogger tracer.PNG

В окне отображаются последние 1000 строк обмена данными. 

Дополнительные возможности:

  • Отображать также сообщения драйвера - в лог будут включены дополнительные сообщения драйвера устройства
  • Блокировать обновление - блокировать обновление сообщений
  • Сохранить - сохрать лог-трассировки в файл

Медленные и быстрые устройства

Дополнительная информация для продвинутых пользователей

В программе все опрашиваемые устройства (на уровне драйверов) условно разделены на два типа:

  • медленные, полный опрос которых занимает значительное время, например, до нескольких минут (это, например, приборы учета) и информацию, с которых можно обновлять по мере возможности
  • быстрые, опрос которых не занимает значительного времени и/или должен происходить чаще, чем медленных устройств.

К быстрым устройствам относятся, например, КДД-RS и КИР-RS при опросе состояния дискретных датчиков, а также те устройства, для которых Интервал опроса в программе ASUDBase выставлен в 0.

Поскольку на один концентратор КЦС-IPM (КУН-IP) могут быть подключены и быстрые и медленные устройства, может возникнуть проблема, связанная с тем, что поскольку программа последовательно опрашивает все устройства, подключенные к данному концентратору, опрос быстрых устройств будет замедляться на время необходимое для полного опроса всех медленных устройств.

Поясним это на примере. Предположим есть КЦС-IPM, к которому подключены:

  • 2 КДД-RS (опрос 1 КДД-RS занимает около 1 секунды).
  • 120 электросчетчиков (опрос 1 прибора занимает около 30 секунд, опрос всех приборов занимает, соответственно, 60 минут).

Пусть интервал опроса электросчетчиков выставлен 3 часа. Интервал опроса КДД-RS - 1 секунда.

Поскольку полный опрос всех электросчетчиков занимает столь значительное время, фактически это приводит к тому, что КДД-RS после начала опроса электросчетчиков будет опрошены только через 60 минут, что конечно же неприемлимо.

Для улучшения данной конфигурации существует возможность указать в настройках значение параметра "Медленных устройств в опросе" > 0.

Например: при установке значения параметра в 1, опрос будет проходить по следующему алгоритму:

  • Опрос КДД-RS
  • Опрос 1-го электросчетчика
  • Опрос КДД-RS
  • Опрос 2-го электросчетчика
  • ...

Т.е. при каждом обращении к КЦС-IP будут опрошены сначала все быстрые устройства и лишь указанное число медленных устройств.

При установке параметра в 2:

  • Опрос КДД-RS
  • Опрос 1-го электросчетчика
  • Опрос 2-го электросчетчика
  • Опрос КДД-RS
  • ...