V2/Integrate/BACnet
From Senfi Docs
Contents
Senfi BACnet Adapter
The Senfi BACnet Adapter is available to onboarded partners only. If you would like to join as a Senfi partner, please send us an email with your organization name and contact details.
General
The Senfi BACnet Adapter integrates Senfi with BACnet compliant devices.
Features:
- Retrieving BACnet data-points through Polling or Change-of-value subscription.
- Writing data to writable BACnet data-points (aka sending Commands)
- Mass import BACnet address mappings using CSV.
Understanding BACnet
To understand BACnet, please read the first page of http://www.bacnet.org/Bibliography/HPAC-3-97.pdf
BACnet Adapter
Installation
- The installation of BACnet adapter has to be handled by G Element. Please contact us for the installation.
Login
- Use an Integration Key & Secret pair to login. You may want to create a separate Integration Key & Secret pair for the BACnet Adapter, to control which Site, Measurement & Assets are accessible to it.
- If the Integration Key input field is pre-filled-in & greyed out, then the BACnet Adapter has already been activated using an Integration Key. You must use that Integration Key & Secret to log in.
Activation
- Before you can begin to map BACnet Points to Senfi's measurement & metrics, you have to activate the BACnet Adapter. This serves as a confirmation to "Lock in" the Integration Key & Secret. Once activated, the BACnet Adapter will remember and use the Integration Key & Secret to publish data to Senfi. From here on, you can only use this Integration Key & Secret to log in to the BACnet Adapter.
Configuration
Configuration There are a few parameters to configure. You can leave most of them as default.
- BACnet/IP UDP Port
- This is the UDP Port that the BACnet Adapter's BACnet Client will listen on. It must be the same UDP Port as other BACnet devices you want to communicate with. This is usually 47808 (0xBAC in hex)
- BACnet/IP UDP Local Endpoint
- This is the IP Address of the network adapter that the BACnet Adapter will bind to and use to communicate with other BACnet devices. If you have multiple network cards/adapters on the machine, select the IP Address of the network card/adapter that is connected to the BACnet Network.
- BACnet Device ID
- This is the Device ID that BACnet Adapter's BACnet Client will use. Every BACnet device, regardless if they have any Objects to be read, must have a unique Device ID within the BACnet Network. Choose a number from 0 - 4194302, that no other BACnet device is using.
- BACnet Device Name
- This is the name that BACnet Adapter's BACnet Client will use. This is a human-friendly name, which does not have to be unique.
- Preferred BACnet Data Retrieval Method
- This is the preferred method which the BACnet Adapter will use to retrieve data from other BACnet Devices. COV Subscription is more efficient, but not all BACnet Devices supports it. If a BACnet Device does not support COV, the BACnet Adapter will automatically fall back to polling.
- Data Update Frequency
- How often to poll BACnet Devices for new data.