Siemens WinCC. Руководство по конфигурации. Том 1
Подождите немного. Документ загружается.
09.99 Курс Си для WinCC
Руководство по конфигурации WinCC
4-75
C79000-G8276-C157-01
Шаг Процедура создания структурного типа WinCC
4 Теперь можно создавать теги WinCC типа Rect. В данно м примере это
означает, что для каждой переменной структурного типа будет создано
четыре тега, соответствующих элементам структуры.
Процедура Си, связанная с кнопкой Button3
•
В первой части описывается переменная rect типа CC_RECT. Тип CC_RECT бы л
определен в предыдущем примере.
•
Затем значения элементов структурного тега WinCC записываются в поля
переменной rect. В данном примере значения структурного тега WinCC
отображаются и могут редактироваться при помощи четырех полей ввода/вывода
(I/O Fields).
•
Далее значения полей структурной переменной rect выводятся на печать при
помощи функции printf(). Ре зультаты работы программы приведены в следующем
разделе.
Вывод в окне диагностики
Пример, описываемый в данной главе, осуществляет в окне диагностики вывод
следующего текста:
Курс Си для WinCC 09.99
4-76
Руководство по конфигурации WinCC
C79000-G8276-C157-01
4.7.4 Пример 4 — Функция для чтения структурного типа
WinCC
В данном примере создается функция для чтения структурного типа WinCC,
описанног о в предыдущем примере. Впоследствии данная функция может быть
использована подобно внутренней функции GetTag. Пример сконфигурирован для
изображенной ниже кнопки Button4 в окне свойств объекта в Event (Событие)
Mouse (Мышь) Mouse Action (Процедура мыши).
Функция проекта GetTagRect()
• В первой части включается заголовочный файл apdefap.h , содержащий
определение структур ного типа tagCC_RECT.
• В заголовке в качестве имени функции указывается GetTagRect. Функции
передается строковая переменная, содержащая название структуры WinCC,
которую следует считать. Функ ция возвращает указатель на область памяти
неопределенного типа (void*).
09.99 Курс Си для WinCC
Руководство по конфигурации WinCC
4-77
C79000-G8276-C157-01
•
В следующей части описывается переменная prect типа PCC_RECT и
инициализируется значением NULL. Это указатель, ссылающийся на переменну ю
типа CC_RECT.
•
Затем создается строковая переменная для хранения названий элементов
структу рного тега WinCC.
•
Далее следу ет выделить достаточный объем памяти для размещения переменной
типа CC_RECT. Это делается при помощи внутренней функции SysMalloc().
Функции передается размер необходимого блока памяти, определяемый
посредством команды sizeof(). Функция возвращает адрес выделенной области
памяти, или NULL, если памяти недостаточно.
•
После этого проверяется адрес, по лученный от функции SysMalloc(). Если памяти
недостаточно, функция завершается и возвра щает NULL.
•
Затем формируются названия каждого элемента структурного тега WinCC и
соответствующие им значения записываются в выделенну ю область памяти.
•
Функция возвращает адрес выделенного блока памяти, в который было записано
содержимое структурного тега WinCC. Данный блок памяти останется
зарезервиро ванным и сохранит размещенные данные даже после завершения
функции.
Замечание:
Если вместо приведенной здесь процедуры будет создана локальная переменная типа
CC_RECT, поля которой содержат значения элементов структурного тега WinCC, и
функция вернет ее адрес, то вызывающая программа полу чит недействительный
указатель. Данный эффект обусловлен тем, что переменная типа CC_RECT
становится недействительной по завершении функции, и, таким образом, бу дет
использован адрес более не существующего объекта.
Курс Си для WinCC 09.99
4-78
Руководство по конфигурации WinCC
C79000-G8276-C157-01
Процедура Си, связанная с кнопкой Button4
• В первой части описывается переменная prect типа PCC_RECT и
инициализируется значением NULL.
• Затем структурный тег WinCC считывается при помощи ранее созданной
функции GetTagRect(). Функция GetTagRect() возвращает указатель,
ссылающийся на бло к памяти, в котором размещены искомые данные. Этот
указатель преобразу ется к указателю типа PCC_RECT.
• Далее проверяется указатель, полученный от функции GetTagRect(). В случае
отсутс твия требуемого объема памяти функция возвращает значение NULL.
• Затем формируются названия каждого элемента структурного тега WinCC и
соответствующие им значения записываются в выделенну ю область памяти.
• Функция возвращает адрес выделенного блока памяти, в который было записано
содержимое структурного тега WinCC. Данный блок памяти останется
зарезервиро ванным и сохранит размещенные данные даже после завершения
функции.
• После этого элементы структурного тега, на который ссылается prect, выводятся
на печать при помо щи функции printf(). Результаты работы программы приведены
в следующем разделе.
Вывод в окне диагностики
Пример, описываемый в данной главе, осуществляет в окне диагностики вывод
следующего текста:
Функция проекта SetTagRect()
Помимо функции GetTagRect() также была создана соответствующая функция
SetTagRect(). В данном примере функция связана с событием Event (Событие)
09.99 Курс Си для WinCC
Руководство по конфигурации WinCC
4-79
C79000-G8276-C157-01
Miscellaneous (Разное) Open Picture (Открытие экранной формы) экранной
формы cc_9_example_04.PDL для инициализации структурного тега WinCC
.
Курс Си для WinCC 09.99
4-80
Руководство по конфигурации WinCC
C79000-G8276-C157-01
4.8 Программный ин терфейс WinCC (API)
В проекте WinCC Project_C_Course примеры, относящиеся к WinCC API, можно
открыть, щелкнув на изображенну ю ниже пиктограмму навигационной панели.
Примеры находятся на экранной форме, назы вающейся cc_9_example_10.PDL.
Программный интерфейс WinCC
Будучи полностью открытой и расширяемой системой, WinCC предоставляет
расширенный API (Application Program Interface — Программный интерфейс
приложения). Это интерфейс, использу емый приложениями для доступа к WinCC.
Функции WinCC API могут также использоваться в самом проекте WinCC.
Пакет WinCC ODK (Open Developers Kit — Открытый комплект разработчика)
обеспечивает подробное описание WinCC API. В нем детально объясняется WinCC
API, приводятся описания функций и примеры. В него также входят все
заголовочные файлы с необходимыми объявлениями функций. Однако пакет WinCC
ODK не является составной частью базового комплекта WinCC, его следует
приобретать отдельно.
09.99 Курс Си для WinCC
Руководство по конфигурации WinCC
4-81
C79000-G8276-C157-01
Библиотеки функций
Каждое (из числа основных) приложение WinCC (Графический дизайнер, Архиватор,
Регистратор аварийных событий, и т.д.) предоставляет свой соб ственный API,
представленный в одной или нескольких DLL. DLL (Dynamic Load Library —
Библиотека динамической компоновки) — это динамически подключаемая
библиотека. Объявления фу нкций, содержащихся в DLL, приводятся в
соответствующем заголовочном файле.
Подключение DLL к Си–действию или дру гой функции проиллюстрировано в
приведенном ниже фрагмен т е кода. В первой строке указывается название DLL,
которую следует загрузить. В приведенном примере это DLL, содержащая функции
CS (Configuration System — Среда конфигу рирования) графического редактора. Во
второй строке подключается заголовочный файл с объявлениями функций. Если
требу е тся использовать только одну –две функции, то их на данном этапе можно
объявить явно. Завершающая строка имеет вид #pragma code(). В приведенном
примере DLL и заголовочный файл имеют общие названия, что вполне естественно.
Тем не менее, это не всегда так.
Функции RT и CS
Функции API любого приложения можно грубо разбить на два типа. Это так
называемые функции CS (Configuration System — Среда конфигурирования) и
функции RT (RunTime — Среда исполнения).
В бо льшинстве случаев в проекте WinCC функции RT можно вызывать без
предварительной загрузки какой–либо DLL. Функции RT влияют на проект только во
время исполнения. После рестарта прое кта, а в большинстве случаев после смены
экранной формы, изменения, внесенные функциями RT, будут утрачены.
Перед применением функций CS в про екте WinCC необходимо загрузить
соответствующие DLL, в которых были запрограммированы требуемые функции.
Применение функций CS в самом про екте WinCC имеет смысл только в редких
слу чаях. Представленный пример, тем не менее, иллюстрирует использование
функций CS, т.к. на основе базовых принципов работы с этими фу нкциями Вы
сможете понять, как их применять в Ваших собственных проектах.
Пример проекта
В примере проекта не приводится детальное описание WinCC API. Осно вные
принципы работы с WinCC API объясняются на примере API графического
редактора. Примеры работают с объектами экранной формы cc_9_example_10x.PDL,
специально созданными для этого. Эта экранная форма отображается для данной
главы в окне экранных форм .
Курс Си для WinCC 09.99
4-82
Руководство по конфигурации WinCC
C79000-G8276-C157-01
4.8.1 Пример 1 — Изм енение свой ств с помощью функций
RT
В данном примере функции RT API графического редактора используются для
установки свойств изображенного объекта. Координаты объекта изменяются
заданием свойств Position X (Координата X) и Position Y (Координата Y). Пример
сконфигурирован для изображенной ниже кнопки Button1 в окне свойств объекта в
Event (Событие)
Mouse (Мышь) Mouse Action (Процедура мыши).
Процедура Си, связанная с кнопкой Button1
• В первой части описывается и инициализируется переменная bRet типа BOOL.
Эта переменная используется для анализа значений, возвращаемых выз ываемыми
функциями API.
• Затем описываются две строковые переменные. Их содержимое — название
экранной формы и название объекта — задают объект для редактирования.
Проверьте, что название экранно й формы не содержит расширения файла PDL.
• Для описания типа задаваемых свойств создается переменная. Для этого
предусмотрен специальный тип данных VARTYPE. Для каждого существующего
09.99 Курс Си для WinCC
Руководство по конфигурации WinCC
4-83
C79000-G8276-C157-01
типа свойств определена символьная константа. Устанавливаемые в данном
примере свойства имеют тип VT_I4 (int д линой в 4 байта).
•
Для устанавливаемых свойств Position X и Position Y описывается по переменной
типа int, которые задают их новые значения.
•
Далее описывается переменная типа CMN_ERROR. При сбое во время исполнения
функции в данную структуру будет записана информация о произошедшей
ошибке.
•
Свойства Position X и Position Y заданного объекта у станавливаются при помощи
функции API PDLRTSetPropEx(). Первый параметр функции API описывает
режим адресации объекта. Следующие три параметра задают названия экранной
формы, объекта и свойства. Для указания нужного свойства следует испо льзовать
его английское название, а не немецкое. Для предыдущего примера — это Left и
Top. Следующий параметр описывает тип свойства. В качестве следу ющего
параметра указывается адрес переменной, содержащей новое значение свойства.
Следующие четыре параметра не имеют отно шения к рассматриваемым
процедурам. В последнем параметре указывается адрес структуры для анализа
ошибок.
•
После вызова функций API возвращаемое ими значение проверяется в условном
выражении if. Если при выполнении происходит ошибка, сообщение об этом
выводится на печать. Часть такого сообщения формируется на основе
информации, содержащейся в поле szErrorText структуры, предназначенной для
анализа ошибок.
Замечание:
В приведенном примере возвращаемое значение функции API присваивается
переменной типа BOOL. Затем осуществляется проверка этой переменной. Вызов
функции API и проверка возвращаемого значения можно объединить в одной строке,
как это будет проделано в последующих примерах данной главы.
Курс Си для WinCC 09.99
4-84
Руководство по конфигурации WinCC
C79000-G8276-C157-01
4.8.2 Пример 2 — Создание связи с тегом с помощью
функции RT
В данном примере функции RT API графического редактора используются для
создания связи с тегом. С тегом связывается свойство поля ввода/вывода, что
делается в меню Property (Свойство) Output/Input (Ввод/вывод) Output
Value (Выходное значение). При мер сконфигурирован для изображенной ниже
кнопки Button2 в окне свойств объекта в Event (Событие)
Mouse (Мышь)
Mouse Action (Проце дура мыши).
Процедура Си, связанная с кнопкой Button2
• В первой части включается заголовочный файл trigger.h. В этом файле находятся
описания использующихся в данно м примере символьных констант.
• Затем описываются две строковые переменные. Их содержимое — название
экранной формы и название объекта задают объект для редактирования.
• Для задания свойств связи с тегом предусмотрен специальный структурный тип
данных LINKINFO. Описывается структурная переменная link типа LINKINO.
• Далее описывается переменная типа CMN_ERROR.
• Поля структурной переменной link заполняются данными об устанавливаемой
связи с тегом. Полю LinkType присваивается значение символьной константы
BUBRT_LT_VARIABLE_DIRECT. Эта константа использу ется для обозначения
прямой связи с тегом. В поле dwCycle записывается 0, соответствующий тригге ру
Upon Change (По изменению). Поле szLinkName указывает используемую
переменную.