Using CCA to discover a BACnet network

Here are instructions for scanning the BACnet network to create devices and data points in the Building X Cloud. Also, to create CSV files that are used as input for further Building X integrations, such as Digital Onboarding. CCA uses MSiB in the background to execute BACnet scanning. For details on how MSiB runs BACnet discovery, refer to the current MSiB user documentation.

Defining the CCA discovery process

To start the Discovery process, click the Start Discovery button located in the application header of the Discovery interface screen.

CCA Start Discovery button

The Discovery scan settings dialog box opens.

Discovery Scan Settings dialog box

To use a manual Discovery file, select Yes for Use Manual Discovery File. For more information, see: Using a manual Discovery file.

Discovery scan settings legend

  1. The default setting for Use Manual Discovery File is No.
  2. Select Discovery Network Adapter and choose the network interface that is connected to the BACnet network This drop-down list contains the networks connected to the local computer. it is already selected if the system has only one.
  3. Enter the IP Address of the Network Adapter selected in step 2 to send the adapter name and IP address to MSiB.
  4. Set the Minimum Device Instance Number value to discover. To Include all, leave the default range of 0 - 4194302.
  5. Set the Maximum Device Instance Number value to discover.
  6. Filter the Network Number to discover a set number of devices or keep the default of zero to have MSiB send the discovery request to all networks. MSiB will also filter for the responses and avoid adding additional devices not requested if a Who is? was Initiated by another device on the network during discovery.
  7. For the Port field, enter the UDP port for the Who is? request.
  8. Leave the IP Address Filter List field blank to allow any IP address. If, however multiple, but limited IP addresses are desired, enter them using commas to keep them separate.
  9. Note: Normally, the process either filters by IP address, or by device-instance range but not at the same time. Both filter methods have the same outcome: 1 file for every discovered device and a master file combining all the individual files in the discovery folder.
  10. If you are using a BBMD and need it to send out the Who is? without using the same port as the BAS, use the field: Register Foreign Device with BBMD. When used, this field has the BBMD IP address to register with. Leave blank and MSiB sends out a Who is? Without a foreign device.
  11. To include MS/TP local subordinate devices, select the Discover Local Slaves check box.
  12. Include the following information to obtain these local subordinate devices tor Discovery:
  13. -Indicate the IP address of the field device on which the subordinate device Is bound in the IP Address Filter List setting.
  14. -Leave the Network Number as zero.
  15. -Leave the Device-Instance filters as 0 - 4194302.
  16. To start Discovery, click the Scan and Upload button.

Using a manual Discovery file

To use a manual Discovery file, select Yes for Use Manual Discovery File.

Use manual Discovery file

Select Yes. The Manual Discovery File dialog box opens.

Select this option and all filter settings in the Discovery Scan Settings dialog box are ignored.

Manual Discovery File dialog box

Click the Choose File button to select the desired CSV file used for manual discovery. To start discovery, click Scan and Upload button.

Starting the Discovery Process

Once started, the process is automatic with the interface providing visual indicators throughout.

To stop the process click Stop Discovery. If the process stops during the Device Discovery step, the process ends immediately with no data saved. If the process is canceled during the Cloud Synchronization step that adds data points in Building X, any data points already added remain in Building X.

CCA starting Discovery scan

As Discovery completes the process the Cloud Synchronization Progress bar provides the estimated time remaining. This is useful to monitor large numbers of data points that can take quite some time to fully sync.

CCA Discovery synchronizing

Once complete the Discovery Scan Progress chart displays a successful synchronized Discovery process

CCA Discovery finished

The Discovery Scan Progress header shows the completed scan timestamp and the number of discovered data points.