BQuark. Файл задания.

Файл задания для программного обеспечения BQuark имеет определенную структуру он разделен на три составных части (секции):

• Секция описания объектов системы сбора данных ( OBJECTS )
• Секция описания интерфейса программы ( INTERFACE )
• Секция протокола ( LOG )

Секция OBJECTS 

OBJECTS  - содержит перечень элементов системы, описание типа канала связи с ними и типа интерфейса, команды на опрос, свойства точек учета (например лицевой счет, адрес установки счетчика) и непосредственно считанные данные.

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

LOG - заполняется программой.

При написании файла необходимо учитывать иерархию элементов. В этой иерархии родительский элемент от подчиненного отделяется знаком перевода каретки и знаком табуляции  т.е. подчиненный элемент находится на строку ниже родительского элемента и смещен вправо на один знак, вводимый при помощи клавиши "Tab". Это важно, для смещения начала строки с подчиненным элементом должна использоваться только клавиша Tab, использование пробела не допускается. В файле задания вообще не должно быть ни одного символа пробела, кроме как в закомментированных строках (строках помеченных символами " // " )
Конструкция команд следующая, сначала сообщается тип элемента ( TYPE= ), затем сетевой адрес элемента или номер дозвона, или другими словами сетевой идентификатор (ADDR= или NUMBER= ), далее следуют параметры связи, свойства и параметры опрос. Типы элементов могут быть следующие:

• счетчик (PLC_I_METER или PLC_II_METER)

TYPE=PLC_I_METER

• счетчики всегда подчинены концентратору (PLC_I_CONCENTRATOR или PLC_II_CONCENTRATOR)

TYPE=PLC_I_CONCENTRATOR

TYPE=PLC_I_METER

• концентратор может быть подчинен, т.е. опрашиваться через GSM модем (GSM_MODEM), GSM шлюз (GSM_GATE),  Ethernet преобразователь или GSM шлюз (модем) в режиме GPRS ( GPRS/TCP ). Если концентратор подключен к компьютеру напрямую по USB или через преобразователь интерфейсов по RS-485, то он будет первым в иерархии

TYPE=GSM_GATE

TYPE=PLC_I_CONCENTRATOR

TYPE=PLC_I_METER

• GSM модем или GSM шлюз подчинены GSM модему подключенному к компьютеру (GSM_TERMINAL), но если шлюз или модем работают в режиме GPRS или если используется Ethernet преобразователь то тогда обозначаться они будут будут как GPRS/TCP, а располагаться первыми в иерархии

TYPE=GSM_TERMINAL

TYPE=GSM_GATE

TYPE=PLC_I_CONCENTRATOR

TYPE=PLC_I_METER

или

TYPE=GPRS/TCP

TYPE=PLC_I_CONCENTRATOR

TYPE=PLC_I_METER

• дополнительный элемент - элемент команды для концентратора (COMMAND) в иерархии он находится на одном уровне  со счетчиками и предназначен для передачи команд концентратору, например команды на вывод параметров конфигурации концентратора 

TYPE=GSM_TERMINAL

TYPE=GSM_GATE

TYPE=PLC_I_CONCENTRATOR

TYPE=PLC_I_METER

TYPE=COMMAND

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

Описание таблицы для отображения собранных данных содержится  в секция  INTERFACE. Первая строка сообщает тип объекта - TABLE или таблица, далее, следующие в иерархии элемент колонка (COLUMN) или столбец таблицы. Количество объектов COLUMN соответствует требуемому количеству столбцов в таблице, требуемому для отображения необходимых данных.


INTERFACE
TYPE=TABLE
TYPE=COLUMN
TYPE=COLUMN
TYPE=COLUMN


Свойства объекта COLUMN содержат указания на заголовок столбца, на его ширину, фильтр для отображения определенных данных или действия над ними. Например, если в колонке требуется отображать данные по учтенной энергии, по Тарифу 1, то мы присваиваем объекту COLUMN следующие свойства: Заголовок колонки - TITLE=Тариф #1;   источник данных - VALUE=BINDATA (BINDATA означает что данные надо брать из тех, что считаны со счетчика, кроме них еще могут быть свойства счетчика VALUE=PROPERTY, которые задаются составителем файла); фильтр, для сортировки данных - FILTER=T1 (этот фильтр означает, что из всего объема считанных со счетчика данных (BINDATA) надо выбрать данные по тарифу 1) В итоге строчка описывающая требуемую колонку - столбец будет выглядеть так:

TYPE=COLUMN; WIDTH=150; TITLE=Тариф #1; VALUE=BINDATA; FILTER=T1

совсем забыл свойство ширина (WIDTH) - оно устанавливается в пикселах и может при этом регулироваться через интерфейс BQuark, путем установки нужной ширины перетаскиванием границы столбца мышью.


Подробнее описание элементов файла задания приведено в справке к программе BQuark. Для ориентирования в этой справке предназначено содержание, в частности формат файла задания и описание всех используемых команд находится в соответствующем разделе "Формат файла задания"

В нем с учетом занимаемого места в иерархии описываются все элементы. Скачать справку к программе BQuark и саму программу версии 3.0 можно здесь.