Intermec 6300 SERIES Programmer'S Reference Manual Download

Page: 7 / 410

CONTENTS

PEN*KEY

6200/6300 Hand-Held Computer Programmer’s Reference Guide v

Power Management Programming Interface

3Ć17

. . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Windows ProtectĆMode API

3Ć17

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Power Management by Windows Applications

3Ć18

. . . . . . . . . . . . . . . . . . . . . . . .

Saving CPU Power

3Ć18

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Saving Device Power

3Ć19

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Holding Off Suspend Timeouts

3Ć19

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Suspending the System Directly

3Ć19

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Power Management in Windows Drivers

3Ć19

. . . . . . . . . . . . . . . . . . . . . . . . . . . . .

6300 Windows Pen Driver

3Ć20

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Pen Applications

3Ć20

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Installation and Configuration

3Ć20

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Hardware Interface

3Ć21

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Digitizer Calibration

3Ć22

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Display Orientation

3Ć23

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

NORPEN.DLL SYSTEM.INI Configuration Example

3Ć24

. . . . . . . . . . . . . . . . .

Pen Calibration

3Ć24

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

6300 Integrated Scanner

3Ć25

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Installation and Configuration

3Ć25

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

SYSTEM.INI Entries

3Ć25

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Entries in [Scanner Driver] Section of SYSTEM.INI

3Ć25

. . . . . . . . . . . . . . . . . .

Usage

3Ć27

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Installing Multimedia Extensions

3Ć28

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

NPCP Printing for Windows

3Ć29

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Installation and Configuration

3Ć29

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Required WIN.INI Entries

3Ć29

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Required SYSTEM.INI Entries

3Ć29

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Usage

3Ć30

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Basic Windows Printing

3Ć31

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Default ErrorĆHandling Mode

3Ć31

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

ApplicationĆDefined ErrorĆHandling Mode

3Ć31

. . . . . . . . . . . . . . . . . . . . . . . . . . .

Printer Services API

3Ć32

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Retrieving the API Entry Point PrtService

3Ć32

. . . . . . . . . . . . . . . . . . . . . . .

Calling PrtService

3Ć33

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supported PrtService Options

3Ć33

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Special Paper Handling

3Ć34

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Windows Error Codes/Messages

3Ć35

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

IrDA Printing

3Ć36

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Installation and Configuration

3Ć36

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Required WIN.INI Entries

3Ć37

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Required SYSTEM.INI Entries

3Ć38

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Default ErrorĆHandling Mode

3Ć39

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

ApplicationĆDefined ErrorĆHandling Mode

3Ć39

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Printer Services API

3Ć39

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Retrieving the API Entry Point PrtService

3Ć40

. . . . . . . . . . . . . . . . . . . . . . . . . . .

Calling PrtService

3Ć40

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supported PrtService Options

3Ć41

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Error Codes and Messages

3Ć41

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

SECTION 4

Power Management BIOS: NORAPM.EXE

System Power States

4Ć2

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

System Power State Management

4Ć3

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Device Power Control

4Ć4

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

APM Software Interface

4Ć7

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

APM Connection

4Ć7

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Power Management Events

4Ć7

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

APM BIOS Functions

4Ć10

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

APM Function Summary

4Ć11

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Summary of Contents for 6300 SERIES

Page 1: ...PEN KEYR 6200 6300 Hand Held Computer PROGRAMMER S REFERENCE GUIDE P N 977 054 003 Revision D December 2000...

Page 2: ...chnologies Corporation Publications Department 550 Second Street SE Cedar Rapids IA 52401 ANTARES INTERMEC NORAND NOR WARE PEN KEY ROUTEPOWER TRAKKER and TRAKKER ANTARES are registered trademarks and...

Page 3: ...CTION 1 Getting Started Open System Environment 1 2 Introduction to the 6200 and 6300 Series Computers 1 2 Operating System 1 2 How the Software is Different 1 2 How the Hardware is Different 1 2 Proc...

Page 4: ...tion System 1 15 PenPal DOS 1 15 PenRight Pro 1 16 Windows 1 16 Handwriting Recognition 1 16 CIC Handwriter Recognition System for Windows 1 17 Synaptics Handwriter Recognition HR 1200 1 17 Pen Extens...

Page 5: ...80h 2 11 NPOWER EXE Multiplex Handle AH 54h 2 11 INT 74h ISR Touch Screen Interrupt 2 11 Interrupts Supported by NORAPM EXE 2 11 NORAND Proprietary System Interfaces 2 13 Calling Convention 2 13 Suppo...

Page 6: ...NGENWAN SYS 2 30 SECTION 3 Supporting Windows Applications Minimal Windows Installation 3 2 Standard SRAM Installation 3 2 Custom SanDisk or PC Card Installation 3 2 Other Custom Installations 3 3 Wi...

Page 7: ...stallation and Configuration 3 29 Required WIN INI Entries 3 29 Required SYSTEM INI Entries 3 29 Usage 3 30 Basic Windows Printing 3 31 Default Error Handling Mode 3 31 Application Defined Error Handl...

Page 8: ...e Parameters 5 11 Minimum NRUPLD CTL 5 12 Example NRUPLD CTL 5 12 Communications Log File 5 12 Protocol Errors 5 13 Novell ODI Ethernet Driver 5 17 Installation 5 17 Using PKODI COM as a Packet Driver...

Page 9: ...y 6 7 Power Management 6 7 Norlib 6 8 Adding PC Card Modem Support 6 8 Adding SanDisk ATA Card Support 6 10 PL N Application Changes 6 10 General Source Changes 6 10 CLKIO 6 11 KBDIO 6 11 MEMIO 6 11 P...

Page 10: ...INT 2Fh 6 117 Standard Mouse Interface INT 33h 6 119 Real Time Clock INT 70h 6 126 Cross Reference to Interrupts 6 127 SECTION 7 System Information ROM DOS 5 7 2 Using COMMAND COM as Command Processo...

Page 11: ...n PL N Application A 2 CONFIG SYS with Device Driver Configurations A 2 AUTOEXEC BAT Listing for 6200 A 5 ROMINIT BAT File Listing for 6200 A 5 Sample Boot Configurations for 6300 A 6 CONFIG SYS Listi...

Page 12: ...rosoft Windows B 26 Windows Architecture B 27 Hardware B 27 BIOS B 28 DOS Device Drivers B 29 DOS B 30 Windows System Files B 31 Windows Device Drivers and APIs B 32 DLLs B 33 INI Files B 34 Additiona...

Page 13: ...al Port 4 5 Table 4 6 Power States Digitizer 4 5 Table 4 7 Power States Ethernet Network 4 5 Table 4 8 Power States Pod 6300 Computer only 4 6 Table 4 9 Power States PC Card Slot 4 6 Table 4 10 Power...

Page 14: ...CONTENTS xii PEN KEYR 6200 6300 Hand Held Computer Programmer s Reference Guide...

Page 15: ...on 4 Several ways to locate information are listed here to assist you in locating topics of interest Contents Topic Summaries Tabs Index Locating Files and Applications 5 Locating Interrupt Definition...

Page 16: ...applications for most standard PCs with some differences For information relating to these differences see the Introduc tion to the 6200 and 6300 Series Computers paragraph in Section 1 For the New U...

Page 17: ...dvanced Power Management APM supported for the 6200 and 6300 Computers Section 5 Communications and Device Support This section includes the following information Communications Support Norand Utiliti...

Page 18: ...top ics listed in the following subsections Files Index This is a fairly comprehensive list of the file names applications and device drivers that are described or mentioned in this publication Inter...

Page 19: ...nd applications The Key Files Used in Flash Upgrade paragraph in Section 1 contains a list of files on page 1 14 CardSoft Utilities in Section 1 contains a list of SystemSoft files begin ning on page...

Page 20: ...in your message your name your company name and address phone number and email to respond to and problem description or question the more specific the better If the equipment was purchased through a V...

Page 21: ...00 Series Computers 1 2 Toolkit for 6200 and 6300 Computers 1 5 Tips for Getting Started 1 6 System Configuration 1 7 Reprogramming Flash Memory 1 8 IFL Card Creation 1 9 Direct Copy Method 1 11 Booti...

Page 22: ...n selecting the equipment and software tools that are best suited to your particular development needs The challenge lies in finding pieces that work well together especially when you are working in t...

Page 23: ...See Section 5 for details Most user input is done using touch pen or bar code scanning Power Management Advanced Power Management APM is critical It consists of a main battery and a backup battery Th...

Page 24: ...re xxxxx consists of modem drive or other device type or PC Card re ferring to the standard or to a card This is because PC Card is becoming the accepted in dustry term for a storage medium that confo...

Page 25: ...re from Intermec from third party suppliers or design your own The files necessary to run Windows and the application software are often loaded onto the RAM drive The instructions included in the tool...

Page 26: ...sive use of handwriting recognition software can slow down an otherwise speedy application Use buttons item lists and pull down menus for common tasks instead 5 When designing a pencentric interface m...

Page 27: ...r Windows toolkit 3 Main and backup batteries at least one of each 4 One 2 MB or 4 MB SRAM card You need at least one 2 MB SRAM card which is useful when you need to update the flash software For larg...

Page 28: ...he archive a text file is produced among others that explains how to reprogram the flash which is essentially the same information presented below Updating Older Configurations Intermec recommends you...

Page 29: ...can the self extracting archive file 62B0100N which transfers the files directly from a network Use INTERSVR as a communication option in the Norand Utilities to transfer files from the network to a R...

Page 30: ...approach To boot the IFL card place it in drive B the drive furthest from the display Press and release the reset button Repeatedly press and release the F4 key until you hear a key beep and then pre...

Page 31: ...omputers or on 6300 Computers with 512K flash memory P N 225 505 xxx 001 or 002 Further older 6300 Computers with a red NO key cannot be updated to the current flash version at the time of this writin...

Page 32: ...A menu Select Option 9 ADVANCED UTILITIES 2 Select Option 3 FORMAT RAM DRIVE 3 Create a RAM drive on the HHC For the 6200 Computer The RAM drive is 960 KB If you already have a RAM drive that is small...

Page 33: ...until you hear a key beep then press and hold the same key until the ROM DOS 5 boot menu is displayed 3 Press the 2 key to boot from drive B Follow the prompts on the display to update the flash memor...

Page 34: ...a 2 MB or larger SRAM card Update the FLASH BIN file that is now written to the 2 MB SRAM card with the custom image file produced in step 3 This is now a Master Mode Boot Initial Flash Load card 5 Fi...

Page 35: ...rait orientation PenDOS Handwriter Recognition System CIC s PenDOS Handwriter Recognition System is a DOS application It is not included in the toolkit A license for CIC s PenDOS specific to the PEN K...

Page 36: ...g up PenRight DOS Windows The 6200 and 6300 Series computers can run any mouse aware Windows application Note that the Windows configuration provided by Intermec is not a full featured Windows package...

Page 37: ...Windows controls Boxed edit or bEdit looks like the following and each letter goes in a box Hashed edit or hEdit looks like the following and each letter goes in a slot A Pen Extensions for Windows p...

Page 38: ...It is very easy to program for Windows with this tool A few warnings however are in order If frequently used forms are not preloaded the screen drawing may be slow Also the data aware controls are ve...

Page 39: ...6300 Application 1 How much space is required Many environments assume that the target machine is a desktop or laptop with virtually unlimited hard drive space This is certainly not the case with a P...

Page 40: ...for location of switch and batteries ON OFF 2 1 Main battery compartment 2 Backup battery switch 1 Figure 1 1 Location of Battery Compartment and Switch 6 Insert the HHC into the dock 7 Verify the HH...

Page 41: ...escription of navigating the screens in the Norand Utilities program see the User s Guide for your particular HHC 12 Prepare the files required for initial program load For a 6300 Computer the standar...

