KCS DEMO.EXE

Введение

Версия:

16-02-2022
 + сканирование указанных в файле идентификаторов приборов учета
19-10-2021
 + при отправке данных через COM-порт добавлена пауза в 50 мс
24-02-2021
 + существенно переработан интерфейс программы
25-09-2020  
 + кнопка запуска IPSet сразу передает IP-адрес выбранный в KCS_DEMO
15-10-2019
 + кнопка запуска IPSet из программы KCS_DEMO 
26-08-2019
 + ускорен опрос устройств
 + незначительные изменения окна настройки Modbus
12-08-2019
 + убрано повторное открытие окна ввода регистров при сканировании modbus-устройств
31-05-2019
 + возможность сканирования RS-номеров выбранного устройства
14-11-2018 
 + Явное указание даты версии в заголовке окна программы
 + Кнопка Драйвер \ Настроить (подробнее см. далее)
2.2.1.29  20.11.2017
 + Поддержка Local echo off для всех подключений
 + Кнопка сохранения окна Лога в файл 
 + Кнопка коррекции времени устройства
2.2.0.28  10.11.2017
 + Поддержка Local echo off для COM-порта
2.2.0.26  03.03.2017
 + Работа с COM-портами 
 + ... (много всего)
2.1.0.19  18.12.2015
2.0.2.15  18.08.2015
2.0.1.4   30.05.2014

Назначение

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

• RS-интерфейсу к КЦС-IPM / КУН-IPM / КИО-RS (напрямую или через преобразователь),
• COM-порту
• компьютерной сети (TCP/IP).

Является крайне полезной утилитой при тестировании подключения стороннего оборудования (счетчиков, контроллеров) к системе АСУД-248, проверки линии связи и тестового обмена данными без какой-либо настройки устройства в ПО АСУД.SCADA. 

Для работы с программой не требуется наличие Драйверов EXT-модуля.

Если вы хотите проверить работу RS-концентраторов АСУД-248,  вы также можете это сделать непосредственно в Tekon OPC-сервер,  воспользовавшись устройством RS-Тестер, которое может быть добавлено к любому IP-концентратору.

Перенос программы на отдельный ПК

Если необходимо запускать программу на отдельном ПК (Ноутбуке), то достачно установить на нем пакет update_logger_drivers.zip,  в который входит утилита KCS_DEMO (или полный дистрибутив ПО АСУД.SCADA).

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

Внимание! 
Перед началом работы с программой следует отключить все приложения,
которые могут осуществлять опрос тестируемого оборудования:
* KCSLogger 
* ASUDBase
* Tekon OPC Server - остановить службу Windows (предварительно закрыв программу АСУД.SCADA).
Это следует выполнить, если тестируемое устройство уже добавлено в рабочую конфигурацию или 
в конфигацию добавлен КЦС-IPM / КУН-IPM / КИО-RS, к которому подключено устройство.

Программа располагается в папке  ...\OPC Server\tools-server

В случае, если тестируемое устройство подключено к концентратору КЦС-IPM / КУН-IP следует предварительно выполнить настройку интерфейса концентратора с помощью программы IPSET.EXE

Начиная с верии 24-02-2021 окно программы переработано и настощий момент выглядит следующим образом

Окно KCS_DEMO предыдущей версии на рисунке ниже.

Программа KCS_DEMO

Если вы хотите работать в предыдущей версии программы, следует открыть файл kcs_demo_old.exe 
Документация по предудыщей версии доступна по ссылке.

Порядок работы с программой

Выбрать драйвер устройства - обычно наименование драйвера совпадает с именем устройства, или с протоколом работы устройства (например, Modbus).

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

-==Информация об устройстве==-
Прибор: СЕ-102 код по БД:1021 Архив: С М 
Число проходов для доступа к архиву: 1
Тип драйвера EXT-модуля: EXT
Версия файла: 18.0.3.20
---

Где,

• Код по БД : 1021 - цифровой идентификатор драйвера
• Архив - типы архивов поддерживаемые устройством:
  • Ч - почасовой
  • С - посуточный
  • М - помесячный
