Справка по APC

APC - сокращение от APC Smart-UPS

Документация: Worksheet/.

APC - это встраевымый драйвер источника бесперебойного питания серии моделей Smart-UPS от производителя APC

Возможности системы:

Управление устройством (вкл./откл., выполнение тестирования);
Измерение входного напряжения;
Измерение выходного напряжения;
Измерение частоты входного напряжения;
Измерение температуры устройства;
Измерение заряда аккумулятора;
Измерение нагрузки;
Измерение входного напряжения;
Измерение напряжения аккумулятора;
Мониторинг состояния устройства;
Протоколирование результатов измерений;
Организация удаленного управления при помощи технологии DIM;
Возможность удаленного управления от сторонних клиентов при помощи технологии DIM.

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

Для именования кривых, тегов, сенсоров, окон и других программных объектов используются следующие соглашения о наименовании:

   Система:
    DEMO - Название система
   Подсистема 1:
    APC - Тип устройства
   Подсистема 2:
    S1 - Индекс устройства
   Параметры:
    POLL_EN - Enable Poll UPS             - Включение опроса устройства
    ENABLE  - Button "Enable/Disable UPS" - Вкл./Выкл. устройство
    TEST    - Button "Test UPS"           - Провести тестирование устройства
    UOUTSTT - Indicator state UPS         - Индикатор состояния устройства "От сети"
    UBATSTT - Indicator state UPS         - Индикатор состояния устройства "От батареи"
    OVERSTT - Indicator state UPS         - Индикатор состояния устройства "Перегрузка"
    LOWSTT  - Indicator state UPS         - Индикатор состояния устройства "Низкий заряд"
    REPBAT  - Indicator state UPS         - Индикатор состояния устройства "Замена батареи"
    STATUS  - Status UPS                  - Статус устройства
    INDIC   - Result last indicator test  - Результат теста индикаторов
    ITSELF  - Result last itself test     - Результат самотестирования
    NAME    - Name device                 - Имя устройства
    UINP    - Input Voltage 220V          - Входное напряжение
    FREQ    - Input Frequency, Hz         - Частота входного напряжения
    UOUT    - Output Voltage              - Выходное напряжение
    UBAT    - Output Battery Voltage      - Выходное напряжение от батареи
    VBAT    - Battery Voltage             - Номинальное напряжение батареи
    CBAT    - Battery Charge,             - Заряд батареи
    POUT    - Output load,                - Нагрузка устройства
    TEMP    - Temperature UPS, Celsium    - Температура устройства
    STATE   - State UPS                   - Состояние устройства
    POLL    - PollRate                    - Скорость опроса устройства
   Например:
    DEMO.APC.S1.POLL_EN - Enable Poll UPS

Если драйвер не внедряется в систему, то уровень "Система" допускается пропустить.

Кофигурирование драйвера

Так как данный драйвер является встраевымым, подразумевается, что драйвер будет работать в какой либо системе для которой уже были созданы дериктории и первоначальные файлы системы. Поэтому, для более удобной работы рекомендуется сначала сконфигурировать Daq-систему при помощи инструмента DaqCreator. Для этого следует выполнить следущий алгоритм действий:

Запустить Crw32.exe
Открыть вкладку "Инструменты"
Во вкладке выбрать "Консольные утилиты..."
В открывшемся окне перейти на вкладку "DAQ"
В выбранной вкладке выбрать "DAQ Creator"
В открывшемся окне выбрать дерикторию, где будет храниться система
Ввести название системы
Добавить описание (не обязательно)
Нажать кнопку "Exec"

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

