KCS DEMO.EXE
Содержание
- 1 Введение
- 2 Назначение
- 3 Перенос программы на отдельный ПК
- 4 Запуск программы
- 5 Порядок работы с программой
- 6 Главное меню программы
- 7 Поиск устройств по RS-идентификаторам
- 8 Задание нового RS-идентификатора
- 9 Коррекция времени
- 10 Обмен данными с КИР
- 11 Обмен данными с КИР-16 исп. TL-RS. Длительность паузы
- 12 Обмен данными с КИР-RS. Длительность паузы
- 13 Обмен данными с Modbus-устройствами
- 14 Обмен данными с M-bus устройством
Введение
Версия:
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_kcslogger.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_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 и т.п.)
- Фикс. - не изменять значение поля "Доп. инфо" указанное пользователем в ручную.
После того как вы указали адрес устройство вы можете запросить данные Служебные или Текущие.
- Служебные - данные о внутренних настройках устройства.
- Текущие (мгновенные) - данные текущих измерений.
Для тестирования проверки связи без разницы какие данные будет запрошены.
Пример запроса мгновенных (текущих) значений.
- ">>" - запись данных в устройство
- "<<" - чтение данных из устройства
- "П=" - обозначает код параметра (служебная информация) и его значение, успешно считанное с прибора.
В случае возникновение ошибки, ее код и описание будут указаны в значении 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;
- // открыт корпус
Для просмотра импульсов также можно воспользоваться окном Работа с драйвером \ Настройка Драйвера.
- задать длительность паузы импульсов для каждого канал КИР-16TLRS (подробнее далее)
- опросить один концентратор
- опросить несколько концентраторов
- обнулить счетчики КИР-16
Для отображения показаний одного концентратора выберете вкладку Один и нажмите Опросить.
Внимание! В этом случае опрос будет осуществлен только концентраторов КИР-16.
Вы также можете воспользоваться опросом непосредственно в программе ASUDBase. Для этого введите пароль, выберите счетчик в Шаге 2, нажмите правой кнопкой мыши и выберите меню Показания каналов КИР.
Обмен данными с КИР-16 исп. TL-RS. Длительность паузы
Для настройки длительности паузы между импульсами КИР-16 исп. TL-RS следует выбрать раздел меню Работа с драйвером \ Настройка Драйвера.
Настройка длительности возможна только для КИР с версией прошивки 21.1
Если версия прошивки концентратора >= 21.1, то будет доступна кнопка Опросить
В приведенном примере:
- значение 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-устройства
При первом чтении с устройства установить следующие значения:
- Базовый регистр - 0 (в редких случаях 1).
- Читать за раз не более - 1 регистра.
- Пропуски - Нет.
- Адрес - указать Адрес читаемого регистра. Для указания Адреса в HEX, следует добавить впереди символ $, например: $A001.
- Адрес 2, Адрес 3 - оставить пустыми.
Нажать Ок.
Пронаблюдать ответ в окне справа (см. рисунок в п.6 выше).
В случае если не верно был указан РЕГИСТР , будет получено сообщение об ошибке
Следует уточнить Регистр чтения и повторить чтение данных с устройства.
В случае если не верно был указан АДРЕС читаемого регистра, будет получено сообщение об ошибке
Если при этом был указан Базовый регистр = 1, попробовать установить значение 0. Если был указан - 0, попробовать установить - 1.
При необходимости изменить параметры чтения, следует повторно перевыбрать Драйвер устройства. После этого снова нажать "Текущие".
Уточнение для ADFweb_HD67044
Для конвертера M-bus ADFWeb HD 67044 в случае если ответ от опрашиваемого прибора не получен, будет получено сообщение об ошибке
Уточнение общих параметров 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
- закройте окно выбора регистров ничего не заполняя
- выберите меню Работа с драйвером / Настройка драйвера (если меню недоступно, повторно выберите драйвер)
В открывшемся окне укажите:
- Базовый регистр - обычно 0 или 1.
- Начиная с адреса - с какого адреса выполнять опрос (для ввода адреса в hex начните его с символа $)
- Число элементов - сколько регистров читать
- Тип - тип данных регистров
- Формат - формат преобразования чисел
- Размер строки - для типа STRING, размер кратен 2 (2, 4 и т.п.)
Нажмите кнопку Обновить.
В таблице будет отображаться значения запрашиваемых регистров.
- Адрес (dec) - адрес регистра в 10-ной кодировке
- Адрес (hex) - адрес регистра в 16-ной кодировке
- Значение - значение регистра
- Значение (bin) - значение регистра в 2-ной кодировке
- Время - время последнего обновления значения
- Код ошибки - код ошибки
- Текст ошибки - описание ошибки
В случае необходимости, внесети изменения в настройки и повторно нажмите Обновить.
Обмен данными с M-bus устройством
Рассмотрим обмен данными с устройством, адреса которого мы не знаем.
- Подключитесь к прибору напрямую с помощью M-Bus конвертера
- Если конвертер настраивается укажите параметры интерфейса 2400 8-Е-1 (или уточните по документации на прибор)
- Укажите RS-идентификатор = 0 (бродкастный адрес)
- Нажмите Служебные
В случае корректного ответ прибора будут получены примерно следующие данные:
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 драйвера, повторное нажатие кнопки Текущие не приводит к перечитыванию информации с подключенного прибора. Для полного обновления данных следует переоткрыть Драйвер.