• Число проходов по архиву - служебная информация.
• Тип драйвера EXT-модуля - указывает тип драйвера, который должен быть записан на USB-ключ защиты для автоматического опроса устройства в программе KCSLogger или Tekon OPC-сервер (для опроса в KCS_DEMO драйверы не нужны)

Далее во кладке Подключение следует установить параметры связи:

• IP - IP адрес КЦС-IPM, КУН-IP, КИО-RS или непосредственно устройства.
• В случае если программа обнаружит свободные COM-порты на ПК их наименование будет выведено в список. При выборе СОМ-порта будут активированы параметры его настройки:
  • Скорость
  • Бит данных
  • Четность
  • Число стоп бит
  • TimeOut (мс) - по умолчанию 2500.
• Порт - обычно 5000 (при работе с КЦС-IPМ, КУН-IP, КИО-RS).
• Local echo off - игнорировать "эхо". Может быть необходимо для преобразователей подключаемых к COM-портам (реже для других типов).

Далее перейти во вкладку Опросить и указать

• RS-номер - RS-идентификатор, сетевой адрес устройства, например: в сети RS-485. В некоторых случаях, если подключено одно устройство можно указывать "бродкастный адрес". Подробнее об указании RS-номера, следует смотреть в документации на конкретное устройство в разделе Интеграция.
• Доп. инфо - дополнительная информация, может быть указана в случае необходимости, см. документацию на устройство в разделе Интеграция. При выборе драйвера устройства, для которого следует указывать дополнительную информацию, поле будет заполнено значением по умолчанию для данного типа устройства. Для драйвера M-Bus в поле доп.информация по необходимости можно указать hex-код команды Application Reset (например: 00, C0 и т.п.)
• Фикс. - не изменять значение поля "Доп. инфо" указанное пользователем в ручную.

После того как вы указали адрес устройство вы можете запросить данные Служебные или Текущие.

• Служебные - данные о внутренних настройках устройства.
• Текущие (мгновенные) - данные текущих измерений.

Для тестирования проверки связи без разницы какие данные будет запрошены. 

Пример запроса мгновенных (текущих) значений.

Программа KCS_DEMO

• ">>" - запись данных в устройство
• "<<" - чтение данных из устройства
• "П=" - обозначает код параметра (служебная информация) и его значение, успешно считанное с прибора.

В случае возникновение ошибки, ее код и описание будут указаны в значении Result.

Описание типовых ошибок

Код ошибки	Описание ошибки	Пояснение ошибки
0	Нет ошибки
1	Ошибка Нет устройства (TCP тайм-аут)	За указанное время от устройства не получен ожидаемый ответ. Устройство с таким RS-идентификатором отсутствует.
101	Ошибка формата пакета	Некорректный ответ устройства. Ошибка в протоколе или реализации драйвера устройства
102	Ошибка Сетевой номер не верен	Ответ пришел от устройства с другим RS-идентификатором
131	Ошибка Архив пуст	В архиве устройства отсутствуют данные
132	Ошибка Архив не поддерживается	Устройство не поддерживается запрашиваемый тип архива
602	Ошибка команды ответа	Устройство вернуло неожиданный ответ. Ошибка в протоколе или реализации драйвера устройства
603	Ошибка CRC	Помеха в линии связи.
702	Ошибка нет инициализации	Необходимо предварительно инициализировать устройство (нажав Инициализация)
801..899	Ошибка драйвера	Некорректная реализация драйвера. Следует обратиться в Текон-Автоматика
901	Ошибка Пинг	Нет связи до КЦС-IPM (КУН-IPM) или непосредственно до устройства, подключенного напрямую к компьютерной сети
908	Ошибка. Входные данные некорректны	Некорректно указан RS-идентификатор устройства. Следует закрыть драйвер и указать корректный идентификатор. Или некорректно указаны Дополнительные параметры
909	Опрос устройства блокирован (Драйвер-Ext)	Для опроса устройства требуется приобрести Драйвер Ext-модуля

