Intermec Janus Application Simulator User manual

JANUS

®

Application Simulator

P/N 062778-001

User's Manual

Intermec Corporation

6001 36th Avenue West

P.O. Box 4280

Everett, WA 98203-9280

U.S. technical and service support: 1-800-755-5505

U.S. media supplies ordering information: 1-800-227-9947

Canadian technical and service support: 1-800-688-7043

Canadian media supplies ordering information: 1-800-268-6936

Outside U.S. and Canada: Contact your local Intermec service supplier.

The information contained herein is proprietary and is provided solely for the purpose of

allowing customers to operate and/or 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 in this manual are subject to change without notice.

 1995 by Intermec Corporation

The word Intermec, the Intermec logo, JANUS, IRL, Duratherm, Virtual Wedge, and CrossBar

are trademarks of Intermec Corporation.

Throughout this manual, trademarked names may be used. Rather than put a trademark ()

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.

Contributors

Author Karen Granger Ross

Editor Craig Thompson

Technical Illustrator George Wilson

Technical Reviewers Roy Chrisop

Roy Law

Yong-Qin Lu

Contents

v

Contents

Before You Begin xi

Warranty Information xi

Cautions xi

About This Manual xii

Other Intermec Manuals xiv

Getting Started

Introduction to the JANUS Application Simulator 1-3

Hardware and Software Requirements 1-4

Installing the JANUS Application Simulator 1-5

Learning About the JANUS Application Simulator 1-6

How the JANUS Application Simulator Works 1-6

If You Are Not Using JANUS PSK Library Functions 1-8

Integrating the Simulator Into Your Development Process 1-9

Using the Simulator With Other Products 1-9

JANUS Features That Are Simulated 1-10

Text Display 1-10

Bar Code Input 1-10

Power Management 1-12

Communications Input and Output 1-12

JANUS Features That Are Not Simulated 1-13

Character Height 1-13

Viewport 1-14

Contrast Level 1-14

Special JANUS Key Sequences 1-14

Speed and Performance 1-14

1

vi

Running and Debugging an Application

Deciding Where to Start the Simulator TSR 2-3

Starting the Simulator TSR 2-3

Running and Debugging a JANUS Application 2-4

Understanding the Limitations of the Simulator TSR 2-5

Exiting the Simulator TSR 2-6

Learning About the INI File

How to Customize the Parameters 3-3

How the Parameters Are Organized in This Chapter 3-3

Overview of Parameters 3-5

portn_read_file 3-6

portn_write_file 3-8

rx_check_status_return 3-9

protocol_ext_status_return 3-9

cancel_rx_buff_return 3-10

cancel_tx_buff_return 3-10

UART_status 3-11

expanded_keyboard_status 3-12

kb_insert_string_status 3-13

kb_insert_string_capacity 3-14

flush_exp_keyboard_status 3-15

warmboot_status 3-16

power_status_line 3-17

power_status_battery 3-18

power_status_backup 3-18

power_status_batt_life 3-19

power_status_return 3-19

display_contrast_level 3-20

2

3

Contents

vii

display_size_mode 3-21

display_video_mode 3-22

display_scroll_mode 3-23

display_viewport_lock 3-24

display_x_pos 3-25

display_y_pos 3-26

display_backlight 3-27

display_char_height 3-28

appl_break_status 3-29

follow_cursor 3-29

control_key 3-30

keyclick 3-31

numeric_keypad_switching 3-32

numeric_keypad_status 3-33

label_symbology 3-34

sim_wand_key 3-35

clear_abort_callback_return 3-36

command_return 3-36

link_comm_return 3-37

serial_protocol_control_return 3-37

standby_wait_return 3-38

unlink_comm_return 3-38

Communications Standard Return Values 3-39

Reader Wedge Standard Return Values 3-40

viii

Customizing INI Files With the Editor

Why Customize INI Files? 4-3

Starting the Editor 4-5

Using Online Help 4-6

Creating a New INI File 4-7

Opening an Existing INI File 4-8

Setting Parameters 4-9

Setting Communications Parameters 4-10

Naming portn_read_file and portn_write_file 4-11

Specifying a Path for portn_read_file and portn_write_file 4-11

Setting Keyboard Parameters 4-12

Setting Power Management Parameters 4-13

Setting Display Parameters 4-14

Setting Keypad Parameters 4-15

Setting Reader Wedge Parameters 4-16

Saving Changes 4-17

Discarding Changes 4-20

Restoring the Default Values 4-20

Updating the Simulator TSR With the Current INI File 4-21

Setting Up the Printer 4-22

Printing INI Files 4-22

Exiting the Editor 4-23

4

Contents

ix

Troubleshooting

