Properties

16 bit word Read-Write Starting address 0x40001 to 0x4FFFF when address mapping is active or 0 to FFFF when addressmapping deactivated

The HoldingRegister item type has the following properties:

NameDescriptionIDFlags
DescriptionA description of what this item does. This is free text, so you can write anything you like here.101Persisted
DirectionDirection of data. Input (false) or Output (true).5040Persisted
ByteorderOnly valid when Valutype is Unicode String or ASCII, overrides module property Byteorder.10013Persisted, Enumerated
Check rangeValidate range of value, set by Hi Range and Lo Range10200Persisted
Endian1Only valid when the Valuetype property is set to "Unicode String" or "ASCII". This property overrides the module's endian.10012Persisted, Enumerated
External quality tagExternal tag overriding quality.100040Persisted
External quality maskBitmap representing quality bits field, when External quality tag is used.100041Persisted
External pattern bad qualityBit pattern determinating bad quality, when External quality tag is used100042Persisted
External mask unertain qualityBit pattern determinating unsertain quality, when External quality tag is used.100043Persisted
EvaluationOrder2What order to use to evaluate the values10020Persisted, Enumerated
Hi RangeUpper limit of range10201Persisted
Lo RangeLower limit of range10202Persisted
ModulusValue = registerhigh x Modulus + registerlow. Valid only for 4 byte signed and unsigned int10015Persisted, Enumerated
OffsetThe linear transformation addend to use when calculating and item value. (Value = RawValue \times Scale + Offset)5006Persisted
QualityItem quality - this tells you whether an item currently has a good or bad quality. It might be bad, for example, because it isn't connected or is set to the wrong type.3ReadOnly
Read single3Force master to read this item only in a single request.10032ReadOnly
RightsItem access rights - this property may be "read", or "read write".5ReadOnly
ScaleThe linear transformation multiplier to use when calculating the item value.5005Persisted
SlaveaddressThe slave address (Unit ID) of the Modbus slave (overrides the module property).10030Persisted
SrcItemIDThe item ID in the source. This is the item ID this item uses to fetch data from the source.5030Persisted
StringSizeThe number of buffers to read. Only valid when "Valuetype" is "Unicode String" or "ASCII".10011Persisted
TimeThe date and time when this item was last updated.4ReadOnly
TypeThe item canonical data type - the specific type of this item. Whether it's an integer, string, date, etc.1ReadOnly
UnitEU units - this is the unit this item value uses. For example: centimetres, kilograms, kilowatts, etc.100Persisted
ValueThe current value of the item.2NormalPage
ValuetypeItem canonical datatype. This is the type of data the field holds. For example: integer, string, datetime, etc.10010Persisted, Enumerated
Write immediatelySend value immediately to slave on set value independet of polling rate (Valid only when Direction = true).10125NormalPage
1

Endian: Modbus is a "big-endian" protocol: that means the more significant byte of a 16-bit value is sent before the less significant byte. Be careful with 32-bit and 64-bit values, which may not be transferred using big-endian order. Some manufacturers treat 32-bit and 64-bit values as being composed of 16-bit words, and transfer the words in little-endian order. For example, the 32-bit value 0x12345678 would be transferred as 0x56 0x78 0x12 0x34. Select LittleEndian to use this mixed ordering.

2

EvaluationOrder:

  • Apis: The value is written to the slave on every cycle;
  • Slave: The value is read from the slave before the write. The value is only written to the slave when its changed in Apis.
  • Slave no writeback: Same as Slave but with no writeback.
3

Read Single: Used to optimize error handling. WARNING: Enabling this feature on numerous items will affect overall performance.

See also

Basic Item Properties

Predefined Item Properties

OPC DA Properties