Define an enumeration

An enumeration is a single value (0-15) that is used to define a condition that is determined by multiple-bit input. You will add enumerations to handle scenarios that are more complicated than simply true-false, to allow for dynamic contingencies. For example, when you need to use multiple bits to describe the position of a circuit breaker, you might do the following:

Bit y (closed) | Bit x (open). Note that the least significant bit is register 1.

Bit x | Bit y

Status

Circuit Breaker Position

Returned Value

0 | 0

Indeterminate

Circuit breaker is neither open nor closed

0

0 | 1

Open

Circuit breaker is open.

1

1 | 0

Closed

Circuit breaker is closed.

2

1 | 1

Error

Circuit breaker is reporting both open and closed condition.

Possible device/wiring error

3

Using the enumerated status, we place the register and bitmask for the open position in register 1 (least significant) and the register and bitmask for the closed position in register 2 (most significant).

Use special tags to control circuit breaker status

When you want to include a device that does not have a pre-defined device profile (such as a third-party circuit breaker), you must identify the registers that the device uses for the operations you want, then choose the correct tags and tag addresses to write to these registers. Finally, when creating the one-line on the graphics page, you will choose the appropriate genie:

  1. Determine the device registers used for the open and close operations on the circuit breaker.
  2. In the Profile Editor, choose the tag needed for each operation.
  3. Ensure that tag address references the correct action and register(s).
  4. When adding a genie for the circuit breaker on the graphics page, choose from the default library.