Page 42: ...IOS Installation 1 33 62CALIB EXE DOS Pen Calibration 6200 Series 1 33 CALIB EXE DOS Pen Calibration 6300 Series 1 33 PENALIGN EXE Windows Pen Calibration 1 33 DOS Batch File Enhancers 1 33 BOOTDRV CO...

Page 43: ...the PC Card slots on the system and lists information about the cards in the slots It also lists any warnings or error messages that may have occurred during the configuration of the cards by the Card...

Page 44: ...process a CONFIG SYS file on the card If an application requires a CONFIG SYS file that differs from the one in flash it is necessary to either boot directly from an SRAM card or boot from the RAM dr...

Page 45: ...atting it using FORMAT COM from ROM DOS 5 also supplied in the Programmer s toolkit NOTE All data is lost when the card is formatted You need to boot a previous version of DOS to run INTERLNK if you h...

Page 46: ...obytes h help NOTE Reboot the HHC after the RAM drive is created or altered to make the change effective If a communications option other than Accessory Card is selected the Norand Utilities program a...

Page 47: ...ne of the newname oldname format This causes the file oldname to be read from the PC and transmitted to the HHC with the name newname Both oldname and newname may include path information The followin...

Page 48: ...following to place the download include file on the disk MD A DATA COPY include file A DATA NCDIR EXE A DATA NOTE 4000 Series applications are copied to a BOOT directory 6000 Series applications are c...

Page 49: ...a DHCP server to provide some or all of the information required by the HHC including the IP addresses of the client router and subnet mask Any information not provided by DHCP must be entered manuall...

Page 50: ...is option is replaced by the TFTP option described above The following setup is required for TCP IP Bootp 1 Bootpd and tftp services must be running on a TCP IP server 2 On the bootpd server add entri...

Page 51: ...Unknown host 205 Error sending to server 206 Error receiving from server 207 Receive timeout 208 Server error 209 Error writing to file Norand Utilities Internals The Norand Utilities program creates...

Page 52: ...NORAPM EXE DOS NORAND ATA card support NORATA SYS DOS NORAND ATA card support NORMOD SYS DOS PC Card modems driver NPOWER EXE DOS power management PC4800 SYS DOS NPCP printing support PRDRV SYS DOS I...

Page 53: ...l int 21h Batch file example BOOTDRV COM SET BootDrive A IF ERRORLEVEL 2 SET BootDrive B IF ERRORLEVEL 3 SET BootDrive C IF ERRORLEVEL 4 SET BootDrive D DD EXE Disk Duplicator This utility copies SRAM...

Page 54: ...on the key if any that was pressed prior to exiting The return value is specifically geared to make it easy to tell which numeric key was pressed Table 1 6 DELAY EXE Error Levels Error Level Key Pres...

Page 55: ...the ROM DOS boot flags The boot flags keep track of the default boot drive and serve as an indicator of Master Mode Booting 2 You can change the default boot drive by supplying a simple command parame...

Page 56: ...SECTION 1 Getting Started 1 36 PEN KEYR 6200 6300 Hand Held Computer Programmer s Reference Guide 1 Getting Started...

Page 57: ...ration 62CALIB EXE CALIB EXE 2 16 DOS Scanner SCANTSR EXE 2 16 DOS NPCP Printing PC4800 SYS 2 18 DOS IrDA Printing PRDRV SYS IRDAPDRV EXE 2 20 Device Driver Entry Points 2 20 PC Card Modem Driver NGEN...

Page 58: ...tem startup time NORAPM EXE takes no parameters and must be installed prior to NPOWER EXE These would be a typical entry in the CONFIG SYS file device norapm exe device npower exe device clock exe Aft...

Page 59: ...conds B3 nnn When the main battery is expected to go critical in less than 30 minutes then 30 minute warnings are broadcast at regular intervals The value of nnn defines how often those warnings are b...

Page 60: ...y time Valid values for the state s are shown in the Operational Switches for NPOWER EXE paragraph page 2 2 Switch Description AC bl ch cl Sets the three activity masks maintained by the APM BIOS NORA...

Page 61: ...s The following examples show the valid socket p values that work To enable power to a selected PC Card socket p set the power management state s for that socket to ON 0 For example to enable power to...

Page 62: ...there is any reason to perform resume processing It in turn checks before performing any processing to make sure that a redundant call has not occurred Assuming this is not a redundant call the follo...

Page 63: ...is time for another warning to be broadcast When warnings are enabled and the counter has counted down to zero a warning is broadcast At that time a Get Power Status call is issued to determine whethe...

Page 64: ...ended then all of the processing normally performed for a normal re sume system notification resume notification is performed Unless the SS 1 switch was specified the COM1 Ring Detect is also broadcas...

Page 65: ...what timeout value to use to control the backlight Key Post AX 9102h This function call is issued whenever the keyboard BIOS puts a key in the keyboard buffer This occurs either in response to a keyb...

Page 66: ...value is used INT 28h API DOS Idle API This interrupt is issued by DOS from the standard input output functions whenever it believes that it is idle Unfortunately that includes situations such as the...

Page 67: ...ue to NPOWER The following is a list of the functions implemented by NPOWER See the Interrupt Definitions paragraph in Section 6 for further details Installation Check AX 5400h Get Set Power Status AX...

Page 68: ...trast Adjust AX 5380h BH 0Dh Yes Backlight Adjust AX 5380h BH 0Eh Yes Read ID AX 5380h BH 0Fh Yes Set Click AX 5380h BH 10h Yes Beep AX 5380h BH 11h Yes Define Key Macro AX 5380h BH 14h Yes Define Key...

Page 69: ...s A list of the NORAND Proprietary System interrupts supported by the Power Management BIOS are included with the other Power Management interrupts as shown in Table 2 1 on page 2 12 The Power Managem...

Page 70: ...E COM After installation the driver displays the following message Pen Driver Version 1 xx Installed successfully NOTE APM driver should be loaded before the mouse driver Configuration and Options The...

Page 71: ...9h Set Text Cursor AX 000Ah Read Motion Counters AX 000Bh Set Interrupt Subroutine Call Mask and Address AX 000Ch Light Pen Emulation Mode On AX 000Dh Light Pen Emulation Mode Off AX 000Eh Set Mickey...

Page 72: ...e the scanned bar code is available to an application as simple keystrokes The program also manages power for the scan operations SCANTSR is installed from the AUTOEXEC BAT file via this statement sca...

Page 73: ...ng time no symbology decoding is attempted This option does not result in a narrower brighter beam on the standard range integrated scanner but it still has the effect of not decoding the symbology wh...

Page 74: ...NT 17h interface must also be installed To do so add an I switch to the command line as shown in the preceding statement The digit that appears after the I refers to the LPT port that gets redirected...

Page 75: ...r encountered during the call If the call was successful this byte is zero If the call was unsuccessful this byte represents the extended error The format for the rest of the data is described in the...

Page 76: ...file for IRDAPDRV EXE Device Driver Entry Points The IrDA printer driver supports the following DOS device driver entry points compatible with the standard input and output libraries provided by DOS c...

Page 77: ...to send the data to the printer 55 BAD_CONNECTION_HANDLE Open write or close failure a defective connection handle was encountered while flushing the driver s coalescence buffer 56 UNKNOWN_TRANSMIT_FA...

Page 78: ...failure the write buffer is too large to fit in the local coalescing buffer and is rejected Present the data to the driver with a buffer size less than 128 bytes close The coalescence buffer is sent...

Page 79: ...connectable and therefore cannot perform that role PC Card Modem Driver NGENMOD SYS NGENMOD SYS is a DOS device driver that enables PC Card modems The driver allows applications to specify when the mo...

Page 80: ...s 4000API EXE to treat COM3 calls as COM3 instead of COM1 with no modem control signals See the DOS NPCP Printing paragraph page 2 18 for examples of AUTOEXEC BAT entries using the C3 and other switch...

Page 81: ...st to preserve the communications session NOTE The driver owns the slot and only a modem device can exist in the socket Supported DOS Driver IOCTL_IN Functions The driver supports DOS init open close...

Page 82: ...iable Value Meaning SUCCESS 0x00 BAD_ADAPTER 0x01 Possibly the device in the slot is not a modem BAD_ATTRIBUTE 0x02 Possibly the device in the slot is not a modem BAD_BASE 0x03 The requested COM port...

Page 83: ...x buffer i if i 16 0 printf n printf n get manufacturer s ID void GetMfgId buffer 0 GET_MFGID insert the command Ioctl hndl ioargs 63 printf mfgid n display the returned data printbuf get the product...

Page 84: ...e symbolic notation NGENMOD INT 14h INT 14h interfaces manage modem power or get error codes dealing with the modem power on sequence The supported INT 14h functions are intercepted when DX 1 represen...

Page 85: ...e of x If x 0 the feature is disabled If x 1 the feature is enabled Ox Slot power control x 0 inactive 1 active See page 2 30 for information about the values for this option Px POD 2 power control x...

Page 86: ...opened it is possible to SUSPEND the system The behavior of the network card during suspend is based on the device driver s O option If the O option is set active the driver removes all power Vcc Vpp...

Page 87: ...on 3 2 Other Custom Installations 3 3 Windows Operation Modes 3 3 Normal Startup Standard Mode 3 3 DOSX EXE Startup 3 4 Windows Components 3 4 Windows Shell 3 7 Installation and Configuration 3 7 NORS...

Page 88: ...from DOS into Windows the Windows configuration also includes DOS startup files such as COMMAND COM AUTOEXEC BAT and CONFIG SYS The Windows 3 1 package is shipped with a default configuration appropr...

Page 89: ...25 356 1799 Windows Operation Modes The Windows 3 1 minimal configuration is shipped with all the files necessary for operating Windows in Standard and Enhanced modes Where possible you should run Win...

Page 90: ...S switch to force Windows into Standard Mode 21 BAT Runs WIN COM with 3 switch to force Windows into Enhanced Mode Optional 22 BAT Runs WIN COM with no switches so that Windows can pick the run mode...

Page 91: ...ound driver Required SYSTEM SPEAKER DRV Windows 3 1 PC speaker multimedia driver Optional SYSTEM NOR4800 DRV Windows 3 1 printer driver to support printing to NORAND 4800 Series Printers Optional SYST...

Page 92: ...TEM SHELL DLL Basic services common to Windows 3 1 shell programs such as File Manager Optional SYSTEM VER DLL Windows versioning API Optional SYSTEM WIN87EM DLL Floating point emulator Optional SYSTE...

Page 93: ...and directory as needed NorShellLaunch Note that NORSHELL does not interpret the run and load lines in WIN INI to avoid conflicts with other Windows shell programs For example you might want to use t...

Page 94: ...me Windows is started Installation and Configuration NORAPM DLL is a Windows 3 1 installable driver The APM 1 1 BIOS extensions are required to be installed before Windows is started The APM BIOS that...

Page 95: ...er some feedback 1 NORAPM DLL notifies the user that the suspend request failed by displaying a message in a dialog box Execution continues after the user presses an OK button ApmEventDialogs Valid va...

Page 96: ...re the backlight is turned off A value of zero disables backlight timeouts ApmAcDebouceMs Valid values 0 to 65535 Default value 1000 This entry sets the debounce period for power change broadcasts whi...

Page 97: ...1 SDK See the SDK documentation of the Windows 3 1 kernel debugger for details chapter 5 of SDK Programming Tools manual Debug output is not intended for use on production systems EXAMPLE The followi...

Page 98: ...n persists Main battery is low Only 0 60 minutes of battery life remaining Only 0 60 seconds of battery life remaining Power failure Dead or missing backup battery Suspend Errors These messages appear...

Page 99: ...fault system beep is substituted If WAV files are to play Windows 3 1 multimedia extensions must be installed Windows Background Power Management As the APM operating system driver NORAPM DLL cooperat...