В случае необходимости связаться со службой технической поддержки Текон-Автоматика, следует сохранить результаты обмена данными с устройством, нажав кнопку Сохранить, и переслать его по электронной почте с описанием типа подключаемого устройства и описанием проблемы.

Главное меню программы

Файл 

• Отображать подсказки - выводить ли подсказки на элементах управления
• Выход - закрыть программу

Работа с драйвером

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

Поиск устройств по RS-идентификаторам

Программа позволяет для выбранного устройства провести "сканирование" сети путем перебора RS-номеров (сетевых адресов)

Поиск можно осуществлять: 

• последовательным перебором RS-идектификаторов;
• выборочной проверкой указанного набора RS-идентификаторов.

Для начала следует выбрать драйвер устройства.

В случае последовательного перебора, следует в поле RS-идентификатор указать начальный RS-номер, а в поле До  RS-номера (ниже) указать конечный адрес.

В случае выборочной проверки следует указать через пробел требуемые RS-идентификаторы либо имя текстового файла, в котором эти идентификаторы перечислены построчно.

Пример файла идентификаторов testnum.txt

12321
22333
34412
42323
54434

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

Найденные номера устройств будут отображены в открывшемся окне  или в файле c окончанием _result.txt

Поиск можно прервать, нажав кнопку Стоп.

Задание нового RS-идентификатора

Для некоторых типов устройств возможно обновление Идентификатора устройства (адреса устройства в сети) - RS-номера.

При этом для драйвера становится активно меню Работа с драйвером \ Задать RS-номер.

Зачем может потребоваться менять Идентификатор? Как правило, при выпуске устройства программируются с Идентификатором "по умолчанию", а при объединении их в сеть необходимо, чтобы адрес каждого устройства был уникальным в данной сети

Как правило, идентификатор меняют, подключившись к стройству напрямую.

Последовательность действий по при этом:

• к ПК (через преобразователь) должен быть подключен только один прибор
• ввести в поле RS-идентификатор текущий Идентификатор или бродкастный адрес
• нажать Служебные, проконтролировать ответ устройства
• нажать Задать RS-номер и ввести новый идентификатор.

Коррекция времени

Некоторые приборы учета позволяют выполнить корректировку встроенных часов. Меню Работа с драйвером \ Коррекция для этих устройств активна.

Время корректируется по часам ПК. Перед проведением корректировки запросите Служебные данные устройства и убедитесь, что расхождение времени существенно и корректировка действительно необходима.

Внимание! Следует использовать с осторожностью.
Изменение времени может привести к "перестройке" архивных данных устройства.
Перед применением проверьте корректность времени ПК.

Обмен данными с КИР

Внимание! В версии АСУД.SCADA 2.6.1 и выше, вы можете выполнить тестовый вопрос устройства в том числе и  в конфигураторе OPC-сервера, добавив к IP-концентратору устройство КИР-16RS.
Кроме того, там реализован удобный сканер RS-устройств (RS-ТЕСТЕР)

Укажите параметры соединения, RS-номер устройства.

Нажмите Текущие.

В случае успешного обмена данными в окне отобразится примерно следующее

-==Инициализация==-
17:41:37:581 Драйвер InitDevice
17:41:37:583 >>[4] : 81 01 00 7E 
17:41:37:787 <<[3/3] : 81 81 03 
17:41:37:788 <<[4/4] : 0A 03 02 EC 
17:41:37:789 Драйвер : Тип: КИР-16-TL-RS
17:41:37:789 Драйвер : Читаю оперативные даныне
17:41:37:790 >>[4] : 81 09 00 76 
17:41:37:866 <<[3/3] : 81 89 01 
17:41:37:867 <<[2/2] : 21 D4 
Result = 0 -  Нет ошибки

