Skip to content

Commit

Permalink
#2152 Can't activate more than 1 Bacnet IP datasource simultaneously
Browse files Browse the repository at this point in the history
  • Loading branch information
Patrykb0802 committed Nov 12, 2024
1 parent f045927 commit 6303a69
Show file tree
Hide file tree
Showing 3 changed files with 12 additions and 13 deletions.
2 changes: 1 addition & 1 deletion WebContent/WEB-INF/dox/de/bacnetIpDS.htm
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ <h1>Overview</h1>
<h1>Configuration</h1>
<p>Every data source requires a <b>Name</b>, which can be any description. The <b>Update period</b> determines how often the BACnet equipment is polled for data. Polling is only used if a desired object does not support COV subscriptions. The device is automatically queried for its supported services to make this determination.</p>
<p>The <b>Device ID</b> is the identifier that Mango will provide to other equipment in its IAm message. An IAm message is automatically sent upon startup of the data source to declare its presence to the network, and is also sent in response to appropriate WhoIs requests.</p>
<p>The <b>Broadcast address</b> is the IP address for broadcast messages. Your network administrator will provide you with an appropriate value to use. The <b>Port</b> is the port number upon which Mango will listen for incoming messages. Note that Mango supports situations where other equipment within the BACnet network listens on other ports, but broadcast messages will only be sent to the port number that Mango listens on.</p>
<p>The <b>Broadcast address</b> is the IP address for broadcast messages. Your network administrator will provide you with an appropriate value to use. The <b>Port</b> is the port number upon which Mango will listen for incoming messages. Note that Mango supports situations where other equipment within the BACnet network listens on other ports, but broadcases messages will only be sent to the port number that Mango listens on.</p>
<p>By default, the port is set to <b>47808</b> (commonly represented as <b>0xBAC0</b>), which is the standard port for BACnet communication. However, in some cases, it may be necessary to set the port to <b>0</b>. Setting the port to <b>0</b> allows Mango to automatically detect the port used by devices in the network, which can be useful when the devices are configured to communicate on non-standard ports. This behavior can help resolve issues related to port mismatches in certain network configurations.</p>
<p>The <b>Timeout</b>, <b>Segment timeout</b>, <b>Segment window</b>, and <b>Retries</b> values are BACnet messaging attributes. In most cases the given default values should be appropriate. Consult the BACnet I/P documentation or your network administrator to determine if other values should be used for your network.</p>
<p>The <b>COV lease time</b> is the number of minutes that Mango will request to hold a COV lease. Mango will automatically attempt to refresh its COV subscriptions after half of the given time has elapsed. So, if the least time is 60 minutes, Mango will request the device honour the lease for 60 minutes, and will resubscribe after 30.</p>
Expand Down
2 changes: 1 addition & 1 deletion WebContent/WEB-INF/dox/en/bacnetIpDS.htm
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ <h1>Overview</h1>
<h1>Configuration</h1>
<p>Every data source requires a <b>Name</b>, which can be any description. The <b>Update period</b> determines how often the BACnet equipment is polled for data. Polling is only used if a desired object does not support COV subscriptions. The device is automatically queried for its supported services to make this determination.</p>
<p>The <b>Device ID</b> is the identifier that Mango will provide to other equipment in its IAm message. An IAm message is automatically sent upon startup of the data source to declare its presence to the network, and is also sent in response to appropriate WhoIs requests.</p>
<p>The <b>Broadcast address</b> is the IP address for broadcast messages. Your network administrator will provide you with an appropriate value to use. The <b>Port</b> is the port number upon which Mango will listen for incoming messages. Note that Mango supports situations where other equipment within the BACnet network listens on other ports, but broadcast messages will only be sent to the port number that Mango listens on.</p>
<p>The <b>Broadcast address</b> is the IP address for broadcast messages. Your network administrator will provide you with an appropriate value to use. The <b>Port</b> is the port number upon which Mango will listen for incoming messages. Note that Mango supports situations where other equipment within the BACnet network listens on other ports, but broadcases messages will only be sent to the port number that Mango listens on.</p>
<p>By default, the port is set to <b>47808</b> (commonly represented as <b>0xBAC0</b>), which is the standard port for BACnet communication. However, in some cases, it may be necessary to set the port to <b>0</b>. Setting the port to <b>0</b> allows Mango to automatically detect the port used by devices in the network, which can be useful when the devices are configured to communicate on non-standard ports. This behavior can help resolve issues related to port mismatches in certain network configurations.</p>
<p>The <b>Timeout</b>, <b>Segment timeout</b>, <b>Segment window</b>, and <b>Retries</b> values are BACnet messaging attributes. In most cases the given default values should be appropriate. Consult the BACnet I/P documentation or your network administrator to determine if other values should be used for your network.</p>
<p>The <b>COV lease time</b> is the number of minutes that Mango will request to hold a COV lease. Mango will automatically attempt to refresh its COV subscriptions after half of the given time has elapsed. So, if the least time is 60 minutes, Mango will request the device honour the lease for 60 minutes, and will resubscribe after 30.</p>
Expand Down
21 changes: 10 additions & 11 deletions WebContent/WEB-INF/dox/ru/bacnetIpDS.htm
Original file line number Diff line number Diff line change
Expand Up @@ -18,16 +18,15 @@
-->

