User Manual

Building Operator Engineering Guide
Adding Data Points Using Building Operator Discovery
1
30 | 69
A6V11881627_en_k
● Begin column "A' data with lowercase letters.
● Add a ping register so that Building Operator Discovery can monitor the
controller to make sure it’s active.
● Manually upload this file to Building Operator Discovery.
Configuration Information
The following information is required to help configure your .CSV file.
● name (required): Name of the register. It must be unique and must start with a
lowercase letter (a-z). A-Z, a-z, 0-9, and underscores are allowed. No spaces
or other special characters.
● addr (required): The address of the register that follows the modbus
convention.
Types of data:
– bit: Bool
– u1: Unsigned 8-bit Int
– u2: Unsigned 16-bit Int
– u4: Unsigned 32-bit Int
– s1: Signed 8-bit Int
– s2: Signed 16-bit Int
– s4: Signed 32-bit Int
– s8: Signed 64-bit Int
– f4: 32-bit Float
– f8: 64-bit Float
● Bit Mask Types: Supports a position notation for cases where bits are packed
into input or holding registers. Format: name, addr, data, rw.
Examples:
– do0, 40101, bit:0, rw
– do1, 40101, bit:1, rw
– do2, 40101, bit:2, rw
● Word and Byte Order: If register data not stored in network byte order, you can
specify the order using suffix
– u21e Unsigned 16-bit Int - Little endian byte and word order
– u21eb Unsigned 16-bit Int - Little endian byte order only
– u21ew Unsigned 16-bit Int - Little endian word order only
● rw (required): Determines read and write permissions.
– rw: Register may be read and written.
– r: Register is read-only.
– w: Register is write-only.
● scale (optional): Allows user to apply a scale factor to the registers. Format:
(operator)(number) where the number is a numeric constant.
Examples:
– Add: +1.5
– Minus: -0.25
– Multiply: *10
– Division: /1000
● dis (optional): An optional tag that allows the user to specify a display name for
the register.
● unit (optional): Defines the unit to use for the register.
● tags (optional): Tags to apply to the point when learned into the database.
● folderPath (optional): User can organize points by applying a folderPath.