TemperZone Babel Buster 3 User manual

BB3-7101-TZ: BACnet–Modbus Network Gateway User Guide 1 | Page
Relevant for model BB3-7101-TZ
Compatible exclusively with the Temperzone UC8
Revision
Date
Notes
1
June 2023
Initial Release

BB3-7101-TZ: BACnet–Modbus Network Gateway User Guide 2 | Page
1Introduction............................................................................................................... 4
1.1 Application of the BB3-7101-TZ .....................................................................................4
2Connecting Gateway for the First Time.......................................................................5
2.1 Connectors and Indicators .............................................................................................5
2.2 Opening the Web User Interface.....................................................................................6
2.3 Changing the Gateway IP Address.................................................................................7
3Local Objects............................................................................................................. 7
3.1 Behaviour of Input vs Output Objects ............................................................................7
3.2 Local Objects Reliability Codes ......................................................................................8
3.3 Analog Objects ................................................................................................................8
3.3.1 Analog Input Objects ...............................................................................................8
3.3.2 Analog Output Objects ............................................................................................9
3.3.3 Analog Value Objects ............................................................................................10
3.4 Binary Objects................................................................................................................11
3.4.1 Binary Input Objects...............................................................................................11
3.4.2 Binary Output Objects............................................................................................11
3.4.3 Binary Value Objects..............................................................................................11
3.5 Multistate Objects .........................................................................................................13
3.5.1 Multistate Input Objects ........................................................................................13
3.5.2 Multistate Output Objects .....................................................................................13
3.5.3 Multistate Value Objects .......................................................................................13
4Configuring Gateway as a BACnet Device ................................................................. 15
4.1 Device Object Parameters ............................................................................................15
4.2 Network Settings ...........................................................................................................16
4.3 BACnet Client Diagnostics............................................................................................17
4.3.1 BACnet Error Code List..........................................................................................18
4.4 Configuring Gateway as a BACnet Server ...................................................................19
4.4.1 Server Configuration..............................................................................................19
4.4.2 Accessing Local Objects.......................................................................................19
4.5 Configuring BBMD.........................................................................................................21
4.5.1 Registering as a Foreign Device ...........................................................................22
4.5.2 Allowing Other Devices to Register Locally .........................................................23
4.5.3 Broadcast Distribution Table ................................................................................24
4.5.4 User Login Password.............................................................................................24

BB3-7101-TZ: BACnet–Modbus Network Gateway User Guide 3 | Page
5Troubleshooting ...................................................................................................... 25
5.1 BACnet IP Troubleshooting ..........................................................................................25
5.1.1 Most Common Problems ......................................................................................25
5.1.2 Using Network Discovery Tool..............................................................................25
6Appendices.............................................................................................................. 29
6.1 Appendix A: Hardware Details......................................................................................29
6.1.1 Wiring......................................................................................................................29
6.1.2 Front Panel LED Indicators....................................................................................30
6.1.3 RS-485 Line Termination & Bias ...........................................................................31
6.2 Appendix B: BACnet Object Property Codes ...............................................................31
6.3 Appendix C: SSL Certificates for Secure Web (HTTPS)..............................................40
6.3.1 X.509 Auto-Certificate Generation........................................................................40

BB3-7101-TZ: BACnet–Modbus Network Gateway User Guide 4 | Page
The Babel Buster 3: BB3-7101-TZ is a BACnet gateway device that converts the Temperzone
unit’s UC8 Modbus RTU communication to BACnet IP protocol. This manual provides
instructions for operating and setting up the BB3-7101-TZ to communicate with Temperzone
units using BACnet IP communication protocol.
The BB3-7101-TZ gateway serves as a BACnet IP client for a Modbus RTU master or slave.
The BB3-7101-TZ can be considered as a data server with multiple network ports that have
access to the internal database. The BB3-7101-TZ is not a router –BACnet devices cannot
interact directly with Modbus devices or vice versa. Both BACnet and Modbus have access
to the internal data objects which are updated according to rules defined by Temperzone.