-==Мгновенные значения==-
18:04:33:222 >>[4] : 81 05 00 7A 
18:04:33:340 <<[3/3] : 81 85 4F 
18:04:33:540 <<[80/80] : 2A 17 00 01 01 13 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 17 00 00 00 AA AA AA AA 21 75 
18:04:34:363 Драйвер : Канал: 1 11081 0
18:04:34:364 Драйвер : Канал: 2 11081 0
...
18:04:34:380 Драйвер : Канал: 16 11081 0
18:04:34:381 Драйвер : Шлейф: 1 10088 2
18:04:34:382 Драйвер : Наработка: 1 11060 0,383333333333333
18:04:34:383 Драйвер : Аккумулятор: 1 10084 1
18:04:34:384 Драйвер : Код ошибки: 1 10080 5
...
18:04:34:443 Драйвер : Шлейф: 16 10088 2
18:04:34:444 Драйвер : Наработка: 16 11060 0,383333333333333
18:04:34:445 Драйвер : Аккумулятор: 16 10084 1
18:04:34:445 Драйвер : Код ошибки: 16 10080 5
Result = 0 -  Нет ошибки  RecCount 81

Где 

Канал: 1 11081 0

• 1 - номер канала
• 11081 - код параметра  
• 0 - число импульсов нарастающим итогом, зафиксированное КИР с момента включения

Шлейф: 1 10088 2

• 1 - номер канала
• 11082 - код параметра  
• 2 - состояние шлейфа 
  • 0 : Result := 'Норма';
  • 1 : Result := 'Замкнут';
  • 2 : Result := 'Обрыв'

Наработка: 1 11060 0,383333333333333

• 1 - номер канала
• 11060 - код параметра
• 0,383333333333333 - число часов наработки (с момента включения концентратора)

Аккумулятор: 1 10084 1

• 1 - номер канала
• 10084  -  код параметра
• 1 - состояние АКБ
  • 0 : Result := 'Норма';  
  • 1 : Result := 'Отсутствует';
  • 3 : Result := 'Замкнут';
  • 4 : Result := 'Заряжается';
  • 7 : Result := 'Питание от АКБ'

Код ошибки: 1 10080 5

• 1 - номер канала
• 10085  -  код параметра
• 5 - битовая маска ошибок
  •  // открыт корпус
     ERR_STATE_OPENNED          = 1;
     // коррекция времени  только старый КИР
     ERR_STATE_TIME_CORRECT     = 2;
     // неисправен АКБ (отстутствует или потерял емкость)
     ERR_STATE_UPS_FAIL         = 4;
     // питание от линии связи
     ERR_STATE_POWER_LINE_FAIL        = 8;
     

Для просмотра импульсов также можно воспользоваться окном  Работа с драйвером \ Настройка Драйвера. 

Kir rs n1.PNG

В данном окне вы можете: 

• задать длительность паузы импульсов для каждого канал КИР-16TLRS (подробнее далее)
• опросить один концентратор
• опросить несколько концентраторов
• обнулить счетчики КИР-16

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

Kir rs n2.PNG

Для опроса нескольких устройсв откройте вкладку Несколько КИР-16 и укажите с какого по какой адрес необходимо опросить данные.
Внимание! В этом случае опрос будет осуществлен только концентраторов КИР-16.

Kir rs n3.PNG

Вы также можете воспользоваться опросом непосредственно в программе ASUDBase. Для этого введите пароль, выберите счетчик в Шаге 2, нажмите правой кнопкой мыши и выберите меню Показания каналов КИР.

Обмен данными с КИР-16 исп. TL-RS. Длительность паузы

Для настройки длительности паузы между импульсами КИР-16 исп. TL-RS следует выбрать раздел меню Работа с драйвером \ Настройка Драйвера. 

Настройка длительности возможна только для КИР с версией прошивки 21.1

Если версия прошивки концентратора >= 21.1,  то будет доступна кнопка Опросить

Kir rs n4.PNG

Нажмите ее для считывания текущих настроек.

Kir rs n5.PNG

В приведенном примере: 

• значение 3 - соответствует паузе 180 мс
• значение 6 - соответствует паузе 700 мс