Page 100: ...on to the power savings from other system components that are idled or that consume less power because they are not being gated by the CPU See Power Management Programming Interface for Windows page 3...

Page 101: ...ur classes of system components Windows Applications Windows applications receive APM event broadcasts by means of the message procedures of any top level windows that they own The message format is M...

Page 102: ...RAPM H in the toolkit Use the message to determine whether the system is running on battery power or line power without having to poll NORAPM DLL BATLOW Battery Low Notification The system battery is...

Page 103: ...that event is available on your particular system Generally you should attempt to use APM 1 1 standardized event codes whenever appropriate however we may choose to make additional events available on...

Page 104: ...f or suspend This function is typically called by drivers that control communications serial Ethernet or user input scanner peripherals Applications can also call this function to indicate that they a...

Page 105: ...ir own power management Otherwise an application might change the power state of a device without the driver s knowledge Holding Off Suspend Timeouts If an application is busy with communication or pr...

Page 106: ...hat do not require handwriting recognition should simply treat the pen as a mouse Mouse input is quite adequate for pointing and drawing tasks such as signature capture Since Windows for Pen Computing...

Page 107: ...ase clock value for Gazelle Logitech digitizer Valid values 0 33 MHz 1 2 MHz 2 14 MHz Default 0 NOTE The only value that is supported by the PEN KEY HHC is 0 This value should not need specification f...

Page 108: ...lt 3000 wDistinctWidth Width of the display in its nonrotated orientation in digitizing units Set by the PENALIGN EXE calibration applet Valid values 0 32676 Default 3500 wDistinctHeight Height of the...

Page 109: ...ies additional rotation of the pen digitizer orientation relative to the display which may already be rotated by the preceding DisplayOrientation value The orientation of the pen relative to the defau...

Page 110: ...0 Display Driver DisplayOrientation 1 DisplayColumns 320 DisplayRows 480 Pen Calibration PENALIGN EXE is a Windows pen calibration utility and takes no parameters There are two screens The first asks...

Page 111: ...rs scanner norscan drv Entries in Scanner Driver Section of SYSTEM INI Scanner Driver ScannerHardwareType PEN KEY MessageBeepScanVerification INTERNAL MessageBeepStatusNotification INTERNAL MessageBox...

Page 112: ...does not require the OpenDriver and CloseDriver calls to be issued by the application to use the scanner If TRUE it does not allow multiplexing of the scanner and external COM1 connections This option...

Page 113: ...ized If a tethered scanner is used COM1 is initialized for scanning For a tethered scanner there is no attempt made to record and restore the comm port so any application multiplexing COM1 with the sc...

Page 114: ...nced 0 Clips audio length Max seconds 3 0 gives better sound but is more invasive to the system since interrupts are disabled while the sound plays Leave interrupts enabled 0 4 Make the following WIN...

Page 115: ...ort device NORAND 4800 NOR4800 LPT1 DOS specifies the default printer for Windows See the following PrinterPorts and devices sections PrinterPorts NORAND 4800 NOR4800 LPT1 DOS 15 45 NORAND 4800 NOR480...

Page 116: ...rupt trigger is chip dependent On a 550 UART a value of 0 causes the chip to interrupt on every character The same value on an ST650 UART causes an interrupt on every eight characters or after four ch...

Page 117: ...form feed is generated to move the paper to the top of the next page 8 Use EndDoc to complete the printing operation AbortDoc can cancel a job GDI cleans things up 9 Free the instance of your abort pr...

Page 118: ...Codes and Messages topic on page 3 35 4 Perform normal printing operations 5 Call PrtService to remove the error handler using PRT_SETPROC 0x0010 and a NULL value for the handler address 6 Call PrtSer...

Page 119: ...ter driver ERROR MB_OK MB_ICONEXCLAMATION return FALSE Supported PrtService Options PrtService provides the following services Enable Driver Enables the driver and installs the default error handler S...

Page 120: ...rm marker which confuses things even more Different sizes of paper behave differently and may jam the printer The following describes a scenario that works in most cases Other options need to be done...

Page 121: ...ion Printer stopped sending data in midst of packet 106 TXTMO Not Transmitting Check Connection Printer stopped receiving data in midst of packet 111 BADADR MAC Address Error Printer rejected MAC addr...

Page 122: ...as flushed 243 PAPEROUT2 Paper Out Paper Out data lost 244 LOWVOLTS2 Low Voltage Printer undervoltage condition data lost 245 HIVOLTS2 Over Voltage Printer overvoltage condition data lost 246 LOWBAT2...

Page 123: ...efault 2 indicates a unit of 0 01 inch PaperWidth For the NORAND 6805 printer paper width is fixed at 480 SizeUnit 1 48 millimeters 1 89 inch or 189 for SizeUnit 2 PaperLength For the NORAND 6805 prin...

Page 124: ...setting is 0x2f8 for COM2 UARTIRQ used to set the IRQ line on which the UART interrupts The correct setting is 3 COM2 Technology sets the type of the hand held computer The correct setting is PENKEY...

Page 125: ...point 2 Call PrtService to enable the driver using PRT_ENABLE 0x0001 3 Call PrtService to register the new handler using PRT_SETPROC 0x0010 and the address of the new handler The new handler should h...

Page 126: ...eturn FALSE Calling PrtService NORIRDA DRV contains an exported procedure PrtService HINSTANCE hInst WORD wOpt LPARAM lParam1 LPARAM lParam2 that provides the API for the driver The parameters to the...

Page 127: ...0 lParam1 to a far pointer to your error handling procedure A 0 value removes the handler Call MakeProcInstance to obtain the value lParam2 to 0 Flush Driver Flushes all the data buffers so that every...

Page 128: ...s Reference Guide Any of the listed errors can appear under 12 different operational phases or categories as indicated below Initialize Discover Discover Timeout Connect Connect Status Error Flush Al...

Page 129: ...interest List of Tables Table Page Table 4 1 Activity Monitors 4 3 Table 4 2 Power States General Definitions 4 4 Table 4 3 Power States Display 4 5 Table 4 4 Power States PC Card Devices 4 5 Table 4...

Page 130: ...y decreases APM reduces the power consumption of system resources until the system is brought into a suspend state There are two methods of power level control The APM BIOS manages CPU core logic disp...

Page 131: ...PM functions Set Device Activity Timer or Get Device Activity Timer These timers decrement when no system activity occurs within 0 125 second and are reset to the defined period when activity occurs w...

Page 132: ...m APM BIOS APM device driver or APM aware application via the Set Power State function Device drivers or applications that control device power should be aware that when the system enters System Suspe...

Page 133: ...ivated hardware suspend state OFF PC Card device is in software activated hardware suspend state Table 4 5 Power States Serial Port Power State Description READY If either RS 232 or RS 485 is enabled...

Page 134: ...able 4 10 Power States System Power State Description READY No action STANDBY No action SUSPEND System is placed into SUSPEND Any APM disabled devices are left in the power state they were set to befo...

Page 135: ...e connection between the APM Driver and the APM BIOS Only one APM connection can be active at a time Power Management Events Power Management Events are communicated from the APM BIOS to the APM drive...

Page 136: ...e Get Power Status call Power Status Change Notification Informs APM driver that system charge status has changed APM driver must issue Get Power Status call to determine the change to the charge stat...

Page 137: ...applications of the event The applications are then responsible for preparing devices for use Real Time Clock Alarm Indicates that a System Resume from the alarm associated with the real time clock af...

Page 138: ...devices are a class and the units are the physical unit numbers The device ID parameter is passed in a word length register BX where BH is the device class and BL is the device unit The APM Power Dev...

Page 139: ...C include file defines NORAPM DLL API PMEVENTS H Contains power management event constants See Appendix B for sample listings of APM Include files NORAPM H and APMCODES H APMEVENT H APMEVENT H is a C...

Page 140: ...l applications in any case Some programs such as Visual Basic applications may therefore want to ignore the NORAPM messages The GetPowerStatus function uses the tagPOWER_STATUS structure to relay the...

Page 141: ...interface connect 07 32 bit protected mode interface already established APM Protect Mode 16 bit Interface Connect APM Protect Mode 32 bit Interface Connect APM Real Mode Interface Connect 08 32 bit...

Page 142: ...SECTION 4 Power Management BIOS NORAPM EXE 4 14 PEN KEYR 6200 6300 Hand Held Computer Programmer s Reference Guide 4 Power Management BIOS NORAPM EXE...

Page 143: ...le 5 5 Upload and Download Files 5 6 PL N File Descripter for Binary Files 5 7 Communications Control File for PSROM0C EXE 5 8 Upload Control File Parameters 5 11 Communications Log File 5 12 Protocol...

Page 144: ...using Norand Utilities The following paragraphs describe how an application can use the communications facilities of the Norand Utilities to perform data communications PSROM0C EXE is the primary pro...

Page 145: ...ollowing drivers PKODI COM ODIPKT COM LSL COM RS485ODI COM Optionally configure a DHCP server to provide IP information required by the computer such as the IP addresses of the client server router an...

Page 146: ...rather than domain name Also the fields that specify IP addresses nnn nnn nnn nnn and the domain field can be omitted if BOOTP EXE or DHCP EXE loads the information from a BOOTP server or a DHCP serve...

Page 147: ...of records in file fixed X data type ignored by host nnn decimal number of bytes in file record end of file header PPPPPPPPPPPPPP program identification TTTTTTTTTTTTTTTT hand held computer ID determi...

Page 148: ...gth of field right justified and zero padded End of file header Additional HHC information The actual file name created on the handheld has DAT or P PL6 appended to the ffffff file name File types D a...

Page 149: ...where the first character of each record identifies the type of record These single character record types are used by the formatting utilities of the communications packages to format the file into...

Page 150: ...XE is a session status code Values for this code are described in the Communications Log File paragraph on page 5 12 Below is a list of protocols to which control file parameters are valid All protoco...

Page 151: ...specified the COM and CONFIG parameters may be omitted MODEMSELECT and MODEMTYPE are mutually exclusive that is only one may be specified in a control file Example MODEMSELECT 30 MODEMTYPE Valid only...

Page 152: ...STOPBITS Valid only if two way TTY protocol was specified Valid values 1 One stop bit 2 Two stop bits 3 1 1 2 stop bits Example STOPBITS 1 TRIES Specifies the number of times to attempt a successful c...

Page 153: ...information on PL N file formats is in the document Writing TCOM Modules in PL N for the HHC or see the host TCOM manual Example FORMAT X020 FORMAT N012X016N004 HEADER This file header record precede...

Page 154: ...CTYPE C FORMAT N004X005 FILE BYTR00 DAT FILE BYTR01 DAT file bytr02 dat FILE BYTR03 DAT HEADER DDOSFIL00001X010 FIMAGE PCX FILE IMAGE PCX HEADER DDOSFIL00001X020 F RT00001 COMMON DAT FILE COMMON DAT H...

Page 155: ...tarted 4 Data send started 3 Turn around started 2 Data receive started 1 Sign off started 0 Session complete See the following Protocol Errors for valid values for nnn UP d pathname filename nnn Indi...

Page 156: ...110 Session closed 111 Command canceled 113 Duplicate name in local name table 114 Name table is full 115 Name is deregistered command completed 117 Local session table full 118 Session open rejected...

Page 157: ...mask router domain and domain name server in PCTCP INI For PSROM0C V3 XX verify the IPHOST NETMASK and ROUTER parameters 804 PSROM0C V2 XX only Could not create socket Check all cables and network co...

Page 158: ...6 User aborted communications by pressing EXIT 11 An invalid parameter was specified in the control file 23 End of transmission 101 Line lost 102 Parity error 103 Character gap too long 104 Data loss...

Page 159: ...PXODI IPXODI COM Novell ODI IPX SPX protocol driver CLIENT CLIENT EXE NetWare Lite client shell Using PKODI COM as a Packet Driver Novell network software uses ODI MAC drivers Many TCP IP networking p...

