Интерфейс PI Interface Для OPC DA 2.6. Руководство Пользователя

Интерфейс PI Interface для OPC DA 2.
Руководство пользователя
OSIsoft, LLC
777 Davis St., Suite 250
San Leandro, CA 94577 USA (Соединенные Штаты Америки)
Телефон: (01) 510-297-5800
Факс: (01) 510-357-8136
Веб-сайт: http://www.osisoft.com
Руководство пользователя по PI Interface для OPC DA 2.6

© OSIsoft, LLC, 1998–2016 г. Все права защищены.
Ни одна из частей данной публикации не может быть воспроизведена, сохранена в системе поиска
информации или передана в какой-либо форме или какими-либо средствами, механически,
фотокопированием, записью или иными методами без предварительного письменного
разрешения корпорации OSIsoft, LLC.
OSIsoft, логотип и эмблема OSIsoft, Managed PI, OSIsoft Advanced Services, OSIsoft Cloud Services,
OSIsoft Connected Services, PI ACE, PI Advanced Computing Engine, PI AF SDK, PI API, PI Asset
Framework, PI Audit Viewer, PI Builder, PI Cloud Connect, PI Connectors, PI Coresight, PI Data Archive, PI
DataLink, PI DataLink Server, PI Developer’s Club, PI Integrator for Business Analytics, PI Interfaces, PI
JDBC driver, PI Manual Logger, PI Notifications, PI ODBC, PI OLEDB Enterprise, PI OLEDB Provider, PI
OPC HDA Server, PI ProcessBook, PI SDK, PI Server, PI Square, PI System, PI System Access, PI
Visualization Suite, PI Web API, PI Web Services и RLINK являются товарными знаками OSIsoft, LLC.
Все прочие используемые в настоящем документе торговые знаки или названия являются
собственностью их соответствующих владельцев.
ПРАВА ПРАВИТЕЛЬСТВА США
Использование, тиражирование или раскрытие информации правительством США ограничено
положениями лицензионного соглашения с OSIsoft, LLC, а также условиями документов DFARS
227.7202, DFARS 252.227-7013, FAR 12.212 и FAR 52.227. OSIsoft, LLC.
Версия: 2.6.0.x
Опубликовано: 21 марта 2016 г.
Содержание
Введение в интерфейс PI Interface для OPC DA..................................................... 1

Настройки оборудования для интерфейса PI Interface для OPC DA..................................................... 1
Обзор операций интерфейса PI Interface для OPC DA...........................................................................2
Руководства, связанные с интерфейсом PI Interface для OPC DA......................................................... 3
Средства, связанные с интерфейсом PI Interface для OPC DA.............................................................. 4
Функции, поддерживаемые интерфейсом PI Interface для OPC DA..................................................... 4
Установка интерфейса PI Interface для OPC DA.....................................................7

Требования для установки..................................................................................................................... 7
Местоположение каталога и файлов установки.................................................................................... 7
Установка интерфейса PI Interface для OPC DA.....................................................................................8
Обзор конфигурации интерфейса PI Interface для OPC DA................................... 9

Контрольный список настройки для интерфейса PI Interface для OPC DA...........................................9
Настройка запуска интерфейса.............................................................................................................11
Создание и настройка экземпляра интерфейса................................................................................... 11
Управление подключением серверов.............................................................................................. 12
Настройка безопасности интерфейса PI Interface для OPC DA........................................................... 12
Рекомендуемые меры безопасности интерфейса PI Interface для OPC DA..................................... 13
Создание PI Trust............................................................................................................................... 14
Настройка службы Windows.............................................................................................................. 15
Настройка DCOM для интерфейса PI Interface для OPC DA............................................................ 16
Настройка точек PI Point для интерфейса PI Interface для OPC DA.....................................................19
Экспорт элементов OPC в конфигуратор точек PI Point.................................................................. 20
Создание точек PI Point вручную...................................................................................................... 21
Настройка атрибутов точек...............................................................................................................21
Настройки классов scan class и частоты обновления....................................................................... 31
Входные точки для интерфейса PI Interface для OPC DA................................................................. 33
Конфигурации точки output.............................................................................................................. 37
Совместимость типов данных........................................................................................................... 39
Конфигурация отказоустойчивости для интерфейса PI Interface для OPC DA.................................. 49
Режимы отработки отказа UniInt интерфейса PI Interface для OPC DA...........................................50
Отработка отказа на уровне сервера OPC........................................................................................52
Буферизация для интерфейсов PI Interface..........................................................................................57
Службы буферизации........................................................................................................................ 57
Буферизация и коллективы.............................................................................................................. 58
Настройка буферизации................................................................................................................... 58
Включение буферизации.................................................................................................................. 59
Подключаемые модули (DLL-библиотеки постобработки).................................................................59
Работа интерфейса PI Interface для OPC DA........................................................61

Проверка запуска интерфейса..............................................................................................................61
Сбор данных с сервера OPC.................................................................................................................. 61
Справочник PI ICU для интерфейса PI Interface для OPC DA................................ 63

Параметры сервера OPC....................................................................................................................... 63
Настройка дополнительных параметров.............................................................................................64
Параметры обработки данных............................................................................................................. 66
Настройки безопасности DCOM........................................................................................................... 67
Параметры отработки отказа............................................................................................................... 68
Настройки подключаемых модулей..................................................................................................... 70
Разные параметры.................................................................................................................................70
Руководство пользователя по PI Interface для OPC DA 2.6 iii

Содержание
Настройки отладки................................................................................................................................70
Параметры метки времени в PI ICU.......................................................................................................72
Параметры командной строки для интерфейса PI Interface для OPC DA.............. 75

Алфавитный список параметров...........................................................................................................75
Параметры по функциям.......................................................................................................................91
Устранение неполадок интерфейса PI Interface для OPC DA............................... 95

Открытие средства PI OPC Client Tool.................................................................................................. 95
Проблемы сервера OPC........................................................................................................................ 95
Просмотр элементов......................................................................................................................... 95
Варианты меток времени сервера OPC............................................................................................ 95
Ненадежные значения...................................................................................................................... 96
Путь доступа......................................................................................................................................96
Проблемы с данными, возвращаемыми сервером OPC...................................................................96
Устранение неполадок работы сервера OPC................................................................................... 97
Обновления OPC............................................................................................................................... 98
Сообщения об ошибках и информационные сообщения для интерфейса PI Interface для OPC DA....
99
Ведение журнала.............................................................................................................................100
Сообщения.......................................................................................................................................100
Системные ошибки и ошибки PI System......................................................................................... 108
Сообщения UniInt, относящиеся к отработке отказа..................................................................... 108
Техническая поддержка и другие ресурсы........................................................113
iv Руководство пользователя по PI Interface для OPC DA 2.6

Введение в интерфейс PI Interface для OPC DA
Интерфейс PI Interface для OPC DA — клиентское приложение OSIsoft, которое
обеспечивает связь между сервером OPC и архивом PI Data Archive. Интерфейс PI
Interface для OPC DA собирает данные в режиме реального времени из сервера OPC и
записывает значения в точки PI Point. При необходимости интерфейс может записывать
в сервер OPC данные из точек PI Point в архиве PI Data Archive.
Интерфейс PI Interface для OPC DA построен на платформе OSIsoft UniInt, которая
располагает стандартным набором типовых функций. Например, интерфейс может быть
настроен на запуск в качестве автоматически запускаемой службы, запуск в
отключенном состоянии, а также использование буферизации для предотвращения
потери данных. Функциональность платформы UniInt документирована в PI Universal
Interface (UniInt) User Manual, вспомогательном руководстве для PI Interface for OPC DA
User Guide.
Работа OPC зависит от служб Microsoft COM и DCOM, и интерфейс должен работать на
платформах Windows. Интерфейс PI Interface для OPC DA поддерживает стандарт OPC
Data Access версий 1.0a, 2.0 и 2.05.
Прим.:
Стандарт OPC DA предназначается для данных в режиме реального времени. Для
данных, соответствующих спецификации OPC XML-DA, используйте интерфейс PI
Interface для OPC DA XML. Для сбора или синхронизации исторических данных OPC
с использованием стандарта OPC HDA используйте интерфейс PI Interface для OPC
HDA. Для сбора данных предупреждений и событий OPC с использованием
стандарта OPC AE используйте интерфейс PI Interface для OPC Alarms and Events.
Настройки оборудования для интерфейса PI Interface для

OPC DA
Интерфейс PI Interface для OPC DA может быть настроен для запуска на машине сервера
OPC, машине сервера PI Data Archive или на отдельной машине. Каждой конфигурации
необходим различный набор настроек для запуска интерфейса. Чтобы интерфейс не
конкурировал за системные ресурсы с PI Data Archive, устанавливайте интерфейс на
выделенном компьютере.
Следующая конфигурация отличается простотой и обеспечивает буферизацию данных
на узле интерфейса.
Руководство пользователя по PI Interface для OPC DA 2.6 1

Следующая конфигурация размещает сервер OPC на собственном компьютере.
Обзор операций интерфейса PI Interface для OPC DA

Интерфейс PI Interface для OPC DA запускается с помощью пакетного файла (.bat)
Windows, который вызывает исполняемый файл интерфейса. Файл .bat содержит
параметры командной строки для настроек интерфейса.
Для нормального запуска интерфейс PI Interface для OPC DA выполняет следующие
операции.
1. Подключается к архиву PI Data Archive (если не настроен запуск в отключенном

состоянии).
2. Получает точки PI Point из архива PI Data Archive.
3. Подключается к серверу OPC.
4. Создает группы OPC.
5. Добавляет элементы в группы.
6. Активирует группы (если группы не созданы как активные).
7. Начинает сбор данных.
После начала сбора данных интерфейс выполняет следующие операции.
• Обслуживает плановые точки входа и поочередно обрабатывает каждый из scan class.
• Обслуживает входные точки по мере поступления событий.
• Обслуживает запущенные входные точки по мере поступления событий.
• Проверяет базу данных PI Point в поисках добавленных, измененных и удаленных
точек.
• Перезагружает новые или измененные точки.
Интерфейс проверяет обновления точек через каждые 2 минуты. Интерфейс
одновременно обрабатывает 25 обновлений точек. Если одновременно добавлено,
изменено или удалено больше 25 точек, то интерфейс обрабатывает первые 25 точек,
ожидает 30 секунд (по умолчанию) или четвертую часть времени, указанного в
параметре updateinterval UniInt (выбирается наименьшее значение), обрабатывает
следующие 25 точек и т. д. После того как все точки обработаны, интерфейс
возобновляет проверку обновлений с интервалом обновления.
2 Руководство пользователя по PI Interface для OPC DA 2.6

Руководства, связанные с интерфейсом PI Interface для

OPC DA
Интерфейс PI Interface для OPC DA построен на основе платформы UniInt. Интерфейсы
UniInt используют множество других компонентов PI System и взаимодействуют с ними.
Дополнительную информацию см. в следующих документах.
• PI Universal Interface (UniInt) User Guide

Описание настройки, работы и устранения неполадок интерфейсов на основе UniInt.
• DCOM Security and Configuration Guide

Описание конфигурации безопасности связанных с OPC продуктов PI System.
• PI OPC Client User's Guide

Содержит информацию об использовании средства PI OPC Client.
• PI Server System Management Guide

Документация по управлению установками PI Data Archive, интерфейсами, точками PI
Point и наборами цифровых состояний.
• Configuring PI Server Security

Содержит информацию о безопасности PI Data Archive.
• High Availability Administrator Guide

Описание настройки высокой готовности и управления PI Data Archive и установками
интерфейсов при использовании коллективов PI Collective.
• PI SDK and PI API Online Help Files

Документация по PI SDK и библиотекам PI API, которые используются интерфейсами.
Файлы встроенной справки (.chm) находятся в каталоге %PIHOME%\PIPC\Help\.
PIHOME — это переменная среды, которая содержит путь к установке PI API.
• PI API Installation Instructions User Guide

Подробные сведения об установке поддерживающих компонентов, включая
буферизацию для предотвращения потери данных в случае разрыва подключения к
PI Data Archive.
• PI Buffering Manager Help Files

Описание настройки буферизации с использованием PI Buffer Subsystem 4.3 или
более поздней версии, включая процедуру обновления с API Buffer Server (bufserv)
при необходимости. Файлы встроенной справки располагаются в PIPC/HELP/
BufferManager.chm.
• PI Interface Configuration Utility User Guide

Описание настройки интерфейсов с использованием PI ICU.
• Ведение журналов интерфейсов

Дополнительные сведения о чтении журналов сообщения см. в статье базы знаний
OSIsoft Чтение новых журналов сообщений интерфейсов UniInt 4.5.0.x и более

поздних версий (http://techsupport.osisoft.com/techsupport/nontemplates/KB/

article.aspx?id=KB00401).
• Примечания к выпуску интерфейса

Касающаяся определенного выпуска информация о функциональных обновлениях,
исправлениях ошибок и новых функциях. Примечания к выпуску предоставляются
как для платформы UniInt, так и для каждого интерфейса.
• Data Access Custom Interface Standard v2.05a

Документация OPC Foundation для версии 2.05a продукта OPC DA.
Средства, связанные с интерфейсом PI Interface для OPC

DA
Интерфейс PI Interface для OPC DA не имеет собственного графического
пользовательского интерфейса. Следующие средства выполняют множество функций,
связанных с установкой, конфигурированием, запуском и устранением неполадок
интерфейса и сервера OPC.
• Клиентское средство PI OPC Client Tool

Подключается к серверам OPC и отображает данные на подключенных серверах OPC,
включая группы и элементы.
• Средство OPC to CSV

Предоставляет доступ к свойствам элементов OPC и позволяет применять
относящиеся к серверу OPC или к сайту знания для пересмотра или создания
атрибутов точек PI Point до того, как эти точки будут созданы или изменены.
Экспортирует элементы OPC в файл значений, разделенных запятой, который можно
загрузить в надстройку PI Tag Configurator для Excel.
• Средство OPC Enum

Обнаруживает серверы OPC.
• opcscan.exe
• opcrefresh.exe
• opcresponse.exe
Служит для преобразования меток времени из журналов обновления для сервера
OPC и запускается из командной строки.
• Программа настройки интерфейса PI Interface (PI ICU)

Служит для создания и настройки экземпляров каждого интерфейса. После создания
каждый экземпляр доступен в раскрывающемся меню в PI ICU.
Функции, поддерживаемые интерфейсом PI Interface для

OPC DA
Номер компонента интерфейса PI OPC DA: PI-IN-OS-OPC-NTI

Совместимые операционные системы

Платформа 32-разрядное приложение 64-разрядное приложение
Windows 2012 Server R2 32- Да Нет
разрядная ОС
Windows 2012 Server R2 64- Да (режим эмуляции) Нет
разрядная ОС
Windows Vista 32-разрядная ОС Да Нет
Windows Vista 64-разрядная ОС Да (режим эмуляции) Нет
Windows 2008 32-разрядная Да Нет
ОС
Windows 2008 R2 64-разрядная Да (режим эмуляции) Нет
ОС
Windows 7 32-разрядная ОС Да Нет
Windows 7 64-разрядная ОС Да (режим эмуляции) Нет
Windows 8 Да (режим эмуляции) Нет
Server 2012 Да (режим эмуляции) Нет
Прим.:
Рекомендуется регулярно устанавливать обновления безопасности от
Майкрософт. Рекомендуется использовать последние версии Windows, которые
имеют более совершенные функции безопасности. Дополнительные сведения о
безопасности см. в разделе Рекомендуемые меры безопасности интерфейса PI
Interface для OPC DA.
64-разрядные сборки для интерфейса PI OPC DA недоступны.
Компонент Поддержка
Стандарт OPC Data Access 1.0a / 2.0 / 2.05
Автоматическое создание точек PI Point Соединитель APS
Служебная программа Point Builder Да
Элемент управления ICU Да
Типы PI Point Int16 Int32 Float16 Float32 Float64 Digital String
Timestamp
Метки времени с указанием долей секунды Да
Scan class с указанием долей секунды Да
Автоматически учитывает изменения атрибута Да
PI Point
Фильтрационный тест «исключение» Интерфейс: исключения PI System
Сервер OPC: зона нечувствительности
Выходные данные из архива PI Data Archive Да

Входные данные в PI Data Archive Незапрошенные теги событий на основе
сканирования
Выходные данные для источника данных Да
* Доступен интерфейс только для чтения Да
Поддерживает сомнительный бит Да

Поддерживает многосимвольный атрибут PI Да
Point pointsource
Максимальное число точек Неограничено

Компонент Поддержка
Использует PI SDK Да
Поддержка строк PINet Недоступно
Источник меток времени Интерфейс или сервер OPC (настраиваемый)
Восстановление журнала Нет
Запуск без соединения с сетью Да
SetDeviceStatus Да
Варианты отработки отказа Отработка отказа на уровне сервера OPC и на
уровне интерфейса UniInt Phase 2
ПО поставщика необходимо для узла Нет
интерфейса PI Interface Node
Требуется ПО поставщика для источника Да
данных
Требуется оборудование поставщика Нет
Дополнительное ПО PI поставляется вместе с Да
интерфейсом
Типы точек устройства VT_I2
VT_I4
VT_R4
VT_R8
VT_BSTR
VT_DATE
Последовательный интерфейс Нет

Установка интерфейса PI Interface для OPC DA
Чтобы установить интерфейс PI Interface для OPC DA, необходимо соблюсти все
предварительные требования к установке, а затем запустить исполняемый файл (.exe).
После установки программного обеспечения интерфейса настройте его параметры с
помощью PI ICU.
В этом разделе
• Требования для установки
• Местоположение каталога и файлов установки
• Установка интерфейса PI Interface для OPC DA
Требования для установки

Перед началом установки и настройки интерфейса убедитесь, что выполнены
следующие системные требования.
• Поддерживаемые операционная система и оборудование и ПО поставщика.
Дополнительные сведения см. в разделе Функции, поддерживаемые интерфейсом PI
Interface для OPC DA.
• Подключение к выполняемому узлу архива PI Data Archive.
Используйте PI System Management Tools (PI SMT) для просмотра состояния PI Data
Archive.
• Подключение к работающему серверу OPC, который заполнен точками.
Используйте средство PI OPC Client Tool для просмотра подключений и содержимого
сервера OPC.
• Измените настройку часового пояса для узла интерфейса.
• Установка интерфейса производится с использованием учетной записи
администратора.
Дополнительные сведения о требованиях к безопасности интерфейса см. в разделе
Настройка безопасности интерфейса PI Interface для OPC DA.
Местоположение каталога и файлов установки

Каталог установки интерфейса PI Interface для OPC DA содержит все файлы,
необходимые для настройки и запуска интерфейса. По умолчанию интерфейс PI
Interface для OPC DA устанавливается в следующей папке: \%PIHOME%\Interfaces
\OPCInt\.
Корневой каталог %PIHOME% — переменная среды, согласно значению которой
устанавливаются продукты OSIsoft. Она определяется элементом PIHOME в файле
конфигурации pipc.ini в каталоге %windir%. Чтобы переопределить папки по
умолчанию, внесите изменения в файл конфигурации pipc.ini.

Прим.:
Ограничьте число учетных записей Windows, которые могут создавать или
записывать файлы в папке или вложенных папках %PIHOME%. Дополнительные
сведения о безопасности учетной записи и ограничении доступа к каталогам и
файлам см. в разделе PI Universal Interface (UniInt) User Manual.
Средство OPCEnum, которое обнаруживает серверы OPC, устанавливается в каталоге \
%windir%\system32, за исключением 64-разрядных систем, где оно устанавливается в
%windir%\sysWOW64. Библиотеки OPC, предоставленные OPC Foundation и
устанавливаемые вместе с интерфейсом, устанавливаются в том же каталоге, что и
OPCEnum.

Установите ПО для интерфейса на узле интерфейса.
Подготовка
Требования для установки
Процедура
1. На узле интерфейса запустите программу установки интерфейса PI Interface для OPC
DA.
2. Проверьте подключение архива PI Data Archive к узлу интерфейса.
◦ Для подключений PI API откройте командную строку, перейдите в каталог %PIPC%
\bin и выполните команду apisnap PISERVERNODE.
◦ Для подключений PI SDK в меню Windows Пуск щелкните Программы > PI System >
About PI-SDK, а затем выберите File > Connections, чтобы выполнить подключение.
Дальнейшие действия
Настройте интерфейс с использованием PI ICU.

Обзор конфигурации интерфейса PI Interface для
OPC DA
После установки программного обеспечения интерфейса необходимо настроить
следующие элементы.
• Параметры запуска
• Безопасность
• Служба Windows
• Точки PI Point
• Буферизация
Дополнительные параметры настройки: отработка отказа, запуск без соединения с
сетью (disconnected startup), точки Performance Point и значения степени исправности
интерфейса. Сведения о настройке типовых компонентов интерфейса UniInt см. в
разделе PI Universal Interface (UniInt) User Guide.
Копии программного обеспечения интерфейса, именуемые экземплярами интерфейса,
можно создать на одном или нескольких узлах интерфейса. Каждому экземпляру
интерфейса требуется собственный файл запуска (.bat). Файл .bat содержит параметры,
иногда называемые флагами, в которых создаются параметры запуска и выполнения
интерфейса.
Служебная программа PI ICU служит для настройки параметров интерфейса,
обеспечивая правильный формат файла .bat. После того как настроен первый
экземпляр интерфейса, можно использовать копию настроенного файла .bat и заменить
специфические параметры для каждого экземпляра интерфейса. Файлы .bat находятся
в установочном каталоге для интерфейса, в котором также находится шаблонный
пакетный (bat) файл (opcint.bat_new), который можно использовать для справочных
целей и тестирования.
Параметры файла .bat можно также применять в командной строке для тестирования и
отладки. Чтобы получить полный список параметров, откройте окно командной строки,
перейдите в установочный каталог интерфейса и введите следующую команду: opcint
-help.
Контрольный список настройки для интерфейса PI

Interface для OPC DA
После установки программного обеспечения с помощью служебной программы PI ICU
настройте экземпляр интерфейса. Типовая процедура настройки состоит из следующих
шагов. Дополнительные сведения о типовых настройках интерфейса UniInt см. в разделе
PI Universal Interface (UniInt) User Guide. Дополнительные сведения об использовании PI
ICU см. в разделе PI Interface Configuration Utility (PI ICU) User Guide.
Процедура
1. Создайте экземпляр интерфейса на узле интерфейса.
2. Настройте параметры безопасности.

Обзор конфигурации интерфейса PI Interface для OPC DA
a. Настройка службы Windows.

b. Ограничьте доступ к учетным записям службы.
c. Создайте и настройте PI identity, PI Trust и сопоставления для интерфейса (имя
приложения: OPCpE), подсистему буферизации и приложения PI ICU.
d. Настройте параметры DCOM.
3. Настройте параметры пакетного файла (.bat) запуска интерфейса с минимальными
значениями.
◦ Point source
Используйте OPC или неиспользуемый источник точки по своему выбору.
◦ Scan classes
Установите по собственному желанию. Scan class 1 зарезервирован для точек
advise.
◦ Interface ID
Укажите 1 или любой неиспользуемый числовой идентификатор.
4. Настройте соединение с сервером OPC. Открыв OPC Server на вкладке OPCInt в
программе PI ICU, нажмите кнопку List Available Servers, а затем выберите сервер.
Если сервер расположен на другой машине, укажите эту машину или ее IP-адрес в
поле Server Node.
5. С помощью PI OPC Client убедитесь, что сервер OPC подключен, функционирует и
заполнен точками.
6. Проверка запуска интерфейса.
7. Определите наборы цифровых состояний для цифровых (digital) точек PI Point.
8. Постройте входные точки и (необязательно) выходные точки для интерфейса и
убедитесь, что данные поступают в PI Data Archive.
Сведения об атрибутах точек см. в разделе Настройка точек PI Point для интерфейса
PI Interface для OPC DA.
9. Настройте буферизацию.
Остановите интерфейс, а затем настройте и запустите буферизацию. Перезапустите
интерфейс и подтвердите, что служба и буферизация перезапущены.
10. Настройте следующие необязательные элементы.
◦ Точки Performance Point и значения степени исправности

Точки Performance Point и значения степени исправности представляют собой
точки PI Point, которые отслеживают состояние и производительность
Прим.:
Интерфейс PI Interface для OPC DA не поддерживает точки Performance Point для
scan class.
◦ Запуск без соединения с сетью (Disconnected startup)

Запуск без соединения с сетью (Disconnected startup) позволяет запустить
интерфейс даже в том случае, если недоступен PI Data Archive.

◦ Отработка отказа UniInt
Отработка отказа UniInt уменьшает потери данных, позволяя резервному
экземпляру интерфейса собирать данные в случае отказа основного экземпляра
Настройка запуска интерфейса

Интерфейс PI Interface для OPC DA обычно запускается как служба Windows. Интерфейс
использует пакетный файл (.bat) Windows, указывающий настройки, в которых
применяются параметры командной строки.
Чтобы обеспечить верный формат файла .bat, используйте служебную программу PI
ICU. Не вносите изменения в файл вручную. Полный список параметров запуска UniInt
см. в разделе PI Universal Interface (UniInt) User Guide. В этом документе описаны
параметры, специфические для интерфейса.
Создание и настройка экземпляра интерфейса

Для каждого сервера OPC, предназначенного для обмена данными с системой PI System,
необходимо создать как минимум один экземпляр интерфейса PI OPC. Настройки для
каждого созданного экземпляра сохраняются в командном файле Windows (файл .bat) в
установочном каталоге интерфейса PI OPC.
Совет:
Настройте несколько экземпляров интерфейса PI Interface для OPC DA с
уникальным идентификатором (id) интерфейса и параметрами запуска point
source (ps), чтобы упростить определение места происхождения данных,
записанных в архив PI Data Archive, и отслеживать любые возникающие проблемы.
Процедура
1. Запустите PI ICU и щелкните Interface > New from BAT file.
2. Перейдите в установочный каталог интерфейса (по умолчанию %PIPC%\Interfaces
\OPCInt), выберите OPCInt.bat_new и щелкните Open.
Откроется окно Select PI Host Server.
3. Укажите архив PI Data Archive и нажмите кнопку OK.
PI ICU отображает параметры нового экземпляра интерфейса.
4. Настройте основные параметры следующим образом.
◦ Вкладка General
▪ Источник точки (Point Source)

Используйте OPC или источник точки, которые еще не используются.
▪ Идентификатор (ID)
Используйте 1 или числовой идентификатор, еще не используемый другим
экземпляром интерфейса.
▪ Scan Class
Установите нужную частоту сканирования. Scan class 1 зарезервирован для
тегов advise. При определении нескольких scan class можно распределить
рабочую нагрузку сервера с использованием смещений (offset).

◦ Страница OPCInt
Нажмите кнопку List Available Servers, а затем выберите свой сервер OPC из
раскрывающегося списка серверов. Если сервер расположен на другой машине,
укажите имя узла или IP-адрес в поле Server Node, чтобы вывести список
доступных серверов.
Прим.:
Некоторые серверы OPC могут отвергать попытки удаленного подключения.
Если поле Server Node не заполнено или содержит значение LocalHost (без
учета регистра), то интерфейс будет работать с сервером как с локальным. Если
в поле Server Node любое другое значение, то подключение будет
рассматриваться как удаленное.
◦ Вкладка Security Parameters

Большинство серверов OPC не поддерживают обеспечение безопасности OPC.
Прежде чем включать этот параметр, убедитесь, что ваш сервер OPC поддерживает
безопасность OPC. Если ваш сервер OPC требует использования клиентами защиты
OPC, включите обеспечение безопасности OPC и выберите NT security или Private
OPC security, а затем введите идентификатор пользователя и пароль.
Прим.:
Рекомендуется использовать NT security для шифрования идентификатора
пользователя и пароля. Функция частной безопасности OPC хранит и передает
эту информацию открытым текстом. Дополнительные сведения см. в разделе
Настройка безопасности интерфейса PI Interface для OPC DA.
Управление подключением серверов

Каждый экземпляр интерфейса PI Interface для OPC DA подключается к одному серверу
OPC. Для работы с несколькими серверами OPC следует запустить несколько
экземпляров интерфейса PI OPC. Можно настроить несколько экземпляров интерфейса
на подключение к одному и тому же серверу OPC. Чтобы интерфейс мог собирать
данные без подключения к PI Data Archive, настройте запуск этого интерфейса в
отключенном состоянии (без соединения с сетью).
Если интерфейс не может подключиться к серверу OPC во время запуска, то он
регистрирует сбой в журнале и выполняет попытки подключения каждые пять секунд,
пока не возобновит подключение. Когда сервер OPC сообщает о том, что он запущен,
интерфейс подключается к нему и начинает создание групп и добавление элементов.
Если интерфейс PI OPC потеряет связь с сервером OPC после первоначального
подключения, то он попытается восстановить его. Чтобы предотвратить потерю каких-
либо данных с сервера OPC в случае отключения PI Data Archive, настройте буферизацию
на узле интерфейса.
Дополнительные сведения о буферизации см. в разделе PI Buffering Manager Help Files.
Настройка безопасности интерфейса PI Interface для OPC

DA
Отправка данных по сетям и через отдельные машины в этих сетях может представлять
риски для безопасности. Поэтому рекомендуется настроить учетные записи служб
интерфейсов с использованием наиболее безопасных из возможных методов,
соответствующих вашим требованиям.
Общие сведения о типах учетных записей служб, ограничении доступа к учетным
записям безопасности и защите интерфейсов чтения-записи см. в разделе PI Universal