Дальнейшее конфигурирование системы производится при помощи конфигурационного файла apc_devices.cmd. Его необходимо скопировать в дерикторию "Config" вашей системы. Затем сокпированный файл необходимо открыть в текстовом редакторе и найти строки настройки устройства:
Пример:

    rem  Device      Facility DevName Identitier Simulator Port  Baudrate Parity DataBits StopBits DevLabel
    call :APC_COM    DEMO     APC     S1         0         1     2400     NONE   8        1        S1
    call :APC_COM    DEMO     APC     S2         0         2     2400     NONE   8        1        S2
    rem   Device     Facility DevName Identitier Simulator TCPPort IPClient      Polling Priority       TxSize RxSize Timeout Label
    call :APC_TCP    DEMO     APC     S3         0         5300    192.168.0.110 1000    tpTimeCritical 16384  32768  1000    S3
    call :APC_TCP    DEMO     APC     S4         0         5301    192.168.1.31  1000    tpTimeCritical 16384  32768  1000    S4
    call :APC_TCP    DEMO     APC     S5         0         5302    192.168.1.31  1000    tpTimeCritical 16384  32768  1000    S5
    call :APC_TCP    DEMO     APC     S6         0         5303    192.168.1.31  1000    tpTimeCritical 16384  32768  1000    S6

В столбце "Device" указывает тип устройства :APC_COM или :APC_TCP. В действительности тот или иной выбор вызывает для разных алгоритма конфигурирования, где :APC_COM - алгоритм конфигурирования для соединения через COM-порт по интерфейсу RS232, :APC_TCP - алгоритм конфигурирования для соединения с устройством через преобразователь интерфейсов TCP-RS232 (например: ADAM-4570).

В столбце "Facility" указывается название системы. В данном случае это DEMO. Если данную систему планируется использовать в качестве подсистемы, то название системы следует указать в формате "NAMESYSTEM.DEMO".

В столбце "DevName" указывается имя устройства. Так как в данном конфигураторе используются устройства SRS Delay Generator DG645, то рекомендуется оставить данный столбец неизменным.

В столбце "Identifire" указывается конфигурационный идентификатор устройства. Идентификатор для каждого устройства должен быть уникален воизбежании конфликта работы драйверов.

В столбце "Simulator" указывается режим работы драйвера - 0 = Driver, 1 = Simulator.

Для :APC_COM, в столбцах "Port", "Baudrate", "Parity", "DataBits", "StopBits" указываются параметры COM-порта, к которому будет подключено устройство.

Для :APC_TCP:

В столбце "TcpPort" необходимо TCP-порт для обмена данных с устройством (обычно указывается в инструкции по эксплуатации к устройству, либо в параметрах устройства).

В столбце "IPClient" указывается IP-адрес устройства.

В столбце "Polling" указывается скорость пробуждения потока канала связи.

В столбце "Priority" указывается приоритет потока канала связи. Данный параметр может иметь следующие значени:

tpIdle - самый низший приоритет. Рекомендуется для вычислительных потоков, которые выполняют длительные вычисления. Чтобы они не мешали выполнению других потоков, им дается самый низший приоритет. Низкоприоритетный поток будет выполняться, только пока система не занята. При высокой загрузке процессора выполнение потока может задерживаться на неопределенное время.
tpLowest - низкий приоритет.
tpLower - приоритет ниже среднего.
tpNormal - средний приоритет. Такой приоритет имеет основной поток программы, где выполняются команды пользователя и отображение графики.
tpHigher - выше среднего.
tpHighest - высокий.
tpTimeCritical - самый высокий. Потоки этого приоритета обязаны освобождать процессор в самые минимальные сроки. Если для низкоприоритетных потоков циклы ожидания не рекомендуются, то для высокоприоритетных потоков они просто запрещены, так как могут подвесить систему. Потоки с приоритетом tpTimeCritical с высокой вероятностью будут выполняться строго периодически, примерно каждые 10 миллисекунд. При высокой загрузке процессора выполнение высокоприоритетного потока будет также с большой вероятностью происходить вовремя.

В столбце "DevLabel" указывается наименавиение устройство, которое будет отображаться на мнемосхеме системы.

После того, как все параметры будут указаны следует запустить отредактированный файл, что создаст файлы конфигурации устройств. Затем следует сослаться на созданные файлы в основном конфигурационном файле (название_системы_daq.cfg).

Например:

   [ConfigFileList] ; APC resources & services
   ConfigFile = apc_devices_hdw.cfg
   ConfigFile = apc_devices_sim-.cfg
   []

Также, если драйвер планируется использовать для удаленной работы по технологии DIM, слудет сослаться на созданные файлы в основных файлах конфигурации клиентской и серверной частях.

