Siemens WinCC. Руководство по конфигурации. Том 1
Подождите немного. Документ загружается.
09.99 Предметный указатель
Руководство по конфигурации WinCC
5-79
C79000-G8276-C157-01
Параметр Описание
lpDMVarKey Указатель на поле Varkey нетипизированных тего в
lpMsgNumber Указатель на поле с номерами отдельных сообщений
dwNumMsgNumber Количество номеров отдельных сообщений
lpError Указатель на структуру ошибки WinCC
Возвращаемое
значение
Описание
TRUE Успешное выполнение функции
FALSE
Ошибка в функции API, описание можно получить че рез
указатель lpError
5.3.4.5 Регистрация всех архивных тегов
Данная функция нужна по той причине, что DLL формата не располагает
конфигу рационной информацией о нужных архивных тегах. Функция PdeSendMsg
вызывается для определенного количества архивных тегов, и таким образом
становится известна конфигурационная и иная дополнительная информация об
архивных тегах .
За один вызов мог ут быть зарегистрир ованы несколько архивных тегов соединения.
Система регистрации тегов пересылает одно двойное слово на архивный тег в
качестве дополнительной инфо рмации для DLL формата, которое сохраняется в
памяти DLL формата. Данная допо лнительная информация будет использована
системой регистрации тегов, как только будет нужно обработать архивные теги (в
возвратной фу нкции TagLogging_ARCHIVE_CALLBACK).
Это означает, что DLL формата может создать таблицу в основной памяти во время
выполнения, по которой можно пол учать структуру специфичных для S7PMC
сообщений регистрации для соответствующих архивов. Сообщения регистрации
нужны для уведомления ПЛК о готовности приема статуса для соответств ующего
номера архива. После успешной процедуры регистрации ПЛК посылает архивные
данные в приложение (WinCC).
PdeSendMsg
Приложение 09.99
5-80
Руководство по конфигурации WinCC
C79000-G8276-C157-01
Параметр Описание
lpfnCallBack Указатель на возвратную фу нкцию, с помощью которой
нетипизированный тег, сгенерированный DLL формата,
передается в менеджер данных (DM).
Если 0, возвратная фу н к ция вызывается из структуры INI.
Адрес функции из структуры INI не совпадает с данным
параметром.
dwFunctionId Идентификатор функции FUNC_ID_REGISTER (см. таблицу
ниже), эта же функция применяется ко всем перечисленным тегам
lpszArcVarName
Указатель на поле указателя, чьи элементы относятся к именам
архивных тегов
lpdwData Указатель на поле, чьи элементы содержат дополнительную
информацию для архивных тегов, может быть нулем.
Дополнительное значение, принадлежащее архивному тегу,
передается без изменений во внутренние списки DLL формата
функцией FUNC_ID_REGISTER (зарегистрировать архивный тег)
и перенаправляется в Tag Logging_ARCHIVE_CALLBACK в
подходящее время.
Не имеет значения для других идентификаторо в функций.
dwNumArchVar
Name
Количество имен архивных тегов, которые должны быть
обработаны
lpVarKey Указатель на поле Varkey нетипизированного тега
lpUser Указатель на пользовательские данные, передается без изменений
в возвратную функцию
lpError Указатель на структуру ошибки WinCC
Возвращаемое
значение
Описание
TRUE Успешное выполнение функции
FALSE
Ошибка в функции API, описание можно получить че рез
указатель lpError
Возможные функции процедуры PdeSendMsg (зн ачения из dwFunctionId):
DEFINE Битовая
маска
Описание
FUNC_ID_LOCK 0x00000001Заблокировать архивный тег
FUNC_ID_FREE 0x00000002 Разблокиро вать архивный тег
FUNC_ID_REGISTER 0x00000004 Зарегистрировать архивный тег
FUNC_ID_UNREGISTER 0x00000008 Отменить регистрацию архивного тега
(в данный момент не требуе тся)
09.99 Предметный указатель
Руководство по конфигурации WinCC
5-81
C79000-G8276-C157-01
5.3.4.6 Переключение языка
Конфигурационные диалоговые окна должны быть зависимыми от языка, ины ми
словами, DLL форма та должна распознавать у становленный в данный момент язык.
При инициализации настройки языка передаются в стартовую структуру.
Динамическое переключение языка также должно быть передано в DLL формата
системой регистрации тегов или системой регистрации аварийных сообщений. Для
этого используется следующий вызов:
NormSetLanguage
Параметр Описание
DwLocalID Настройки языка на момент вызова
LpError Указатель на структуру ошибки WinCC по умолчанию
Возвращаемое
значение
Описание
TRUE Успешное выполнение функции
FALSE Ошибка в функции API, описание можно получить через
указатель lpError
Приложение 09.99
5-82
Руководство по конфигурации WinCC
C79000-G8276-C157-01
5.3.5 Форматирование
Если приложение зарегистрировалось на ПЛК для приема сообщений или архивных
данных, эти д анные будут предоставлены через соответствующий нетипизированный
тег. С этого момента ПЛК может посылать сообщения. Сообщения упаковываются в
нетипизированные теги и посылаются в DLL формата через DLL канал а, менеджер
данных и соответству ющее приложение (в данном слу чае, система регистрации тегов
или аварийных сообщений); DLL берет на себя ра боту с нетипизированными тегами.
DLL формата интерпретирует входящие данные и затем создает сообщения или
архивирует данные из них.
5.3.5.1 Вывод одиночных сообщений
Содержимое нетипизированного тега может хранить n отдельных сообщений. DLL
форма та должно проинтерпретировать это специфичное для S7PMC сообщение и
перенаправить получившиеся отдельные сообщения в систему регистрации
аварийных сообщений.
Номер сообщения (EV_ID) S7PMC является частью номера сообщения WinCC.
До десяти значений процесса может быть доставлено S7PMC. В данном случае, в
качестве значения процесса допустим строковый тип. Это значение процесса не
поддерживается системой регистрации аварийных сообщений – дополнительные
значения подобного вида должны отвергаться DLL формата.
Функция MldReceiveMsg вызывается системой регистрации аварийных сообщений
каждый раз, когда изменяется состояние нетипизированного тега, т.е. менеджер
данных определяет, что состояние ошибки изменяется на OK или наоборот.
Изменение состояния нетипизированного тега имеет значение только для DLL
форма та S7PMC. Допо лнительную информацию можно найти в главе Обработка в
слу чае изменения состояния.
MldReceiveMsg
Параметр Описание
lpfnMsgReceive Указатель на возвра тную подпрограмму, с помо щью ко торой
отдельные сообщения, структурированные DLL формата,
передаются системе регистрации аварийных сообщений
lpDMVar Указатель на нетипизированный тег
lpUser Указатель на пользовательские данные, передается без изменений
в возвратную функцию
lpError Указатель на структуру ошибки WinCC
Возвращаемое
значение
Описание
TRUE Успешное выполнение функции
FALSE
Ошибка в функции API, описание можно получить че рез
указатель lpError
09.99 Предметный указатель
Руководство по конфигурации WinCC
5-83
C79000-G8276-C157-01
Возвратная функция для отправки отдельных сообщений в систему регистрации
аварийных сообщений имеет следующий вид:
Параметр Описание
lpMsgCreate Указатель на сообщение WinCC
dwNumMsg Количество отдельных сообщений
lpUser Указатель на данные приложения
lpError Указатель на структуру ошибки WinCC по умолчанию
Возвращаем
ое значение
Описание
TRUE Успешное выполнение функции
FALSE Ошибка в функции API, описание можно получить через указатель
lpError
5.3.5.2 Подтверждение, блокировка/ра зрешение сообщений
Концепция сообщений и аварий системы регистрации аварийных сообщений WinCC
и S7PMC предполагает, что сообщения подтверждаются в зависимости от их
конфигу рации. Информация о подтверждении известна системе регистрации
аварийных сообщений, но она также должна обрабатываться в области для хранения
подтверждений сообщений в ПЛК. Для этого система регистрации аварийных
сообщений посылает подтверждения сообщений в ПЛК с помощью DLL формата для
соответствующего соединения.
На основе по лученных данных, DLL формата S7PMC со здает соответствующие
сообщения S7PMC, которые направляются в менеджер данных возвратной функцией
системы регистрации аварийных сообщений NORM_SEND_PROC.
Эта же процедура применяется, если отдельное сообщени е должно быть
заблокировано/разрешено системой регистрации аварийных сообщений, т.е. их
создание запрещается/разрешается на стороне ПЛК.
MldSendMsg
Параметр Описание
lpfnMsgSend Указатель на возвратную подпрограмму системы регистрации
аварийных сообщений, с помощью которой нетипизированный тег –
созданный DLL формата – передается для записи в ПЛК. Параметры
описаны в главе Запрос свойств динамической библиотеки формата.
lpSendData
Указатель на отправляемые данные, их структура подробнее описана
ниже
Приложение 09.99
5-84
Руководство по конфигурации WinCC
C79000-G8276-C157-01
Параметр Описание
dwNumData Количество индивидуальных задач, которые должны быть
обработаны
lpUser
Указатель на пользовательские данные, передается без изменений в
возвратную функцию
lpError Указатель на структуру ошибки WinCC
Возвращаем
ое значение
Описание
TRUE Успешное выполнение функции
FALSE Ошибка в функции API, описание можно получить через указатель
lpError
09.99 Предметный указатель
Руководство по конфигурации WinCC
5-85
C79000-G8276-C157-01
Структура отправляемых данных систе мы регистрации аварийных
сообщений (индивидуальная задача)
Тег Описание
DWORD dwVarID ID нетипизированного тега DM
DWORD dwNotify Уведомление: возможные значения
MSG_STATE_QUIT: подтвердить сообщение
MSG_STATE_LOCK: заблокировать сообщение
MSG_STATE_UNLOCK: разрешить сообщение
MSG_STATE_QUIT_EMERGENCY: подтвердить все
сообщения
DWORD dwData Для QUIT, LOCK, UNLOCK --> номер сообщения
Для EMERGENCY ACK --> не используется
5.3.5.3 Обработка в случае изм енения сос тояния
Об изменение состояния соединения (нетипизированных тегов) должна быть
уведомлена DLL формата. Это выполняется функцией MldReceiveMsg.
Изменени е состояния с
– на
Обработка в DLL формата S7PMC
Ошибка – OK
Сообщения регистрации для всех классов сообщений
S7PMC, в которых было сконфигу рировано, по меньшей
мере, одно сообщение – передаются в ПЛК. Регистрация,
производимая для сообщений S7PMC, зависит от их
класса . DLL формата уже знает обо всех
сконфигурированных сообщениях благодаря их
регистрации.
OK – Ошибка
DLL формата должна отвергнуть активные задачи,
которые уже были переданы в ПЛК, но не смогли быть
полностью обработаны из-за смены состояния
(отсутствуют подтверждения).
5.3.5.4 Обновление сообщений динами ческой библи отеки
формата (Format DLL) S7PMC
В случае обновления сообщения, DLL формата S7PMC считывает состояния всех
сообщений, о которых было получено уведомление (через регистрацию) и отправляет
их как отдельное сообщение в систему регистрации аварийных сообщений.
Следовательно, можно составить цельную картину сообщений при инициализации
системы.
Обновление сообщения нео бходимо при:
•
изменении состояния с ошибочного на OK (это также неявно производится при
инициализации)
•
отправке ПЛК сообщения об обновлении сообщения. Это сообщение
отправляется всем зарегистрир ованным участникам, если, например, было
обнаружено переполнение сообщений, сообщения от других участников
подтверждаются или разрешаются.
Приложение 09.99
5-86
Руководство по конфигурации WinCC
C79000-G8276-C157-01
В течение обновления сообщений ПЛК считывает состояния обновления сообщений
и их идентификаторы блокировки (lock IDs). Дополнительные значения и время не
посылаются. В данном слу чае, DLL формата предоставляет текущее системное время
в качестве времени для отдельного сообщения или записывает идентификатор
MSG_STATE_UPDATE в состояние сообщени я.
09.99 Предметный указатель
Руководство по конфигурации WinCC
5-87
C79000-G8276-C157-01
5.3.5.5 Форматирование архивных тегов
DLL формата предоставляет две функции для системы регистрации тего в:
•
Вывод отдельных значений архивных тегов из содержимого нетипизированного
тега
•
Блокировка/разрешение архивных тегов
5.3.5.6 Вывод отдельных значений архивных тегов
Содержимое нетипизированного тега (сообщения) может состоять из n значений
архивных тегов. DLL формата должна проинтерпретировать эти специфичные для
S7PMC сообщения и направить получившиеся значения а рхивных тего в в систему
регистрации тегов.
Для архивного тега также должны быть переданы конвертеры значений процесса.
DLL формата S7PMC затем произведет требуемые преобразования значения
процесса в значение архивного тега. Этот про цесс использует существующие
функции масштабирования WinCC. Точная процедура, однако, все ра вно должна
быть указана.
Функция PdeReceive вызывается системой регистрации тегов каждый раз, когда
изменяется состояние нетипизированного тега, т.е. менеджер данных определяет
изменение состояния ошибки OK или наоборот. Изменение сост ояния
нетипизированного тега имеет значение только для DLL формата S7PMC.
Дополнительную информацию можно найти в главе Обработка в случае изменения
состояния.
PdeReceive
Параметр Описание
LpDmVarUpdate Указатель на нетипизированный тег
LpfnCallBack
Указатель на возвратную подпрограмму, с помо щью ко торой DLL
форма та передает отдельные значения архивных тего в в систему
регистрации тегов.
LpUser Указатель на пользовательские данные, передается в возвратную
функцию без изменений
LpError Указатель на структуру ошибки WinCC
Возвращаемое
значение
Описание
TRUE Успешное выполнение функции
FALSE
Ошибка в функции API, описание можно получить че рез
указатель lpError
Возвратная функция для отправки отдельных значений архивных тего в в систему
регистрации тегов имеет следующий вид:
Приложение 09.99
5-88
Руководство по конфигурации WinCC
C79000-G8276-C157-01
Параметр Описание
lpszArcVar
Name
Имя архивного тега из идентификатора нетипизированного тега
doValue Значение архивног о тега
lpstTime Указатель на временну ю метк у из польз овательских данных
нетипизированного тега
dwFlags
Идентификаторы, точное значение которых будет определено в
будущем.
dwData Допо лнительная дата, которая была предоставлена во время
регистрации, передается без изменений
lpUser
Указатель на пользовательские данные, передается без изменений в
возвратную функцию
lpError Указатель на структуру ошибки WinCC
Возвращае
мое
значение
Описание
TRUE Успешное выполнение функции
FALSE Ошибка в функции API, описание можно получить через указатель
lpError
5.3.5.7 Блокировка/разрешение архивных тегов
С помощью этой функции система регистрации тего в имеет возможность
контролировать прием значений архивных тегов в S7PMC. Для этой цели DLL
форма та S7PMC формирует вызов процедуры logoff или logon соответствующего
архива, и направляет этот вызов в DM через NORM_SEND_PROC.
С точки зрения DLL формата S7PMC функция блокировки/разрешения архивных
тегов почти идентичны функции для регистрации архивных тегов. В обеих функциях
вызывается одна и та же функция DLL формата (PdeSendMsg).
Через идентификатор функции dwFunctionId различают функции для регистрации и
блокировки/разрешения: для блокировки/разрешения дополнительные данные
lpdwData архивного тега не имеют значения. См. также главу Регистрация всех
архивных тегов.
5.3.5.8 Обработка в случае изм енения сос тояния
В случае изменения состояния соединения (нетипизированных тегов) DLL формата
должна быть об этом уведомлена. Это выполняется функцией PdeReceive.
Изменени е состояния с
– на
Обработка в DLL формата S7PMC
Ошибка- OK
Сообщения регистрации (logon) для всех архивных тегов