Running an Application Without the Simulator TSR 5-3

Simulating Bar Code Input With an Intermec Wedge 5-3

Error and Status Messages for the Simulator TSR 5-3

Error and Status Messages for the Editor 5-4

Index

5

I

Before You Begin

xi

Before You Begin

This section introduces you to standard warranty provisions, cautions,

document formatting conventions, and sources of additional product

information.

Warranty Information

To receive a copy of the standard warranty provision for this product,

contact your local Intermec sales organization. In the U.S. call (800) 755-

5505, and in Canada call (800) 688-7043. Otherwise, refer to the Worldwide

Sales & Service list shipped with this manual for the address and telephone

number of your Intermec sales organization.

Cautions

The cautions in this manual use the following format.

CAUTION

Caution

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.

Conseil

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.

JANUS Application Simulator User’s Manual

xii

About This Manual

This manual describes how to install, customize, and use the JANUS

Application Simulator. You should see the online README file for

important information that was not available when this manual was

printed.

Use this manual in conjunction with the JANUS PSK Reference Manual,

which describes the PSK library functions and JANUS-specific system

interrupts that the JANUS Application Simulator captures and simulates.

Intended Audience

This manual is intended for experienced PC programmers who already

understand return values, know how to program in their chosen language,

and know how to use their application development and debugging

software. They have already read the JANUS PSK Reference Manual so they

understand how to create programs for the JANUS.

How This Manual Is Organized

The JANUS Application Simulator User's Manual is divided into five chapters:

Chapter What you'll find

1

Gettin

g

Started

Introduces the JANUS Application Simulator and explains how to

install the software. Also describes which JANUS features the

Simulator can make your development PC mimic.

2

Runnin

g

and Debu

gg

in

g

an A

pp

lication

Explains how to start and exit the Simulator TSR, and gives hints

for debugging a JANUS application.

3

Learnin

g

About the INI File

Lists the parameters in the initialization file.

4

Customizin

g

INI Files With the Editor

Describes how to use the Editor to customize the parameters in the

initialization file.

5

Troubleshootin

g

Describes how to recover if you run a JANUS application on your

PC without first starting the Simulator TSR. Also lists and describes

the status and error messages you may see.

Before You Begin

xiii

Terms and Conventions

In this manual, the JANUS 2010 and JANUS 2020 are referred to as “the

JANUS” or “the reader.” Also, the Intermec-specific library functions

described in the JANUS PSK Reference Manual are referred to as “PSK

functions.”

This manual uses the following conventions to emphasize keyboard input,

screen messages, and command syntax.

Keyboard Input

Keystrokes are emphasized in bold. For example, “press Enter” means you

press the key labeled “Enter” on your keyboard.

If you must press more than one key at the same time, the keys are

connected by a dash in the text. For example, press Ctrl-Alt-Del to perform

a warm boot on a PC. When the keys are connected by a dash, it is

important that you press and hold the keys in the order they are listed in the

text.

Commands

Command syntax is shown in the text as you should type it. For example, to

see a listing of directories on the PC, type this command and press Enter:

dir

If a command line includes keywords in italics, the italics indicates that you

must enter a real value in place of the keyword. For example, this command

directs you to type the janussim command, specify the name of the INI file,

and press the Enter key:

janussim

filename

.ini Enter

JANUS Application Simulator User’s Manual

xiv

Other Intermec Manuals

You may need to refer to the JANUS manuals listed below while using the

JANUS Application Simulator. To order manuals, contact your local

Intermec representative or distributor.

Manual

Intermec

Part No.

JANUS Programmer's Software Kit Reference Manual

062133

JANUS 2010 Hand-Held Data Collection Computer User's Manual

058426

JANUS 2020 Hand-Held Data Collection Computer User's Manual

059951

Also, you should see the online README file provided with the software.

This README file contains important information that was not available

when this manual was printed, such as operating guidelines or software

development packages that are compatible with the JANUS Application

Simulator.

Getting Started

1

Getting Started

1-3

1

This chapter introduces the JANUS Application Simulator, explains how to install

the software, and describes how to make your PC mimic a JANUS reader.

Introduction to the JANUS Application Simulator

Applications created for JANUS readers may contain JANUS PSK library

functions and JANUS-specific system interrupts that—when run on a PC

instead of a reader—cause a PC to lock up.

With the JANUS Application Simulator, however, you can run JANUS

applications on a PC. The Simulator captures those functions and interrupts

before they can disrupt the PC. The Simulator then uses those functions and

interrupts to make the PC mimic a JANUS reader, allowing you to run and

debug any JANUS application on your PC.

The JANUS Application Simulator operates as shown in this illustration.

Briefly, while a JANUS

application is processing on

