Siemens WinCC. Руководство по конфигурации. Том 1
Подождите немного. Документ загружается.
09.99 Предметный указатель
Руководство по конфигурации WinCC
5-69
C79000-G8276-C157-01
5.3.2 Дополнения, специфичные для системы регистрации
тегов (Tag Logging)
Система исполнения
Расширенный диалог конфигурации
Приложение 09.99
5-70
Руководство по конфигурации WinCC
C79000-G8276-C157-01
5.3.3 API функции динамической библиотеки форм ата
(Format DLL) WinCC
DLL формата подразделяется на следующие секции:
• Инициализация DLL формата
• Инициализация операционной системой во время загрузки DLL формата
(LibMain)
• Запрос свойств DLL ф ормата
• Запрос имени DLL формата
• Прекращение работы DLL формата
• Прекращение работы системой регистрации тегов/аварийных сообщений
• Выгрузка операционной системой
• Расширения конфигурации
• Диалоговые расширения во время конфигурации сообщений
• Диалоговые расширения во время конфигурации архивных тегов
• Online слу жбы
• Регистрация всех специфичных для DLL формата объектов (сообщений,
архивных тегов)
• Переключение языка
• Форматирование
• Форматирование сообщений
• Форматирование архивных тего в
5.3.3.1 Инициализация динамической библиотеки формата
(Format DLL)
Инициализация во время операции загрузки
Приложения систем регистрации тегов/аварийных сообщений загружают DLL
форма та WinCC с помощью системного вызова LoadLibrary. DLL формата
загружается операционной системой и инициализируется че рез стандартные
механизмы. При этом определяются все адреса входов DLL формата.
09.99 Предметный указатель
Руководство по конфигурации WinCC
5-71
C79000-G8276-C157-01
5.3.3.2 Запрос свойс тв динамической библиотеки формата
(Format DLL)
Система регистрации аварийных сообщений и система регистрации тегов
регистрируются в соответствующей DLL формата с помощью вызова NormDLLStart.
Он предназначен для обмена информацией между DLL формата и приложением.
NormDLLStart
Параметр Описание
lpUser Указатель на данные приложения, перенаправляется воз вратной
функции без изменений
bModeRuntime
TRUE если DLL формата запу щена в режиме исполнения, FALSE
если в режиме конфигурации, в данный момент не проверяется
DLL формата
pcis Указатель на стартову ю структуру
lpError Указатель на структуру ошибки в WinCC по умолчанию
Возвращаемое
значение
Описание
TRUE Без ошибки
FALSE
Ошибка в функции API, описание причины ошибки можно
получить через указатель lpError
NORM_STARTSTRUCT
Компонент Описание I/O
dwSize Размер стру ктуры в байтах O
lpstrProjectPath Путь к выбранному в данный момент прое кту I
NORM_SEND_PR
OC
pfnWriteRwData
Указатель на возвратную фу нкцию приложения, с
которой DLL формата посылает нетипизированный тег
через Data Manager в ПЛК.
I
dwAppID Идентификатор (ID) приложения ID:
1 = Система регистрации аварийных сообщений
2 = Система регистрации тего в
3 = USER (пользователь, зарезервировано для будущих
применений, в данный момент не использу ется)
I
dwLocalID Установка языка во время вызова I
dwNormCap Свойства DLL формата в соо тветствии с таблицей,
приведенной ниже
O
Приложение 09.99
5-72
Руководство по конфигурации WinCC
C79000-G8276-C157-01
Возвратная функция для передачи нетипизированных тегов в WinCC Data Manager
имеет следующий вид:
Параметр Описание
lpDmVarUpdate Указатель на нетипизированный тег
dwWait
Идентификатор, определяющий, до лжно приложение ожидать
завершения вызова write (запись) или нет:
WAIT_ID_NO с SET_VALUE
WAIT_ID_YES с SET_VALUE_WAIT
lpUser Указатель на данные приложения, см. описание вызова
NormDLLStart
lpError Указатель на структуру ошибки в WinCC по умолчанию
Возвращаемое
значение
Описание
TRUE Без ошибки
FALSE
Ошибка в функции API, описание причины ошибки можно
получить через указатель lpError
09.99 Предметный указатель
Руководство по конфигурации WinCC
5-73
C79000-G8276-C157-01
Каждому свойству назначается бит в соответствии со следующей таблицей:
DEFINE
Битовая
маска
Описание
NORMCAP_DIAL
OG
0x00000001УстановленDLL формата предоставляет
специальный диалог
Сброшен
DLL формата не предоставляет
специальный диалог
NORMCAP_REEN
TRANT
0x00000002 Установлен DLL формата реентерабельна
Сброшен DLL формата не реентерабельна
NORMCAP_MSG_
FREE_LOCK
0x00000004 Установлен
Logon/logoff возм ожен для
сообщений
Сброшен Logon/logoff невозможен для
сообщений
NORMCAP_ARC_
FREE_LOCK
0x00000008 Установлен
Logon/logoff возм ожен для
архивных тегов
Сброшен Logon/logoff невозможен для
архивных тегов
NORMCAP_MSG_
GENERIC
0x00000010 Установлен
Сообщения могут быть
сконфигурированы обычным
образом
Сброшен Сообщения могут быть
сконфигурированы обычным
образом
NORMCAP_ARC_
GENERIC
0x00000020 Установлен Сообщения могут быть
сконфигурированы обычным
образом
Сброшен
Сообщения могут быть
сконфигурированы обычным
образом
5.3.3.3 Запрос имени динамической библиотеки формата (Format
DLL)
NormGetDLLName
Возвращаемое
значение
Описание
LPTSTR
Указатель на строку, содержащую имя DLL формата в виде
простого текста, имя зависит от текущего языка
Приложение 09.99
5-74
Руководство по конфигурации WinCC
C79000-G8276-C157-01
5.3.4 Завер шение работы дина мической библиотеки
форм ата (Format DLL)
Завершение работы системой регистрации тегов/аварийных сообщ ений
Система регистрации тегов и система регистрации аварийных сообщений посылают
DLL формата уведомление о том, что приложение закрывается. Ресурсы затем
корректно возвращаются в DLL формата.
NormDLLStop
Возвращаемое значение Описание
TRUE Успешное выполнение функции
FALSE Ошибка в функции API
Выгрузка операционной сис темой
Не требуе тся никаких специальных действий.
5.3.4.1 Расширения конфигурации
Для объектов S7PMC требуются особые спецификации. Эти спецификации вначале
запрашиваются в диалоге с использованием стандартных способов (без MFC) и
отправляются непосредственно в номер сообщения WinCC или архивный тег. Это
означает, что DLL формата не должна хранить эти спецификации или оперировать с
ними сама. Для гарантии уникальнос ти номера сообщения или архивного тега по
всему проекту, номеру сообщения или архивному тегу до лжен быть назначен
нетипизированный тег. Информация о данно м назначении является неотъемлемой
частью номера сообщения или имени архивного тега.
5.3.4.2 Диалоговое р асширение во время конфигурации
сообщений S7PMC
DLL формата содержит функцию API для назначения специфичного для S7PMC
номера сообщения. Данная функция вызывается аварийной системой системы
конфигу рации (CS) при назначении параметров отдельным сообщениям,
принадлежащим DLL формата S7PMC. Номер сообщения, назначаемый DLL
форма та S7PMC, состоит из двух частей.
09.99 Предметный указатель
Руководство по конфигурации WinCC
5-75
C79000-G8276-C157-01
Часть 1:
Номер, который однозначным образом идентифицирует ЦПУ ПЛК во всем проекте
(число в нетипизированном теге).
Часть 2:
Номер, принадлежащий сообщению в ПЛК, которое однозначным образом
идентифицирует сообщение в ЦПУ ПЛК (специфично для DLL формата).
В конфигурационном диалоге нуж но сделать следующие настройки для установки
номера сообщения:
Структура номера сообщений S7PMC (32 бита)
Для части 1
Каждое сообщение связано с нетипизированным тегом, который идентифицируе т
ЦПУ ПЛК. Для того что бы назначить номеру сообщения нетипизированный тег,
должно быть выполнено следующее.
Имя нетипизированного тега для S7PMC – и всех типов соединений с DLL форма та –
имеет следующую структуру :
@rd_alarm#rd_nr
@rd_alarm#
Фиксированная неотъемлемая часть имени нетипизированного тега
для DLL библиотек формата
rd_nr Десятичное число от 0 до 1023 для идентификации
нетипизированного тега (без предваряющих нулей)
Самый значимый бит номера сообщения устанавливается для тех номеров
сообщений, которые назначаются DLL формата (внешне). Эти сообщения могут быть
обработаны только соответствующей DLL формата, т.е. номер сообщения не может
быть изменен через конфигурационный диалог системы регистрации аварийных
сообщений.
Приложение 09.99
5-76
Руководство по конфигурации WinCC
C79000-G8276-C157-01
Для части 2
Данная часть номера сообщения может быть назначена только соответствующей DLL
форма та. Для S7PMC она имеет следующий смысл:
MKl
Класс сообщения; один из следующих:
SCAN (1)
ALARM/NOTIFY (2)
ALARM_8P/ALARM_8 (2)
LTM (3)
Sub-No.
Номер подсообщения, применим только к ALARM_8 и ALARM_8P:
1...8
PMC-ID Номер сообщения PMC (параметр ввода блока EV-ID):
1...16386
для сообщений класса SCAN и ALARM/NOTIFY или
ALARM_8P/ALARM_8
1...7
для сообщений класса LTM
MldShowDialog
Параметр Описания
hwnd handle окна
lpmCS Указатель на данные отдельного сообщения
lpDMProjectInfo Указатель на структуру с информацией о проекте
lpError Указатель на структуру ошибки WinCC по умолчанию
Возвращаемое
значение
Описание
TRUE Успешное выполнение функции
FALSE
Ошибка в функции API, описание причины ошибки можно
получить через указатель lpError
09.99 Предметный указатель
Руководство по конфигурации WinCC
5-77
C79000-G8276-C157-01
5.3.4.3 Диалоговое р асширение во время конфигурации
архивных тегов
DLL формата содержит функцию API для определения специфичного для S7PMC
имени архивного тега. Эта функция вызывается системой регистрации тегов системы
конфигу рирования (CS) при назначении параметров архивным тегам,
принадлежащим соединению S7PMC. Имя архивного тега, назначаемое DLL формата
S7PMC, состоит из нескольких компонентов, которые содержат, помимо остальных
вещей, номер, связанный с архивом в ПЛК. По данному алгоритму, номера тегов
S7PMC содержатся уникальным образом в описании архивных тегов WinCC: при
этом до с тигается максимально быстрое назначение в процессе исполнения.
Система регистрации тегов гарантиру е т, что имена архивных тегов полностью
уникальны.
Структура имени архивного тега S7PMC (не длиннее 18 байтов)
Имя
Длина в
байтах
Назначается Описание
character 9 Системой
регистрации
тегов
Строка фиксированного размера,
назначаемая системой регистрации тего в,
состоит из имени DLL формата и
неотображаемого символа # в качестве
разделителя, например, для S7PMC:
NRMS7PMC
rw_id 8 Системой
регистрации
тегов /
DLL формата
Двоичный идентификатор в
шестнадцатеричном представлении (с
предваряющими нулями) для
уникальности назначения
нетипизированного тега (соединения), с
которым связан но мер архива. Часть
имени формир уется DLL формата с
использованием входных параметров
системы регистрации тегов.
x 1 DLL формата
из CS
Специфичный для S7PMC идентификатор
для различения BSEND и AR_SEND:
A = AR_SEND
B = BSEND
ar_id 4 DLL формата
из CS
Идентификатор в шестнадцатеричном
представлении (с предваряющими нулями)
В зависимости от x ID:
Специфичный для S7PMC номер архива
AR_ID или
Специфичный для S7 R_ID при BSEND
Приложение 09.99
5-78
Руководство по конфигурации WinCC
C79000-G8276-C157-01
Пример имени архивного тега, сгенерированного для S7PMC: #00000001#A#0014
PdeShowDialog
Параметр Описание
hwnd handle окна
lpszArcVarName Указатель на строку , содержащую специфичную для DLL
форма та часть имени архивного тега
dwArcVarNameLength
Максимальная длина специфичной для DLL формата
части имени
lpVarKey Указатель на поле Varkey нетипизированных тегов
lpError Указатель на структуру ошибки WinCC
Возвращаемое
значение
Описание
TRUE Успешное выполнение функции
FALSE
Ошибка в функции API, описание причины можно
получить через указатель lpError
5.3.4.4 Online службы
Регистрация всех сообщений
Данная функция требуется по той причине, что DLL формата не имеет
конфигу рационной информацией об нужных сообщениях. Сообщения не посылаются
ПЛК до тех пор, пока приложение (WinCC) не зарегистрируется для получения
сообщений. В этот момент система регистрации аварийных сообщений вызывает
функцию MldRegisterMsg для каждого нужного сообщения и таким образом передает
конфигу рационную информацию для отдельного сообщения в DLL формата. Кроме
описания сообщения, DLL формата также получает указатель на нетипизированный
тег (соединение), который назначается этому сообщению. Это означает, что DLL
форма та может создать таблицу в основной памяти во время исполнения, согласно
которой будет определяться структура специфичных для S7PMC сообщений
регистрации.
MldRegisterMsg