Page 160: ...MAC drivers are documented in Appendix F of the Novell DOS ODI Developer Guide Other Novell user guides also document the strings The PKODI driver should be able to install on a PEN KEY system with no...

Page 161: ...tely as a DOS TSR which is NORAPM EXE When the APM BIOS is provided as a DOS TSR be sure that the APM BIOS is loaded before PKODI COM is loaded otherwise PKODI does not read its Ethernet ID and fails...

Page 162: ...rd is primarily a numeric keyboard with some added function keys Figure 5 1 illustrates the 30 key keyboard PG PG ON F1 F2 F3 F4 EXIT Y A 7 CLR SP B 9 5 4 6 0 2 3 8 NO 1 YES Figure 5 1 30 Key Keyboard...

Page 163: ...y keyboard The unshifted values for these keys act exactly the same on both keyboards the keys have the same key number and the same function A few of the shifted functions are different and are docum...

Page 164: ...an be treated as an internal function rather than as a PC scan code The attribute byte is defined as a bit field in which each bit uniquely modifies the function of the key The following table defines...

Page 165: ...lar to setting bit 6 of the attribute byte for unshifted functions Any time the length is greater than 1 both the key depress scan codes and the key release scan codes must be provided for the shifted...

Page 166: ...D 0x8D 0xAA 18 N N 0x31 0 0x2A 0x1A 0x9A 0xAA 19 T T 0x14 0 0x2A 0x27 0xA7 0xAA 20 Z Z 0x2C 0 N A 21 comma 0x33 0 0x2A 0x33 0xB3 0xAA 22 Y up arrow 0x48 0 N A N A 23 B down arrow 0x50 0 N A N A 24 C C...

Page 167: ...0C 0x8C 44 7 7 0x08 0 0x2A 0x08 0x88 0xAA increase contrast 0x01 45 4 4 0x05 0 0x2A 0x05 0x85 0xAA increase brightness 0x04 46 1 1 0x02 0 0x2A 0x02 0x82 0xAA N A 47 NO Esc 0x01 0 N A N A 48 F1 F1 0x3B...

Page 168: ...rd using the default definitions but it can be disabled in software by changing the BIOS shift flags in the BIOS data area Shifted Key Function Redefinitions This interface for shifted keyboard key re...

Page 169: ...n al 0 pop bp ret _oemDefineKey endp 6300 Keyboard Definition Redefinition The following paragraphs present the standard definitions for the keys on the 6300 Computer and specify the interface used fo...

Page 170: ...eyboard This system scan code is translated to a specific character by the BIOS and Windows drivers based on AT standard key code definitions For each key number and for both shifted and unshifted key...

Page 171: ...0x06 18 2 2 0x03 19 0 0 0x0b 20 c C 0x2e 21 k K 0x25 22 s S 0x1f 23 z Z 0x2c 24 9 9 0x0a 25 6 6 0x07 26 3 3 0x04 27 YES CR CR 0x1c 28 d D 0x20 29 l L 0x26 30 t T 0x14 31 SP SP 0x39 32 Home End 0x47 3...

Page 172: ...llowing table Bit Definition 0 1 Suspend resume key All other attribute bits ignored when this bit is set 1 1 GOLD shift key Attribute bits 2 7 are ignored when this bit is set 2 1 Extended function k...

Page 173: ...key Keyboard macros may continue to repeat as long as the second key is pressed and held Macros comprising only one byte of code information are treated as special keys There are five predefined spec...

Page 174: ...key position being redefined as in table on page 5 30 BL Key position as in chart on page 5 27 CL New scan code as in table starting on page 5 28 BH 15h Define key function number AX 5380h OEM functio...

Page 175: ...lly are scanned for and reserved that is left untouched A single command line switch is provided to force the UMP to reserve memory block elements other than those with option ROM signatures in them T...

Page 176: ...SECTION 5 Communications and Device Support 5 34 PEN KEYR 6200 6300 Hand Held Computer Programmer s Reference Guide 5 Communications and Device Support...

Page 177: ...following page contains entries with pointers to each of the major topics containing interrupts and converting 4000 Series applications for the 6200 Series and 6300 Series computers The List of Tables...

Page 178: ...erfaces List of Tables Paragraph Table Page 6200 6300 BIOS Interfaces Table 6 1 BIOS Interrupts Supported 6 16 4000 Series Programming Interfaces Table 6 2 4000API Interrupts Supported 6 25 4000 Serie...

Page 179: ...oaded from flash MINI NET COM Use MININET EXE see New 6000 Series Files on page 6 4 NOR ANSI SYS NORANDBB EXE NP4805 EXT The 4805 Endcap Printer is specific to 4000 Series HHCs NPRTBIOS EXT Use PC4800...

Page 180: ...e so the cache is large enough to contain the entire application program and the entire library resource program A 4000 Series computer can be configured to minimize executable memory space The 6000 S...

Page 181: ...IOS interface to the NPCP LAN ROMINIT BAT This is a standard ROM DOS 5 configuration file See the ROM DOS 5 topic in Section 7 for a description of this file Unchanged Files The following 6000 Series...

Page 182: ...rectory entries for all open files Example code for Borland C int FileCommit void REGS regs SREGS sregs Parameter table used by function 5d01h Only process_id and computer_id are used struct unsigned...

Page 183: ...s lose their values when the computer is reset Any information that is needed to recover from a reset must be written to a file so that it can be retrieved Memory Verify that the memory requirements o...

Page 184: ...Norlib C library is used skip the next step as it is handled automatically 3 Turn the modem on or off The modem should be turned on just before starting an internal modem TCOM and turned off when the...

Page 185: ...2 Q5 KS0 0 IBM ADAPTER AT FE0V0Q0X1W0 S1 C1 D2 Q5 KS0 0 MS 2 IBM CELLULAR AT FE0V0Q0 S1 C1 D2 K0 M1 E0 M18 N2 H1S7 90 NOTE If the NORAND Norlib C library is used skip the next step as it is handled au...

Page 186: ...pm exe p 0 Dual card support means a system that supports both Sandisk ATA cards and PC Card modems See Adding PC Card Modem Support on page 6 8 If dual card support is not needed remove the line abov...

Page 187: ...s that use GETCTL 3 KB_PHYSIZE need to do one of two things Include code to handle the new display size generated by FONTMAP EXE Applications that support multiple display sizes often check the displa...

Page 188: ...Do not use the standard routine PGEPS1P because it is not compatible with PGAPR2P PGPER2P Replace calls to PGEPS1P EP_FF with PGSFF1P Replace calls to PGEPS1P IP_DONE with PGWTE1P Replace other calls...

Page 189: ...used The READ ME file from RPGDEV V5 20 includes updated documentation for these routines EXAMPLE NUMERIC FUNCTION AUTODETECT PGMDM1P NUMERIC FUNCTION HAYES PGHAD3P MODEM_TYPE AUTODETECT CONFIG TCOM_S...

Page 190: ...er timeouts for other modems because the modems have their own timeout The configuration strings for cellular connections set a longer modem timeout Adding SanDisk ATA Card Support The following steps...

Page 191: ...hich the error occurred cannot be determined the MEM FUL file on all drives is deleted PGFEX1P Used to search all drives for a specified file PGUTL1P Displays a directory of all drives to the user Sin...

Page 192: ...plications that support any of these interrupts handle those interrupts it supports provided the application has not been configured by the use of switches to ignore specific interrupts The following...

Page 193: ...age State AX 101Ah Set Gray Scale Values AX 101Bh Load User Font AH 11h AL 00h 10h Load ROM 8x14 Fonts AH 11h AL 01h 11h Load ROM 8x8 Fonts AH 11h AL 02h 12h Set Block Specifier AX 1103h Load ROM 8x14...

Page 194: ...ive AH DAh Enable RAM Drive AH EAh Enable Checksum AH ECh 14h Serial Communications Services Initialize COM Port AH 00h Send a Character AH 01h Receive a Character AH 02h Get Port Status AH 03h Extend...

Page 195: ...Time Clock Services Read System Timer Ticks AH 00h Set System Timer Ticks AH 01h Read the Real Time Clock Time AH 02h Set the Real Time Clock Time AH 03h Read Real Time Clock Date AH 04h Set Real Tim...

Page 196: ...play Parameters Function AH 12h Subfunction BL 0FCh AL 0DDh Return Invert Mode Status Function AH 12h Subfunction BL 0FCh AL 0DEh Enable Invert Mode Function AH 12h Subfunction BL 0FCh AL 0DFh Disable...

Page 197: ...unction AX 010Eh Enable Time Slicing Function AX 010Fh Disable Time Slicing Function AX 0110h Set Task Identifier These functions can be installed by use of the 4000API EXE TSR if required by an appli...

Page 198: ...ask Value Function AH 0FDh Set Debounce Timer Value Function AH 0FEh Swap Keyboard Translate Tables supported by 4000API EXE Function AH 0FFh Return Number of Keys on Default Keyboard supported by 400...

Page 199: ...NGENMOD is used to access internal modems 4000API EXE C3 If NGENMOD is not used 4000API EXE Command Line Switches Typically you should supply these switches unless your application is a PL N applicati...

Page 200: ...eemptive multi tasker Each task in the ready list is allocated a 55 millisecond time slice If the currently executing task exhausts its time slice before relinquishing control of the processor it is f...

Page 201: ...ge from the queue without pending An accept from an empty queue returns 0 Interrupts Supported by 4000API EXE The 4000 Series interrupts supported by 4000API EXE are matrixed into the entire set of in...

Page 202: ...ueue Structure as Empty AX 100Dh Enable Time Slicing AX 010Eh Disable Time Slicing AX 010Fh Set Task Identifier AX 0110h Accumulate CRC 16h AX 01F4h Exchange Network Packets AX 01F5h Adjust CX for Pro...

Page 203: ...yboard System Resume Vector INT 6Ch 4000 Series Screen Emulation Topics Page Parameters and Command Line Switches 6 28 Font File Format 6 28 Interrupts Supported by FONTMAP EXE 6 28 4000 Series Video...

Page 204: ...is 8 KB Interrupts supported by FONTMAP EXE The 4000 Series interrupts supported by FONTMAP EXE are matrixed into the entire set of interrupts The interrupts for FONTMAP EXE with its symbolic notatio...

Page 205: ...12E0h BL FCh Set Fixed Mode AH 12E1h BL FCh Return Physical Display Size AH 12h BL FDh Read Write Contrast AH 12h BL FEh Backlight Off On AH 12h BL FFh Load User Font AX 1400h Load System Default Fon...

Page 206: ...may be two tokens but each token has its own definition which means each application supporting that interrupt has different expectations for the interrupt The following table shows a list of referenc...

Page 207: ...returns the value zero Shift PrtSc Print Screen Shift Print Screen issues an INT 05h Ctrl Num Lock Pause The Pause key causes the handler to issue INT 15 Function 41h to wait for a valid ASCII keystro...

Page 208: ...ata item start address initialized to 0 crt_mode set to selected mode crt_cols set to number of columns for selected mode page_len set to 1000h for 80x25 modes 800h for 40x25 modes page_offset set to...

Page 209: ...modes though not visible in graphic modes A page need not be active for the function to perform properly The cursor may move off the screen causing it to disappear Position 0 0 is upper left corner o...

Page 210: ...witches NOTE For FONTMAP EXE only pages 0 and 1 are supported On Entry AH 05h AL Page number zero based On Return None INT 10h Function AH 06h Scroll Active Page Up BIOS FONTMAP Allows active display...

Page 211: ...on 40x25 display For 640x200 and 640x480 graphic modes based on 80x25 display On Entry AH 07h AL Number of lines to scroll BH Attribute for blank lines CX Upper left corner CH Row CL Column DX Lower...