Interface (UniInt) User Guide. Дополнительные сведения о настройке безопасности DCOM

см. в разделе DCOM Security and Configuration Guide.
Рекомендуемые меры безопасности интерфейса PI Interface для OPC DA

Дополнительные сведения о безопасности OPC см. в разделе DCOM Security and
Configuration Guide. Дополнительные сведения о настройке безопасности PI Data Archive
см. в разделе PI Server Configuring PI Server Security.
Для установки интерфейса требуется учетная запись администратора, позволяющая
выполнять следующие задачи.
• Установка программного обеспечения интерфейса.
• Создание учетной записи службы интерфейса.
• Создание, изменение и удаление службы интерфейса.
• Добавление, обновление и удаление счетчиков производительности.
Рекомендации по безопасности учетных записей служб для интерфейсов PI Interface на
основе платформы UniInt обсуждаются в разделе PI Universal Interface (UniInt) User Guide.
Прим.:
В некоторых случаях права учетной записи службы интерфейса могут быть
ограничены, чтобы ограничить доступ к файлам, папкам и разделам реестра.
Виртуальные учетные записи служб, управляемые учетные записи служб, учетные
записи служб домена без прав администратора и локальные учетные записи служб
без прав администратора являются лучшими вариантами ограничения
разрешений учетных записей служб.
Дополнительные сведения об управлении безопасностью и трастами в PI Data Archive
см. в разделе PI Server System Management Guide.
Проверка подлинности и авторизация

Для подключения интерфейса к PI Data Archive учетная запись службы интерфейса
должна пройти проверку подлинности и быть авторизована для обмена данными. Это
требует настройки безопасности для приложений, подключающихся к PI Data Archive.
Дополнительные сведения о проверке подлинности и авторизации для интерфейсов см.
в руководстве пользователя PI Universal Interface (UniInt).
Прим.:
При настройке пользователей и групп PI System для интерфейса избегайте
использования суперпользователя piadmin и группы piadmins. Эти встроенные
пользователи и группы обладают правами высокого уровня, которые могут
представлять риски для безопасности.
Безопасность точек PI Point и файлы белых списков

Безопасность точек PI Point можно настроить для доступа пользователя к атрибутам
точки с помощью атрибута ptsecurity и к данным точки с помощью атрибута
datasecurity.
Для выходных точек атрибуты zero и span позволяют указать минимальное и
максимальное значения, разрешенные выходной точкой.
Для всех интерфейсов, которые могут вести запись в источник данных, OSIsoft
рекомендует настроить файл разрешенных выходных точек из PI Data Archive в
источник данных. Создайте белый список выходных точек, чтобы указать
авторизованные обновления точек в источнике данных. При использовании белого

списка интерфейс проверяет выходную точку по списку перед обновлением источника

данных. Файл белого списка представляет собой файл со значениями, разделенными
запятой (.csv), в котором содержится список допустимых выходных точек и атрибутов,
необходимых для указания выходных точек и их целевого расположения в пределах
источника данных. Если вывод в источник данных не требуется, то оставьте файл
белого списка пустым. Включите использование белого списка с помощью параметра
запуска /whitelist=path/filename.
Дополнительные сведения о настройке файла белого списка и о параметре файла
запуска, который включает файл белого списка, см. в разделе Настройка файла белого
списка или PI Universal Interface (UniInt) User Guide.
Безопасность DCOM
Серверные и клиентские приложения OPC основаны на модели связи Microsoft COM/
DCOM. Обзор см. в разделе Настройка DCOM для интерфейса PI Interface для OPC DA.
Дополнительные сведения о безопасности DCOM для продуктов PI OPC см. в разделе
DCOM Security and Configuration Guide.
Создание PI Trust
При создании PI Trust существует много вариантов. Ниже приведен простой и надежный
подход к созданию PI Trust для следующих приложений.
• PI Interface для OPC DA

• Программа настройки интерфейса PI Interface (PI ICU)
• Буферизация
Прим.:
Не рекомендуется использовать удостоверения, пользователей или группы с
расширенными правами в PI Trust для интерфейсов. Избегайте использовать
суперпользователя piadmin и группу piadmins. Рекомендуемый подход к
безопасности PI Data Archive — создать удостоверение, пользователя или группу,
обладающих только правами пользователя, необходимыми для
функционирования интерфейса, PI ICU или буферизации.
Чтобы создать каждый из этих трастов PI Trust с помощью PI System Management Tools,
подключитесь к серверу PI Data Archive и выполните следующие действия.
Процедура
1. Щелкните Security и выберите Mappings & Trusts.
2. Щелкните правой кнопкой мыши вкладку Trusts и выберите New Trust.
Откроется мастер Add Trust.
3. Укажите понятное имя и описание для траста PI Trust.
4. Настройте параметры следующим образом.
PI Trust Тип Application Name Network Path PI User
(Сетевой путь)
PI Interface для Приложение PI OPCpE Имя узла PI Identity с
OPC DA API интерфейса или правами доступа
IP-адрес плюс к точкам PI Point
маска сети для интерфейса.
255.255.255.255 Включено
атрибутом
datasecurity.

PI Trust Тип Application Name Network Path PI User

(Сетевой путь)
PI ICU Приложение PI PI-ICU.exe Имя узла Выделенное
API интерфейса или удостоверение PI
IP-адрес плюс Identity с
маска сети разрешениями,
255.255.255.255 точно
соответствующи
ми необходимым
(доступ на
чтение для базы
данных, чтение
ptsecurity
разрешение на
чтение и запись
для точек OPC)
Буферизация Приложение PI Bufserv: APIBE Имя узла Удостоверение
API интерфейса или службы
PIBufss:
IP-адрес плюс буферизации с
Pibufss.exe
маска сети необходимыми
255.255.255.255 правами для
точек PI Point
всех
интерфейсов в
узле интерфейса.
Настройка службы Windows

Чтобы обеспечить перезапуск интерфейса PI Interface для OPC DA при перезапуске узла
интерфейса, настройте его запуск как службы Windows.
Прим.:
В целях безопасности рекомендуется запускать службу интерфейса от имени
учетной записи с минимальными правами, например от виртуальной учетной
записи встроенной службы Windows, встроенной учетной записи Network Service
или созданной вами неадминистративной учетной записи. Дополнительные
сведения о безопасности см. в разделе Рекомендуемые меры безопасности
интерфейса PI Interface для OPC DA.
С помощью PI ICU установите интерфейс как службу.
Процедура
1. Запустите PI ICU и перейдите на вкладку Service.
2. Заполните поля, как показано в следующей таблице.
Поле Описание
Service name Описательное имя службы интерфейса.
ID Числовой идентификатор экземпляра интерфейса. Должен быть уникальным
для каждого экземпляра.
Display name Имя службы, отображаемое на панели управления Windows Services.
По умолчанию отображаемое имя — имя службы с префиксом PI-. Можно
переопределить значение по умолчанию. Чтобы службы, относящиеся к
OSIsoft, были расположены вместе на панели управления Services, сохраните
префикс PI-.

Поле Описание
Log on as Пользовательская учетная запись Windows, связанная со службой.
Пользователь должен иметь разрешения DCOM, настроенные на сервере OPC.
Задайте срок действия пароля Never.
Password Пароль, если он указан, для указанного выше пользователя.

Dependencies Любые службы, от которых зависит функционирование интерфейса.
Единственная зависимость — служба TCP/IP, заданная заранее. Если
буферизация включена, то вы получите запрос для создания зависимости от
службы буферизации.
Startup type Указывает, запускается ли служба интерфейса автоматически при перезапуске
узла интерфейса. Обычно службы интерфейса настраиваются на
автоматический запуск.
3. Чтобы создать службу, щелкните Create.

4. Для запуска службы нажмите кнопку .
Управление службой интерфейса PI Interface для OPC DA

После установки интерфейса как службы Windows процедуры в этом разделе помогут в
управлении ей.
Процедура
• Чтобы удостовериться, что служба функционирует, запустите services.msc из меню
Пуск ОС Windows.
• Для запуска и останова службы пользуйтесь PI ICU.
• Чтобы удалить службу с помощью PI ICU, остановите ее и щелкните Remove.
• Чтобы запустить службу в интерактивном режиме, запустите PI ICU и выберите
Interface > Start Interactive.
Запуск в интерактивном режиме, как правило, необходим только для отладки.
Настройка DCOM для интерфейса PI Interface для OPC DA

Классические серверные и клиентские приложения OPC основаны на модели связи
Microsoft COM/DCOM. Тип связи зависит от сетевой конфигурации:
• COM (Component Object Model)

Предоставляет набор интерфейсов, которые позволяют компонентам программного
обеспечения обмениваться данными на одном компьютере.
• DCOM (Distributed Component Object Model)

Расширяет модель COM, позволяя программным компонентам обмениваться
данными между сетевыми узлами.
DCOM позволяет процессу на одном компьютере запрашивать у другого компьютера
исполнение программ от его имени, поэтому нужно с осторожностью выдавать
разрешения, чтобы поддерживать безопасность.
Прим.:
Разрешения DCOM должны быть предоставлены учетным записям, под которыми
выполняются сервер OPC и интерфейс PI Interface для OPC DA, даже если для
сервера OPC и клиента OPC используется один и тот же узел.

Более подробную информацию см. в разделе DCOM Security and Configuration Guide.
• Уровни безопасности DCOM
• Клиенты и серверы DCOM
• Домены и пользователи Windows
• Учетные записи пользователей DCOM
• Брандмауэры и безопасность
Уровни безопасности DCOM

Доступ к серверу COM регулируется средствами безопасности Windows и управляется
списками доступа (ACL), которые предоставляют определенным пользователям или
группам разрешение на использование соответствующего сервера. Кроме того,
политики и настройки системного уровня определяют способ проверки подлинности
пользователей и предоставления разрешений.
Безопасность DCOM реализована на нескольких уровнях:
• Списки доступа, настройки и политики системного уровня определяют
минимальный уровень безопасности для всех компонентов DCOM (списки доступа
Edit Limits в dcomcnfg).
• Списки доступа и настройки безопасности по умолчанию используются, если
компонент DCOM не задает явно уровень безопасности (списки доступа Edit
Defaults в dcomcnfg).
• Настраиваемые списки доступа и уровни безопасности можно задать для отдельных
серверов DCOM с помощью Windows dcomcnfg .
• Настраиваемая безопасность может быть реализована в коде сервером DCOM
(CoInitializeSecurity).
Клиенты и серверы DCOM

Серверы OPC являются серверами DCOM, а клиенты OPC — клиентами DCOM, но эти
роли не фиксированы.
Интерфейс PI Interface для OPC DA получает данные с сервера OPC через асинхронные
обратные вызовы (callbacks). В процессе обратного вызова интерфейс PI Interface для
OPC DA действует в качестве сервера DCOM, в то время как сервер OPC выступает
клиентом DCOM. По этой причине необходимо настроить безопасность DCOM узла
интерфейса, чтобы разрешить доступ по учетной записи, связанной с сервером OPC.
Домены и пользователи Windows

Домен Windows представляет собой сеть компьютеров с общей базой данных
безопасности. Если узел интерфейса PI Interface для OPC DA и сервер OPC являются
участниками одного и того же домена (включая домены с двунаправленными
трастами), то пользователи домена могут включаться в списки управления доступом
DCOM. Если интерфейс и сервер располагаются в разных доменах, то необходимо
настроить идентичные локальные учетные записи на обеих машинах и использовать
эти учетные записи в списках ACL. Эти учетные записи должны иметь идентичные
имена пользователя и пароли, а ограничение срока действия паролей для них должно
быть отключено.

Если интерфейс и сервер OPC находятся на одном и том же компьютере, то можно

использовать любую учетную запись, распознаваемую этим компьютером, включая
встроенную учетную запись SYSTEM. Некоторые серверы OPC реализуют специальные
меры безопасности. В таком случае учетной записи необходимо предоставление доступа
к серверу OPC независимо от разрешений DCOM.
Компьютеры в конфигурациях рабочих групп Windows по умолчанию обладают
политиками, которые вмешиваются в обмен данными между сервером и клиентом OPC,
что требует отключения простого общего доступа к файлам.
Учетные записи пользователей DCOM

Если у поставщика сервера OPC имеются предписанные настройки DCOM, не изменяйте
их иначе как в случае, если при использовании этих настроек невозможна связь с
сервером. Настройки DCOM не сохраняют историю внесенных изменений. Чтобы
обеспечить возможность возврата к исходным настройкам (при необходимости),
следует записать текущие настройки перед выполнением каких-либо изменений.
Следует корректировать настройки клиента в соответствии с сервером, а не наоборот.
Доступ к серверам DCOM регулируется списками доступа (ACL), в которых указываются
учетные записи пользователей и связанные с ними разрешения. Когда клиент вызывает
сервер, проверяется подлинность учетной записи пользователя, связанной с
клиентским процессом, затем оценивается список ACL, чтобы определить, имеется ли у
соответствующей учетной записи разрешение использовать сервер.
Для запуска интерактивных клиентов, например PI OPC Client или PI Interface для OPC
DA, в интерактивном режиме эффективным пользователем является учетная запись,
которая использовалась для входа на компьютер. Интерактивный процесс можно
запустить под другой учетной записью с помощью команды RunAs.
Для клиентских программ, выполняемых в качестве служб Windows, пользователем
является учетная запись, указанная на вкладке Вход панели управления Службы.
Для сервера OPC пользователем является учетная запись, указанная на вкладке Identity
в конфигурации DCOM для сервера. Windows предоставляет несколько настроек для
удостоверения, используемого сервером DCOM.
• Interactive user
Учетная запись, выполнившая вход в консоль компьютера, на котором работает
сервер. Эта настройка проблема для связи с OPC: если ни один пользователь не вошел
в консоль или если вошедший пользователь не имеет разрешений DCOM, клиент не
сможет подключиться к серверу OPC.
• Launching user
Процесс на сервере запускается от той же учетной записи, что и вызывающий клиент.
Не используйте эту настройку, если нескольким клиентам, работающим под разными
учетными записями, требуется доступ к одному и тому же серверу OPC, так как для
каждого пользователя запускается новый экземпляр сервера OPC. Обратите
внимание, что идентификатор пользователя вызывающего клиента может не иметь
разрешения на подключение к серверу, так как многие серверы реализуют
собственную проверку подлинности пользователей, помимо разрешений DCOM.
• This user
Рекомендуется только в том случае, если поставщик сервера OPC не указывает
другую настройку. Включите указанного пользователя в списки доступа DCOM по
умолчанию на узле интерфейса. Если сервер OPC запускается как служба Windows,
используйте ту же учетную запись, что и для службы.

• System account (services only)

Используйте только в том случае, если интерфейс запускается на том же компьютере,
что и сервер OPC.
Брандмауэры и безопасность
В DCOM используются динамически назначаемые TCP-порты. Клиент OPC подключается
к серверу OPC по порту 135 (программа сопоставления портов RPC), в результате чего
компоненту выделяется один порт TCP и один порт UDP. Обмен данными между
клиентом и сервером выполняются через эти порты. Из-за этих ограничений трудно
настроить DCOM для работы через обычные брандмауэры.
Сторонние поставщики предоставляют продукты, учитывающие эти ограничения.
Средства туннелирования OPC используют специализированный клиент OPC, зеркально
отражающий данные на специализированный сервер OPC через зашифрованный канал.
Настроенные на работу с OPC брандмауэры обеспечивают безопасную связь с серверами
OPC с минимальными настройками.
Если решения сторонних поставщиков нежелательны, обеспечьте безопасность OPC,
выполнив настройку следующим образом.
• Если поставщик сервера OPC позволяет, устанавливайте интерфейс PI Interface для
OPC DA на той же машине, что и сервер OPC. Локальное подключение COM позволяет
не обращать внимания на проблемы брандмауэра при обмене данными между
клиентом и сервером.
• Если требуется отдельный узел интерфейса, найдите интерфейс в подсети сервера
OPC. Гораздо проще открыть единственное исключение брандмауэра для порта 5450
на сервере PI Data Archive, чем настраивать DCOM для работы через обычный
брандмауэр.
• Настройте разрешения DCOM по принципу предоставления минимальных прав,
указывая только конкретные учетные записи службы в списках управления доступом
DCOM.
• Используйте встроенный брандмауэр Windows, поставляемый с используемой
версией Windows.
Настройка точек PI Point для интерфейса PI Interface для

OPC DA
Точка PI Point — это запись отдельного набора измерений (например, температуры в
баке) с меткой времени. Настройте точки PI Point, чтобы интерфейс PI Interface для OPC
DA мог передавать данные с сервера OPC в PI Data Archive.
Прим.:
Наполнить PI Data Archive точками, определенными на вашем сервере OPC, можно с
помощью средства PI OPC Client или OPCtoCSV для экспорта элементов OPC в файл
Excel (.csv), а затем воспользоваться функцией PI SMT Tag Configurator для
загрузки тегов в PI Data Archive. Дополнительную информацию см. в разделе
Экспорт элементов OPC в конфигуратор точек PI Point.
Если вывод данных на сервер OPC не требуется, настройте экземпляр интерфейса на
отключение операций вывода из PI Data Archive. Если требуется вывод данных,
настройте белый список точек output для экземпляра интерфейса.

Прим.:
Отключение операций вывода или настройка белого списка точек output защищает
от случайных или злонамеренных изменений в системе управления.
Дополнительные сведения см. в разделе Рекомендуемые меры безопасности
Точки PI Point интерфейса PI Interface для OPC DA требуют следующей минимальной
настройки атрибутов точек.
• Имя точки (tag)
• Источник точки (pointsource)
• Тип данных (pointtype)
• Экземпляр интерфейса (location1)
• Тип точки PI Point: advised, event или polled (location3)
• Scan class (location4)
• OPC ItemID (instrumenttag)
В зависимости от типа создаваемой точки могут потребоваться дополнительные
настройки атрибутов.
• Экспорт элементов OPC в конфигуратор точек PI Point
• Создание точек PI Point вручную
• Настройка атрибутов точек
• Настройки классов scan class и частоты обновления
• Входные точки для интерфейса PI Interface для OPC DA
• Конфигурации точки output
• Совместимость типов данных
Экспорт элементов OPC в конфигуратор точек PI Point

Чтобы заполнить PI Data Archive точками, определенными на сервере OPC,
воспользуйтесь средством PI OPC Client или OPCtoCSV (которое устанавливается в %PIPC
%\PI OPC Tools\PI_OPCtoCSV) для экспорта элементов OPC в файл Excel (.csv), а
затем с помощью Tag Configurator из состава PI System Management Tools (PI SMT)
загрузите точки в PI Data Archive.
Прим.:
Чтобы программа PI Tag Configurator могла создавать точки PI Point, необходимо
определить PI Trust или настроить разрешения, позволяющие Microsoft Excel
производить запись в PI Data Archive.
Чтобы экспортировать точки OPC и создать соответствующие точки PI Point, выполните
следующие действия.
Процедура
1. Запустите средство PI OPC Client и подключитесь к серверу OPC.
2. Чтобы выбрать элементы OPC, которые нужно экспортировать, создайте группу
(щелкните ) и добавьте в нее нужные элементы.
3. Выберите File > Save As и укажите имя и расположение файла экспорта.

4. Нажмите кнопку Сохранить (Save).

PI OPC Client создаст файл .csv, содержащий выбранные элементы OPC.
5. В PI SMT запустите Microsoft Excel, выбрав Tools > Tag Configurator.
6. В Microsoft Excel откройте файл .csv, который содержит экспортированные
элементы OPC.
7. Рассмотрите созданные записи, чтобы убедиться в том, что перечислены нужные
точки. Если какие-либо записи содержат значение Unknown в столбце PointType,
укажите нужный тип данных для точки.
8. Чтобы создать точки PI Point, выберите PI SMT > Export Tags. Откроется окно Export PI
Tags.
9. Выберите целевой узел PI Data Archive и нажмите кнопку ОК.
10. Рассмотрите список результатов и убедитесь, что точки PI Point созданы.
Создание точек PI Point вручную

Для построения отдельных точек PI Point вручную используйте функцию Point Builder в
PI System Management Tools (SMT). Для запуска Point Builder выберите Points > Point
Builder
Настройка атрибутов точек

Настройте входные и возможные выходные точки PI Point для интерфейса PI Interface
для OPC DA с использованием следующих минимальных атрибутов.
Процедура
1. Убедитесь, что настроены следующие атрибуты точки PI Point.
◦ pointsource
Идентифицирует все точки, принадлежащие этому экземпляру интерфейса PI OPC.
Укажите тот же Point source, который введен на вкладке General служебной
программы PI ICU.
◦ location1
Указывает идентификатор экземпляра интерфейса OPC, который отображается на
вкладке General служебной программы PI ICU.
◦ location2
Чтобы включить обработку для серверов OPC, которые не возвращают
определенные числовые типы в их собственном формате, присвойте location2
значение 1. Числовые данные возвращаются в виде строки.
◦ location3
Тип точки. Варианты:0 (polled), 1 (advise) или 2 (output).
◦ location4
Указывает scan class.
◦ location5
Дополнительное значение зоны нечувствительности для точек advise.

◦ exdesc
Указывает точки событий, Long ItemID, Dzero для масштабируемых точек или
ItemID, чтобы получить метку времени для выходного значения.
◦ instrumenttag
OPC ItemID, соответствующий точке PI Point, которую вы определяете.
Учитывается регистр символов. Для отображения элементов сервера OPC
воспользуйтесь средством PI OPC Client Tool.
◦ datasecurity
Для каждой точки PI Point, обслуживаемой экземпляром интерфейса, список
управления доступом в атрибуте datasecurity должен предоставить доступ на
чтение для PI identity в PI Trust, который проверяет подлинность экземпляра
интерфейса. Если интерфейс используется без приложения буферизации, то
должен быть также предоставлен доступ на запись. Если интерфейс используется
с приложением буферизации, то приложению буферизации требуется доступ на
запись (но не интерфейсу).
Прим.:
Когда буферизация настроена, атрибут datasecurity должен разрешить
доступ на запись для сопоставления или PI Trust приложения буферизации.
Разрешение на запись datasecurity для PI Trust интерфейса требуется только
в том случае, если буферизация не настроена.
◦ ptsecurity
Список управления доступом в атрибуте ptsecurity каждой точки PI Point,
обслуживаемой экземпляром интерфейса, должен предоставить доступ на чтение
для PI Identity в PI Trust, который проверяет подлинность экземпляра интерфейса.
Атрибуты точек для интерфейса PI Interface для OPC DA

Некоторые конфигурации атрибутов точек PI Point относятся к точкам интерфейса PI
Interface для OPC DA, в то время как другие являются общими для всех точек.
Дополнительные сведения о конфигурациях точек PI Point см. в разделах PI Universal
Interface (UniInt) User Guide и PI Server System Management Guide.
Tag
Атрибут Tag (или имя тега) представляет собой имя точки. Существует однозначное
соответствие между именем точки и самой точкой. Поэтому в документации по PI
System термины «тег» и «точка» используются как взаимозаменяемые.
Соблюдайте следующие правила именования точек PI Point.
• Имя должно быть уникальным в пределах архива PI Data Archive.

