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


     Symbol SDK\Sample

    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

    IBack to top

    May 10, 2002

    Copyright (c) 2002
    Symbol Technologies