BB3-7101-TZ: BACnet–Modbus Network Gateway User Guide 5 | Page
2
Follow these steps to connect to the BB3-7101-TZ.
1. Connect power cables:
Apply 12-24VDC or 24VAC to the terminal marked “POWER”.
Apply common or ground to one of the terminals marked “GND”.
2. Connect a CAT5 cable between the RJ-45 jack on the gateway and your network
switch or hub.
Note: You may be unable to connect directly to your PC unless you use a “crossover” cable (or your PC
supports auto-MDX, which many newer laptops do).
3. Apply power.
A blue LED inside the case should light, showing power is present.
If the link LED (yellow) on the RJ-45 (CAT5) jack is not illuminated, check your Ethernet cable
connections. Both link (yellow) and activity (green) LEDs on the RJ-45 jack will be illuminated
solidly for a short time during boot-up. The entire bootup process will take 1-2 minutes,
during which time you will not be able to connect with a browser.
Refer to 6.1 Appendix A: Hardware Details for additional detail pertaining to connections
and indicators as well as optional internal jumper settings.

BB3-7101-TZ: BACnet–Modbus Network Gateway User Guide 6 | Page
The default IP address as shipped is 10.0.0.101. Open your browser and enter
“http://10.0.0.101/” in the address bar. You should see a page with the “Babel Buster 3 &
Temperzone” header as shown below. The model should show “BB3-7101-TZ”. From this
point, you will find help on each page on the website contained within the product.
If your PC is not already on the 10.0.0.x domain, and you are unable to connect, you may
need to temporarily change your computer’s IP address to a static IP address “10.0.0.x”
where “x” is any number except 101. Your subnet mask should also be set to 255.255.255.0.
When you click on any of the page tabs such as ‘System’, you will be asked for a username
and password. The only login as shipped is:
Username: system
Password: admin

BB3-7101-TZ: BACnet–Modbus Network Gateway User Guide 7 | Page
To change the IP address of the gateway, go to the ‘System’ tab and navigate to the
‘Network’page under ‘Settings’. The following page should appear.
Change the IP address, subnet mask and gateway if applicable. Click Change IP to save the
changes. Programming this into flash memory takes around half a minute. The new IP
address will only take effect following the next system restart or power cycle.
When considering input and output values you should think of the BACnet system as the
frame of reference rather than the BB3-7101-TZ device.
An input will receive input to the system from the device and so be a read only value. The
value will be displayed in either analog form, binary form or multistate form.
An output will send data from the system to the device and so be a writable value. The value
shall be provided as either analog form, binary form or multistate form.
An object can be either an input or an output and is generally both read and write. The values
will be read or written in either analog form, binary form or multistate form.

BB3-7101-TZ: BACnet–Modbus Network Gateway User Guide 8 | Page
Reliability codes may be any of the following:
Modbus client/master, no response from slave (64)
Modbus client/master, crc error (65)
Modbus exception, illegal function code (66)
Modbus exception, illegal data address (67)
Modbus exception, illegal data value (68)
Modbus exception, code+65, rarely used (69..79)
Local device, configuration property fault (80)
Faulty Modbus packet (81)
BACnet IP client, device timeout (82)
BACnet IP client, error returned by server (83)
Status flags A, B, C & D indicate the following, 0 meaning not true, 1 meaning true:
A = in alarm
B = fault
C = overridden
D = out of service
The source of data for an Analog Input object will typically be reading from the UC8
Controller. These values are Read Only. They may appear editable, however there is no way
to save any changes made on site.
The object name, units, value, and status are shown for the object number entered at the top
of the page. Click ‘Prev/Next’to scroll through the list. Click ‘Refresh’to update the page.
The object may be set Out of Service by checking that box and clicking Update. The present
value may be changed by entering a value, checking Force, and clicking Update.