Page 212: ...es the bit map for ASCII values 128 255 are stored in a table pointed at by location 0 10Ch in the interrupt table location INT 43h This value is initialized to an internal table maintained by the BIO...

Page 213: ...ics or text modes 1 Selects 320x200 color graphics palette BL Color value to use with color ID value in BH On Return None INT 10h Function AH 0Ch Write Graphics Dot BIOS Writes specified pixel to vide...

Page 214: ...sition of display written to display scrolls up one line On Entry AH 0Eh AL Character to write BH Page BL Foreground color in graphics mode On Return None INT 10h Function AH 0Fh Return Current Video...

Page 215: ...reen 10 Light Green 3 Cyan 11 Light Cyan 4 Red 12 Light Red 5 Magenta 13 Light Magenta 6 Brown 14 Yellow 7 White 15 Intense White 8 Gray On Entry AH 10h AL 02h ES DX Pointer to color list On Return No...

Page 216: ...d stored in all three components of color register On Entry AH 10h AL 10h BX Color register CH Green value CL Blue value DH Red value On Return None INT 10h Function AX 1012h Set Block of Color Regist...

Page 217: ...X 1015h Get Color Register BIOS Returns the contents of a color register as its red green and blue components On Entry AH 10h AL 15h BX Color register On Return CH Green value CL Blue value DH Red val...

Page 218: ...tate BIOS On Entry AH 10h AL 1Ah On Return BH Color page BL Paging mode 0 4 pages 64 registers 1 16 pages 16 registers INT 10h Function AX 101Bh Set Gray Scale Values BIOS For each color register the...

Page 219: ...10h BH Number of points bytes per character BL Block CX Number of characters defined by table DX First character code in table ES BP Pointer to font table On Return None INT 10h Function AH 11h AL 01h...

Page 220: ...after mode set On Entry AH 11h AL 02h or 12h BL Block On Return None INT 10h Function AX 1103h Set Block Specifier BIOS Determines the character blocks selected by bit 3 of the character attribute by...

Page 221: ...n after mode set to avoid unpredictable behavior On Entry AH 11h AL 04h or 14h BL Block On Return None INT 10h Function AX 1120h Set INT 1Fh Font Pointer BIOS Sets INT 1Fh pointer to point to user tab...

Page 222: ...vector to point to default ROM BIOS 8x8 font and updates video ROM BIOS data area Video controller not reprogrammed Provides font selection in graphic display modes On Entry AH 11h AL 23h BL 00 Charac...

Page 223: ...en ES BP Pointer to font table Alternative Settings Video INT 10h Function AH 12h BL 10h Get Video Configuration Information BIOS Returns configuration information for video system Feature bits are se...

Page 224: ...oading BIOS On Entry AH 12h BL 31h AL 0 Enable default palette loading 1 Disable default palette loading On Return AL 12h Function supported INT 10h Function AH 12h BL 32h Enable Disable Video BIOS Di...

Page 225: ...contents should display on the screen Disabling the video refresh blanks the screen and displays the color specified by the DAC color register 00h On Entry AH 12h BL 36h AL 0 Enable screen refresh 1...

Page 226: ...FCh Return Invert Mode FONTMAP Specific to NORAND computers may not be PC compatible On Entry AH 12h AL 0DDh BL 0FCh On Return AL Nonzero Invert mode set INT10h Function AX 12DEh BL FCh Enable Invert...

Page 227: ...egment whose upper left corner is specified by the value in DX On Entry AH 12h AL 0E1h BL 0FCh DH Row window coordinate DL Column window coordinate On Return None INT 10h Function AH 12h BL FDh Return...

Page 228: ...Function AX 1400h Load User Font FONTMAP The font file must be in the following format xsize byte Number of font pixels in x direction ysize byte Number of font pixels in y direction font xsize 7 8 y...

Page 229: ...talled Bit 1 Math coprocessor installed Bit 0 Disk available for boot Memory Size Determination INT 12h BIOS Returns the contents of location 0040 0013h in the BIOS data area in the AX register which...

Page 230: ...boundary error 0A Bad sector flag detected 0B Bad cylinder detected 0C Media type not found 0D Invalid number of sectors on format 0E Control data address mark detected 0F DMA arbitration level out of...

Page 231: ...ul Carry 0 AH 0 If NOT successful Carry 1 AH Drive status INT 13h Function 02h Read Disk Sectors into Memory BIOS The requested sectors are transferred into the buffer See the Error Codes table page 6...

Page 232: ...ectors ES BX Buffer address On Return If successful Carry 0 AH 0 AL Number of sectors actually transferred If NOT successful Carry 1 AH Drive status INT 13h Function AH 04h Verify Disk Sectors BIOS Se...

Page 233: ...ransferred BX 5 CX 7F08h 128 cylinders 8 sectors per track DH 0 One head per cylinder DL 3 Number of floppy drives If NOT successful Carry 1 AH Drive status INT 13h Function AH 15h Get Disk Type BIOS...

Page 234: ...change line support 03h Hard disk CX DX Number of 512 byte sectors If NOT successful Carry 1 AH Drive status 00h No media change 01h Invalid drive 06h Media changed or change line not supported 80h Ca...

Page 235: ...ksum of RAM Drive Integrity Memory BIOS Copies following RAM drive signature into RAM drive logical boot sector s reserved portion _RamDriveSignature label byte db Norand RamDrive 0 db 0 0 0Fh 0FFh 0F...

Page 236: ...Port 1 signals will indicate active To extend battery life shut off communications port power when the port is not in use The power is turned on whenever you access a port You must explicitly turn off...

Page 237: ...rs Bits 7 6 5 Baud Rate 000 110 bps 001 150 bps 010 300 bps 011 600 bps 100 1200 bps 101 2400 bps 110 4800 bps 111 9600 bps Bits 4 3 Parity 00 NO parity 10 ODD parity 11 EVEN parity Bit 2 Stop Bits 0...

Page 238: ...DSR is expected within a timeout period specified by a 40 7C array When DSR is received a character is expected in the receive buffer in the timeout period If a timeout occurs the timeout bit is set i...

Page 239: ...ry point for initialization On Entry AH 04h DX COM port NGENMOD or NGENWAN 2 or 3 BH Parity setting 0 None 1 Odd 2 Even BL Stop bits 0 One 1 Two CH Word length 2 7 bits 3 8 bits CL Baud rate 0 110 1 1...

Page 240: ...es on page 6 61 NOTE This is a nonstandard PC function It may not be available in every PC BIOS Use caution where portability is a concern INT 14h Function AX 0501h Write Modem Control Port 4000API Wr...

Page 241: ...ry device 03h 08h 1Eh 1Fh Configuration requested not supported by card 14h No card is in slot F0h Power error INT 14h Function AH FFh Communications Port Power Off On 4000API NGENMOD NGENWAN Turns of...

Page 242: ...ts for new task ipval dw ip register contents for new task csval dw cs register contents for new task dw does not care context ends csval ipval specifies the code segment and instruction pointer where...

Page 243: ...ists on the task stack only when the task is ready or pending not running On Entry AH 01h AL 02h CX Task ID 0 for currently active task On Return CX Task identifier 0 if task not found ES BX TCB addre...

Page 244: ...ssage if available 0 otherwise NOTE INTERRUPT ROUTINES MUST NOT ISSUE THIS CALL INT 15h Function AX 0107h Accept Message from Mailbox No Pend 4000API On Entry AH 01h AL 07h ES BX Mailbox pointer On Re...

Page 245: ...LL INT 15h Function AX 010Ah Accept Message from Queue No Pend 4000API On Entry AH 01h AL 0Ah ES BX Pointer to queue On Return AX Undefined if successful DX CX Pointer to queue message node if queue i...

Page 246: ...4000API On Entry AH 01h AL 0Fh On Return None INT 15h Function AX 0110h Set Task Identifier 4000API On Entry AH 01h AL 10h CX New task ID for current task On Return None INT 15h Function AX 01F4h Accu...

Page 247: ...C1 Timeout transmit complete no receive activity FF Timeout receive activity Code fragment cbuf struc dd BIOS scratch area db unused by BIOS db BIOS scratch area len dw length of buffer data dw BIOS s...

Page 248: ...elow input trip voltage threshold Reset Current value above input trip voltage threshold INT 15h Function AX 01FAh Sound Error Beep 4000API This system service may not be PC compatible On Entry AH 01h...

Page 249: ...ngth or error Function 1F5h errors es bx adr Has packet destination address all addresses received es bx ctl Has packet control character es bx buffer Has more packet information if appropriate INT 15...

Page 250: ...past the end of the block CX 0000h AX CRC INT 15h Function AX 4200h Request System Shutdown Normal 4000API This interrupt is a PC like system service Has ON OFF key wake unit Puts processor to sleep s...

Page 251: ...INT 15h Function AX 5300h APM Installation Check NORAPM Allows the APM driver caller to determine whether the system s BIOS supports the APM functionality and if so which version of the specification...

Page 252: ...connection already established 05h 16 bit protected mode interface already established 07h 32 bit protected mode interface already established 09h Unrecognized device ID INT 15h Function AX 5304h APM...

Page 253: ...n control to the driver or power aware application On Entry AH 53h AL 05h On Return If successful Carry 0 If NOT successful Carry 1 AH Error code 03h Interface not connected 09h Unrecognized device ID...

Page 254: ...otification 0005h Last request rejected Power states 0004h and 0005 supported only for Power Device ID 0001h On Return If successful Carry 0 If NOT successful Carry 1 AH Error code 01h Power managemen...

Page 255: ...600 Condition cycle xFF All devices in this class F000 FFFF reserved See APM BIOS Functions in the Power Management BIOS section for details of those devices INT 15h Function AX 5308h Enable Disable P...

Page 256: ...Charging FFh Undefined All other values reserved CH Battery flag Bit 0 1 High Bit 1 1 Low Bit 2 1 Critical Bit 3 1 Charging Bit 7 1 No system battery or powerfail has occurred All other bits reserved...

Page 257: ...Carry 1 AH Error code 80h No power management events pending INT 15h Function AX 530Ch Get Power State NGENMOD NGENWAN On Entry AH 53h AL 0Ch BX 40xh where x COM port number On Return CX Power state...

Page 258: ...t altered from the state set before Suspend was entered On Entry AH 53h AL 0Dh BX Power device ID See definitions page 6 78 CX Function code 0000h Disable 0001h Enable On Return If successful Carry 0...

Page 259: ...12 volts 3 VPP High impedance state On Return If successful Carry 0 AH 0 AL Undefined If NOT successful Carry 1 AH Error Code AL Undefined INT 15h Function AX 5380h Subfunction BH 0Ah Set VPP2 NORAPM...

Page 260: ...pt is a NORAND Proprietary System interface On Entry AH 53h AL 80h BH 0Dh BL Contrast adjustment On Return If successful Carry 0 AH 0 AL Undefined If NOT successful Carry 1 AH Error Code AL Undefined...

Page 261: ...DX Ethernet or system ID AH 0 AL Undefined If NOT successful Carry 1 AH Error Code AL Undefined The format of the ETHERNET ID structure is typedef struct UC id 6 the actual ID ETHERID INT 15h Functio...

Page 262: ...alue from 0 255 On Return If successful Carry 0 AH 0 AL Undefined If NOT successful Carry 1 AH Error Code AL Undefined INT 15h Function AX 5380h Subfunction BH 14h Define Key Macro NORAPM Defines a ma...

Page 263: ...ace On Entry AH 53h AL 80h BH 15h BL Key position CH Type CL Keycode On Return If successful Carry 0 AH 0 AL Undefined If NOT successful Carry 1 AH Error Code AL Undefined INT 15h Function AX 5380h Su...

Page 264: ...rietary System interface On Entry AH 53h AL 80h BH 1Bh On Return If successful Carry 0 AH 0 AL Undefined If NOT successful Carry 1 AH Error Code AL Undefined INT 15h Function AX 5380h Subfunction BH 1...

