Reference - Manual - INTERFASES XPR
Reference - Manual - INTERFASES XPR
Reference - Manual - INTERFASES XPR
1 Introduction 3
2 Command Formats 4
2.1 Conventions ................................................................................................................ 4
2.2 Response formats ........................................................................................................ 5
2.2.1 Format of responses with weight value ............................................................ 5
2.2.2 Format of responses without weight value........................................................ 6
2.3 Error messages ........................................................................................................... 7
2.3.1 Command-specific error messages ................................................................. 7
2.3.2 General error messages ................................................................................. 8
2.4 Tips for programmers ................................................................................................... 9
2.5 Read only ................................................................................................................... 11
4 What if...? 87
Index 89
u www.mt.com/XPR-analytical-RM
u www.mt.com/XPR-micro-analytical-RM
u www.mt.com/XSR-analytical-RM
u www.mt.com/XPR-precision-RM
u www.mt.com/XSR-precision-RM
See also
2 I0 – Currently available MT-SICS commands } Page 25
2 Tips for programmers } Page 9
2.1 Conventions
Throughout this manual, the following conventions are used for command and response syntax:
<> Triangle brackets indicate that you must specify a value for the enclosed parameter. The
brackets are not sent with the command string.
[] Square brackets indicate that the enclosed expression is optional and can be omitted. The
brackets are not sent with the command string.
a..b Intervals or ranges are represented using the "dot-dot" notation indicating the set of numbers
from a to b including a and b.
Ü Commands sent to the balance.
Û Response of the balance.
Example
Command to balance which writes Hello into the balance display:
Ü DV"Hello" The quotation marks " " must be inserted in the entry.
Û DVA Command executed successfully.
The command terminator CRLF is not shown.
Response with stable weight value of 152.38 g outside the fine range:
Ü S Request a stable weight value
Û SVSVVVV152.38Vg
Note
We recommend using the [I0 } Page 25] command to get a list of all commands that are supported by your
particular balance.
Example
Ü I0 Requests a list of commands.
Û I0VBV0V"I0" command I0.
Û I0VB… …
Û I0VBV0V"@" command [@ – Abort } Page 12].
Û I0VBV1V"D" command [D – Write text to display } Page 22].
Û I0VB… …
Û I0VAV3V"SM4" command SM4.
See also
2 @ – Abort } Page 12
2 I0 – Currently available MT-SICS commands } Page 25
2 I1 – MT-SICS level and level versions } Page 26
2 S – Stable weight value } Page 53
2 SI – Weight value immediately } Page 54
2 SIR – Weight value immediately and repeat } Page 55
2 SIRU – Weight value in display unit immediately and repeat } Page 56
2 SIU – Weight value in display unit immediately } Page 58
2 SR – Send stable weight value and repeat on any weight change } Page 70
2 SU – Stable weight value in display unit } Page 75
2 T – Tare } Page 76
2 TA – Tare weight value } Page 77
2 TI – Tare immediately } Page 79
2 Z – Zero } Page 85
2 ZI – Zero immediately } Page 86
See also
2 I4 – Serial number } Page 30
Comments
• Set the target value to 0 g and tolerances to 2.5%:
A10V0V0Vg
A10V1V2.5V%
A10V2V2.5V%
• As soon as you have specified the values, the SmartTrac updates.
• If too many decimal places are defined, the balance returns L.
• Reset target and tolerances:
A10V0V""V""
>VA10VA
A10V1V""V""
>VA10VA
A10V2V""V""
>VA10VA
Examples
Ü A10 Query of the target weight and tolerances.
Û A10VBV0V100.12Vg Current setting is target weight 100.12 g, + tolerance
Û A10VBV1V5.25Vg is 5.25 g and - tolerance is 7.6%.
Û A10VAV2V7.6V%
Comments
• A sufficient number of available IDs must be configured in the UI.
• To write the ID type must be set to "manual".
• To write the label the user needs sufficient user rights. To write the value only (keeping the label the same)
the user does not need any privileged user rights.
• To write the label the method must not be locked.
Examples
Ü A36 Query the result identification label and value of the
application.
Û A36VBV1V"ResultVIDV1Vlabel"V"ResultV ID number 1, label "Result ID 1 label" and value
IDV1Vvalue" "Result ID 1 value" are set.
Û A36VAV2V"ResultVIDV2Vlabel"V"ResultV ID number 2, label "Result ID 2 label" and value
IDV2Vvalue" "Result ID 2 value" are set.
Comments
• A sufficient number of available IDs must be configured in the UI.
• To write the ID type must be set to "manual".
• To write the label the user needs sufficient user rights. To write the value only (keeping the label the same)
the user does not need any privileged user rights.
• To write the label the method must not be locked.
Examples
Ü A37 Query the result identification label and value of the
application.
Û A37VBV1V"ResultVIDV1Vlabel"V"ResultV ID number 1, label "Task ID 1 label" and value "Task
IDV1Vvalue" ID 1 value" are set.
Û A37VAV2V"ResultVIDV2Vlabel"V"ResultV ID number 2, label "Task ID 2 label" and value "Task
IDV2Vvalue" ID 2 value" are set.
Example
Ü C0V0V1 Set adjustment setting to manual and external.
Û C0VA Adjustment setting set.
See also
2 M19 – Adjustment weight } Page 43
2 C1 – Start adjustment according to current settings } Page 20
Syntax
Command
C1 Start the adjustment according to the current setting,
see [C0 } Page 18].
First Responses
C1VB The adjustment procedure has been started. Wait for
second response, see Comments.
C1VI Command understood but currently not executable
(balance is currently executing another command).
No further response follows.
C1VL Command understood but not executable (e.g.
approved version of the balance). No further response
follows.
Further Responses
C1V<"WeightValueVUnit"> Weight request with external adjustment.
C1VA Command understood and executed successfully.
C1VI The adjustment was aborted as, e.g., stability not
attained or the procedure was aborted.
Parameters
Name Type Values Meaning
<"WeightValue"> String Weight values specify the value of the weight for a
sensitivity adjustment requested from the user via the
display or interface
<"Unit"> String The unit corresponds to the definition unit, e.g., gram
(g)
Comments
• Commands sent to the balance during the adjustment operation are not processed and responded to in the
appropriate manner until the adjustment is at an end.
• Use [@ } Page 12] to abort a running adjustment.
Example
Ü C1 Start the adjustment according to the current setting.
Û C1VB Adjustment operation started.
Û C1V"VVVVVVV0.00Vg" Prompt to unload the balance.
Û C1V"VVVV2000.00Vg" Prompt to load the adjustment weight of 2000.00 g.
Û C1V"VVVVVVV0.00Vg" Prompt to unload the balance.
Û C1VA Adjustment completed successfully.
See also
2 @ – Abort } Page 12
2 C0 – Adjustment setting } Page 18
2 M19 – Adjustment weight } Page 43
Examples
Ü DV"HELLO" Write HELLO into the balance display.
Û DVA The full text HELLO appears in the balance display.
See also
2 DW – Show weight } Page 24
2 Tips for programmers } Page 10
See also
2 TIM – Time } Page 80
Example
Ü DW Switch the main display to show the current weight
value.
Û DWVA Main display shows the current weight value.
See also
2 D – Write text to display } Page 22
See also
2 @ – Abort } Page 12
Example
Ü I1 Query the current MT-SICS level and version.
Û I1VAV"0123"V"2.00"V"2.20"V"1.00"V Level 0-3 is implemented and the according version
"1.50" numbers are shown.
Note
The idea behind the MT-SICS level was the standardization of the commands for all METTLER TOLEDO devices.
With the MT-SICS levels a simple identification was created to identify a certain set of MT-SICS command (and
the functionality behind); see below.
With years of experience and with MT-SICS commands and devices becoming more and more complexes it is
no longer possible to maintain the levels and the command behind in the original way. Thus we decided no
longer to support the levels in the MT-SICS manuals. Consequently the level version for level 0, 1 and 2 needs
to be fixed to a version, version of level 3 has to remain product specific.
• Level 0 fixed to version 2.30
• Level 1 fixed to version 2.22
• Level 2 fixed to version 2.33
• Level 3 is product specific and must be defined by the according product team
For Rainbow examples, Level 3 is fixed to version 2.20
Usually all defined commands at the level of 0...1 were implemented in the devices. This is no longer the case.
Therefore, do not expect anymore that all commands of a certain level are implemented.
See also
2 I14 – Device information } Page 34
Example
Ü I2 Query of the balance data.
Û I2VAV"XPR6UV6.1Vg" Balance type and capacity.
See also
2 I14 – Device information } Page 34
Example
Ü I3 Query of the software version number(s) and type
definition number.
Û I3VAV"2.10V10.28.0.493.142" 2.10: Software version number.
10.28.0.493.142: Type definition. number
See also
2 I14 – Device information } Page 34
See also
2 @ – Abort } Page 12
Comments
• A sequence of maximum 20 alphanumeric characters are possible as <ID>.
• The set balance ID is retained even after the cancel command [@ } Page 12].
Example
Ü I10 Query of the current balance ID.
Û I10VAV"MyVBalance" The balance ID is "My Balance".
Comments
• A sequence of maximum 20 alphanumeric characters is possible as <Model>.
• The following abbreviations used in model designations are relevant to MT-SICS:
DR = Delta Range.
DU = Dual Range.
/M, /A = Approved balance or weigh module.
Example
Ü I11 Query of the current balance type.
Û I11VAV"XPR603SDR" The balance is an "XPR603SDR".
10 10 5 1 7 10 10 5 71
Example
When a code with a press and hold is sent, new key commands will not be accepted.
Ü KV4 Set mode 4: when a key is pressed, execute the corre-
sponding function and send the function number as a
response.
Û KVA Command executed successfully.
Û KVBV1 The taring function has been started → taring active.
Û KVAV1 Taring completed successfully.
Û KVBV1 The taring function has been started → taring active.
Û KVIV1 Taring not completed successfully, taring aborted (e.g.
tried to tare a negative value).
Example
Ü M01 Query of the current weighing mode.
Û M01VAV0 Weighing mode is set.
See also
2 M12 – Acoustic beep signal } Page 42
Example
Ü M12V1 Trigger a beep variant 2.
Û M12VA Beep has been triggered.
See also
2 M11 – Key beeper volume } Page 41
Examples
Ü M19 Query of the current adjustment weight.
Û M19VAV100.123Vg The adjustment weight is 100.123 g.
See also
2 C0 – Adjustment setting } Page 18
2 C1 – Start adjustment according to current settings } Page 20
See also
2 SU – Stable weight value in display unit } Page 75
Example
Ü M23 Query the readability.
Û M23VAV1 The readability is 10d.
Examples
Ü M37 Query of the current draft shield door opening width.
Û M37VAV75 Door opening width is 75%.
Examples
Ü M40 Query of the current inner draft shield door opening
width.
Û M40VAV50 Door opening width is set to 50%.
Ü M40V100 Set the inner draft shield door opening width to 100%.
Û M40VA Door opening width 100% is set.
See also
[WS – Draft shield doors } Page 83]
See also
2 I4 – Serial number } Page 30
Example
Ü S Send a stable weight value.
Û SVSVVVVV100.00Vg The current, stable ("S") weight value is 100.00 g.
Example
Ü SI Send current weight value.
Û SVDVVVVV129.07Vg The weight value is unstable (dynamic, "D") and is
currently 129.07 g.
Example
Ü SIR Send current weight values at intervals.
Û SVDVVVVV129.07Vg The balance sends stable ("S") or unstable ("D")
Û SVDVVVVV129.08Vg weight values at intervals.
Û SVSVVVVV129.09Vg
Û SVSVVVVV129.09Vg
Û SVDVVVVV114.87Vg
Û SV…
See also
2 SIR – Weight value immediately and repeat } Page 55
Example
Ü SIU Requests the current weight value in display unit
independent of the stability.
Û SVDVVVVVV12.34Vlb Non-stable (dynamic) weight value is 12.34 lb.
Example
Ü SM0 Cancel all SMx commands except [SM4 } Page 65].
Û SM0VAV3 Any SMx commands are canceled.
See also
2 SM1 – Dynamic weighing: Start immediately and send the result } Page 60
2 SM2 – Dynamic weighing: Start after a minimum load is exceeded send result } Page 61
2 SM3 – Dynamic weighing: Start after a minimum load is exceeded, send result and repeat } Page 63
2 SM4 – Dynamic weighing: Time interval } Page 65
Example
Ü SM1 Start a dynamic weighing immediately and transfer the
result.
Û SM1VA Command understood, result follows.
Û SMV*VVVVV23.76Vg Result of the dynamic weighing is 23.76 g.
Comments
• Prerequisite: The currently running task has Capture mode set to Dynamic.
• SM4 is read only. The time interval can be set in the Methods settings.
Example
Ü SM4 Query the time interval.
Û SM4VAV10 Current time interval is set to 10 seconds.
See also
2 @ – Abort } Page 12
2 SM0 – Dynamic weighing: Cancel all SMx commands } Page 59
See also
2 SNR – Send stable weight value and repeat on stable weight change } Page 66
See also
2 SNR – Send stable weight value and repeat on stable weight change } Page 66
Example
Ü STV1 Activate ST function.
Û STVA Command executed.
Û SVSVVVV123.456Vg When the button Add to protocol pressed: current net
weight is 123.456 g.
Example
Ü SU Query the stable weight value with the currently
displayed unit.
Û SVSVVVVVV12.34Vlb The current, stable weight value is 12.34 lb.
Example
Ü T Tare.
Û TVSVVVVV100.00Vg The balance is tared and has a value of 100.00 g in
the tare memory.
See also
2 TA – Tare weight value } Page 77
2 TAC – Clear tare weight value } Page 78
Example
Ü TAV100.00Vg Preset a tare weight of 100 g.
Û TAVAVVVVV100.00Vg The balance has a value of 100.00 g in the tare
memory.
See also
2 T – Tare } Page 76
2 TAC – Clear tare weight value } Page 78
See also
2 T – Tare } Page 76
2 TI – Tare immediately } Page 79
2 TA – Tare weight value } Page 77
Example
Ü TI Tare immediately.
Û TIVDVVVVV117.57Vg The tare memory holds a non-stable (dynamic) weight
value.
See also
2 T – Tare } Page 76
2 TA – Tare weight value } Page 77
2 TAC – Clear tare weight value } Page 78
See also
2 DAT – Date } Page 23
Example
Ü TST3 Start sensitivity test with built-in weight.
Û TST3VB The test procedure has been started.
Û TST3VAV"VVVVVV0.0002" Test with internal weight completed successfully. The
difference to the specified value is 0.0002 (= 2 digits
from a weigh module/balance with an increment of
0.1 mg).
Not supported balances
The command is not supported for the following balances.
XPR26 XPR36 XSR64 XPR204S XSR303S
XPR26DR XPR36DR XSR104 XPR303S XSR303SN
XPR26C XPR36C XSR105DU XPR303SN XSR603S
XPR105 XPR106DUH XSR105 XPR603S XSR603SN
XPR603SN XSR1202S
XPR603SDR XSR2002S
XPR603SNDR
XPR1202S
XPR2002S
See also
2 M37 – Draft shield door opening width } Page 50
2 M40 – Inner draft shield door opening width } Page 51
Example
Ü Z Zero.
Û ZVA Zero setting performed.
See also
2 ZI – Zero immediately } Page 86
See also
2 Z – Zero } Page 85
See also
2 I4 – Serial number } Page 30
D W
Display Weighing
D 22 S 53
DW 24 SI 54
K 36 SIR 55
M11 41 SIRU 56
M12 42 SIU 58
M23 48 SNR 66
PWR 52 SNRU 68
Door SR 70
M37 50 SRU 72
M40 51 ST 74
Mettler-Toledo GmbH
Im Langacher 44
8606 Greifensee, Switzerland
www.mt.com/contact