BB3-7101-TZ: BACnet–Modbus Network Gateway User Guide 9 | Page
The source of data for an Analog Input object will typically be reading from some other
BACnet or Modbus device via the map indicated by the Device Link. The mapped device will
be polled at the rate specified by the Read Map.
Out of Service means polling of the mapped remote device will stop. While out of service, the
present value may be written by the BACnet client. Data may be forced via this web page at
any time but will be overwritten by the next mapped client update unless the object is out of
service.
Device link will indicate RTU, followed by R for read or W for write, and a number which is the
map number in the table of read or write maps for mapping to this BACnet object. The
designation R means read from a UC8 controller, and W means write to a UC8 controller.
The destination of data for an Analog Output object will be from a UC8 controller. These may
appear editable, however there is no way to save any changes made on site.
The object name, units, value, and status are shown for the object number entered at the top
of the page. Click Prev/Next to scroll through the list. Click Refresh to update the page.
The destination of data for an Analog Output object will be writing to the UC8 controller via
the map indicated by the Device Link. The UC8 controller will be updated upon change of
source data and/or periodically as defined by the Write Map.
The Analog Output object is command able, meaning the BACnet client must write both a
value and a priority level for that value. The highest-level value will be the one written to the
remote device (if one is mapped). If all values are relinquished, the relinquish default value
will be written to the remote device.
To set an output object manually from this page, check the Force box, enter a value in the
Present Value window, and select a priority level to assign to your forced value.
Then click Update. To return a given priority level to NULL, simply type the word NULL in the
Present Value window, check Force, and click Update.
Out of service means the mapped remote device will not be written to. Values written by the
BACnet client will be retained, but only applied when this object is placed back in service. At
that time, the highest priority value will be written to the remote device.
Reliability codes indicate errors as itemized on the tabular object list.

BB3-7101-TZ: BACnet–Modbus Network Gateway User Guide 10 | Page
Analog Value objects may be both a source and destination for a UC8 controller. These may
appear editable, however there is no way to save any changes made on site.
The object name, units, value, and status are shown for the object number entered at the top
of the page. Click Prev/Next to scroll through the list. Click Refresh to update the page.
The object may be set Out of Service by checking that box and clicking Update. The present
value may be changed by entering a value, checking Force, and clicking Update.
Analog Value objects may be both a source and destination. The source of data for the
Value object will be reading from a remote device when associated with a Read Map. The
destination of data for the Value object will be writing to a UC8 Controller when associated
with a Write Map.
The Value object may be simultaneously associated with both Read and Write maps pointing
to the same remote device object. When this Value object receives new data (from any
source), this data will be written to the mapped remote device before any subsequent read
from the same device. Thus, the Value data is not discarded by the read operation before the
new data can be written.

BB3-7101-TZ: BACnet–Modbus Network Gateway User Guide 11 | Page
The source of data for a Binary Input object will typically be reading from a UC8 controller.
These may appear editable, however there is no way to save any changes made on site.
The object name, units, value, and status are shown for the object number entered at the top
of the page. Click Prev/Next to scroll through the list. Click Refresh to update the page.
The object may be set Out of Service by checking that box and clicking Update. The present
value may be changed by entering a value, checking Force, and clicking Update.
The source of data for a Binary Input object will typically be reading from A UC8 controller
via the map indicated by the Device Link. The UC8 controller will be polled at the rate
specified by Read Map.
Check 'Deconfigure' and click Update to erase configuration for this object.
There are no binary objects operational in the program. These may appear editable, however
there is no way to save any changes made on site.
Binary Value objects may be both a source and destination for the UC8 controller. These
may appear editable, however there is no way to save any changes made on site.