Page 265: ...successful Carry 1 AH Error Code AL Undefined INT 15h Function AX 5380h Subfunction BH 25h Write EEPROM NORAPM Writes a byte data parameter to the system configuration EEPROM at the specified offset...

Page 266: ...ffset address On Return If successful Carry 0 AH 00h AL Value If NOT successful Carry 1 AH Error Code AL Undefined INT 15h Function AX 5380h Subfunction BH 28h Set COM2 Mux NORAPM Sets the COM2 mux to...

Page 267: ...ay edge unsigned int Width Digitizer long axis length in device units unsigned int Height Digitizer short axis length in device units NOR_PEN_CALIBRATION INT 15h Function AX 5380h Subfunction BH 2Dh G...

Page 268: ...ty Mask 3 0 PC Card Undefined GPIO or DMA 2 1 Pen digitizer Undefined GPIO 2 2 Ethernet Undefined GPIO 3 3 VGA Undefined GPIO 4 4 COM 1 SCAMP GPIO 5 5 Undefined Touch screen GPIO 6 6 COM 2 Keyboard GP...

Page 269: ...turn If successful Carry 0 AH 0 AL Undefined If NOT successful Carry 1 AH Error Code AL Undefined The format of the ETHERNET ID structure is as follows typedef struct UC id 6 the actual ID ETHERID INT...

Page 270: ...rface On Entry AH 53h AL 80h BH 32h BL Port number 0 Port A 1 Port B On Return If successful Carry 0 AH 0 AL Undefined If NOT successful Carry 1 AH Error Code AL Undefined INT 15h Function AX 5380h Su...

Page 271: ...0 AH 0 AL Dock control bit Port number 0 Port A 1 Port B INT 15h Function AX 5380h Subfunction BH 35h Get Wakeup Mask NORAPM This interrupt is a NORAND Proprietary System interface On Entry AH 53h AL...

Page 272: ...t Activity Mask 1 Activity Mask 2 Activity Mask 3 0 PC Card Undefined Reserved 1 Pen digitizer Undefined COM 3 2 Ethernet Undefined COM 4 3 VGA Undefined Internal BCR 4 COM 1 SCAMP SST radio 5 Undefin...

Page 273: ...On Entry AH 53h AL 80h BH 38h On Return If successful Carry 0 DX Millivolts AX FF00h If NOT successful Carry 1 DX 0FFFFh AH Error Code AL Undefined INT 15h Function AX 5380h Subfunction BH 39h Charge...

Page 274: ...rror Code AL Undefined INT 15h Function AH 81h Device Close BIOS Default BIOS returns with AH 0 and carry flag clear On Entry AH 81h BX Device ID CX Process ID On Return If successful Carry 0 AH 0 AL...

Page 275: ...nterval in microseconds ES BX Pointer to byte in calling program s memory with bit 7 set when the interval expires On Return If successful Carry 0 AH 0 AL 0 Function busy Value written to CMOS RAM reg...

Page 276: ...address space to anywhere else in the system address space Memory space not generally available to real mode programs is accessible through this function On Entry AH 87h CX Number of 16 bit words to...

Page 277: ...ment limit is set to 0FFFFh The DS ES and SS descripters are loaded with 0018h 0020h and 0028h respectively The descripters built at these GDT offsets describe the segments that these registers refere...

Page 278: ...ints to request block if AL 80h FFh On Return If successful Carry 0 Wait NOT performed driver completes own wait AH 00h If NOT successful Carry 1 Wait performed I O complete or timeout INT 15h Functio...

Page 279: ...C0h On Return If successful Carry 0 AH 00h Successful ES BX Address of system configuration table If NOT successful Carry 1 AH 86h System model undetermined INT 15h Function AH C1h Return Extended BIO...

Page 280: ...turn normal values return the normal value indicated in the chart Pressing a shift key while in the Caps Lock state causes alphabetical keys to return nonshifted values All other keys defined to retur...

Page 281: ...ard Legend Scan Codes Hex Unshifted AH AL Shifted AH AL Control AH AL Alt AH AL 1 29 29 60 29 7e 2 1 02 02 31 02 21 78 00 3 2 03 03 32 03 40 03 00 79 00 4 3 04 04 33 04 23 7A 00 5 4 05 05 34 05 24 7B...

Page 282: ...L Shift 2A 45 102 Key 56 46 Z 2C 2C 7A 2C 5A 2C 1A 2C 00 47 X 2D 2D 78 2D 58 2D 18 2D 00 48 C 2E 2E 63 2E 43 2E 03 2E 00 49 V 2F 2F 76 2F 56 2F 16 2F 00 50 B 30 30 62 30 42 30 02 30 00 51 N 31 31 6E...

Page 283: ...37 37 2A 37 2A 101 9 PgUp 49 49 00 49 39 84 00 102 6 Right 4D 4D 00 4D 36 74 00 103 3 PgDn 51 51 00 51 33 76 00 104 Del 53 53 00 53 2E 105 4A 4A 2D 4A 2D 106 4E 4E 2B 4E 2B 108 Enter pad E0 1C 1C 0D...

Page 284: ...ting on page 6 105 for returned character codes On Entry AH 00h On Return AX Character code INT 16h Function AH 01h Return Key Buffer Status BIOS If the keyboard buffer does not contain a key this fun...

Page 285: ...fault first repeat delay is 14 or about 0 77 second The default repeat time is 3 or about 0 17 second On Entry AH 03h AL 05h BH First repeat delay in system timer ticks BL Repeat time in system timer...

Page 286: ...nt flag settings For those Alt character combinations that INT 09h loads an F0h into the low character byte this could create some PL N compatibility issues since the scan code returned in the AH regi...

Page 287: ...4 Scroll Lock state Bit 3 Alt Shift Bit 2 Ctrl Shift Bit 1 Left shift Bit 0 Right shift INT 16h Function AH FEh Swap Keyboard Translate Tables 4000API On Entry AH 0FEh ES BX Address of new keyboard t...

Page 288: ...b 1 ESCAPE 0 CR shifted 25 key table db TUP TDWN TLEFT LITE db 1 EXIT db 1 LSHFT TDEL CLEAR db 1 7 8 9 db 1 4 5 6 db 1 1 2 3 db 1 ESCAPE 0 CR INT 16h Function AH FFh Return Number of Keys on Default K...

Page 289: ...ocessed by INT 08h Interrupts are disabled while the timer tick is read to prevent update during access to the memory locations The timer overflow flag returned in AL is reset to zero when this functi...

Page 290: ...59 DH Seconds in BCD 0 59 DL Daylight Savings Time option 0 No Daylight Savings Time 1 Daylight Savings Time If NOT successful Carry 1 INT 1Ah Function AH 03h Set Real Time Clock Time BIOS Writes the...

Page 291: ...urn If successful Carry 0 CH Century in BCD 19 or 20 CL Year in BCD 0 99 DH Month in BCD 1 12 DL Day in BCD 1 31 If NOT successful Carry 1 INT 1Ah Function AH 05h Set Real Time Clock Date BIOS Writes...

Page 292: ...issued If calling program needs control passed to it it must place interrupt handler address in vector for INT 4Ah User routine must save and restore all registers and preserve machine state If hour...

Page 293: ...ss bit to become zero and disable interrupts before accessing the CMOS data On Entry AH 09h On Return If successful Carry 0 CH Hours in BCD 0 23 CL Minutes in BCD 0 59 DH Seconds in BCD 0 59 DL 1 Alar...

Page 294: ...et Status BL Current PM status If Power Function Enable Disable Power BL New PM status AX Connection Status 0 Successful 2 Already connected 3 Already disconnected Idling cannot be enabled with this c...

Page 295: ...e hardware and software and returns the status On Entry AH 00h AL 00h On Return AX 1 Successful 0 Failed BX Number of buttons INT 33h Function AX 0001h Show Cursor MOUSE On Entry AH 00h AL 01h On Retu...

Page 296: ...r button status BX Number of presses since last call CX X coordinate at last press DX Y coordinate at last press INT 33h Function AX 0006h Get Button Release Information MOUSE Gets the current status...

Page 297: ...raphics Cursor Block MOUSE On Entry AH 00h AL 09h On Return None INT 33h Function AX 000Ah Set Text Cursor MOUSE On Entry AH 00h AL 0Ah On Return None INT 33h Function AX 000Bh Read Motion Counters MO...

Page 298: ...n AX 000Eh Light Pen Emulation Mode Off MOUSE No action taken On Entry AH 00h AL 0Eh On Return None INT 33h Function AX 000Fh Set Mickey to Pixel Ratio MOUSE On Entry AH 00h AL 0Fh On Return None INT...

Page 299: ...es status of driver On Entry AH 00h AL 16h BX Size of buffer needed to store driver status See note ES DX Buffer to store driver status On Return ES DX Buffer for driver status copied from status bloc...

Page 300: ...019h Get User Alternate Interrupt Address MOUSE On Entry AH 00h AL 19h On Return AX 0 BX 0 CX 0 DX 0 INT 33h Function AX 001Ah Set Mouse Sensitivity MOUSE On Entry AH 00h AL 1Ah On Return None INT 33h...

Page 301: ...ge Number MOUSE Gets current active page number On Entry AH 00h AL 1Eh On Return BX 0 INT 33h Function AX 001Fh Disable Mouse Driver MOUSE Disables the mouse driver On Entry AH 00h AL 1Fh On Return AX...

Page 302: ...s driver version mouse type and IRQ number On Entry AH 00h AL 24h On Return BX Version CH 0 CL IRQ Real Time Clock INT 70h BIOS This interrupt handler controls the periodic and alarm interrupt functio...

Page 303: ...Active Page Down 07h 6 35 Read Character and Attribute at Cursor Position 08h 6 35 Write Character and Attribute at Cursor Position 09h 6 36 Write Character Only at Cursor Position 0Ah 6 36 Set Color...

Page 304: ...Configuration Information 12h 10h 6 47 Set Scan Lines 12h 30h 6 48 Enable Disable Default Palette Loading 12h 31h 6 48 Enable Disable Video 12h 32h 6 48 Enable Disable Gray Scale Summing 12h 33h 6 48...

Page 305: ...Character 01h 6 62 Receive a Character 02h 6 62 Read Communications Port Status 03h 6 62 Extended Initialize 04h 6 63 Read Modem Control Port 05h 6 64 Write Modem Control Port 05h 6 64 Get Extended Er...

Page 306: ...75 APM Installation Check 53h 00h 00h 00h 6 75 APM Real Mode Interface Connect 53h 01h 00h 00h 6 76 APM Interface Disconnect 53h 04h 00h 00h 6 76 CPU Idle 53h 05h 6 77 CPU Busy 53h 06h 6 77 Set Power...

Page 307: ...53h 80h 33h 6 94 Get Dock Port Control 53h 80h 34h 6 95 Get Wakeup Mask 53h 80h 35h 6 95 Get Activity Mask 53h 80h 36h 6 96 Main Battery Voltage 53h 80h 37h 6 96 Backup Battery Voltage 53h 80h 38h 6 9...

Page 308: ...turn Number of Keys on Default Keyboard FFh 6 112 19h System Reboot 6 112 1Ah Timer and Real Time Clock Services AH AL BH BL Read System Timer Ticks 00h 6 113 Set System Timer Ticks 01h 6 113 Read the...

Page 309: ...et Mickey to Pixel Ratio 00h 0Fh 6 122 Conditional Off 00h 10h 6 122 Set Double Speed Threshold 00h 13h 6 122 Swap Interrupt Subroutines 00h 14h 6 123 Get Status Block Size 00h 15h 6 123 Save Driver S...

