Babel Buster MX-71-RTU Modbus to BACnet IP Gateway

Babel Buster Configuration Builder

You would normally use the web pages found in the gateway itself to configure the gateway. But you may be able to take a shortcut if you have a long list of registers already in CSV file format.

The Babel Buster Configuration Builder is used to facilitate building of configuration files (aka "profiles") for Babel Buster network gateways by converting XML files to CSV files and vice versa. This simplifies the process of creating or changing a large number of entries because you can use any standard spread sheet program to manipulate the content of one or more CSV files, and then convert that into an XML configuration file that can be loaded into the gateway. If the gateway will be reading a long list of Modbus registers, for example, you can sometimes just copy a list of registers from another source, paste into a simple text file, and import that into the spread sheet program. Then add a header line to label the content, add a handful of additional columns, and you quickly have most of a complete configuration. Very often, the only thing that changes from one line to the next is the register number. The other entries can be quickly made by entering once and using the spread sheet program's "fill down".

The Babel Buster Configuration Builder simplifies the process of making global changes to a large number of gateway register or object "maps". The gateway “converts” protocols by querying devices on one network with one protocol, and then saving that data internally so that it may be accessed on another network using a different protocol. The designation of what should be queried is referred to as a “map” in the gateway. In most applications, most or all maps are “read” maps, meaning the gateway will read data from some other device. A “write” map will write data to that device. Most often the gateway will actively read data from a device and passively wait for another device on the alternate network to query the gateway to obtain that data. But it is also possible to configure the gateway with two sets of maps, one to actively read device A using protocol A, and then actively write that data to device B using protocol B. The process can also be reversed, and can be done concurrently. You may both read and write data on one network while writing and reading data on the other network.

What to Expect from the Conversion Tool

The point of this configuration builder is to simplify the process of entering long lists of registers or objects. Where most of the parameters are the same for many maps, using a spread sheet program's "fill down" makes the process fast and easy.

There are situations where creating a CSV file for configuring some aspect of the gateway is actually going to create more work than simply using the web UI or PC based software to directly configure that aspect. Configuring the Modbus RTU port baud rate is one such example. There is only one setting. A CSV file would create more work rather than less, as intended. Therefore, the configuration builder only supports CSV import/export for those aspects of gateway configuration that involve long lists of largely replicated parameters. There are a very limited number of list type entries that are not supported in part because they are seldom used, and in part because very little of the list is replicated from one entry to the next. The BACnet Broadcast Distribution Table is one such example.

Do note, however, that if you have already done a lot of configuration, have saved that to an XML file, and want to add a list from a CSV file, you can do that. Refer to the section in the user guide that talks about modifying an existing configuration.

Get the Tool Now!

This tool is free and available for download now. Unzip and run the bb-builder-setup.exe file. Open the program, and click the help icon (blue question mark in upper left corner) to access the user guide. The very first section tells you how to get started.

NOTE: Version 2 of the configuration builder tool supports BB3-7101 file formats, and supports upgrading XML files from BB2-7010 format to BB3-7101 format. Also do note that the BB3-7101 can import CSV files directly. If you have a compatible CSV file ready to go, just upload that into the BB3-7101 - no need to convert to XML first.

Download the Babel Buster Configuration Builder here.

Configuration Service

Need even more help with your network gateway configuration task? We can do the configuration for you, or at least give you a big head start. We are working on building a library of configuration files for commonly used devices. If yours isn't already in the library, we will add it. To get started, open a support ticket and attach a copy (typically a .pdf document) of whatever documentation you have for your device. In addition, provide a list of the registers or objects you want to read or write. Of course, you can also start by asking if we already have that device in our library. If you have a proprietary application that you do not want included in our library, you can hire us at a very reasonable rate to do custom, proprietary configuration work for you, too.