a PC, it may issue a JANUS-

specific system interrupt.

The Simulator TSR captures

the interrupt, uses values

from the INI file to

assemble a response, and

then sends the response to

the JANUS application.

The JANUS application

acccepts the response and

continues processing.

For a detailed technical

description, see “How the

JANUS Application

Simulator Works” later in

this chapter.

S

i

m

u

l

a

t

o

r

T

S

R

Janus

Application

Processing

INI FILE

5700U-002

JANUS Application Simulator User’s Manual

1-4

With the JANUS Application Simulator, you can debug the logic and syntax

of a JANUS application, but not the user interface or performance:

• The Simulator helps you debug logic and coding errors by allowing you

to use development tools and debuggers common in the software

industry. For example, if you are using Microsoft Visual C++ to create

JANUS applications, you can use Microsoft Codeview for DOS to test

the applications. The Simulator runs in the background, transparent to

your development software.

• The Simulator does not help you test the user interface or performance of

the application. You can test those characteristics of the application far

better on a JANUS reader than on any simulation program. You should

always test your application by running it on a JANUS reader after you

have finished debugging the logic.

Because JANUS applications are DOS applications, you must use a DOS-

application debugger, not a Windows-application debugger. For example,

you can use Codeview for DOS, but not Codeview for Windows.

Use the JANUS Application Simulator and this manual in conjunction with

the programming software and documentation provided with your reader.

Hardware and Software Requirements

To run the JANUS Application Simulator, you need a PC with this

hardware:

• Intel 386 or 486 CPU

• 3.5 inch floppy disk drive

• 1.2 MB available on the hard drive

• VGA monitor

• Mouse or other pointing device

You must have already installed this software on your PC:

• MS-DOS 5.0 or higher

• MS-Windows 3.0 or higher

• Application development software, such as Microsoft Visual C++ 1.5

Professional Edition

Getting Started

1-5

1

Note: Because JANUS applications are DOS applications, you must use DOS-

application debugging software, such as Codeview for DOS. You cannot use

Windows-application debugging software, such as Codeview for Windows.

Installing the JANUS Application Simulator

The Simulator includes a Windows-based installation program to help you

install the software. During the installation, you choose the directory in

which to install the software.

To start the installation

1. Insert the JANUS Application Simulator disk into your floppy drive.

2. Start Windows.

3. From the Program Manager File menu, choose Run.

4. Start the installation with either of these commands:

• If the disk is in Drive A, type this command: a:setup

• If the disk is in Drive B, type this command: b:setup

5. Choose the OK button.

6. Follow the instructions displayed by the installation program.

The installation program

creates an Intermec group

on your Windows desktop.

The group contains the icon

for the Editor, the Editor's

help files, and the

README file.

Read the README file before you use the Simulator. The README file

may contain important information that was not available when this manual

was printed, such as operating guidelines or the names of software

development packages that are compatible with the Simulator.

For help using the Editor and its online help, see Chapter 4, “Customizing

INI Files With the Editor.”

JANUS Application Simulator User’s Manual

1-6

Learning About the JANUS Application Simulator

To learn more about the JANUS Application Simulator, read these sections:

• How the JANUS Application Simulator Works

• If You Are Not Using the JANUS PSK

• Using the Simulator During Development

• Using the Simulator With Other Products

• JANUS Features That Are Simulated

• JANUS Features That Are Not Simulated

How the JANUS Application Simulator Works

The JANUS Application Simulator consists of three parts:

Simulator TSR The Simulator terminate and stay resident (TSR) program

runs in the background on your PC. The Simulator TSR captures JANUS-

specific system interrupts and makes your PC mimic a JANUS reader. For

instructions, see Chapter 2.

INI File The initialization (INI) file specifies how the Simulator TSR

simulates JANUS features such as bar code input and battery status.

JANUSSIM.INI is the default INI file. For a description of the parameters in

the file, see Chapter 3.

Editor The Editor is a Windows-based tool for setting the parameters

stored in the JANUSSIM.INI file. For instructions, see Chapter 4.

The Simulator TSR uses the parameters in the INI file as out parameters and

return values for any JANUS PSK library functions and JANUS-specific

system interrupts that a JANUS application contains.

For example, consider the JANUS battery. The status of the battery is very

important because it may be the reader’s only power source. JANUS

applications may check the battery’s status to make sure that sufficient

power is available for the application. There is no battery to check on the

PC. Therefore, the Simulator TSR must simulate the JANUS battery.

The following illustration shows how the Simulator TSR simulates a JANUS

battery when a JANUS application issues the im_power_status function.

Page is loading ...

Intermec Janus Application Simulator, Janus 2010, Janus 2020 User manual

Related papers

Other documents