Перейти к основному содержанию

Bacnet

23 января 2025 г.Около 3 минEDGEbacnet

Зависимости проекта

библиотека bacnet-stack-0.5.7

Предварительные условия

  1. Для запроса справки необходимо добавить ключ -help

  2. Для запуска режима отладки необходимо добавить ключ\пару ключ и значение.

КлючОписаниеТип значения
-dcollectorСобирает данные по устройствам-
-timeoutВременной промежуток для запроса данныхuint32_t (миллисекунды)
-idИдентификатор устройстваuint32_t
-tТип значенияuint32_t
-pСвойствоuint32_t
-iИндексuint32_t
-helpСправка по программе-

Примечание

В режиме отладки отправка сообщений по mqtt отключена. В режиме отладки только -dcollector не нуждается в значении.

  1. Есть ТРИ сценария работы программы, для них определены необходимые ключи. Задержка играет роль, только в сценарии сбора данных по всем устройствам. В других случаях, эта задержка определит только продолжительность запроса данных в случае их долгого ответа.
№СценарийНеобходимые ключи
1Сбор данных по одному устройству-dcollector -id
1Сбор данных по одному устройству c задержкой-dcollector -id -timeout
2Сбор данных по всем устройствам-dcollector
2Сбор данных по всем устройствам c задержкой-dcollector -timeout
3Сбор данных по параметру-id -t -p -i
3Сбор данных по параметру с задержкой-id -t -p -i -timeout
  1. Примеры использования сценариев:
dcollector  -id 260001
dcollector -id 260001 -timeout 100`
dcollector
dcollector -timeout 200
-i -1 -t 8 -p 76 -id 260001
-i -1 -t 8 -p 76 -id 260001 -timeout 300
  1. Таблица допустимых типов: Type
  2. Таблица допустимых свойств: Property

Состав конфигурационного файла

Блок для логирования

АтрибутТипОписаниеСтатусЗначение по умолчанию
is_debugboolПараметр для вывода дополнительного логирования, принимает значения false или trueне обязателенfalse
max_size----
"log":
{
    "is_debug": false,
    "max_size": 2
}

Блок для подключения по mqtt

АтрибутТипОписаниеСтатусЗначение по умолчанию
portunsigned intЗначение портане обязателен1883
urlstringip для подключенияне обязателен"localhost"
usernamestringлогинобязателен для защищенного режима-
passwordstringпарольобязателен для защищенного режима-
"mqtt":
{
    "port": 1883,
    "url": "localhost",
    "username": "ivan",
    "password": "123"
}

Блок для работы с bacnet

АтрибутТипОписаниеСтатусЗначение по умолчанию
connection-параметры соединенияобязателен-
devicesarrayсписок устройствобязателен-
parametersarrayсписок параметров по устройствамобязателен-
"ports":
[
    {
        "connection":{},
        "devices":[],
        "parameters":[]
    }
]

Блок из "ports" для работы с bacnet

АтрибутТипОписаниеСтатусЗначение по умолчанию
enabledboolблокировка соединенияобязателен-
poll_intervalunsigned intзадержка опроса параметровобязателен-
timeoutunsigned intвремя ожидания для запроса/записиобязателен-
delayunsigned intвременное окно для запроса/записи данныхобязателен-
typestringтип модуляобязателен-
bacnet_ifacestringинтерфейс подключения по bacnetне обязателенeth0
db_updateboolобновить базу даыыхне обязателенtrue
"connection":
{
    "enabled": true,
    "poll_interval": 5000,
    "timeout": 500,
    "delay": 300,
    "type": "bacnet",
    "bacnet_iface": "eth0",
    "db_update": true
}

Блок из "ports" для подключения к серверу по bacnet

АтрибутТипОписаниеСтатусЗначение по умолчанию
namestringимя устройстваобязателен-
sidunsigned intномер устройстваобязателен-
cnamestringгруппа параметров для устройстваобязателен-
"devices":
[
    {
        "name": "server_1",
        "sid": 260001,
        "cname": "iss"
    }
]

Блок из "ports" для работы с параметрами по bacnet

АтрибутТипОписаниеСтатусЗначение по умолчанию
config-параметрыобязателен-
cnamestringназвание группы параметров для устройстваобязателен-
"parameters":
[
    {
        "config":{},
        "cname": "iss"
    }
]

Блок из "parameters" для опроса и запроса данных по bacnet

АтрибутТипОписаниеСтатусЗначение по умолчанию
namestringимя параметраобязателен-
object_numberunsigned intномер параметраобязателен-
scalefloat-обязателен-
value_typestringтип параметраобязателен-
tagstringтэг для изменения параметраобязателен-
read_onlyboolустаовка чтения или записи для параметране обязателенtrue
"channels":
[
                            
    {
        "name": "Param_1",
        "object_number": 1,
        "scale": 1.0,
        "value_type": "binary-lighting-output",
        "tag": "real",
        "read_only": false
    }
]

Полный конфигурационный файл

{
    "log":
    {
        "is_debug": false,
        "max_size": 2
    },
    "mqtt":
    {
        "port": 1883,
        "url": "localhost",
        "username": "ivan",
        "password": "123"
    },
    "ports": [
        {
            "connection":
            {
                "enabled": true,
                "poll_interval": 5000,
                "timeout": 500,
                "delay": 300,
                "type": "bacnet",
                "bacnet_iface": "eth0",
                "db_update": true
            },
            "devices": [
                {
                    "name": "server_1",
                    "sid": 260001,
                    "cname": "iss"
                },
                {
                    "name": "server_2",
                    "sid": 260002,
                    "cname": "inspark"
                }
            ],
            "parameters": [
                {
                    "config":
                    {
                        "channels": [
                            {
                                "name": "Param_1",
                                "object_number": 1,
                                "scale": 1.0,
                                "value_type": "lighting-output",
                                "tag": "real"
                            },
                            {
                                "name": "Param_2",
                                "object_number": 0,
                                "scale": 1.0,
                                "value_type": "accumulator",
                                "tag": "real"
                            }
                        ]
                    },
                    "cname": "iss"
                },
                {
                    "config":
                    {
                        "channels": [
                            {
                                "name": "Param_1",
                                "object_number": 10,
                                "scale": 1.0,
                                "value_type": "accumulator"
                            },
                            {
                                "name": "Param_2",
                                "object_number": 11,
                                "scale": 3.01,
                                "value_type": "accumulator"
                            }
                        ]
                    },
                    "cname": "inspark"
                }
            ]
        }
    ]
}

Тэги

Инфо

Если в поле tag находится значение отличное от имеющихся значений, то автоматически выставляется значение "null". Если в названии стоит прочерк, то это означает, что параметр не реализован!

ТэгЗначениеНазвание
BACNET_APPLICATION_TAG_NULL0null
BACNET_APPLICATION_TAG_BOOLEAN1bool
BACNET_APPLICATION_TAG_UNSIGNED_INT2uint
BACNET_APPLICATION_TAG_SIGNED_INT3sint
BACNET_APPLICATION_TAG_REAL4real
BACNET_APPLICATION_TAG_DOUBLE5double
BACNET_APPLICATION_TAG_OCTET_STRING6o_str
BACNET_APPLICATION_TAG_CHARACTER_STRING7c_str
BACNET_APPLICATION_TAG_BIT_STRING8b_str
BACNET_APPLICATION_TAG_ENUMERATED9enumerated
BACNET_APPLICATION_TAG_DATE10date
BACNET_APPLICATION_TAG_TIME11time
BACNET_APPLICATION_TAG_OBJECT_ID12object_id
BACNET_APPLICATION_TAG_RESERVE113reserve_1
BACNET_APPLICATION_TAG_RESERVE214reserve_2
BACNET_APPLICATION_TAG_RESERVE315reserve_3
MAX_BACNET_APPLICATION_TAG16-
BACNET_APPLICATION_TAG_EMPTYLIST17-
BACNET_APPLICATION_TAG_WEEKNDAY18-
BACNET_APPLICATION_TAG_DATERANGE19-
BACNET_APPLICATION_TAG_DATETIME20-
BACNET_APPLICATION_TAG_TIMESTAMP21-
BACNET_APPLICATION_TAG_ERROR22-
BACNET_APPLICATION_TAG_DEVICE_OBJECT_PROPERTY_REFERENCE23-
BACNET_APPLICATION_TAG_DEVICE_OBJECT_REFERENCE24-
BACNET_APPLICATION_TAG_OBJECT_PROPERTY_REFERENCE25-
BACNET_APPLICATION_TAG_DESTINATION26-
BACNET_APPLICATION_TAG_RECIPIENT27-
BACNET_APPLICATION_TAG_COV_SUBSCRIPTION28-
BACNET_APPLICATION_TAG_CALENDAR_ENTRY29-
BACNET_APPLICATION_TAG_WEEKLY_SCHEDULE30-
BACNET_APPLICATION_TAG_SPECIAL_EVENT31-
BACNET_APPLICATION_TAG_READ_ACCESS_SPECIFICATION32-
BACNET_APPLICATION_TAG_LIGHTING_COMMAND33-
BACNET_APPLICATION_TAG_HOST_N_PORT34-
BACNET_APPLICATION_TAG_XY_COLOR35-
BACNET_APPLICATION_TAG_COLOR_COMMAND36-
Последнее обновление: 23.01.2025, 15:30:35
Контрибьюторы: gukovi
© 2013-2025 Inspark Ltd. All rights reserved