BB3-7101-TZ: BACnet–Modbus Network Gateway User Guide 12 | Page
The object name, units, value, and status are shown for the object number entered at the top
of the page. Click Prev/Next to scroll through the list. Click Refresh to update the page.
The object may be set Out of Service by checking that box and clicking Update. The present
value may be changed by entering a value, checking Force, and clicking Update.
Binary Value objects may be both a source and destination for a UC8 controller. The source
of data for the Value object will be reading from a UC8 controller when associated with a
Read Map. The destination of data for the Value object will be written to a UC8 controller
when associated with a Write Map. If a UC8 controller is mapped, the UC8 links are
displayed above. You may click on either link to view the respective mapping.
The Value object may be simultaneously associated with both Read and Write maps pointing
to the same UC8 controller object. When this Value object receives new data, this data will
be written to the mapped UC8 controller before any subsequent read from the UC8
controller. Thus, the Value data is not discarded by the read operation before the new data
can be written.

BB3-7101-TZ: BACnet–Modbus Network Gateway User Guide 13 | Page
The source of data for a Multistate Input object will typically be reading from a UC8
controller.
The object name, value, and status are shown for the object number entered at the top of the
page. Click Prev/Next to scroll through the list. Click Refresh to update the page.
The object may be set Out of Service by checking that box and clicking Update. The present
value may be changed by entering a value, checking Force, and clicking Update.
There are no Multistate output objects operational in the program. These may appear
editable, however there is no way to save any changes made on site.
There are no Multistate value objects operational in the program. These may appear
editable, however there is no way to save any changes made on site.

BB3-7101-TZ: BACnet–Modbus Network Gateway User Guide 14 | Page

BB3-7101-TZ: BACnet–Modbus Network Gateway User Guide 15 | Page
The identity of the gateway as a BACnet device is entered on this page, along with other
device object parameters.
Enter a device instance from 1 to 4,194,303. Enter a port number (note that 47808 is the
standard port expected by most BACnet IP devices).
The device object name, description, and location are entered here. The device object name
is expected to be unique to the entire BACnet network. Standard BACnet timeout and retry
values are also entered on this page. These values are stored in a special area of non-
volatile memory.
Network Number is optional, and normally left set to zero here. Normally, BACnet routers will
take care of any network number translation needed. If you leave this network number entry
set to zero, then this BB3-7101-TZ WILL respond to any local broadcast message. If you
enter a network number here, then this device WILL NOT respond to local broadcast
messages and will only respond to remote broadcast messages or global broadcast
messages. The default setting is zero, and BTL certification was done with the default
setting of zero - no other number is needed here for normal typical use.
Local command priority is used when the result of a Calculate or Copy rule is written to a
commandable object. It is also used if the result of a client read map is saved to a local
commandable object, although this would not be recommended. Output objects are
commandable. Client read maps should store results in input or value objects, while client
write maps take their data from value or output objects. In other words, output objects
should not be used for input.
Check the "allow" check box to allow faults to self-reset. These faults are those conditions
indicated by a non-zero reliability code in any of the data objects (see list on data objects
pages). Normally an external client needs to read the reliability code to acknowledge the
fault before it will automatically reset. By checking the "allow" check box, faults will

BB3-7101-TZ: BACnet–Modbus Network Gateway User Guide 16 | Page
automatically self-reset without acknowledgement. This is required any time the client does
not periodically read reliability codes but does check fault status - a behavior known to be
common to BMS front ends.
Check the "disable self-restart" box to disable self-restart upon communication loss. If this
box is not checked, this gateway will restart itself to auto-recover if communications with
devices has started and then stopped.
By default, when Modbus reads values that are mapped to a Multi-State object, the values
are offset by one. Multi-State objects are not allowed to contain a value of zero per BACnet
protocol standard. Since Modbus doesn't often deal very well with zero being prohibited,
values are offset by one. Therefore, where Modbus sees zero, the BACnet Multi-State object
will see one. This offset only applies to Multi-State objects. You can disable this offset by
checking the "Disable Modbus offset" box and saving the setting. Just be aware that with the
offset disabled, Modbus will not know the difference between zero and one because any
attempt to write zero to the Multi-State object will be forced to one. You can safely disable
the offset when only reading Multi-State objects, but use extra caution when writing to Multi-
State objects from Modbus with the offset disabled.
Click Save to store. This store process will take a little while as these parameters are being
saved to non-volatile memory. A change in port number will not take effect until the next
system restart.
The two most important things that must be unique on the BACnet IP network are device
instance, and IP address. The IP address is set on the Network page.
Select either Static or Automatic for IPv4. To change the Static IP address of this device,
enter the address, subnet mask, and gateway, then click Apply.
Select Automatic to specify that DHCP should be used to obtain an IP address upon power-
up. IP address change will take effect upon next power cycle.

