placeholder Command:  TARES 


Short version Long version Changes Example

Mandatory: no
max. Occurrence:  unbounded
Description:
This tag is used as container for commands regarding tares.
Notes:
In the NSM form the UC3 application the content of this command is handled with NSM item 47.
 
Mandatory: yes
max. Occurrence:  unbounded
Supported modes: delete Delete the named item.
read Read the named item.
read+ Read the following item.
read- Read the previous item.
readall Read all items from the desired device(s). This doesn't mean comparable reading as in the L2 protocol.
write Write the named item.
Description:
This command is used for creating, manipulating or deleting a tare.
Notes:
For the mode ''readall'' the following information can be helpful:
The table below shows values for the mandatory elements.
<department_no> <tare_no> Comment
0 0 All tares of all departments will be returned.
0 unequal 0 All tares of all departments whose tare numbers are greater or equal than the value of <tare_no> will be returned.
unequal 0 0 All tares that are belonging to the desired deparment number will be returned.
unequal 0 unequal 0 All tares of the desired department whose tare numbers are greater or equal than the value of <tare_no> will be returned.

   
Mandatory: yes
max. Occurrence: 1
Datatype: short
Range: 1 - 9 999
Nillable: no
Description:
The number of the department the tare is belonging to.
   
Mandatory: yes
max. Occurrence: 1
Datatype: short
Range: 1 - 9 999
Nillable: no
Description:
The number of the tare (to identify it).
   
Mandatory: no
max. Occurrence: 1
Datatype: string
Range: max. 20 characters
Nillable: no
Description:
The name of the tare.
   
Mandatory: no
max. Occurrence: 1
Datatype: int
Range: 1 - 99 999 999
Nillable: no
Description:
The value of the tare.
   
Mandatory: no
max. Occurrence: 1
Datatype: short
Range: 0 - 1
Nillable: no
Description:
The tare type.
Value Description
0 Weight Tare
The tare value above is interpreted as weight.
The value has to be set in the smallest unit of the loadcell e.g. g for a loadcell based on kg/g.
1 Percentage tare
The tare value above is interpreted as percentage value, e.g. 5 means 5 %. A tare value with decimal places is not possible.

Notes:
The value 1 (percentage tare) is not supported by the UC3. It will only be stored by it.
   
Mandatory: no
max. Occurrence: 1
Datatype: string
Range: max. 10 characters
Nillable: no
Description:
The tare reference is a standard denomination for the trays. On the Etica, this denomination is used on controls to select tares by the operator.
Notes:
This information is not used by the UC3. It will only be stored by it.
   
Mandatory: no
max. Occurrence: 1
Datatype: string
Range: max. 20 characters
Nillable: no
Description:
The string is decoded by the program to calculate the place where the label is put on the the article on the conveyor. The tray is devided into 100 zones, determined by their x-y coordinates (from 0 to 9 for each). The rotation is done by the third value (from 0 to 3 for 0°, 90°, 180° and 270°). A value of 580 means pos x = 5, pos y = 8, rot = 0°.
Notes:
This information is not used by the UC3. It will only be stored by it.
   
Mandatory: no
max. Occurrence: 1
Datatype: int
Range: 0 - 99 999 999
Nillable: no
Description:
The length of the tare object in mm.
Notes:
This information is not used by the UC3. It will only be stored by it.
   
Mandatory: no
max. Occurrence: 1
Datatype: int
Range: 0 - 99 999 999
Nillable: no
Description:
The width of the tare object in mm.
Notes:
This information is not used by the UC3. It will only be stored by it.
   
Mandatory: no
max. Occurrence: 1
Datatype: dateTime
Range: -
Nillable: yes
Description:
The last time when the record was changed.
CCYY-MM-DDThh:mm:ss
The format is as following:
C = Century
Y = Year
M = Month
D = Day
T = Separator between date and time
h = hour
m = minute
s = second