Пример для сервеной:

   [ConfigFileList] ; APC resources & services
   ConfigFile = apc_devices_hdw.cfg
   ConfigFile = apc_devices_sim-.cfg
   ConfigFile = apc_devices_dis.cfg
   []

Пример для клиентской:

   [ConfigFileList] ; APC resources & services
   ConfigFile = apc_devices_hdw.cfg
   ConfigFile = apc_devices_sim-.cfg
   ConfigFile = apc_devices_diс.cfg
   []

Прежде чем приступать к настройке клиент-серверного приложения по технологии DIM, прочитайте Help-файлы по конфигурации DIM в Crw.

Также в файле ".crc" основной системы следует сослать на созданный ".crc" файл.

   [ConfigFileList] ; Include the Painter GUI Library
   ConfigFile = ~~\Resource\DaqSite\Default\Painter.crc
   ConfigFile = apc_devices_link.crc
   []

Файл apc_ctrl.crc следует из папки Circuits следует скопировать в соответствующую дерикторию своей системы. Также следует поступить с BMP-файлами из папки Bitmaps.

Запуск драйвера

Запуск драйвера производится вызовом основных конфигурационных файлов системы из Crw32.exe.

Использование драйвера

После загрузки дрйвера откроется главное окно мнемосхемы:

Пример:
Кнопка управления имеет несколько состояний:
Вкл.UPS (цвет серый, кнопка отжата) - состояние, когда устройство выключено;
Вкл.-ие (цвет желтый, кнопка отжата) - состояние, когда устройство находится в процессе запуска;
Выкл.UPS (цвет зеленый, кнопка нажата) - состояние, когда устройство включено;
Выкл.-ие (цвет желтый, кнопка нажата) - состояние, когда устройство находится в процессе выключения;

Состояние устройства может принимать следующие значения:
ВЫКЛЮЧЕН (цвет серый) - устройство выключено;
ОТ СЕТИ (цвет зеленый) - устройство включено, на линию нагрузки подается напряжение из сети;
ОТ БАТ. (цвет желтый) - устройство включено, на линию нагрзуки подается напряжение от батареи;
WARNING (цвет красный) - данное состояние показывает, что устройство находится в аварийном состоянии (низкий заряд батареи, перегрузка на линии нагрузки, требуется замена батареи);
REFUSED (цвет красный) - соединение с утройством не установлено (возникает при неудачной попытке открытия канала связи с утройством, необходимо проверить настройки COM-порта);
TIMEOUT (цвет желтый) - ожидание ответа от устройства превысило время ожидания;
SIMULATOR (цвет желтый) - драйвер работет в режиме симуляции;

При нажатии на название устройства открывается диагностическое окно устройства:

По умолчанию опрос устройства не производится (сосотояние кнопки - "Вкл.опрос", кнопка отжата, цвет серый),
но при этом функции управления доступны (Вкл./выкл., Тест) и принимается информация о состоянии устройства (поле "Регистр статуса").
После нажатии кнопки "Вкл.опрос", кнопка поменяет свое состояние - кнопка нажата, цвет зеленый - опрос включен.
При включенном опросе устройства, драйвер принимает информацию от устройства, обрабатывает ее и выводит данные в графах ниже (см. пред. рисунок)

Если устройство выключено, после нажатия кнопки Вкл.UPS (кнопка отжата, цвет серый), кнопка перейдет в состояние Вкл.-ие (кнопка отжата, цвет желтый),
что означает, что устройство включается. При этом опрос устройства приостанавливается на 25 секунд.
Это сделано по причине того, что само устройство, пока включается, не отсылает никакую информацию и в момент опроса возникнет ошибка.

После нажатия кнопки "Тест", устройство производит самодиагностику и результаты отображаются в полях слева от кнопки

При нажатии на заголовок окна открывается меню инструментов, где есть возможность открыть:
Help-файл (который Вы сейчас изучаете);
Консольное окно устройства;
Выставить flags для консоли;
Сохранить парметры в INI-файл;
Загрузить параметры из INI-файла.

Справка по APC

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

Кофигурирование драйвера

Запуск драйвера

Использование драйвера

Удачного использования!