<h1>Обзор</h1>
<p>Источник данных BACnet I/P используется для сбора данных от устройств, совместимых с BACnet I/P, которые доступны по IP-сети. Оборудование может находиться в локальной сети, внутри локальной сети (интранет) или даже в интернете. Этот источник данных использует оба опроса и подписки на изменения (COV - Change Of Value) для обновления, если это применимо.</p>
<p>Источник данных BACnet I/P используется для сбора данных с устройств, совместимых с BACnet I/P и доступных через IP-сеть. Устройства могут быть подключены к локальной сети или к Интранет-сети, а также могут находиться где угодно в сети Интернет. Для получения информации данный источник использует как режим опроса, так и режим подписки на получение COV (Изменение значения).</p>

<h1>Конфигурация</h1>
<p>Каждому источнику данных необходимо задать <b>Имя</b>, которое может быть любым описанием. <b>Период обновления</b> определяет, как часто оборудование BACnet будет опрашиваться для получения данных. Опрос применяется только в случае, если желаемый объект не поддерживает подписки COV. Устройство автоматически опрашивается на предмет поддержки ими необходимых сервисов для принятия решения.</p>
<p><b>Идентификатор устройства (Device ID)</b> является идентификатором, который Mango предоставит другим устройствам в сообщении IAm. Сообщение IAm автоматически отправляется при запуске источника данных для объявления о своём наличии в сети и также отправляется в ответ на запросы WhoIs.</p>
<p><b>Адрес широковещательной отправки (Broadcast address)</b> является IP-адресом для широковещательных сообщений. Ваш администратор сети предоставит вам необходимое значение для использования. <b>Порт</b> - это номер порта, на котором Mango будет слушать входящие сообщения. Обратите внимание, что Mango поддерживает ситуации, в которых другое оборудование в сети BACnet слушает на других портах, но широковещательные сообщения будут отправляться только на порт, на котором Mango слушает.</p>
<p>По умолчанию, порт установлен на <b>47808</b> (часто обозначаемый как <b>0xBAC0</b>), что является стандартным портом для BACnet. Однако, в некоторых случаях может понадобиться установить порт на <b>0</b>. Установка порта на <b>0</b> позволяет Mango автоматически определять порт, используемый устройствами в сети, что может быть полезно, когда устройства настроены на работу на нестандартных портах. Это поведение может помочь решить проблемы, связанные с несоответствием портов в определенных конфигурациях сети.</p>
<p><b>Таймаут (Timeout)</b>, <b>Таймаут сегмента (Segment timeout)</b>, <b>Окно сегмента (Segment window)</b> и <b>Повторы (Retries)</b> являются параметрами сообщений BACnet. В большинстве случаев данные параметры по умолчанию должны быть подходящими. Обратитесь к документации BACnet I/P или к вашему администратору сети, чтобы определить, если для вашей сети должны быть использованы другие значения.</p>
<p><b>Время действия подписки COV (COV lease time)</b> — это количество минут, на которое Mango будет запрашивать сохранение аренды COV. Mango автоматически попытается обновить свои подписки COV после того, как пройдёт половина заданного времени. Так что, если время аренды равно 60 минут, Mango запросит у устройства продление аренды на 60 минут, а переоформит подписку через 30 минут.</p>
<p>Когда подписки COV не доступны, вместо этого используется опрос с указанной частотой. Устройства опрашиваются поотдельно. Устройства, которые поддерживают запросы ReadPropertyMultiple, отправляют это сообщение, разделенное на не более чем 200 свойств в один запрос при необходимости. В противном случае отправляются отдельные запросы ReadProperty.</p>