Page 310: ...SECTION 6 Conversions and Interfaces 6 134 PEN KEYR 6200 6300 Hand Held Computer Programmer s Reference Guide 6 Conversions and Interfaces...

Page 311: ...Booting or Resetting 7 8 Master Mode Boot Sequence 7 8 Memory Map Flash Memory Vs Shadow RAM 7 9 Boot Drive Selection 7 9 H8 Downloads H8PROG EXT 7 9 System Information Tables 7 10 List of Tables Pag...

Page 312: ...XMS manager that supports the upper memory functions must be loaded A simple XMS driver named UMP SYS is available for using shadow RAM as upper memory UMP SYS is much smaller and simpler than EMM386...

Page 313: ...mands are available command The command prefix prevents a single line from being echoed as it is executed label The command prefix defines labels within ROMINIT BAT for use with the GOTO command Since...

Page 314: ...r MiniCMD which in turn restarts MiniCMD Every time MiniCMD is executed it looks for and executes ROMINIT BAT You do lock up if you attempt to execute another batch file by name either in ROMINIT BAT...

Page 315: ...is known as BIOS shadowing The RAM used in this process is called shadow RAM Shadow RAM is different from conventional memory in that a hardware mechanism prevents the shadow RAM from being modified o...

Page 316: ...efaults It also records in EEPROM that a cold boot has occurred Since the standard power on defaults do not include a RAM drive no RAM drive is present after a cold boot In standard PCs the CMOS RAM i...

Page 317: ...ithout making any other system changes After the BIOS has finished scanning for all BIOS extensions it issues an interrupt 19h to boot the system At this point ROM DOS 5 displays its startup message a...

Page 318: ...cycle The rest of memory is reconstructed as part of the tests that were performed For example only that extended memory which was not allocated to the RAM drive is reset when extended memory is teste...

Page 319: ...media is present and the drive is ready it becomes the default drive Note that this test applies only to drives A and B since they are the only drives that are associated with removable media When the...

Page 320: ...00 FCFFFF 15 KB ROM drive FD0000 FD57FF ROMDOSHI BIN 22 KB ROM DOS not shadowed FD5800 FEFFFF 106 KB of ROM drive FF0000 FF99FF ROMDOSLO BIN 38 5 KB ROM DOS 5 F0000 F99FF FF9A00 FFAFFF 5 5 KB ROM driv...

Page 321: ...e RAM drive but left the CMOS intact This can occur when swapping batteries and backup battery is either bad or missing Application download required unless application was not stored on RAM drive Mup...

Page 322: ...3 First 64K of system RAM is not operating correctly 3 4 3 LCD cannot be enabled 4 2 3 Cannot enable A20 using port 64h see Note standard keyboard port 4 2 4 Cannot enable A20 using port 92h see Note...

Page 323: ...exception 07h Processor Invalid opcode 08h IRQ0 Processor Timer interrupt handler Double exception 09h IRQ1 Processor Keyboard interrupt handler Coprocessor segment overrun 0Ah IRQ2 Processor Slave c...

Page 324: ...9 SCAMP configuration disable register 0FB SCAMP configuration enable register 108 16F Reserved for PC Card general use 170 177 Reserved secondary hard disk controller 178 1EF Reserved for PC Card gen...

Page 325: ...facto industry standard defines most of the variables on which a ROM BIOS must operate In the following table the entries that are unique to the NORAND BIOS are italicized and bold The remaining entr...

Page 326: ...of fixed drives 40 76 Byte Reserved fixed disk control byte 40 77 Byte Reserved fixed disk port offset 40 78 4 bytes Reserved printer timeout table 40 7C 4 bytes Serial timeout table 40 80 Word Offse...

Page 327: ...specified register The first few registers are real time clock registers In the list that follows register definitions that were created for use by Intermec Technologies Corporation are italicized an...

Page 328: ...y size CMOS_XTD_MEMHI 18h CMOS_FDISK1_TYPE 19h CMOS_FDISK2_TYPE 1Ah CMOS_CHKSUM_HI 2Eh Checksum for 10h 2Dh CMOS_CHKSUM_LO 2Fh CMOS_POST_XTD_MEMLO 30h Posted extended memory size CMOS_POST_XTD_MEMHI 3...

Page 329: ...er P O Box 7641 Mt Prospect IL 60056 7641 800 548 4725 ISBN 241704 001 Handwriter Recognition System for Windows User s Guide Communication Intelligence Corp CIC Intermec P N 961 054 001 Handwriter Re...

Page 330: ...ted to AFS you can simply perform standard Unix VMS whatever directory listing and file copies from the above directory On FIDOnet from SoundingBoard BBS 1 129 26 1 412 621 4604 9600 14 4k HST V32 as...

Page 331: ...Distribution Network system CompuServe In the IBM Programming Forum GO IBMPRO Library 6 as INTrrA INTrrB INTrrC and INTrrD The list is also posted to USEnet in comp binaries ibm pc about twice a year...

Page 332: ...and Peripheral Data Volume II DL139 Motorola Literature Distribution P O Box 20912 Phoenix AZ 85036 Mup System Interfaces Intermec Technologies Corporation ISBN 212 005 001 H8FMW ABS PCMCIA Controlle...

Page 333: ...L N Application A 2 CONFIG SYS with Device Driver Configurations A 2 AUTOEXEC BAT Listing for 6200 A 5 ROMINIT BAT Listing for 6200 A 5 Sample Boot Configurations for 6300 A 6 CONFIG SYS Listing A 6 A...

Page 334: ...EVICE D NORAPM EXE DEVICE D NPOWER EXE ID 4 BB 50 B1 30 B2 30 B3 30 AC FF CF F6 DEVICE D CLOCK EXE REM REM THE FOLLOWING DRIVERS TSRS ARE NEEDED BY THE APPLICATIONS DEVICE PC4800 SYS LPT1 1 I1 INSTALL...

Page 335: ...CardSoft to manage PC Card devices rem device d ump sys X D000 D400 D800 DC00 REM The exclude switches above are additive Therefore if both NGENMOD SYS REM and CardSoft are used rem device d ump sys X...

Page 336: ...e ATA card should use the same REM drive letters that the ATA card uses Omit this parameter if no more REM memory device support is loaded REM REM If SRAM card support is desired through CARDSOFT and...

Page 337: ...d this problem If you load either EMM386 or UMP and claim REM segment C800 as upper memory then drive A and B access is effectively REM disabled See CONFIG SYS for details rem d assign com a e b f REM...

Page 338: ...ing MINICMD instead of REM COMMAND COM The ECHO state when you exit determines whether or not REM the prompt is displayed Echo on Sample Boot Configurations for 6300 CONFIG SYS Listing The following i...

Page 339: ...ently find the available ranges REM HIMEM SYS must be loaded before EMM386 EXE REM Without CARDSOFT rem device emm386 exe i B000 B7FF x C800 EFFF 1024 ram frame E000 REM With CARDSOFT rem device emm38...

Page 340: ...loaded REM If SRAM card support is desired through CARDSOFT and not SANDISK REM support omit line 4 Please note the PEN KEY BIOS can read SRAM cards REM without CARDSOFT The SRAM cards then are seen a...

Page 341: ...d mininet exe REM NPCP PRINTING AND COMMUNICATIONS REM ___________________ MOUSE AWARE DOS APPS ________________________ REM Load the pen driver for DOS based non PenRight applications 63mouse C REM c...

Page 342: ...Recognizer mars dll Dictionary List MAINDICT DLL Recognizer List MARS DLL MsSpell MSSPELL DLL MsMainDict enuMain User List User 1 sysges C xx 0 Ctrl Ins P xx 0 Shift Ins X xx 0 Shift Del U xx 0 Alt Bs...

Page 343: ...support It is disabled by default npcp nornpcp drv This driver is needed to provide IrDA printing support It is disabled by default irda norirda drv Power Driver Indicates how often to repeat warnings...

Page 344: ...to synchronize the clock on the HHC with a remote system s clock Use of this setting is recommended only for debugging Add 256 to the entry to enable this option Bits 4 7 and 9 15 are currently undef...

Page 345: ...usNotification TRUE EnableScannerWhenDriverLoads controls when the scanner is enabled If TRUE scanner is enabled when it is loaded by Windows and is always active until Windows shuts down This option...

Page 346: ...s are 0 3 The Receive interrupt trigger is Chip dependent On 550 UART setting a value of 0 causes Chip to interrupt on every character However on an ST650 UART this implies interrupt on every 8 charac...

Page 347: ...o causes the DOS clock to lose time when sounds are played NORAPM DLL fixes this by correcting the DOS clock every 10 seconds or so Leave interrupts enabled 0 keyboard subtype type 4 keyboard dll oema...

Page 348: ...ce biosxlat device vcd device vmcpd device combuff device cdpscsi local CON FileSysChange off COM3 is where the PCMCIA modem installs if using one COM3Irq 10 COM3Base 03E8 The following fonts are requ...

Page 349: ...sounds are played when Windows starts and quits SystemStart tada wav Windows Start SystemExit chimes wav Windows Exit These sounds are played when A C is connected and disconnected ApmAcOn tada wav A...

Page 350: ...f Times Times New Roman Helvetica Arial TrueType Sounds SystemDefault ding wav Default Beep SystemExclamation chord wav Exclamation SystemStart tada wav Windows Start SystemExit chimes wav Windows Exi...

Page 351: ...0 NORAND 6805 LPT2 DOS Paper Size 256 Paper Length 1450 Paper Width 480 Size Unit 1 PrinterPorts NORAND 4800 NOR4800 LPT1 DOS 15 45 NORAND 6805 NOR6805 LPT2 DOS 15 45 devices NORAND 4800 NOR4800 LPT1...

Page 352: ...e sure the card is set up IF EXIST E AUTOEXEC BAT GOTO CONTINUE REM If files are not on the card then assume the application files were REM downloaded to the RAM drive using the Norand Utilities progr...

Page 353: ...tes as Activity D VACTIVE D REM Load the pen driver 63MOUSE COM or SET APIRSC 63MOUSE RSC REM Calibrate if required ECHO PRESS 1 TO CALIBRATE CALIB REM Run the sample PENRIGHT program penr api e k x 3...

Page 354: ...0 6300 Hand Held Computer Programmer s Reference Guide rem Run the sample PEN PAL program PPCP6300 RUN EXAMPLE PENDOSEM BAT Code echo off rem 1 is the prefix for all files here LH 1VLOAD 1USAREC EXP L...

Page 355: ...ce code listing Keyboard Remapping Program B 7 Sample program demonstrating a method for remapping keyboard with source code listing Critical Error Handler B 12 Sample program showing how to handle cr...

Page 356: ...s reserved BYTE LineStatus AC line status bits 00H Off line 01H On line 02H On backup power FFH Unknown All other values reserved BYTE BatteryCharge of battery left 0 100 Percentage of full charge FFH...

Page 357: ...unsigned int State Sets APM BIOS device Device to power state State Returns PWR_FAIL for failure No APM unsupported device or power state or PWR_OK for success extern C int FAR PASCAL _export SetPowe...

Page 358: ...detect define APM_OEM_RESUME 0x020a Resume key detect define APM_OEM_BUBLOW 0x020b Backup battery low define APM_OEM_MB0 0x020c Main battery critical define APM_OEM_MB10 0x020d 10 minutes left on bat...

Page 359: ...press define PWR_OEM_BATT_CHANGE 0x0214 Battery change detected define PWR_OEM_PWRFAILNEW 0x0215 Powerfail detected define PWR_OEM_PWRMSGTXT 0x027F Power message text broadcast APM BIOS standard devic...

Page 360: ...g NorAPM library instance tagPOWER_STATUS PwrStat Holds current power status WORD Error Holds error codes char MsgBuf 100 Message buffer pragma argsused int PASCAL WinMain HINSTANCE hInstance HINSTANC...

