Format code definitions

The address field is part of the tag. It includes a variety of attributes, some of which are required, and some optional. The following tables list the attributes, whether they are required, and their possible modifiers. All parts of a tag are case sensitive. The order of the fields is fixed; and all fields are separated by semi-colons. See About logic codes for templates of constructed tags.

Real-Time Format Code Definitions

Attributes

Modifiers

Comments

T (type)

Required

SS = single status

DS = double status enumeration

ST = string

UT = UTC time

MV = measured value (float)

CM = complex measured value (float)

BC = binary counter (integer)

 

 

 

 

 

 

Temporarily, this may return a string; when Power Operation is upgraded to handle large integers, this will change.

D (module—Micrologic devices)

B = BCM

P = PM

M = MM

C = CCM

 

M/m/S/s/C/c/I/i (register type)

M = holding registers in hexadecimal

m = holding registers in decimal

S = input coil (status register) in hexadecimal

s = input coil (status register) in decimal

C = output coil (writable only) in hexadecimal

c = output coil (writable only) in decimal

I = input register (read only) in hexadecimal

i = input register (read only) in decimal

 

Register Number Modifiers (register number from 1–4)

u## = ## registers are unsigned, ## is a decimal

s## = ## registers are signed; ## is a decimal

After the modifier, there may be a number indicating scaling factor. See “V,” below in this table. Used for conversion to SI units, this number will be:

RegisterValue x scale

For SS and DS: there must be a 1U default; the modifier will be a bitmask:

- The mask must use hex only, 16 bits/register

- Attach the ones, then the zero mask, to the register; if you only have ones masks, just attach them

- Only one register cases can be inverted. Add :I after the masks for inversion.

N (scale)

numerical entries; range is -10 to 10

N defines a constant scale; the logic code knows how to use it.

R (scale register)

 

the register number in decimal

R defines the holding register where the scale is held; the logic code knows how to use it.

E (priority)

single digit: 1, 2, or 3; default 2 is used if this is not included

(1 = high, 2 = normal, 3 = low)

Defines the priority Power Operation uses in processing data.

V (conversion factor)

Use scientific notation without the decimal.

Examples: 354E-3 = 0.354

354E1 = 3540
Will be multiplied before the value is returned.

L:P (logic code)

Required

 

 

The number that is used comes from the Logic Codes table.

L:P is the logic code for PowerLogic. Other codes may follow, such a L:I for ION.

For logic code descriptions, see About logic codes

Alarm format code definitions

Attributes

Modifiers

Comments

T (type)

Required

ALM = alarm

 

D (module—optional for Micrologic devices)

B = BCM

P = PM

M = MM

C = CCM

BCM is straight addressing, and therefore, optional.

F (file)

Required

File number will be in decimal, up to 5 digits

 

Q (unique ID)

Required

Unique ID will be in decimal.

This number can be huge.

Control format code definitions rules of operation

These rules are true for predefined and custom codes:

Address structure

Result

C:N;(action)

If 1, perform action. If 0, undefined.

C:N;(action1);(action2)

C:NO;(action1);(action2)

If 1, perform action1. If 0, perform action 2.

C:NC;(action1);(action2)

If 1, perform action2. If 0, perform action1

Predefined control format codes

Attributes

Modifiers

Comments

C (command)

Required

NO = normally open

NC = normally closed

N = normal operation

 

 

Normal operation does not have a closed/open status.

OPERATE (command word)

n/a

Two required for NO and NC.

Predefined reset format codes

Attributes

Modifiers

Comments

Reset (command word)

n/a

Entering a one to this tag causes the reset to take place.

Custom control and reset format codes

Attributes

Modifiers

Comments

C (command)

Required

NO = normally open

NC = normal closed

N = normal operation

 

 

Normal operation does not have a closed/open status.

Followed by one or two entire “write” addresses; used only for logic codes 101, 102, 103. For logic code descriptions, see About logic codes.

Write Address format: T:SS;m:##:#;L.:P:101

Example: C:NO;T:SS;m:1234:1;L:P101;T:SS;m:3456:1;L:P101