Настройка библиотеки MBMasterCUP.library

 

Вход xExec предназначен для активации блока опроса. В переменной FuncCode указывается код функции Modbus из списка: 1, 2, 3, 4, 5, 6, 15, 16, 23. В переменной AddressRead для чтения регистров указывается начальный адрес Modbus регистра из таблицы регистров подключенного устройства, в QuantityRead количество регистров (не более 125 типа WORD и не более 2000 типа BOOL). В переменной AddressWrite для записи регистров указывается начальный адрес модбас регистра из таблицы регистров подключенного устройства, в QuantityWrite количество регистров (не более 123 типа WORD, не более 121 для 23 функции и не более 1968 типа BOOL). В переменной RequestTime указывается период выполнения запроса. Переменная WriteChanges активируется, если необходим режим автоматической записи при изменении записываемых данных, при этом вход xExec должен быть не активным. Переменная CleaningData активируется, если необходим режим сброса данных чтения при ошибке опроса.

Массив WriteData предназначен для хранения записываемых данных, запись в массив осуществляется при вызове методов типа Set.

Переменные RequestAccept, RequestComplete, AddressBase, ErrCode, ExcepCode предназначены для внутреннего взаимодействия ФБ MBChannel с MBPoll.

В соответствии с LagTime – фактическим временем выполнения запроса каналом – корректируется время вежду запросами RequestTime.

Выходные переменные

Выход xBusy активируется в момент обработки запроса. Выход xDone активируется при поступлении новых данных и выполнении запроса без ошибок. Выход xError активируется при наличии ошибки обработки запроса, код ошибки канала можно видеть в переменной eError. Массив ReadData предназначен для хранения читаемых данных, чтение из массива осуществляется при вызове методов типа Get.

Переменная ExecuteRequest предназначена для внутреннего взаимодействия ФБ MBChannel и MBPoll, активируется при возникновении запроса на обновление данных.

 

Метод предназначен для подтверждения чтения данных, сбрасывает выходную переменную xDone. 

 

Метод предназначен для сброса ошибок блока опроса, сбрасывает выходные переменные eError, eExcep.

Пользователем создается ФБ обработки данных устройства UserUnit на основе MBUnit как расширение базового блока (EXTENDS MBUnit). В базовом блоке MBUnit уже объявлен массив блоков опроса регистров MBPoll (255 блоков).

 

 

 

При инициализации ФБ UserUnit должно быть предусмотрено действие Settings с первоначальной настройкой блоков опроса регистров. В настройку устройства может включаться настройка базового адреса устройства и признаков чередования бай, слов, двойных слов.

 

 

 

 

Пользователем в ФБ UserUnit заполняются настройки блоков MBPoll начиная с нулевого элемента массива, без пропуска элементов массива. При подключении устройства к каналу опроса методом AddUnit подсчитывается количество элементов массива NumberPoll с заполненным корректным кодом функции Modbus. Элементы массива, начиная элемента с незаполненным кодом функции не участвуют в подключении к каналу. Метод AddUnit подключения к каналу должен вызываться после настройки блоков опроса MBPoll, входящих в состав пользовательского устройства, для корректного подсчета количества блоков опроса NumberPoll в составе устройства Unit.

Настройки блока опроса динамические, их можно менять при выполнении программы.

 

В пользовательском приложении создается ФБ MBChanels, объявляются экземпляры каналов опроса MBChannel. Объявляются пользовательские ФБ обработки данных Modbus устройств UserUnit.

 

 

Каждый экземпляр MBChannel привязан к одному из COM портов или к IP-адресу устройства. На один COM порт может быть привязан только один канал, к одному IP адресу множество каналов. Каналы работают независимо друг от друга, осуществляют параллельный опрос подключенных устройств.

Заводится действие Settings, в котором описывается первоначальная настройка канала.

 

 

 

 

 

Здесь канал A настроен на COM1, канал B настроен на IP-адрес. При изменении параметров настройки канала следует произвести инициализацию канала, то есть отключить и снова включить канал.

При инициализации ФБ MBChanels должно быть предусмотрено подключение устройств к каналам. Устройства при подключении должны предварительно настроены.

Здесь к каналу A подключено 2 устройства, к каналу B подключено 3 устройства.

Во время работы программы методами DelUnit и AddUnit можно отключать и подключать устройства от каналов, то есть, например, отключить устройство Unit5 от канала B (TCP) и подключить к каналу A (RTU).

В ФБ пользователя Unit управление блоком опроса осуществляется через вход xExec. По фронту активации входа происходит однократное выполнение запроса, во время исполнения запроса активируется выход xBusy, при успешном выполнении запроса активируется выход xDone, при ошибке активируется выход xExec. Вход xExec после выполнения сбрасывается.

Для того, чтобы быть уверенным в актуальности считанных данных и для экономии времени процессора, чтение из буфера чтения следует производить в момент активации выхода xDone. Если такой задачи не стоит, то можно производить чтение данных без анализа выхода xDone. После успешного чтения данных выход xDone можно сбросить методом Acknow.

 

 

Здесь данные из устройства считаны из устройства одним блоком опроса модбас регистров MBPoll, вне зависимости от типа данных.

Пользователь имеет возможность организовать опрос по событиям, активируя в нужный момент времени вход xExec или циклический опрос регистров. Если постоянно держать активным вход xExec, то происходит периодическое выполнение запроса с периодом RequestTime. Если при настройке блока опроса активировать вход WriteChanges, то будет происходить выполнение запроса на запись при изменении данных в буфере записи методами Set, запись будет происходить без активации входа xExec. Также реакция на ошибки может определятся пользователем. При появлении критической ошибки опрос останавливается, для продолжения опроса необходимо в пользовательском приложении сбросить выход ошибки. Можно в настройках канала активировать вход AutoResetPoll, тогда с периодом времени TimeResetPoll будет происходить сброс ошибок и возобновление опроса.

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

 

При выполнении блоков MBChannel и MBPoll происходят ошибки, коды ошибок приведены в таблице. Ошибки сгруппированы по источнику возникновения.

 

Ошибки канала и приема ответа (код более 16#90) вызывают повторные запросы и, после накопления повторов, приводят к остановке выполнения запросов.

Ошибка исключения протокола Modbus (код 16#80) – это ошибки, которые содержатся в коде исключения eExcep согласно спецификации протокола Modbus, формируются подключенным устройством. При наличии этой ошибки обработка ее должна быть предусмотрена в ФБ пользователя. Код предупреждения для методов чтения Get или записи Set данных появляется, когда адрес регистра в методе чтения Get или записи Set не входит в поле адресов ни одного блока опроса MBPoll устройства Unit. Это предупреждение означает, что при составлении пользователем программы обработки данных устройства допущена ошибка задания адресов.

 

 

Пример использования с комментариями приведен в AbakController_v1.0.4.0.package в шаблонном проекте ABAKPLC_examples.project (устройство ex_MBMasterCUP_Modbus).