Page 361: ...ude files are presented on the following pages Include File SMM H define MBC 0x80 Multiple byte command define RD_EVENT 0x01 define SMM_SUSPEND 0x02 define DEV_ENABLE 0x20 define DEV_DISABLE 0x40 defi...

Page 362: ...e File REMAP C remap c This program calls two functions 1 DownloadKBD To remap the keys 2 DownloadMacros To map the key macros when gold key is used define UC unsigned char define ULI unsigned long de...

Page 363: ...l dx grx UI GetData ASM xor cx cx Clear any message mov dx 201h gd in al dx mov ah al or ah 80h test al 1 loopz gd jcxz gdx test al 4 jnz gdx and ah not 80h dec dx in al dx gdx UI MupCom UC clen UC _f...

Page 364: ...0 0 0 0 0 0 0 0 UC F7 0x41 0xf0 0xc1 0 0 0 0 0 0 0 0 0 UC F8 0x42 0xf0 0xc2 0 0 0 0 0 0 0 0 0 UC F9 0x43 0xf0 0xc3 0 0 0 0 0 0 0 0 0 UC F10 0x44 0xf0 0xc4 0 0 0 0 0 0 0 0 0 UC F11 0x57 0xf0 0xd7 0 0 0...

Page 365: ...t bit 5 1 no key repeat bit 6 1 Non gold shift plane system event key This causes the key code value received to be sent to the host as a system event rather than a keyboard interrupt Bits 2 4 and 5 a...

Page 366: ...0x18 0x20 53 ROW 5 O 0x11 0x20 54 ROW 6 W 0x35 0x20 55 ROW 7 COL 7 0x2b 0x20 40 ROW 0 0x27 0x20 41 ROW 1 0x28 0x20 42 ROW 2 0x1d 0x30 43 ROW 3 cntl 0x23 0x20 44 ROW 4 H 0x19 0x20 45 ROW 5 P 0x2d 0x02...

Page 367: ...union fncptr FAR void fnc struct faddr addr FP struct devhdr fncx void set24h fnc FP void fnc asm xor ax ax mov es ax mov bx 24h 4 mov ax bp 4 mov dx bp 6 cli mov es bx ax mov es bx 2 dx sti endasm dr...

Page 368: ...nnection Retry n break case RXTMO scr_printf Printer not transmitting Check connection Retry n break case TXTMO scr_printf Printer not receiving Check connection Retry n break case BADADR scr_printf M...

Page 369: ...am3 tdelay 10000 break case PAPEROUT scr_printf Printer paper out Retry n break case LOWVOLTS scr_printf Printer low voltage Retry n break case HIVOLTS scr_printf Printer over voltage Retry n break ca...

Page 370: ...ent Implementation Installing the WANPOWER TSR General Environment Some radios do some of their own power management some do not Applications developed at Intermec Technologies Corporation are radio p...

Page 371: ...Place the radio in a minimum power state Idle radio Place the radio in an idle state This state may not differ from the default state but is included because APM can send an idle message Initiate rad...

Page 372: ...ity that is transmission or reception To monitor battery status the following System Interface Functions are used Function Description ReadMBVoltage 10 second average main battery voltage GetFuel Func...

Page 373: ...red by battery temperature or combination Unfortunately no amperage value is available 30 minutes Application activity period How long WANPOWER holds PEN KEY HHC up in anticipation of application acti...

Page 374: ...erval are provided Where possible these defaults are based on the installed radio Enter WANPOW ER at the command prompt for this option If WANPOWER is already installed it displays its current paramet...

Page 375: ...up to run in a Windows environment the next item loaded is Windows Finally the user selects an application to run which the system loads into the RAM Standard PC Memory Overview While installing prog...

Page 376: ...84 KB of memory for UMA Extended Memory Above UMA and includes HMA To access extended memory add device d himem sys to the CONFIG SYS file where d is the drive and directory where HIMEM SYS exists The...

Page 377: ...data are stored on the hard drive DOS BIOS Windows Application Work Space 4MB 3MB 2MB 1MB Figure B 2 Desktop Laptop PC with Hard Disk The application and all DOS Windows software components are loade...

Page 378: ...6000 Series computer the RAM is powered continuously Consequently the RAM disk retains its contents over long periods of time NOTE In the illustrations 4 or 8 MB memory models are shown Keep in mind...

Page 379: ...aged PC The main drawbacks to enhanced mode are slower execution speed and larger code size Despite its name the enhanced mode is the slower of the two modes and the size of the Windows code required...

Page 380: ...osoft Windows The design for the Windows environment was born out of the need for a better user interface The Macintosh environment had gained significant popularity with many potential customers who...

Page 381: ...al Applications DLLs INIs APIs Additional Windows Files optional Handwriting Recognition Pen Windows Minimal Windows System Files Windows Drivers DOS DOS Drivers BIOS Hardware The following paragraphs...

Page 382: ...t the keyboard your key presses are changed into binary strings and sent to the BIOS When the BIOS receives the string it sets an interrupt to alert the CPU that it has data to be processed All of thi...

Page 383: ...Computer requires at least one device driver HIMEM SYS to control access to the high memory area HMA the first 64K RAM above the 1 MB boundary Other DOS device drivers may be loaded depending on the...

Page 384: ...peripherals that the application uses Applications DLLs INIs APIs Additional Windows Files optional Handwriting Recognition Pen Windows Minimal Windows System Files Windows Drivers DOS DOS Drivers BIO...

Page 385: ...ly its own code to interact with the display and other peripherals Windows applications need only conform to the general parameters of the device The intricacies of dealing with the device are handled...

Page 386: ...peripherals Windows does not allow the application to access the hard ware directly that is the job of the device driver By following this approach the application does not need to concern itself wit...

Page 387: ...when it is need ed and is removed when its job is done DOS subroutines are bound to the DOS application program If two programs on a DOS PC use the same subroutine each of the DOS programs contains it...

Page 388: ...information such as where the fonts are lo cated how the windows need to look the speed of the mouse etc Many applica tions create sections of their own within WIN INI as well A thorough treat ment of...

Page 389: ...r unless you are able to determine exactly which files the application is expecting to have available on the disk For assistance in determining what these files are in reference to an application that...

Page 390: ...s Windows applications include the main executable program with the EXE ex tension the device driver files with the DLL extension and other files that are required for the main program to execute Appl...

Page 391: ...S Drivers BIOS Hardware Pen Windows adds only a few files to the standard Windows configuration Basic added functionality includes enabling pen input for non pen aware applications and handwriting rec...

Page 392: ...nce Corp CIC from Intermec Technologies Corporation at additional cost NORAND Value Adds In addition to Windows specific value added software provided by Intermec Technologies Corporation there are se...

Page 393: ...able in the PEN KEY 6000 Series Computer Communications protocols included within this application are NPCP Communications Drivers IrDA Communications Drivers TTY Communications Drivers NOTE ACN is NO...

Page 394: ...and disk stor age space It is best to first determine the amount of execution space need ed and then use the balance for the RAM drive Of course the RAM drive must be large enough to contain DOS Wind...

Page 395: ...30 files required to boot from a disk 7 2 master mode boot See Master mode boot process 7 5 standard boot cycle 7 8 Booting cold booting 7 5 files for 1 5 from a RAM drive 1 24 from an SRAM card 1 24...

Page 396: ...des error handling IrDA 3 39 NPCP 3 31 numeric responses modem 5 16 power management APM BIOS 4 13 during installation 3 12 printing IrDA 3 41 NPCP 3 35 protocol errors MININET 5 14 NPCP 5 13 PC Card...

Page 397: ...tiplex Handle 2 11 Windows Release Virtual Machine Time Slice 2 11 INT 74h ISR Touch Screen Interrupt 2 11 interrupts support by NORAPM EXE 2 11 Interrupts driver support APM NORAPM 2 12 APM NPOWER 2...

Page 398: ...ypes 1 4 booting to 1 13 custom flash creating 1 14 device driver for 1 24 files INTERMEC 1 23 IFL card creation 1 8 1 9 input output 1 4 installation custom 3 2 locating slots 1 20 Master mode boot 1...

Page 399: ...pecial paper handling 3 34 usage communication port 3 30 Processor speed 1 4 1 19 type 1 3 Programs sample See Sample Programs Proprietary system interfaces 2 13 NORAND interrupts 2 13 Protocols error...

Page 400: ...2 H8 downloads H8PROG EXT 7 9 hardware connector pin outs COM1 7 13 IRQ interrupts 7 13 ports 7 12 I O addresses 7 14 master mode boot sequence 7 8 memory map flash versus shadow 7 10 MiniCMD alternat...

Page 401: ...B 22 B 29 CPLNI COM 6 4 CRC32 EXE 1 5 CRITICAL C 2 19 B 12 CS EXE 1 23 CS_APM EXE 1 23 CSALLOC EXE 1 23 CSALLOC INI 1 23 5 33 CUSTOM BAT 1 14 D DD EXE 1 9 1 11 1 14 1 33 1 35 DDEML DLL 3 6 DELAY EXE 1...

Page 402: ...OM0C EXE 5 2 5 3 5 8 5 12 version 2 xx 5 3 version 3 xx 5 3 R RAMDFMT CTL 1 26 RAMDFMT EXE 1 26 README TXT 1 9 RELNOTES TXT 2 1 5 1 9 1 10 1 23 REMAP C B 7 B 8 REMAP EXE 5 32 RESET EXE 1 14 1 24 1 35...

Page 403: ...al Display Size Return 6 51 Set 6 49 Read Write Contrast 6 51 Return Pointer to Current Display Pa rameters 6 50 Set Mode Chase 6 51 Fixed 6 51 Set Scan Lines 6 48 Video Screen Off On 6 49 APM Event P...

Page 404: ...imum INT 33h Set x Position 6 120 Set y Position 6 121 Read INT 10h Character and Attribute at Position 6 35 Position Type 6 33 Set Graphics Block INT 33h 6 121 Position INT 10h 6 33 Position INT 33h...

Page 405: ...Read Memory Size INT 15h 6 101 Next ASCII Character INT 16h 6 110 Shift Status INT 16h 6 111 Return BIOS Area Data Segment INT 15h 6 103 Key Buffer Status INT 16h 6 110 Set Zero Flag if Key Buffer Emp...

Page 406: ...ze INT 15h 6 101 Size Determination INT 12h 6 53 Message INT 15h Mailbox Accept from no pend 6 68 Post to 6 68 Queue Accept from no pend 6 69 Post to 6 69 Mickey INT 33h Set to Pixel Ratio 6 122 Minim...

Page 407: ...e 6 64 Read Communications Status INT 14h 6 62 V25 Comparator INT 15h 6 72 Position Character and Attribute at Cursor INT 10h Read 6 35 Write 6 36 Cursor Read and Type INT 10h 6 33 Set INT 10h 6 33 Se...

Page 408: ...Get 6 42 Set 6 41 Power INT 15h Get 6 81 Set 6 78 Return Current Video INT 10h 6 38 Status Driver INT 33h Restore 6 123 Save 6 123 Get Block Size INT 33h 6 123 Button and Mouse Position INT 33h 6 119...

Page 409: ...Active Page 6 34 User Get Alternate Interrupt Address INT 33h 6 124 Load Font INT 10h 6 43 V V25 INT 15h Read Comparator Port 6 72 Values INT 10h Set Gray Scale 6 42 Verify INT 13h Disk Sectors 6 56 V...

Page 410: ...INTERRUPTS INDEX Index 16 PEN KEYR 6200 6300 Hand Held Computer Programmer s Reference Guide...

Search results

Summary of Contents for 6300 SERIES

Reviews:

Related manuals for 6300 SERIES

Brands by name

Popular brands

Intermec 6300 SERIES, Programmer'S Reference Manual

Search results

Summary of Contents for 6300 SERIES

Reviews:

Related manuals for 6300 SERIES

Brands by name

Popular brands