• Первый символ должен быть алфавитно-цифровым символом, нижним
подчеркиванием (_) или знаком процента (%).
• Управляющие символы, такие как знаки табуляции и перевода строки, запрещены.
• Запрещены также следующие символы: * ’ ? ; { } [ ] | \ ` '‘"“
Длина
В зависимости от версии PI API и PI Data Archive, этот интерфейс поддерживает
атрибуты Tag, длина которых не более 255 или 1023 знаков. В следующей таблице

указана максимальная длина этого атрибута для всех возможных комбинаций версий PI
API и PI Data Archive.
PI API PI Data Archive Максимальная длина
6.0.2 или более поздняя версия 4.370.x или более поздняя 1023
4.370.x или более поздняя версия
версия
6.0.2 или более поздняя версия Более ранние, чем 3.4.370.x 255
Более ранние, чем 1.6.0.2 4.370.x или более поздняя 255
версия
Более ранние, чем 1.6.0.2 Более ранние, чем 3.4.370.x 255
Если PI Data Archive имеет версию ранее 3.4.370.x или версию PI API ранее 1.6.0.2 и если
нужно использовать максимальную длину тега 1023, то необходимо включить PI SDK.
Дополнительные сведения см. в *** SDK options***.
PointSource
Атрибут PointSource содержит уникальную одно- или многосимвольную строку,
используемую для идентификации PI Point как точки, принадлежащей к определенному
интерфейсу.
Атрибут типа данных

Атрибут типа данных (pointtype) указывает, какой тип данных хранится в точке PI
Point.
Обычно типам данных элементов OPC не требуется в точности соответствовать типам
данных точек PI Point, но эти типы данных должны быть совместимы. Например,
целочисленные значения с устройства могут отправляться на точки PI Point с
плавающей запятой или цифровые (digital) точки. Аналогичным образом, значение с
плавающей запятой с устройства может отправляться на целочисленные (integer) или
цифровые (digital) точки PI Point, хотя значения могут усекаться.
Интерфейс PI Interface для OPC DA поддерживает все типы точек PI Point, за
исключением BLOB.
Прим.:
У некоторых серверов OPC отсутствует поддержка полного спектра типов точек PI
Point. Чтобы определить, какие типы точек PI Point поддерживаются вашим
сервером OPC, см. документацию, предоставленную поставщиком.
Если тип точки, определенный в PI Data Archive, не соответствует требуемому типу
данных, определенному на сервере OPC, интерфейс пытается преобразовать данные.
Чтобы определить, можно ли прочитать точку в виде необходимого типа,
воспользуйтесь средством PI OPC Client Tool и попытайтесь прочитать точку
непосредственно с сервера OPC. Дополнительные сведения о совместимости типов
данных см. в разделе Совместимость типов данных.
Location1 (Расположение 1)
Location1 указывает, какой копии интерфейса принадлежит точка. Значение этого
атрибута должно соответствовать параметру командной строки /id.

Атрибут обработки типов данных (location2)

Атрибут location2 настраивает обработку типов данных для интерфейса PI Interface
для OPC DA.
Допустимые настройки для location2 следующие:
Value Описание
0 Обычная обработка; специальная обработка не применяется.
1 Чтение и запись значения в виде строки (string).
Для цифровых (digital) точек строки, считанные с сервера OPC, должны
соответствовать строкам в наборе цифровых состояний, используемом точкой
PI Point. Для целочисленных (integer) и действительных (real) точек
интерфейс запрашивает строковое значение и преобразует его в число.
2 Чтение значения в логическом виде (Boolean). Логические значения (Boolean)

являются либо нулевыми, либо ненулевыми.
Для числовых точек любое значение, кроме 0 (False), устанавливается как -1
(True). Эта настройка позволяет правильно преобразовать логическое
значение с сервера OPC в цифровое состояние PI System, что препятствует
получению точкой PI Point значений Bad quality для логического значения
(Boolean), которое является True.
3 Чтение значения в виде четырехбайтового целого числа (integer).

Эта настройка адаптируется к серверам, которые не могут передавать
значение в виде двухбайтового целого числа (integer), как обычно
считываются цифровые (digital) точки.
4 Сохраняет качество элемента вместо его значения.

5 Действительные (real) точки следует запрашивать в виде элементов VT_R8
(восьмибайтовых действительных чисел).
По умолчанию интерфейс запрашивает действительные (real) точки в виде
элементов VT_R4 (четырехбайтовых действительных чисел). Для точек float32
(включая все точки PI2 Real) значения, которые не помещаются в 32-битном
числе с плавающей запятой, теряют точность. Эта настройка включена для
поддержки серверов, которые не преобразуют данные VT_R8 в данные VT_R4,
и для того, чтобы разрешить использование точек float32, когда
преимущество повышенной точности не оправдывает затрат на
использование точек float64.
6 Чтение меток времени с сервера OPC в виде строк и преобразование их в

секунды.
Точка PI Point может иметь тип int или float. Формат строки метки времени
указывается в пакетном (bat) файле интерфейса с помощью параметра tf.
7 Чтение меток времени с сервера OPC в виде переменных VT_DATE.

Эти значения могут быть преобразованы в строки меток времени или
переданы в PI Data Archive в виде числа секунд, пригодного для
использования в вычислениях. Если значение преобразуется в строку, то
формат строки метки времени указывается в пакетном (bat) файле
интерфейса с помощью параметра tf.
8 Указывает серверу OPC передавать канонический тип данных.

Интерфейс пытается преобразовать значение в надлежащий тип данных для
точки PI Point. Использовать это следует с осторожностью, так как
преобразование может завершиться неуспешно, если исходный тип данных
несовместим с типом данных точки PI Point, или если значение не может быть
представлено с использованием типа данных точки PI Point.

Value Описание
>= 1024 При использовании DLL-библиотеки постобработки с интерфейсом PI
Interface для OPC DA указывает, что данные будут обработаны DLL-
библиотекой.
Добавление любой из приведенных выше настроек (1–8) к 1024 включает
использование соответствующих режимов в ходе обработки. Дополнительные
сведения см. в разделе TimeArray Plug-in User Manual.
Обработка атрибута типа (location3)

Атрибут location3 указывает, является ли данная точка PI Point точкой polled, advise,
event или output.
Location3 Описание
0 Точка polled или точка event
1 Advise
2 Output
3 «Сторожевая» (watchdog) точка polled, используемая при отработке отказа на
уровне сервера
4 «Сторожевая» (watchdog) точка advise, используемая при отработке отказа на
уровне сервера
Для точки advise интерфейс PI Interface для OPC DA регистрируется для обновления на
сервере OPC, а сервер OPC передает интерфейсу новые данные. Частота обновления с
сервера не превышает частоту обновления для группы.
Атрибут Scan class (location4)

Атрибут location4 настраивает scan class для точки PI Point. Scan class определяет
частоту, с которой входные теги сканируются на наличие новых значений.
Для точек на основе триггеров задайте location4 значение, равное нулю. Для всех
остальных точек атрибут location4 должен быть положительным числом. Для
выходных тегов location4 настраивает класс вывода. Если это необходимо для
балансирования нагрузки, интерфейс распределяет теги в scan class 1 по нескольким
группам OPC. Классы, отличные от scan class 1, назначаются отдельным группам для
балансирования нагрузки.
Можно назначить несколько групп одним и тем же классам scan class для интерфейса PI
Interface для OPC DA. Для каждого scan class (за исключением scan class 1) можно
назначить не более одной группы polled, одной группы advise и одной группы output.
Имеются следующие ограничения.
Tag Максимальное число групп
Polled 200
Advise 600
Событие 199
Output Нет ограничений
Стандарт OPC не гарантирует возможность сканирования данных с частотой, указанной

вами для того или иного scan class. Если сервер OPC не поддерживает запрашиваемую
частоту сканирования, то назначенная классу частота заносится в файл pipc.log. Если

интерфейс подвергается тяжелой рабочей нагрузке, то сканирование может

выполняться с опозданием или пропускаться. Дополнительные сведения о
пропущенных сканированиях см. в разделе PI Universal Interface (UniInt) User Guide.
Дополнительные сведения о выборе scan class, смещении при сканировании и частоте
обновления см. в разделе Настройки классов scan class и частоты обновления.
Зона нечувствительности OPC (location5)

В соответствии со стандартом OPC обработка зоны нечувствительности необязательна
для серверов. Если сервер OPC не поддерживает обработку зоны нечувствительности, то
точка PI Point обновляется для всех изменений значений в зависимости от атрибутов
исключения, указанных для точки PI Point.
Зона нечувствительности позволяет сократить объем сетевого трафика от сервера OPC
к интерфейсу PI Interface для OPC DA. Если изменение между последним прочитанным
значением и новым значением меньше зоны нечувствительности, то сервер OPC не
отправляет значение интерфейсу. Для точек advise атрибут location5 указывает
значение зоны нечувствительности для аналоговых элементов OPC.
Прим.:
Прежде чем пытаться настроить точки advise, убедитесь, что сервер OPC
поддерживает обработку зоны нечувствительности.
Обработка зоны нечувствительности сервера OPC — не то же самое, что обработка зоны
нечувствительности исключения, которая происходит между интерфейсом и архивом PI
Data Archive.
Чтобы настроить зону нечувствительности сервера OPC, укажите процент диапазона
зоны нечувствительности исключения, умноженный на 100. Зона нечувствительности
сервера OPC применима только к аналоговым элементам dwEUType, которые
используют свойства EU Low и EU High для расчета диапазона для элемента. Эти
свойства элемента OPC соответствуют атрибутам zero и span в определении точки PI
Point. Дополнительные сведения о зоне нечувствительности сервера OPC см. в
спецификации OPC DA 2.05.
Например, если элемент сервера OPC определен как аналоговый с EU Low равным -10 и
EU High равным 10, а значение location5 установлено в 2500 (25%), то данные
передаются в интерфейс только когда разница между новым значением и старым
значением составляет не менее 5 (25% от 20 = 5). Обработка зоны нечувствительности
исключения по-прежнему применяется к значениям, принимаемым интерфейсом.
Значение атрибута (location5) зоны нечувствительности OPC влияет только на
значения, переданные сервером OPC.
Атрибут ItemID OPC (instrumenttag)

Атрибут instrumenttag сопоставляет точку PI Point с элементом OPC. Это поле должно
точно соответствовать имени элемента, как определено на сервере OPC, включая знаки
пунктуации, пробелы и регистр.
Проверить ItemID можно с помощью средства PI OPC Client. Если сервер OPC
поддерживает просмотр, выберите List Server’s Tags, чтобы увидеть список
определенных значений ItemID. Чтобы показать полный ItemID, необходимый для поля
instrumenttag, дважды щелкните ItemID в списке
Максимальная длина атрибута instrumenttag зависит от используемых версий PI Data
Archive и PI API. Если PI API представлена версией 1.6.0.2 или более поздней, а PI Data
Archive — версией 3.4.370.x или более поздней, то максимальная длина — 1023. Для всех
более ранних версией максимальная величина составляет 32. Если вы работаете с более

ранними версиями и требуется более 32 символов, чтобы указать ItemID, то необходимо

включить PI SDK или использовать расширенный дескриптор (атрибут exdesc) для
указания ItemID OPC.
Атрибут расширенного дескриптора (exdesc)

Атрибут расширенного дескриптора (exdesc) является многоцелевым полем.
Если атрибут exdesc используется для указания более одной настройки, разделяйте
определения запятой.
По умолчанию начальные и конечные пробелы удаляются из записей в атрибуте
exdesc. Чтобы сохранились начальные и конечные пробелы, заключите запись в
двойные кавычки.
Интерфейс PI Interface для OPC DA использует атрибут exdesc следующим образом.
• Сбор данных на основе событий

Чтобы определить тег события, установите для этого атрибута значение event=tag.
Если для указанного тега имеется событие исключения, то теги, для которых оно
срабатывает, считываются с сервера OPC.
• Dzero для масштабированных тегов

Если устройство возвращает значения, которые необходимо масштабировать под
диапазон значений, хранящихся в теге, сохраните нуль устройства в атрибуте exdesc.
Формат для указания нуля устройства — Dzero=nnnnn.nnn. Чтобы указать диапазон
устройства, воспользуйтесь атрибутом convers.
• Целевой элемент OPC для метки времени выходного тега

Чтобы направить метку времени выходной точки в элемент OPC, укажите целевой
ItemID в атрибуте exdesc.
Формат метки времени зависит от типа данных ItemID, который должен получить
эту метку времени, как указано ниже.
◦ Tim=ItemID
Если задан параметр Tim, то метка времени будет записываться в виде строки
(VT_BSTR), отформатированной для экземпляра интерфейса с использованием
параметра формата метки времени (tf) из пакетного (bat) файла. Метка времени
поступает с сервера PI Data Archive и не корректируется при различиях в часовом
поясе или настройке летнего времени.
◦ Dat=ItemID
Если задано Dat, то метка времени будет записываться в виде VT_DATE.
VT_DATE — это тип автоматизации, в котором не указывается часовой пояс.
Значения VT_DATE обычно интерпретируются как локальное время.
В сообщениях об ошибках, связанных с ItemID этой метки времени, интерфейс
указывает созданное имя тега в форме TS:pointname, где pointname — имя (атрибут
tag) выходной точки PI Point.
• OPC ItemID
Вследствие ограничений на максимальную длину атрибута instrumenttag может
возникнуть необходимость указать OPC ItemID в атрибуте exdesc.

Используйте синтаксис instr=ItemID, где ItemID в точности соответствует ItemID,

определенному на сервере OPC. Если ItemID содержит запятую или пробел, заключите
его в двойные кавычки.
Если версия PI API — 1.6.0.2 или более поздняя, а версия PI Data Archive — 3.4.370.x
или более поздняя, то максимальная длина атрибута instrumenttag равна 1023
символам. Для всех предыдущих версий максимальная длина равна 32. Если
используются более ранние версии и для указания ItemID требуется более 32
символов, то необходимо включить PI SDK или указать OPC ItemID с помощью
атрибута exdesc.
Атрибут исходной точки PI Point (sourcetag)

Для точек output (точек, записывающих данные в сервер OPC) атрибут sourcetag
указывает имя (сохраненное в атрибуте tag) точки PI Point, из которой считываются
данные.
Дополнительные сведения см. в разделе Конфигурации точки output.
Атрибут кода масштабирования (totalcode)

Атрибут totalcode содержит код, который указывает, как должно масштабироваться
значение.
Атрибут totalcode используется в сочетании с атрибутами squareroot, convers и
exdesc. Дополнительные сведения см. в разделе Преобразования и масштабирование.
Атрибут квадратного корня (squareroot)

Атрибут squareroot указывает квадратный корень значения, которое будет
использовано.
Дополнительные сведения см. в разделе Преобразования и масштабирование.
Атрибут коэффициента преобразования (convers)

Атрибут convers применяет смещение или множитель к значению точки.
Для масштабируемых тегов атрибут convers содержит диапазон устройств.
Дополнительные сведения см. в разделе Преобразования и масштабирование.
Элемент OPC может иметь значения зоны нечувствительности, соответствующие
атрибутам zero и span, которые определяют действительный диапазон значений,
передаваемых сервером OPC. Интерфейс PI Interface для OPC DA может использовать эти
значения зоны нечувствительности OPC для преобразования единиц измерения,
используемых устройством, в единицы измерения, определенные для точки PI Point.
Дополнительные сведения см. в разделе Зона нечувствительности OPC (location5).
Атрибут индекса массива OPC (userint1)

Атрибут userint1 сопоставляет значение точки PI Point с элементом массива OPC.
Удостоверьтесь, что все точки PI Point, сопоставленные с массивом OPC, имеют
идентичные параметры для instrumenttag, exdesc и все атрибуты location.
Для точек PI Point, которые не сопоставлены с массивом OPC, присвойте параметру
userint1 значение 0 (нуль).

Элемент массива OPC содержит несколько значений плюс одну метку времени и поле
качества. Эти элементы могут быть идентифицированы с помощью средства PI OPC
Client для считывания элемента и проверки типа данных, возвращаемых сервером OPC.
Если это элемент массива, то тип значения — VT_ARRAY | VT_other, где VT_other — тип
данных, например VT_R4 или VT_I2. Значения в архиве передаются как один элемент
данных и имеют одинаковый тип данных.
PI Data Archive не поддерживает точки PI Point, имеющие тип массива, поэтому значения
будут назначены множеству отдельных точек PI Point. Первое значение в массиве
соответствует точке PI Point, у которой параметру userint1 назначено значение 1,
второе — точке с параметром userint1 со значением 2 и т. д.
Если эти значения нужно обрабатывать как различные типы данных, используйте
атрибут location2 для точки PI Point с userint1=1 и параметры для масштабирования
и преобразования для каждой отдельной точки, чтобы задать способ обработки
отдельных значений интерфейсом PI Interface для OPC DA.
Интерфейс PI Interface для OPC DA получает данные с типом данных, который задается
значением location2 для точки с userint1=1, а затем обрабатывает значение в
соответствии с особенностями настройки отдельной точки. Обратите внимание, что
некоторые серверы не могут предоставлять данные массива с использованием любого
типа данных кроме канонического, или собственного, типа данных (отображаемого в
средстве PI OPC Client, если опустить тип данных). Для этих серверов необходимо
использовать точку PI Point с верным типом данных, или назначить location2
значение 8, чтобы настроить интерфейс для запроса канонического типа данных. Для
повышения эффективности всего запрашивайте канонический тип данных.
Атрибут группы событий (userint2)

Атрибут userint2 назначает группу событий для точки event. Для точек, не
являющихся точками событий, установите для userint2 значение 0.
Дополнительные сведения см. в разделе Точки event.
Scan (Сканирование)
По умолчанию атрибут Scan имеет значение 1, что означает, что сканирование для
точки включено. Установка атрибута Scan в значение 0 отключает сканирование. Если
атрибут Scan равен 0 во время запуска интерфейса, то в журнал записывается
сообщение, а точка не загружается интерфейсом. Существует одно исключение из
предыдущего утверждения.
При удалении любой точки PI Point во время работы интерфейса (включая установку
для атрибута Scan значения 0) в эту точку записывается SCAN OFF независимо от
значения атрибута Scan. Два примера действий, которые удаляют точку PI Point из
интерфейса, — это изменение источника точки и установка атрибуту Scan значения 0.
Если изменение характерного для интерфейса атрибута вызывает отклонение точки
интерфейсом, в точку PI Point записывается SCAN OFF.
Завершение работы
Атрибут Shutdown имеет значение 1 (true) по умолчанию. По умолчанию подсистема PI
Shutdown Subsystem записывает цифровое состояние SHUTDOWN во все точки PI Point
при запуске PI System. Метка времени, используемая для событий SHUTDOWN,
извлекается из файла, обновляемого Snapshot Subsystem. Как правило, метка времени
обновляется через каждые 15 минут, то есть метка времени для событий SHUTDOWN

будет точна в течение 15 минут в случае сбоя питания. Дополнительные сведения о

событиях завершения работы см. в руководствах по PI Data Archive.
Прим.:
События SHUTDOWN, записанные подсистемой PI Shutdown Subsystem, не зависят от
событий SHUTDOWN, записываемых интерфейсом, когда указан параметр командной
строки /stopstat=Shutdown .
Чтобы настроить PI Shutdown Subsystem для записи событий SHUTDOWN только для тех
точек PI Point, у которых атрибут shutdown имеет значение 1, внесите изменения в файл
\PI\dat\Shutdown.dat, как описано в PI Server System Management Guide.
Можно отключить запись событий SHUTDOWN в точки PI Point при перезапуске архива
PI Data Archive, назначив атрибуту Shutdown значение 0 для каждой точки. В качестве
альтернативы поведение подсистемы PI Shutdown Subsystem можно изменить таким
образом, чтобы события SHUTDOWN записывались только для тех точек PI Point, у
которых атрибут Shutdown имеет значение 0. Чтобы изменить поведение по умолчанию,
внесите изменения в файл Shutdown.dat, как описано в руководствах по PI Data Archive.
Bufserv и PIBufss
Нежелательно записывать события завершения работы, когда используется
буферизация. Bufserv и PIBufss — служебные программы, позволяющие сохранять и
перенаправлять события в архив PI Data Archive, обеспечивая непрерывный сбор
данных, когда PI Data Archive отключается для обслуживания, обновления, резервного
копирования или в случае непредвиденных сбоев. Это означает, что, когда PI Data
Archive выключен, Bufserv или PIBufss будут продолжать собирать данные для
интерфейса. Поэтому нежелательно записывать события SHUTDOWN в точки PI Point
для этого интерфейса. Рекомендуется отключить Shutdown при отправке данных в
Highly Available PI Data Archive collective. Дополнительные сведения см. в руководствах
по Bufserv и PIBufss.
Атрибуты фильтрационного теста «исключение»

Чтобы минимизировать объем данных, сохраняемых и передаваемых по сети, можно с
помощью фильтрационного теста «исключение» отфильтровать те изменения
значений, которые не важны. Фильтрация осуществляется на узле интерфейса до того,
как данные будут отправлены в PI Data Archive.
• Максимальный интервал фильтрационного теста «исключение» (excmax)

Этот атрибут задает максимальные разрешенный период времени между отправкой
значений в PI Data Archive.
Эта настройка применяется как к тегам polled, так и к тегам advise. Для тегов advise,
если интерфейс PI Interface для OPC DA не получает значения через указанное число
секунд и не выявляет разрыва связи, то он отправляет последнее полученное
значение в PI Data Archive с меткой времени, значение которой равно последней
метке времени плюс время excmax. Для тегов polled интерфейс отправляет значение
в PI Data Archive, если не отправлял такового в течение последних excmax секунд,
даже если новое значение не проходит тесты excdev.
• Минимальный интервал фильтрационного теста «исключение» (excmin)

Этот атрибут настраивает минимальный период времени между отправкой значений
в PI Data Archive.

• Отклонение исключения (excdev)
Этот атрибут настраивает минимальное изменение последнего значения,
отправленного в PI Data Archive, необходимое для отправки нового значения
интерфейсом PI Interface для OPC DA.
Чтобы отключить фильтрационный тест «исключение», установите для всех трех
атрибутов значения 0. Дополнительные сведения о фильтрационном тесте
«исключение» см. в разделе PI Universal Interface (UniInt) User Guide.
Настройки классов scan class и частоты обновления

Классы scan class указывают, как часто источник данных проверяется на наличие новых
данных. Параметр f в файле .bat определяет один или несколько scan class.
Синтаксис: /f=scan-interval
Укажите интервал сканирования и дополнительное смещение, используя следующий
формат: time value,time offset,L
Для значений времени scan class и времени смещения используется следующий формат:
HH:MM:SS.##, где:
• HH — часы
• MM — минуты
• SS — секунды
• ## — сотые доли секунды (от 01 до 99)
Если опустить HH и MM, то предполагается, что период сканирования указан в секундах.
Например, /f=00:01:00,00:00:05 равнозначно /f=60,5.
Значение L ассоциирует значение единицы времени с настройками времени дня
локального компьютера. При сканировании значений времени дня используется 24-
часовой формат, и они автоматически корректируются по летнему времени. Это также
называется планированием по настенным часам. В следующем примере используется
частота сканирования 24 часа (один раз в сутки), смещение на восемь часов после
полуночи (8 AM), а также включается сканирование времени дня путем указания
значения L: /f=24:00:00,08:00:00,L
Частота scan class определяет, как часто будет выполняться сканирование на наличие
данных. Смещение указывает, как долго после значения времени частоты будет
выполняться сканирование наличия данных. Для балансирования рабочей нагрузки
сканирования укажите смещение для классов scan class с одинаковым интервалом,
чтобы они не сканировались одновременно.
Для каждого определяемого scan class укажите параметр f. Классы scan class
нумеруются в порядке, в котором вы их определяете. Scan class 1 — первый
определяемый параметр f, а scan class 2 — второй параметр f, который вы определяете.
Примеры:
• Scan class 1 имеет частоту сканирования в одну минуту со смещением на пять секунд,
а scan class 2 — частоту сканирования в семь секунд без смещения:
/f=00:01:00,00:00:05 /f=00:00:07
• Два scan class, определенные только в секундах:
/f=60,5 /f=7
• Субсекундные scan class, определенные как десятичные значения:
/f=0.5 /f=00:00:00.1

Прим.:
Удаление классов scan class или изменение их порядка может неблагоприятно
повлиять на работу существующих точек PI Point, которые тесно связаны с
частотами сканирования. Классы scan class должны корректироваться только
администраторами PI System, которые полностью понимают, как настраивать PI
System и сознают последствия таких изменений.
Дополнительные сведения о scan class см. в разделе PI Interface Configuration Utility (PI
ICU) User Guide.
Смещения при сканировании

Для уменьшения рабочей нагрузки на интерфейс и сервер OPC можно указать смещение
для поэтапной организации сканирования. Если указано смещение, то время
сканирования рассчитывается от полуночи тех суток, когда был запущен интерфейс, с
использованием любого указанного смещения. В первом scan class из приведенного
выше примера, если интерфейс был запущен в 05:06:06, то первое сканирование
произойдет в 05:07:05, второе в 05:08:05 и так далее. Если смещение опущено, то
сканирование выполняется с указанным интервалом независимо от времени на часах.
Смещения определяют, когда интерфейс запрашивает у сервера OPC текущие значения
для классов polled. Они не регулируют поведение сервера OPC и не оказывают влияния
на классы advise, если только не указан параметр ga для ступенчатой активации групп.
В данном случае смещения используются для распределения по времени активации
всех групп, за исключением scan class 1, зарезервированного для тегов advise.
Частоты обновления
Сервер OPC считывает данные с устройства в соответствии с частотой обновления для
группы, в которой располагается элемент. По умолчанию частота обновления совпадает
с частотой сканирования.
Чтобы переопределить настройку по умолчанию с помощью PI ICU, перейдите к
странице OPCInt > OPC Server > Advanced Options и введите значение частоты
обновления в качестве параметра ur в области Update Rates.
Для групп polled настройка частоты обновления, которая короче периода сканирования,
обеспечивает получение интерфейсом текущих данных. Например, если период
сканирования равен пяти секундам, а частота обновления — двум секундам, то данные
при считывании оказываются не старше двух секунд. Но при этом обратите внимание,
что с повышением частоты сканирования увеличивается рабочая нагрузка на сервер
OPC.
Для групп advise следует назначать идентичные частоты обновления и сканирования за
исключением случаев, когда для интерфейса настроена отработка отказа UniInt фазы 1.
В этом случае, чтобы обеспечить как можно более скорую доступность для интерфейса
новых значений тегов пульса отказоустойчивости (Heartbeat tag), установите частоту
обновления, равную половине периода сканирования. Такая конфигурация снижает
риск ненужного переключения управления туда и обратно. Выделите scan class с
высокой частотой обновления для точек пульса отказоустойчивости (Heartbeat tag).
Прим.:
Рекомендуется использовать отработку отказа UniInt фазы 2. Дополнительные
сведения о преобразовании отработки отказа UniInt из фазы 1 в фазу 2 см. в
разделе PI Universal Interface (UniInt) User Guide.

Входные точки для интерфейса PI Interface для OPC DA

Интерфейс PI Interface для OPC DA использует следующие три типа входных точек для
сбора данных из источников данных OPC DA.
• Точки advise
Входные данные собираются и сохраняются в точках PI Point, когда сервер OPC
обновляет значения элементов в кэше сервера, на основе scan class, настроенного для
точки PI Point. Интерфейс обновляет точки PI Point, получив извещение о том, что
значение изменилось.
• Точки event
Входные данные сохраняются в точках PI Point, когда интерфейс извещен об
обновлении точки триггера. Интерфейс считывает точки событий, которые могут
быть связаны с группой событий, из сервера OPC.
• Точки polled
Входные данные собираются и сохраняются в точках PI Point на основе scan class,
настроенного для точки PI Point, и частоты обновления сервера OPC. Интерфейс
опрашивает сервер OPC через регулярные интервалы времени.
Все три типа точек принимаются интерфейсом асинхронно.
Точки advise
Точки advise отправляются в интерфейс PI Interface для OPC DA сервером OPC только
при считывании нового значения в кэш сервера OPC.
Scan class 1 зарезервирован для точек advise, и вы можете создавать дополнительные
классы scan class для точек advise по мере необходимости. Убедитесь, что частота scan
class достаточно велика для получения всех изменений из источника данных.
По умолчанию максимальное число точек PI Point в scan class 1 — 800. До 800 точек с
одинаковой зоной нечувствительности может находиться в одной группе. Если
существует более 800 точек с одинаковой зоной нечувствительности в scan class 1, то
интерфейс создает столько групп, сколько требуется. В целях оптимизации
производительности убедитесь, что размер групп не превышает 800 элементов.
Прим.:
Производительность вашего сервера может быть выше при малых размерах групп;
для некоторых серверов OPC оказался эффективным предел в 200 точек на группу.
Чтобы изменить выбираемый по умолчанию предел для точек PI Point на основе
рекомендаций в scan class, с помощью PI ICU задайте значение Number of Tags в поле
advise group на странице OPCInt > Data Handling.
Чтобы создать точки advise, настройте следующие атрибуты PI Point.
• location3
Установите значение 1 для точек advise.
• location4
Назначает scan class для точки.
Прим.:
Не назначайте один и тот же scan class точкам advise и polled. Используйте
отдельный класс для каждого типа точек.

Точки event
Точки event считываются интерфейсом PI OPC при получении уведомления о том, что с
точкой триггера произошло новое событие. Точки событий PI Point настраиваются с
помощью точки триггера PI Point. Когда точка триггера получает значение, считывается
точка event.
Частые операции чтения с устройства могут снизить производительность сервера OPC.
По умолчанию у сервера запрашивается обновление его кэша каждую секунду для
каждой заданной точки event. Можно установить другую частоту обновления операций
чтения в зависимости от версии сервера OPC.
• Серверы OPC версии 2.0 всегда считывают точки событий с устройства, а не из кэша.
Чтобы уменьшить нагрузку на системные ресурсы от обновлений кэша на сервере
OPC, задайте для параметра частоты событий (er) высокое значение, например
восемь часов.
• Для серверов OPC версии 1.0 асинхронные операции чтения поступают из кэша.
Интервал внутреннего обновления кэша должен быть достаточно малым, чтобы
предотвратить устаревание данных в кэше.
При любом асинхронном чтении от сервера OPC требуется вернуть все значения вместе,
что может задержать возврат новых значений в PI Data Archive, если сервер OPC
обнаружит задержку при чтении значений. Чтобы улучшить производительность в этом
случае, группируйте точки в соответствии с устройством, с которого происходят
данные.
Чтобы создать точки event, настройте следующие атрибуты PI Point.
• location3
Задайте значение 2 для точек event.
• location4
Назначает scan class для точки. Задайте значение 0 для точек event.
• userint2
Для каждой группы событий OPC задайте для этого атрибута одно и то же целое
число для каждой точки PI Point в группе. Назначение точек PI Point группам событий
OPC обеспечивает считывание точек вместе.
Например, подключаемый модуль DLL, выполняющий постобработку данных, может
требовать отправки данных в одной группе.
• exdesc
Для каждой группы событий OPC задайте атрибут exdesc одинаковым именем точки
триггера. Используйте синтаксис TRIG='trigger_point_name’ event_condition.
Используйте одинарные кавычки. Чтобы интерпретировать все изменения как
события триггера, опустите event_condition.
Список описаний событий см. в следующей таблице:

Условие события Описание

Anychange Срабатывание при любом изменении, пока
значение текущего события отличается от
значения предыдущего события. Цифровые
состояния системы также запускают события.
Например, событие сработает при изменении
значения с 0 на «Bad Input», равно как и при
изменении значения с «Bad Input» на 0.
Increment Срабатывание при любом увеличении
значения. Цифровые состояния системы не
запускают события. Например, событие
сработает при изменении значения с 0 на 1,
но при изменении значения с «Pt Created» на
0 событие не сработает. Аналогично, событие
не сработает при изменении значения с 0 на
«Bad Input».
Decrement Срабатывание при любом уменьшении
значения. Цифровые состояния системы не
запускают события. Например, событие
сработает при изменении значения с 1 на 0,
но при изменении значения с «Pt Created» на
0 событие не сработает. Аналогично, событие
не сработает при изменении значения с 0 на
«Bad Input».
Nonzero Срабатывание при любом ненулевом
значении. События не срабатывают при
записи цифрового состояния системы в тег
триггера. Например, событие срабатывает
при изменении значения с «Pt Created» на 1,
однако не сработает при изменении значения
с 1 на «Bad Input».
Точка PI Point, которая инициирует чтение, является входной точкой, отдельной от

точек событий. При отправке нового события для точки триггера в PI Snapshot
система PI System уведомляет интерфейс, который затем считывает значения для
всех связанных точек event с сервера OPC.
Для серверов версии 1.0a асинхронная операция чтения отправляется в кэш сервера.
Для серверов версии 2.0 интерфейс выполняет асинхронное чтение с устройства.
Дополнительные сведения о настройке входных триггерных точек см. в разделе PI
Universal Interface (UniInt) User Guide.
В целях эффективности для серверов версии 1.0a следует разделить точки event по
группам в зависимости от триггерного события. Для серверов OPC версии 2.0 точки
событий следует разделять в соответствии с источником данных. Стандарт OPC 2.0
требует, чтобы все асинхронные операции чтения происходили с устройства, а не из
кэша сервера, поэтому задайте высокую частоту обновления кэша и не группируйте
значения, поступающие с разных устройств.
В следующей таблице показаны точки PI Point, настроенные для отдельных точек
событий.

Tag ExDesc Instrum Location Location Location Location Location UserInt1 UserInt2
entTag 1 2 3 4 5
(Распол (Распол
ожение ожение
1) 4)
PM1_Te TRIG=P ItemID1 1 0 0 0 0 0 1
mp.PV M1_Trig
ger
PM1_Rat TRIG=P ItemID2 1 0 0 0 0 0 1
e.PV M1_Trig
ger
PM2_Te TRIG=P ItemID3 1 0 0 0 0 0 2
mp.PV M2_Trig
ger
В предыдущем примере точки PM1_Trigger и PM2_Trigger обновляются данным

экземпляром интерфейса, другим интерфейсом или путем ручного ввода. Когда
PM1_Trigger получает новое событие в снэпшоте, интерфейс отправляет серверу OPC
команду read, которая запрашивает данные как для PM1_Temp.PV, так и для
PM1_Rate.PV. Оба значения возвращаются в ходе одного вызова. Аналогично, когда
PM2_Trigger получает событие в снэпшоте, интерфейс запрашивает значение для
PM2_Temp.PV.
Точки polled
Точки polled PI Point группируются по атрибуту scan class. По возможности интерфейс
считывает группы с использованием частоты сканирования scan class, настроенной для
точки. Частоты сканирования scan class настраиваются с помощью PI ICU.
Прим.:
Сервер OPC не гарантирует соответствие частот сканирования между сервером
OPC и интерфейсом. Интерфейс PI Interface для OPC DA отправляет на сервер OPC
запрос на использование частоты обновления, соответствующей scan class, но
сервер OPC определяет собственную частоту обновления для сканирования своих
источников данных. Смещение scan class не оказывает влияния на сервер OPC, если
только интерфейс не настроен для ступенчатой групповой активации, а сервер
OPC использует активацию группы для инициирования цикла сканирования.
Дополнительные сведения о точках polled см. в документе OPC Foundation Data Access
Custom Interface Standard v2.05a.
Чтобы создать точки polled, настройте следующие атрибуты PI Point.
• location3
Установите значение 0 для точек polled.
• location4
Назначает scan class для точки.
Прим.:
Не назначайте один и тот же scan class точкам advise и polled. Используйте
отдельный класс для каждого типа точек.

Конфигурации точки output

Точки output отправляют данные от PI Data Archive серверу OPC. Обратите внимание,
что можно отправлять только значения хорошего качества. Системные цифровые
состояния элементам OPC не отправляются.
Чтобы настроить точку output, измените точку с помощью PI Point Builder, задав
следующие настройки.
• Присвойте location1 значение параметра id экземпляра интерфейса.
• Задайте для location3 значение 2.
• Укажите ItemID (записываемый элемент OPC) для атрибута instrumenttag.
• Необязательно. Укажите исходную точку (точка PI Point, которая содержит значение,
записываемое в сервер OPC) в атрибуте sourcetag. Не требуется, если значение
планируется отправлять непосредственно в элемент вывода без копирования
значений и меток времени в точку PI Point.
• Необязательно. Назначьте location4 нужной группе output. Точки output с
location4, установленным в значение 0, распределены по группам output для
балансировки нагрузки.
Можно запустить вывод на сервер OPC из интерфейса с использованием input точки, где
хранятся данные сервера OPC, или из отдельной точки PI Point, настроенной для сбора
выходных значений и метки времени для записи. Чтобы настроить точки output,
используйте один из следующих методов.
• Чтобы одна и та же точку PI Point использовалась как точка источника и точка output,
оставьте атрибут sourcetag пустым.
Допустимы любые средства обновления значения снэпшота для точки output. Любое
новое значение отправляется в элемент OPC.
Чтобы начался вывод в целевой элемент OPC, метка времени должна быть более
новой, чем предшествующая, независимо от изменения значений. Значение,
введенное в снэпшот точки output, записывается в целевой элемент на сервере OPC.
• Чтобы настроить точку output с использованием отдельной исходной точки, укажите
в атрибуте sourcetag имя другой точки PI Point, которая будет содержать значения,
которые нужно записать в элемент OPC.
Когда исходная точка успешно обновлена, новое значение записывается в целевой
элемент OPC. Если интерфейс PI OPC успешно обновляет элемент OPC, то значение и
метка времени записываются в точку output. Если обновление элемента OPC
завершилось неуспешно, то интерфейс записывает цифровое состояние, которое
описывает ошибку для точки output. Для точек output состояние success указывает,
что элемент сервера OPC был обновлен, но нет гарантии, что обновлен
соответствующий источник данных. Чтобы удостовериться, что источник данных
обновлен, создайте соответствующую входную точку и добавьте логику для
проверки, что значения входных точек и точек выхода совпадают.
Атрибут pointsource точки выхода должен соответствовать значению точки
источника (ps) экземпляра интерфейса, но исходная точка может быть связана с
любой точкой источника. Тип данных исходной точки и точки выхода должны быть
совместимы.

Настройка файла белого списка

Для повышения уровня безопасности можно создать белый список выходных точек и
включить параметр запуска whitelist для интерфейса. Когда эта функция включена,
интерфейс проверяет наличие выходной точки в белом списке, прежде чем выполнять
запись в источник данных OPC.
Файл белого списка представляет собой файл со значениями, разделенными запятой
(.csv), в котором содержится список утвержденных выходных точек PI Point и
атрибутов, которые связывают точку PI Point с доступным для записи значением в
устройстве OPC.
Для этого интерфейса можно включить следующие обязательные атрибуты в файл
белого списка, чтобы обеспечить защиту выходных точек.
• tag
• instrumenttag
• location3
• userint1
Белый список также поддерживает проверку диапазона выходных значений. Включите
атрибуты zero и span, чтобы указать защищенный диапазон значений для отправки в
источник данных OPC. Эти атрибуты задают минимальное (zero) и максимальное
(сумма zero и span) разрешенные выходные значения.
Дополнительные сведения о создании, настройке и включении файла белого списка
выходных точек см. в разделе PI Universal Interface (UniInt) User Guide.
Выходные данные, передаваемые интерфейсом в серверы OPC

Когда интерфейс записывает значение в сервер OPC, интерфейс ожидает
подтверждения (ACK) от сервера и контролирует подтверждения операций записи.
Чтобы ускорить обработку выходных данных, можно управлять обработкой выходных
данных следующими способами.
• Настроить несколько групп output.
• Указать число ожидающих завершения необработанных операций записи,
разрешенных для группы.
• Указать объем данных, отправляемых каждой операцией записи.
Чтобы назначить точку output группе output, укажите в атрибуте location4 номер
группы. Чтобы сбалансировать нагрузку, точки output с location4, установленным в
значение 0, распределяются по группам output, в том числе группам, которым выходные
точки назначаются явно.
От сервера OPC не требуется одновременно принимать более одной операции записи от
любой группы, но многие серверы допускают отправку нескольких операций записи, не
ожидая подтверждения первой операции записи.
Даже если сервер принимает только одну операцию записи за один раз, определение
нескольких групп output может улучшить пропускную способность. Если указать
больше ожидающих завершения необработанных операций записи, чем может принять
сервер OPC, то интерфейс PI Interface для OPC DA уменьшает соответствующий параметр
до максимального значения для сервера OPC.

Можно указать, как долго ожидать от сервера OPC подтверждения операции записи.
Если подтверждение не получено в течение указанного периода, то интерфейс отменяет
запись и повторяет операцию.
Если сервер OPC не подтверждает операций записи, то можно создать предупреждение с
использованием значения степени исправности статуса устройства. Настройте
предупреждение для обнаружения нужного числа находящихся в очереди операций
записи. При достижении заданного уровня предупреждение устанавливает состояние
тревоги и отбрасывает указанное число значений, самых старых или самых новых.
Совместимость типов данных

Тип данных точки PI Point должен быть совместим с типом данных соответствующего
элемента OPC. Например, если строковое значение с сервера OPC должно быть
помещено в точку PI Point типа Int32, то строка должна содержать число. Если 64-битное
значение с плавающей запятой должно быть помещено в точку типа Int16, то его
значение не должно приводить к переполнению целевого типа данных.
Интерфейс PI Interface для OPC DA указывает требуемый тип данных при запросе
информации с сервера OPC, а сервер OPC отвечает за доставку запрашиваемого типа
данных, если он может это сделать.
Обычно интерфейс PI Interface для OPC DA запрашивает значения с использованием
следующих типов данных по умолчанию:
Тип данных PI System (pointtype) Тип данных OPC
Цифровой Двухбайтовый целочисленный (VT_I2)
Int16 Двухбайтовый целочисленный (VT_I2)
Int32 Четырехбайтовый целочисленный (VT_I4)
Float32 Четырехбайтовый с плавающей запятой
(VT_R4)
Float64 Восьмибайтовый с плавающей запятой (VT_R8)
String Строковый (VT_BSTR)
Если ваш сервер OPC не разрешает клиентам указывать тип данных, установите для
location2 значение 8 для всех точек PI Point на основе OPC, чтобы настроить
интерфейс на запрос канонического или собственного типа данных с сервера OPC.
Прим.:
Интерфейс PI Interface для OPC DA может получать данные, для которых
невозможно никакое осмысленное преобразование. По возможности всегда
следует указывать тип данных OPC, который соответствует точке PI Point.
Числовые строки OPC

Некоторые серверы OPC возвращают определенные числовые типы данных только в
виде строк. Чтобы интерпретировать форматированные в виде строк значения Int16,
Int32, Float32 и Float64, задайте для location2 значение 1. Интерфейс PI Interface для
OPC DA запрашивает данные в виде строки (VT_BSTR) и интерпретирует их как число.
Цифровые (digital) точки PI Point содержат целочисленные значения, соответствующие
определенным строкам в таблице цифровых состояний в свойстве цифрового набора
точки. Некоторые устройства считывают и записывают строковое значение вместо
целочисленного. Для чтения и записи цифровых (digital) точек в виде строковых
значений установите для location2 значение 1. Убедитесь, что строки, используемые
сервером OPC, идентичны строкам в цифровом наборе, включая пунктуацию и пробелы.

В целях оптимальной производительности по возможности следует считывать

цифровые (digital) точки в виде чисел.
Логические значения (Boolean)

Некоторые серверы OPC отправляют логические значения (Boolean) в виде 0 и -1 при
считывании в виде целых чисел. Такой подход создает проблему при считывании этих
данных в цифровую точку PI Point, так как "-1" не является значением, которое должно
быть сохранено. Для обработки данных с таких серверов интерфейс использует
абсолютное значение любых целочисленных или действительных значений, считанных
для цифровых (digital) точек. Так как значения цифровых (digital) точек фактически
представляют собой смещения в цифровом наборе для точки, а отрицательное
смещение не имеет функционального значения, эта проблема не вызывает неполадок
для правильно написанных серверов.
Интерфейс PI Interface для OPC DA также может запрашивать элемент в виде
логического значения (VT_BOOL). Этот подход работает только для элементов, у
которых есть два возможных состояния, поскольку любое ненулевое значение
интерпретируется как 1. Чтобы считывать и записывать элементы как логические
значения (Boolean), задайте для location2 значение 2.
Четырехбайтовые целочисленные значения

Если ваш сервер OPC не поддерживает двухбайтовый целочисленный (VT_I2) тип
данных, можно настроить интерфейс PI Interface для OPC DA на запрос данных в виде
четырехбайтового целочисленного значения (VT_I4), установив для location2
значение 3.
Значения Float64
Для обработки восьмибайтовых чисел с плавающей запятой (VT_R8) установите для
location2 целевой точки значение 5. PI Data Archive сохраняет значение в виде
четырехбайтового числа с плавающей запятой, с возможной потерей точности. Если
число слишком велико для размещения в точке, сохраняется статус BAD INPUT.
• Корректировка меток времени
• Преобразования и масштабирование
• Информация о качестве данных
• Считывание данных о качестве OPC в цифровую точку PI Point
• Точки PI Point элемента массива OPC
• Массивы OPC как точки событий
Корректировка меток времени

Интерфейс PI Interface для OPC DA не корректирует получаемые метки времени,
независимо от настройки часового пояса или параметра ts, указанного в пакетном (bat)
файле. Любые операции масштабирования и трансформации выполняются после того,
как строка преобразована в секунды, что позволяет обрабатывать широкий диапазон
значений.
Существует два типа меток времени.
• Метка времени типа Windows

Метки времени этого типа сопровождают значения элементов и определяются как
время в формате UTC.

• VT_DATE или другой тип variant (VT_*)

Это тип значения элемента, который может представлять дату, время или сочетание
этих двух значений. Элемент, содержащий значение VT_DATE, интерпретируется как
местное время без учета перехода на летнее время. Значения элементов, содержащих
представление VT_BSTR (строка) даты или времени, не имеют указаний для
предполагаемых часовых поясов; сервер OPC может выбирать между локальным
временем и всемирным координированным временем (UTC).
Метка времени в секундах

Чтобы сохранить строку метки времени (VT_BSTR) в секундах, присвойте location2
значение 6.
Если точка PI Point является целочисленным значением, то интерфейс PI Interface для
OPC DA пытается перевести метку времени в целые секунды. Точки Int16 могут
содержать только числа до 32767, поэтому используйте точки Int32 для интервалов
времени, превышающих девять часов.
Если точка PI Point имеет тип данных с плавающей запятой, то метка времени
преобразуется в секунды и хранится как число с плавающей запятой.
Метки времени как типы данных VT_DATE

Стандартом OPC допускается тип данных VT_DATE, который представляет собой
внутреннее представление метки времени. Интерфейс PI Interface для OPC DA
преобразуется между VT_DATE и целочисленными (integer) точками, точками с
плавающей запятой и строковыми точками. Интерфейс не корректирует полученные
метки времени, независимо от настроек часового пояса.
Чтобы настроить интерфейс PI Interface для OPC DA, чтобы использовался тип данных
VT_DATE для считывания значения с сервера OPC или для записи значения в точки
output, присвойте location2 значение 7.
Для строковых точек формат меток времени строки должен быть указан с
использованием параметра командной строки tf.
Строки меток времени

Чтобы настроить формат меток времени, отправленных сервером OPC, в программе PI
ICU перейдите на страницу OPCInt > Data Handling и укажите формат в поле Format of
Timestamp Strings с использованием следующих маркеров.
Маркер метки времени Описание
cc Значение для столетия из двух цифр
yy Значение для года из двух цифр
mn Значение для месяца из двух цифр
mon Значение для месяца из трех символов (Jan Feb
Mar и т. д.)
dd Значение для дня из двух цифр
hh Значение для часа из двух цифр от 0 до 23
hr Значение для часа из двух цифр от 0 до 12
mm Значение для минуты из двух цифр
ss Значение для секунды из двух цифр
000 Значение для миллисекунд из трех цифр
XM AM или PM

Положение маркеров и разделителей должно точно указывать формат строки метки

времени. Примеры:
Строка формата Результат
ccyy/mn/dd hh:mm:ss.000 1998/11/29 15:32:19.391
dd mon, ccyy hr:mm:ss XM 29 Nov, 1998 03:32:19 PM
mn-dd-ccyy hh:mm:ss 11-29-1998 15:32:19
hh:mm:ss.000 15:32:19.482
Для каждого экземпляра PI Interface для OPC DA может быть указана только одна строка
формата. Если нужно обработать более одного формата метки времени, настройте
дополнительные экземпляры интерфейса с нужной строкой формата метки времени.
Если опустить элементы строк формата, то значения по умолчанию следующие
(текущие значения — в формате UTC).
Опущенный элемент строки формата По умолчанию
День Текущий день
Месяц Текущий месяц
Год Текущий год
Столетие Текущее столетие
Прим.:
Если указаны только часы, минуты и секунды, то по умолчанию принимается дата
1 января 1970 г. Чтобы получить точные метки времени, обязательно указывайте
все элементы формата метки времени. Если сервер OPC возвращает нулевое
значение для элемента дня, месяца или года, то интерфейс применяет значения по
умолчанию, описанные выше, независимо от указанной строки формата.
Преобразования и масштабирование
Точки PI Point можно настроить таким образом, чтобы интерфейс PI Interface для OPC DA
выполнял преобразования и масштабирование. Преобразование и масштабирование
применяются перед сравнением значения с параметрами исключения для точки, чтобы
параметры исключения применялись к значению, отправляемому в PI Data Archive, а не
к необработанному значению.
Масштабирование
Чтобы настроить масштабирование для основанной на OPC точки PI Point, задайте
атрибуты totalcode и squareroot этой точки. Атрибут convers указывает диапазон
устройства, а exdesc — нуль устройства (Dzero). Используя эти значения, интерфейс
может транслировать значение из масштаба устройства в масштаб точки PI Point.
Масштабирование поддерживается только для числовых точек.
Для простого квадратичного/квадратно-корневого масштабирования установите
totalcode и convers равными нулю. Чтобы настроить способ сохранения значения,
задайте squareroot следующим образом.
• Чтобы возводить значение в квадрат перед отправкой в PI Data Archive, установите

squareroot в значение 1. Для выходных значений вычисляется квадратный корень
перед записью на устройство.
• Чтобы квадратный корень отправлялся в архив PI Data Archive, а квадрат — на
устройство, установите squareroot в значение 2.

Преобразование
Чтобы преобразовать значение в другой масштаб измерения, применить смещение или
коэффициент преобразования либо выполнить побитовое маскирование, настройте
параметры так, как показано в следующей таблице. Если squareroot установлен в
значение 1 или 2, то сначала вычисляется квадратный корень или квадрат значения, а
затем применяется формула.
Conver TotalCo SquareRo Dzero Входные точки операции Выходные точки операции
s de ot
0 0 1 Нет (Значение)2 (Значение)0,5
влиян
ия
2 Нет (Значение)0,5 (Значение)2
влиян
ия

Conver TotalCo SquareRo Dzero Входные точки операции Выходные точки операции
s de ot
Ненул 1 0 Опреде [ (Значение – Dzero) / [ (Значение – Zero) / Span] *
евое лено Convers ] * Span + Zero Convers + Dzero
1 Опреде [ ((Значение)2 – Dzero) / [ ((Значение)0,5 – Zero) / Span]
лено Convers ] * Span + Zero * Convers + Dzero
2 Опреде [ ((Значение)0,5 – Dzero) / [ ((Значение)2 – Zero) / Span] *
лено Convers ] * Span + Zero Convers + Dzero
2 0 Нет Значение * Convers Значение / Convers
влиян
ия
1 Нет (Значение)2 * Convers (Значение)0,5 / Convers
влиян
ия
2 Нет (Значение)0,5 * Convers (Значение)2 / Convers
влиян
ия
3 0 Опреде (Значение / Convers) – (Значение + Dzero) * Convers
лено Dzero
1 Опреде ((Значение)2 / Convers) – ((Значение)0,5 + Dzero) *
лено Dzero Convers
2 Опреде ((Значение)0,5 / Convers) – ((Значение)2 + Dzero) *
лено Dzero Convers
4 0 Опреде (Значение – Dzero) / (Значение * Convers) + Dzero
лено Convers
1 Опреде ((Значение)2 – Dzero) / ((Значение)0,5 * Convers) +
лено Convers Dzero
2 Опреде ((Значение)0,5 – Dzero) / ((Значение)2 * Convers) +
лено Convers Dzero
5 0 Нет Значение + Convers Значение – Convers
влиян
ия
1 Нет (Значение)2 + Convers (Значение)0,5 – Convers
влиян
ия
2 Нет (Значение)0,5 + Convers (Значение)2 – Convers
влиян
ия
6 Нет Нет Значение AND Convers Значение AND Convers
влияния влиян
ия
7 Нет Нет Значение OR Convers Значение OR Convers
влияния влиян
ия
8 Нет Нет Значение = Значение XOR Значение = Значение XOR
влияния влиян Convers Convers
ия

Информация о качестве данных

Стандарт OPC Data Access определяет набор флагов качества. Интерфейс PI Interface для
OPC DA обеспечивает максимальное приближение флагов качества к набору системных
цифровых состояний по умолчанию. Младшие восемь разрядов флагов качества
разбиты на три поля — качества (QQ), вложенного состояния (SSSS) и ограниченного
состояния (LL), которые упорядочены следующим образом: QQSSSSLL.
Обработка данных сомнительного качества

Интерфейс PI Interface для OPC DA хранит качество или значение в точке PI Point, тогда
как сервер OPC возвращает значение и качество в отдельных полях. Если значение
имеет хорошее качество, то оно сохраняется в точке. Если значение имеет плохое
качество, то сохраняется цифровое состояние, описывающее качество. Для данных
сомнительного качества можно настроить интерфейс так, чтобы значения
обрабатывались как хорошие и сохранялись, либо рассматривались как плохие и
сохранялось цифровое состояние. Нельзя настроить интерфейс для сохранения
значения плохого качества.
Чтобы настроить обработку данных сомнительного качества с помощью программы PI
ICU, перейдите на страницу OPCInt > OPC Server и включите нужный параметр, как
показано на следующей иллюстрации.
Сохранение как значений, так и информации о качестве

Чтобы записывались как сообщаемые значения, так и возвращаемая вместе с ними
информация о качестве, сохраняйте качество в отдельной точке PI Point. Чтобы
настроить точку на сохранение качества для связанного ItemID, установите location2 в
значение 4. Качество OPC представлено 16-разрядными целочисленными значениями
без знака, поэтому интерфейсу PI Interface для OPC DA требуется тег Int32 для их
хранения. Показатели качества сохраняются в архиве PI Data Archive без изменений и
всегда имеют состояние GOOD. Чтобы получить дополнительные сведения о значениях
качества OPC, загрузите OPC Data Access specification из http://www.opcfoundation.org или
обратитесь к PI OPCClient User’s Guide.
Состояния качества
Качество данных состоит их трех вложенных полей. В следующих таблицах
перечислены возвращаемые значения.
Хорошее качество
Качество Определение OPC Состояние PI System
11SSSSLL Не указано Good
За исключением: Локальное переопределение _SUBStituted*
110110LL
* Эти значения будут отмечены как сомнительные, если для того, чтобы сомнительные
значения игнорировались, не используются следующие параметры.

• Если указано /SG=S, то «Локальное переопределение» рассматривается как хорошее

качество. Но при этом подавляются значения плохого и сомнительного качества.
• /SQ=I записывает сомнительные значения, но подавляет флаг сомнительных
значений, поэтому они отображаются в системе PI System так, как если бы они были
хорошими.
Не используется OPC
10SSSSLL Недопустимо Bad Input
Сомнительное качество
010110 LL Ненормально Bad_Quality
010101LL Превышены инженерные
показатели
LL=01 Нижнее ограничение Under LCL
LL=10 Верхнее ограничение Over UCL
Иначе Inp OutRange
010100LL Датчик не точен
LL=01 Нижнее ограничение Under Range
LL=10 Верхнее ограничение Over Range
Иначе Вне калибровки (если не Invalid Data
выходит за верхний или
нижний предел диапазона)
010011LL Недопустимо Bad Input
010010LL Недопустимо Bad Input
010001LL Последнее применимое No_Sample
значение
010000LL Не указано Doubtful
Плохое качество (PI System версии 3.3 или более поздней)

000111LL Нерабочий Out of Service
000110LL Отказ связи Comm Fail
000101LL Последнее известное значение Scan Timeout
000100LL Отказ датчика Equip Fail
000011LL Отказ устройства Unit Down
000010LL Не подключено Not Connect
000001LL Ошибка конфигурации Configure
000000LL Не указано Bad
Чтобы заменить цифровые состояния PI System по умолчанию особыми состояниями,

используемыми PI ICU, перейдите на страницу OPCInt > Data Handling и задайте
значение в поле Alternate Digital State for Questionable/Bad Qualities. Чтобы
переопределить состояния по умолчанию, необходимо указать полный набор замен, а
числовые значения должны быть непрерывными.

В следующей таблице перечислены цифровые состояния и состояния PI System, которые

можно переопределить.
Особые цифровые состояния
Состояние порядка после маркера Состояние PI System по умолчанию
1 Bad_Quality
2 Under LCL
3 Over UCL
4 Inp OutRange
5 Under Range
6 Over Range
7 Invalid Data
8. Bad Input
9. No_Sample
10. Doubtful
11. Out of Service
12. Comm Fail
13. Scan Timeout
14. Equip Fail
15. Unit Down
16. Not Connect
17. настройка
18 Bad
Считывание данных о качестве OPC в цифровую точку PI Point

Для хранения данных о качестве OPC в цифровой точке PI Point следует использовать
преобразования и масштабирование, чтобы преобразовать качество в набор цифровых
состояний Bad Value, Questionable Value, Invalid Value или Good Value.
Чтобы определить такую точку PI Point, установите location2 в значение 4, чтобы
считывалось качество элемента вместо его значения, а затем определите
математическое преобразование, которое преобразует значение качества в целое число
от 0 до 3. Разделите число качества на коэффициент преобразования, который выдает
нужное число.
Качество OPC возвращается в диапазонах значений, как описано ниже.
Диапазон Описание
Меньше 0x40 Неверное значение
Больше или равно 0x40 и меньше 0x80 Сомнительное значение
Больше или равно 0x80 и меньше 0xc0 Не используется OPC
Больше или равно 0xc0 Корректное значение
Так как у каждого диапазона одинаковый размер (decimal 64), можно с помощью
простого преобразования получить соответствующее цифровое состояние, как описано
ниже.

Convers TotalCode SquareRoot Dzero Операция

Не 0 3 0 Определе Входные точки:
но
Значение = (Значение / convers) – Dzero
Выходные точки:
Значение = (Значение + Dzero) * convers
Определите атрибуты точек следующим образом.

Атрибут Настройка
convers 64
totalcode 3
squareroot 0
exdesc "Dzero=0"
Точки PI Point элемента массива OPC

Серверы OPC могут содержать массивы данных, состоящие из множества значений
одного типа данных с одним качеством и меткой времени. Архив PI Data Archive не
поддерживает типы данных массива, поэтому необходимо настроить одну точку PI Point
для каждого элемента массива, который нужно сохранить, или использовать
подключаемый модуль TimeArray. Подробные сведения см. в руководстве пользователя
подключаемого модуля TimeArray.
Чтобы задать точку PI Point как содержащую элемент из массива OPC, укажите ItemID
элемента массива в атрибуте instrumenttag и присвойте userint1 номер индекса
элемента в массиве. Необходимо определить точку PI Point для первого элемента
массива (userint1 = 1), даже если его данные не нужны. Но не нужно определять точки
для всех элементов массива, задайте ее только для первого элемента массива и всех
элементов, которые представляют интерес.
Если тег массива из сервера OPC считан в несколько точек PI Point, то каждая точка PI
Point получит значение элемента массива, индексируемого по параметру userint1 с
одинаковыми меткой времени и качеством, так как массив содержит множество
значений, но вместе с тем всего одну метку времени и качество. Чтоб считать тег
массива OPC в одну точку PI Point, необходимо использовать подключаемый модуль
TimeArray, который сохраняет массив значений в одной точке PI Point в виде
последовательных значений данных, для каждого значения на заданный интервал
увеличивая метку времени, связанную с массивом. Подробные сведения см. в
руководстве по подключаемому модулю TimeArray.
Все точки PI Point, настроенные для массива OPC, должны иметь такие же параметры
для pointsource, location1 и location4 (и userint2, если это точки event). Для точек
advise установите location3 в значение 1. Для точек polled установите location3 в
значение 0.
При настройке точек PI Point для чтения массивов OPC обратите внимание на
следующие моменты.
• Необходимо определить точку, которая считывает первый элемент массива.

• Назначьте точки одному scan class.

• Чтобы оптимизировать загрузку ЦП, не используйте один scan class для считывания
более одного массива OPC.
• Если необходимо считать один и тот же элемент массива OPC более чем в одну точку,
то нужно назначить точки различным scan class.
Массивы OPC как точки событий

Несколько scan class могут иметь одинаковый период сканирования, а классы событий
представляют собой логические группы точек PI Point. Для повышения эффективности
помещайте массивы событий в их собственные scan class с любыми другими точками,
которые должны считываться вместе с массивами.
Настройка массивов, считываемых как теги событий, представляет собой непростую
задачу. Поскольку лишь первый элемент массива (с userint1 = 1) приводит к
считыванию, необходимо создать фиктивную точку PI Point триггера для
использования с остальными элементами массива. Эта точка PI Point должна иметь
pointsource, который не используется или используется для точек с ручным вводом
(данные в лабораториях обычно вводятся вручную, поэтому L часто используются как
pointsource для ввода точек PI Point вручную).
В следующем примере точка PI Point триггера называется TriggerTag, а фиктивная
точка PI Point триггера — DummyTrigger.
Tag ExDesc Instrum Location Location Location Location Location UserInt1 UserInt2
entTag 1 2 3 4 5
(Распол (Распол
ожение ожение
1) 4)
Array00 TRIG=Tr Data.Arr 1 0 0 0 0 1 1
01.PV iggerTag ay
Array00 TRIG=D Data.Arr 1 0 0 0 0 2 1
02.PV ummyTr ay
igger
Array00 TRIG=D Data.Arr 1 0 0 0 0 3 1
03.PV ummyTr ay
igger
Все теги в массиве должны принадлежать к одной группе, поэтому, даже если сервер
OPC имеет версию v2.0 и некоторая часть данных массива поступает с иного устройства,
нежели остальные данные массива, все теги массива должны быть настроены таким
образом, чтобы они находились в одной группе событий.
Конфигурация отказоустойчивости для интерфейса PI

Интерфейс PI Interface для OPC DA реализует два способа настройки
отказоустойчивости, которые позволяют обеспечить продолжение сбора данных в
случае отказа любого из интерфейсов или серверов OPC.
• Отработка отказа UniInt

В случае отказа одного экземпляра PI Interface для OPC DA другой экземпляр может
взять на себя сбор данных.

Прим.:
Отработка отказа UniInt является распространенной функцией в интерфейсах
на основе UniInt. Дополнительные сведения о настройке отработки отказа
UniInt см. в разделе PI Universal Interface (UniInt) User Guide.
• Отработка отказа на уровне сервера OPC

Если интерфейс PI Interface для OPC DA прекращает получение данных с текущего
подключенного сервера OPC, он может переключиться на другой сервер OPC и
возобновить сбор данных.
При производится настройка обоих типов отработки отказа, то их необходимо
настраивать в следующем порядке.
1. Настроить и проверить отработку отказа UniInt.
2. Отключить отработку отказа UniInt.
3. Настроить и проверить отработку отказа на уровне сервера OPC.
4. Повторно включить отработку отказа UniInt.
Использование отработки отказа кластера Windows больше не рекомендуется.
• Режимы отработки отказа UniInt интерфейса PI Interface для OPC DA
• Отработка отказа на уровне сервера OPC
Режимы отработки отказа UniInt интерфейса PI Interface для OPC DA

Режим отработки отказа указывает, каким образом резервный экземпляр PI Interface
для OPC DA выполняет подключение к серверу OPC, создает группы и добавляет точки
при отработке отказа.
Чем скорее резервный экземпляр интерфейса сможет начать сбор данных, тем меньше
данных будет потеряно. Однако сопутствующие действия, необходимые для того, чтобы
повысить готовность резервного экземпляра интерфейса, увеличивают нагрузку и
необходимые системные ресурсы сервера OPC. Выбор режима использования
определяется тем, как долго занимает отработка отказа и с какой рабочей нагрузкой
справится ваша система. Будьте готовы экспериментировать, а при необходимости —
обратиться к поставщику и документации по серверу OPC.
Интерфейс PI Interface для OPC DA обеспечивает пять уровней отработки отказа, от
холодной до горячей. Более высокие («горячие») уровни позволяют сохранить больше
данных в случае отработки отказа, но повышают рабочую нагрузку на систему. Самый
высокий уровень, горячая отработка отказа, выполняется без потерь данных, если
только одновременно не откажут основной и резервный узлы экземпляра интерфейса.
Горячая отработка отказа

Горячая отработка отказа — режим, в котором ресурсы расходуются наиболее
интенсивно. Как основной, так и резервный экземпляры интерфейса собирают данные,
возможно, с одного сервера OPC. Потери данных при отработке отказа не произойдет, но
сервер OPC будет нести двойную рабочую нагрузку, или, если используется два сервера,
внутренняя система должна поддерживать оба сервера OPC.
Теплая отработка отказа

Существует три варианта теплой отработки отказа.

• Нет групп на резервном экземпляре интерфейса (вариант 1)

Резервный экземпляр подключается к серверу OPC через каждые 30 секунд и
проверяет его состояние, но не создает групп и не добавляет элементов. Поскольку
интерфейс заранее загружает информацию о точках из архива PI Data Archive, в этом
режиме отработка отказа будет выполняться быстрее, чем в холодном, но когда
резервный экземпляр станет основным, ему придется создать группы, добавить в
них элементы, активировать, а затем рекомендовать их. Для этого потребуется
время, данные могут быть потеряны во время отработки отказа. Этот режим
предназначен для серверов OPC, которые не могут поддерживать группы, когда не
являются активными серверами OPC.
• Неактивные группы на резервном экземпляре интерфейса (вариант 2)

Резервный экземпляр подключается к серверу OPC, создает неактивные группы и
добавляет элементы в группы, но не активирует группы. Для большинства серверов
OPC такой подход сокращает рабочую нагрузку, поскольку серверу не приходится
поддерживать текущие значения для неактивных групп. Когда экземпляр
интерфейса становится основным, он активирует группы, а затем рекомендует их.
При таком подходе отработка отказа выполняется быстрее, чем для варианта 1.
• Активные группы на резервном экземпляре интерфейса (вариант 3)

Резервный экземпляр подключается к серверу OPC, создает группы, добавляет
элементы и активирует группы, но не рекомендует группы. Серверу OPC приходится
поддерживать кэш текущих значений для всех элементов, но он не отправляет
значения резервному экземпляру интерфейса.
Если оба экземпляра интерфейса подключены к одному сервера OPC, а сервер
поддерживает один центральный кэш для данных, то такой подход может
обеспечить очень малую нагрузку на сервер, поскольку требует обновления кэша для
основного экземпляра интерфейса.
Для сервера OPC, где не используется централизованный кэш или конфигурация, в
которой экземпляры интерфейса подключаются к различным серверам OPC, такой
подход может привести к существенной нагрузке на сервер OPC или систему
источника данных. Когда резервный экземпляр интерфейса становится основным,
все, что нужно сделать для начала сбора данных, — это рекомендовать группы,
поэтому данный вариант теплой отработки отказа — самый быстрый.
Холодная отработка отказа

Холодная отработка отказа требуется в тех случаях, когда сервер OPC может
поддерживать только один клиент или если используются избыточные серверы OPC, а
резервный сервер OPC не может принимать подключения. Резервный экземпляр не
устанавливает связь с сервером OPC, пока не станет основным. В этот момент он должен
создать группы, добавить элементы в группы и рекомендовать группы. Эта задержка
всегда связана с некоторой потерей данных, но совершенно не создает нагрузки на
сервер OPC или систему источника данных.

Прим.:
Интерфейс PI Interface для OPC DA позволяет использовать сторожевые точки OPC
для управления отработкой отказа. Сторожевые точки позволяют интерфейсу
обнаружить, когда соответствующий сервер OPC не смог должным образом
предоставить данные, и переключиться на другой интерфейс, если он справляется
со сбором данных лучше. Такой подход предназначен для серверов OPC, которые
агрегируют данные, собирая данные из нескольких ПЛК. Если одна точка на
каждом ПЛК назначена сторожевой, то интерфейс можно настроить на отработку
отказа в том случае, если число считываемых точек меньше указанного значения.
Такой подход позволяет реализовать преимущества избыточности на уровне сбора
данных. Дополнительные сведения о настройке сторожевых точек OPC см. в
разделе Состояние сервера и сторожевых точек OPC.
Отработка отказа на уровне сервера OPC

Чтобы обеспечить продолжение поступления данных из сервера OPC в интерфейс PI
Interface для OPC DA, можно настроить интерфейс для перехода на другой сервер OPC в
следующих обстоятельствах.
• Потеря связи с текущим сервером OPC.

• Состояние сервера OPC изменяется на значение, отличное от RUNNING.
• Заданные элементы сервера OPC указывают, что сервер OPC недоступен, по
конкретному значению или по качеству.
Серверы OPC можно сделать полностью избыточными (несколько серверов активны
одновременно) или настроить для отработки отказа в ситуации, когда одновременно
активен один сервер. Обратите внимание, что серверы OPC сильно различаются в
подходах к отслеживанию и подготовке отчетов о состоянии, поэтому
проконсультируйтесь с документацией по серверу OPC, чтобы определить
поддерживаемые варианты.
На следующей схеме показана базовая конфигурация отработки отказа на уровне
сервера OPC.

• Настройка отработки отказа сервера OPC
• Отработка отказа при изменении состояния сервера OPC
• Состояние сервера и сторожевых точек OPC
• Время отработки отказа
Настройка отработки отказа сервера OPC

Настройте интерфейс PI Interface для OPC DA на отработку отказа с переходом на другой
сервер OPC в случае потери соединения с первоначальным сервером OPC.
Процедура
1. С помощью PI ICU перейдите на страницу OPCInt Failover > Server Level и введите узел
и имя другого сервера OPC.
Эта базовая конфигурация запускает отработку отказа только в том случае, когда
интерфейс PI Interface для OPC DA теряет связь с сервером OPC.
2. При необходимости создайте строку PI Point для отслеживания активного сервера
OPC. Назначьте точку PI Point неиспользуемому источнику точек.
С помощью PI ICU перейдите на страницу OPCInt > Failover > Server Level и введите
имя точки PI Point в поле Current Active Server Tag. Чтобы показать значение точки,
запустите PI SMT и используйте функцию Data > Current Values.
Когда произойдет отработка отказа, значение этой точки заменится именем сервера
OPC, подключенного в настоящее время. Благодаря архиву этих изменений можно
просмотреть историю отработки отказов.
3. Чтобы проверить, что отработка отказа происходит при потере связи, выполните
следующие действия.
a. Запустите оба сервера OPC, а затем запустите интерфейс.
b. С помощью PI SMT или служебной программы pigetmsg проверьте журнал PI SDK
на узле PI Data Archive на предмет сообщений, удостоверяющих успешный запуск.
c. Остановите активный сервер OPC и проверьте журнал SDK, чтобы убедиться, что
интерфейс переключился на другой сервер OPC.
d. Чтобы вновь переключиться на первый сервер OPC, перезапустите его, остановите
второй сервер и проверьте журнал SDK или значение точки PI Active Server, если
оно определено, чтобы убедиться, что интерфейс PI OPC переключился на первый
сервер OPC.
Отработка отказа при изменении состояния сервера OPC

Можно настроить отработку отказа для случаев, когда сервер OPC выходит из состояния
RUNNING.
Перейдите на страницу OPCInt > Failover > Server Level и проверьте параметр Failover if
Server Leaves RUNNING State.
Чтобы задать период ожидания, укажите в поле Wait For RUNNING State нужное число
секунд. Если сервер OPC не войдет в состояние RUNNING до истечения указанного
периода, то интерфейс PI Interface для OPC DA попытается подключиться к другому
серверу. Если другой сервер не войдет в состояние RUNNING до истечения указанного

периода, то интерфейс повторит попытку связаться с первым сервером, переключаясь

между ними до тех пор, пока не будет снова обнаружен работающий сервер.
Состояние сервера и сторожевых точек OPC

Чтобы интерфейс мог отслеживать серверы OPC, воспользуйтесь PI ICU для настройки
сторожевых точек PI Point, которые сопоставлены с элементами OPC, надежно
отражающим состояние сервера OPC.
Элементы OPC должны содержать положительное целое число, если сервер OPC
запущен, или 0, если сервер OPC недоступен, а сторожевые точки OPC должны иметь
целочисленный тип данных.
Выбирая элементы OPC, сопоставленные сторожевым точкам OPC, учитывайте, какие из
них наиболее надежны и лучше отражают состояние сервера OPC. Например, в условиях
производства это может быть элемент, подсчитывающий число изготовленных
изделий. Чтобы обеспечить единые отчеты о состоянии от основного и резервного
серверов OPC, выберите элемент OPC на основе собственно источника данных (а не
элемента на сервере OPC).
Чтобы значения сторожевых точек OPC были действительными (0 или положительное
целое число), используйте масштабирование и трансформацию точек PI Point по мере
необходимости.
Чтобы уменьшить рабочую нагрузку на систему, настройте сторожевые точки OPC как
точки advise, если сервер OPC поддерживает точки advise. Если нет, назначьте их для
scan class с коротким периодом сканирования.
Если на одном или нескольких узлах выполняется более одного экземпляра интерфейса,
необходимо создать отдельные сторожевые точки OPC для каждого экземпляра
интерфейса. Если идентификатор экземпляра не используется, то каждый экземпляр
сканирует только те точки PI Point с атрибутами pointsource, которые соответствуют
параметру ps экземпляра интерфейса. Когда используется идентификатор экземпляра,
атрибут pointsource должен соответствовать параметру ps интерфейса, а атрибут
location1 должен соответствовать параметру id интерфейса.
Настройка единственной сторожевой точки PI Point

Если можно определить доступность сервера OPC на основе одного элемента OPC,
создайте единственную сторожевую точку PI Point. Если значение элемента OPC равно 0,
то интерфейс PI Interface для OPC DA пытается подключиться к другому серверу. Если не
удается успешно подключиться к другому серверу в течение указанного времени
ожидания подключения, то выполняется попытка повторно подключиться к первому
серверу OPC.
Создание и настройка сторожевой точки OPC
Процедура
1. Создайте точку PI Point. Сопоставьте точку элементу OPC, который вы считаете
надежным индикатором состояния сервера.

Элемент OPC, с которым сопоставлена точка, должен быть одинаково определен на

основном и резервном серверах OPC, хотя может иметь различные значения на двух
серверах.
2. Укажите сторожевую точку для основного и резервного серверов OPC. Запустив PI
ICU, перейдите на страницу OPCInt > Failover > Server Level и настройте поля Primary
Server Watchdog Tag и Backup Server Watchdog Tag.
3. Убедитесь, что элемент OPC выполняет отработку отказа.
a. Запустите серверы OPC и убедитесь, что сторожевой элемент имеет значение,
отличное от нуля, как минимум на одном сервере. Запустите интерфейс.
b. Вручную установите элемент OPC в значение 0 на сервере, подключенном в
настоящий момент.
c. Проверьте журнал PI SDK или точку Active Server, чтобы определить, произошло
ли переключение интерфейса на другой сервер OPC.
Настройка нескольких сторожевых точек PI Point

Если необходимо оценить элементы OPC для определения доступности (например,
когда сервер OPC может сообщить о доступности серверных источников данных),
настройте нескольких сторожевых точек PI Point сервера OPC. Сумма значений
сторожевых точек OPC определяет, считается ли сервер активным. Сначала интерфейс
назначает каждой сторожевой точке 1 и пересчитывает итог всякий раз, когда получает
новое значение для одной из точек. Если сумма стала ниже указанного минимума, то
запускается отработка отказа.
Процедура
1. Создайте точки PI Point и сопоставьте их с элементами OPC, которые вы считаете
надежными индикаторами состояния сервера OPC. Для каждой точки установите
значение location3 равным 3 для точек polled или 4 для точек advise.
2. С помощью программы PI ICU перейдите на страницу OPCInt > Failover > Server Level и
введите в поле Multiple Watchdog Tags Trigger Sum минимальное допустимое
суммарное значение сторожевых точек.
3. Убедитесь, что, когда сумма значений снижается ниже заданного минимума,
запускается отработка отказа.
a. Запустите серверы OPC и интерфейс.
b. Вручную задайте значения элементов OPC.
c. Проверьте журнал PI SDK или точку Active Server, чтобы определить, произошло
ли переключение интерфейса на резервный сервер OPC.
Качество элемента OPC

Если существует несколько сторожевых точек PI Point, то можно настроить систему
таким образом, чтобы выполнялась обработка отказа, когда считано указанное число
сторожевых точек с качеством BAD. Чтобы настроить этот параметр, перейдите на
страницу OPCInt > Failover > Server Level и введите нужное максимальное значение в
поле Maximum number of Watchdog Tags which can have Bad Quality or Any Error without
triggering Failover.

Настройка специфических для сервера сторожевых точек OPC для эффективной

отработки отказа
Серверы OPC отслеживают собственные состояния (изолированный режим). Чтобы
интерфейс PI Interface для OPC DA мог определить состояние сервера OPC, прежде чем
пытаться переключиться на него, настройте оба сервера OPC для взаимного
отслеживания состояния (режим, определяемый сервером). Эта конфигурация позволит
серверу OPC определить состояние обоих серверов без излишних затрат на создание
второго подключения.
Прим.:
Метод, с помощью которого сервер OPC отслеживает свое состояние, в большой
степени зависит от поставщика, и его реализации различны. Подробности см. в
документации по серверу OPC.
С помощью PI ICU настройте сторожевые точки OPC.
Процедура
1. В обоих серверах OPC создайте идентичные элементы, отслеживающие состояние
каждого сервера.
Если сервер OPC активен, то элемент OPC должен содержать положительное
значение. Если сервер OPC не может обслуживать данные, то значение элемента
должно равняться нулю. Реализуйте любую логику, позволяющую обоим серверам
корректно обнаруживать и поддерживать состояние другого сервера, поэтому
значения в обоих серверах OPC должны быть идентичными.
2. Настройте серверы OPC таким образом, чтобы во время нормального
функционирования один сервер отправлял данные в интерфейс PI Interface для OPC
DA, а другой ожидал отказа основного сервера.
Состояние основного сервера должно быть положительным, а состояние резервного
сервера — равным нулю. Если произошла отработка отказа, то состояние основного
сервера должно стать нулевым, а состояние резервного сервера — положительным.
3. В архиве PI Data Archive создайте для каждого сервера OPC сторожевую точку PI Point,
сопоставленную с элементами OPC, отслеживающими состояние сервера.
4. С помощью PI ICU перейдите на страницу OPCInt > Failover > Server Level и введите в
поля Primary Server Watchdog Tag и Backup Server Watchdog Tag имена сторожевых
точек PI Point, созданных на предыдущем шаге.
В пакетном файле запуска интерфейса эти настройки заданы параметрами wd1 и wd2.
Результат
Если обе сторожевых точки равны нулю, то сбор данных останавливается до тех пор,
пока значение одной из сторожевых точек не станет положительным. Если обе
сторожевые точки имеют положительное значение, то интерфейс остается
подключенным к серверу, который поставляет ему данные в настоящее время.
Время отработки отказа

При запуске отработки отказа интерфейс PI Interface для OPC DA должен быстро
распознать, что текущий сервер OPC перестал быть доступным и определить
доступность резервного сервера OPC. Для повышения эффективности отработки отказа
можно изменить следующие настройки в PI ICU на странице OPCInt > Failover > Server
Level.

• Switch to Backup Delay (/FT=#)

Указывает время в секундах, в течение которого интерфейс OPC пытается
восстановить подключение к текущему серверу, прежде чем переключиться на
другой сервер, и, если это значение менее 30, как часто интерфейс проверяет
состояние сервера.
• Number of Interfaces on this Node (/NI=#)

Указывает число экземпляров интерфейса, выполняемых на этом узле. Это значение
используется для того, чтобы разнести во времени запуск экземпляров интерфейса и
избежать негативных последствий одновременного подключения нескольких
экземпляров к серверу OPC. (Чтобы уменьшить влияния перезапуска нескольких
экземпляров, можно также использовать параметр Startup Delay.)
• Wait for Running State (/SW=#)

Указывает, сколько секунд ожидать перехода сервера в состояние RUNNING, прежде
чем переключиться на другой сервер. По умолчанию интерфейс ожидает перехода
сервера в состояние RUNNING неопределенно долго. Обратите внимание, что между
серверами OPC есть существенные различия по времени, требуемому для перехода в
состояние RUNNING.
Буферизация для интерфейсов PI Interface

Чтобы предотвратить потерю данных, когда архив PI Data Archive недоступен, на узле
интерфейса используется буферизация. Интерфейсы UniInt могут буферизовать данные
для сохранения значений точек при отсутствии сетевого подключения к архиву PI Data
Archive. Буферизация обязательна для запуска UniInt без подключения к сети, а также
настоятельно рекомендуется для целей отработки отказа. Буферизация для
интерфейсов включается и настраивается через PI ICU.
Службы буферизации
Система PI System включает две службы, которые позволяют реализовать буферизацию
на интерфейсах.
• PI Buffer Subsystem (PIBufss)
• API Buffer Server (Bufserv)
Подсистема PI Buffer Subsystem представляет собой лучший выбор для большинства
сред.
Сервер API Buffer Server следует выбирать только в том случае, если выполняется одно
или несколько из следующих условий.
• PI Data Archive, который получает буферизованные данные, имеет версию ниже
3.4.375.
• Интерфейсы работают на платформе, отличной от Windows.
Если выполняется одно из вышеперечисленных условий, см. документацию PI Buffering
Manager Help (PIPC/HELP/BufferManager.chm) для PI Server. В противном случае
используйте подсистему PI Buffer Subsystem.

Буферизация и коллективы
Подсистема PI Buffer Subsystem 4.3 и более поздние версии обеспечивают буферизацию
данных на нескольких независимых серверах, в том числе настроенных как коллективы
PI Server. Чтобы интерфейсы могли использовать подсистему PI Buffer Subsystem с
коллективами PI Server, серверы PI Data Archive должны работать с версией PI Data
Archive 3.4.375 или более поздней.
ОСТОРОЖНО:
Сервер API Buffer Server не обнаруживает и не проверяет конфигурацию
коллектива PI Server. Поэтому требуется ручная настройка API Buffer Server при
каждом изменении коллектива. Кроме этого, поскольку API Buffer Server
выполняет сжатие на машине PI Data Archive, архивы на разных серверах в
коллективе могут содержать различные записи.
Настройка буферизации
Программа PI Interface Configuration Utility (PI ICU) служит для настройки буферизации
Параметр Tools > Buffering поможет настроить буферизацию. В зависимости от текущей
конфигурации этот параметр выполняет одно из следующих действий.
• Если данный компьютер настроен для буферизации данных через подсистему PI
Buffer Subsystem 4.3 или более поздних версий, то открывается окно Buffering
Manager и отображается панель буферизации. На панели показана информация о
состоянии буферизации на этом компьютере.
• Если в данное время этот компьютер не настроен для буферизации данных и
установлена подсистема PI Buffer Subsystem 4.3 или более поздней версии, то будет
выдан запрос о настройке подсистемы PI Buffer Subsystem. Если нажать кнопку «Yes»,
то открывается окно Buffering Manager и запускается мастер установки, который
поможет настроить подсистему PI Buffer Subsystem.
• Если этот компьютер настроен для буферизации данных через API Buffer Server
(Bufserv) и установлена подсистема PI Buffer Subsystem 4.3 или более поздней версии,
то будет выдан запрос о переходе к подсистеме PI Buffer Subsystem и ее настройке.
Если нажать кнопку «Yes» в ответ на оба запроса, то откроется окно Buffering Manager
и запустится мастер обновления, который поможет перейти с сервера API Buffer
Server на подсистему PI Buffer Subsystem.
• Если подсистема PI Buffer Subsystem 4.3 еще не установлена, то откроется окно
Buffering для API Buffering или более ранней версии подсистемы PI Buffer Subsystem.
Для подсистемы PI Buffer Subsystem 4.3 при настройке интерфейса для буферизации
данных на сервере PI Data Archive, который не был добавлен в список буферизованных
серверов, необходимо включить буферизацию. Нажмите кнопку Enable в поле Buffering
Status на странице интерфейса General. Чтобы убедиться, что буферизация имеет
состояние On, выйдите из PI ICU, а затем перезапустите и выберите интерфейс.
Можно использовать Buffering Manager для настройки, контроля и устранения
неполадок буферизации через подсистему PI Buffer Subsystem. Использование
подсистемы PI Buffer Subsystem рекомендуется для приложений, которые
подключаются к PI Data Archive 3.4.375 или более поздних версий. Для предыдущих
версий PI Data Archive требуется сервер API Buffer Server, как и для некоторых сайтов с
пользовательскими решениями. Дополнительные сведения см. в разделе Buffering
Manager help (PIPC/HELP/BufferManager.chm).

Включение буферизации
Процедура
1. В PI ICU выберите Tools > Buffering. Открывается окно Buffering.
2. Щелкните Enable buffering with PI Buffer Subsystem.
3. Запустите службу буферизации. Щелкните PI Buffer Subsystem Service, а затем
щелкните .
4. Убедитесь, что буферизация запущена успешно. Проверьте журнал сообщений на

наличие сообщений, указывающих на подключение приложения буферизации к
архиву PI Data Archive.
5. Убедитесь, что буферизация функционирует исправно. Перезагрузите узел
интерфейса и подтвердите перезапуск службы интерфейса и приложения
буферизации.
Подключаемые модули (DLL-библиотеки постобработки)

Интерфейс PI Interface для OPC DA можно настроить на использование подключаемых
модулей, то есть DLL-файлов, содержащих библиотеки подпрограмм, которые
выполняют характерную для приложения обработку данных до того, как данные
отправляются в PI Data Archive или на сервер OPC. DLL-библиотеки и сопровождающие
их файлы и документация включены в комплект установки PI Interface для OPC DA и
устанавливаются во вложенный каталог Plug-ins под каталогом установки. Каждый
пакет подключаемого модуля содержит пользовательскую документацию, а
руководства пользователей подключаемых модулей можно загрузить из Центра
загрузки OSIsoft.


Работа интерфейса PI Interface для OPC DA
В ходе работы интерфейса PI Interface для OPC DA можно проверить запуск интерфейса,
подтвердить сбор данных с сервера OPC, а также устранить неполадки в настройке и
работе.
Проверка запуска интерфейса

Для проверки успешного запуска интерфейса можно воспользоваться журналом
сообщений.
Процедура
1. Выведите на экран журнал сообщений. Откройте PI System Management Tools и
щелкните Operation > Message Logs.
2. Запустите интерфейс. Откройте PI ICU, перейдите к экземпляру интерфейса, а затем
щелкните Interface > Start Interactive.
PI ICU открывает командное окно и выполняет пакетный файл запуска (.bat).
Интерфейс записывает сообщения в процессе инициализации и запуска.
3. См. в журнале сообщения, указывающие на успешное выполнение или ошибки.
4. Чтобы остановить интерфейс, закройте командное окно.
Сбор данных с сервера OPC

Данные считываются с серверов OPC группами, а не в виде отдельных элементов.
Интерфейс PI Interface для OPC DA создает группы OPC для scan class системы PI System.
(Для точек advise PI Point в scan class 1 может быть создано несколько групп.) Сервер
OPC записывает в кэш самые последние данные.
По умолчанию интерфейс PI Interface для OPC DA выполняет считывание данных из
кэша сервера OPC. Когда интерфейс создает группу, он указывает, как часто должны
обновляться значения кэша для точек в этой группе. Запрошенная частота обновления
обычно совпадает с частотой сканирования для точек. Сервер OPC может отклонить
запрашиваемую частоту и вернуть частоту обновления, поддерживаемую им для данной
группы. Частота обновления, принятая сервером OPC, записывается в локальном файле
журнала сообщений PI Message Log.

Работа интерфейса PI Interface для OPC DA

Справочник PI ICU для интерфейса PI Interface
для OPC DA
Программа PI Interface Configuration Utility (PI ICU) представляет собой графический
пользовательский интерфейс для настройки интерфейсов. PI ICU обеспечивает
хранение конфигурационной информации в пакетном (bat) файле запуска, а также
корректное создание и обновление базы данных PI Module Database, устраняя
необходимость ее редактирования вручную.
Для PI ICU требуется PI Data Archive 3.3 или более поздней версии. Дополнительные
сведения см. в разделе PI Interface Configuration Utility (PI ICU) User Manual.
• Параметры сервера OPC
• Настройка дополнительных параметров
• Параметры обработки данных
• Настройки безопасности DCOM
• Параметры отработки отказа
• Настройки подключаемых модулей
• Разные параметры
• Настройки отладки
• Параметры метки времени в PI ICU
Параметры сервера OPC

Имя узла сервера OPC
Имя или IP-адрес узла сервера OPC (/SERVER=узел::имя). Оставьте пустым или
присвойте значение localhost (без учета регистра символов), если интерфейс PI Interface
для OPC DA и сервера OPC расположены на одном узле. Если в качестве имени узла
указано другое имя, то интерфейс будет рассматривать сервер OPC как удаленный. Это
может привести к тому, что некоторые серверы OPC будут отвергать попытки
удаленного подключения.
Имя сервера OPC

Зарегистрированное имя сервера OPC на узле сервера OPC.
Применение протокола v1.0a

По умолчанию интерфейс пытается подключиться к серверу OPC с использованием
спецификации OPC Data Access версии v2.0 (/vn=2). Если попытка завершилась
неуспешно, то используется протокол версии v1.0a. Чтобы заставить интерфейс
использовать только спецификацию OPC Data Access версии v1.0a, включите этот
параметр.
Timestamps
Interface Provides Timestamp. Интерфейс OPC предоставляет метку времени получения
данных (/ts=N).

Справочник PI ICU для интерфейса PI Interface для OPC DA
OPC server Provides Timestamp. Интерфейс OPC использует метки времени данных,
предоставленные сервером OPC, и учитывает смещение между серверами OPC и узлом PI
Data Archive (/ts=Y).
Timestamp for Advise Tags Only. Сервер OPC предоставляет метки времени только для
тегов advise, а интерфейс учитывает смещение между сервером OPC и узлом PI Data
Archive. Для всех остальных тегов интерфейс предоставляет метку времени, когда
данные получены (/ts=A).
OPC Server Provides Timestamp (no offset). Сервер OPC предоставляет метки времени для
всех данных, а интерфейс не применяет никакого временного смещения к этим
значениям. Потеря данных произойдет, если значение получено из OPC с меткой
времени не менее 10 минут или после текущего времени узла PI Data Archive. (/ts=U).
Сомнительное качество
Store Quality Only. Если данные имеют качество, отличное от GOOD, то сохранить
информацию о качестве, а не значение (/sq=Y).
Store Value Only. Интерфейс рассматривает «сомнительное» качество как «хорошее» (/
sq=I). Данные плохого качества сохраняются как системные цифровые состояния.
Настройка дополнительных параметров

Time delay before reading OPC Tags (sec)
Указывает задержку (в секундах) перед считыванием или записью данных в сервер OPC.
Если этот параметр настроен, то интерфейс подключается к серверу OPC и ожидает в
течение заданного времени, прежде чем попытаться считать данные. (/sd=#).
Event Tags Source

Для серверов v1.0a OPC указывает, считываются ли теги событий из кэша сервера OPC
или непосредственно из устройства. Для серверов v2.0 этот параметр не действует, так
как все теги событий считываются из устройства. (/es=CACHE или DEVICE).
Advise Groups on Creation

Некоторые серверы OPC не возвращают начальное значение, когда создается точка
advise PI Point. Результирующий симптом заключается в том, что для редко
изменяющегося значения интерфейс PI Interface для OPC DA не записывает значение в
архив PI Data Archive при запуске интерфейса. Чтобы определить, существует ли данная
проблема на вашем сервере OPC, с помощью средства PI OPCClient создайте группу,
добавьте теги, а затем рекомендуйте группу. Если значение для ваших тегов не
возвращается немедленно, но добавление тега в scan class приводит к возврату
значения, то включите этот параметр. (/af=Y).
Disable Mass Tag Adding

Массовое добавление тегов: по умолчанию /ma=N. По умолчанию интерфейс не
добавляет несколько тегов к группе одновременно. Некоторые серверы OPC отвергают
всю группу, если один тег недействителен. Чтобы включить массовое добавление тегов,
установите /ma=Y. Обратите внимание, что включение массового добавления тегов
может существенно задержать запуск интерфейса. Включите этот параметр, чтобы
настроить интерфейс для добавления тегов в группу OPC по одному. По умолчанию
массовое добавление отключено (если интерфейс не настроен с использованием PI ICU,
в котором этот параметр включен). Если несколько тегов добавлены к группе
одновременно, то некоторые серверы OPC отвергают всю группу, если один тег

недействителен. Обратите внимание, что отключение может существенно задержать

запуск интерфейса. (/ma=N).
GlobalLocking Not Valid

Если вы видите сообщения OnDataChange: Invalid group ID в локальном файле
журнала сообщений PI Message Log, включите этот параметр. Если проблема устранена,
сервер OPC не следует спецификациям OPC. В этом случае отправьте сведения (с
указанием поставщика и версии сервера OPC) по электронной почте по адресу
techsupport@osisoft.com. Этот флаг имеет смысл только для OPC DA версии 1.0a. (/gl=N).
Ignore Group Status

Если вы видите OnDataChange: Header status: в локальном файле журнала
сообщений PI Message Log, то статус группы, отправленный сервером, недействителен.
Чтобы игнорировать статус группы, включите этот параметр. Этот флаг имеет смысл
только для OPC DA версии 1.0a. (/gs=N).
Ignore Server Status

Если сервер OPC не переходит в состояние OPC_STATUS_RUNNING, когда он готов
отправить данные, включите этот параметр, чтобы настроить интерфейс для
повторения попытки установить связь в любом случае (/is=Y).
Ignore OPC Server Access Rights

Если в локальном файле журнала сообщений PI Message Log вы видите сообщения
«Invalid read/write mode requested», включите этот параметр. (/ar=N).
Use Honeywell Plantscape Failover Error Codes

Включает проверку кодов ошибки, специфических для системы Honeywell Plantscape,
для отработки отказа на уровне сервера. Настраивает интерфейс для отработки отказа,
если получен код ошибки 0xE00483FD или 0xE00483FC для любого тега. Устарело, так
как Honeywell прекратила использовать эти коды после одного выпуска. (/hwps)
Reconnect to Server Delay (sec)

Указывает длительность ожидания (в секундах), прежде чем попытаться подключиться
к серверу OPC, если соединение нарушено. (/rd=#).
Update Rates
Указывает запрошенную частоту обновления, если отличается от периода
сканирования. Выберите scan class из раскрывающегося списка, введите желаемую
частоту в поле справа от scan class и щелкните . Scan class, частота сканирования и
частота обновления отображаются в поле ниже точки. Перечислены только классы scan
class, которые были обновлены.
Этот параметр полезен, когда серверу необходимо получить недавнее значение для
элементов, но интерфейс выполняет их чтение не слишком часто, например, если
интерфейс PI Interface для OPC DA опрашивает значение через каждые 30 минут, но
возраст самого значения не может быть больше одной минуты. В этой ситуации
нагрузка на сервер OPC увеличивается в большей степени, чем в случаях, когда частота
обновления и период сканирования одинаковы, однако при этом может быть сокращена
латентность значений для элементов, которые приходится читать реже. (/ur=period).

Параметры обработки данных

Staggered Group Activation
Этот параметр указывает интерфейсу PI Interface для OPC DA на необходимость
деактивировать все группы при запуске и выполнять ступенчатую активацию групп в
соответствии со смещениями, указанными для периода сканирования группы. Эта
функция не влияет на работу всех серверов OPC. Ее назначение — выравнивание
рабочей нагрузки за счет распределения обновлений по группам с одинаковым
периодом сканирования. (/ga).
Inactivate Groups on Startup

Деактивировать все группы при запуске. После того как все группы построены, они
активируются. Этот параметр помогает снизить нагрузку на сервер OPC в процессе
запуска. (/gi).
Update Snapshot
Если текущий снэпшот представляет системное цифровое состояние (такое как I/O
timeout, Shutdown, и т. д.) и интерфейс считывает новое значение, более старое, чем
снэпшот, новое значение отправляется спустя одну секунду после метки времени
системного цифрового состояния. Эта проверка не выполняется, если текущий снэпшот
является корректным значением. Это может оказаться полезным для точек установки,
которые изменяются редко. (/us).
Ignore First Value

Если сервер OPC отправляет данные, прежде чем считаны данные из источника данных,
то это может указывать на то, что передаются нулевые или ошибочные значения. Этот
параметр указывает, что интерфейс должен игнорировать первое полученное значение
после запуска для каждого тега. (/if=Y).
Ignore Subsecond Timestamps

Если миллисекундная часть метки времени не требуется, то ее можно отбросить, что
позволит ускорить работу PI Data Archive (/it=Y).
No Timeout
Указывает, что интерфейс PI Interface для OPC DA ни в каких случаях не должен
записывать ошибки I/O timeout, даже если потеряна связь с сервером OPC. Установите
этот параметр при настройке отработки отказа. (/nt=Y).
Disable Callbacks
Снижает нагрузку на сервер OPC за счет отключения обратных вызовов для групп polled.
По умолчанию обратные вызовы для групп polled включены, но не используются
интерфейсом. Этот параметр не влияет на группы advise. (/dc).
Write Status to Tags on Shutdown

Этот параметр указывает, должно ли цифровое состояние записываться во все точки PI
Point, когда интерфейс отключен (/opcstopstat=state).
Alternate Digital State for Questionable/Bad Qualities

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

состояний, перечисленных в руководстве по OPC, затем назначьте первое цифровое

состояние набора параметру командной строки. (/as=system digital state). Для
просмотра системных цифровых состояний с использованием PI System Management
Tools перейдите к Points > Digital States.
Format of Timestamp Strings

Задает формат строк меток времени, прочитанных из сервера OPC или записанных в
него. (/tf=format). Дополнительные сведения см. в разделе Корректировка меток
времени.
Number of Tags in Advise Group

Назначение максимального числа тегов для каждой группы advise, созданной со scan
class 1. Рекомендуемый максимальный показатель — 800 тегов для группы, что
представляет собой значение по умолчанию. Подберите это число в соответствии с
требованиями сервера OPC. (/am=#).
Time Offset
Если для узла сервера OPC назначен часовой пояс, отличный от локального, то этот
параметр заставляет интерфейс заменять все метки времени на указанное значение.
Для указания смещения используйте формат [-]ЧЧ:ММ:СС. (/to=offset).
Event Update Rate

Указывает запрашиваемую частоту обновления для группы классов событий. Все теги
на основе событий принадлежат одной и той же группе, а частота обновления по
умолчанию для группы составляет одну секунду. Если кэш данных сервера OPC для
тегов на основе событий не обязательно обновлять каждую секунду, то можно
уменьшить нагрузку на сервер OPC, назначив этому параметру более высокое значение
(более низкую частоту). Для серверов v2.0 все события считываются из устройства,
поэтому это значение может быть довольно высоким, если существует какая-либо
другая причина для обновления кэша.
Trend Advise
Для точек advise PI Point отправляется значение из предыдущего сканирования, если
метка времени нового значения больше указанного количества периодов сканирования
(задается параметром ta). Включение этой настройки вызывает такое же поведение
тегов advise, как и при включенном атрибуте step.
Настройки безопасности DCOM

Дополнительные сведения о настройке безопасности DCOM см. в OSIsoft DCOM Security
and Configuration Guide.
Default Authentication Level

Задайте один из следующих уровней проверки подлинности в системе безопасности
DCOM (/da):
• DEFAULT
• NONE
• CONNECT (по умолчанию)
• CALL
• PKT

• PKT_INTEGRITY
• PKT_PRIVACY
Default Impersonation Level

Задайте один из следующих уровней олицетворения в системе безопасности DCOM (/
di):
• ANONYMOUS
• IDENTIFY (по умолчанию)
• IMPERSONATE
• DELEGATE
Параметры отработки отказа

UniInt-Interface Level Failover
Следующие три параметра доступны только в том случае, если на странице UniInt >
Failover включена горячая отработка отказа.
• Warm_1: Do not create groups on the server (/fm=1)

• Warm_2: Create inactive groups and add PI points (/fm=2)
• Warm_3: Create active groups; do not use advise groups (default)
• Percent of tags accepted by OPC Server as valid

Укажите процент точек, которые должны быть приняты сервером OPC в качестве
допустимых. Если количество принятых меньше, чем этот процент, то интерфейс PI
Interface для OPC DA устанавливает состояние устройства в Connected/No Data, что
запускает отработку отказа, если настроена обработка отказов UniInt. (/rp).
• Maximum number of Watchdog Tags which can have Bad Quality or Any Error
without triggering Failover
Указывает максимальное число сторожевых точек PI Point, которые могут иметь
ошибку или плохое качество, прежде чем будет запущена отработка отказа. Можно
настроить сторожевые точки PI Point для управления отработкой отказов, когда
интерфейс не может прочитать некоторые или все элементы или когда элементы
имеют плохое качество. Эта функция позволяет запустить отработку отказа, когда
источник данных теряет связь с одним сервером OPC, но может передавать данные
другому. Для настройки сторожевых точек PI Point установите location3. Для
сторожевой точки, которая находится в группе advise, установите location3 в
значение 4. Для сторожевой точки, которая находится в группе polled, установите
location3 в значение 3. (/uwq).
Cluster Interface Failover

Чтобы выбирать элементы в этом режиме, сначала включите его, установив флажок
Enable Cluster Interface Failover. Обратите внимание, что эта вкладка доступна только в
том случае, если выбран параметр UniInt Failover.
Настройка Описание
This node is the Указывает, будет ли узел основным (/pr=1)
или резервным (/pr=2).

Failover Mode Chilly: Do not create groups on the server (/
fm=1).
Cool: Create inactive groups, and add points (/
fm=2).
Warm: Create active groups, do not advise groups
(default) (/fm=3).
Cluster Mode Настройка работы резервного интерфейса.
Primary Bias: This node is the preferred
primary. (/cm=0).
No Bias: No node is preferred. Активный
интерфейс PI OPC остается активным до тех
пор, пока не произойдет отработка отказа
кластерного ресурса, как в результате отказа,
так и вследствие вмешательства человека. (/
cm=1).
Resource Number for APIOnline Указывает экземпляр apionline,
соответствующий этому экземпляру
интерфейса. Например, чтобы настроить
зависимость интерфейса от экземпляра с
именем apionline2, установите это поле в
значение 2. Чтобы настроить зависимость
интерфейса от экземпляра с именем apionline
(без номера ресурса), установите это поле в
значение -1. (/rn=#).
Active Interface Node Tag Указывает строковую точку, которая содержит
имя текущего активного узла интерфейса OPC.
(/cn).
Health Tag ID Этот параметр используется для фильтрации
значений степени исправности UniInt по
location3. Параметр должен быть
уникальным для каждого интерфейса —
параметр участника отработки отказа. Если
этот параметр имеет недопустимое значение
или не установлен, то для атрибута location3
при создании значений степени исправности
UniInt используется значение по умолчанию 0.
(/uht_id).
Server Level Failover

Backup OPC Server Node Name Имя или IP-адрес резервного узла сервера OPC
(/backup).
Backup OPC Server Name Зарегистрированное имя резервного сервера
OPC (/backup).
Number of Interfaces on this Node Число экземпляров интерфейса, выполняемых
на этом узле (/ni=#).
Switch to Backup Delay (sec) Число секунд, отведенных на попытку
подключения перед переключением на
резервный сервер (/ft=#).
Wait for RUNNING State (sec) Число секунд, отведенных на ожидание
состояния RUNNING перед переключением на
резервный сервер (/sw=#).

Current Active Server Tag (Необязательно) Строковая точка PI Point,
содержащая имя текущего активного сервера.
Если задано, то интерфейс записывает имя
сервера OPC в эту точку при каждом
подключении. Полезно для отладки отработки
отказа на уровне сервера. (/cs=tag).
Primary Server Watchdog Tag Сторожевая точка для основного сервера (/
wd1=tag).
Backup Server Watchdog Tag Сторожевая точка для резервного сервера (/
wd2=tag).
Multiple Watchdog Tag Trigger Sum Минимальное суммарное значение сторожевых
точек. Отработка отказа запускается в том
случае, если сумма значений этих точек
опустилась ниже указанного значения. (/wd=#).
Maximum number of Watchdog Tags which can По умолчанию равно 0, если сторожевая точка
have Bad Quality or Any Error without triggering всего одна. Не может превышать
Failover определенного числа сторожевых точек. (/
wq=#).
Failover if Server Leaves RUNNING State Запускает отработку отказа, если состояние
сервера изменилось на любое, кроме RUNNING.
(/ws=1).
Настройки подключаемых модулей

• DLL-библиотека постобработки
Введите имя DLL и путь к DLL-библиотеке постобработки, например /DLL=”
\Interfaces\OPCInt\plug-ins\exampledll.dll”
• Файл конфигурации подключаемого модуля

Введите имя файла конфигурации DLL-библиотеки постобработки. Этот текстовое
поле отображается только в случае, если DLL-библиотеке постобработки требуется
файл конфигурации.
Разные параметры
ОСТОРОЖНО:
Не изменяйте эти параметры, если только соответствующие указания не получены
от специалиста технической поддержки OSIsoft.
• OPC Server Status Tag

Укажите точку PI Point для сохранения состояния сервера OPC, когда изменяется
состояние. (/ST)
Настройки отладки
Чтобы включить параметры отладки с помощью PI ICU, перейдите на вкладку UniInt >
Debug. В общем случае параметры отладки следует включать на короткий период
времени, так как они могут переполнить файлы журналов и привести к снижению

производительности. Параметры с пометкой «Technical Support only» следует включать

только по указанию службы технической поддержки OSIsoft. Подробнее о других
параметрах командной строки см. в разделе PI Universal Interface (UniInt) User Guide.
Опция Описание Value
Internal Testing Only Только для внутреннего /db=1
тестирования OSIsoft.
Log of Startup Запись в журнал информации /db=2
о запуске для каждой точки PI
Point, включая instrumenttag
и exdesc
Log Write Op’s and Acks for Tag Запись в журнал операций /db=4
записи интерфейса PI Interface
для OPC DA, подтверждений
(ACK) с сервера OPC и
операций записи,
поставленных в очередь
ожидания записи. Можно
настроить на запись в журнал
значений для определенной
точки, если указать поле
Debug Tag.
Log Timestamps of refresh Только для использования /db=8
службой технической
поддержки OSIsoft.
Log Information for ExcMax Запись информации об /db=16
отчетности по исключениям
Log Timestamp and Data (All Для каждого значения данных, /db=32
Tags) получаемого интерфейсом,
выполняется запись метки
времени с данными,
откорректированной метки
времени, времени PI Time, scan
class и идентификатора
транзакции.
Log Timestamp and Data for Tag Только для использования /db=64
службой технической
/dt=tagname
Logging of Event Tags Запись имени каждой точки PI /db=256
Point в локальный файл
журнала сообщений PI по мере
получения данных для этой
точки.
Logging of Array Tags Запись в журнал информации /db=512
о точках PI Point массива
Logging of OPC List Pointers Только для внутреннего /db=1024
тестирования OSIsoft.

Опция Описание Value

Log TS, Data and Quality for Tag Для точки, указанной в поле /db=4096
Debug Tag, в локальный
журнал сообщений PI System
записываются метки времени,
значения и качества. Если
точка не указана,
записывается первая точка,
для которой получено
значение. Эта настройка
является подробной и может
существенно заполнить файл
журнала.
Log debugging info for /US Предоставляется информация /db=8192
command об отладке для Update
Snapshot (параметр /us), если
он включен).
Log client, server, and group Запись в журнал адресов, /db=16384
handles используемых интерфейсом и
сервером для каждого тега,
добавленного в интерфейс.
Следует включать только по
указанию службы технической
Введите любые дополнительные параметры, которые недоступны через PI ICU

(например, /dbuniint=0x0400). Параметры следует разделять одним или несколькими
пробелами. Если аргумент параметра содержит встроенные пробелы, заключите этот
аргумент в двойные кавычки.
Параметры метки времени в PI ICU

Интерфейс PI Interface для OPC DA может использовать метки времени,
предоставляемые сервером OPC, или создавать собственные метки времени в момент
получения данных. Метки времени типа Windows определяются по всемирному
координированному времени (UTC), а элементы с вариантными значениями VT_*
интерпретируются как локальное время без поправок на летнее время.
Если сервер OPC предоставляет метки времени, с помощью PI ICU можно настроить
поведение интерфейса следующим образом.
Опция Описание Timestamp Offset Applied
Interface Provides Time (По умолчанию) Интерфейс Разность между узлом PI Data
stamp снабжает меткой времени каждое Archive и узлом интерфейса.
значение по мере его получения.
(/ts=N)
Выберите этот параметр, если
сервер OPC не может
предоставить точные метки
времени или если вы не хотите
использовать метки времени,
возвращаемые сервером OPC.
OPC Server Provides Time Интерфейс использует метку Разность между узлом PI Data
stamp времени UTC, предоставляемую Archive и узлом сервера OPC.
сервером OPC.
(/ts=Y)

Опция Описание Timestamp Offset Applied

Time stamp for Advise Tags Для опрашиваемых операций Для рекомендательных
Only чтения некоторые серверы OPC данных — разность между
возвращают время, когда узлом PI Data Archive и узлом
(/TS=A)
значение в последний раз сервера OPC. Для всех
изменилось, а не время остальных данных — разность
считывания. В этом режиме между узлом PI Data Archive и
интерфейс настраивается на узлом интерфейса.
использование
рекомендательных меток
времени, но предоставляет метки
времени для опрашиваемых
значений. Дополнительные
сведения о точках advise и polled
см. в разделе Входные точки для
интерфейса PI Interface для OPC
DA.
OPC Server Provides Интерфейс использует метку Никаких.
Timestamp, no Offset времени UTC, предоставленную
сервером OPC, и не применяет
(/ts=U)
никакого смещения к меткам
времени.
ОСТОРОЖНО:
Эту настройку следует
использовать крайне
осторожно, так как она
чревата потерей данных,
если сервер OPC отправит
значение с меткой времени
на 10 или более минут позже
текущего времени PI Data
Archive.
Подробные сведения о чтении и записи меток времени из точки PI Point, когда метка
времени является значением точки, см. в разделе Корректировка меток времени.


Параметры командной строки для интерфейса PI
Параметры командной строки, используемые для настроек в пакетном (bat) файле
запуска интерфейса, перечислены в двух таблицах. Одна упорядочена в алфавитном
порядке, а другая — по функциональности. Эти параметры приводятся исключительно
для целей отладки, чтобы помочь прочитать файл. Чтобы гарантировать правильный
формат файла, пользуйтесь для настройки интерфейса программой PI Interface
Configuration Utility (PI ICU).
Алфавитный список параметров

Алфавитный список параметров файла .bat интерфейса PI Interface для OPC DA
Параметр и синтаксис Описание
/af=Option Необязательно. Настраивает обработку данных
для точек advise. Включите, если точки advise
не получают текущее значение при запуске. Не
включайте этот параметр, если используется
отказоустойчивый кластер Windows, так как
это приводит к рекомендации групп OPC сразу
при их создании.
По умолчанию: N
Параметры: Y или N
/ag=group_name Необязательно. Используется для настройки
пользовательских имен групп advise.
Чтобы задать имя для определенной группы,
используйте параметр /ag#=name. Например, /
ag1=MyAdvise и /ag2=NextAdvise указывают
для интерфейса использование имени
MyAdvise для первой группы advise и имени
NextAdvise — для второй.
Чтобы задать базовое имя для групп advise,
используйте параметр /ag=name. Если имя для
определенной группы не указано с помощью
параметра /ag#=name, то ее именем будет
базовое имя, к которому добавлен номер
группы. Например, если /ag=AdviseGroup и
параметр /ag3 не указан, то третья группа
advise будет называться AdviseGroup3.
Базовым именем по умолчанию для групп
advise является Advise. Если имена групп advise
не настроены, то группы advise получат имена
Advise1, Advise2, Advise3 и т. д.
По умолчанию: /ag=Advise
/am=# Необязательно. Указывает количество точек в

каждой группе advise OPC, созданных для scan
class 1. Предназначается для управления
рабочей нагрузкой сервера OPC.
По умолчанию: 800

Параметры командной строки для интерфейса PI Interface для OPC DA

/ar=Option Необязательно. Включение (отключение)
использования свойства, задающего права
доступа для элементов, добавляемых в группу.
Если интерфейс регистрирует в журнале
ошибку “Invalid read/write mode
requested”, попробуйте отключить права
доступа, задав настройку /AR=N
По умолчанию: Y
/as=system_digital Необязательно. Назначение альтернативных
цифровых состояний для значений спорного и
плохого качества. Для использования этого
параметра необходимо создать цифровое
состояние в наборе системных цифровых
состояний, которое соответствует опции
system_digital параметра командной строки.
Затем любые цифровые состояния, которые
следуют за аргументом system_digital,
используются для сопоставления цифровых
состояний с точками PI Point при получении
данных со спорными или неверными
качествами с сервера OPC, переопределяя
цифровые состояния по умолчанию.
Дополнительные сведения см. в разделе
Информация о качестве данных.
/at=# Как долго следует ожидать подтверждения
записи от сервера OPC (в мс). По истечении
этого времени интерфейс отменяет операцию
записи и отправляет ее повторно. Минимум:
2000 мс.
По умолчанию: 2000 мс (две секунды)
/backup=hostname::OPCservername При обеспечении отказоустойчивости на

уровне сервера указывает имя резервного
сервера OPC. Если сервер OPC находится на
локальной машине, не указывайте hostname.
Если имя сервера содержит пробелы,
заключите имя в двойные кавычки.
/cachemode Включение запуска в отключенном от сети
состоянии.
/cachepath=filepath (Необязательно) Задает каталог, где создаются
файлы кэширования точек для запуска в
отключенном состоянии. Каталог должен уже
существовать на целевой машине. По
умолчанию файлы создаются в том же
расположении, что и исполняемый файл
интерфейса. Если путь содержит пробелы,
заключите путь в кавычки.
Примеры:
• /cachepath=D:\PIPC\Interfaces
\CacheFiles
• /cachepath=”D:\Program Files\PIPC
\MyFiles”


/cachesync=# (Необязательно) Задает период отрезка
времени в миллисекундах (мс), выделяемого
для синхронизации файла кэша точек
интерфейса с PI Data Archive. По умолчанию
интерфейс синхронизирует кэш точек в случае
выполнения в режиме запуска в отключенном
состоянии. Чтобы отключить синхронизацию
файла кэша точек, укажите /cachesync=0.
Минимальное значение — 50 мс,
максимальное — 3000 мс (3 с). Значения,
которые меньше минимального или больше
максимального, соответствующим образом
корректируются. Это значение должно быть
меньше наименьшего периода scan class. Если
значение превышает наименьшее значение
scan class, то во время синхронизации файла
кэша точек входные сканирования
пропускаются.
По умолчанию: 250 мс
/cm=Option (Необязательно) Настройка связанного с

кластером поведения при реализации
отказоустойчивости уровня интерфейса в
кластере. Режим 0 (/cm=0) —
предпочтительный основной режим. Режим 1
(/cm=1) — непредпочтительный режим, где
любой экземпляр интерфейса, который
активен, остается активным до перехода на
резервный ресурс кластера.
Параметры: 0 или 1
/cn=tag_name (Необязательно) При реализации
отказоустойчивости уровня интерфейса в
кластере этот параметр задает строковую
точку PI Point, которая получает имя узла
экземпляра интерфейса, который в настоящее
время собирает данные. Эта функция
позволяет отслеживать узел кластера, который
является активным узлом интерфейса.
Убедитесь, что источник указанной точки не
используется ни одним интерфейсом.
/cs=tag_name (Необязательно) Точка PI Point, которая
отслеживает текущий активный сервер OPC в
целях отказоустойчивости. Убедитесь, что
источник указанной точки не используется ни
одним интерфейсом.


/da=option (Необязательно) Настраивает уровень
проверки подлинности по умолчанию — часть
настроек безопасности DCOM для интерфейса.
Этот параметр задает относящийся к
интерфейсу уровень проверки подлинности,
необходимый для проверки удостоверения
сервера OPC во время вызовов. Допустимы
следующие значения option:
• DEFAULT
• NONE
• CONNECT (по умолчанию)
• CALL
• PKT
• PKT_INTEGRITY
• PKT_PRIVACY
Используйте эту настройку с параметром di.
Если задать /di и пропустить /da,
используется CONNECT. Если не настроено ни
da, ни di, интерфейс использует разрешения
по умолчанию на клиентской машине.
По умолчанию: CONNECT
/bd=# (Необязательно) Задайте уровень выходных

данных отладки, которые записываются в
журнал. По умолчанию запись отладки в
журнал отключена. Допустимые настройки см.
в разделе Настройки отладки.
/dc (Необязательно) Отключите обратные вызовы
для групп polled, чтобы уменьшить рабочую
нагрузку сервера OPC. На группы advise не
оказывает никакого влияния. По умолчанию
обратные вызовы включены.
/df=tag_name (Необязательно) Настройте точку PI Point,
которая содержит уровень отладки и
позволяет переключать его во время работы
интерфейса. Настройте точку output Int32 для
интерфейса и задайте ей значение 0, затем
настройте точку с использованием параметра
df. После запуска интерфейса можно изменить
уровень отладки, настроив точку на нужный
уровень. Допустимые настройки см. в разделе
Настройки отладки.
Для instrumenttag обязательно необходимо
ввести значение, но это значение игнорируется
и не обязано являться допустимым
идентификатором ItemID OPC.


/di=level (Необязательно) Задает относящийся к
интерфейсу уровень олицетворения,
предоставляемый серверу OPC для выполнения
задач обработки от имени интерфейса.
Уровень олицетворения по умолчанию — одна
из настроек безопасности DCOM для
интерфейса. Допустимы следующие уровни
полномочий.
• ANONYMOUS
• IDENTIFY (по умолчанию)
• IMPERSONATE
• DELEGATE
Используйте с параметром da. Если указать
параметр /da и пропустить /di, по умолчанию
используется IDENTIFY. Если не задан ни один
параметр, интерфейс использует настройки
безопасности DCOM компьютера по
умолчанию.
По умолчанию: IDENTIFY
/dll=drive:\path\filename.dll (Необязательно) Настройте DLL-библиотеку

постобработки. Путь по умолчанию —
подкаталог PlugIns каталога установки
интерфейса. Настроить более одного
подключаемого модуля нельзя.
/dllconfig=config_file_name (Необязательно) Указывает путь к каталогу и
или имя файла конфигурации для DLL-библиотеки
постобработки (некоторые DLL-библиотеки
/dll_ini=config_file_name
постобработки не требуют файла
конфигурации).
/dt=tag_name (Необязательно) Укажите точку, для которой
будут записываться в журнал подробные
сведения при использовании подробного
уровня отладки. (/DB=64). Если опустить эту
настройку, то интерфейс использует первую
точку, для которой получает значение.
/ec=# (Необязательно) Укажите номер счетчика для

точки скорости ввода-вывода. Если требуются
несколько экземпляров интерфейса со
счетчиками событий, укажите по отдельному
номеру счетчика для каждого экземпляра. Эта
настройка должна соответствовать точке PI
Point в файле iorates.dat. Если указать /ec и
опустить аргумент, то счетчиком по
умолчанию будет 1. По умолчанию: /ec=1


/eg=group_name Необязательно. Используется для настройки
пользовательских имен групп событий.
используйте параметр /eg#=name. Например, /
eg1=MyEvent и /eg2=NextEvent указывают для
интерфейса использование имени MyEvent для
первой группы событий и имени NextEvent —
для второй.
Чтобы задать базовое имя для групп событий,
используйте параметр /eg=name. Если имя для
параметра /eg#=name, то именем этой группы
будет базовое имя, к которому добавляется
номер группы. Например, если /eg=EventGroup
и параметр /eg3 не указан, то третья группа
событий будет называться EventGroup3.
событий является Event. Если имена групп
событий не настроены, то группы событий
получат имена Event1, Event2, Event3 и т. д.
По умолчанию: /eg=Event
/er=hh:mm:ss (Необязательно) Задает запрошенную частоту

обновления для группы scan class событий.
(Все основанные на событиях точки
принадлежат к одной и той же группе.) Частота
обновления по умолчанию для группы
составляет одну секунду. Если кэш данных
сервера OPC для тегов на основе событий не
требует настолько частого обновления,
уменьшите рабочую нагрузку, указав более
низкую частоту.
Для серверов OPC версии 2.0 все операции
чтения событий осуществляются с устройства,
поэтому следует задать эту частоту высокой (/
er=24:00:00), если только не требуются более
частые обновления кэша по иным причинам.
По умолчанию: 00:00:01
/es=option (Необязательно) Для сервера OPC версии 1.0a

указывает, поступают ли операции чтения
тегов событий из кэша (CACHE) или с
устройства (DEVICE). Операции чтения с
устройства могут отрицательно влиять на
производительность сервера OPC.
Дополнительную информацию см. в разделе
Точки event.
По умолчанию: CACHE
/f=frequency[,offset] Определите scan class, укажите, как часто

сканируются данные в этом классе. Укажите
частоту сканирования и дополнительное
смещение, используя следующий формат:
HH:MM:SS.##,HH:MM:SS.##. Дополнительную
информацию см. в разделе Атрибут Scan class
(location4).


/fm=# (Необязательно) Настройте тип
отказоустойчивости уровня интерфейса.
Допустимы следующие варианты.
• 1: не создавать группы на сервере
• 2: создать неактивные группы и добавить
теги
• 3: создать активные группы, но не
рекомендовать группы
Конфигурация отказоустойчивости для
/ft=# (Необязательно) Указывает (в секундах) время,

в течение которого интерфейс пытается
подключиться к текущему серверу перед
переходом на резервный сервер, указанный
параметром backup. Если указано значение
меньше 30, то также задает, как часто
интерфейс проверяет состояние сервера. По
умолчанию (и при минимальном значении)
интерфейс проверяет состояние сервера
каждые 60 секунд.
/ga (Необязательно) Организует групповую

активацию так, чтобы снизить рабочую
нагрузку сервера OPC. Используйте в
сочетании со смещениями scan class.
/gi (Необязательно) Чтобы снизить нагрузку на

сервер OPC во время запуска, деактивирует
группы до тех пор, пока они не будут
построены.
/gl=Option (Необязательно) Исправление для некоторых

ранних серверов версии 1.0a. Если журнал
содержит сообщение об ошибке
OnDataChange: Invalid group ID,
попробуйте задать /gl=N.
По умолчанию: Y
/gs=Option (Необязательно) Исправление для старых, не

соответствующих требованиям серверов OPC,
которые не предоставляют допустимый
GroupStatus при асинхронных операциях
чтения. Если журнал содержит сообщение об
ошибке OnDataChange: Header status,
попробуйте задать /gs=N, чтобы указать
интерфейсу игнорировать параметры статуса
группы.
/host=host:5450 (Обязательно) Указывает хост и порт узла PI

Data Archive, на который интерфейс
отправляет данные. Host — имя узла хоста.


/hs=Option (Устарел) Запрос частоты обновления кэша в
половину от частоты сканирования для scan
class. Используйте вместо этого ur.
/hwps (Необязательно) Проверка относящихся к

Plantscape кодов ошибок элементов (Item)
0xE00483FD или 0xE00483FC, а в случае
нахождения — переход на альтернативный
сервер OPC.
/id=# (Необязательно) Указывает идентификатор
экземпляра интерфейса. Максимум девять
цифр. Необязательно, но настоятельно
рекомендуется.
/if=Option (Необязательно) Игнорировать первое
значение, отправленное для каждой точки. Для
использования с серверами OPC, которые
отправляют ответ при подключении
интерфейса к точке, независимо от того, имеют
ли они допустимое значение.
/is=Option (Необязательно) Игнорировать состояние,
возвращенное сервером OPC. Некоторые
серверы OPC не возвращают
OPC_STATUS_RUNNING при готовности. Если
интерфейс зависает при запуске, а средство PI
OPC Client отображает состояние сервера OPC,
отличное от RUNNING, задайте /is=Y и
сообщите о проблеме поставщику вашего
сервера OPC.
/it=Option (Необязательно) Чтобы усекать доли секунды
из меток времени, передаваемых в PI Data
Archive, и отправлять только целочисленные
значения секунд, задайте значение Y.
Сокращает потребление ресурсов ЦП и диска.
/ma=Option (Необязательно) По умолчанию интерфейс OPC
добавляет элементы в группы по одному, так
как некоторые серверы OPC отклоняют всю
группу, если один из элементов недопустимый.
Чтобы добавлять все элементы класса
одновременно, задайте значение Y.
Рекомендуется в целях эффективности, если
поддерживается сервером OPC.


/maxstoptime=# (Необязательно) Указывает, сколько секунд
выделяется интерфейсу на закрытие его
подключений и корректный выход.
По умолчанию: 120 с
/ni=# (Необязательно) Указывает количество

экземпляров интерфейса, работающих на узле.
Используется в сочетании с параметром ft для
определения длительности ожидания перед
инициированием перехода на резервный
ресурс на уровне сервера.
/nt=Option (Необязательно) Выполнять или не выполнять

запись I/O Timeout в точки PI Point при
разрыве соединения c сервером OPC. Задайте
значение Y, чтобы отключить запись.
/oc=# Максимальное количество незавершенных
операций вывода на группу. После выпуска
указанного количества операций записи
интерфейс ожидает подтверждения одной или
нескольких из них, прежде чем выполнять
какие-либо дополнительные операции записи.
/od=# (Необязательно) Уровень, на котором следует

начать сброс операций вывода. Если очередь
вывода для группы содержит указанное
количество операций вывода, интерфейс
сбрасывает самую старую или самую новую
операцию. Чтобы сбрасывалась самая новая
операция вывода, укажите положительное
значение. Чтобы сбрасывалась самая старая
операция вывода, укажите отрицательное
значение.
/og=# Количество групп output. Каждая группа имеет

собственную очередь.
/opcstopstat=system_digital_state (Необязательно) Чтобы указать, чтобы сбор

данных был остановлен при завершении
работы интерфейса, записывает цифровое
состояние в каждый входной тег. Если
цифровое состояние не указано, записывается
строка «I/O Timeout». Если цифровое состояние
указано, то оно должно быть допустимым
значением из набора системных цифровых
состояний.
ОСТОРОЖНО:
Не используйте параметр UniInt stopstat
с интерфейсом OPC. stopstat может
привести к сохранению недопустимых
значений в точках PI Point.
По умолчанию: "I/O Timeout"


/ot=# Максимальное количество значений точек для
записи за один раз.
/ou=group_name Необязательно. Используется для настройки

пользовательских имен групп output.
используйте параметр /ou#=name. Например, /
ou1=MyOutput и /ou2=NextOutput указывают
для интерфейса использование имени
MyOutput для первой группы output и имени
NextOutput — для второй.
Чтобы задать базовое имя для групп output,
используйте параметр /ou=name. Если имя для
параметра /ou#=name, то именем этой группы
номер группы. Например, если /
ou=OutputGroup и параметр /ou3 не указан, то
третья группа output будет называться
OutputGroup3.
output является Write. Если имена групп output
не настроены, то группы вывода получат
имена Write1, Write2, Write3 и т. д.
По умолчанию: /ou=Write
/outputsnaptime (Необязательно) Для тегов вывода

используйте метку времени из исходного
события, которое привело к выполнению
операции вывода. По умолчанию интерфейс
использует время получения нового значения
в качестве метки времени для хранения
выходных данных, после того как вывод был
завершен.
/outputacktime (Необязательно) Для меток времени тегов
вывода используйте время подтверждения, а
не метку времени события, которое привело к
выполнению вывода. Использует метку
времени из подтверждения записи сервером
OPC. Переопределяет outputsnaptime, если
включено.
/ow=# (Необязательно) Количество ожидающих
операций вывода, при котором в качестве
статуса устройства следует установить
предупреждение о том, что операции вывода
поступают быстрее, чем сервер OPC может их
обработать. Если указаны как ow, так и od, то
значение ow должно быть меньше od.


/pg=group_name Необязательно. Используется для настройки
пользовательских имен групп polled.
используйте параметр /pg#=name. Например, /
pg1=MyPolled и /pg2=NextPolled указывает для
интерфейса использование имени MyPolled для
первой группы polled и имени NextPolled — для
второй.
Чтобы задать базовое имя для групп polled,
используйте параметр /pg=name. Если имя для
параметра /pg#=name, то именем этой группы
номер группы. Например, если /pg=PolledGroup
и параметр /pg3 не указан, то третья группа
polled будет называться PolledGroup3.
polled является Poll. Если имена групп polled не
настроены, то группы polled получат имена
Poll1, Poll2, Poll3 и т. д.
По умолчанию: /pg=Poll
/pisdk=# (Необязательно) Включите (1) или отключите

(0) пакет PI SDK. Если он требуется интерфейсу
PI System, то пакет PI SDK включается и не
может быть отключен с помощью данной
настройки.
/pisdkcontimeout=# (Необязательно) Задайте количество секунд
для ожидания перед таймаутом вызовов PI
SDK.
/pr=# Настройте отказоустойчивый кластер для

экземпляра интерфейса:
• 0: без отказоустойчивого кластера (по
умолчанию)
• 1: основной экземпляр интерфейса
• 2: резервный экземпляр интерфейса
/ps=point_source (Необязательно) Указывает источник точки

для экземпляра интерфейса. Регистр не
учитывается. Экземпляр интерфейса
использует эту настройку для определения
точек PI Point, которые следует загрузить и
обновить.


/pw=password (Необязательно) Пароль для идентификатора
пользователя, указанного параметром sec.
Учитывается регистр.
ОСТОРОЖНО:
Добавление пароля в файл .bat
раскрывает этот пароль перед любым
пользователем, который может
прочитать файл .bat, и может
представлять риск безопасности. Список
управления доступом для файла .bat
должен отказывать в доступе на чтение
ко всем учетным записям за исключением
тех, которым следует знать пароль.
Дополнительные сведения о
безопасности см. в разделе
Рекомендуемые меры безопасности
/rd=# (Необязательно) Время в секундах, в течение

которого происходит ожидание перед
попыткой повторного подключения к серверу
OPC.
/rn=# (Необязательно) Указывает номер ресурса
службы APIonline, от которой зависит
интерфейс. Например, /rn=1 настраивает
интерфейс на зависимость от apionline1.
Обязателен при наличии нескольких
экземпляров PI Interface для OPC DA,
выполняющихся с разными именами служб на
одной и той же машине. Для настройки
отказоустойчивого кластера Windows.
/rp=# Указывает минимальный процент точек,
необходимый для принятия сервером OPC в
качестве допустимых. Если принято меньше
указанного процента, то интерфейс
устанавливает для себя статус устройства
Connected/No Data, вследствие чего
срабатывает механизм отказоустойчивости
UniInt, если он настроен.
/rt=# Только опрашиваемые scan class:

максимальное количество сканирований,
которые могут не возвращать данных, прежде
чем группа будет признана зависшей и
интерфейс установит для себя статус
устройства, предупреждающий о проблеме.
Минимум — 2 периода сканирования.
/sd=# (Необязательно) Указывает количество секунд

для ожидания после подключения перед
чтением точек OPC. По умолчанию после
подключения нет задержки.


/sec (Необязательно) Чтобы включить параметр
или безопасности NT стандарта OPC, укажите /sec
(опустите идентификатор пользователя). Если
/sec=userid
используется параметр частной безопасности
OPC, укажите идентификатор пользователя в
качестве этого параметра и пароль в качестве
параметра pw. Требует наличия сервера OPC,
который поддерживает безопасность OPC.
/server=host::name (Обязательно) Настраивает целевой сервер
OPC. Если сервер OPC работает на той же
машине, что интерфейс, опустите имя хоста и
двоеточия. Если имя сервера содержит
пробелы, заключите имя в двойные кавычки.
/sg=[S] (Необязательно) Отправлять только данные о
качестве GOOD. Спорные данные о качестве и
данные о качестве BAD игнорируются. Чтобы
проигнорировать вложенный статус для
значений, у которых имеется статус GOOD,
укажите /sg=s.
Чтобы интерпретировать
OPC_QUALITY_LOCAL_OVERRIDE как
SUBSTITUTED, укажите /sg. Чтобы
интерпретировать
OPC_QUALITY_LOCAL_OVERRIDE как GOOD,
укажите /sg=s.
Если также задан параметр /sq=I или /sq=y, то
спорные данные о качестве отправляются в PI
Data Archive. Данные о качестве BAD
игнорируются. Информация о качестве
продолжает передаваться на точки, которые
настроены на хранение качества вместо
значений.
/sin=node (Устарело) Указывает имя дополнительного
узла интерфейса для отказоустойчивого
кластера.
/sq=Option (Необязательно) По умолчанию интерфейс
хранит и помечает значения с неопределенным
качеством. Чтобы сохранять данные о качестве
вместо значений данных, которые не являются
GOOD, укажите /sq=Y. Чтобы сохранять спорные
данные, укажите /sq=I. Для данных о качестве
BAD интерфейс отправляет код цифрового
состояния в точку PI Point.
Параметры: Y или I


/st=tag_name (Необязательно) Настройте цифровую точку PI
Point для сохранения состояния сервера OPC
при его изменении. Убедитесь в наличии
набора цифровых состояний со следующими
состояниями.
1. OPC_STATUS_RUNNING
2. OPC_STATUS_FAILED
3. OPC_STATUS_NOCONFIG
4. OPC_STATUS_SUSPENDED
5. OPC_STATUS_TEST
Если сервер возвращает что-либо отличное от
одного из предшествующих состояний, 0
сохраняется. Настройте нулевое состояние для
этого набора состояний, в котором будет
отражаться нестандартный статус сервера.
/startup_delay=# (Необязательно) Настраивает задержку после

запуска. Интерфейс ожидает в течение
указанного периода перед началом работы.
Предназначается для использования в случае,
если настроен интерфейс для автозапуска, а
сетевому слою требуется время для
завершения запуска, прежде чем он станет
доступным. Если указать /startup_delay и
опустить задержку, будет настроена
тридцатисекундная задержка.
/sw=# (Необязательно) Указывает длительность (в

секундах) ожидания интерфейсом вхождения
сервера OPC в состояние OPC_STATUS_RUNNING.
Если по истечении указанного периода сервер
OPC не запущен, интерфейс переходит на
альтернативный сервер OPC.
/ta=#.# (Необязательно) Для точек advise PI Point
отправляется значение из предыдущего
сканирования, если метка времени нового
значения больше указанного количества
периодов сканирования. Включение этой
настройки вызывает такое же поведение тегов
advise, как и при включенном атрибуте Step.
/tf=format (Необязательно) Указывает формат строк
меток времени. Используется для точек с
location2 = 6 или 7, где ItemID — либо строка,
содержащая метку времени, либо значение
VT_DATE. Также используется для записи меток
времени вывода с использованием TIM= в поле
атрибута exdesc. Допустимые токены: cc, yy,
mn, mon, dd, hh, hr, mm, ss, 000, XM.
Корректировка меток времени.


/to=HH:MM:SS (Необязательно) Применяет смещение ко всем
меткам времени, поступающим с сервера.
Предоставляется для взаимодействия с
серверами и установками, которые не следуют
спецификациям OPC (например, где часовым
поясом должен быть UTC вне зависимости от
расположения сервера). Формат аналогичен
параметру периода сканирования (f). Перед
отрицательными смещениями ставится знак
минус.
/ts=Option (Необязательно) Указывает, поступают ли
метки времени с сервера OPC или применяются
интерфейсом при поступлении данных. По
умолчанию метки времени предоставляет
интерфейс (/ts=N)). Если сервер OPC может
предоставлять допустимые метки времени,
укажите /ts=Y. Если сервер OPC может
предоставлять допустимые метки времени
только для рекомендованных точек, укажите /
ts=A. Чтобы использовать только метки
времени, предоставленные сервером OPC, и не
применять смещения времени, укажите /ts=U.
Параметры: Y или N или A или U
/ufo_id=# (Обязательно для фазы 1 или 2 механизма
отказоустойчивости интерфейса UniInt)
Указывает идентификатор
отказоустойчивости. Должен быть
уникальным положительным целым числом.
/ufo_interval=# (Необязательно) Указывает частоту (в
миллисекундах) обновления точек пульса
отказоустойчивости (Heartbeat tag) и проверки
статуса интерфейса. Значение должно
совпадать на обоих узлах интерфейса.
Минимум: 50 Максимум: 600000 мс (10 минут)
По умолчанию для фазы 1 отказоустойчивости:
1000
По умолчанию для фазы 2 отказоустойчивости:
5000
/ufo_otherid=# Идентификатор отказоустойчивости другого

экземпляра интерфейса: Обязательно для фазы
1 или 2 отказоустойчивости уровня


/ufo_sync=path/[file_name] (Обязательно для фазы 2 отказоустойчивости
уровня интерфейса) Путь и (необязательно)
имя общего файла, содержащего состояние
отказоустойчивости. path может быть полным
именем узла и каталогом, буквой
подключенного диска или локальным путем,
если общий файл находится на узле
интерфейса. Значение path должно
заканчиваться символом косой черты или
обратной косой черты. Имя файла по
умолчанию:
executablename_pointsource_interfaceID.dat При
наличии пробелов в path или filename весь путь
и имя файла должны быть заключены в
кавычки. Если заключить путь в двойные
кавычки, то завершающая обратная черта
должна быть двойной обратной чертой \\.
/ufo_type=type (Обязательно для фазы 2 отказоустойчивости
уровня интерфейса) Указывает тип
конфигурации отказоустойчивости: HOT, WARM
или COLD.
/uht_id=# (Необязательно) Указывает уникальный

идентификатор для экземпляров интерфейса,
которые выполняются в избыточном режиме
без использования механизма
отказоустойчивости UniInt. Если указан
идентификатор, загружаются только точки
работоспособности с указанным значением в
location3.
/ur=HH:MM:SS.000 (Необязательно) Указывает запрашиваемую
частоту обновления для группы. По умолчанию
частота обновления, запрашиваемая для scan
class, совпадает с этой частотой. Частота
обновления применяется к периоду
сканирования, за которым она следует.
Например:
• /f=00:00:02 — частота обновления 2 с
• /f=00:00:03 /ur=00:00:00.5 — частота
обновления 0,5 с
• /f=00:00:01 — частота обновления 1 с
/us (Необязательно) Если текущий снэпшот
представляет собой системное цифровое
состояние, а новое значение старше снэпшота,
то интерфейс отправляет новое значение в PI
Data Archive через одну секунду после метки
времени снэпшота системного цифрового
состояния. Эта проверка не выполняется, если
текущий снэпшот является корректным
значением.
/uwq=# (Необязательно) Направляет экземпляр
интерфейса на резервный ресурс, если
указанное количество сторожевых точек не
имеют качества GOOD и, для серверов OPC
версии 2.0, если произошла ошибка чтения
сторожевых точек.


/vn=Option (Необязательно) Указывает версию сервера
OPC (v1.0a или V2.0).
/wd=# (Необязательно) При настройке
отказоустойчивости с использованием
нескольких сторожевых точек срабатывает
переход на резервный ресурс, если сумма
значений точек падает ниже указанного
значения.
/wd1=wd1tagname (Необязательно) Настройте сторожевые точки
и для отказоустойчивости. Дополнительные
сведения см. в разделе Состояние сервера и
/wd2=wd2tagname
сторожевых точек OPC.
/whitelist=path\filename Включает файл белого списка для точек output.
Указывает путь к файлу белого списка. Файл
белого списка задает список разрешенных
точек output и их атрибутов, которые
интерфейс использует для записи выходных
данных в источник данных.
/wq=# (Необязательно) При настройке
отказоустойчивости с использованием
нескольких сторожевых точек. Направляет
интерфейс на резервный ресурс, если
количество сторожевых точек с качеством,
отличным от GOOD, превышает указанное
значение (а также, для серверов версии 2.0, в
случае ошибки чтения элемента).
/ws=Option (Необязательно) Для отказоустойчивости
задайте значение 1, чтобы настроить
экземпляр на отключение от сервера, если
сервер выйдет из состояния
OPC_STATUS_RUNNING. По умолчанию
интерфейс остается подключенным.
Параметры по функциям
Параметры группируются по способу их использования и относятся к интерфейсу PI
Interface для OPC DA, за исключением параметров UniInt, общих для всех интерфейсов
OSIsoft на основе UniInt. В параметрах не учитывается регистр символов.

Общие параметры UniInt Расширенные параметры Обработка данных

/CACHEMODE /AM /AF
/CACHESYNC /AR /AS
/EC /AT /ER
/F /DC /HOST
/ID /ES /IF
/MAXSTOPTIME /GA /IT
/PISDK /GI /NT
/PISDKCONTIMEOUT /GL /OPCSTOPSTAT
/PS /GS /SG
/STARTUP_DELAY /HWPS /SQ
/WHITELIST /IS /TA
/MA /TF
/OC /TO
/OD /UR
/OG /US
/OT
/OUTPUTACKTIME
/OUTPUTSNAPTIME
/OW
/RD
/SD
Безопасность DCOM Подключаемые модули (DLL- Отладка

библиотеки постобработки)
/DA /DLL /DB
/DI /DLLCONFIG /DF
/DT

Отработка отказа на уровне Отработка отказа на уровне Отработка отказа на уровне

сервера интерфейса UniInt интерфейса
/BACKUP /UFO_ID /CM
/CS /UFO_INTERVAL /CN
/FT /UFO_OTHERID /FM
/NI /UFO_SYNC /PR
/SW /UFO_TYPE /RN
/WS /UWQ /UHT_ID
/WD /RP
/WD1 /RT
/WD2
/WQ
/WS
OPC Server Прочие

/Server /PW
/TS /SEC
/VN /ST


Устранение неполадок интерфейса PI Interface
для OPC DA
При устранении неполадок интерфейса или сервера OPC см. следующие разделы.
Открытие средства PI OPC Client Tool

Чтобы подключиться и просмотреть содержимое сервера OPC, воспользуйтесь
средством PI OPC Client Tool. Вы сможете протестировать процедуры обмена данными,
такие как sync read, refresh, advise и outputs, с помощью этого средства.
Процедура
1. Откройте средство PI OPC Client Tool одним из двух способов.
◦ Найдите и дважды щелкните исполняемый файл OPCClient.exe.
◦ В меню «Пуск» Windows выберите Программы > PI System > PI OPCClient.
Проблемы сервера OPC

Спецификация OPC обеспечивает значительную гибкость в проектировании серверов
OPC и определении диапазона поддерживаемой ими функциональности. Такие
вариации серверов OPC могут повлиять на пользователей PI Interface для OPC DA.
• Просмотр элементов
• Варианты меток времени сервера OPC
• Ненадежные значения
• Путь доступа
• Проблемы с данными, возвращаемыми сервером OPC
• Устранение неполадок работы сервера OPC
• Обновления OPC
Просмотр элементов
Чтобы иметь возможность сопоставить точки PI Point с элементами OPC, необходимо
иметь доступ к именам OPC. Но от сервера OPC не требуется поддержка просмотра
элементов. Если просмотр поддерживается, то можно воспользоваться средством PI OPC
Client для просмотра точек, распознаваемых сервером OPC.
Варианты меток времени сервера OPC

Серверы OPC отправляют метки времени одним из двух способов.

Устранение неполадок интерфейса PI Interface для OPC DA
• Отправка метки времени для последнего момента, когда значение и качество данных
прочитаны из устройства. В этом случае метка времени изменится, даже если
значение не изменилось.
• Отправка метки времени последнего изменения значения и качества данных. В этом
случае если данные не изменились, метка времени не изменится.
Необходимо назначить способ записи меток времени, настроив параметр метки
времени (ts) с использованием PI ICU.
Ненадежные значения
Когда клиент подключается к точке, некоторые серверы OPC возвращают значение
даже в том случае, если у сервера нет верного значения для этой точки. Некоторые
серверы сопровождают ненадежное значение состоянием GOOD, в результате чего это
значение отправляется в архив PI Data Archive.
Чтобы избавиться от ненадежных значений, с помощью служебной программы PI ICU
включите параметр Ignore First Value на странице Data Handling (/if=Y).
Путь доступа
В элементах OPC путь доступа предполагает, каким образом сервер может получить
доступ к данным. В стандарте OPC оговорено, что серверы могут запросить информацию
о пути для доступа к значению, но им запрещено требовать, чтобы оно было передано в
поле пути доступа. В соответствии со стандартом сервер OPC может игнорировать его,
но некоторым не соответствующим стандарту серверам OPC необходим путь доступа.
Например, RSLinx требует информации о пути в пути доступа или в составе ItemID в
следующем формате: [accesspath]itemid.
Если для сервера OPC требуется путь доступа, обратитесь к поставщику сервера OPC,
чтобы определить, как лучше настроить сервер с интерфейсом PI Interface для OPC DA.
Проблемы с данными, возвращаемыми сервером OPC

Сообщения об ошибках Unpack2 в локальном журнале сообщений PI Message Log могут
указывать на недопустимые данные. В некоторых случаях интерфейс PI Interface для
OPC DA может отправлять данные в PI Data Archive, а также записывать в журнал
ошибки Unpack2 для точки PI Point, поскольку сервер OPC отправляет значения
хорошего качества, когда это возможно, и коды ошибок, когда это невозможно.
Перемежающиеся сбои между сервером OPC и источником данных приводят к
сочетанию ошибок и значений.
Обычно в журнал заносятся следующие универсальные сообщения об ошибках:
In UnPack2 Tag MyPV.pv returns error 80020005: 80020005(Type mismatch)
In UnPack2 Tag MyPV2.pv returns error: The operation failed (80004005)
Следующие сообщения об ошибках указывают, что данные, полученные с сервера OPC,

содержали ошибки, а сервер OPC не вернул текстовое описание ошибки:
In UnPack2 Tag MyPV3.pv returns error : Unknown error(800482d2)
In UnPack2 Tag MyPV4.pv returns error E004823E: Unknown error (e004823e).
In UnPack2 Tag MyPV5.pv returns error E241205C: Unknown error (e241205c)
In UnPack2 Tag MyPV6.pv returns error E2412029: Unknown error (e2412029)

Для устранения таких связанных с данными неполадок рассмотрим следующие

причины и решения.
• Если возникают ошибки Unknown, обратитесь к поставщику сервера OPC и покажите

ему код ошибки, отображаемый в сообщении. Серверы OPC могут выдавать коды
ошибок, характерные для определенных поставщиков, и только поставщик сервера
OPC может объяснить, что они значат.
• Устранить неполадку может перезапуск сервера OPC.
• Ошибки Type mismatch указывают на несовместимые типы данных. Проверьте
наличие несоответствия между типом данных PI Data Archive и типом элемента OPC.
Проверьте настройки location2. Чтобы избежать неполадок с кэшем после
изменения типов данных, перезапустите интерфейс.
• Убедитесь, что тип данных точки PI Point может принимать диапазон значений,
отправляемых сервером OPC. Например, если точка PI Point определена как
двухбайтовое целое число, а сервер OPC отправляет значения, которые превышают
этот размер, возникает переполнение точки.
• Убедитесь, что типы данных элемента OPC и точки PI Point совместимы.
• Возможно, источник данных отправляет поврежденные данные на сервер OPC.
Проверьте наличие неполадок в сети, которые могут повреждать пакеты данных.
• Проверьте размер группы серверов OPC. Если scan class содержит больше точек, чем
разрешено в группе серверов OPC, то могут возникать ошибки Unpack2. См. в
документации по серверу OPC сведения об ограничениях на размер группы.
• Если точка является цифровой и данные могут быть считаны в точку string PI Point, а
базовой системой управления является Honeywell, то может возникнуть
необходимость в точном соответствии строк цифрового состояния в PI Data Archive
строке, сообщаемой системой DCS. Чтобы определить цифровые состояния,
перейдите к Honeywell Universal Station или GUS и рассмотрите каждый блок
контроллера (источник данных).
Устранение неполадок работы сервера OPC

Интерфейс PI Interface для OPC DA может записывать журнал взаимодействий с
сервером OPC в файлы opcresponse.log, opcscan.log и opcrefresh.log. Для
интерпретации сведений из этих файлов необходимо понимать базовую архитектуру
интерфейса. Интерфейс PI Interface для OPC DA имеет два рабочих потока.
• Поток PI System
Взаимодействует с PI Data Archive.
• Поток COM
Взаимодействует с сервером OPC.
Точки polled PI Point

Для точек polled PI Point интерфейс уведомляет поток PI System о наступлении времени
сканирования. Поток PI System начинает процесс сбора данных и регистрирует время,
номер группы и текущее значение флага в opcscan.log, а затем устанавливает флаг
(если флаг в opcscan.log не равен нулю, то последний вызов сервера не вернул
результатов до момента, когда интерфейс инициировал другой опрос, и вследствие
этого данные могли быть пропущены).
Когда поток COM обнаружил, что флаг установлен, он регистрирует время, номер
группы и идентификатор транзакции в файле opcrefresh.log и обращается к серверу

OPC для обновления. При получении синхронного отклика от сервера OPC он очищает
флаг.
Теперь сервер OPC может асинхронно отправлять данные в любой момент. Когда сервер
OPC отправляет данные в поток COM интерфейса, время, номер группы и
идентификатор транзакции записываются в opcresponse.log.
Точки advise PI Point

Для точек advise PI Point поток COM получает обратные вызовы только тогда, когда
данные с сервера OPC изменяют значение. Поэтому точки advise не создают записей в
файлах opcscan.log или opcrefresh.log, а в файле opcresponse.log регистрируются
только обратные вызовы данных. Точки advise можно идентифицировать в файле
opcresponse.log по номерам групп в диапазоне от 200 до 800.
Обновления OPC
Регистрация обновлений
Для регистрации обновлений OPC включите параметр отладки 8, в результате
интерфейс PI Interface для OPC DA создает три файла журнала: opcscan.log,
opcrefresh.log и opcresponse.log. Если интерфейс запускается как служба, то файлы
располагаются в каталоге %windows%/system32 (%windows%/sysWOW64 для 64-
разрядных систем). В противном случае файлы располагаются в рабочем каталоге
процесса интерфейса. Рабочий каталог не обязательно совпадает с каталогом,
содержащим файл .exe.
Когда интерфейс устанавливает флаг для сканирования, он записывает текущее время,
номер scan class и текущее значение флага сканирования в файле opcscan.log. Метка
времени в формате UTC (всемирное координированное время, переход на летнее время
не учитывается), в структуре FILETIME, записанной в 64-разрядном шестнадцатеричном
поле. Нижняя и верхняя половины поля транспонированы, и значение получается в
результате подсчета числа интервалов длительностью 10E-7 секунд (1 микросекунда)
начиная с 1 января 1601 г.
После регистрации данных интерфейс устанавливает флаг сканирования для группы, а
затем наступает очередь COM-потока. При выполнении циклического опроса интерфейс
записывает время, scan class и TransID, используемые в файле opcrefresh.log. Для
сервера версии v1.0a записывается TransID, который был возвращен при последнем
опросе группы. Для серверов версии v2.0 это действительное значение TransID,
возвращенное из сервера.
Когда интерфейс получает данные из сервера OPC, он регистрирует время, scan class и
TransID, полученные в файле opcresponse.log. Для точек advise никакие элементы не
записываются в файлы opcrefresh.log и opcscan.log. Обновляется только файл
opcresponse.log.
Метки времени в журналах PI Interface для OPC DA сохраняются в собственном формате,
что затрудняет чтение. Чтобы преобразовать метки времени в удобный для чтения
формат, используйте следующие программы, которые установлены в каталоге Tools,
вложенном в каталог интерфейса:
• opcscan.exe
• opcrefresh.exe
• opcresponse.exe
Чтобы запустить одну из этих программ из командной строки, укажите имена входного
и выходного файлов. Примеры:

> opcscan.exe opcscan.log scan.log

> opcrefresh c:\pipc\Interfaces\OPCInt\opcrefresh.log c:\temp\refresh.log
> tools\opcresponse opcresponse.log response.log
Служебные программы отображают метку времени в формате UTC, сопровождающую

данные, как необработанную, так и преобразованную, метку времени, преобразованную
к локальному времени, как необработанную, так и преобразованную, и время PI System,
переданное в архив PI Data Archive. Пример.
response.log 126054824424850000 2000/06/14 18:54:02.485 126054680424850000
2000/06/14 14:54:02.485 960994309.485001 2 1db8
Чтобы проверить метку времени, переданную из сервера OPC, обратитесь к этим

файлам журнала. Метка времени отсчитывается от 1 января 1600 г. в формате UTC,
поэтому, если вы видите даты около 1600 г., значит, сервер не посылает
действительные метки времени. Чтобы настроить интерфейс для создания меток
времени, когда он получает данные, используйте PI ICU для включения параметра
Interface Provides Timestamp на странице OPCInt (или измените пакетный (bat) файл и
укажите параметр /ts=N).
Если интерфейс функционирует с включенными параметрами отладки 32 или 64, то
файл журнала содержит записи для отдельных элементов данных, полученных COM-
потоков. Для точек advise номер группы в файле opcresponse.log может оказаться
неверным для записей, сформированных параметрами отладки 32 или 64, хотя более
короткие записи, сформированные параметром отладки 8, соответствуют верному
номеру группы.
Просматривая файлы журнала, можно увидеть, когда интерфейс начинает опрос, когда
выполняет вызов и когда поступили данные. Если флаг в opcscan.log отличен от нуля,
то последний вызов, направленный серверу, не вернул данных к моменту, когда
интерфейс начал новый опрос. Если в файле журнала обнаружены флаги, отличные от
нуля, обратитесь к поставщику сервера и попросите его обратиться в OSIsoft.
Но один сервер OPC не отвечает на вызовы обновления

Чтобы определить, отвечает ли сервер OPC на вызовы обновления от интерфейса,
проверьте наличие в локальном файле журнала сообщений PI Message Log следующее
сообщение:
The OPC server did not respond to the last refresh call for scan class 2, and has
not has not responded to the previous 100 refresh call(s).
Это сообщение указывает, что сервер OPC не ответил на вызов обновления. Эта
проблема возникает в том случае, когда сервер OPC не успевает за частотой обновления
или приостановил работу из-за ошибки. Сообщение повторяется для каждых 100 новых
вызовов обновления, которые получают ответы от сервера OPC для каждого scan class.
Если эти сообщения появляются в локальном журнале сообщений PI Message Log,
возможно, происходят потери данных. Немедленно обратитесь к поставщику сервера
OPC и попробуйте внести следующие корректировки, чтобы уменьшить нагрузку на
сервер OPC.
• Переместите точки в рекомендательный scan class 1.
• Сократите общее число scan class для интерфейса.
Сообщения об ошибках и информационные сообщения

для интерфейса PI Interface для OPC DA
События регистрируются следующим образом.

• Во время запуска. Сообщения включают в себя версию интерфейса, версию UniInt,

используемые параметры командной строки и количество точек.
• В процессе извлечения точек. События отправляются в журнал при наличии проблем
с конфигурацией точек.
• Если включена отладка.
Дополнительные сведения о журналах сообщений см. в разделе PI Universal Interface
(UniInt) User Guide.
Ведение журнала
Интерфейс PI Interface для OPC DA регистрирует сообщения об этой операции с
локальном файле журнала сообщений.
Записывается следующая информация.
• Сообщения о статусе запуска и завершения
• Частота сканирования, установленная для каждого scan class, и фактическая частота
обновления, обеспечиваемая сервером OPC
• Число точек PI Point в каждом scan class, точек output, а также тегов рекомендаций и
событий
• Неверно настроенные точки
• Точки, отвергнутые сервером OPC (и другие сообщения об ошибках от сервера OPC)
• Попытки подключения сервера OPC и результатов, в том числе потери подключения
Сообщения
Журнал содержит сообщения от интерфейса PI Interface для OPC DA, платформы UniInt и
PI API. В списке описаны только сообщения от интерфейса. Если сообщение об ошибке
имеет номер точки PI Point наряду с именем точки, то этот номер можно использовать
для идентификации проблемной точки, так как длинные имена точек усекаются до 12
символов.
Информационные
Сообщение No ConnectionPoint for OPCShutdown
Shutdown Advise Failed
Значение Сервер OPC не реализует интерфейс Shutdown
или реализует его некорректно. Не мешает
правильному функционированию интерфейса.
Сообщение QueryInterface:IID_IconnectionPointCont
ainer failed, using v1.0a protocol
Значение Сервер OPC не поддерживает OPC DA v2.0.
Сообщение GetStatus: Server has no current time.

Значение Указывает сервер, не соответствующий

стандарту OPC, который не передает время
суток. В соответствии со спецификацией OPC
сервер должен указывать текущее время,
передавая информацию о состоянии.
Интерфейс делает предположение о метках
времени, но его точность сомнительна.
Сообщение Cleaning up connections

Cleaned up connections
Значение Указывает, что интерфейс отключен и

выполняет выход.
Сообщение Server sent shutdown notice.

Значение Интерфейс получает уведомление о
выключении от сервера OPC. Интерфейс
периодически пытается заново подключиться
к серверу, пока не будет выключен или не
установит успешное соединение.
Сообщение Got %d and cleared it

ClearWrite: dwTransID mismatch, have
%d, got %d
Stashing transid %d
Sending transid %d
Writing transid %d
Значение Сообщения уровня отладки 4, указывающие,

что сервер подтвердил указанную операцию
записи и интерфейс может отправить другое
значение для записи. Переменная %d
представляет собой заполнитель для
десятичного целого значения.
Сообщение Can’t find status tag, ignoring

Can’t find queue tag, ignoring
Status tag is not Digital tag, ignoring
Queue tag is not Integer tag, ignoring
Значение Точка статуса/очереди не существует или

неверный тип данных.
Сообщение Can’t connect to OPC Server, going into

slow cycle wait
Значение Интерфейс попытался подключиться к серверу
OPC. Проверьте другие сообщения, которые
содержат сведения о причинах неудачной
попытки. Интерфейс периодически повторяет
попытки подключения.
Сообщение AddItems failed, server not in RUNNING

state, will try later

Значение Интерфейс ожидает перехода сервера OPC в

состояние RUNNING. Увидеть состояние
сервера можно с помощью средства PI
OPCClient (нажмите кнопку Get Status). Если
сервер не перешел в состояние RUNNING,
выясните причину.
Ошибки
Сообщение Out of Memory.
Cannot allocate a list; fails.
Unable to add tag.
Причина В системе недостаточно ресурсов.

Решение С помощью диспетчера задач Windows
проверьте задействованные ресурсы. Нажмите
клавиши Ctrl+Shift+Esc, чтобы открыть
диспетчер задач. Если opcint.exe занимает
много памяти, то возможно, что существует
узкое место между интерфейсом и PI Data
Archive. Постарайтесь найти связанные
сообщения в журнале (см. также Running low
on memory, dropping data).
Сообщение CLSIDFromProgID
Причина Недопустимый элемент реестра OPC Server.
Решение Проверьте инструкции по установке сервера.
Сообщение CoCreateInstanceEx
Причина Указывает на проблему с конфигурацией
DCOM.
Решение Проверьте настройки DCOM.
Сообщение IOPCServer
Причина Файлы прокси — заглушки не
зарегистрированы.
Решение Для регистрации файлов opcproxy.dll и
opccomn_ps.dll необходимо использовать
учетную запись администратора. Откройте
окно командной строки, перейдите в каталог, в
котором установлены DLL-файлы, и выполнить
следующие команды:
>regsvr32 opcproxy.dll
>regsvr32 opccomn_ps.dll
Сообщение AddRef
Причина Указывает, что сервер OPC не позволяет
интерфейсу выполнить простейшую функцию.

Решение Если удается выполнить считывание и запись

точек с помощью PI OPCClient, но в журнале
регистрируется эта ошибка, то проверьте
настройки DCOM. Проверьте, с какой учетной
записью пользователя запускается интерфейс.
Попробуйте запустить его в интерактивном
режиме.
Сообщение Advise returns error: 80040202(Unable

to open the access token of the current
thread)
Причина Если возникает эта ошибка после успешного
подключения к серверу, то, возможно,
загружен неверный opcproxy.dll.
Решение Если имеется несколько экземпляров
opcproxy.dll на узле интерфейса (возможно,
потому что на сервере размещено более одного
сервера OPC), убедитесь, что они имеют одну и
ту же версию. Надежнее всего иметь в системе
всего одну версию (в каталоге \%windows%
\system32 или %windows%\sysWOW64).
Проверьте, указаны ли в системном пути
каталоги, содержащие старые версии.
Сообщение AddGroup failed for scanclass %d

AddItem failed for %s
AddItems failed for tag %s
Advise Group failed for %s
Advise returns E_OUTOFMEMORY
Advise returns E_UNEXPECTED
Advise returns error
No ConnectionPoint for scanclass %d
QueryInterface:IID_IdataObject failed
for scanclass %d
QueryInterface:IID_IOPCAsyncIO2 failed
for scanclass %d
Read: (string)
Refresh: (string)
Unable to add to group
Unable to add to OPC group.
Unable to advise event group
Unable to advise group
Unable to advise output group
Unable to create group
Write error %X for tag
Write failed
Причина Ниже приведены неустранимые ошибки,

возвращаемые сервером OPC.

Решение Попробуйте выполнить ту же операцию с

помощью PI OPCClient. В случае успеха
запустите интерфейс в интерактивном режиме,
чтобы проверить, возникает ли та же ошибка. В
случае успеха проверьте конфигурацию DCOM,
чтобы убедиться, что предоставлены
необходимые разрешения учетной записи
INTERACTIVE. c0040004: Указывает, что
запрошенный тип данных не может быть
возвращен для этого элемента. С помощью PI
OPCClient добавьте этот элемент в группу,
опустив тип данных. Сервер отправит значения
с использованием типа данных, который
используется внутри сервера для этого
элемента. c0040007: Возвращается из AddItem,
указывает, что данный элемент отсутствует на
сервере. Убедитесь, что поле instrumenttag
для точки PI Point в точности соответствует
имени элемента OPC. С помощью PI OPCClient
попробуйте добавить элемент в группу, а если
сервер OPC поддерживает обзор, перейдите к
элементу и дважды щелкните его, чтобы
отобразить его полное имя.
Сообщение Invalid read/write mode requested for

tag %s
Причина Сервер возвращает неверную информацию о
доступе для чтения-записи.
Решение Чтобы интерфейс игнорировал эту
информацию, укажите параметр /ar=N.
Сообщение RemoveItem failed for tag %s

dev_remove_tag: Unable to unadvise %s
dev_remove_tag: Unable to remove group
%s
Причина Сервер не удаляет элемент из группы или не

прекращает сбор данных для группы.
Решение Несущественная проблема, если не
сопровождается большим числом других
сообщений, но указывает на какие-то
неполадки сервера OPC.
Сообщение Write unable to get values:

Getsnapshotx error %d
Причина Интерфейс не мог считать значение из PI

System для записи на сервер OPC.
Решение Чтобы удостовериться, что PI Data Archive
запущен, используйте apisnap (в каталоге
API). Убедитесь, что типы и значения данных
источника и назначения совместимы.

Сообщение Event Point has invalid scan class (!=

0)
No Item name – instrumenttag and exdesc
both empty
Nonzero Totalcode requires nonzero
Convers
Point cannot be write and Read On
Change
Point has invalid scan class
Point has invalid scan class (== 0)
ROC Point has invalid scan class (= =
0)
Square root must be 0, 1 or 2
This Totalcode requires Dzero to be
specified.
Total must be 0,1,2,3,4, or 5
Unable to get point type
Unable to get source point type.
Unable to get square root
Unable to get total specs
Причина Указывает, что точка PI Point настроена

неверно.
Решение Проверьте конфигурацию точки, особенно
указанный атрибут.
Сообщение GetStatus
Причина Сервер OPC не отвечает на запрос состояния.
Он может быть неисправен или отключен.
Решение С помощью PI OPCClient проверьте статус.
Сообщение Interface failed to write some %s

states
Причина При завершении работы сервера OPC
интерфейс отправляет сообщения о состоянии
завершения каждой точке, если он настроен
соответствующим образом (/opcstopstat).
Это сообщение об ошибке указывает, что
интерфейс не смог передать все или часть из
них из-за отсутствия буферизации или
подключения к PI Data Archive.
Решение Возможно, придется вручную ввести цифровое
состояние для соответствующих точек, чтобы
указать, что интерфейс завершает работу.

Сообщение OnDataChange:Invalid group ID < 0

OnDataChange:Invalid advise group ID:
OnDataChange:Invalid group ID > 999
OnDataChange: Header status:
OnDataChange has format not Hglobal
OnDataChange:Invalid group ID for write
completion
Unknown access type for group %s
Причина Указывает, что сервер отправляет

бессмысленные данные.
Решение Чтобы игнорировать поле состояния заголовка
во входящих данных, укажите. /gs=N.
Обратитесь к поставщику сервера OPC. С
помощью PI OPCClient создайте группы и
попробуйте воспользоваться Advise и
AsyncRead. Проверьте правильность входящих
данных. Бессмысленные данные могут не
влиять на сбор данных.
Сообщение OnDataChange: Bad Timestamp

Причина Интерфейс получил неверную метку времени с
данными из сервера OPC.
Решение Проверьте сервер OPC и отобразите метки
времени с помощью PI OPCClient.
Сообщение Invalid timestamp for tag: %s, %d and

%.36f
Причина Интерфейс получил неверную метку времени с
данными из сервера OPC. Указывает на
проблему с сервером OPC.
Решение Используйте PI OPCClient для отображения
нужного элемента. Воспользуйтесь Refresh,
Advise или AsyncRead для просмотра метки
времени.
Сообщение Putsnap system error %d, %d

Putsnap no longer in system error %d,
%d
Причина Системная ошибка указывает на проблему с

отправкой данных в архив PI Data Archive.
Решение Если ошибка не повторяется, то
предпринимать никакие действия не
требуется.
Сообщение Putsnapsx not implemented %d

Getsnapshotx not implemented
Причина Указывает на устаревшую версию PI API.

Решение Обновите версию PI API.
Сообщение Unable to translate string.

Причина Попытка преобразовать строковое значение

ASCII из точки PI Point в формат Юникод
завершилась неуспешно.
Решение Проверьте значение точки.
Сообщение Unable to initialize server object

Причина Привилегии не предоставляют доступа.
Решение Убедитесь, что учетная запись имеет
достаточные привилегии.
Сообщение No OPC Server specified

Причина Параметр server указывает несуществующий
сервер, или вызов присутствует на нескольких
строках.
Решение Убедитесь, что в пакетном файле запуска
интерфейса указан параметр server, а вызов
представлен одной строкой.
Сообщение Unable to create clock drift timer

Причина Интерфейс не может создать таймер для
отслеживания дрейфа.
Решение Проверьте системные ресурсы.
Сообщение Running low on memory, dropping data

Memory load within acceptable limits,
resuming data collection
Причина Если архив PI Data Archive не может принять

данные так же быстро, как интерфейс
отправляет их, то интерфейс буферизует
данные в памяти. Чтобы избежать захвата всей
доступной памяти, интерфейс начинает
отбрасывать данные при приближении
ограничений, заданных в hq и lq.
Решение Попробуйте выделить системе PI System
больше ресурсов, изменив параметры
исключения точек или изменив период их
сканирования.
Сообщение Failed to open cluster: error ####.

Intf-failover will not be supported.
Failed to open cluster resource: error
####. Intf-failover will not be
supported.
Причина Код ошибки Win32 , указывающий, что

попытка открыть службу кластера или ресурс
завершилась неуспешно.
Решение Проверьте параметры кластера.
Критические ошибки
Сообщение Error from CoInitialize:
Error from CoInitializeSecurity:

Причина Возможно, COM неправильно установлен в

системе.
Решение Если это так, то это серьезная проблема.
Сначала проверьте настройку COM. Возможно,
потребуется обращение в службу технической
Сообщение Cannot get PI Server time.

Причина Не удается подключиться к архиву PI Data
Archive.
Решение Для вновь установленной системы выполните
перезагрузку и проверьте возможность
подключения к архиву PI Data Archive. Чтобы
проверить подключение, ping машину PI Data
Archive. Чтобы удостовериться, что архив PI
Data Archive запущен, выполните apisnap. Для
существующих установок обратитесь в службу
технической поддержки OSIsoft.
Сообщение OnDataChange: VariantCopy

Причина Указывает, что сервер отправил
бессмысленные данные. Интерфейс отвергает
данные и записывает BADSTAT в точку. Метка
времени исправна.
Решение Проверьте данные с использованием PI
OPCClient.
Системные ошибки и ошибки PI System

Номера системных ошибок положительные. Номера ошибок PI System отрицательные.
Чтобы показать описания системных ошибок и ошибок PI System, используйте
служебную программу pidiag :
\PI\adm\pidiag -e error_number
Сообщения UniInt, относящиеся к отработке отказа

Информационные
Сообщение 16-May-06 10:38:00 OPCInt 1> UniInt failover: Interface in the
“Backup” state.
Значение После запуска интерфейса первоначально переход совершается в резервное
состояние. В этом состоянии интерфейс отслеживает состояние другого
интерфейса, участвующего в отработке отказа. При настройке горячей
отработки отказа данные, полученные от источника данных, записываются в
очередь и не пересылаются в архив PI Data Archive, пока существует это
состояние. Объем данных, записанных в очередь, пока существует это
состояние, определяется интервалом обновления при отработке отказа. Как
правило, в один момент времени в очереди находятся данные не более чем
для двух интервалов обновления. Некоторые последовательности переходов
могут привести к тому, что в очереди будут содержаться данные из пяти
интервалов обновления при отработке отказа.


“Primary” state and actively sending data to PI. Backup
interface not available.
Значение В основном состоянии интерфейс отправляет данные в архив PI Data Archive
по мере их приема. Это сообщение также указывает на то, что в отработке
отказа не принимает участия резервный интерфейс.

“Primary” state and actively sending data to PI. Backup
interface available.
Значение В этом состоянии интерфейс отправляет данные в архив PI Data Archive по
мере их приема. Это сообщение также указывает, что другая копия
интерфейса готова принять роль основной.
Сообщения об ошибках (фазы 1 и 2)

Сообщение 16-May-06 17:29:06 OPCInt 1> One of the required Failover
Synchronization points was not loaded. Error = 0: The Active ID
synchronization point was not loaded. The input PI tag was not
loaded.
Причина Неверно настроен тег Active ID.
Решение Проверьте правильность атрибутов точек. Проверьте, присвоено ли атрибуту
location1 значение параметра id интерфейса. Все теги отработки отказа
должны иметь идентичные атрибуты pointsource и location1. По
необходимости измените атрибуты точки и перезапустите интерфейс.
Сообщение 16-May-06 17:38:06 OPCInt 1> One of the required Failover

Synchronization points was not loaded. Error = 0: The Heartbeat
point for this copy of the interface was not loaded. The input
PI tag was not loaded.
Причина Неверно настроен тег пульса отказоустойчивости (Heartbeat tag).
Сообщение 17-May-06 09:06:03 OPCint > The UniInt FailOver ID (/UFO_ID)

must be a positive integer.
Причина Параметру ufo_id не присвоено положительное целочисленное значение.
Решение Измените параметр и проверьте, имеет ли он положительное целочисленное
значение, а затем перезапустите интерфейс.
Сообщение 17-May-06 09:06:03 OPCInt 1> The Failover ID parameter (/UFO_ID)

was found but the ID for the redundant copy was not found
Причина Параметр ufo_otherid не определен, или ему не присвоено положительное
целочисленное значение.
Решение Измените параметр ufo_otherid проверьте, имеет ли он положительное
целочисленное значение, и перезапустите интерфейс.
Ошибки (фаза 1)
Сообщение 17-May-06 09:06:03 OPCInt 1> UniInt failover: Interface in an
“Error” state. Could not read failover control points.

Причина Контрольные точки на источнике данных возвращают ошибочное значение в

интерфейс. Причиной этой ошибки может быть создание
неинициализированной контрольной точки на источнике данных. Это
сообщение возникает только в том случае, если интерфейс настроен для
синхронизации через источник данных (фаза 1).
Решение Проверьте правильность значений контрольных точек на источнике данных.
Сообщение 16-May-06 17:29:06 OPCInt 1> Loading Failover Synchronization

tag failed Error Number = 0: Description = [FailOver] or
HeartBeat:n] was found in the exdesc for Tag Active_IN but the
tag was not loaded by the interface. Failover will not be
initialized unless another Active ID tag is successfully loaded
by the interface.
Причина Неверно настроен тег Active ID или тег пульса отказоустойчивости (Heartbeat
tag). Это сообщение возникает только в том случае, если интерфейс настроен
для синхронизации через источник данных (фаза 1).
Сообщение 17-May-06 09:05:39 OPCInt 1> Error reading Active ID point from
Data source Active_IN (Point 29600) status = -255
Причина Значение точки Active ID на источнике данных вызвало ошибку при
считывании интерфейсом. Значение, считанное из источника данных,
должно быть действительным. После получения этой ошибки интерфейс
переходит в состояние «Backup in Error state».
Решение Проверьте правильность значения точки Active ID на источнике данных.
Сообщение 17-May-06 09:06:03 OPCInt 1> Error reading the value for the
other copy’s Heartbeat point from Data source HB2_IN (Point
29604) status = -255
Причина Значение точки пульса отказоустойчивости (Heartbeat tag) на источнике
данных вызвало ошибку при считывании интерфейсом. Значение, считанное
из источника данных, должно быть действительным. После получения этой
ошибки интерфейс переходит в состояние «Backup in Error state».
Решение Проверьте правильность значения точки пульса отказоустойчивости
(Heartbeat tag) на источнике данных.
Сообщения об ошибках (фаза 2)

Сообщение 27-Jun-08 17:27:17 PI Eight Track 1 1> Error 5: Unable to create
file ‘\\georgiaking\GeorgiaKingStorage\UnIntFailover\
\PIEightTrack_eight_1.dat’ Verify that interface has read/write/
create access on file server machine. Initializing uniint
library failed Stopping Interface
Причина Интерфейс не может создать новый файл синхронизации отработки отказа
при запуске. Создание файла происходит при первом запуске любой копии
интерфейса, если файл не существует. Чаще всего выдается номер ошибки 5.
Ошибка 5 «Доступ запрещен», вероятно, вызвана проблемой с разрешениями.
Решение Проверьте, имеет ли учетная запись, с которой работает интерфейс,
разрешения на чтение и запись для каталога. Установите список управления
доступом для каталога на доступ на чтение/запись/создание для учетной
записи, с которой работает интерфейс.

Сообщение Sun Jun 29 17:18:51 2008 PI Eight Track 1 2> WARNING> Failover
Warning: Error = 64 Unable to open Failover Control File ‘\
\georgiaking\GeorgiaKingStorage\Eight\PIEightTrack_eight_1.dat’
The interface will not be able to change state if PI is not
available
Причина Интерфейс не может открыть файл синхронизации отработки отказа.
Отработка отказа интерфейса продолжает работать корректно, если связь с
архивом PI Data Archive не прервана. Если связь с архивом PI Data Archive
прервана, то, пока один или оба интерфейса не имеют доступа к файлу
синхронизации, интерфейсы останутся в том состоянии, в котором они
находились во время второго отказа: основной интерфейс остается
основным, а резервный — резервным.
Решение Проверьте, имеет ли учетная запись, с которой работает интерфейс,
разрешения на чтение и запись для каталога. Установите список управления
доступом для каталога на доступ на чтение/запись/создание для учетной
записи, с которой работает интерфейс.


Техническая поддержка и другие ресурсы
Обратиться за помощью в отдел технической поддержки OSIsoft можно по телефону + 7
495-269-6144 (на английском языке +1 510-297-5828) или на странице контактов
службы технической поддержки OSIsoft (https://techsupport.osisoft.com/Contact-Us/). На
веб-сайте приведены дополнительные варианты обращения в службу поддержки для
клиентов, находящихся за пределами Соединенных Штатов.
При обращении в техническую поддержку OSIsoft будьте готовы предоставить
следующую информацию:
• название продукта, его версию и номера сборок;
• сведения о компьютере (тип процессора, название и номер версии операционной
системы);
• время возникновения неполадки;
• соответствующие файлы журналов;
• подробные сведения обо всех изменениях среды перед возникновением неполадки;
• краткое описание проблемы, включая все соответствующие файлы журналов.
Чтобы ответить на вопросы других пользователей программного обеспечения OSIsoft,
вступите в сообщество OSIsoft — PI Square (https://pisquare.osisoft.com). Участники
сообщества могут запрашивать советы и делиться идеями о системе PI System. Клуб
разработчиков PI (PI Developers Club) в рамках PI Square предоставляет ресурсы для
помощи в программировании и интеграции продуктов OSIsoft.

Техническая поддержка и другие ресурсы

Интерфейс PI Interface Для OPC DA 2.6. Руководство Пользователя

Загружено:

Сведения о документе

Авторское право

Доступные форматы

Поделиться этим документом

Поделиться или встроить документ

Параметры публикации

Этот документ был вам полезен?

Это неприемлемый материал?

Авторское право:

Доступные форматы

Интерфейс PI Interface Для OPC DA 2.6. Руководство Пользователя

Загружено:

Авторское право:

Доступные форматы

Интерфейс PI Interface для OPC DA 2.

Руководство пользователя по PI Interface для OPC DA 2.6

Введение в интерфейс PI Interface для OPC DA..................................................... 1

Установка интерфейса PI Interface для OPC DA.....................................................7

Обзор конфигурации интерфейса PI Interface для OPC DA................................... 9

Работа интерфейса PI Interface для OPC DA........................................................61

Справочник PI ICU для интерфейса PI Interface для OPC DA................................ 63

Руководство пользователя по PI Interface для OPC DA 2.6 iii

Параметры командной строки для интерфейса PI Interface для OPC DA.............. 75

Устранение неполадок интерфейса PI Interface для OPC DA............................... 95

Техническая поддержка и другие ресурсы........................................................113

iv Руководство пользователя по PI Interface для OPC DA 2.6

Настройки оборудования для интерфейса PI Interface для

Руководство пользователя по PI Interface для OPC DA 2.6 1

Следующая конфигурация размещает сервер OPC на собственном компьютере.

Обзор операций интерфейса PI Interface для OPC DA

1. Подключается к архиву PI Data Archive (если не настроен запуск в отключенном

2 Руководство пользователя по PI Interface для OPC DA 2.6

Руководства, связанные с интерфейсом PI Interface для

• PI Universal Interface (UniInt) User Guide

• DCOM Security and Configuration Guide

• PI OPC Client User's Guide

• PI Server System Management Guide

• Configuring PI Server Security

• High Availability Administrator Guide

• PI SDK and PI API Online Help Files

• PI API Installation Instructions User Guide

• PI Buffering Manager Help Files

• PI Interface Configuration Utility User Guide

• Ведение журналов интерфейсов

Руководство пользователя по PI Interface для OPC DA 2.6 3

поздних версий (http://techsupport.osisoft.com/techsupport/nontemplates/KB/

• Примечания к выпуску интерфейса

• Data Access Custom Interface Standard v2.05a

Средства, связанные с интерфейсом PI Interface для OPC

• Клиентское средство PI OPC Client Tool

• Средство OPC to CSV

• Средство OPC Enum

• Программа настройки интерфейса PI Interface (PI ICU)

Функции, поддерживаемые интерфейсом PI Interface для

4 Руководство пользователя по PI Interface для OPC DA 2.6

Совместимые операционные системы

Выходные данные из архива PI Data Archive Да

Поддерживает сомнительный бит Да

Руководство пользователя по PI Interface для OPC DA 2.6 5

Последовательный интерфейс Нет

6 Руководство пользователя по PI Interface для OPC DA 2.6

Требования для установки

Местоположение каталога и файлов установки

Руководство пользователя по PI Interface для OPC DA 2.6 7

Установка интерфейса PI Interface для OPC DA

8 Руководство пользователя по PI Interface для OPC DA 2.6

Контрольный список настройки для интерфейса PI

Руководство пользователя по PI Interface для OPC DA 2.6 9

a. Настройка службы Windows.

◦ Точки Performance Point и значения степени исправности

◦ Запуск без соединения с сетью (Disconnected startup)

10 Руководство пользователя по PI Interface для OPC DA 2.6

Настройка запуска интерфейса

Создание и настройка экземпляра интерфейса

▪ Источник точки (Point Source)

Руководство пользователя по PI Interface для OPC DA 2.6 11

◦ Вкладка Security Parameters

Управление подключением серверов