<h1>Обнаружение BACnet I/P</h1>
<p>Сети BACnet I/P могут быть обнаружены автоматически с помощью отправки сообщений WhoIs. Устройства обязаны ответить сообщением IAm, которое содержит некоторую основную информацию об устройстве. Чтобы проверить настройки конфигурации и определить, какие устройства доступны для точек, введите <b>номер порта</b>, на котором будет выполняться широковещательная отправка, и нажмите кнопку «Отправить WhoIs». (Если номер порта не указан, используется значение из конфигурации.) Одно сообщение WhoIs будет отправлено, и после этого устройство будет слушать сообщения IAm бесконечно. (Нажатие «Отмена» остановит слушатель.) По мере получения сообщений IAm информация о устройствах будет отображаться в таблице ниже кнопки. Эта информация может быть использована для создания точек.</p>
<p>Каждый источник данных должен иметь произвольно заданное Имя. Значение поля Период обновления задает частоту опроса устройств сети BACnet. Режим опроса применяется только в тех случаях, если нужный объект не поддерживает подписки на получение COV. Устройству автоматически направляется запрос для определения, какой из способов сбора данных будет использоваться.</p>
<p>Идентификатор устройства – это значение идентификатора, которое данное устройство отправляет другому устройству в начальном стартовом сообщении IAm. Начальное стартовое сообщение отправляется автоматически при включении источника данных для подтверждения присутствия устройства в сети, а также отправляется в ответ на соответствующий запрос «Кто есть кто» (WHOIS). </p>
<p>Широковещательный адрес – это IP-адрес для широковещательной рассылки сообщений. Ваш администратор сообщит Вам, какое значение следует установить.</p>
<p>Порт – это номер порта, который прослушивает Scada-LTS. Необходимо отметить, что Scada-LTS поддерживает ситуации, когда некоторые устройства в сети BACnet имеют возможность прослушивать сообщения с других портов. Но широковещательные сообщения будут рассылаться только через порт, который прослушивает Scada-LTS.</p>
<p> Значения полей Время ожидания, Время ожидания сегмента, Окно сегмента и Повторы являются атрибутами сообщений в сети BACnet. В большинстве случаев подходят значения, заданные по умолчанию. Если в Вашей сети необходимо использовать другие значения этих атрибутов, пожалуйста, обратитесь к администратору сети или проверьте техническую документацию сети BACnet I/P. </p>
<p>Срок аренды COV – это количество минут, в течение которых Mango будет использовать COV. Система автоматически начнет пытаться обновить COV-подписки по прошествии половины заданного времени. Таким образом, если минимальное время составляет 60 минут, Mango отправит в устройство запрос об установлении аренды в течение 60 минут, а через 30 минут повторно запустит подписку.</p>
<p> Если режим подписки на получение COV не доступен, используется опрос с заданной периодичностью. Каждое устройства опрашивается индивидуально. Если устройство поддерживает сервис чтения групп свойств (ReadPropertyMultiple), ему направляется сообщение-запрос, разбитое на части таким образом, чтобы в одном запросе содержалось не более 200 свойств. В противном случае направляются единичные запросы чтения свойства (ReadProperty).</p>
<h1>Обнаружение устройств сети BACnet I/P </h1>
<p>Обнаружение сети BACnet I/P происходит автоматически при широковещательной рассылке сигнала WhoIs. Устройства сети должны направлять в ответ начальное стартовое сообщение IAm, в котором содержится основная информация об устройстве. Чтобы проверить настройки конфигурации и найти доступные устройства, введите номер Порта для передачи широковещательного сигнала и нажмите кнопку «Отправить WhoIs». (Если нет номера порта, берется значение из конфигурации). В этом случае будет разослан сигнал WhoIs и немедленно начнется прослушивание ответных сигналов IAm (нажатие кнопки «Отмена» остановит прием сообщений). После получения сигнала IAm, информация об устройстве будет отображена в таблице, расположенной под кнопкой. Эта информация будет использоваться для создания объектов.</p>

0 comments on commit 6303a69

Please sign in to comment.