Далее вы можете

• отредактировать значение для нужных каналов и нажать Записать 
• записать одно значение во все каналы, нажав Записать одно для всех

Обмен данными с КИР-RS. Длительность паузы

После обновления КИР-RS до прошивки 09-2021 ему также становится доступна настройка длительности паузы между импульсами.

Однако, в отличии от КИР-16,  данная настройка действует на все каналы КИР.

Следует выбрать раздел меню Работа с драйвером \ Настройка Драйвера. 

Нажать кнопку Опросить для чтения текущей настройка.

Нажать кнопку Записать для записи нового значения.

Обмен данными с Modbus-устройствами

Отдельно рассмотрим обмен данными с устройствами, работающими по протоколу Modbus.

С помощью программы KCS_DEMO можно:

• прочитать значения 1 - 3 регистров.
• уточнить параметры настройки Modbus-устройства:
  • базовый регистр;
  • возможность чтения группы регистров;
  • возможность чтения группы регистров с пропусками в группе.
• выполнить циклический опрос одного или нескольких регистров (см. Modbus сканер далее)

В программе следует выбрать драйвер в зависимости от реализуемого устройством протокола:

• Modbus RTU (для устройств, подключаемых по RS-485)
• Modbus TCP (для устройств, подключаемых по Ethernet)

Чтение одного регистра

Нажать кнопку "Текущие" и в открывшемся окне указать параметры чтения с устройства

Чтение Modbus

Подробнее о параметрах см. в Modbus-устройства

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

• Базовый регистр - 0 (в редких случаях 1).
• Читать за раз не более - 1 регистра.
• Пропуски - Нет.
• Адрес - указать Адрес читаемого регистра. Для указания Адреса в HEX, следует добавить впереди символ $, например: $A001.
• Адрес 2, Адрес 3 - оставить пустыми.

Нажать Ок.

Пронаблюдать ответ в окне справа (см. рисунок в п.6 выше).

В случае если не верно был указан РЕГИСТР , будет получено сообщение об ошибке

Чтение Modbus

Следует уточнить Регистр чтения и повторить чтение данных с устройства.

В случае если не верно был указан АДРЕС читаемого регистра, будет получено сообщение об ошибке

Чтение Modbus

Если при этом был указан Базовый регистр = 1, попробовать установить значение 0. Если был указан - 0, попробовать установить - 1.

При необходимости изменить параметры чтения, следует повторно перевыбрать  Драйвер устройства. После этого снова нажать "Текущие".

Уточнение для ADFweb_HD67044

Для конвертера M-bus ADFWeb HD 67044 в случае если ответ от опрашиваемого прибора не получен, будет получено сообщение об ошибке

Чтение Modbus

 

Уточнение общих параметров Modbus-устройства

После того, как был успешно прочитан один регистр устройства, можно попытаться уточнить общие параметры Modbus-устройства: можно ли читать группу регистров в одном запросе?

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

Для начала следует заполнить Адреса 3-х любых регистров устройства последовательно расположенных в таблице и указать параметры:

• Читать за раз не более - 1 регистра.
• Пропуски - Нет.

Нажать "Ок". Нажать "Текущие".

С устройства должны быть корректно считаны три значения.

Далее следует повторно нажать "Инициализация" и указать:

• Читать за раз не более - 0 регистра.
• Пропуски - Нет.

Нажать "Ок". Нажать "Текущие".

Если при этом опять считаются три значения без ошибки, то устройство поддерживает чтение группы регистров в одном запросе. При настройке Modbus-устройства в программе ASUDBase можно указать значение "Читать группу элементов" - 0 (т.е. любое количество). Следует отметить, что в документации на Modbus-устройство может быть ограничено максимальное число элементов группы, поэтому рекомендуется указывать не 0, а например: 10 или 5.

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

Для этого следует ввести Адреса 3-х непоследовательно расположенных в адресной таблице регистров и указать параметры:

• Читать за раз не более - 0.
• Пропуски - Да.