BB3-7101-TZ: BACnet–Modbus Network Gateway User Guide 17 | Page
The above screenshot is only a portion of the Network setup page, and is the only part of the
Network page that is required for BACnet IP. The remainder of the Network page is
discussed in Section 11.3.
The Web User Interface is accessible via IPv6; however, the BACnet IP Client does not yet
support IPv6. The only demonstrated version of BACnet IP over IPv6 does not use actual
IPv6 addresses - it uses Virtual MAC addresses (VMAC) and address translation tables. The
VMAC approach allows IPv6 to coexist with original IPv4 devices. As of the BTL testing of
this device, test specifications for BACnet IP over IPv6 were not available and thus IPv6
support is not included in the BTL tested device.
If errors are detected in the course of reading or writing other BACnet objects via the client's
maps, they will be indicated on the errors pages.
Errors for BACnet client read/write maps are shown on these pages. Only those maps with
errors to report are listed. Refer to the code and class lists below for interpretation. In the
illustration above, error class 1 says the error refers to "object" and the code says "unknown
object". In other words, AV 6125 does not exist in the device shown.
Proprietary class 82, code 0, is generated locally indicating a timeout, no response received
from remote server. All other codes listed below are returned by the remote server.

BB3-7101-TZ: BACnet–Modbus Network Gateway User Guide 18 | Page
0 = ERROR_CLASS_DEVICE
1 = ERROR_CLASS_OBJECT
2 = ERROR_CLASS_PROPERTY
3 = ERROR_CLASS_RESOURCES
4 = ERROR_CLASS_SECURITY
5 = ERROR_CLASS_SERVICES
/* valid for all classes */ 0 = ERROR_CODE_OTHER
/* Error Class - Device */
2 = ERROR_CODE_CONFIGURATION_IN_PROGRESS
3 = ERROR_CODE_DEVICE_BUSY
25 = ERROR_CODE_OPERATIONAL_PROBLEM
/* Error Class - Object */
4 = ERROR_CODE_DYNAMIC_CREATION_NOT_SUPPORTED
17 = ERROR_CODE_NO_OBJECTS_OF_SPECIFIED_TYPE
23 = ERROR_CODE_OBJECT_DELETION_NOT_PERMITTED
24 = ERROR_CODE_OBJECT_IDENTIFIER_ALREADY_EXISTS
27 = ERROR_CODE_READ_ACCESS_DENIED
31 = ERROR_CODE_UNKNOWN_OBJECT
36 = ERROR_CODE_UNSUPPORTED_OBJECT_TYPE
/* Error Class - Property */
8 = ERROR_CODE_INCONSISTENT_SELECTION_CRITERION
9 = ERROR_CODE_INVALID_DATA_TYPE
32 = ERROR_CODE_UNKNOWN_PROPERTY
37 = ERROR_CODE_VALUE_OUT_OF_RANGE
40 = ERROR_CODE_WRITE_ACCESS_DENIED
41 = ERROR_CODE_CHARACTER_SET_NOT_SUPPORTED
42 = ERROR_CODE_INVALID_ARRAY_INDEX
44 = ERROR_CODE_NOT_COV_PROPERTY
45 = ERROR_CODE_OPTIONAL_FUNCTIONALITY_NOT_SUPPORTED
47 = ERROR_CODE_DATATYPE_NOT_SUPPORTED
50 = ERROR_CODE_PROPERTY_IS_NOT_AN_ARRAY
/* Error Class - Resources */
18 = ERROR_CODE_NO_SPACE_FOR_OBJECT
19 = ERROR_CODE_NO_SPACE_TO_ADD_LIST_ELEMENT
20 = ERROR_CODE_NO_SPACE_TO_WRITE_PROPERTY
/* Error Class - Security */
1 = ERROR_CODE_AUTHENTICATION_FAILED
6 = ERROR_CODE_INCOMPATIBLE_SECURITY_LEVELS
12 = ERROR_CODE_INVALID_OPERATOR_NAME
15 = ERROR_CODE_KEY_GENERATION_ERROR
26 = ERROR_CODE_PASSWORD_FAILURE
28 = ERROR_CODE_SECURITY_NOT_SUPPORTED
30 = ERROR_CODE_TIMEOUT

