Errata exists for this version of the document.

The OptionSetType VariableType is used to represent a bit mask. Each array element of the OptionSetValues Property contains either the human-readable representation for the corresponding bit used in the option set or an empty LocalizedText for a bit that has no specific meaning. The order of the bits of the bit mask maps to a position of the array, i.e. the first bit (least significant bit) maps to the first entry in the array, etc.

In addition to this VariableType, the DataType OptionSet can alternatively be used to represent a bit mask. As a guideline the DataType would be used when the bit mask is fixed and applies to several Variables. The VariableType would be used when the bit mask is specific for only that Variable.

The DataType of this VariableType shall be capable of representing a bit mask. It shall be either a numeric DataType representing a signed or unsigned integer, or a ByteString. For example, it can be the BitFieldMaskDataType.

The optional BitMask Property provides the bit mask in an array of Booleans. This allows subscribing to individual entries of the bit mask. The order of the bits of the bit mask points to a position of the array, i.e. the first bit points to the first entry in the array, etc. The VariableType is formally defined in Table 74.

Table 76 – OptionSetType Definition

Attribute

Value

BrowseName

OptionSetType

IsAbstract

False

ValueRank

−1 (−1 = Scalar)

ArrayDimensions

{0} (0 = UnknownSize)

DataType

BaseDataType

References

NodeClass

Browse

Name

DataType

TypeDefinition

ModellingRule

Subtype of the BaseDataVariableType defined in 7.4

HasProperty

Variable

OptionSetValues

LocalizedText[]

PropertyType

Mandatory

HasProperty

Variable

BitMask

Boolean[]

PropertyType

Optional