> > > > Symbol Technologies, Inc.

> > > > ## Symbol Palm Terminal SDK

> > Revision

> > > SPT SDK, version 4.10

> > ##

> > ### Contents

> > > - Purpose of this release
> > > - Directory structure of the Symbol Scanner SDK
> > > - Directory descriptions
> > > - How to use the Print Sample
> > > - Spectrum 24®
> > > - Special notes for this release

> > ### Purpose of this release

> > This release of the Symbol Scanner SDK is provided for use with PalmOS, version 4.1. It contains SPT SDK files and sample application code. The files contained in this SDK release are subject to change.

> > ### Directory Structure

> > > Symbol SDK The main ScanManager directory

> > > Symbol SDK\Document Documentation in pdf format

> > > Symbol SDK\Lib Library files

> > > Symbol SDK\Include All header files

> > > Symbol SDK\prc Supporting prc and pdb files

> > > Symbol SDK\Sample Source for the SPT, printer, MSR, and S24 applications

> > > Symbol SDK\Host Tools\msr Host MSR configurator

> > > Back to top

> > ### Directory Descriptions

> > Symbol SDK\Document
> > If you need to download Acrobat Reader to read the pdf manuals, go to: http://www.adobe.com/products/acrobat/alternate.html
> > and select the appropriate version of Adobe Acrobat Reader.

> > The following documentation is included:

> > The Symbol Palm Terminal Scanner System Software Manual provides the Documentation in PDF format for use when developing scan aware applications to read 1D barcodes for the Symbol Palm Terminal (SPT). In addition, it contains the following chapters to:

> > > (1) develop printer applications for the SPT and Palm III units,
> > > (2) provide information for use in developing applications to enable magnetic stripe
> > > reading on the Symbol Technologies SPT Terminal.
> > > (3) provide an overview of Spectrum24 wireless operation

> > The SPT 173X/SPT 183X WAN Developer™s Guide provides general information for developers creating WAN applications for the SPT 173X or SPT 183X terminals.

> > The GSM AT COMMAND SET for WAVCOM guide describes the AT command set supported by the SPT 1834 GSM radio modem. The SPT 1834 dual-band GSM radio modem is fully integrated in the SPT 1834, allowing the terminal to communicate wirelessly using the GSM900/1800 cellular networks.

> > Symbol SDK\Lib

> > The ScanMgr.lib file is linked with your source code and provides the interface to the Scan Manager Shared Library. The Scan Manager Shared Library provides support for 1D decoded data. PtStatic.lib is the shared library that must be linked with your source code for printing.

> > Symbol SDK\prc

> > - The file MsrMgrLib.prc is the shared library needed for use and control of the MSR 3000.
> > - The pdb files, Printcap.pdb and ptDynLib.pdb, are used for printing. These two files must be HotSynced onto the SPT for printing, along with the user application or PrintSample.prc (See sample subdirectory).

> > Symbol SDK\Sample

> > - The sample code has been built using CodeWarrior 7.x. It will compile out of the box with CodeWarrior, 7.x.
> > - If Metrowerks CodeWarrior, version 8.x, is used, the following modifications must be made to the sample code project:
> > a) For all the samples, the system access path must be changed from "PalmOS 3.5 Support" to "PalmOS Support"
> > b) For PrintSample, replace MSL Runtime PalmOS (2i).Lib with PalmOS Runtime_2i_A5.Lib.
> > - ScanDemo and SScan

> > > Source code for the ScanDemo and Sscan applications is provided. These applications are supplied to help developers create scan aware applications using the Metrowerks Codewarrior IDE. It is expected that portions of this sample code will be used in developer applications. The Sscan application is designed to get the developer up and running quickly with simple scan aware applications, while ScanDemo is more advanced, showing the developer how to provide enhanced scan aware capabilities into their applications.

> > > The Sscan demo is completely described in the Sample Scanning Application section of Chapter 1 of the System Software Manual.

> > - Print Sample

