Auto-Created States Text - Metasys - LIT-1201531 - System Integration - BACnet Controller Integration - 10.1

BACnet Controller Integration Technical Bulletin

Product name
BACnet Controller Integration
Document type
Technical Bulletin
Document number
Revision date

In addition to the standard enumeration sets (which define the text displayed for each state of a Binary and Multistate object) provided with the Metasys system, Auto-Created States Text can be automatically added when a non-Johnson Controls device or select Johnson Controls-labeled BACnet device is discovered and added to a supervisory controller. An Auto-Created States Text can be automatically assigned to the States Text field of a mapped object.

The BACnet State_Text property is read when an online supervisory controller discovers BACnet objects (BI, BO, BV, MSI, MSO, and MSV), and when a user views the object. When the value of the integrated point's States Text attribute is updated and the user-selected states attribute is false, the Metasys system checks to see if the BACnet State_Text property associated with the object matches a standard enumeration set used with Metasys States Text. Existing Auto-Created States Text are also checked.

If a match occurs, the Metasys system automatically assigns the matching States Text value to the object. If no match occurs, the Metasys system automatically creates and assigns a new enumeration set. All new sets added at each supervisory controller are copied to the Site Director. New States Text added have the following limitations:

  • 1,000 new enumeration sets maximum

  • 260 Kb memory for all sets

  • For any multi-value BACnet object (MSI, MSO, MSV), the number of states can be between 2 and 500, with a maximum of 60 characters for any one state. Using the Command window, you can only manually select from the first 32 states.

  • Auto-Created States Text can only be automatically assigned to one object and cannot be edited using the Metasy system.

  • Auto-Created States Text is saved in the Site Director, and cached in the other devices.

  • The Rediscover Text Strings device level command allows you to reset the States Text across an entire Metasys supervisory device; It rediscovers text strings from all the mapped BACnet objects.

Table 1. Auto-Created Enumeration Sets Usage by Metasys Product

Metasys Product

Uses Auto-Created Enumeration Sets

Makes Changes to Auto-Created Enumeration Sets

Metasys Advanced Reporting System with Energy Essentials









SCT, SCT Simulation






Auto-Created Enumeration Sets are not translatable and do not appear in the dictionary viewer tool. They are local to the site where they are defined.

Important: When using Auto-Created Enumeration Sets, you must upload the Site Director first, then the network engine where you mapped the object. If you download from SCT, download the Site Director first, and then the network engine. You must do the procedure in this order, or the enumeration set text files do not match, and the state values are not indicated correctly.

For Binary Values and Multistate Variables, Auto-Created States Text is indicated by an asterisk at the beginning of the States Text value, as shown in Figure 1.

Important: If you edit an Auto-Created States Text value to choose a standard enumeration set, you lose the option to reselect the Auto-Created Enumeration Set. To restore the Auto-Created Enumeration Set, you can execute the Restore Controller States Text or use the Rediscover Text Strings supervisory device level command to reset all of the mapped objects.
Figure 1. Auto-Created Text For Binary Value

Figure 2. Auto-Created Text for Multistate Variable Objects

After a multi-value BACnet object from a third-party device is mapped to Metasys, in a rare instance the SMP UI might display its enumeration set ID with the current value of the object (for example, 1031:10 (text not found) Normal). The first number in this example (1031) is the enumeration set ID and the second number is the enumeration value counting from 0. If you see the current value of the object represented in this manner, either the UserDictionary on the site is out of sync or the number of states property at the third party device has changed. To resolve, perform a Rediscover Text Strings command at the network engine to which the third-party device reports. This action flushes the locally saved auto-discovered text and updates all objects with the current text.