BB3-7101-TZ: BACnet–Modbus Network Gateway User Guide 19 | Page
/* Error Class - Services */
5 = ERROR_CODE_FILE_ACCESS_DENIED
7 = ERROR_CODE_INCONSISTENT_PARAMETERS
10 = ERROR_CODE_INVALID_FILE_ACCESS_METHOD
11 = ERROR_CODE_ERROR_CODE_INVALID_FILE_START_POSITION
13 = ERROR_CODE_INVALID_PARAMETER_DATA_TYPE
14 = ERROR_CODE_INVALID_TIME_STAMP
16 = ERROR_CODE_MISSING_REQUIRED_PARAMETER
22 = ERROR_CODE_PROPERTY_IS_NOT_A_LIST
29 = ERROR_CODE_SERVICE_REQUEST_DENIED
43 = ERROR_CODE_COV_SUBSCRIPTION_FAILED
46 = ERROR_CODE_INVALID_CONFIGURATION_DATA
48 = ERROR_CODE_DUPLICATE_NAME
49 = ERROR_CODE_DUPLICATE_OBJECT_ID
The BB3-7101-TZ contains a set of BACnet objects whose only purpose is to store copies of
data obtained from the UC8 controllers. This copy of data may then be queried by different
devices.
The only configuration needed to use the BB3-7101-TZ as a BACnet server is to set the
Device instance on the BACnet page. The device should also be given an object name that
will be unique on the entire network. Configuring the gateway as a BACnet Device is
described in more detail in Section 4.
The collection of local objects includes Analog, Binary, and Multi-State types of objects, and
includes Input, (commandable) Output, and (writeable) Value types of each of those objects.
The BB3-7101-TZ also contains a Device object which is configured in the above screen.

BB3-7101-TZ: BACnet–Modbus Network Gateway User Guide 20 | Page
Data may be placed in the local objects by other devices writing to the BB3-7101-TZ, or by
the BB3-7101-TZ querying other devices. When the BB3-7101-TZ is configured to query other
devices, these operations are defined by “read maps” and “write maps” associated with the
respective client function (BACnet client).
The following pages illustrate the Analog Input object pages and the Binary Output object
pages. The remaining object pages found in the BB3-7101-TZ are virtually identical, and are
not replicated here.
Each object page initially comes up as a table of object data. Click on the object number in
the left-hand column to expand the view of that object and access the windows that let you
locally force values, assign units, etc.
The object name, units, value, and status are shown for a list of objects starting with the
number entered at the top of the page. Click Prev/Next to scroll through the list. Click on the
object number in the first column to change name, units, COV, and out-of-service state.
The source of data for an Analog Input object will be reading from the UC8 controller. Click
on the object number in the first column for more detail including the link to any client map
providing data to this object.
Reliability codes may be any of the following:
Modbus client/master, no response from slave (64)
Modbus client/master, crc error (65)
Modbus exception, illegal function code (66)
Modbus exception, illegal data address (67)
Modbus exception, illegal data value (68)
Modbus exception, code+65, rarely used (69..79)