> > > The source for PrintSample is provided as a example of how to use the
> > > printer API. It is supplied as a prototype for developers, so that
> > > they can easily create applications that require printing using the
> > > Metrowerks Codewarrior IDE. It is expected that portions of this sample
> > > code will be used in developer applications. See Chapter 3 of the System
> > > Software Manual for a description of sample code and the sample application

> > - MSR Sample

> > > Two examples demonstrating MSR ability are provided: MSR Demo and
> > > MSR Sample.

> > - S24 Samples

> > > > Examples for Spectrum24® code are provided in the S24 Samples Directory. Application source code is provided for the Client (SPT 184x) and Server portions of the S24 sample program.

> > > > Back to top

> > How to use PrintSample
> > Here's the installation procedure to test with the sample code that is provided:

> > > 1. HotSync the following 3 files onto the unit:

> > > > PrintSample.prc - sample application
> > > > ptDynLib.pdb - printer dynamic library
> > > > printcap.pdb - printcap data file that contains descriptions of each supported printer

> > > 2. Tap on the ptSample icon
> > > 3. Select a Transport and a Printer
> > > a) Select either serial or Ir and check the appropriate box.
> > > b) Select the Printer that you are using and check the appropriate box.
> > > 4. NOTE: If you want to use the PrintSample program with a Symbol PGP1000 or a Zebra EPL II printer, then select "Eltron", from the list of Printers. Eltron, Symbol PGP1000 and Zebra EPL II Printers use the same printcap data.
> > > 5. Then select the Command from the lower left hand corner.
> > > (See chapter 3 for full details.) For example:

> > > > - Connect to the printer with a serial cable, if the transport selected is serial. For Ir, just align the unit with the Ir port of the printer.
> > > > - Open the library, i.e.. Select Command/Open.
> > > > - Select Form, i.e. Select Command/Form.
> > > > - Select Data to print, i.e. Select Command/Data.
> > > > - Close the library, i.e. Select Command/Close.
> > > > Back to top

> > Spectrum24®

> > The driver necessary to support the Spectrum24® network is already included on the ROM image of your SPT 184x. The primary interface to the Spectrum24driver is via the PalmOS NetLib API functions. NetLib is a wrapper around the IP stack and is used by SPT 184x applications to establish connections, send and receive data. For a detailed description of the NetLib API refer to the PalmOS SDK documentation.

> > The SPT SDK provides the S24 Radio API that can be used by developers for Spectrum24 radio terminals. Using this API, an application can control some of the Spectrum24 terminal's radio behavior and gather information about its radio settings. However, applications are not required to configure any of the radio settings using this API. By default, the Spectrum24 terminal radio initializes and connects to the Spectrum24 network based on the preferences set in the Spectrum24 Network Preference Panel in the terminal.

> > Details of the Spectrum24 Radio API can be found in the Chapter 4 of the System Software Manual, (SSM.PDF), included in the Document subdirectory of this SDK.

> > Note: Existing applications that use any S24 API calls will need to be converted to use the new S24 API. Convert all existing applications to work with this SDK 4.10.

> > Back to top

> > Notes

> > - Users should be able to generate the sample code for all demos, as is, using Metrowerks CodeWarrior, version 7.x and PalmOS 4.1.
> > - Note that the SPT 184x library is no longer required. If you don't want to modify your application for the new S24 functions, you can download the SPT SDK 3.10 and use spt184x.lib, located in the lib directory. It is recommended that old applications be revised.

> > - It is not recommended that the developer remove the battery while holding the scanner button, when the radio is on. This can cause unexpected results.
> > - Two new header files have been added:
> > - The file, SymbolEvents.h, has been added. This file includes Symbol Generated Palm Event defines.
> > - File, UserControl.h, has also been added. This file includes definitions used for obtaining driver version and modem information from the GSM modem driver using the Serial Manager User Defined Control Code.

> > - For ROM images updates, go to Developer Downloads on: http://devzone.symbol.com/
> > - If the file, printcap.pdb, does not contain an entry for your printer, contact Symbol or the printer manufacturer for updates to the printcap file. Updates will be posted on the Symbol web site: http://devzone.symbol.com
> > IBack to top

> > May 10, 2002