Аргументы при вызове операции чтения
Параметр |
Описание |
File Identifier |
Параметр формата Object_Identifier, определяющий конкретный файл для чтения |
Stream Access |
Параметр показывает, что доступ к файлу будет потоковый, включает в себя параметры File Start Position и Request Octet Count |
Stream Access : File Start Position |
Параметр типа INTEGER, указывающий на количество байтов от начала файла до позиции, откуда будет производиться чтение. Значение «0» соответствует первому байту файла. |
Stream Access : Request Octet Count |
Параметр типа Unsigned, указывающий на количество байтов, которые будут читаться из файла начиная с позиции File Start Position. |
Record Access |
Параметр показывает, что доступ к файлу будет организован как доступ к записям, включает в себя параметры File Start Record и Request Record Count. |
Record Access : File Start Record |
Параметр типа INTEGER, указывающий на количество записей от начала файла до позиции, откуда будет производиться чтение. Значение «0» соответствует первой записи файла. |
Record Access : Request Record Count |
Параметр типа Unsigned, указывающий на количество записей, которые будут читаться из файла начиная с записи File Start Record. |
Результат выполнения операции чтения
Параметр |
Описание |
End Of File |
Параметр типа BOOLEAN, принимает значение TRUE, если ответ включает последний байт файла и FALSE в противном случае. Этот параметр используется для контроля конца файла, когда число считанных байтов или записей меньше, чем запрошено. |
Stream Access |
Параметр показывает, что был запрошен потоковый доступ к файлу, включает в себя параметры File Start Position и File Data. |
Stream Access : File Start Position |
Параметр типа INTEGER, указывающий на количество байтов от начала файла до позиции, откуда было произведено чтение. Значение «0» соответствует первому байту файла. |
Stream Access : File Data |
Параметр содержит строку байтов, содержащую запрошенные данные файла. |
Record Access |
Параметр показывает, что доступ к файлу был организован как доступ к записям, включает в себя параметры File Start Record,Returned Record Count и File Record Data. |
Record Access : File Start Record |
Параметр типа INTEGER, указывающий на количество записей от начала файла до позиции, откуда производилось чтение. Значение «0» соответствует первой записи файла. |
Record Access : Returned Record Count |
Параметр типа Unsigned, указывающий на количество записей, которые были реально считаны из файла. Это значение может меньше, чем указанное при запросе в Request Record Count. |
Record Access : File Record Data |
Параметр содержит список массивов байтов, содержащих запрошенные данные. |
Аргументы при вызове операции записи
Параметр |
Описание |
File Identifier |
Параметр формата Object_Identifier, определяющий конкретный файл для чтения |
Stream Access |
Параметр показывает, что доступ к файлу будет потоковый, включает в себя параметры File Start Position и File Data |
Stream Access : File Start Position |
Параметр типа INTEGER, указывающий на количество байтов от начала файла до позиции, куда будут записываться данные. Значение «0» соответствует первому байту файла. Значение «-1» показывает, что это будет операция добавления данных в конец файла. |
Stream Access : File Data |
Параметр содержит строку данных, которые должны быть записаны в файл. |
Record Access |
Параметр показывает, что доступ к файлу будет организован как доступ к записям, включает в себя параметры File Start Record, Record Count и File Record Data. |
Record Access : Record Count |
Параметр типа INTEGER, указывающий на количество записей от начала файла до позиции, куда будет производиться запись. Значение «0» соответствует первой записи файла. Значение «-1» показывает, что записи будут добавлены в конец файла. |
Record Access : File Record Data |
Параметр содержит список строк данных, которые будут записаны в файл. |
Результат выполнения операции записи
Параметр |
Описание |
Stream Access |
Параметр показывает, что был запрошен потоковый доступ к файлу, включает в себя параметр File Start Position. |
Stream Access : File Start Position |
Параметр типа INTEGER, указывающий на количество байтов от начала файла до позиции, откуда была произведена запись. Значение «0» соответствует первому байту файла. |
Record Access |
Параметр показывает, что доступ к файлу был организован как доступ к записям, включает в себя параметр File Start Record. |
Record Access : File Start Record |
Параметр типа INTEGER, указывающий на количество записей от начала файла до позиции, откуда производилось запись. Значение «0» соответствует первой записи файла. |
Структура параметров вызова AddListElement
Параметр |
Описание |
Object Identifier |
Параметр типа BACnetObjectIdentifier, идентифицирующий объект, чьи параметры обрабатываются данной службой. |
Property Identifier |
Параметр типа BACnetPropertyIdentifier, уникальный идентификатор свойства, которое модифицируется данной службой. |
Property Array Index |
Если идентификатор, описанный выше, определяет свойство как массив данных, этот условный параметр указывает на элемент в массиве данных свойства, который будет модифицироваться данной службой. В противном случае этот параметр опускается. |
List of Elements |
Этот параметр определяет один или несколько элементов, которые будут добавлены к свойству, определенному параметром Property Identifier. Тип данных этих элементов определяется типом объекта в параметре Object Identifier. |
Структура параметров вызова CreateObject
Параметр |
Описание |
Object Specifier |
Параметр сообщает информацию о типе создаваемого объекта. Параметр может иметь тип ObjectType или ObjectIdentifier. В первом случае указанный тип объекта записывается в свойство Object_Type создаваемого объекта, идентификатор объекта задается автоматически. |
List of Initial Values |
Этот параметр является списком типа BACnetPropertyValues, значения свойств из которого будут записаны в свойства объекта при его создании. |
Структура параметров вызова DeleteObject
Параметр |
Описание |
Object Identifier |
Параметр типа BACnetObjectIdentifier определяет удаляемый объект |
Структура параметров вызова ReadProperty
Параметр |
Описание |
Object Identifier |
Параметр типа BACnetObjectIdentifier, идентифицирующий объект, чье свойство будет прочитано и возвращено этой службой. |
Property Identifier |
Параметр типа BACnetPropertyIdentifier, уникальный идентификатор свойства, которое запрашивается данной службой. |
Property Array Index |
Если идентификатор, описанный выше, определяет свойство как массив данных, этот условный параметр указывает на элемент в массиве данных свойства, который будет запрашиваться данной службой. Если этот параметр опущен, действие применяется ко всему массиву. Если свойство не является массивом, параметр также не учитывается. |
Структура параметров вызова ReadPropertyMultiple
Параметр |
Описание |
List of Read Access Specifications |
Параметр содержит список одной или нескольких Read Access Specification. Каждая спецификация содержит два параметра Object Identifier и List of Property References. |
Спецификация Read Access Specifications
Параметр |
Описание |
Object Identifier |
Параметр типа BACnetObjectIdentifier, идентифицирующий объект, чьи свойства будут прочитаны и возвращены этой службой. |
List of Property References |
Этот параметр содержит список из одного или нескольких BACnetPropertyReferences, каждый из которых прямо указывает на конкретное свойство объекта. Если значение идентификатора содержит значение ALL, это означает что доступ запрашивается ко всем свойствам объекта. Значение REQUIRED означает, что запрашиваются стандартные свойства объекта. Значение OPTIONAL означает, что запрашиваются опциональные свойства. |
Структура параметров ответа ReadPropertyMultiple
Параметр |
Описание |
Object Identifier |
Параметр типа BACnetObjectIdentifier, идентифицирующий объект, чьи свойства возвращаются в ответе на запрос этой службы. |
List of Results |
Результат запроса свойств в виде списка. Каждый элемент списка содержит Property Identifier, условный параметр Property Array Index и Property Value или Property Access Error, если чтение завершилось с ошибкой. |
Property Identifier |
Параметр типа BACnetPropertyIdentifier, уникальный идентификатор свойства, которое запрашивается данной службой. |
Property Array Index |
Если идентификатор, описанный выше, определяет свойство как массив данных, этот условный параметр указывает на элемент в массиве данных свойства, который возвращается данной службой. Иначе параметр опускается. |
Property Value |
Если доступ к указанному свойству совершен успешно, возвращается этот параметр со значением этого свойства. |
Property Access Error |
Если доступ к указанному свойству указанного объекта запрещен, возвращает этот параметр с кодом ошибки доступа. |
Структура параметров вызова ReadRange
Параметр |
Описание |
Object Identifier |
Параметр типа BACnetObjectIdentifier, идентифицирующий объект, чье свойство будет прочитано и возвращено этой службой. |
Property Identifier |
Параметр типа BACnetPropertyIdentifier, уникальный идентификатор свойства, которое запрашивается данной службой. |
Property Array Index |
Если идентификатор, описанный выше, определяет свойство как массив списков, этот условный параметр указывает на элемент в массиве списков свойства, которое будет запрашиваться данной службой. Если свойство не является массивом, параметр не учитывается. |
Range |
Здесь задается последовательный диапазон элементов запрашиваемого свойства. Причем критериями задания диапазона может быть позиция элемента, порядковый номер элемента или timestamp элемента в массиве. |
Структура параметров вызова WriteProperty
Параметр |
Описание |
Object Identifier |
Параметр типа BACnetObjectIdentifier, идентифицирующий объект, чье свойство будет модифицировано этой службой. |
Property Identifier |
Параметр типа BACnetPropertyIdentifier, уникальный идентификатор свойства, которое будет модифицировано данной службой. |
Property Array Index |
Если идентификатор, описанный выше, определяет свойство как массив данных, этот условный параметр указывает на элемент в массиве данных свойства, который будет модифицироватся данной службой. Если этот параметр опущен, действие применяется ко всему массиву. Если свойство не является массивом, параметр также не учитывается. |
Property Value |
Новое значение, которое записывается в модифицируемое свойство. |
Priority |
Этот параметр может иметь значение в диапазоне 1-16 и обозначает приоритет данной операции записи. Если запись производится без указания приоритета, будет установлено значение по умолчанию 16 (низший приоритет). |
Структура параметров вызова WritePropertyMultiple
Параметр |
Описание |
List of Write Access Specifications |
Параметр содержит список одной или нескольких Write Access Specification. Каждая спецификация содержит до пяти параметров: Object Identifier, List of Properties References each of which consist of, Property Identifier, Property Array Index, Property Value и Priority |
Спецификация Write Access Specifications
Параметр |
Описание |
Object Identifier |
Параметр типа BACnetObjectIdentifier, идентифицирующий объект, чьи свойства будут модифицированы этой службой. |
List of Properties |
Этот параметр содержит список из одного или нескольких свойств, которые должны быть модифицированы. Каждый элемент этого списка содержит параметры, описанные ниже. |
Property Identifier |
Параметр типа BACnetPropertyIdentifier, уникальный идентификатор свойства. |
Property Array Index |
Если идентификатор, описанный выше, определяет свойство как массив данных, этот условный параметр указывает на элемент в массиве данных свойства, который модифицируется данной службой. Иначе параметр опускается. Если параметра не задан для массива, модифицируется весь массив. |
Property Value |
Новое значение модифицируемого свойства. |
Priority |
Этот параметр может иметь значение в диапазоне 1-16 и обозначает приоритет данной операции записи. Если запись производится без указания приоритета, будет установлено значение по умолчанию 16 (низший приоритет). |
Продолжение следует.
Архив публикаций
Дата печати: 22 Dec 2024 01:58:19 |