Paxar Gold 6037EX User Manual

Size:
2.78 Mb
Download

I N T R O D U C T I O N

1

 

 

Welcome to the software development kit (SDK) for the Monarch® Pathfinder® Ultra® Gold 6037EX™ printer. The SDK consists of software and documentation.

This chapter introduces the kit, describing

About this Manual

System Requirements

SDK Contents

Related Documentation

About this Manual

This manual is written for experienced Microsoft® C/C++ programmers who write printer applications. These programmers should also be familiar with Monarch’s MPCL printer language.

The following table describes the conventions used in this manual.

Convention

Description

[ ]

Brackets indicate optional items.

Ellipses indicate the preceding item is repeated

 

one or more times.

Italics

An item appearing in italics is a variable, a

 

function parameter, or a value of a variable.

Bold

An item appearing in bold is being emphasized.

+

A plus sign placed between two keys indicates

 

to press the keys at the same time.

Introduction 1-1

S y s t e m R e q u i r e m e n t s

Following are the hardware and software requirements for the SDK. Refer to your Windows® and C/C++ documentation for additional requirements.

H a r d w a r e R e q u i r e m e n t s

You need an IBM® PC or 100% compatible with

80486 or higher processor

VGA or higher monitor

at least 8 MB of memory (16 MB recommended)

hard disk with 8 MB of free space (not including the space needed for C/C++)

Windows 95® (or higher)-compatibleCD-ROMdrive

serial port

a printer-to-PCcable (part number 124054).

S o f t w a r e R e q u i r e m e n t s

Your PC needs the following software:

Microsoft Windows 95 or higher

Any third-partyproducts for serial communications (purchased separately)

Microsoft C/C++ 1.52

1-2Programmer’s Manual

S D K C o n t e n t s

The SDK is located in the directory you specified during installation. It is divided into several sub-directories,as described below.

Sub-directory

Description

bin

Development tools

docs

Online documentation

dos

ROM-DOS™files

font

MPCL packets containing the printer’s

 

external base fonts

images

Pre-builtROM disk images

include

Include files

lib

Library files

samples

Source code samples

utilities

Utility programs

 

 

Introduction 1-3

R e l a t e d D o c u m e n t a t i o n

The following table describes other documentation for the printer.

Item

Description

ROM-DOSUser Manual

Information about the printer’s ROM-

 

DOS operating system.

Equipment Manual

Information about printer operation.

Application Notes

Technical information needed for

 

application development (beyond

 

writing a C/C++ program). It contains

 

information on radio networks,

 

memory cards, etc.

Packet Reference Manual

Syntax descriptions of the MPCL

 

printer language.

Datalight Sockets

Describes the TCP/IP stack and API

Developer’s Guide

for use with radio cards.

 

 

1-4Programmer’s Manual

P R I N T E R F E A T U R E S

2

There are several printer features that you must understand to write applications. For example, just knowing that the printer has a display does not help. You must know its size, how it treats messages written to it, how the rows and columns are numbered, and which functions manipulate it.

This chapter describes the following printer features:

Display

Keypad

Speaker

Memory

Fonts

Scanners

Boot Process

Windows 95/Network Notes

Printer Features 2-1

D i s p l a y

The printer has an 8-rowdisplay. The printers can display characters in either reverse or normal video. A display backlight is also available.

Several functions that manipulate the display use a coordinate system to access a certain point on the display. Coordinate (0,0) (row, column) is the display’s upper-leftcorner.

The display is not compatible with any standard IBM PC display adapter. There is no program-accessiblevideo memory.

Display Pages

The printer has two display pages (numbered 0-1).

An application can manipulate any display page, regardless of the current page. To manipulate the display, use the functions with the vid prefix (see Chapter 4, “Function Reference”).

Each display page has its own cursor. Only one page appears on the display at a time. To ensure the

application begins on the same display page every time, use vidSetPage to set the display page at the application’s beginning.

display pages are empty at the application’s beginning, use vidScroll to clear the pages at the application’s beginning and end.

2-2Programmer’s Manual

If the application writes to

a display page other than the current one, the displayed

information does not appear until the application uses vidSetPage to switch to the new display page.

the current display page, the displayed information appears immediately.

You may want the application to write messages longer than 20 characters to the display or have a command move the cursor. If you use standard C functions such as printf,p u t s, andputc in the application, the message wraps to the next line and the cursor moves. The vid functions truncate the message if it extends beyond the twentieth column and only vidPutCursor moves the cursor.

LCD Utility

Use the LCD Utility to

set the display speed

turn the display on or off

turn the backlight on or off.

You must reference this utility in AUTOEXEC.BAT to enable the display before you run your application.

Printer Features 2-3

LCD [options… ]

You can enter one or more of the following options on the command line.

Y Enable the display. This option is the default.

N Disable the display.

F Set the display speed to fast.

S Set the display speed to slow.

CClear display. Using this command is equivalent to using the cls command.

DBacklight off.

L Backlight on.

K e y p a d

The following table describes the keypad’s data entry modes. These are described in more detail in the Equipment Manual.

Mode

Acceptable Keys

 

 

Numeric/Symbol

Default. Numbers and Symbols

Alphabetic

Letters

Special Key

Function Keys

 

 

Normally, when entering data, the operator must enter and exit the modes manually. However, with the Kbd functions described in Chapter 4, an application can also change between the modes automatically.

Using the trigger is a special case of Function Key mode. See “Reading Trigger Presses” in Chapter 6 for more information.

2-4Programmer’s Manual

S p e a k e r

Applications can make the printer speaker beep for different lengths of time and frequencies. For example, you might use the speaker to bring an error to the operator’s attention or to indicate a good scan. The spkBeep function (described in Chapter 4) manipulates the speaker.

M e m o r y

The printer has 2 MB of memory.

Printer Features 2-5

Following is the address map for the printer.

200000

180000

100000

F0000

A0000

80000

0

Free

F0000 – FFFFF

BIOS

 

 

 

 

 

EE000 – EFFFF

Disk On Chip

 

 

 

 

 

EC000 – EDFFF

PCMCIA

 

 

 

 

 

DC000 – EBFFF

True FFS

 

 

 

 

 

AA000 – ABFFF

 

 

System Variables

 

 

 

 

A8000 – A9FFF

Display RAM

Video Data Storage

 

 

 

 

 

 

 

 

 

 

 

 

 

Free Up to

 

 

 

 

 

 

 

 

A0000H

 

 

 

 

 

 

 

 

 

 

 

 

 

DOS

 

 

 

 

 

500 – 5FF

Data Area 1 for ROM BIOS

 

 

 

 

 

400 – 4FF

Data Area 2 for ROM BIOS

 

 

 

 

 

0 – 3FF

INT Vectors

 

2-6Programmer’s Manual