This manual contains information about configuring the terminals, developing and using applications,
running diagnostics, using reader commands and configuration commands, and using default and
optional applications. It also contains full ASCII tables and bar code charts and English and International
font sets.
If you need to learn about the terminal’s features, install the terminal, learn about the menu system,
operate the terminal in a network, or troubleshoot problems, you also need to download the appropriate
user’s manual:
www.intermec.com
The information contained herein is proprietary and is provided solely for the purpose of allowing customers
to operate and service Intermec-manufactured equipment and is not to be released, reproduced, or used for
any other purpose without written permission of Intermec.
Information and specifications contained in this document are subject to change without prior notice and do
not represent a commitment on the part of Intermec Technologies Corporation.
Duratherm, EasyCoder, EasyLAN, Enterprise Wireless LAN, EZBuilder, Fingerprint, i-gistics, INCA (under
license), InterDriver, Intermec Printer Network Manager, IRL, JANUS, LabelShop, Mobile Framework,
MobileLAN, Nor*Ware, Pen*Key, Precision Print, PrintSet, RoutePower, TE 2000, Trakker Antares, UAP,
Universal Access Point, and Virtual Wedge are either trademarks or registered trademarks of Intermec
Technologies Corporation.
Throughout this manual, trademarked names may be used. Rather than put a trademark (™ or ®) symbol in
every occurrence of a trademarked name, we state that we are using the names only in an editorial fashion,
and to the benefit of the trademark owner, with no intention of infringement.
There are U.S. and foreign patents pending.
Wi-Fi is a registered certification mark of the Wi-Fi Alliance.
Microsoft, Windows, and the Windows logo are registered trademarks of Microsoft Corporation in the
United States and/or other countries.
This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit.
(http://www.opensssl.org/).
This product includes cryptographic software written by Eric Young (EAY@cryptsoft.com).
Wavelink is a registered trademark of Point Information Network Corporation.
ii
Page 5
Document Change Record
This page records changes to this document. The document was originally released as version 001.
Version Date Description of Change
002 09/2001 Added the 243X to the system manual.
Explained the new features and changes for firmware versions 4.X through 7.0:
• Added new configuration commands: Display Spacing and Beep Frequency.
• Modified existing configuration commands: Display Contrast, Display Font Type,
Keypad Type, Scanner Selection, and Symbology Identifiers.
• Removed screen mapping.
003 06/2002 Added the 2475 to the system manual.
Explained the new features and changes for firmware version 6.20 through 7.12:
• Added new configuration commands: Microwave Robustness and ICMP.
This section provides you with safety information, technical support
information, and sources for additional product information.
Safety Summary
Your safety is extremely important. Read and follow all warnings and
cautions in this document before handling and operating Intermec
equipment. You can be seriously injured, and equipment and data can be
damaged if you do not follow the safety warnings and cautions.
Do not repair or adjust alone
Do not repair or adjust energized equipment alone under any
circumstances. Someone capable of providing first aid must always be
present for your safety.
First aid
Always obtain first aid or medical attention immediately after an injury.
Never neglect an injury, no matter how slight it seems.
Before You Begin
Resuscitation
Begin resuscitation immediately if someone is injured and stops breathing.
Any delay could result in death. To work on or near high voltage, you
should be familiar with approved industrial first aid methods.
Energized equipment
Never work on energized equipment unless authorized by a responsible
authority. Energized electrical equipment is dangerous. Electrical shock
from energized equipment can cause death. If you must perform
authorized emergency work on energized equipment, be sure that you
comply strictly with approved safety regulations.
Trakker Antares 2400 Family System Manual xv
Page 18
Before You Begin
Safety Icons
This section explains how to identify and understand dangers, warnings,
cautions, and notes that are in this document. You may also see icons that
tell you when to follow ESD procedures and when to take special
precautions for handling optical parts.
A warning alerts you of an operating procedure, practice, condition,
or statement that must be strictly observed to avoid death or serious
injury to the persons working on the equipment.
Avertissement: Un avertissement vous avertit d’une procédure de
fonctionnement, d’une méthode, d’un état ou d’un rapport qui doit
être strictement respecté pour éviter l’occurrence de mort ou de
blessures graves aux personnes manupulant l’équipement.
A caution alerts you to an operating procedure, practice, condition, or
statement that must be strictly observed to prevent equipment damage
or destruction, or corruption or loss of data.
Attention: Une précaution vous avertit d’une procédure de
fonctionnement, d’une méthode, d’un état ou d’un rapport qui doit
être strictement respecté pour empêcher l’endommagement ou la
destruction de l’équipement, ou l’altération ou la perte de données.
Note: Notes either provide extra information about a topic or contain
special instructions for handling a particular condition or set of
circumstances.
Global Services and Support
Warranty Information
To understand the warranty for your Intermec product, visit the Intermec
web site at http://www.intermec.com and click Service & Support. The
Intermec Global Sales & Service page appears. From the Service &
Support menu, move your pointer over Support, and then click
Warranty.
Disclaimer of warranties: The sample code included in this document is
presented for reference only. The code does not necessarily represent
complete, tested programs. The code is provided “as is with all faults.” All
warranties are expressly disclaimed, including the implied warranties of
merchantability and fitness for a particular purpose.
xvi Trakker Antares 2400 Family System Manual
Page 19
Before You Begin
Web Support
Visit the Intermec web site at http://www.intermec.com to download our
current documents in PDF format. To order printed versions of the
Intermec manuals, contact your local Intermec representative or
distributor.
Visit the Intermec technical knowledge base (Knowledge Central) at
http://intermec.custhelp.com to review technical information or to request
technical support for your Intermec product.
Telephone Support
These services are available from Intermec Technologies Corporation.
Service
Factory Repair and
On-site Repair
Technical Support Get technical support on your
Service Contract
Status
Schedule Site Surveys
or Installations
Ordering Products Talk to sales administration,
Description
Request a return authorization
number for authorized service
center repair, or request an onsite repair technician.
Intermec product.
Inquire about an existing
contract, renew a contract, or
ask invoicing questions.
Schedule a site survey, or
request a product or system
installation.
place an order, or check the
status of your order.
In the U.S.A. and Canada
call 1-800-755-5505
and choose this option
1
2
3
4
5
Outside the U.S.A. and Canada, contact your local Intermec
representative. To search for your local representative, from the Intermec
web site, click Contact.
Who Should Read This Document?
This manual provides you with information about how to configure,
operate, and program the Trakker Antares® 2400 Family of terminals. Use
this manual in conjunction with your terminal user’s manual, which
contains specific information about installing, configuring, operating,
troubleshooting, and maintaining your terminal.
You should be familiar with your network and general networking terms,
such as IP address.
Trakker Antares 2400 Family System Manual xvii
Page 20
Before You Begin
Related Documents
The Intermec web site at http://www.intermec.com contains our current
documents that you can download as PDF files.
To order printed versions of the Intermec manuals, contact your local
Intermec representative or distributor.
xviii Trakker Antares 2400 Family System Manual
Page 21
Introducing the Trakker
1
This chapter introduces the Trakker Antares® 2400 Family of terminals
and covers these topics:
• Overview of the Trakker Antares 2400 Family
• What’s new in firmware version 8.01
• About network connectivity and protocols
Antares 2400 Family
Trakker Antares 2400 Family System Manual 1
Page 22
Chapter 1—Introducing the Trakker Antares 2400 Family
What Is the Trakker Antares 2400 Family?
The Trakker Antares 2400 Family of terminals provides a comprehensive
data collection solution for manufacturing, warehousing, distribution,
healthcare, and retail environments. This full family of products shares the
same programming tools, configuration, and connectivity. The 2400
Family includes the following terminals:
• 2410 and 2415 handheld
• 2420, 2425, and 2425CS handheld
• 2430 and 2435 handheld
• 2455 vehicle-mount
• 2460 and 2461 light industrial stationary
• 2475 vehicle-mount
• 2480, 2481, 2485, and 2486 heavy industrial stationary
For information about the 2425CS, see the documentation that ships with
the 2425CS.
The 2400 Family is a Wi-Fi certified family of products. The 2415, 2425,
2435, 2455, 2475, 2485, and 2486 terminals with an IEEE 802.11b radio
installed are Wi-Fi certified for interoperability with other 802.11b
wireless LAN devices.
The 2415, 2425, 2435, 2455, 2475, 2485, and 2486 terminals are also
supported by the Wavelink Avalanche client management system. For
more information, see “Managing Your Terminals with Wavelink
Avalanche” on page 38.
Trakker Antares 241X Terminals
The Trakker Antares 2410 and 2415 terminals are small, lightweight,
handheld data collection terminals that are designed for a range of
applications, including commercial applications such as in-store retail.
2410
The 2410 is a programmable data collection terminal that runs custom
batch applications. The terminal has a flash drive to store applications and
files. The 2410 also has an integrated input/output (I/O) port to transmit
data to and accept data from a host or PC through RS-232 serial
communications.
2 Trakker Antares 2400 Family System Manual
Page 23
Chapter 1—Introducing the Trakker Antares 2400 Family
2415
The 2415 has all of the capabilities of the 2410; however, it can also
communicate in a radio frequency (RF) network. Because it can
communicate using RF, the 2415 provides real-time communications
to a host either through the access points and the Intermec Gateway or
DCS 30X, or directly through the access points. The 2415 can also run
client/server applications, TE 2000™ terminal emulation applications, and
Data Collection Browser™ (dcBrowser™), which lets you run web-based
applications.
Trakker Antares 242X Terminals
The 2420, 2425, and 2425CS terminals are handheld data collection
terminals. You can use these programmable terminals to run custom
applications or terminal emulation applications.
2420
The 2420 is a programmable data collection terminal that has 512K of
RAM reserved for custom applications. The terminal has a 750K flash
drive to store applications and files. The 2420 also has a serial port to
transmit data to and accept data from a host or PC through RS-232 serial
communications.
2425
The 2425 has all of the capabilities of the 2420 with the additional ability
to communicate in the RF network. Because it can communicate using
RF, the 2425 provides real-time communications to a host either through
the access points and Intermec Gateway or DCS 30X, or directly through
the access points. The 2425 can also run client/server applications,
terminal emulation applications, and dcBrowser, which lets you run webbased applications.
2425CS
The 2425CS has all of the capabilities of the 2425 with the addition of the
Intrinsically Safe qualification. For more information, see the 2425 Intrinsically Safe Terminal Instruction Sheet (P/N 069311).
Trakker Antares 243X Terminals
The 2430 and 2435 terminals are handheld data collection terminals. You
can use these programmable terminals to run custom applications or
terminal emulation applications.
Trakker Antares 2400 Family System Manual 3
Page 24
Chapter 1—Introducing the Trakker Antares 2400 Family
2430
The 2430 is a programmable data collection terminal that runs custom
batch applications. The 2430 has a flash drive to store applications and
files and an integrated I/O port to transmit data to and accept data from a
host computer or other serial device using RS-232 communications. The
versatile display features of the 2430 allow you to resize the screen up to 21
lines by 31 characters based on operator preference and work environment.
2435
The 2435 has all of the same functionality as the 2430 with the additional
ability for real-time communications through an RF network. The 2435
can communicate with a host either through the access points and the
Intermec Gateway or DCS 30X, or directly through the access points. The
2435 can also run client/server applications, TE 2000 terminal emulation
applications and dcBrowser, which lets you run web-based applications.
Trakker Antares 2455 Terminal
The 2455 is a vehicle-mount data collection terminal that can
communicate in an RF network. You can use this programmable terminal
to run client/server applications, terminal emulation applications, and
dcBrowser, which lets you run web-based applications.
Trakker Antares 246X Terminals
The Trakker Antares 2460 and 2461 stationary terminals are desktop data
collection terminals. You can use these programmable terminals to run
client/server applications such as work-in-process, time and attendance, or
document tracking.
2460
The 2460 is a programmable data collection terminal that uses serial ports
to transmit data to and receive data from a host or PC. The 2460 has two
serial ports, COM1 and COM2.
2461
The 2461 is a programmable data collection terminal that has both a serial
port and an Ethernet connector to transmit data and receive data.
Note: The 246X terminals are mentioned in this manual; however, the
primary source of information for these terminals is the user’s manual. For
help using the 246X, see the Trakker Antares 246X Stationary Terminal User’s Manual (P/N 068575).
4 Trakker Antares 2400 Family System Manual
Page 25
Chapter 1—Introducing the Trakker Antares 2400 Family
Trakker Antares 2475 Terminal
The 2475 is a vehicle-mount data collection terminal that can
communicate in an RF network. You can use this programmable terminal
to run client/server applications, terminal emulation applications, and
dcBrowser, which lets you run web-based applications.
Trakker Antares 248X Terminals
The Trakker Antares 248X terminals (2480, 2481, 2485, and 2486) are
compact stationary data collection terminals that are designed for a range
of applications including process tracking, labor collection, and time and
attendance applications. You can use these programmable terminals to run
either client/server applications or terminal emulation.
2480
The 2480 is a programmable data collection terminal. It has a serial port to
transmit data to and accept data from a host or PC through RS-232 serial
communications. With the optional Ethernet card, the 2480 can also
transmit and receive data through Ethernet communications. The 2480
has a 4-line by 40-character screen.
2481
The 2481 has the same functionality as the 2480. The only difference
between these two models is the screen size. The 2481 has a 12-line by 40character screen that is configurable up to 25 lines.
2485
The 2485 is a programmable data collection terminal with the additional
ability to communicate in the RF network. The 2485 provides wireless
communications to a host either through the access points and Intermec
Gateway or DCS 30X, or directly through the access points. The 2485 has
a 4-line by 40-character screen.
2486
The 2486 has the same functionality as the 2485. The only difference
between these two models is the screen size. The 2486 has a 12-line by 40character screen that is configurable up to 25 lines.
Trakker Antares 2400 Family System Manual 5
Page 26
Chapter 1—Introducing the Trakker Antares 2400 Family
What’s New in Firmware Version 8.01?
Note: Firmware version 8.01 is supported on all terminals in the Trakker
Antares 2400 Family except for the 246X. The 246X terminal supports
firmware version 6.2X and earlier. For help using the 246X terminal, see
the Trakker Antares 246X Stationary Terminal User’s Manual (P/N
068575).
With this system manual revision, several significant changes were made to
support software for firmware version 8.01:
• Support for the Wavelink Avalanche client management system was
added. For more information, see “Managing Your Terminals with
Wavelink Avalanche” on page 38.
• These configuration commands were added: Device Management,
Device Manager IP Address, GTIN Compliance, Terminal Port, and
Time Zone. For more information, see Chapter 6, “Configuration
Command Reference.”
• “Entering ASCII Characters” on page 129 was added to describe how to
enter characters using the TRAKKER Antares 2400 Menu System.
• These updates from the Trakker Antares 2400 Family System Manual Addendum (P/N 073395) were added:
• Keypad Table diagnostic
• AP Density, Display Spacing, Keypad Type, and Scanner Selection
configuration commands
About Network Connectivity and Protocols
The 2400 Family of terminals are data collection terminals with network
support. The terminals communicate with a host computer or other serial
device through the terminal’s serial port. The Ethernet terminal
communicates with a host directly through the Ethernet network. The RF
terminal also communicates with a host either through the Intermec
Gateway or DCS 30X, or directly through the access points. The access
point acts as a bridge between the Ethernet or wired network and the RF
network.
6 Trakker Antares 2400 Family System Manual
Page 27
Chapter 1—Introducing the Trakker Antares 2400 Family
In a UDP Plus or WTP network, the terminal communicates through an
access point using the Intermec Gateway or DCS 30X to a host on a wired
network. In a TCP/IP network, the terminal communicates through the
access point directly to a host on a wired network.
The communications protocol stack for the terminal is developed using
the Open Systems Interconnection (OSI) seven-layer model. The next
illustration shows how the network and RS-232 serial port map into the
OSI model.
The terminal applications including terminal emulation and screen
mapping are on top of the protocol stack. Intermec provides a terminal
communications API (application program interface) to interface to the
protocol stack. The API provides a common interface to the following
Intermec value-added protocols.
Trakker Antares Protocols
Protocol Description
Terminal
Message
Format
UDP Plus UDP Plus is an Intermec protocol built on top of the User
WTP WTP is an Intermec protocol that is designed to be used with TE
Trivial File
Transfer
Protocol
Configurable
Serial Port
Network
management
Terminal Message Format (TMF) is an Intermec proprietary
protocol that is used to route data and network management
messages between applications on the terminal and peer tasks on the
Intermec Gateway, DCS 30X, or host.
Datagram Protocol (UDP). It maximizes the performance of
wireless (RF) and hardwired networks and provides robust data
communications.
2000 terminal emulation. With terminal emulation, WTP provides
access to two host sessions and supports switching keys between the
two sessions.
Trivial File Transfer Protocol (TFTP) allows efficient file exchange
between the terminal and the DCS 300 or host.
Configurable Serial Port (CSP) protocol allows efficient file
exchange between the terminal and the host through RS-232 serial
communications. The terminal uses either the XMODEM or
YMODEM protocol to transfer files using reader commands.
Network management provides network access to the terminal
configuration, status, and statistics. Network management uses the
Terminal Message Format to receive and send messages.
The remaining layers in the protocol stack are a series of standard
protocols that interface with the drivers and hardware needed to support
the RF network and RS-232 serial communications.
Trakker Antares 2400 Family System Manual 7
Page 28
Chapter 1—Introducing the Trakker Antares 2400 Family
OSI Layers
Applications
Presentation
Session
Transport
Network
Data Link
Physical
Trakker Antares 2400 Family applications
Communications API and additions
Trivial File
Transfer
Protocol
(TFTP)
TCPUDP
ICMP, IP, and ARP
2.4 GHz RF protocol driver
RF NetworkWired
Terminal Message
Format (TMF)
UDP Plus
2.4 GHz radio
Configurable
Serial Port
protocol
Serial
port
driver
Serial port
Network
Network
management
241XXS028.eps
WTP Core
Trakker Antares Terminal Protocol Stack and the OSI Model
Note: In a WTP network, the WTP core replaces the shaded layers shown.
For help using WTP, see the appropriate TE 2000 user’s guide.
8 Trakker Antares 2400 Family System Manual
Page 29
Chapter 1—Introducing the Trakker Antares 2400 Family
Protocols Used by the Trakker Antares Terminals
Layer Protocol Description
Physical 2.4 GHz radio
Serial Port
Data Link 2.4 GHz RF
protocol driver
Serial port
driver
Network ICMP, IP, and
ARP
Transport UDP The User Datagram Protocol (UDP) complies with
TCP Transmission Control Protocol (TCP) complies with
Session and
Presentation
UDP Plus UDP Plus is an Intermec proprietary session layer
Provides spread spectrum radio signal control.
Provides serial communications.
Provides RF media access control. The default
hardwired media access control (MAC) protocol
used with TCP/IP supports the Ethernet II standard.
Provides serial communications control that uses
CSP and the standard XMODEM or the
YMODEM protocol for data transfer.
The Internet Control Message Protocol (ICMP)
complies with the standard outlined in RFC 826.
The Internet Protocol (IP) complies with the
standard outlined in RFC 791.
The Address Resolution Protocol (ARP) complies
with the standard outlined in RFC 826.
the standard outlined in RFC 768.
the standard outlined in RFC 793.
protocol built on UDP. The UDP Plus session layer
provides these services:
• Guaranteed delivery
• Duplicated message removal
• Link connection and status management
• Network error recovery
• Congestion control
• Device error detection
TFTP Trivial File Transfer Protocol (TFTP) allows
efficient file exchange between the terminal and the
DCS 300 or host. TFTP complies with the standard
outlined in RFC 1350.
Presentation
and
Application
TMF Terminal Message Format is an Intermec proprietary
protocol that is used to route data, configuration,
and network management messages between
applications on the terminal and peer tasks on the
Intermec Gateway, DCS 30X, or host.
Trakker Antares 2400 Family System Manual 9
Page 30
Chapter 1—Introducing the Trakker Antares 2400 Family
Protocols Used by the Trakker Antares Terminals (continued)
Layer Protocol Description
Application,
Presentation,
Session,
Transport,
and Network
WTP Wireless Transaction Protocol (WTP) is an Intermec
proprietary protocol that provides these Ethernet
level services:
• Duplicated message removal
• Guaranteed delivery
• Link connection and status management
• Network error recovery
• Congestion control
• Device error detection
10 Trakker Antares 2400 Family System Manual
Page 31
Configuring and Managing
2
This chapter describes the different methods you can use to configure the
Trakker Antares® terminals and covers these topics:
• Overview of how to configure the terminals
• Configuring the terminal by scanning bar code labels
• Configuring the terminal through the serial port
the Terminals
• Configuring the terminal through the network
• Configuring the terminal with the clone application
• Transferring files and data in a TCP/IP direct connect network
• Saving configuration changes in flash memory
• Restoring the terminal’s default configuration
• Upgrading the terminal
• Managing your terminals with Wavelink Avalanche
Trakker Antares 2400 Family System Manual 11
Page 32
Chapter 2—Configuring and Managing the Terminals
How to Configure the Terminals
You can customize many operating characteristics of the 2400 Family of
terminals such as the volume of their audio signals and the bar code
symbologies they decode. These characteristics are controlled by
configuration parameters. The values you set for the configuration
parameters determine how the terminal operates. To learn about each
parameter, see Chapter 6, “Configuration Command Reference.”
This chapter describes how to configure terminals using the UDP Plus or
TCP/IP networks. If you are using a WTP network, see the appropriate
TE 2000™ user’s guide. You can configure the terminals by using any of
these methods:
How to Configure the Terminals
Method Description
Use the
TRAKKER
Antares 2400
Menu System
Scan bar code
labels
Send commands
through the
serial port
Send commands
through the
Ethernet or RF
port
Use the clone
application
Use the
Wavelink
Avalanche
Manager
With menus and screens, the TRAKKER Antares 2400 Menu
System lets you view the current configuration and modify
configuration parameters. For help, see your user’s manual.
You can change the terminal’s configuration parameters by scanning
Code 39 or Code 93 bar code labels that contain configuration
commands. This method is a fast, easy way to change the terminal’s
configuration. You can scan the bar code labels in this manual, or
you can create your own bar code labels. For help, see “Configuring
the Terminal by Scanning Bar Code Labels” on page 13.
You can change the terminal’s configuration parameters by sending
commands from a host computer or PC that is connected to the
terminal’s serial port. For help, see “Configuring the Terminal
Through the Serial Port” on page 15.
You can change the terminal’s configuration parameters by sending
commands through the UDP Plus or TCP/IP network. This
method lets you configure one or more terminals at the same time.
For help, see “Configuring the Terminal Through the Network” on
page 17.
You can set the terminal’s configuration parameters by using the
clone application to copy configuration parameters from one
terminal to another. This method is a fast, easy way to configure
your new terminals with the same parameters as your existing
terminals. For help, see “Configuring the Terminal With the Clone
Application” on page 23.
You can send configuration information to multiple terminals in
your RF network using the Wavelink Avalanche client management
system and the Intermec Settings (ICCU) application. For help, see
“Managing Your Terminals with Wavelink Avalanche” on page 38.
12 Trakker Antares 2400 Family System Manual
Page 33
About the Configurations
The terminal uses three configurations: current, active, and default.
Having separate current and active configurations lets you control the
active configuration while letting each operator make some changes to the
current configuration, such as scanning a bar code to change the beep
volume.
Trakker Antares Configurations
Configuration Description
Current This configuration, also called the runtime configuration, uses the
Active When you update the flash memory, the terminal copies the current
Default This configuration is the factory default configuration. You may
Chapter 2—Configuring and Managing the Terminals
configuration that is saved in RAM. When you change a parameter
by using the menu system, by scanning a bar code, by sending it
from a host application, or by sending it from the DCS 300, the
terminal updates the current configuration. The changes to the
current configuration are lost when you boot or reset the terminal.
configuration to the active configuration. The active configuration
is the configuration that the terminal uses when you boot or reset
the terminal.
want to restore the default configuration. For help, see “Restoring
the Terminal’s Default Configuration” on page 30.
Configuring the Terminal by Scanning Bar Code Labels
You can configure the terminal by scanning bar code labels that are listed
in this manual or by creating your own Code 39 or Code 93 bar code
labels. For example, you can scan this bar code label to set the beep volume
to a quiet audio level:
Set Beep Volume to Quiet
*$+BV1*
*$+BV1*
Note: If you are working in the TRAKKER Antares 2400 Menu System,
you cannot scan configuration commands. Exit the menu system to scan
configuration commands.
As you scan bar code labels to configure the terminal, the terminal accepts
and sets all commands. However, the terminal only uses the parameters
that are valid for the current configuration. For example, if you configure
COM1 to use the Configurable protocol, disable Handshake, and set a
value for Poll, the terminal will set the value for Poll, but it will not use
this value because Handshake is disabled.
Trakker Antares 2400 Family System Manual 13
Page 34
Chapter 2—Configuring and Managing the Terminals
If you want to save your changes after you boot or reset the terminal, you
must save them in the terminal’s flash memory. For help, see “Saving
Configuration Changes in Flash Memory” on page 29.
To configure the terminal, you can scan separate bar code labels, or you
can create bar code labels that contain more than one configuration
command. For example, you can create one bar code label to configure the
terminal for:
• One-Shot Scanner mode (SB0)
• Scanner Redundancy set to high (SR2)
• Beep Volume set to very loud (BV4)
• Disable Keypad Clicker (KC0)
One-Shot Scanner Mode, Set Scanner Redundancy to High,
Set Beep Volume to Very Loud, Disable Keypad Clicker
*$+SB0SR2BV4KC0*
*$+SB0SR2BV4KC0*
When you create a bar code label to set several configuration commands,
follow these rules:
• The bar code label must be printed using Code 39 or Code 93
symbology. If you need to scan a Code 39 bar code label that includes
quotes or periods, you must configure the terminal to use Code 39 in
Full ASCII mode.
• The bar code label must include the start and stop character. Most bar
code printing utilities automatically include the start and stop character.
• The bar code label must start with $+ (Change Configuration
command).
• Each configuration command must include the command syntax and
the value for the command. For example, BV is the command syntax for
Beep Volume and the value 4 sets the beep volume to very loud.
• If you set one configuration command to a string of ASCII characters
and another configuration command follows, you must enclose the
value in quotes. If you do not include the quotation marks, the terminal
will interpret everything after the first command as data and will not
find the second configuration command.
• For example, to set the preamble to BV, use $+ADBV (no quotes are
needed). To set the preamble to BV and turn off the beep volume, use
$+AD"BV"BV0, or change the order and use $+BV0ADBV. To clear
the preamble and postamble from a single label, use $+AD""AE.
• To include quotation marks when you set a value, the entire value must
be enclosed in quotation marks. Type two sets of quotation marks ("")
to include one quotation mark as the value for a command. For
example, to set the preamble to ABC"D, use $+AD"ABC""D".
14 Trakker Antares 2400 Family System Manual
Page 35
Chapter 2—Configuring and Managing the Terminals
Configuring the Terminal Through the Serial Port
You can write a host application that configures the terminal by sending
reader and configuration commands through the serial port. For a list of
reader commands, see Chapter 5, “Reader Command Reference.” For a list
of configuration commands, see Chapter 6, “Configuration Command
Reference.” You must connect the terminal to the host by either using a
special cable or a communications dock and a special cable. Once the
terminal and the host are communicating, you can configure the terminal.
If you are using the Configurable protocol, you must enable Frame mode
and the Configuration Commands Via Serial Port command. You cannot
configure the terminal through the serial port if you are using
Configurable protocol with no EOM or Binary protocol on that port.
You can continue running an application on the terminal while
configuring the terminal from the host. However, if you send a
configuration command that changes the serial port parameters, you may
not be able to continue sending commands unless you also reconfigure
your host. You can also improve TMF performance by disabling the
Network Activate command before sending commands through the serial
port. For help, see “Network Activate” on page 210.
To set up the application
• Write a host application that can send transactions to and receive
transactions from the terminal in this format:
SOM TMF fieldcommands EOM
where:
SOM is the start of message field.
TMF fieldis only used if the Configuration Commands Via Serial
Port are enabled with TMF. It is a 2-byte field containing
one of these values:
CG Configuration Get request sent from the host
application.
Cg Configuration Get response sent from the terminal
to the host.
CS Configuration Set request sent from the host
application.
Cs Configuration Set response sent from the terminal to
the host.
To send data to an application instead of sending
configuration commands, use the letter A followed by a
space in the TMF field. If the TMF field does not contain
CG, Cg, CS, Cs, or A, the terminal ignores the transaction.
Trakker Antares 2400 Family System Manual 15
Page 36
Chapter 2—Configuring and Managing the Terminals
commandsare the reader and configuration commands that you want
to set on the terminal or get the current value of from the
terminal. To save configuration changes in flash memory,
send the reader command
EOM is the end of message field.
If the Configuration Commands Via Serial Port command
is enabled without TMF or if you are using a protocol
other than Configurable, leave this field blank.
Note: For security purposes, you cannot get the values for Security ID and
WEP Key. To get the value for Symbology Identifiers, you need to use the
command syntax and the value for Parameter 1. For example, to get the
value for the Code 39 symbology identifier, use CY01. For help, see
“Symbology Identifiers” on page 245.
Example with TMF
In the host application, you want to set the values for the beep volume and
keypad caps lock on the terminal. Send this transaction from the host
application:
.+1 as the last command.
CS$+BV4KA1.+1
Note: SOM and EOM are not shown in this example.
where:
CS is a TMF Configuration Set request.
$+ is the Change Configuration reader command.
BV4 sets the Beep Volume command to a value of 4, which is
a very loud beep volume.
KA1 enables the Keypad Caps Lock configuration command.
.+1 saves the configuration changes to the terminal’s flash
memory.
The terminal returns this transaction to the host application:
Cs$+BV4KA1.+1
where:
Cs is a TMF Configuration Set response.
$+ is the Change Configuration reader command.
16 Trakker Antares 2400 Family System Manual
Page 37
Chapter 2—Configuring and Managing the Terminals
BV4 means the Beep Volume command has been changed to
a value of 4, which is a very loud beep volume.
KA1 means the Keypad Caps Lock configuration command
was enabled.
.+1 means the configuration changes have been saved in
flash memory.
Configuring the Terminal Through the Network
You can remotely configure the RF or Ethernet terminal by using one of
these methods:
• Send a command from the DCS 300 (UDP Plus network only).
• Send a command from an application on the host computer (UDP Plus
and TCP/IP networks).
Before you can send a command to the terminal, it must be
communicating with the RF network. You must have already installed and
configured the access points. If you are using a UDP Plus network, you
must have installed and configured the DCS 300.
You can modify most RF network parameters through the network, except
for these parameters:
• Acknowledgement Delay Lower Limit
• Acknowledgement Delay Upper Limit
• Controller Connect Check Receive Timer
• Controller Connect Check Send Timer
• DHCP (Controller)
• DHCP (Terminal)
• Maximum Retries
• Network Activate
• TCP Maximum Retries
• TCP/IP Maximum Transmit Timeout
You can modify these parameters or configure the terminal locally by using
the TRAKKER Antares 2400 Menu System or by scanning a command
from a Code 39 or Code 93 bar code label.
Note: You can continue running an application on the terminal while
configuring the terminal from the network.
Trakker Antares 2400 Family System Manual 17
Page 38
Chapter 2—Configuring and Managing the Terminals
Sending a Command From the DCS 300
You can use the DCS 300 to configure one or more terminals in your RF
or Ethernet network. The DCS 300 lets you group together terminals that
you want to receive the same reader and configuration commands.
This method is very efficient if you need to change the same configuration
parameters for several terminals in one area. For example, you may want to
set the Beep Volume to very loud and turn on Keypad Caps Lock for all
the terminals in one area.
Note: You can configure an RF or Ethernet terminal from the DCS 300,
but you cannot get configuration data from the terminal.
To send commands from the DCS 300
1 Using the Download Server feature on the server, select the terminal or
group to which you want to download the reader and configuration
commands, and then choose Edit. For help configuring a group of
terminals, see the DCS 300 User’s Manual (P/N 067296).
2 In the Initialization Data box, choose the Command option button.
3 In the Initialization Data box field, enter the reader or configuration
command, and then choose Add. The command appears in the Files
and Data box.
For example, enter this command to set the Beep Volume to very loud:
$+BV4
18 Trakker Antares 2400 Family System Manual
Page 39
Note: You can set the Postamble or Preamble configuration command
to use characters from the extended ASCII character set such as the
Field Exit code for 5250 TE. For help, see the appropriate TE manual.
4 Repeat Step 3 to add another reader or configuration command, or
choose OK.
5 To save the configuration changes in flash memory, enter .+1 as the last
command.
If you do not save the configuration changes in flash memory, the
commands only change the current configuration.
6 Choose OK. The Terminal Download Configuration dialog box
appears.
7 Choose Download to download the commands and change the
configuration of the selected terminals.
Sending a Command From the Host
Chapter 2—Configuring and Managing the Terminals
You can write a host application that configures one RF or Ethernet
terminal. This host application must be able to communicate with the
DCS 300 in a UDP Plus network or directly through the access point in a
TCP/IP direct connect network.
Configuring the Terminal in a UDP Plus Network
You can use the host computer to configure a terminal in your RF or
Ethernet network. To send and receive configuration data or files, you
need to write a host application that can communicate with the DCS 300.
For help, see the DCS 300 User’s Manual. You use the Terminal Message
Format (TMF) protocol to send and receive transactions between the host
application and the terminal.
To set up the DCS 300
• Configure a peer-to-peer destination name for the host application.
Create a transaction ID, $NGCFGRSP, that will be routed to this
destination name. The DCS 300 uses the transaction ID to route
responses from the terminal back to the host application. $NGCFGRSP
is a special transaction ID that the server uses to forward configuration
response data from a terminal.
All configuration responses will be routed with the $NGCFGRSP
transaction ID. The DCS 300 cannot keep track of multiple
applications sending reader or configuration commands. If you have
two host applications sending reader or configuration commands, they
must both be configured to receive the $NGCFGRSP transactions, and
therefore both will receive all responses from all terminals.
Trakker Antares 2400 Family System Manual 19
Page 40
Chapter 2—Configuring and Managing the Terminals
To set up the host computer
• Verify that the host computer can communicate with the DCS 300.
To set up the application
• Prepare and write a host application that can communicate with the
DCS 300 and send transactions to and receive transactions from the
terminal in this format:
transaction header TMF field commands
where:
transaction
header
is a 96-byte field containing the message number, date
and time, source application ID, destinations
application ID, transaction ID, and other
information. You must set the system message
(SYS$MSG) flag to E in the transaction header. For
help, see the DCS 300 User’s Manual.
TMF fieldis a 2-byte field containing one of these values: CG Configuration Get request sent from the host
application.
Cg Configuration Get response sent from the
terminal to the host.
CS Configuration Set request sent from the host
application.
Cs Configuration Set response sent from the
terminal to the host.
commands are the reader and configuration commands that you
want to set on the terminal or the current value you
want to retrieve from the terminal. To save
configuration changes in flash memory, send the
reader command .+1 as the last command.
To see examples of the host application transactions, see “Example 1” on
page 22 and “Example 2” on page 22.
Configuring the Terminal in a TCP/IP Direct Connect Network
You can use the host computer to configure an RF or Ethernet terminal in
your TCP/IP network.
To send and receive configuration data, you need to write a host
application that can communicate with the terminal directly through an
20 Trakker Antares 2400 Family System Manual
For a list of commands, see Chapter 5, “Reader
Command Reference,” or Chapter 6, “Configuration
Command Reference.”
Page 41
Chapter 2—Configuring and Managing the Terminals
access point or through the Ethernet network. You use the Terminal
Message Format (TMF) protocol to send and receive transactions between
the host application and the terminal.
For more information about sending and receiving data, see “Transferring
Files and Data in a TCP/IP Direct Connect Network” on page 24.
Note: You can continue running an application on the terminal while
configuring the terminal from the host.
To set up the host computer
• Verify that you can communicate with the terminal.
To set up the application
• Prepare and write a host application that can communicate with the
terminal. Configuration commands must be sent to network port 6000
on the terminal. Message transactions to and receive transactions from
the terminal on network port 6000 must conform to the following
format:
TMF field commands
where:
TMF fieldis a 2-byte field containing one of these values: CG Configuration Get request sent from the host
application.
Cg Configuration Get response sent from the
terminal to the host.
CS Configuration Set request sent from the host
application.
Cs Configuration Set response sent from the
terminal to the host.
commandsare the reader and configuration commands that you
want to set on the terminal or the current value you
want to retrieve from the terminal. To save
configuration changes in flash memory, send the
reader command .+1 as the last command.
For a list of commands, see Chapter 5, “Reader
Command Reference,” or Chapter 6, “Configuration
Command Reference.”
Trakker Antares 2400 Family System Manual 21
Page 42
Chapter 2—Configuring and Managing the Terminals
Example 1
In the host application, you want to get the current values of two
configuration commands from the terminal. Send this transaction from
the host application:
CG$+NABV
Note: The transaction header is not shown in this example. You do not
need a transaction header for a host application in a TCP/IP network.
where:
CG is a TMF Configuration Get request.
$+ is the Change Configuration reader command.
NA is the Network Activate configuration command.
BV is the Beep Volume configuration command.
The terminal returns this transaction to the host application.
Cg$+NA1BV4
where:
Cg is a TMF Configuration Get response.
$+ is the Change Configuration reader command.
NA1 means the Network Activate configuration command is
currently set to a value of 1, which means that the RF or
Ethernet network is enabled.
BV4 means the Beep Volume configuration command is
currently set to a value of 4, which is a very loud beep
volume.
Example 2
In the host application, you want to set the value for two configuration
commands on the terminal. Send this transaction from the host
application:
CS$+BV4KA1
Note: The transaction header is not shown in this example. You do not
need a transaction header for a host application in a TCP/IP network.
where:
CS is a TMF Configuration Set request.
$+ is the Change Configuration reader command.
22 Trakker Antares 2400 Family System Manual
Page 43
Chapter 2—Configuring and Managing the Terminals
BV4 sets the Beep Volume configuration command to a value
of 4, which is a very loud beep volume.
KA1 sets the Keypad Caps Lock configuration command to a
value of 1, which enables the Keypad Caps Lock.
The terminal returns this transaction to the host application.
Cs$+BV4KA1
where:
Cs is a TMF Configuration Set response.
$+ is the Change Configuration reader command.
BV4 means the Beep Volume configuration command has
been changed to a value of 4, which is a very loud beep
volume.
KA1 means the Keypad Caps Lock configuration command
has been changed to a value of 1, which enables the
Keypad Caps Lock.
Configuring the Terminal With the Clone Application
The clone application uses XMODEM-1K protocol to copy configuration
parameters and applications from one terminal (server terminal) to another
(client terminal). The server and client terminals must have the same:
• hardware configuration.
• version of firmware.
• version of the clone application.
Note: The clone application does not clone terminals with double-byte
fonts or the 802.1x security option.
The clone application copies all configuration parameters from the server
terminal to the client terminal, except for:
• terminal IP address.
• security ID.
You need to configure these parameters separately. The clone application
also removes all existing files on the client terminal’s C drive and replaces
them with the files on the server terminal’s C drive.
For more information about upgrading firmware, see “Upgrading the
Firmware” on page 31. For more information about downloading
applications, see “How to Download Applications” on page 53.
Trakker Antares 2400 Family System Manual 23
Page 44
Chapter 2—Configuring and Managing the Terminals
To clone configuration parameters and applications
1 Make sure the server terminal’s configuration is saved in flash memory
by scanning this bar code:
Save Configuration in Flash Memory
*.+1*
*.+1*
2 Load all applications and files to clone on the server terminal’s C drive.
3 (RF terminals only) Disable the radio on both the server terminal and
the client terminal.
4 Run the clone application on the server unit.
a Choose Main Menu > System Menu > Clone Unit.
b Select OK to continue.
c Select Server.
5 Run the clone application on the client unit.
a Choose Main Menu > System Menu > Clone Unit.
b Select OK to continue.
c Select Client.
6 Connect COM1 on the server terminal to COM1 on the client terminal
using an RS-232 null modem cable. If you are cloning a 243X terminal,
you can use the cloning cable accessory (P/N 216-909-001).
The cloning process automatically begins once you connect the
terminals. The client terminal lists the applications when cloning is
complete.
7 On the server terminal, press d to exit. You can also configure another
terminal by connecting it to the server terminal.
Transferring Files and Data in a TCP/IP Direct Connect Network
In a TCP/IP direct connect network, you can use a host application to
transfer files and send data between the terminal and host.
To initiate file transfers from the host, you must write a host application
that can communicate directly with an RF or Ethernet terminal. You use
the file management reader commands such as Receive File and Transmit
File to transfer files between the terminal and the host. For help, see
Chapter 5, “Reader Command Reference.”
To initiate file transfers from the terminal, you do not need to develop a
host application as described in this section. You can use the Receive File
and Transmit File reader commands within a terminal application or by
scanning bar code labels. For help, see Chapter 5, “Reader Command
Reference.”
24 Trakker Antares 2400 Family System Manual
Page 45
Chapter 2—Configuring and Managing the Terminals
To use the built-in TFTP client on the RF or Ethernet terminal, the
• TFTP (Trivial File Transfer Protocol) server must be running on the
host.
• TFTP server must be running on at least a Pentium processor or
equivalent.
• RF or Ethernet terminal must be communicating with the host that is
running the TFTP server.
• TFTP server or some other application on the host must be able to send
the reader command on the network.
Note: You can continue running an application, except TE, on the RF or
Ethernet terminal while transferring files from the host.
To transfer files or send configuration data from the host
1 Make sure the TFTP server is running on the host and the RF or
Ethernet terminal is communicating with the host.
2 Start the host application that can send reader commands to the
terminal.
3 Send the two-character TMF code, CS (Configuration Set request)
followed by the reader or configuration command. For help with TMF,
see “Configuring the Terminal in a TCP/IP Direct Connect Network”
on page 20.
For example, to send the application INVENTRY.BIN from drive C on
the host to drive C on the terminal, enter this command:
CS.%R,c:inventry.bin,c:inventry.bin
For command information, see Chapter 5, “Reader Command
Reference,” or Chapter 6, “Configuration Command Reference.”
CLIENT.CPP is the source for a sample application you can run on the
host. You can use CLIENT.CPP to send reader commands to the RF or
Ethernet terminal and receive the resulting messages.
The source code for the sample utilities CLIENT.CPP and the include file
UTILS.H is shown on the next pages. You can build the application using
Microsoft Visual C++ version 4.0 or later and the Windows sockets library
that is included with Microsoft Visual C++. You can also develop your
own application to meet the needs of your host environment.
You run the resulting application (CLIENT.EXE) from the DOS
command line. The application expects NCM to be defined as the
terminal IP address in the hosts file. Once running, the application
prompts you to enter a reader command, which it then sends to the RF or
Ethernet terminal. The application also displays any return messages.
Reader commands are handled by the Trakker Antares operating system,
so you can continue running an application while you use the
CLIENT.EXE application to send commands.
Trakker Antares 2400 Family System Manual 25
Page 46
Chapter 2—Configuring and Managing the Terminals
To use the sample utility CLIENT.CPP
1 Make sure the TFTP server is running on the host and the RF or
Ethernet terminal is communicating with the host.
2 In the hosts file on the host, add the terminal IP addresses and the target
name, NCM. For example, to send files or data to the terminal with an
IP address of 192.9.200.130, add this line to the hosts file:
192.9.200.130 ncm
3 Start the CLIENT.EXE application on the host.
4 When the “Enter Command” prompt appears on the host, enter the
two-character TMF code, CS (Configuration Set request) followed by
the reader or configuration command.
For example, to send the application INVENTRY.BIN from drive C on
the host to drive C on the terminal, enter this command:
CS.%R,c:inventry.bin,c:inventry.bin
CLIENT.CPP Sample Application for a TCP/IP Direct Connect Network
// our application uses a fixed port number
const unsigned short SERVER_PORT = 6000;
const unsigned short CLIENT_PORT = 6001;
// we will default to the local host machine
// unless argv[1] has a hostname
const char SERVER_HOSTNAME[] = "ncm";
int main(int argc, char *argv[])
{
// turn on the socket library for this process
WSADATA wsad;
int error = WSAStartup(MAKEWORD(1,1), &wsad);
if (error != 0)
ErrorMessage("WSAStartup", WSAGetLastError());
// create an unitialized connection-oriented socket
SOCKET connection;
connection = socket(PF_INET, SOCK_DGRAM, 0);
if (connection == INVALID_SOCKET)
ErrorMessage("socket", WSAGetLastError());
// lookup the IP address of the requested host
HOSTENT *phostent = gethostbyname(argc == 2 ? argv[1] : SERVER_HOSTNAME);
if (phostent == 0)
ErrorMessage("gethostbyname", WSAGetLastError());
// define a SOCKADDR to contain the IP address of the
// server and the port number of our application
SOCKADDR_IN serverAddress;
memset(&serverAddress, 0, sizeof(serverAddress));
serverAddress.sin_family = PF_INET;
26 Trakker Antares 2400 Family System Manual
Page 47
Chapter 2—Configuring and Managing the Terminals
serverAddress.sin_port = htons(SERVER_PORT);
memcpy(&serverAddress.sin_addr, phostent->h_addr_list[0], phostent->h_length);
// Bind a well known port of 6000 to the socket
SOCKADDR_IN clientAddress;
memset(&clientAddress, 0, sizeof(clientAddress));
clientAddress.sin_family = PF_INET;
clientAddress.sin_port = htons(CLIENT_PORT);
clientAddress.sin_addr.s_addr = htonl(INADDR_ANY);
if(!(bind(connection, (LPSOCKADDR)&clientAddress, sizeof(clientAddress))
==0))
{
ErrorMessage("bind", WSAGetLastError());
}
// attempt to connect to the server
error = connect(connection, (const SOCKADDR *)&serverAddress,
sizeof(serverAddress));
if (error != 0)
ErrorMessage("connect", WSAGetLastError());
// check the local name for the socket
SOCKADDR_IN localName;
memset(&localName, 0, sizeof(localName));
int localNameLength = sizeof(localName);
error = getsockname(connection, (LPSOCKADDR)&localName,
&localNameLength);
// run the user-interface
char sz[1024];
char rz[1024];
BOOL bConnectionAlive = TRUE;
printf("> ");
int Scount, Rcount;
int cbRecv, cbSend;
Scount = Rcount = 0;
int cbLen, rcLen;
unsigned char *psend = (unsigned char *)sz;
// continue while not EOF on the console and the connection is alive
while (bConnectionAlive)
{
// send the string entered by the user
printf("Enter Command:\n");
printf("> ");
gets(sz);
if(sz[0] != 'q')
{
cbLen = strlen(sz);
cbSend = send(connection, (const char *)psend, cbLen, 0);
if (cbSend < 0)
{
Scount++;
printf("send failed %d\n", Scount);
bConnectionAlive = FALSE;
ErrorMessage("send", WSAGetLastError());
}
Trakker Antares 2400 Family System Manual 27
Page 48
Chapter 2—Configuring and Managing the Terminals
Sleep(2000);
// receive the converted string from the server
memset(&rz, 0, sizeof(rz));
rcLen = sizeof(rz);
cbRecv = recv(connection, rz, rcLen, 0);
if (cbRecv < 0)
{
Rcount++;
printf("receive failed %d\n", Rcount);
ErrorMessage("receive", WSAGetLastError());
bConnectionAlive = FALSE;
}
// printf the converted string
printf("response:%s\n",rz);
printf("\n> ");
Sleep(1000);
}
else
bConnectionAlive = FALSE;
}
// release the resources held by the socket
error = closesocket(connection);
if (error != 0)
ErrorMessage("closesocket", WSAGetLastError());
// release the resources held by the socket library
error = WSACleanup();
if (error != 0)
ErrorMessage("WSACleanup", WSAGetLastError());
return 0;
}
0);
if (!bRet)
lstrcpy(szPrompt, __TEXT("Unknown Error"));
wsprintf(szTitle, __TEXT("%s failed with error code (0x%x)!"), szFn,
dwError);
int id = MessageBox(HWND_DESKTOP, szPrompt, szTitle,
MB_ABORTRETRYIGNORE|MB_SETFOREGROUND);
if (id != IDIGNORE)
ExitProcess(0);
}
28 Trakker Antares 2400 Family System Manual
Page 49
Chapter 2—Configuring and Managing the Terminals
Saving Configuration Changes in Flash Memory
If you configure the terminal by scanning bar code labels, using the serial
port, or using the network, you may want to save the changes in flash
memory by:
• scanning the Save Configuration in Flash Memory reader command bar
code label.
• sending the Save Configuration in Flash Memory reader command
through the network.
• using the TRAKKER Antares 2400 Menu System.
To save configuration changes by scanning a bar code label
• Scan this bar code label:
Save Configuration in Flash Memory
*.+1*
*.+1*
To save configuration changes by sending a command through the network
• Send .+1 as the last command from the host application or the
DCS 300.
To save configuration changes using the menu system
1 Press ) ; 2 4 8 or scan this bar code:
TRAKKER Antares 2400 Menu System
*..-.*
*..-.*
The Main Menu appears.
2 Choose System Menu > Store Configuration. The Store
Configuration screen appears.
Store configuration
changes in flash
(used when rebooting
memory?
the terminal)
YesNo
Trakker Antares 2400 Family System Manual 29
CANCEL
24XXS033.eps
Page 50
Chapter 2—Configuring and Managing the Terminals
3 Choose Yes to save the configuration in flash memory.
To exit without saving the configuration, choose Cancel. The System
Menu appears.
4 Press d to exit the System Menu. The Main Menu appears.
5 Choose another menu from the Main Menu or press d to exit the
TRAKKER Antares 2400 Menu System.
Restoring the Terminal’s Default Configuration
The default configuration for the terminal is listed starting on page 272.
You can restore the terminal’s default configuration by:
• scanning the Default Configuration bar code label.
• sending a command through the network.
• using the TRAKKER Antares 2400 Menu System.
If you restore the default configuration, you need to set the primary
network communications parameters on the RF terminal to reestablish
communications with other devices in the RF network. You may also need
to reset the serial port or Ethernet parameters to communicate with other
devices in your wired network.
To restore the default configuration by scanning a bar code label
• Scan this bar code label:
Default Configuration
*.+*
*.+*
To restore the default configuration by sending a command through the network
• Send .+0 from the host application or the DCS 300.
To restore the default configuration using the menu system
1 Press ) ; 2 4 8 or scan this bar code:
TRAKKER Antares 2400 Menu System
*..-.*
*..-.*
The Main Menu appears.
2 Choose System Menu > Load Default Values. The Load Default
Values screen appears.
30 Trakker Antares 2400 Family System Manual
Page 51
Chapter 2—Configuring and Managing the Terminals
LOAD DEFAULT VALUES
Load default
configuration
values in RAM?
(Overwrites current
configuration)
OKCANCEL
3 Choose OK and press ; to load the default configuration values. The
default values will override the current runtime configuration on the
terminal.
To exit without loading the default values, choose Cancel and press
;. The System Menu appears.
4 Press d to exit the System Menu. The Main Menu appears.
5 Choose another menu from the Main Menu or press d to exit the
TRAKKER Antares 2400 Menu System.
Upgrading the Terminal
This section explains how to upgrade the firmware on the terminal and
how to load double-byte fonts, if you choose to order them after you
receive your terminal. You can also upgrade the terminal for:
• TE 2000 (new releases)
• Data Collection Browser™ (dcBrowser™)
For pricing and availability, contact your local Intermec representative.
24XXS034.eps
Upgrading the Firmware
When you upgrade the firmware, you remove existing applications and
files on the terminal and restore the terminal’s default configuration. Make
sure you back up your custom files and applications, such as TE 2000,
dcBrowser, and ROM-DOS™, so that you can reinstall them after the
upgrade procedure. For help, see “Using the Serial Port to Transfer
Applications and Files” on page 55.
You will need to set the primary network communications parameters on
the RF terminal to reestablish communications with other devices in the
RF network. You may also need to reset the serial port or Ethernet
parameters to communicate with other devices in your wired network.
Trakker Antares 2400 Family System Manual 31
Page 52
Chapter 2—Configuring and Managing the Terminals
Note: Trakker Antares Native terminal emulation is only supported on
terminals with firmware version 6.23 and earlier. If you want to upgrade
your firmware to version 7.0 or later and continue to use a terminal
emulation application, you can order TE 2000. For help, see your local
Intermec sales representative.
You can download the latest version of firmware from the Intermec web
site at www.intermec.com. When you download the firmware files,
you will be prompted to also download the Trakker Antares Firmware
Upgrade Utility (TAUPGRADE.EXE) and the FileCopy application
(FILECOPYx.x.EXE, where x.x is the version number). Download
TAUPGRADE.EXE if you are using a PC with Microsoft Windows
2000/NT/XP. Download FILECOPYx.x.EXE if you have or need to load
TE 2000 on your terminal.
You can upgrade your terminal firmware using the:
• Trakker Antares DOS Firmware Upgrade Utility (UPGRADE.BAT).
This utility is included with the firmware upgrade. You can use this
utility to upgrade the firmware using an MS-DOS window on a PC
with Microsoft Windows 95/98.
If you want to use the DOS Firmware Upgrade Utility on a PC with
Windows 2000/NT/XP, you can follow the upgrade procedure through
Step 13. Print the UPGRADE.BAT file. Identify the numbers that are
associated with the menu selections in Steps 15 through 18. When you
get to Step 14, type:
UPGRADE X X X X
where the Xs represent the menu selection numbers.
• Trakker Antares Firmware Upgrade Utility (TAUPGRADE.EXE).
This utility is available at no charge from the Intermec web site at
www.intermec.com. It allows you to upgrade the terminal firmware
using a Microsoft Windows interface on a PC with Microsoft Windows
2000/NT/XP.
Note: The Trakker Antares Firmware Upgrade Utility cannot be used
to upgrade terminals with 802.1x security.
• Firmware Upgrade Utility on the DCS 300.
This section describes how to use the DOS Firmware Upgrade Utility and
the Trakker Antares Firmware Upgrade Utility. For help using the
Firmware Upgrade Utility on the DCS 300, see the DCS 300 User’s Manual.
32 Trakker Antares 2400 Family System Manual
Page 53
Chapter 2—Configuring and Managing the Terminals
To upgrade the firmware using the Trakker Antares DOS Firmware Upgrade Utility
Note: Make sure you back up your custom files and applications, such as
TE 2000, dcBrowser, and ROM-DOS, so that you can reinstall them after
the upgrade procedure. For help, see “Using the Serial Port to Transfer
Applications and Files” on page 55.
1 Open the MS-DOS window, and then open the MS-DOS Prompt
Properties dialog box. On the Memory tab, set the Initial Environment field to 4096. Close the MS-DOS window and re-open
it.
2 Connect the terminal to a PC running Windows 95/98. For help see
your user’s manual.
3 Create a new directory on your PC.
4 Copy these five upgrade files to the directory that you created in Step 3:
• INSTALL.BAT
• INSTALL.INF
• README.TXT
• TKANTxxx.EXE, where xxx is the firmware revision number.
Or, TKVxxxxx.EXE, where xxxxx is the field trial release number.
• WHATSNEW.TXT
Note: If you are using Wavelink Avalanche, copy all of the Avalanche
(.AVA) files in addition to the upgrade files.
5 Access the MS-DOS window.
6 Change to the directory where the upgrade files are located.
7 Type:
INSTALL
The batch file explodes the TKANTxxx.EXE or TKVxxxxx.EXE file to
a new directory. This new directory contains all the files you need to
perform an upgrade.
8 On the terminal, press ) ; 248 or scan this bar code label:
TRAKKER Antares 2400 Menu System
*..-.*
*..-.*
The Main Menu appears.
Trakker Antares 2400 Family System Manual 33
Page 54
Chapter 2—Configuring and Managing the Terminals
9 Choose System Menu > Upgrade Firmware. The Upgrade Firmware
screen appears.
UPGRADE FIRMWARE
Upgrade terminal
firmware?
Make sure the
terminal is
connected to a host
OK
CANCEL
10 Choose OK to continue. The next screen appears.
Are you sure you
want to continue?
Selecting YES will
upgrade and replace
all of the
terminal's firmware.
Selecting NO will
exit without
upgrading firmware.
YES
YES
NO
24XXS036.eps
11 Choose Yes to continue and upgrade the firmware. The terminal
reboots and then displays the Loader Waiting screen.
If you reach the Loader Waiting screen and cannot upgrade or continue,
press d once or œ twice to exit without upgrading the firmware. The
Boot Menu appears. Press 2 or L to access the Loader Waiting
screen.
24XXS035.eps
12 On your PC in the MS-DOS window, change to the directory that
contains the upgrade files in Step 6.
13 Type:
UPGRADE
A menu appears asking you to select a communications port.
If you are using Windows 2000/NT/XP, print the UPGRADE.BAT
file. Identify the numbers that are associated with the menu selections in
Steps 15 through 18. Type:
UPGRADE X X X X
where the Xs represent the menu selection numbers.
34 Trakker Antares 2400 Family System Manual
Page 55
Chapter 2—Configuring and Managing the Terminals
14 Select a communications port:
Type This Value Communications Port
1 COM1
2 COM2
3 COM3
4 COM4
A menu appears asking you to select a download speed.
A menu appears asking you to select which protocol stack to use.
16 Select a protocol stack:
Type This Value Protocol Stack
1 UDP Plus
2 TCP/IP
3 Batch/Serial
4 WTP
A menu appears asking you to select the communication hardware for
your terminal.
17 Select the communications hardware:
Type This Value Communications Hardware
1 OpenAir radio
2 802.11b radio
3 Ethernet
4 802.11b radio and 802.1x TTLS security
5 802.11b radio and 802.1x LEAP security
Note: You can only select 802.11b radio and TTLS or LEAP security if you
selected TCP/IP in Step 17 and you have either the 802.1x security option or
the 4MB flash memory.
The Loader screen appears and begins downloading the firmware and
application to the terminal.
Trakker Antares 2400 Family System Manual 35
Page 56
Chapter 2—Configuring and Managing the Terminals
18 When you are done upgrading the firmware, the terminal returns to its
default configuration. You will need to reconfigure the terminal. For
help, see “How to Configure the Terminals” on page 12.
19 If necessary, reload your custom applications and files on the terminal.
For help, see “Using the Serial Port to Transfer Applications and Files”
on page 55.
To upgrade the firmware using the Trakker Antares Firmware Upgrade Utility
Note: Make sure you back up your custom files and applications, such as
TE 2000, dcBrowser, and ROM-DOS, so that you can reinstall them after
the upgrade procedure. For help, see “Using the Serial Port to Transfer
Applications and Files” on page 55.
1 The Trakker Antares Firmware Upgrade Utility is included with the
firmware upgrade. Install the utility (TAUPGRADE.EXE) on your PC.
2 Use the online help that ships with the utility to upgrade the firmware
on your terminal.
3 If necessary, reload your custom applications and files on the terminal.
For help, see “Using the Serial Port to Transfer Applications and Files”
on page 55.
Loading Double-Byte Fonts
If you ordered the optional 4MB flash drive (drive D), you can order a
double-byte font and load the font on your terminal. To order a doublebyte font, contact your local Intermec representative.
Note: Double-byte fonts are not available for terminals with the 802.1x
security option.
You can also order the Thai language font as a configuration option for the
Trakker Antares 2400 Family. For help, contact your local Intermec
representative. Use the next table to determine which file name you need.
Double-Byte Fonts
Language File Name
Simplified Chinese, VT 24DBCSCT.FON
Simplified Chinese, 5250 24DBCSCL.FON
Japanese EUC (unix), VT 24DBCSJT.FON
Japanese, 5250 24DBCSJL.FON
Korean, VT 24DBCSKT.FON
Korean, 5250 24DBCSKL.FON
36 Trakker Antares 2400 Family System Manual
Page 57
Chapter 2—Configuring and Managing the Terminals
Double-Byte Fonts (continued)
Language File Name
Big 5 Chinese, VT 24DBCSTT.FON
Big 5 Chinese, 5250 24DBCSTL.FON
Note: If you are using a Japanese double-byte font, the cursor symbol is
represented by an arrow symbol.
If you have a 241X terminal, you may also need to order a keypad overlay
to use the double-byte font. For more information, contact your local
Intermec representative.
To load a double-byte font
1 Connect your terminal to a PC running Windows 95/98. For help, see
your user’s manual.
2 On your PC, copy the FLOADER.EXE application and the double-
byte font file into a directory.
3 On your terminal, press ) ; 248 or scan this bar code label:
TRAKKER Antares 2400 Menu System
*..-.*
*..-.*
The Main Menu appears.
4 Choose System Menu > Upgrade Firmware. The Upgrade Firmware
screen appears.
5 Choose OK to continue.
6 Choose Yes to continue and upgrade the firmware. The terminal
reboots and displays the Loader Waiting screen.
Note: If you reach the Loader Waiting screen and cannot upgrade or
continue, press d once or œ twice to exit without upgrading the
firmware. The Boot Menu appears. Press 2 or L to access the Loader
Waiting screen.
7 On your PC, access the MS-DOS window.
8 At the prompt, change to the directory that contains the double-byte
font.
Trakker Antares 2400 Family System Manual 37
Page 58
Chapter 2—Configuring and Managing the Terminals
9 Type:
FLOADER /COMn /baudratefilename.FON
where:
baudrate is b9600, b19200, b38400, b57600, or b115200.
filename is one of the file names in the table.
n is the number of the COM port.
The font is downloaded to your terminal.
10 On your terminal, press d to exit the Loader Waiting screen, and press
1 or B to boot the terminal.
Managing Your Terminals with Wavelink Avalanche
You can manage Trakker Antares terminals with firmware version 8.01 or
later with the Wavelink Avalanche client management system.
This section provides a brief overview of Wavelink Avalanche and
describes how it interacts with your Trakker Antares terminal. To learn
more about how to use Wavelink Avalanche in your data collection
network, see the Wavelink Avalanche documentation and online help.
Learning About Wavelink Avalanche
To use Wavelink Avalanche, you need:
• Wavelink Avalanche Manager version 3.0 or later.
• Trakker Antares RF terminal (TCP/IP or UDP Plus) with firmware
version 8.01 or later.
The Wavelink Avalanche system uses three main components to help you
easily manage your terminals and other devices.
Wavelink Avalanche Components
Component Description
Enabler Resides on all devices managed by the Avalanche system. It
communicates information about the device to the Avalanche
Agent and manages software applications on the device.
Agent Automatically detects and upgrades all devices in the Wavelink
Avalanche system and manages the daily processing functions.
Console The administrative user interface that lets you configure and
communicate with the Agent. From the Console, you can
configure and monitor devices and build and install software
packages and software collections.
38 Trakker Antares 2400 Family System Manual
Page 59
Chapter 2—Configuring and Managing the Terminals
Wavelink Avalanche uses a hierarchical file system organized into software
packages and software collections.
• Software packages are groups of files for an application that resides on
the device.
• Software collections are logical groups of software packages.
The Trakker Antares terminal requires the 24XXCOR.AVA software
package and one Trakker Antares protocol software package. The
Avalanche Console displays the package title.
Trakker Antares Protocol Packages
Package
Filename
24xxTCP.AVA Trakker Antares TCP/IP Network Stack for OpenAir Radios
24xxHW.AVA Trakker Antares TCP/IP Network Stack for Ethernet
24xxTDS.AVA Trakker Antares TCP/IP Network Stack for 802.11 DS
24xxTLS.AVA Trakker Antares TCP/IP Network Stack for 802.11 DS with LEAP
24xxTSS.AVA Trakker Antares TCP/IP Network Stack for 802.11 DS with TTLS
24xxP24.AVA Trakker Antares UDP+ Network Stack for OpenAir Radios
24xxUHW.AVA Trakker Antares UDP+ Network Stack for Ethernet
24xxUDS.AVA Trakker Antares UDP+ Network Stack for 802.11 DS
24xxULS.AVA Trakker Antares UDP+ Network Stack for 802.11 DS with LEAP
24xxUSS.AVA Trakker Antares UDP+ Network Stack for 802.11 DS with TTLS
Package Title
You can download these and other packages at no charge from the
Intermec web site at www.intermec.com.
For more information about software packages and software collections,
see the Wavelink Avalanche documentation and online help.
Wavelink Avalanche Files
In addition to software collections and software packages, Avalanche
uses control files on drive C of the Trakker Antares terminal to record
information and configure the terminal. Avalanche uses these types of files:
• Package control files
• Network profiles
Note: The following files on the terminal’s C drive are used for
Wavelink Avalanche. Do not delete these files from your terminal:
• AVA-NET.DHP
• NET.CFG
• Any files with these file extensions: *.CTL, *.SCF, and *.SDH.
Trakker Antares 2400 Family System Manual 39
Page 60
Chapter 2—Configuring and Managing the Terminals
Additionally, these types of files are used by the Trakker Antares terminals:
• Reader command files
• Firmware upgrade files
Package Control Files
A package control file is automatically created for each package
downloaded to the terminal. The Avalanche Agent uses control files to
track which packages are installed on the client and version information
about the package. If you delete a .CTL file on the client and reboot, the
corresponding package is re-downloaded to the terminal.
The package control file assumes the name of the downloaded package
with .CTL as the file extension. However, there is one exception: data sent
with network profile information is represented by a special control file
named _IPCFG.CTL.
Network Profiles
A network profile is a collection of settings that lets you download certain
network parameters to the terminal. Intermec recommends that you use
network profiles to help manage your terminals. When a network profile is
enabled, the Avalanche Agent downloads a file named AVA-NET.DHP to
the terminal. The Enabler processes the file and renames it with an .SDH
file extension. If an .SDH file with the same name is already present, it is
replaced by the new .SDH file.
When you upgrade the terminal with a Trakker Antares firmware upgrade
package, all .SDH files on the terminal are renamed with the .DHP file
extension so that they can be reprocessed to restore the configuration.
Reader Command Files
Reader command files are text-based files (.RCD) that can contain any
Trakker Antares reader or configuration command.
A reader command file can be included in any package and is processed
after the package is downloaded to the terminal. When the terminal
processes reader command files, it scans for and processes all .RCD files.
Reader command files have an .RCD file extension. After the reader
command file is processed, it is renamed with an .SCF file extension. If an
.SCF file with the same name is already present, it is replaced by the new
.SCF file.
When you upgrade the terminal with a Trakker Antares firmware upgrade
package, all .SCF files on the terminal are renamed with the .RCD file
extension so that they can be reprocessed to restore the configuration.
40 Trakker Antares 2400 Family System Manual
Page 61
Chapter 2—Configuring and Managing the Terminals
When creating .RCD files, note that:
• almost any Trakker Antares command can be included in an .RCD file.
Note: The Command Processing configuration command lets you
disable or enable multiple commands. Do not send the Disable All Reader Commands command to the terminal in an .RCD file.
• commands that cause the terminal to reboot are processed last (after all
file processing is complete).
• any line that starts with a pound sign (#) or semicolon (;) is treated as a
comment line.
• blank lines are allowed and are not processed.
• you need to include an .RCD filed named app_name.RCD for your
applications. This .RCD file includes a single line of code:
//program.bin
that causes your application to run.
Upgrade Files
The Trakker Antares firmware upgrade package includes special files used
to upgrade firmware. The Enabler uses C:SYS_BLK.BIN and
C:BLOCK3.BIN to reprogram flash blocks in firmware.
The Trakker Antares protocol upgrade packages include
C:_LST_FLE.TXT. The Enabler uses C:_LST_FLE.TXT to update
the list of applications loaded on the terminal.
Configuration changes that are made manually are lost when the terminal
is upgraded.
Synchronization Properties and Selection Criteria
The Avalanche Agent uses specific parameters to synchronize with the
Enabler on your Trakker Antares terminal. These parameters can also be
used as selection criteria to determine which devices to send updates and
downloads to.
Synchronization Properties
Property Description and Values
IP Current IP address
Series I (for Intermec)
ModelName ITCxxxx
where xxxx is the model of the Trakker Antares terminal, such
as 2415.
ModelCode Last two digits of the terminal model number. For example,
15 indicates the 2415.
Rows Number of rows displayed while Avalanche is running
Trakker Antares 2400 Family System Manual 41
Page 62
Chapter 2—Configuring and Managing the Terminals
Synchronization Properties (continued)
Property Description and Values
Columns Number of columns displayed while Avalanche is running
KeyboardName Keypad Type configuration command name that identifies the
keypad overlay
KeyboardCode Keypad Type configuration command binary value that
identifies the keypad overlay
The Avalanche Enabler on the Trakker Antares terminals defines
additional properties that can be used as selection criteria. These properties
appear in the Avalanche Console only after you synchronize with the
Enabler on your Trakker Antares terminal.
Trakker Antares Enabler Properties
Property Description and Values
PROTOCOL
NIC
FirmwareVersion 6-digit firmware version number. For example, firmware
UDP UDP Plus protocol
TCP TCP/IP protocol
1 OpenAir
2 802.11DS
3 Ethernet
4 802.11DS with TTLS
5 802.11DS with LEAP
version 8.01 is represented as 080100.
Learning About Intermec Settings (ICCU)
Intermec Settings (ICCU ) is a proprietary Intermec application that
allows you to easily configure multiple Trakker Antares terminals.
Intermec Settings is available as part of a Wavelink Avalanche package
(24XXRCD). You can download the Intermec Settings package at no
charge from the Intermec web site at www.intermec.com.
To configure your terminals using Intermec Settings
1 From the tree view in the Avalanche Console, expand localhost >
Software Collections > Antares Configuration.
2 Right-click the 24XXRCD package, and select Configure Package >
Configure Firmware. The Intermec Settings application starts.
3 Use Intermec Settings to select your configuration parameters.
4 From the File menu, select Save Settings. Your configuration settings
are now saved to the 24XXRCD configuration package.
5 Close the Intermec Settings window.
42 Trakker Antares 2400 Family System Manual
Page 63
Chapter 2—Configuring and Managing the Terminals
6 Download the package to the terminals you want to configure.
For more information, see the online help that ships with Intermec
Settings.
Trakker Antares 2400 Family System Manual 43
Page 64
Chapter 2—Configuring and Managing the Terminals
44 Trakker Antares 2400 Family System Manual
Page 65
Developing and Using
3
This chapter explains how to create, download, and run applications on
the programmable terminals and covers these topics:
• About the Trakker Antares programmable terminals
• Creating applications for the terminal
• How to download applications
Applications
• Using the serial port to transfer applications and files
• Using the DCS 300 to download applications and files
• Running applications on the terminal
Trakker Antares 2400 Family System Manual 45
Page 66
Chapter 3—Developing and Using Applications
About the Trakker Antares Programmable Terminals
The Trakker Antares® terminals ship loaded with a terminal emulation
application or a sample application. If you ordered the DOS option, the
terminal also ships with the necessary DOS files you need to run DOS
applications.
You can also develop your own data collection applications for the
terminal and download the applications to the terminal. After you
download an application to the terminal, you are ready to run the
application and use it. This chapter describes how to:
• develop applications for the terminals. For help, see “Creating
Applications for the Terminal” on page 48.
• download applications and files to the programmable terminals. For
help, see “How to Download Applications” on page 53.
• run applications on the terminals. For help, see “Running Applications
on the Terminal” on page 65.
Note: This chapter describes how to create, download, and run DOS
applications. To use DOS on the Trakker Antares terminal, you must
order the DOS option. For help, contact your local Intermec
representative.
The next table lists specifications and technical information you need to
know to develop applications for the Trakker Antares terminals.
RS-232/422/485 serial
communications from the
PC or host computer
communications from the
DCS 300 to the terminal’s
flash drive
communications and TFTP
from a host application to
the terminal’s flash drive
241X, 242X (also through the modem), 243X,
2455, 2475 through RS-232 only
2460, 248X (with the enhanced input/output board option)
through RS-232/422/485
2415, 2425, 2435, 2455, 2475, 2485/6 through RF
2461, 2480/1 (with the optional Ethernet card) through
Ethernet
2415, 2425, 2435, 2455, 2475, 2485/6 through RF
2461, 2480/1 (with the optional Ethernet card) through
Ethernet
Creating Applications for the Terminal
The Trakker Antares terminals run applications programmed in Microsoft
C. You can use the Trakker Antares Programmer’s Software Kit (PSK) or
EZBuilder and Microsoft C/C++ functions to create two types of
applications for the terminal:
• DOS applications (.EXE executable format) (only available with the
DOS option)
You can download the latest versions of the PSK and EZBuilder from the
Intermec web site at www.intermec.com.
DOS applications and native Trakker Antares applications are mutually
exclusive. You can either run a DOS .EXE application or a native Trakker
Antares .BIN application. For help running DOS .EXE applications, see
“Using DOS on the Terminal” on page 313.
To use DOS applications, you must have the DOS option, and the
terminal must be running firmware version 6.12 or later. If you are using
an earlier version of firmware, you must upgrade the firmware. For help,
contact you local Intermec service representative.
To create applications
1 Use the PSK or EZBuilder to develop your application.
Convert a JANUS® application or IRL program to use on the terminal.
2 (.BIN applications) Convert the application to a binary file.
Each step is described in the next sections.
48 Trakker Antares 2400 Family System Manual
Page 69
Chapter 3—Developing and Using Applications
Note: You build your applications differently for terminals running .BIN
applications and terminals running DOS .EXE applications. For help, see
the Trakker Antares Application Development Tools System Manual (P/N
064433).
Using the PSK or EZBuilder to Develop Applications
Intermec has two development tools, the Trakker Antares PSK and
EZBuilder, which you can use to create applications for the terminals.
Developing Applications Using the PSK
You can download the latest version of the PSK at no charge from the
Intermec web site at www.intermec.com. This kit has a full set of
programming tools to help you create applications for the terminal:
• Programmer’s Software Kit (PSK)
• Application Simulator
• FileCopy utility
• Sample programs and Make files
In addition to the PSK, you also need an Intermec-certified 16-bit C/C++
compiler, such as Microsoft Visual C/C++. For help, see your Intermec sales
representative.
Note: You must use the Trakker Antares PSK version 4.2 or later to create
DOS applications. To support DOS .EXE applications, some PSK library
functions were moved from the IM24LIB library to the LLIBCA library.
The IM24LIB library contains Intermec-specific functions.
The PSK is a library of C functions that control the Trakker Antares
programmable terminals. You can program the terminal to display
prompts and error messages, to collect and display data, and to transmit
data to an upline Intermec Gateway, DCS 30X, or host computer. The
PSK functions work with most standard Microsoft C functions. You can
create complex applications that collect, store, manipulate, and transmit
data to meet your system needs.
The Application Simulator is a terminate-and-stay resident (TSR) program
that lets you debug and run Trakker Antares applications on a DOS or
Windows PC. The Simulator captures the PSK and C functions and
makes the PC mimic a Trakker Antares terminal.
Developing Applications Using EZBuilder
EZBuilder (P/N 066381) is a software code generator product that
provides programmers and technically oriented non-programmers with a
quick and easy way to create applications for the Trakker Antares terminal.
Trakker Antares 2400 Family System Manual 49
Page 70
Chapter 3—Developing and Using Applications
EZBuilder contains these items:
• EZBuilder software
• Intermec certified 16-bit C/C++ compiler
• Application Simulator
• PSK libraries
• FileCopy utility
• Sample EZBuilder programs
• EZBuilder Getting Started Guide (P/N 066450)
• EZBuilder Tutorial (P/N 066449)
Using EZBuilder, you enter simple commands to create menus, screens,
and transactions and to define menu items, labels, and data fields. You can
also set attributes, define function keys, and specify other processing, such
as calculations, for the application. After you define the application,
EZBuilder generates the program code for the application. The
Application Simulator mimics a Trakker Antares terminal and lets you test
the application on your computer.
Converting JANUS Applications and IRL Programs
You can modify a JANUS application or an IRL program to run on your
Trakker Antares terminal.
Converting Applications Between JANUS and Trakker Antares
You can develop applications that run on both the JANUS devices and the
Trakker Antares terminals. However, there are some differences that you
need to plan for in your applications. The Trakker Antares is an intelligent
terminal. A JANUS device is a DOS-compatible computer. Because of
these differences, there are some features and functions that are different
between the JANUS PSK and the Trakker Antares PSK.
In general, a C/C++ application written for Trakker Antares terminals
requires minor changes to run on a JANUS device. However, an
application written for a JANUS device may require more changes to work
properly on a Trakker Antares terminal. JANUS applications developed
with the JANUS PSK and compiler libraries are relatively easy to convert
to an application for the Trakker Antares terminals.
There are several methods you can use to convert applications to and from
JANUS devices and Trakker Antares terminals. For help with converting
applications, see the Trakker Antares Application Development Tools System Manual.
50 Trakker Antares 2400 Family System Manual
Page 71
Chapter 3—Developing and Using Applications
Converting IRL Programs Between the 95XX and Trakker Antares
The Trakker Antares terminals and the 95XX terminals run different types
of applications. The Trakker Antares terminals can run Microsoft C/C++
applications while the 95XX terminals run IRL (Intermec Reader
Language) programs.
The Trakker Antares terminals support IRL by using IRL to C conversion
programs. You can convert IRL programs to Microsoft C/C++ applications
that use the Trakker Antares PSK functions. For information about
converting IRL programs, contact your local Intermec service
representative.
You can also convert your IRL program by developing a new C/C++
application using the Trakker Antares Programmer’s Software Kit or
EZBuilder and Microsoft C/C++ functions.
If you are using a 2460 or a 248X with the enhanced input/output board
option in a CrossBar network, the application needs to send and receive
data through COM2. After your application is converted, you can
download the application to the terminal and begin using it in your
network.
Converting the Application to a Binary File
If you ordered the DOS option, you can download the executable (.EXE)
file to your terminal and run the DOS .EXE application. However, if you
want to run a native Trakker Antares application, you must store it as a
binary file (.BIN). You can convert a native Trakker Antares application
from an .EXE file to a .BIN file using one of the following methods:
• If you use EZBuilder to create the application, specify a file format
(.EXE or .BIN) in the Build Options dialog box before you build the
application.
• Use the FileCopy utility to convert the .EXE file to a .BIN file when
you download the file. For help, see “Using the Serial Port to Transfer
Applications and Files” on page 55.
• Use the EXE2ABS.EXE program that comes with the Trakker Antares
PSK or EZBuilder to convert the file.
This section explains how to use the EXE2ABS.EXE program to convert
an executable file (.EXE) to an executable binary file (.BIN).
To convert an executable file to a binary file using EXE2ABS.EXE
1 Use the Trakker Antares PSK or EZBuilder to develop the application.
2 Convert the application from an executable file to a binary file by typing
this command on your development PC:
drive:\intermec\im24\lib\exe2abs filename.exe
Trakker Antares 2400 Family System Manual 51
Page 72
Chapter 3—Developing and Using Applications
The conversion application (EXE2ABS.EXE) creates an executable
binary file named filename.BIN.
For example, if your application is named SHIPPING.EXE and the
Intermec directory is on drive C, type this command on your PC:
c:\intermec\im24\lib\exe2abs shipping.exe
The conversion application creates the SHIPPING.BIN file.
3 If you plan to download applications and files from the DCS 300 or
host through the RF network or the Ethernet network, copy all the
binary application files and any data files to a 3.5-inch disk. Continue
with the instructions for “Using the DCS 300 to Download
Applications and Files” on page 60.
Creating a Custom Logo
You can create a custom logo that appears on the terminal screen each time
the terminal boots.
VERSION 7.XX
COPYRIGHT 1996-2002
Custom logo
replaces this graphic
Creating a custom logo: This custom logo replaces the “initializing” graphic on the
Trakker Antares splash screen.
24XXS004.eps
To create a custom logo
1 On your PC, create a custom logo in bitmap format. The bitmap
should be 128 x 20 pixels in size.
2 Save the custom logo as USERINIT.BMP.
3 Download USERINIT.BMP from your PC to the terminal flash drive
C using the serial port, DCS 300, or a host application. For help, see
the next section, “How to Download Applications.”
52 Trakker Antares 2400 Family System Manual
Page 73
How to Download Applications
You can download applications and files to the programmable terminals by
using any of the following methods:
• Serial port
• DCS 300
• Host application
These methods are described in the next procedures.
You can also use reader commands to transfer files. For help, see
“Transmit File” on page 116 and “Receive File” on page 105. To learn
how to run applications on the terminal, see “Running Applications on the
Terminal” on page 65.
Use a serial port to download applications and files to the terminal
1 Create your applications using the Trakker Antares Programmer’s
Software Kit (PSK) or EZBuilder. For help, see “Creating Applications
for the Terminal” on page 48.
Chapter 3—Developing and Using Applications
2 (.BIN applications) Convert each application to a binary file.
• Use the PSK utility EXE2ABS.EXE. For help, see “Converting the
Application to a Binary File” on page 51.
• Use FileCopy or EZBuilder.
3 Connect the terminal’s serial port to the host computer or PC. For help,
see your terminal user’s manual.
4 Use the FileCopy utility, VIEW246X.EXE, or LOADER.EXE on the
host computer or PC to download applications and files to the terminal.
For help, see “Using the Serial Port to Transfer Applications and Files”
on page 55.
5 (.BIN applications) Use the TRAKKER Antares 2400 Menu System to
load and run an application. For help, see “Running Applications on the
Terminal” on page 65.
6 (DOS .EXE applications) If you ordered the DOS option, start DOS
on the terminal and run a DOS application. For help, see “Using DOS
on the Terminal” on page 313.
Trakker Antares 2400 Family System Manual 53
Page 74
Chapter 3—Developing and Using Applications
Use the DCS 300 to download applications and files to the terminal
1 Create your applications using the Trakker Antares PSK or EZBuilder.
For help, see “Creating Applications for the Terminal” on page 48.
2 (.BIN applications) Convert each application to a binary file.
• Use the PSK utility EXE2ABS.EXE. For help, see “Converting the
Application to a Binary File” on page 51.
• Use FileCopy or EZBuilder.
3 Copy the applications and files to the DCS 300. For help, see “Copying
Applications and Files to the DCS 300” on page 61.
4 Use the Download Server feature on the DCS 300 to download
applications and files to the terminal. For help, see “Downloading
Applications and Files to the Terminal” on page 62.
5 (.BIN applications) Use the TRAKKER Antares 2400 Menu System to
load and run an application. For help, see “Running Applications on the
Terminal” on page 65.
6 (DOS .EXE applications) If you ordered the DOS option, start DOS
on the terminal and run a DOS application. For help, see “Using DOS
on the Terminal” on page 313.
Use a host application to download applications and files to the terminal
1 Create your applications using the Trakker Antares PSK or EZBuilder.
For help, see “Creating Applications for the Terminal” on page 48.
2 (.BIN applications) Convert each application to a binary file.
• Use the PSK utility EXE2ABS.EXE. For help, see “Converting the
Application to a Binary File” on page 51.
• Use FileCopy or EZBuilder.
3 Copy the applications and files to the host.
4 Write a host application that can communicate with the terminal
directly through an access point or through the Ethernet network. Use
the host application to download applications and files to the terminal.
For help, see “Transferring Files and Data in a TCP/IP Direct Connect
Network” on page 24.
5 (.BIN applications) Use the TRAKKER Antares 2400 Menu System to
load and run an application. For help, see “Running Applications on the
Terminal” on page 65.
Use the host application to send the Run Program command.
6 (DOS .EXE applications) If you ordered the DOS option, start DOS
on the terminal and run a DOS application. For help, see “Using DOS
on the Terminal” on page 313.
54 Trakker Antares 2400 Family System Manual
Page 75
Chapter 3—Developing and Using Applications
Using the Serial Port to Transfer Applications and Files
You can download or upload applications and files between a PC or host
computer and the terminal using serial communications. For help
connecting the terminal, see your terminal user’s manual. Once the
terminal is connected, you can transfer files to or from the terminal using
one of the following methods:
• Use the FileCopy utility that ships with the Trakker Antares
Programmer’s Software Kit (PSK) and EZBuilder to copy files to and
from the terminal. This utility is also available at no charge from the
Intermec web site at www.intermec.com.
• Use the VIEW246X.EXE program that comes with the firmware
upgrade software to copy files to and from the terminal. You also need
the FLASHLDR.BIN file that comes with the firmware upgrade
software.
• Use the LOADER.EXE program that comes with the firmware upgrade
software to copy files to the terminal.
• Use the EZBuilder “download” tool. For help, see the EZBuilder online
help.
• Use the Receive File or Transmit File reader commands. For help, see
“Transmit File” on page 116 and “Receive File” on page 105.
• (2460 terminal or 248X terminal with enhanced input/output board
option only) Use the following reader commands to download an
application through the 9154 or 9161 controller to a 2460 or 248X in a
CrossBar network:
• Receive and Convert 7-Bit ASCII Files to 8-Bit Binary Files. For
help, see “Receive and Convert 7-Bit ASCII Files to 8-Bit Binary
Files” on page 107.
• Transmit and Convert 8-Bit Binary Files to 7-Bit ASCII Files. For
help, see “Transmit and Convert 8-Bit Binary Files to 7-Bit ASCII
Files” on page 118.
This section explains:
• how to use the FileCopy utility to download or upload applications and
files to or from the terminal.
• how to use the VIEW246X.EXE program to download or upload
applications and files to or from the terminal.
• how to use the LOADER.EXE program to download applications to the
terminal.
You can use the FileCopy utility and LOADER.EXE to download either
.EXE or .BIN application files. However, to run a native Trakker Antares
application on the terminal, it must be stored as an executable binary file
(.BIN).
Trakker Antares 2400 Family System Manual 55
Page 76
Chapter 3—Developing and Using Applications
If you are using the FileCopy utility, you can automatically convert any
.EXE file to a binary file (.BIN) before downloading the file. If you are
using LOADER.EXE, you need to use EXE2ABS.EXE to convert the
.EXE file to a .BIN file. For help, see “Converting the Application to a
Binary File” on page 51.
To transfer applications and files to or from the terminal using the FileCopy utility
1 Connect the Trakker Antares terminal to your host computer or PC.
2 Run FileCopy on your host computer or PC. The Trakker Antares
FileCopy Utility dialog box appears.
FileCopy includes detailed online help. You can click the Help button or
press F1 to get more information.
3 Check the serial port and serial communications parameters to verify
that the settings for your PC match the values that are set for the
terminal’s serial port.
a Select the COM Port Setup tab to select and configure the following
parameters:
• PC COM port
• Trakker Antares COM port
• Communications protocol
• File Transfer protocol
• Baud rate, parity, data bits, and stop bits
b Select the Serial Setup tab to verify and configure the PC’s serial
communications parameters.
c Use the TRAKKER Antares 2400 Menu System to configure the
serial port parameters on the terminal. For help, see the configuration
chapter in your terminal user’s manual.
56 Trakker Antares 2400 Family System Manual
Page 77
Chapter 3—Developing and Using Applications
4 Make sure the terminal is running an application that will not be
updated during the file transfer. If you are in the TRAKKER Antares
2400 Menu System, exit the menu system.
You can run the APPTSK.BIN application while transferring files. For
help, see “Running Applications on the Terminal” on page 65.
5 Select the FileCopy tab to download or upload applications and files.
a In the PC filename and path field, type the path and filename
(filename.EXE or filename.BIN) for the file on your PC.
To select a previously used filename from a list, click the down arrow.
To view the files on your PC, click the Browse button.
b In the Terminal filename and path field, type the drive and
filename on the terminal.
To select a previously used filename from a list, click the down arrow.
Applications must be stored on drive C. Depending on your terminal
options and configuration, you can download other files to drive C,
D, E, or G (if available).
Note: If you are downloading a DOS application that uses terminateand-stay resident (TSR) programs, you also need to download and
install the TSR files on the terminal. If your application uses a TSR on
drive C, transfer the TSR to drive C along with the application. If your
application uses a TSR on drive A, you need to recreate drive A to
include the TSR. For help, see “Customizing Drive A” on page 322.
6 If you are downloading a .BIN file and want to run the application on
the terminal immediately after it is downloaded, select the Run program
check box.
If you are downloading an .EXE file and want to convert it to a .BIN so
you can run it on the terminal immediately after it is downloaded, select
the Run program check box and select the Convert .EXE check box.
Trakker Antares 2400 Family System Manual 57
Page 78
Chapter 3—Developing and Using Applications
7 Click Download to copy the file from the PC to the terminal. If you
selected the Run program check box, the terminal boots, resets, and
runs the application you downloaded. Otherwise, the current
application continues to run on the terminal.
Click Upload to copy the file from the terminal to the PC.
8 To download or upload another file, repeat Step 5 through Step 7.
9 Click Exit to close the FileCopy utility.
You are ready to run the application from the terminal. For help, see
“Running Applications on the Terminal” on page 65.
To transfer applications and files to and from the terminal using VIEW246X.EXE
1 Connect the terminal to your PC running Windows 95/98. For help
connecting the terminal, see your terminal user’s manual.
2 On the terminal, access the Loader Waiting screen.
a Press ) ; 2 4 8 or scan this bar code label:
TRAKKER Antares 2400 Menu System
*..-.*
*..-.*
The Main Menu appears.
b From the Main Menu, choose System Menu > Upgrade Firmware >
OK.
c Choose Yes to continue. The terminal reboots and displays the
Loader Waiting screen.
Note: If you reach the Loader Waiting screen and cannot continue,
press • once or œ twice to exit. The Boot Menu appears. Press 2
or L to access the Loader Waiting screen.
3 On your PC, access an MS-DOS window.
4 Change to the directory that contains the VIEW246X.EXE application
and the FLASHLDR.BIN file.
5 Type VIEW246X and press Enter to run the application.
6 Use these available commands to copy files to or from the terminal:
Command Description
dir <drive> { > filename }
Displays the contents of a drive on
the terminal and creates a .txt file with
this information, where <drive>
is the name of the drive and { > filename } is the name of the .TXT
file.
58 Trakker Antares 2400 Family System Manual
Page 79
Chapter 3—Developing and Using Applications
Commands (continued)
Command Description
del term_filename
cls
copyfromterm <cf>
term_filename, pc_filename
copytoterm <ct>
pc_filename, term_filename
Deletes a file from the terminal, where
term_filename is the name of the
file.
Clears the screen.
Copies a file from the terminal to the
PC where term_filename is the
name of the file on the terminal and
pc_filename is the name that the
file will be given on the PC.
Example: Type cf
c:\basedate.txt
d:\date.txt to copy
basedate.txt from the C drive on
the terminal to the D drive on the PC
and rename the file date.txt.
Copies a file from the PC to the terminal
where pc_filename is the name of
the file on the PC and
term_filename is the name that the
file will be given on the terminal.
Example: Type ct
d:\basedate.txt
c:\basedate.txt to copy the file
basedate.txt from the D drive on
the PC to the C drive on the terminal.
help
quit or exit
Displays the help screen.
Closes the VIEW246X.EXE application.
To transfer applications and files to the terminal using LOADER.EXE
Note: Before you can transfer applications and files, you must open the
MS-DOS window and open the MS-DOS Prompt Properties dialog box.
In the Memory tab, set the Initial Environment field to 4096. Close the
MS-DOS window and re-open it.
1 Connect the terminal to your PC. For help connecting the terminal, see
your terminal user’s manual.
2 On your PC, load the application or file that you want to download.
3 Access the MS-DOS window.
4 Change to the directory that contains the LOADER.EXE program.
Trakker Antares 2400 Family System Manual 59
Page 80
Chapter 3—Developing and Using Applications
5 On the terminal, access the Loader Waiting screen.
a Press ) ; 2 4 8 or scan this bar code label:
TRAKKER Antares 2400 Menu System
*..-.*
*..-.*
The Main Menu appears.
b From the Main Menu, choose System Menu > Upgrade Firmware >
OK.
c Choose Yes to continue. The terminal reboots and displays the
Loader Waiting screen.
6 On your PC, type:
LOADER pathname\filename
where:
pathnameis the path to the application or file that you want to
download.
filenameis the name of the application or file that you want to
download.
The Loader screen appears and the file or application is transferred to
the terminal.
Using the DCS 300 to Download Applications and Files
You can download applications and files to an RF or Ethernet terminal
using network communications. The advantage to downloading files
through RF or Ethernet network communications is that you can
download multiple files to one or more terminals.
You use RF or Ethernet communications to download applications from
the DCS 300 to RF or Ethernet terminals running UDP Plus or WTP or
from the host to RF or Ethernet terminals running TCP/IP. This section
explains how to use the DCS 300 to download applications and files. For
help downloading files in a TCP/IP network, see “Transferring Files and
Data in a TCP/IP Direct Connect Network” on page 24.
To download applications and files from the DCS 300
1 Copy the applications and files to the DCS 300. For help see the next
section, “Copying Applications and Files to the DCS 300.”
2 Use the Download Server feature on the DCS 300 to download the
applications and files to the RF or Ethernet terminal. For help, see
“Downloading Applications and Files to the Terminal” on page 62.
60 Trakker Antares 2400 Family System Manual
Page 81
Or, use the Receive File or Transmit File reader commands to download
the applications and files to the RF or Ethernet terminal. For help, see
“Transmit File” on page 116 and “Receive File” on page 105.
Each step is described in the next sections. Before you start, make sure that
the RF or Ethernet terminal is communicating with the DCS 300. For
help installing or configuring the network, see the networking chapter in
your terminal user’s manual.
Copying Applications and Files to the DCS 300
1 Copy the applications and files to a 3.5-inch disk.
2 Insert the disk into the disk drive of the DCS 300.
3 From the main menu sidebar buttons, choose File Handling. The File
Handling dialog box appears.
4 In the File Handling list box, select Restore User Files and choose OK.
A message box appears telling you to insert the disk in the disk drive of
the DCS 300.
Chapter 3—Developing and Using Applications
5 Choose OK. The Restore User Files dialog box appears. The files on the
disk appear in the Available Files list box.
6 In the Available Files list box, add all the files that you want to restore
to the Selected Files list box.
Trakker Antares 2400 Family System Manual 61
Page 82
Chapter 3—Developing and Using Applications
a Select the file name.
b Choose Select. The file name appears in the Selected Files list box.
If the Selected Files list box displays any files that you do not want to
restore, select the file name and choose Remove.
7 Choose Restore Files. The DCS 300 restores the files you selected to
the D:\USERDATA directory.
8 Remove your disk from the disk drive.
Downloading Applications and Files to the Terminal
Once the applications and files are stored on the DCS 300, you can use
the Download Server feature on the DCS 300 to download applications
and files to one or more RF or Ethernet terminals.
To prepare the terminal
1 (2415, 2425, or 2435 only) Make sure the main battery pack is fully
charged.
2 Make sure the terminal is on and communicating with the DCS 300.
To download applications and files to the terminal
1 If data collection is not started on the DCS 300, choose Start Data
Collection from the main menu sidebar buttons.
2 From the main menu sidebar buttons, choose System Maintenance.
The System Maintenance dialog box appears.
3 Select Configure Download Server and choose Start. The Terminal
Download Configuration dialog box appears.
62 Trakker Antares 2400 Family System Manual
Page 83
Chapter 3—Developing and Using Applications
4 In the Terminals and Groups list box, select a terminal or group of
terminals to receive the binary applications and files.
5 Choose Edit. The Configure Device Initialization Download dialog box
appears.
6 Verify that there are no files (or entries) listed in the Files and Data list
box. If there are entries, select the entries and choose Clear to remove
them.
7 In the Initialization Data box, choose File.
8 In the field, type:
\filename
where filename is the name of the executable binary application.
Choose Find, select your application, and choose OK.
9 Select the Binary file check box.
10 Select the Overwrite option button to overwrite an existing file with the
same name.
11 In the Target file name field, type a name if you want to save the file
under a different name on the terminal.
Do NOT enter a slash or backslash character before the target filename.
12 Choose Add. The file appears in the Files and Data list box with a B
for binary in the leftmost column.
Trakker Antares 2400 Family System Manual 63
Page 84
Chapter 3—Developing and Using Applications
13 Repeat Steps 7 through 12 to select another application.
14 You can also download files used by your application such as an
employee list or a part number list.
To download additional files, choose File in the Initialization Data
box. Type the filename including the backslash. Disable the Binary file
check box and choose Add.
15 Choose OK to save your changes and return to the Terminal Download
Configuration dialog box.
16 In the Terminals and Groups list box, choose the terminal or group
you configured if it is not already highlighted and marked with an
asterisk.
17 Choose Download. A Download initiated message box appears.
18 Choose OK. The executable binary applications and files are
downloaded to the terminal or group of terminals. If you are
downloading the applications and files to many terminals or if there is a
lot of traffic in your RF or Ethernet network, the download may take
longer. All files are downloaded and stored on the terminal’s flash drive
C.
Note: If you use terminate-and-stay resident (TSR) programs in your
DOS application, you also need to download and install the TSR files
on the terminal. If your application uses a TSR on drive C, transfer the
TSR to drive C along with the application. If your application uses a
TSR on drive A, you need to recreate drive A to include the TSR. For
help, see “Customizing Drive A” on page 322.
64 Trakker Antares 2400 Family System Manual
Page 85
Chapter 3—Developing and Using Applications
19 Click Close to close the dialog box and return to the System
Maintenance dialog box.
After you download an application to the terminal, you can run the
application. For help, see the next section, “Running Applications on the
Terminal.”
Running Applications on the Terminal
After you download an application to the terminal, you are ready to run
the application and use it. Depending on the type of application you want
to run, you can use one or more of these methods:
• Use the FileCopy utility. For help, see “Using the Serial Port to Transfer
Applications and Files” on page 55.
• Use the Run Program reader command. For help, see “Run Program” in
on page 112.
• (DOS option only) Use DOS to run DOS applications. For help, see
“Using DOS on the Terminal” on page 313.
• Use the TRAKKER Antares 2400 Menu System. For help, continue
with the next procedure.
Note: You must use DOS to run DOS applications; however, once you
have started DOS, you can switch between DOS and the TRAKKER
Antares 2400 Menu System as needed.
To run an application on the terminal
1 Press ) ; 2 4 8 or scan this bar code label to access the
TRAKKER Antares 2400 Menu System.
TRAKKER Antares 2400 Menu System
*..-.*
*..-.*
The Main Menu appears.
2 Choose System Menu > File Manager. The File Manager screen
appears prompting you to select a drive.
Trakker Antares 2400 Family System Manual 65
Page 86
Chapter 3—Developing and Using Applications
FILE MANAGER
Select drive: C
OK
CANCEL
3 Press ; to select drive C, or press – or ª to select the letter of the
drive you want to manage, and then press ;. The File Manager
screen appears and lists all the files stored on the drive.
FILE MANAGER
C:EM9560.BIN14336
C:ROM-DOX.IMG 50255
C:DOS.BIN14336
C:DRIVEB.IMG0182K
00497201 Bytes Free
[Enter] Run App
[F7] Rename
[DEL] Delete
[F1] Help [Esc] Exit
4 Press † or ¥ to select an application and press ;. The terminal
boots, resets all firmware, and runs the application.
If you also made configuration changes while you were working in the
menu system, you will be prompted to store your changes in flash
memory. After you save or discard the changes, the terminal boots,
resets all firmware, and runs the application.
24XXS086.eps
24XXS087.eps
Note: You can press ) ¢ to rename a file or ) . to delete a file.
You can begin using the application to collect data. Repeat the instructions
in this section to run another application on the terminal.
66 Trakker Antares 2400 Family System Manual
Page 87
Running Diagnostics
4
This chapter explains how to run diagnostics on the terminal to help
analyze hardware, application, and firmware problems. This chapter covers
these topics:
• Available diagnostics
• Running diagnostics from the menu system
• Defining the diagnostics screens
• Error numbers and messages
Trakker Antares 2400 Family System Manual 67
Page 88
Chapter 4—Running Diagnostics nugget 39 AGaramond
What Diagnostics Are Available?
You can run diagnostics on the Trakker Antares® terminals to help analyze
hardware and firmware problems, fix application problems, and view
system information. You use the TRAKKER Antares 2400 Menu System
to run diagnostics. This chapter lists the diagnostics in alphabetical order.
Use the following tables to find the software, hardware, and system
diagnostics you want to run.
Note: Diagnostics are not available on 246X terminals, because 246X
terminals do not use the TRAKKER Antares 2400 Menu System.
Diagnostics Listed by Category
Hardware
Diagnostic Test Description
Battery/PIC
Status
Beeper Test Sounds a series of beeps to test the beeper by using
Display Test Tests and turns on the pixels on the screen to make
Hardware
Configuration
Keypad Test Shows the hexadecimal, decimal, and scan code
Radio Test (RF terminals only) Tests the radio to make sure it
Scanner Test Tests the laser scanner to make sure it is working. 84
Shows the power level of the backup battery.
Indicates the backup battery’s current volts,
temperature, and charging status.
Reports main board and the I/O board
temperature, and the status of the EEPROM
checksum and the master bus.
a range of beep volumes and beep frequencies.
sure all areas of the screen are working correctly.
Lists the terminal’s hardware components that were
installed at the Intermec factory, including the RF
country code.
value for any key or key combination on the
keyboard.
is working.
Page
Number
73
76
77
80
82
83
68 Trakker Antares 2400 Family System Manual
Page 89
nugget39 AGaramond Chapter 4—Running Diagnostics
Diagnostics Listed by Category (continued)
System
Diagnostic Test Description
Access Point (RF terminals only) Lists information about the
access point the RF terminal is communicating
with across the network.
Application
Efficiency
Code Verify Determines if the terminal’s firmware has been
Malloc
Application
Information
Malloc Firmware
Information
Serial Port Test Tests serial communications between the terminal
Subsystem
Versions
Software
Diagnostic Test Description
Application
Events
Displays the application efficiency percentage to
help determine the impact that the application has
on the terminal’s battery power.
overwritten.
Shows how memory is allocated and used by the
current application.
Shows how memory is allocated and used in the
terminal firmware.
and the host computer or serial device.
Lists the version of each major firmware subsystem
loaded on the terminal.
Shows the current status of each application event
to help debug applications.
Page
Number
72
72
77
82
83
85
86
Page
Number
73
Clear Task
Profiles
Error Logger Lists any errors that the firmware did not expect. 78
Font Test Lists the double-byte font, if any, that is loaded in
Keypad Table Lists the number of the keypad table that is loaded
Task Status Shows the task name, stack, the percentage of
Clears the Task Status counters so that you can
begin accumulating new task statistics for the Task
Status screen and the Application Efficiency screen.
the terminal.
in the terminal.
time each subsystem has been running, and the
stack usage.
Running Diagnostics From the Menu System
The TRAKKER Antares 2400 Menu System is a menu-driven application
that lets you configure the terminal, view system information, and run
diagnostics. You can access the TRAKKER Antares 2400 Menu System
and run diagnostics while running any application.
76
79
80
86
Trakker Antares 2400 Family System Manual 69
Page 90
Chapter 4—Running Diagnostics nugget 39 AGaramond
To run diagnostics from the TRAKKER Antares 2400 Menu System
1 Press ) ; 2 4 8 or scan this bar code:
TRAKKER Antares 2400 Menu System
*..-.*
*..-.*
The Main Menu appears.
24XXS030.eps
2 Press † to choose the Diagnostics Menu and press ;. The
Diagnostics Menu appears.
DIAGNOSTICS MENU
Software Diagnostics
Hardware Diagnostics
System Diagnostics
_` Select item
[Enter] Next screen
[F1] Help
[Esc] Exit
The Diagnostics Menu contains these diagnostics:
Diagnostic Description
Software
Diagnostics
Hardware
Diagnostics
System
Diagnostics
Lets you run software diagnostics to help analyze software
problems on the terminal. For example, you can view the Error
Logger file to view system errors.
Lets you run hardware diagnostics to help analyze hardware
problems on the terminal. For example, you can check the
power remaining and the condition of the batteries.
Lets you run system diagnostics to help analyze network,
system, or application problems on the terminal. For example,
you can run diagnostics to check the communications between
the 2455 and the access point.
24XXS040.eps
70 Trakker Antares 2400 Family System Manual
Page 91
nugget 39 AGaramond Chapter 4—Running Diagnostics
3 Press ¥ or † to choose Software Diagnostics, Hardware
Diagnostics, or System Diagnostics and press ;. One of the
diagnostics menus appears.
SOFTWARE DIAGNOSTICS
Error Logger
Application Events
Task Status
Clear Task Profiles
Font Test
Keypad Table
Note: The Radio Test and Access Point diagnostics are only available
for RF terminals. These diagnostics do not appear on terminals that do
not have radios.
4 Press ¥ or † to choose the diagnostic test you want to run and press
;. The diagnostic screen appears. Use the information on the screen
or follow the instructions to run the diagnostic test. For help, see the
next section, “Defining the Diagnostics Screens.”
5 Press d to exit each diagnostic screen and to exit the diagnostics menus.
HARDWARE DIAGNOSTICS
Hardware Config
Battery/PIC Status
Display Test
Keypad Test
Main Board Menu
Radio Test
Scanner Test
MAIN BOARD MENU
Application
Beeper
SYSTEM DIAGNOSTICS
Subsystem Versions
Access Point
App Efficiency
Serial Port Test
Malloc Info Menu
Code Verify
MALLOC INFO
Application
Firmware
24XXS041.eps
6 Choose another menu from the Main Menu or press d to exit the
TRAKKER Antares 2400 Menu System. If you have made any changes,
a screen prompts you to store the changes in flash memory. For help, see
“Exiting the Menu System” in the configuration chapter of your user’s
manual.
After you exit the menu system, the terminal will resume the application
you were running when you started the menu system.
Defining the Diagnostics Screens
This section lists the diagnostics in alphabetical order. You can find the
following information about each diagnostic test:
• Description and purpose
• Menu where the diagnostic is available
• Sample diagnostic screen
• Definition and explanation of the diagnostic screen
To find diagnostics listed by category, see “What Diagnostics Are
Available?” on page 68.
Trakker Antares 2400 Family System Manual 71
Page 92
Chapter 4—Running Diagnostics nugget 39 AGaramond
Access Point
Purpose: Use the Access Point screen to get version and address information about
the access point the terminal is communicating with across the RF
network. This diagnostic only applies to RF terminals.
Where Available: System Diagnostics menu
Sample Screen:
ACCESS POINT
Radio ROM Ver:
V1.6EB
Radio MAC Addr:
0020A6306510
Access Point Name:
SHIPPING
Access Point MAC:
0020A6301365
[Esc] Exit
24XXS045.eps
Definition: The screen displays the radio ROM firmware version and the radio MAC
(machine) address for the terminal. It also displays the access point name
and the access point MAC. If you have a problem with the radio or the
connection to the access point, use the information on this screen to
troubleshoot your network configuration.
Application Efficiency
Purpose: Use the Application Efficiency screen to determine if your application is
effectively using, and therefore maximizing, battery life on the terminal.
Where Available: System Diagnostics menu
Sample Screen:
APP EFFICIENCY
Subsystem Versions
Application is
running at 90%
80%100%
POORGOOD
Battery life is
affected by
application
efficiency.
[Esc] Exit
24XXS046.eps
Definition: The screen displays the application efficiency percentage. The closer the
percentage is to 100%, the more efficient the application is at using battery
power. When less power is required, the terminal automatically goes into
an internal Standby mode to draw power at a lower level.
72 Trakker Antares 2400 Family System Manual
Page 93
nugget39 AGaramond Chapter 4—Running Diagnostics
An efficient application uses the Trakker Antares PSK (Programmer’s
Software Kit) functions to wait for events to occur, and it does not poll in
an infinite loop. When programmed correctly with the PSK or EZBuilder,
the application uses the terminal’s battery power as efficiently as possible
and does not prevent the terminal from going into Standby mode.
Application Events
Purpose: A programmer can use the current status of each event to help debug
Definition: The terminal uses an event-driven architecture. All inputs to the terminal,
such as from the keypad or from the network, arrive in the form of an
event. You can check the status of each event using the Application Events
screen. When an event is serviced by the application, the event is cleared.
0 means the event is cleared. 1 means the event has occurred (or is set).
Battery/PIC Status
Purpose: Depending on the type of terminal you have, you can use the Battery/PIC
status screens to get information about the terminal’s main (lithium-ion)
battery pack, backup (NiCad) battery, or main board.
241X, 242X, and 243X Terminals
Note: While the battery is charging, do not use this screen to determine
when the battery is fully charged. To determine when the battery is fully
charged, use the status LEDs on the battery chargers or communications
dock.
Where Available: Hardware Diagnostics menu, Battery/PIC Status, and then choose either
Main Battery/PIC or Backup Battery/PIC.
Trakker Antares 2400 Family System Manual 73
Page 94
Chapter 4—Running Diagnostics nugget 39 AGaramond
Note: The Backup Battery/PIC option is only available for the 242X
terminal, because the 241X and 243X terminals do not have a backup
battery.
Sample Screen:
BATTERY/PIC MONITOR
Main Battery
Capacity
EF
100%
Main Battery Volts
8.200V(Ea)
Temp:25C (A4)
Main Charging: NO
PIC Rev.:8
[Esc] Exit
24XXS052.eps
Main Battery/PIC Screen Backup Battery/PIC Screen
BATTERY/PIC MONITOR
Backup Battery
Good
Backup Battery Volts
10.80V(BC)
Temp:25C(A4)
Backup Charging:NO
PIC Rev.:8
[Esc] Exit
24XXS053.eps
Definition: The Main Battery/PIC screen displays the main battery capacity, the
percentage of battery power remaining in the battery pack. You can
continue using the battery pack until the terminal indicates that the
battery is low: the Battery LED on your 241X turns on, the Battery icon
on your 242X appears on the screen, or the Battery status icon on your
243X appears on the screen.
Note: The 243X Battery status icon only appears if the status icons are
enabled. For help enabling the status icons, see “Display Video Mode” on
page 182.
The Backup Battery/PIC screen indicates the status of the backup battery
power, either GOOD or LOW. If the status is LOW, turn off the
terminal. Let the main battery pack charge the backup battery. The
backup battery fully charges in approximately 18 hours.
You can also use these screens to find out the current volts, temperature,
and charging status. For both screens, the PIC Rev field is the firmware
version that is running on the battery monitory processor.
74 Trakker Antares 2400 Family System Manual
Page 95
nugget 39 AGaramond Chapter 4—Running Diagnostics
2455, 2475, and 248X Terminals
Where Available: Hardware Diagnostics menu, Battery/PIC Status, and then choose either
Main Battery/PIC or Backup Battery/PIC.
Sample Screen:
BATTERY/PIC MONITOR
Main Board Temp:
-30C (00)
IO Board Temp:
-30C (00)
EEPROM Checksum: OK
I2C Mstr Bus: OK
PIC Rev.: 0
[Esc] Exit
24XXS050.eps
BATTERY/PIC MONITOR
Backup Battery
Good
Backup Battery Volts
10.80V(BC)
Temp:25C(A4)
Backup Charging:NO
PIC Rev.:8
[Esc] Exit
24XXS051.eps
Main Battery/PIC Screen Backup Battery/PIC Screen
Definition: The Main Battery/PIC screen does not provide information about the
main battery because 2455, 2475, and 248X terminals do not have a main
battery. Instead, this screen reports the temperature of the main board and
the I/O board, as well as the status of the EEPROM checksum and the
master bus.
The Backup Battery/PIC screen displays the status of the backup battery.
Battery Status Descriptions
Status Description
Good The backup battery is operating correctly. No action is required.
Low The backup battery needs to be charged. For help, see “Charging the Backup
Battery” in Chapter 1 of the 2455, 2475, or 248X user’s manual.
Bad The backup battery may be disconnected or not operating correctly. If you
have a 2455, you can check if the backup battery is connected or replace it.
For help, follow the instructions in “Replacing the Backup Battery” in
Chapter 4 of the 2455 user’s manual. If you have a 2475 or 248X, contact
your local Intermec service representative.
Note: The NiCad backup battery in the 2475 and 248X is not userserviceable. You must return the Trakker Antares 2475 or 248X terminal
to Intermec to replace the backup battery.
Trakker Antares 2400 Family System Manual 75
Page 96
Chapter 4—Running Diagnostics nugget 39 AGaramond
The Backup Battery/PIC screen also shows the current volts, temperature,
and charging status. The number in parentheses after the volts and
temperature is the hexadecimal value returned from the processor. On
both screens, the PIC Rev field is the firmware version that is running on
the battery monitory processor.
Beeper Test
Purpose: You can test the terminal beeper to make sure the entire beep volume
range and beep frequency range are available and working correctly. The
Beeper Test can also help you distinguish the different beep volumes to
choose a level that you can hear in your working environment.
Where Available: Choose the Main Board Menu from the Hardware Diagnostics menu.
Sample Screen:
BEEPER TEST
SELECT BEEP TEST:
(Hold down any key
to stop test)
1-Frequency Test
2-Volume Test
3-Club 39 Jam
4-K. 622
[Esc] Exit
24XXS056.eps
Definition: Press 1 to test the beep frequency range. The terminal will sound a series
of beeps starting from a low frequency beep through the range to a high
frequency beep, and then back to a low frequency beep.
Press 2 to test the beep volume. The terminal sounds a series of beeps
from a quiet beep to a very loud beep.
Tests 3 and 4 also test the beep volume and frequency by playing a short
tune. If you do not hear any beeps during any of these tests, you may have
a problem with the beeper or internal speakers. For help, contact your
local Intermec service representative.
Clear Task Profiles
Purpose: Clears the task profile counters so that you can begin accumulating
statistics on the firmware subsystem tasks from a known point in time.
Where Available: Software Diagnostics menu
76 Trakker Antares 2400 Family System Manual
Page 97
nugget 39 AGaramond Chapter 4—Running Diagnostics
Sample Screen:
CLEAR TASK PROFILES
Hardware Config
Operating system
task profiles
counters have been
cleared.
[Esc] Exit
24XXS058.eps
Definition: When you select the Clear Task Profiles option, the terminal clears the
%Time field on the Task Status screen. It also resets all counters that are
used to calculate the Application Efficiency screen.
Code Verify
Purpose: A programmer or application developer can use this diagnostic to
determine if the terminal’s firmware has been overwritten.
Where Available: System Diagnostics menu
Sample Screen:
CODE VERIFY TEST
Passed
[Esc] Exit
CODE VERIFY TEST
FAILED
beeperDB400
cspD4100
scannerCE200
[Esc] Exit
24XXS059.eps
Definition: If this diagnostic passes, “Passed” appears on the screen. If this diagnostic
fails, then the name of the firmware driver that failed and its address
appears on the screen.
Display Test
Purpose: Use the Display Test to make sure that every pixel on the terminal screen
is working correctly. For example, you may want to test the screen if you
do not see complete characters on the screen.
Where Available: Hardware Diagnostics menu
Trakker Antares 2400 Family System Manual 77
Page 98
Chapter 4—Running Diagnostics nugget 39 AGaramond
Sample Screen:
DISPLAY TEST
[Enter] Next pattern
[Esc] Exit
24XXS062.eps
Definition: Press ; to display each of the four patterns. After 5 seconds, the entire
screen is filled with the current test pattern. Press ; to display the next
pattern. The first two patterns appear as a shaded pattern and turn off
every other pixel. The third pattern turns on every pixel and appears as a
black square. The fourth pattern turns off every pixel and appears as a clear
square.
If any of these patterns are not displayed correctly, you may have a
problem with the LCD. For help, contact your local Intermec service
representative.
Error Logger
Purpose: If you suspect that your terminal has a problem, you can use the Error
Logger to help diagnose the problem.
The terminal posts an entry to the Error Logger whenever it detects an
unexpected condition. Each entry does not necessarily indicate a problem.
For example, if an application is not waiting for keyboard input and you
press enough keys to fill the keyboard queue, the terminal will post a
queue full error to the Error Logger. For a list of possible errors, see “Error
Numbers and Messages” on page 87.
Note: The Error Logger is not intended to be an application debugging
tool.
Definition: The Error Logger screen shows the last 30 errors in three columns:
• The first column displays the time in HHMMSS format.
• The second column displays the error number. To learn which error
message is associated with the error number, see “Error Numbers and
Messages” on page 87.
• The third column displays the internal firmware address, which helps
identify why the error occurred.
Press ; to see the next screen of errors.
Font Test
Purpose: You can use this diagnostic to identify which double-byte font, if any, you
have loaded on your terminal.
Where Available: Software Diagnostics menu
Sample Screen:
[Esc] Exit
FONT TEST
DB Font 13
[Esc] Exit
Definition: If you ordered the optional 4MB flash memory for your terminal, you can
use the Trakker Antares Font Loader to download a double-byte font set
to the terminal. See your local Intermec sales representative for
information about ordering double-byte fonts.
FONT TEST
No Double Byte
Font Loaded
24XXS064.eps
Use this table to match the font number with the double-byte font that is
loaded on your terminal.
Purpose: If you are discussing a problem with Intermec, you can use the Hardware
Configuration screen to tell the Intermec representative the exact version
of hardware that was installed on the terminal at the Intermec factory.
Where Available: Hardware Diagnostics menu
Sample Screen:
HARDWARE CONFIG
Country Code:
USA(80,01)
Display Type:0
Display Rev.:0
Display Cont:32
Keypad Type :0
Keypad Rev. :0
Keypad Table:0
HARDWARE CONFIG
PCMCIA Type:2
PCMCIA Rev.:1
PCB Rev.:1
Product ID :2485
Serial #:
X123456789
[Enter] Next screen
[Esc] Exit
[Enter] Next screen
[Esc] Exit
24XXS065.eps
Definition: Press ; to display the next screen of hardware information. If you are
having a specific problem with one system, such as the radio, note the
hardware versions on the terminal before contacting your local Intermec
service representative.
The country code information on the Hardware Configuration screen is
only valid when the radio (Network Activate command) is enabled. If the
radio is disabled, the country code information is not valid. For help, see
“Network Activate” on page 210.
Keypad Table
Purpose: Intermec service personnel use this diagnostic to identify the number of
the keypad table that you have loaded on your terminal.
80 Trakker Antares 2400 Family System Manual
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.