Нажать "Ок". Нажать "Текущие".

Если при этом опять считаются три значения без ошибки, то устройство поддерживает чтение группы регистров с пропусками в одном запросе. При настройке Modbus-устройства в программе ASUDBase можно указать "Разрешать пропуски в группе".

По завершении закрыть драйвер, нажав Закрыть.

Modbus сканер

В утилиту добавлен фунционал схожий с программой ModScan32. 

Вы можете выполнить циклическое "сканирование" (опрос)  одного или нескольких последовательно расположенных регистров. 

Для этого, укажите базовые настройки подключения к Modbus-устройству: 

• драйвер Modbus RTU или Modbus TCP
• укажите RS-номер устройства
• укажите IP-адрес и порт
  • Порт 5000 - при подключении через КЦС-IPM
  • Порт 502 - при прямом подключении к устройству по протоколу Modbus-TCP
• закройте окно выбора регистров ничего не заполняя
• выберите меню Работа с драйвером / Настройка драйвера  (если меню недоступно, повторно выберите драйвер)

Kcs demo mb scan.PNG

В открывшемся окне укажите: 

• Базовый регистр - обычно 0 или 1.
• Начиная с адреса - с какого адреса выполнять опрос (для ввода адреса в hex начните его с символа $)
• Число элементов - сколько регистров читать 
• Тип - тип данных регистров
• Формат - формат преобразования чисел
• Размер строки - для типа STRING, размер кратен 2 (2, 4 и т.п.)

Нажмите кнопку Обновить. 

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

• Адрес (dec) - адрес регистра в 10-ной кодировке
• Адрес (hex) - адрес регистра в 16-ной кодировке
• Значение  - значение регистра 
• Значение (bin) - значение регистра в 2-ной кодировке
• Время - время последнего обновления значения
• Код ошибки - код ошибки
• Текст ошибки - описание ошибки

В случае необходимости, внесети изменения в настройки и повторно нажмите Обновить.

Обмен данными с M-bus устройством

Рассмотрим обмен данными с устройством, адреса которого мы не знаем.

1. Подключитесь к прибору напрямую с помощью M-Bus конвертера
2. Если конвертер настраивается укажите параметры интерфейса 2400 8-Е-1 (или уточните по документации на прибор)
3. Укажите RS-идентификатор = 0 (бродкастный адрес)
4. Нажмите Служебные

В случае корректного ответ прибора будут получены примерно следующие данные:

N=43349047 <-- SecondaryID 
PrimaryID=13 <-- PrimaryID 
Тип=Горячая вода 
Версия прибора=74 
Заводской номер=43349047

Закройте Драйвер.

В дальнейшем опрос устройства может проводиться с помощью указанных PrimaryID или SecondaryID. Подробнее об идентификаторах смотри статью M-Bus устройства.

Пример корректного обмена данными по SecondaryID (серийному номеру прибора)

Запись: 10 40 FD 3D 16 
Запись: 68 0B 0B 68 73 FD 52 02 01 90 83 FF FF FF FF D4 16 
Чтение: E5 
Запись: 10 7B FD 78 16 
Чтение: 68 
Чтение: B1 B1 
Чтение: 68 08 02 72 02 01 90 83 D3 10 02 04 1D 00 00 00 04 FB 0D ... 

Пример обмена данными по SecondaryID (серийному номеру прибора) - нет ответа, прибор занят. Следует выполнить опрос позднее.

Запись: 10 40 FD 3D 16 
Запись: 68 0B 0B 68 73 FD 52 02 01 90 83 FF FF FF FF D4 16 
Чтение: E5 
Запись: 10 7B FD 78 16 
Чтение: E5 

В случае необходимости вы можете поменять PrimaryID, нажав на кнопку RS-идентификатор.

Внимание! Следует учитывать тот факт, что в связи с особенностью реализации M-bus драйвера, 
повторное нажатие кнопки Текущие не приводит к перечитыванию информации с подключенного прибора.
Для полного обновления данных следует переоткрыть Драйвер.