Information can easily be transferred between a Digi-Star indicator and a computer using several different
devices. These devices include the Digi-Star Datakey, the Digi-Star Data Down Loader (DDL), Digi-Star
Datalink Radio Frequency(RF) Modem and direct connections to computers.
This document provides the necessary information to allow developers to directly transfer information
between their computer and a Digi-Star indicator using the "EZII Escape Computer Command Set" . This
Command Set is found on indicators with Serial Ports having a PROG ID of "EZ2 2.0" and higher.
The command set is powerful and allows the external computer to control most of the scale functions.
Commands are included to allow recipe batch and feeding information to be sent from the computer to the
EZ 3500, EZ 3600, EZ 4300 & EZ 4600 indicator and there are also commands that allow the data to be
collected after the feeding has been completed. Commands for transferring EID tag numbers and weight data
from the SW 550EID, SW 2600EID and SW 4600EID are also included.
Please note: Not all commands are available on all indicator models.
Please note: References to commands for the EZ 3500 also apply to the EZ3600, EZ4300 & EZ4600
indicator models. References to the SW550 EID also apply to the SW2600 EID indicator model. Some of
these references may also apply to the SW4600 EID indicator model.
Command Format:
In general terms, most of the new "EZII Escape Computer Command Set” have the following format. Each
command starts with the “Escape” (<ESC> = hex value 1B) ASCII control code. This is followed by a
Digi-Star Command Character. Command characters will normally be “UPPER” case letters and will have
additional “sub-command” characters following them. The Digi-Star sub-command characters may be either
“lower” or "UPPER" case letters and may also have additional sub-command characters or numerical values
behind them. Most commands will end with the “End Of Transmission” (<EOT> = hex value 04) ASCII
control code. Examples of the "EZII Escape Computer Command Set" follow. Most of the original EZ
Computer Interface Commands have been included in the new format. To use the original EZ computer
commands, change the selection in the Long Form setting "Computer In Mode" (COM IN) from
"EZ2CMD" to "EZ CMD".
The indicator receives commands from a computer and stores them in a "command buffer" until it has time
to perform the commands. Once, the commands are performed, they are removed from the command buffer
to make room for more commands. If too many commands are sent to the indicator, the command buffer
may overflow. The "command buffer" can store over 200 serial characters at one time, but special care must
be taken to not overflow the buffer. Command responses will indicate when a command is complete.
Command Response Format:
Most of the new computer interface commands will indicate completion by sending a single byte response
out the Computer Port. The "Success Acknowledgment" is the "ACK" character (Hex value 0x06). The
"Fail Acknowledgment" is the "NAK" character (Hex value 0x15).
D3648 Rev GNovember 30, 2009
1
EZII Escape Computer Command Set
Communication Parameters:
Data is transmitted and received in the asynchronous ASCII format. This communication format is
compatible with other Digi-Star indicators, printers, terminals and computers. "Handshake lines" are not
used and XON/XOFF is not supported.
Port Configuration when COM IN is set to EZ2CMD
9600 BAUD, 1 Start Bit, 7 Data Bits, 1 EVEN Parity Bit & 1 Stop Bit.
Port Configuration when COM IN is set to EZCMD
1200 BAUD, 1 Start Bit, 7 Data Bits, 1 EVEN Parity Bit & 1 Stop Bit.
These parameters are not adjustable in the scale. Equipment interfacing to the scale must match this
configuration.
Port Wire Connections:
PinJ904 Connector Signals
EZ 2000, EZ 3200,
EZ2400 & EZ3400
1 20ma Current Loop(+)1 20ma Current Loop(+)1 Jumpered to 4 & 6
2 Printer&Computer Data(Tx)2 Com #1 Out (Tx)-DDL & Computer2 Com #1 Out (Tx)-Computer
3 Computer Data (Rx)3 Com #1 In (Rx) - DDL & Computer3 Com #1 In (Rx) - Computer
4 Scoreboard Data (Tx)4 Com #2 Out (Tx) - Printer4 Jumpered to 1 & 6
5 Computer Gnd5 +12 VDC5 Gnd
6 Printer Gnd6 Gnd - Available for any Com device6 Jumpered to 1 & 4
7 Scoreboard Gnd7 Com #2 In (Rx)7 Jumpered to 8
8 20ma Current Loop(-)8 20ma Current Loop(-) is GND8 Jumpered to 7
PinJ905 Connector Signals
EZ 3500, EZ4300,
EZ3600 & EZ4600
PinComputer Signals
SW550, SW600, SW2600
& SW4600
9 No connection
D3648 Rev GNovember 30, 2009
2
EZII Escape Computer Command Set
List of Computer Commands:
'G' - General Operation Sub-Commands (Page 4):
G A - Select scale (a = scale A, b = scale B, c = scale
C).
1
G B - Balance indicator, enter GROSS mode.
G c- Motion weight adjustment (0-999999). Standard
motion detection is selected when indicator is
first turned ON or if "0" is sent.
1
G D - Perform "recheck weight" for "Lock-On" weigh
method.
G f- Clears "Blackout","Pulsed Output", and
"Recipe" errors at scale startup.
G G - Enter GROSS mode.
G h- Enter HOLD Mode (E-enables Hold, D-disables
Hold & A-Aborts Hold).
G I - Display the alpha-numeric "ID" value.
G i- Load the alpha-numeric"ID" value (0 clears ID
value).
1
G k- Keyboard Lock (or allow 1 key).
G L - Enter L/UL mode if applicable.
G m - Displays messages on the EZ.
1
1
1
G N - Enter NET mode. TARE if necessary.
G o- Computer Command ACK/NAK responses (D-
disables horn, E-enables horn<-default).
G s- Sends status information for the EZ.
1
G T - Perform TARE and enter NET mode.
G t- Preload a TARE value (0-999999).
G u- Changes Hello message on the EZ.
1
G W - Print Program ID (Software Rev.).
G Y - Print Setup Number.
G y- Enter Short Form Setup Value (100000 -
999999).
G Z - Print Calibration Number.
G z- Load Short Form Calibration Number (1 -
99999).
'P' - Print Sub-Command:
P P- Print weight data. This command will also
advance to the next ingredient if the scale is
processing a recipe.
'S' - Preset Sub-Commands:
Print outputted when clearing preset.
S E- Display & re-enter previous preset value.
S g- Load a preset (0-999999), enter GROSS mode
(0 clears preset).
S l- Load a preset (0-999999), enter Load/Unload
mode (0 clears preset).
S n- Load a preset (0-999999), enter NET mode (0
clears preset).
'R' - Recipe Sub-Commands (Page 20):
R A - Advance recipe to next ingredient.
R d- Transfers feedline data into the EZ 3500.
R e- Erase all EZ 3500 Recipes.
1
R f- Uploads EZ 3500 Feedline Field Format.
R p- Sends EZ3500 Recipes from the EZ.
1
1
1
R Q - Print last recipe name or batch number loaded.
The ingredient name will also be printed if
recipe is currently active.
R r- Loads an EZ 3500 Recipe using the batch
number (0-9999).
R T - Terminate active recipe.
R v- Load amount for an EZ 3200 recipe (0-999999).
Should precede the recipe command 'r'. Not
available on the EZ 3500.
'D' - Direct Access Number Sub-Commands (Pg. 28):
213- Scoreboard Mode in EZ.
103- Motion Detection in EZ. (D = disables Motion,
E = enables Motion).
More details for the Continuous Computer Status Data
Output (Scoreboard Mode)is found on Pg 29.
'E' - EID & Print Buffer Sub-Commands (Pg. 33):
E e- Erase all EID Records/Print Data in EZ.
E p- Sends all EID Records/Print Data from the EZ.
E c- Clears the current EID tag in the EZ.
E r- Records the current EID/Weight Record.
E a- Uploads Quick Data info from PC into EZ.
1
1
1
1
E b- Sends Quick Data information from EZ to PC.
1
1
Examples of the data formats printed by the indicator
can be found on page 10 with the Gs - Status Command.
'M' - Memory Function Sub-Commands:
M C - Perform CM (Clear Memory).
M M - Perform M+ (Memory Plus).
M R - Perform RM (Recall Memory).
M A - Provide Average weight.
D3648 Rev GNovember 30, 2009
'C' - Control Mode Sub-Commands (Pg. 40):
C c- Enter Control Mode(E-enable,D-disable).
C m - Displays messages during Control Mode.
C r- Change DataLink channel (1-7) and retry value
(0-9) in EZ.
'O' - Cab Control (CC) Sub-Commands (Pg. 42):
O m - Display numbers and text on CC.
Oa- Display annunciators on CC.
Ou- Activates alarms on CC.
<SUB> - Send Keys from CC.
1
- More detailed information follows in document.
1
1
1
1
1
3
1
1
EZII Escape Computer Command Set
Format Example:
Zero/Balance command. (GB)
<ESC>GB<EOT>
The command string sent includes this information:
Start new command:<ESC>
Command identifier:GB
End of command:<EOT>
Sending a 2000 lb Gross Preset command(Gg).
<ESC>Sg2000<EOT>
The command string sent includes this information:
Start new command:<ESC>
Command identifier:Sg
Data to send: 2000
End of command:<EOT>
Data Field Format Command Response:
If the command is performed successfully, then the <ACK> (Hex value 0x06) character will be returned.
If the command fails, the <NAK> (Hex value 0x15) character will be returned.
D3648 Rev GNovember 30, 2009
4
EZII Escape Computer Command Set
General Operation Sub-Commands:
Gc - Motion Weight Adjustment Command:
This command allows the "Motion Weight Value" to be adjusted over the computer Interface. The indicator
uses the motion weight value to determine when the weight on the scale is changing rapidly. The motion
detection is a feature that can be turned ON or OFF in the Long Form Setup or using the “Direct Access
Number Sub-Command” - 103.
The standard motion detection will activate:
When the weight displayed has moved more than "2 display counts" in less than "2 seconds".
The standard motion detection is selected whenever the indicator is first turned ON or the "Motion Weight
Adjustment Computer Command" sends a motion weight value of "0". Use this command to change the
motion weight value.
The "Motion Weight Adjustment Command" detects motion:
When the weight measured has moved more than the "Motion Weight Value" in less than "2
seconds".
This command includes the following information:
Start new command:<ESC>
Command identifier:Gc
Data format to send:nnnnnn (n can be a number from 0 to 999999, must have at least 1 digit).
End of command:<EOT>
Motion Weight Adjustment Command Response:
If the command is completed successfully, then the <ACK> (Hex value 0x06) character will be returned.
If the command fails, the <NAK> (Hex value 0x15) character will be returned.
Motion Weight Adjustment Command Example:
The following command string:
<ESC>Gc100<EOT>
would cause the indicator to use 100 as the "Motion Weight Value".
The following command string:
<ESC>Gc0<EOT>
would cause the indicator to use the standard motion detection.
D3648 Rev GNovember 30, 2009
5
EZII Escape Computer Command Set
GI & Gi - ID Commands:
This command allows up to a six character alpha-numeric ID Number to be uploaded over the Computer
Interface (Gi) or can simply cause the ID Number to be displayed on the indicator (GI). Please note that if
this command is used while a recipe is loaded, the ID Number is displayed as the ingredient or pen
information instead of the information stored in the feedline. The ID# will also appear on the printouts from
the indicator.
The "ID# Command" is used to display(GI) or change(Gi) the current ID Number. These commands include
the following information:
To display the current ID Number:
Start new command:<ESC>
Command identifier:GI
End of command:<EOT>
Alpha-Numeric ID# Command Example:
The following command string:
<ESC>GI<EOT>
would cause the current ID Number to appear on the indicators display.
To change the current ID Number:
Start new command:<ESC>
Command identifier:Gi
ID Number:Must be one to six characters long. If the ID Number is less than six
characters the value will appear on the right side of the display. Valid
characters may not be less than the Space " " (hex value 20) character and
may not be greater than the "z" (hex value 7A) character of the ASCII
character set. Valid characters are from 20 hexi-decimal to 7A hexi-decimal.
Note: The character "$" will show up as a "l" (small character L ) on the
indicator display since the "$" character is a special used for Lock-On weigh
mode.
Note: Lower case characters will be printed as lower case characters however
they appear as UPPER case characters on the scale's display.
End of command:<EOT>
Alpha-Numeric ID# Command Response:
If the command is completed successfully, then the <ACK> (Hex value 0x06) character will be returned.
If the command fails, the <NAK> (Hex value 0x15) character will be returned.
Alpha-Numeric ID# Command Example:
The following command string:
<ESC>GiCORN<EOT>
would appear as " CORN" on the indicators display.
The command string <ESC>Gi2H-31A<EOT> would appear as "2H-31A".
To clear the ID Number value, send the command string <ESC>Gi0<EOT>. Empty ID Numbers appear
as "------" on the indicators display.
D3648 Rev GNovember 30, 2009
6
EZII Escape Computer Command Set
Message Commands:
There are two message commands, "Gm" and "Cm". Most messages should be sent using the "Gm"
command. The "Cm" command can only be used with the "Control Mode" (CcE) command described later.
Gm - General Message Command:
This command allows an alpha-numeric message (up to 60 characters in length) to be displayed on the
indicator. No additional computer interface commands should be sent while the message is being displayed
or the message will be terminated. The operator can also terminate any messages being displayed by
pressing a key on the front panel of the indicator.
The Message command can be used with the Keyboard Lock command to instruct the operator to "PRESS
THE PRINT KEY WHEN FINISHED". All keys will perform there proper function except the ON key.
Pressing the key will simply return the unit to weighing.
This command includes the following information:
Start new command:<ESC>
Command identifier:Gm
Message display interval:nn (nn can be a number from 00 to 99, must be 2 digits)
For messages longer than 6 characters:
nn = stands for the number times to scroll messages.
For messages 6 characters or less:
nn = stands for number of seconds to display the message.
When nn is set to a value of 00 then the message will scroll until a key
is pushed on the indicator. Please note, a value of 00 is only valid on
messages longer than 6 characters.
Start of Message:<STX> = start of the text = hex value 2 in the ASCII character set
Message:Must be 1 to 60 characters long. If the message is less than six characters the
value will appear on the right side of the display. Valid characters may not
be less than the Space " " (hex value 20) character and may not be greater
than the "z" (hex value 7A) character of the ASCII character set. Valid
characters are from 20 hexi-decimal to 7A hexi-decimal.
Note: The character "$" will show up as a "l" (small character L ) on the
indicator display since the "$" character is a special character used for
Lock-On weigh mode.
Note: Lower case characters will be printed as lower case characters however
they appear as UPPER case characters on the scale's display.
End of command:<EOT>
Message Command Response:
If the command is completed successfully, then the <ACK> (Hex value 0x06) character will be returned
after receiving the command AND AGAIN AFTER THE MESSAGE HAS FINISHED SCROLLING OR THE DISPLAY
TIME HAS ELAPSED. If the command fails, the <NAK> (Hex value 0x15) character will be returned.
Message Command Examples:
The following command string <ESC>Gm10<STX>WAIT<EOT> would cause the indicator to display
the message " WAIT" for 10 seconds.
The command string <ESC>Gm00<STX>LOAD CORN<EOT> will scroll the message "LOAD CORN"
until the operator pressed a key on the indicator.
The command string <ESC>Gm15<STX>LOAD WHEAT FROM BUNKER #1<EOT> scroll the
message "LOAD WHEAT FROM BUNKER #1" 15 times or until the operator pressed a key on the indicator.
D3648 Rev GNovember 30, 2009
7
EZII Escape Computer Command Set
Gu - Signon Message Command:
This command allows an alpha-numeric message (up to 40 characters in length) to be displayed on the
indicator during power up. It will appear immediately after a short “HELLO” message is displayed.
This command includes the following information:
Start new command:<ESC>
Command identifier:Gu
Start of Message:<STX> = start of the text = hex value 2 in the ASCII character set
Message:Must be at least 1 character and can be up to 40 characters long. If the
message is less than six characters the value will appear on the right side of
the display. Valid characters may not be less than the Space " " (hex value
20) character and may not be greater than the "z" (hex value 7A) character of
the ASCII character set.
Note: The character "$" will show up as a "l" (small character L ) on the
indicator display since the "$" character is a special character used for
Lock-On weigh mode.
Note: Lower case characters will be printed as lower case characters however
they appear as UPPER case characters on the scale's display.
End of command:<EOT>
Signon Message Command Response:
If the command is completed successfully, then the <ACK> (Hex value 0x06) character will be returned
after receiving the command. If the command fails, the <NAK> (Hex value 0x15) character will be returned.
Signon Message Command Examples:
The following command string <ESC>Gu<STX>DS<EOT> would cause the indicator to display the
message " DS" after “ HELLO” is displayed on the indicator when the unit is first turned on.
The command string <ESC>Gu<STX>SERVICE LOANER<EOT> will scroll the message "SERVICELOANER" after “ HELLO” is displayed on the indicator when the unit is first turned on.
GA - Select Scale Command:
This command is used to switch the indicator to display scale A, B, or C. This command includes the
following information:
Start new command:<ESC>
Command identifier:GA
Selected scale:a = scale A, b = scale B, c = scale C
End of command:<EOT>
Select Scale Command Example:
When the "Select Scale Command" string is sent to the indicator
<ESC>GAc<EOT>
the indicator will display the weight on Scale C and the <ACK> (Hex value 0x06) character will be returned.
If the command fails, the <NAK> (Hex value 0x15) character will be returned.
D3648 Rev GNovember 30, 2009
8
EZII Escape Computer Command Set
Gk - Keyboard Lock Command:
This command is very powerful and can disable all or only a few keys on the EZ indicator.
This command includes the following information:
Start new command:<ESC>
Command identifier:Gk
Code for Enabled key:'L', 'U' or 2 digits - L= Lock or disable all keys, U=Unlock or enable all keys
or XX = enables the key associated with the key code from the table below.
End of command:<EOT>
Keyboard Lock Command Response:
If the command is completed successfully, then the <ACK> (Hex value 0x06) character will be returned.
If the command fails, the <NAK> (Hex value 0x15) character will be returned.
Keyboard Lock Command Example:
The following command string:
<ESC>GkL<EOT>
would disable all keys.
The following command string:
<ESC>Gk23<EOT>
would enable the Print key.
Up to 20 keys can be enabled after the Lock command has been sent.
Key Code Table:
M+ ..........= 42
RM .........= 32
ID ..........= 12
Zero........= 43
Print........= 23
Help........= 13
Timer.......= 47
Tare........= 40
Load/Unload ..= 30
Hold........= 20
The Message command can be used with the Keyboard Lock command to instruct the operator to "PRESS
THE PRINT KEY WHEN FINISHED". All keys will perform there proper function except the ON key.
Pressing the key will simply return the unit to weighing.
Net/Gross ....= 10
Ingr/Pen .....= 41
Recipe......= 31
Bunk +/- Read . = 21
On ..........= 08
Select .......= 27
Function .....= 37
Clear ........= 17
1 ...........= 34
2 ...........= 45
3 ...........= 35
4 ...........= 25
5 ...........= 15
6 ...........= 14
7 ...........= 46
8 ...........= 36
9 ...........= 26
0 ...........= 16
D3648 Rev GNovember 30, 2009
9
EZII Escape Computer Command Set
Gs - Status Command:
This computer interface command works like the current Print Command (P), except this command does
not advance to the next ingredient if the scale is processing a recipe.
The "Status Command" is used to determine the current status of the scale. The Status Command can be
used to follow serial commands which do not have a command response. This identifies when the previous
command has been processed by the scale. There are certain circumstances when the scale cannot process
serial commands. Reviewing recipes, operating the timer, displaying messages, and while using the Short
or Long Form Setup & Calibration functions are some of the operations when the scale cannot process
Computer Interface Commands until that operation is completed.
The serial input buffer on the indicator can become full and an error #14 or #17 "Input Buffer Overflow
Error" can occur if too many serial commands are sent during these operations.
This command includes the following information:
Start new command:<ESC>
Command identifier:Gs
Data format to send:xx (see below)
End of command:<EOT>
Status Command Response:
If the command is completed successfully, then the message string shown below will be returned followed
by the <ACK> (Hex value 0x06) character. If the command fails, the <NAK> (Hex value 0x15) character
will be returned.
Status Command Example:
The following command string:
<ESC>Gs02<EOT>
would cause the indicator to print the following text.
123456789012
" 0LB GR"
Output Examples: Date & Time formats selected in the Long Form may change these examples.
No Name Description
01 " AUTO "Uses whatever print format (D.A.N. 216) is selected in the Long Form.
02 "WTONLY"Simple weight value. Must be selected for AGCO (Hesston, Hay & Forage).
-Includes weight, display unit, $' if unit is "locked-on", weight tag (GR, M+, etc...).
-Ends with a <CR>,<LF>, <CR>,<LF>.
Print example:
10
123456789012
" 0LB GR"
D3648 Rev GNovember 30, 2009
10
EZII Escape Computer Command Set
03 "DOWNLD" This format is compatible with the original Downloader. It duplicates the standard EZ
210 / EZ 150 print output. The print data is the same even while batching on an EZ3200.
It is not the same as the EZ 320 and therefore does not provide the exact same
information while batching. Use this selection when connected to a Downloader.
-Includes weight, display unit, $' if unit is "locked-on", weight tag (GR, M+, etc...)
date and time.
-Ends with a <CR>,<LF>.
04 "DT+TM "This is a simple comma delimted format.
-Includes weight, display unit, $' if unit is "locked-on", weight tag (GR, M+, etc...)
and date.
-Ends with a <CR>,<LF>.
Print example:
10 20 30
123456789012345678901234567890
" 0,LB, ,GR,13MR02,11:08"
05 "ID+TM "This comma delimted format includes ID, time but not date.
-Includes ID, weight, display unit, $' if unit is "locked-on", weight tag (GR, M+,
etc...) and time.
-Ends with a <CR>,<LF>.
Print example:
10 20 30
123456789012345678901234567890
" , 0,LB, ,GR,11:08"
06 "IDWTTM"This comma delimted format includes ID, time and date.
-Includes ID, weight, display unit, $' if unit is "locked-on", weight tag (GR, M+,
etc...), date and time.
07 "ANIMAL"This comma delimted format includes information for animal weighing.
-Includes $' if unit is "locked-on",weight, weight tag (GR, M+, etc...), display unit,
Memory Weight (RM), Average Count (Number of times M+ key was pressed),
Average Weight, Gross weight on scale, ID, date and time.
09 "3200-B"This comma delimted format includes more information for batching weighing.
-Includes Manual Advance indicator, Scale ID, Preset, Weight, weight tag (GR, M+, etc...), Gross Weight, display unit,
$' if unit is "locked-on", ID, Ingred/Pen Name, Recipe#, Batch#, Total Rotation Count, Time, Date and User ID.
12 "FDINFO"This comma delimted format includes batching feedline status information.
-Includes Feedlines Done, Feedlines Undone, Total Feedlines Loaded, Number of Additional Feedlines that can be Loaded
and the Maximum Number of Feedlines that can be loaded into this EZ3500.
-Ends with a <CR>,<LF>.
Print example:
1 2 3 4
1234567890123456789012345678901234567890
" 0, 5, 5, 763, 768"
13 "WTRCTM" This comma delimted format includes basic weighing information.
-Includes Gross Weight, display unit, weight tag (GR, M+, etc...), Total Rotation Count, Date & Time.
-Ends with a <CR>,<LF>.
Print example:
1 2 3 4
1234567890123456789012345678901234567890
" 280,LB,GR, 187,03JL03,12:41:03"
D3648 Rev GNovember 30, 2009
13
EZII Escape Computer Command Set
No Name Description
14 "EIDINF"This comma delimted format includes EID memory status information.
-Includes number Used EID lines, number of Un-used EID lines, and Maximum EID line capacity.
-Ends with a <CR>,<LF>.
Note: Currently only the StockWeigh indicators ( SW550 EID, SW2600 EID, and SW4600 EID ) support EID memory storage.
Print example of StockWeigh SW550 EID and SW2600 EID indicators:
1 2 3 4
1234567890123456789012345678901234567890
" 157, 1379, 1536"
Print example of StockWeigh SW4600 EID indicator:
1 2 3 4
1234567890123456789012345678901234567890
" 76, 10092, 10168"
15 " EID "This comma delimited format includes EID information for animal weighing.
-Includes EID tag information, weight, display unit, '$' if weight is "locked-on", Net/Gross, date, time & checksum.
-Ends with a <CR>,<LF>.
-For more details on data field format see “Send All EID Records Command” response SW550 / SW2600 format.