Casio IT-2000W manuel d'utilisation

IT-2000W (Window s version) T echnical Reference Manual (V ersion 1.00 ) A pril 1998 Casio Computer Co., Ltd. Copy right ©1998. All rights r eser ved.[...]

2 Table of Contents Preface 5 Chapter 1 Overview 6 1.1 Features of System 6 1.1.1 Development Concept 6 1.1.2 Hardware 6 1.1.3 Software 6 1.1.4 Basic Specifi cat ions 7 1.1.5 Model Name 8 1.2 System Configuration 9 1.2.1 Hardw are Block Diagram 9 1.2.2 Supported Softw are 10 1.3 Precautions 13 Chapter 2 Basic Softw are 16 2.1 Overview 16 2.1.1 Soft[...]

3 3.10 Y M ODEM Utility 61 3.11 FLINK Command 65 3.12 S y stem Date/ T ime Setup 68 3.13 Command Prompt 69 3.14 R A M Disk Siz e Change 70 3.15 Disk Format 72 3.16 S y stem Initialization 74 3.17 Pass w ord Entry 75 Chapte r 4 M S-DOS 76 4.1 O v er v iew 76 4.2 How t o Write CONFIG.SY S and A U T OEXEC.B A T 78 4.3 Card Boot 81 Chapte r 5 M S-Windo[...]

4 8.4.2 Debugging Through Simulation 147 8.4.3 Operation Check on IT- 2000 (Using COM2KEY /XY) 149 8.4.4 Installation of A pplication Program 150 8.5 Simulation Driver 152 8.5.1 System Driver Simulator (SysCall.DLL) 153 8.6 Library 157 8.6.1 Overv iew 157 8.6.2 System Library 158 8.6.3 Keypad Library 196 8.6.4 OBR Library 213 Setting Operation M od[...]

5 Preface The IT- 2000 Technical Reference Manual (hereinafter referred to as this document) is provided to assist the user in developing programs to run on the Casio I T-2000 (hereinafter referred to as this terminal or I T-2000 or HT). Microsoft C/C++ Ver.7.0 or later, and the manuals supplied with it, is required to develop programs for this ter[...]

6 1. Ov erview 1.1 Features of Sy stem 1.1.1 Dev elopment Concept The IT-2000 is a data collection term inal for business use. After years of refinem ent Casio Computer Co., L td. has developed its hand-held ty pe terminals so that they yield high speed and a high functionality in com parison to general personal computers. This allows improved effi[...]

7 PC card slot conforms to PCMCIA Release 2.1 supporting various PC cards. Im plements IrDA 1.1 protocol for high- speed infrared communication. System menu makes it easy to maintain the I T-2000 and install user application programs. Provides various developm ent support tools including C-language libraries and comm unication utilities for develop[...]

8 1.1.5 Model Name The following IT-2000s of Windows version will be av ailable. For price of each model, please consult with y our local Casio representative. Model RAM FlashROM Total Remark IT- 2000W20 4 Mby tes 4 Mbyt es 8 Mbyt es IT- 2000W30 4 Mby tes 8 Mbyt es 12 Mbyt es IT- 2000W40 4 Mby tes 12 Mbyt es 16 Mbyt es IT- 2000W50 4 Mby tes 16 Mbyt[...]

9 1.2 Sy stem Configuration 1.2.1 Hardw are Block Diagram CPU i486GX 1 Power switch A/D converter Buffer DRAM F LASH ROM (DI NOR) BIOS/ DOS MASK ROM Lithium -ion battery Secondary sub- battery Primary sub- battery IrD A Driver/Receiver RS-232C driver PC card slot IrD A 1 . 1 IrD A 1 . 0 16550 PC card controller Analog touch panel Key board controll[...]

10 1.2.2 Supported Softw are The software used with this terminal can be div ided into two categories: the system software that includes the BIOS, OS, and dev ice drivers and the user software such as the developm ent tools. The system software is stored on the DINOR F LASH RO M (1 MB), and the user software is supported from the SDK CD-ROM (versio[...]

11 TFORMAT.E XE Basic drive (C:) F-ROM drive formatter Window s Driver These drivers are necessary for the Windows to run on IT-2000. Download to F -ROM driv e (D: ). File nam e Storage location Description VGA_C.DRV VGA_NC.DRV MASK ROM driv e (E: ) Display drivers PENMOUSE.DRV SDK Mouse dri ver VKD.386 SDK Virtual key driv er IRDA.DL L IRCOM M.DRV[...]

12 Development Tool Libraries All the libraries of Windows are provided either as Dy namic L ink Library (DLL ) or as Visual BASIC Custom Control (VBX). To use these libraries, download first to a directory in F -ROM drive (D: ). The files, * .LIB and * .H, are needed when y ou develop an application program. File nam e Storage location Description[...]

13 1.3 Precautions If reading the internal clock with I NT21h the significant data should include and be limited to the seconds digits. On thi s terminal the tim e is read directly from the RTC so that the correct time can be attained at any mom ent, even during extended continuous use. As a result the 1/100 of a second digit is ignored. (refer to [...]

14 If an L B1 event (low main battery voltage) occurs, the alarm buzzer starts sounding and sy stem operation is suspended about 10 minutes later. I f the alarm buzzer starts sounding, terminate the current operation as soon as possible and recharge the main battery . This system will not execute an alarm indication to be displayed on the L CD scre[...]

15 The backlight is turned off by m eans of the ABO (Auto Backlight OFF ) function. However, it is turned off 1.3 seconds after the setup time. This is because the sy stem has 1.3 seconds of monitoring tim e before the internal timer is started. During the process of loading Windows after boot-up, do not press the Power switch. Do not press the Po [...]

16 2. Basic Softw are 2.1 Ov erview 2.1.1 Softw are Configuration The following diagram shows the software configuration of the IT-2000W. F i g . 2 . 1 SysCall.DLL Li bS Y SW. LIB Application Program L ibOBRW.L IB PADCTRL.VBX PenMo use.drv OBRL IB.D LL Handy Term inal Original Hardwar e & RO M BIOS Li bY M OD . LIB YMODEM .DL FLINK.DLL Mouse Ev[...]

17 2.1.2 Memory Map The mem ory m ap of the IT-2000 is as follows. F i g . 2 . 2 Extended Memory ROM BI OS NAND DISK BIOS/ VGA BIOS Memory Mapped Disk I/F 100000h 0F0000h 0E0000h 0DC000h 0D8000h 0C8000h 0C0000h 000000h 0A0000h PC Card I/F EMS Windows 16 KB x 4 Reserved Video Buffer 128 KB Syst em RAM 640 KB[...]

18 2.1.3 Driv e Configuration The drive configuration differs for each m odel as described in the following table: RAM disk Driv e A: [Read and Write] This drive is prepared for use after the RAM disk size is specified from the System Menu. The contents of this RA M disk will not be erased through a boot process or by pressing the RESET sw itch. Ba[...]

19 2.2 Basic Sy stem Operation 2.2.1 Ov erv iew Basic operation of this system on the terminal consists of the suspend/resume process and boot process operated by m eans of the Power switch and RESET switch, as shown in the following diagram. Fi g. 2.3 During normal operation the sy stem status will move between the ON state and the OFF state, show[...]

20 The following table summ arizes the power-on processes provided for this term inal. System Menu boot process Alway s exec utes CONF IG.SYS and AUTOEXEC.BAT loca ted in drive (C:) for starting up the MS- DOS. Application boot process Searches for CONFI G.SYS and AUTOEXEC.BAT prepared by the user and starts up MS- DOS from the drive where they are[...]

21 2.2.2 Pow er ON Process Overv iew The ON process is provided to make the sy stem ready for use (ON state). The actual process varies depending on the settings at that point in time and the last OF F factor (the cause of the OF F action). ON factors: Pressing the P ower switch Pressing the RESET sw itch Power ON alarm Reception of RING signal Mou[...]

22 System Menu Boot Process Press the RES ET switch to set the drive C as the current drive, and load MS-DOS from that drive. As a result, the System Menu that includes the maintenance program will be initiated (refer to “Sys tem Menu Boot Process” on this page). Resume Process This process restores the conditions that existed before the power [...]

23 Note: The RESE T switch can be used not onl y for initiating the S y ste m Menu but also as the forced restart switch when the user application progra m under develop m ent hangs. Howev er, note that if the RESET switch is pressed while the disk is being written to, the data m a y be corrupted. Therefore, the RESET switch should be pressed onl y[...]

24 This terminal has the Auto Power O N function which automatically starts the system . This A uto Power ON function can operate in one of the following three way s: Auto Pow er ON function (only aff ects the resume process) activated by alarm The system power can be turned on (resumed) at the specified tim e by means of an alarm . However, this w[...]

25 2.2.3 Pow er OFF Process Overv iew Turns off the system power. However, the power to all the dev ices is not turned off and some can be used for storing the information required for the next resum e operation. This process is called the suspend process and the state of the system while off is called the suspend state. The suspend process can be [...]

26 OFF Factors The OFF factors refer to various causes that make the sy stem enter the OFF state (suspend state), as follows: OFF factor Description Suspend Power switch System operation can be suspended by holding down the Power switch for more than a second. (see note) Normal Auto Power OFF (APO ) System operation automatically shifts to the susp[...]

27 2.2.4 Battery Voltage Monitoring Process This terminal uses a main battery (lithium- ion battery pack) for driving the m ain unit, and a primary sub-battery (lithium battery ) and a secondary sub-battery (lithium- vanadium battery ) for backup. Application programs can acquire the status of these batteries through the APM BIOS or sy stem library[...]

28 Low Voltage Level The IT-2000 continuously monitors the voltage of the m ain battery, the prim ary sub-battery , and the SRAM card battery. This allow s an application program to determine through the sy stem library if the voltage of each battery reaches a warning level. The following table summ arizes the low battery v oltage warning levels, w[...]

29 Main Battery Voltage Monitoring If the m ain battery voltage reaches L B1, the system issues a warning buzzer. I f this warning buzzer sounds, either start recharging the battery or replace it w ith a fully charged battery as soon as possible. If one of these m easures is not taken within ten minutes, the sy stem will forcibly turn off the power[...]

30 Sub-batter y Voltage Monitoring The sub - batteries are used for s y ste m backup while the m ain batter y is being replaced. The sub- batteries consists of two units: the pri m ar y sub - batter y (button - t y pe lithiu m batter y ) and secondary sub - batter y (button - t y pe lithiu m - vanadiu m batter y ). The secondar y sub - batter y is [...]

31 2.2.5 Low Consumption Current Process This terminal has the APM BIOS installed to provide a low-power consumption capability . It works in com bination with POWER.EXE from Microsoft Corporation. The low-power consumption capability is further enhanced by the use of unique power m anagement functions, including Auto Power OFF (APO) function, Auto[...]

32 A uto Pow er OFF Function (A PO) This function automatically shifts the system to the OF F state (suspend state) if no event has taken place for a specified period of time from the touch panel, the keyboard, COM1, or a file. This time interv al has been set to one minute by default. I t can be modified using the Sy stem Menu or system library. A[...]

33 DOZE/RUN Transit Function On this terminal the sy stem will reduce the clock speed of the built-in CPU if no activity (access to the touch panel, keys , COM1, or file) has occurred for a specified period of time (four seconds). The state in which the CPU clock speed has been reduced is called the "DOZE state" and the state in which the[...]

34 2.2.6 How to Replace or Recharge Batteries Replacement of Batt eries The method used to replace the m ain battery, sub- battery, and SRAM card battery are explained here Failure to observ e the correct battery replacement procedure m ay result in a loss of data. Alway s observe the following steps in battery replacement. Main battery replacement[...]

35 Note: The SRAM card is supplied power by the main battery when it is installed in the main unit. This means that the SRAM card can be used norm ally as long as it is in the slot, even if the voltage of the card battery is zero. In this case, however, the data on the SRAM card will be lost when the card is remov ed from the main unit slot. Since [...]

36 2.3 Supported Dev ices 2.3.1 Display Unit Hardw a re Configuration LCD FSTN sem i-transparent liquid cry stal display Resolution 192 x 384 dots Tone B/W 16 gray scales (4 gray scales are identifiable) Method VGA com patibl e VRAM 512 KB RAM for hardware window 32 KB Note: With B/W liquid crystal display s the actual display colors will be change[...]

37 Softw are Functions Standard Video BIOS is supported. This supports the following v ideo modes: Mode No Mode Type Characters Resolution Colors Memory Segm ent 00h Text 40 x 25 320 x 200 16 B800h 01h Text 40 x 25 320 x 200 16 B800h 02h Text 80 x 25 640 x 200 16 B800h 03h Text 80 x 25 640 x 200 16 B800h 04h Graphics 320 x 200 4 B800h 05h Graphics [...]

38 2.3.2 EL Backlight Overv iew This terminal has the following functions to control the backlight. F or more inform ation refer to Chapter 6 “Key board Controller”. Manual Backlight ON/OFF function Auto Backlight OFF function (ABO) Auto Backlight Control function (ABC) Manual Backlight ON/OFF Function The backlight can be turned on and off wit[...]

39 2.3.3 Touch Panel Hardw a re Configuration Method : Analog ty pe touch panel Resolution : 192 x 384 dots Softw are Function To enable application programs to acquire touch panel coordinates, the following two pieces of software are provided: PENMOUSE.COM With this PENMOUSE.COM application programs can acquire touch panel input through the mouse [...]

40 2.3.4 Disk Ty pes of Disk Type Drive nam e Capacity RAM disk A 0 to 1920 Kby tes Basic drive C 768 K bytes F- ROM disk D 0, 4, 8, 12, 16 or 24 Mbyt es PC card G or F SRAM card, ATA card Note: The drive nam e of the P C card varies for each m odel. For more inform ation refer to Chapter 2.1.3 “Drive Configuration”. RA M Disk Part of the main [...]

41 F-ROM Drive The F- ROM drive is supported as a disk for which both read and write operations are possible (only for models with the F -ROM drive). Various disk capacities are supported for each model: Disk capacity: 0 (m odels without F- ROM), 4M, 8M, 12M, 16M or 24 MB. To format the F -ROM drive use the System Menu. For information about the fo[...]

42 2.3.5 Serial Communication A vailable Int erfaces Port I/O Address N ame Uses Remark COM1 3F8h- 3FF h 8-pin serial I/ F Connection with a barcode reader or PC 14-pin serial I /F C onnection with an expansion I/F device COM2 2F8h- 2FF h IrDA 1.0 Comm unication with an I/O Box or between two I T2000s Can be switched via the sy stem library. COM3 3[...]

43 COM2 Either the 14-pin serial I /F or I rDA 1.0 can be assigned to this COM2 port depending on the system library setup. Both the 14- pin serial I/F and IrDA 1.0 can be used as a normal RS- 232C interface. By default, the COM2 channel is not assigned to either device. Therefore, alway s use the system library to designate either the 14-pin seria[...]

44 2.3.6 PC Card Hardwa re Overview Standard Conforms to PCMCIA Release 2.1 Register compatibility Has register compatibility with I ntel 82365SL Step Slot 1 slot TYPE II Power supply Vcc : 5V (not operable at 3.3V) Card lock switch Has a card lock switch Recommended PC Cards Type Model SRAM card DT-635MC (256 K B) DT-636MC (512 K B) DT-637MC ( 1 M[...]

45 Card Lock Switch The IT- 2000 has a card lock switch to prevent accidental removal of the card. Any card can be made usable only after it has been inserted in the slot and the sw itch has been locked properly. However, since some ty pes of cards do not allow this card lock switch to be closed, a library routine to disable this switch is supporte[...]

46 2.3.7 Clock Timer Clock BIOS 00h to 07h of the INT1Ah function is com patible with the IBM PC/AT. Since INT1Ah can be called in the C language, an alarm operation using the clock can be set with the system library. Al a r m If an alarm operation is set using the INT1Ah or system library, it is possible to cause an I NT4Ah interrupt at the specif[...]

47 2.3.8 Buzzer This terminal is prov ided with a buzzer function that is compatible, via an appropriate interface, with the IBM PC. The application side can sound this buzzer by controlling the I /O port assigned to 61h. It is also possible to m odify the sound frequency by controlling channel 2 of the tim er. For inform ation about the method use[...]

48 2.3.9 Barcode Reader Overv iew The IT- 2000 supports the following two Casio OBR (Optical Barcode Reader) models: DT-9650BCR ( Pen scanner ) DT-9656BCR ( CCD scanner) Connect the OBR to the COM1 (8-pin) port of this terminal, and set up the interface as follows. Synchronization Asy nchronous Baud rate 9600 bps Data bit 8 bits Parity bit none Sto[...]

49 2.3.10 Infrared Communication (IR) The infrared comm unication function of this terminal supports the protocol of IrDA 1.0 (see note below) and IrDA 1.1 standards. I rDA 1.0 can be used as the COM port for a general RS-232C. I rDA 1.1 can provide comm unication at a maximum rate of 4 Mbps by m eans of the dedicated utility (F LI N K utility ). I[...]

50 2.3.11 Key s Hardwa re Overview Key configuration 5 (column) x 3 (row) key s IRQ IR Q1 Key repeat function available Simultaneous pressing of m ultiple keys not available Roll-over function not available Key Layout See the following key layout. Fi g. 2.12 Fn key The "F n" key should be used in com bination with the numeric key . Hold d[...]

51 2.3.12 Sensors The IT-2000 has the following three ty pes of built-in sensors: Illum ination sensor Attached to the upper section of this terminal and used to sense the am bient light intensity. I t is used for the Auto Backlight Control (ABC) function. It cannot be controlled directly from the application. (For m ore information about the sy st[...]

52 3. Sy stem Menu 3.1 Overv iew The system menu is a program and used to perform various setups (sy stem clock, contrast of liquid crystal display , etc.) and implem ent (downloading) application programs, all of which are necessary to use this term inal. To start up the system menu press the reset switch located at the back of the main unit. When[...]

53 3.2 Basic Operation In the sy stem menu a com mon set of key operations are used. The following list shows the keys that can be used in the system m enu. Current Condition Key Operation Operation Process 8 Moves the line selection cursor up one line. 2 Moves the line selection cursor down one line. CLR Moves the line selection cursor to the uppe[...]

54 3.4 Key Click Sound Setup Function Sets the key click sound ON and OF F. I f it is set to ON, a key click sound is heard when a key is pressed or when the keypad is touched. I t does not sound if it is set to OFF . Fi g. 3.3 Operation Select ON/OF F wi th the “ 0” or “ 1 “ key, t hen confirm the sel ection with the “RET” key . Key Op[...]

55 3.5 Buzzer Volume Setup Function Sets the volume of the buzzer (beep). One of the four levels (OF F/Sm all/Medium/Large) can be selected. Fi g. 3.4 Operation Make a selection w ith a key, “ 0” t o “ 3 “, and confirm the sel ection with the “ RET” key . Key Operation Function 0 to 3 keys Selects the corresponding number. . (decimal) k[...]

56 3.6 Contrast A djustment Function Adjusts the contrast of the liquid crystal display . Fi g. 3.5 Operation Press the “8 “ key to increase the contrast or press the “ 2” key to decrease the contrast. Press the “ RET” key to confirm the setting. Key Operation Function 8 key Increase the contrast. 2 key Decrease the contrast. RET key Co[...]

57 3.7 A uto Backlight Setup Function Sets the auto backlight control ON or OFF (refer to Chapter 6 “Key board Controller"). Fi g. 3.6 Operation Select ON/OF F wi th the “ 0” or “ 1” key, t hen confirm the sel ection with the “RET” key . Key Operation Function 0 key T urns the auto backlight control to OF F. 1 key S ets the auto [...]

58 3.8 A uto Pow er OFF Setup Function Sets the time- out period of the auto power off function (APO ) (refer to Chapter 2.2.3 “Power OFF Process"). This time-out period is the interv al between when no key entry or no entry on the touch panel is made and when the power of sy stem is shut off autom atically. Fi g.3.7 Operation Set the APO ti[...]

59 3.9 Touch Panel Calibration Function Adjusts the calibration of touch panel. If an inconsistency is noted between the target position and the position actually touched on the touch panel, correct it by performing this calibration adjustm ent. Fi g. 3.8 Operation Adjustment of the calibration : First m ake sure that the arrow points to in the upp[...]

60 Note: If a n mark does not disappear and the arrow does not m ove to the next position even if the mark has been touched by the stylus, an incorrect position w as likely touched. Touch the correct position. Key Operation Function 1 key Adjusts the touch panel calibration starting from the beginning. 2 key Returns to the menu screen. Others Inval[...]

61 3.10 YMODEM Utility Function Used to achieve a file transfer via the COM cable. Comm unication can be established either between an AT-com patible machine (PC) and an IT- 2000 (main unit), referred to as "PC-to-HT com munication". A dedicated 9- pin DSUB-8-pin cross-ty pe cable (DT-9689AX) is required to connect both the terminals. Thi[...]

62 Note: When the cable comes off w hile the comm unication takes place: If the connection cable is accidentally unplugged while comm unication between the IT-2000 and PC is taking place, a communication error results and com munication is interrupted. In this case the comm unication software on the P C will display an error message and interrupt t[...]

63 Operations (1) SEND FILE TO HT (one file transmission from IT-2000 to IT-2000) This function may be available in future (as of now, not available). I t is not allowed to use the function. If the file transm ission between IT-2000s is needed, F LINK utility may be used (refer to Chapter 3.11 “FL INK Comma nd”.). (2) SEND FILE TO PC (one file [...]

64 When the "Normal End" message is displayed on the I T-2000 side, file reception has been completed. F or information about the copy destination directory refer to the following table. If the “CL R” key is pressed during comm unication, file reception will be interrupted. It will take about 10 seconds for comm unication to completel[...]

65 3.11 FLINK Command Function Files can be transferred by infrared comm unication (IR). This can be implem ented either as PC-to- HT (AT-com patible machine to IT- 2000) communication or as HT- to-HT (between two I T-2000 terminals) com munication. To perform PC-to- HT com munication an I/O Box for IT- 2000 and a P C-side com munication utility &q[...]

66 Note: I f the identical file na m e exists on the reception side, this co mm and overwrites the existing file. At this ti m e, the s y ste m does not unconditionall y overwrite the existing file but creates a te m porary file on the reception - side disk and atte m pts the overwrite after file trans m ission has been co m peted. This protects fi[...]

67 Note: If the “CL R” key is pressed during file transfer, transfer will be interrupted. It will take about 10 seconds for comm unication to completely stop. REMOTE SERVER (remote server mode ) The remote server m ode is used by the sy stem which assigns the right of issuing a transm ission request to the partner side and enters the wait state[...]

68 3.12 Sy stem Date/Time Setup Function This is used to set (modify ) the date and time of the built-in tim er in the IT-2000 unit. Fi g. 3.15 Operation Enter in the following order: y ear -> month - > day -> hour - > minute. Press a numeric key and the corresponding number will appear in the cursor position. Press the “ RET” key t[...]

69 3.13 Command Prompt Function This is the MS DOS comm and prompt screen. An appropriate DOS comm and can be inputted through the keypad. This DOS com mand prom pt is the resu lt of calling COMM AND.COM as a child proces s from the system menu. Consequently , if the EXIT comm and is entered, operation returns to the system menu. Fi g. 3.16[...]

70 3.14 RA M Disk Size Change Function This screen is used to set the RAM D ISK size (capacity). The setting will become v alid after the system has rebooted. Fi g. 3.17 Operation Setting up the RAM disk Adjust the RAM disk size with the “8” and “2” keys. Confirm the setup with the “ RET” key . When the "Hit Any Key... " messa[...]

71 Key Operation Function 8 key Increases the RAM disk size. 2 key Decreases the RAM disk size. RET key Confirm s the currently selected RAM disk size and exi ts this operation. CLR key Cancels the currently selected RAM disk size. 1 key Form ats the RAM disk (Form at confirmation screen). 0 key Aborts formatting of the RAM disk. Others Invalid. Op[...]

72 3.15 Disk Format Function Form ats the RAM disk and F-ROM drive. Fi g. 3.18 Operation In the screen shown abov e, use the “2” or “8” key to select whether the RAM disk or user drive is to be format ted, then press the “RET” key . This makes t he following screen appear. I n this screen press the “1” key to m ove the cursor onto &[...]

73 Key Operation Function 2 or 8 key Selects the objective item (drive selection screen). 0 key Does not perform formatting (form atting start screen). 1 key Starts formatting (form atting start screen). . (decimal) key T oggles YES and NO options of formatting. RET key Confirms the current setting. CLR key Cancels the current setting. Others Inval[...]

74 3.16 Sy stem Initialization Function Sets all the system setups to their default settings. Fi g. 3.21 Operation The following table shows the available key operations. Key Operation F unction 0 key Does not initialize the system . 1 key Initializes the sy stem. . (decimal) key Toggles YES and NO options of initialization. RET key C onfirms the c[...]

75 3.17 Passw ord Entry Function When "F ILE TRANSF ER" or "MAINTENANCE" is selected for the first time after the sy stem menu is initiated, the operator is requested to enter a password. Fig. 3.22 Operation With the key pad enter "sy stem " (lowercase lett er), then press the “RET” key . If the “CL R” key is p[...]

76 4. MS-DOS 4.1 Ov erview In general, if a personal com puter is booted-up with a floppy disk in the driv e, first an attempt will be made to read MS- DOS from the floppy disk, and if a copy of MS-DOS does not reside on the floppy it is loaded from the hard disk (C:). However, this m ethod cannot be used on this terminal since its basic drive (C:)[...]

77 As described above, if the sy stem power is turned on without an application installed (i.e. the conditions just after purchase), the CONFI G.SYS and AUTOEXEC.BAT files locating on the basic drive will be executed autom atically. This inevitably initiates the System Menu (m aintenance program). Therefore, if not only CONFI G.SYS and AUTOEXEC.BAT[...]

78 4.2 How to Write CONFIG.SYS and A UTOEXEC.BA T This section explains how to write the CONF IG.SYS and AUTOEXEC.BAT files mentioned in the previous section. A basic explanation of the CONF IG.SYS and AUTOEXEC.BAT is not given here. For further inform ation about these files refer to the MS-DOS manual or appropriate technical documents. Observ e t[...]

79 (1) DOS=HIGH,NOUMB This specifies that the main part of DOS is to be loaded in the HMA and, consequently , the UMB (Upper Memory Block) is not used. This terminal does not support a mem ory space for UMB if the EM S memor y is t o be used. Therefore, alw ays speci fy NOUMB w hen using the EMS. (2) DEVICE=C: SYSDRV.SYS This driver is required to [...]

80 Example of A UTOEXEC.BA T The following example shows a ty pical AUTO EXEC.BAT script. Since this example assum es that the sy stem is booted from either the RAM disk or the NAND F -ROM driv e, it is necessary to partially m odify it if booting up from the ATA card. For inform ation about booting from the ATA card refer to Chapter 4.3 "Card[...]

81 4.3 Card Boot Basically the " card boot" operation boots MS-DOS from the ATA card, just like it is booted from a floppy disk. F or this terminal the boot operation looks the sam e as this case. However, this terminal uses a boot process greatly different from a general card boot so that the MS-DOS in the drive C is alway s loaded, in s[...]

82 the drive G, which is currently enabled, will be disabled. This problem arises from the fact that the hardware conditions established by initialization with CARDID.EXE are lost since access to the drive F was executed by means of specific codes included in the BIOS. To av oid this problem, these specific codes in BIOS should be disabled. ENDATA.[...]

83 CONFI G.SYS which resides on the drive C. Howev er, CARDID.EXE cannot be registered as a device driv er at a card boot. If this CARDID.EXE is registered as a device driv er, two drives may be enabled concurrent ly if M S-DOS executes CONF IG.SYS. In addi tion, if ENDATA.COM is called with the INSTAL L com mand, the drive G is enabled exclusively[...]

84 5. MS-Window s 5.1 Ov erview The MASK ROM driv e (E:) of this terminals has MS-Windows installed in it. However, MS-Window s cannot be booted directly from this MASK ROM drive. This is because MS-Windows will overwrite som e of the INI files at start up. However, since all files including the INI files are initially located in the MASK ROM drive[...]

85 5.2 Installation of MS-Window s As explained on the previous page, it is necessary to move (copy ) some files onto the write-perm it drive before booting MS-Windows. This section will describe this copy operation The following is an example of m anually installing necessary files so that the user can determine the contents. A utility program (WI[...]

86 Note: The contents of the latest version of E: WINDOWS L OCAL may be released as SDK. I f this is the case, use the files in SDK instead of those stored in E: WINDOWS LOC AL. 5.2.2 A pplication Installation For this term inal it is recommended to initiate the application program at the same time MS-Windows is started. This can be achiev ed by mo[...]

87 6. Key board Controller 6.1 Ov erview This terminal is equipped with a sub- CPU dedicated to controlling the keyboard, touch panel, backlight, and various sensors. This chapter describes m ajor tasks assigned to this sub-CPU. F i g . 6 . 1 Main CPU Sub- CPU Temperature Sensor Illum ination Sensor Battery Voltage Sensor Buzzer Volum e El Backligh[...]

88 6.2 Key board Control The keyboard control of I T-2000 is compatible with the I BM PC /AT. The key board controller senses if a key has been pressed and sends a MAK E or BREAK code to the m ain CPU. F i g . 6 . 2 Sy stem Scanning Code Each keyboard scanning code generated from the keyboard m ain unit will be converted to the keyboard sy stem sca[...]

89 Secondary code Basically a sy stem scan code is assigned to each key , however, for some key s, different codes will be assigned depending on the Fn key . Code Table The following diagram shows the relationship between the keyboard key s and primary codes. Fig. 6.3 Fn ke y The Fn key is used to generate a system scanning code for the function ke[...]

90 6.3 Touch Panel Control Function The keyboard controller has incorporated a program for acquiring the touch coordinates of the touch panel. This program com pensates these acquired coordinates with the values obtained through calibration so that correct coordinate values can be calculated. The calculated coordinates will be passed to a ROM-resid[...]

91 6.4 Sensor Control This terminal has the following three ty pes of sensors installed to serve as dedicated devices for handy term inal. Sensor Pu rpose of Use Temperature sensor Detects the temperature inside the main unit. This result will be used to automatically compensate the LCD brightness. Illum ination sensor Detects the ambient light int[...]

92 6.5 Backlight Control This terminal has incorporated two ty pes of automatic backlight control functions: ABO (Auto Backlight OFF ) and ABC (Auto Backlight Control). The ABO function is used to turn off the backlight if no key or touch panel input has been m ade for a given period of time, and the ABC function is used to automatically turn on an[...]

93 Transition of Backlight Control Methods The concept of ABC lies in automating user operations. Howev er, automatic control depends on the illumination sensor. I t cannot be perfect because various types of light, sunlight or room light for example, m ay be incident to the sensor. Consequently , this requires manual ON/OF F control even if under [...]

94 Press F7 key ABO time- up ABC Enable ABC Disable Becomes dark Becomes light 1A B C disabled Backlight ON sta te 2 2 3 or 4 *1 -- - Ignore Ignore 2A B C disabled Backlight O FF st at e 1 --- 3 or 4 *1 -- - Ignore Ignore 3A B C enabled Backlight ON sta te 6 Ignore Ignore 2 --- 4 4A B C enabled Backlight O FF st at e 5 --- I gnore 2 3 --- 5A B C te[...]

95 7. Driv ers 7.1 Ov erview The following drivers are supplied for this term inal. Install them as required for operation. Driver File nam e Purpose System driver SYSDRV.SYS Driver required to operate the system . This driver must be installed. Clock control driver TIME.SYS Executes the process that restores the clock condition at a resume-boot in[...]

96 7.2 Sy stem Driv er 7.2.1 Function The system driver (SYSDR V.SYS) must be installed because it executes critical processes in this terminal. The sy stem driver m ainly performs the following processes. LB1 monitoring and warning Monitors the main battery conditions and sounds a warning buzzer if an LB1 event is detected. It also forcibly turns [...]

97 7.3 Clock Control Driv er 7.3.1 Function This driver adjusts the system time on this term inal. Th is driver m ust be installed. On a general PC a timer interrupt occurs every 55 ms to update the clock tick counter, which is one of the BIOS sy stem variables, and the clock ov erflow counter. The clock tick counter is incremented each tim e the t[...]

98 7.3.2 Startup Method This driver is loaded by defining the DEVICE statement in the CONF IG.SYS file. TIME.SYS is stored in the basic drive (C:). Format DEVICE=C: TIME.SYS Start option None Note: TIME.SYS must be loaded im mediately after PO WER.EXE.[...]

99 7.4 Key pad Driv er/Hardw are Window Manager 7.4.1 Function The keypad driv er ( KEYPAD.EXE ) is used to add the key pad function to the system. Application programs can use the key pad by calling the key pad driver functions via the key pad library (refer to Chapter 8.6.3 “Key pad Library ”). This keypad driv er internally calls the hardwar[...]

100 7.5 PenMouse Driv er 7.5.1 Ov erv iew The PenMouse driver (PENMOUSE.DRV) simulates the operation of the mouse driv er specific to the personal computer using inputs receiv ed from the touch panel. The PenMouse driver makes it possible to run an application on the IT-2000 term inal that was designed for use with a mouse driv er on the personal c[...]

101 7.5.2 Startup Method The PenMouse driver can be loaded by specify ing as follow at [boot] section of SYSTEM.INI . However, it is loaded autom atically to F- ROM drive (D: ) when Windows is installed by using the Windows installer. SYSTEM.INI is also created automatically . The driver is supplied as an SDK. Format: [boot] ...... mouse.drv=penmou[...]

102 7.6 Virtual Key board Driv er 7.6.1 Function The Virtual Key board Driver (VKD.386) is a driver that enables access to the keyboard controller on Windows (refer to Chapter 6 "K eyboard Controller"). This driver is only called from the sy stem library. Since this driv er has no chance of being directly called from the application progr[...]

103 7.6.2 Startup Method The Virtual Key board Driver can be loaded by making the following specification in the “386Enh” section of SYSTEM.INI . VDK.386 is included in SDK. I f Windows is installed by the installer, VDK.386 will be automatically copied into the F- RO M drive (D:) and SYSTEM.INI will also be automatically created. Therefore, th[...]

104 7.7 Sy stem Library (main program file) 7.7.1 Function SYSCA L L.DLL is a dynami c link library that constitutes the main program of the system library (refer to Chapter 8.6.2 "Sy stem Library "). Before executing an application that calls the sy stem library it is necessary to locate this file in the Windows directory (or other direc[...]

105 7.8 Display Driv er 7.8.1 Function Display driver (VGA_C.DRV, VGA_NC.DRV) is a Windows di splay dri ver for a screen s ize of 192 x 384 dots. If this driver is used, m aximized or iconized windows will not extend bey ond the screen size and dialog boxes can be displayed in the center of the screen. The relationship between the Display driver an[...]

106 Note: If the abov e script is deleted from SYSTEM.INI or PE NMOUSE.DRV is rem oved, no display operation is permitted on Windows.[...]

107 7.9 COM Driv er for IrDA 7.9.1 Ov erv iew The IrDA Driv er consists of IRDA.DLL and IRCOMM.DRV. The former is processes the protocol section and the latter processes the port emulation and fram e sections. It is possible to set up param eters to define the operation of the IrDA section by w riting them in the WIN .IN I fil e. F i g . 7 . 7 This[...]

108 IrCOMM Lay er (including TinyTP Lay er) The IrCOMM (Infrared COMM) layer includes Tiny TP (Tiny Transport P rotocol) layer. I rDA protocol can be used through this IrCOMM (Tiny TP) layer. Three connection methods are supported: 3-Wire Raw, 3- Wire, and 9-Wire. The credit size of Tiny TP is fixed to five (and it cannot be modified). 3-Wire Raw C[...]

109 7.9. 2 Windo w s 3.1 Communication Functions To perfor m co mm unication with I rDA use A P I of MS - Windows. The following table lists the specifications of the available co mm unication functions. List of communication functions F unction Description P age B uildCo mm DCB Sets the control codes to the device control block (DCB). 110 ClearCo [...]

110 BuildCommDCB int BuildCommDCB(lpszDef, lpdcb) LPCSTR lpszDef; /* Address of the device control character string * / DCB FAR *lpdcb; /* Address of the dev ice control block */ The BuildComm DCB function converts the device definition character string to the corresponding serial device control block (DCB) codes. < Parameter > lpszDef : Poin[...]

111 ClearCommBreak int ClearCommBreak (idComDev) int idComDev; /* Device with canceled break state */ The ClearComm Break function cancels the break state of the communication dev ice and restores it so it is ready for character transm ission. < Parameter > idComDev: I dentifies the communication dev ice for which the break state is to be can[...]

112 CloseComm int CloseComm(idComDev) int idComDev; /* Dev ice to be closed */ The CloseComm function will close the specified com munication device and release the m emory area assigned to the transmission and reception queues of the dev ice. All characters in the transmission queue will be flushed out before the com munication device is closed. &[...]

113 EnableCommNotification BOOL EnableCommNotification(idComDev, hwnd, cbWriteNotify, cbOutQueue) int idComDev; /* Communication device identifier * / int hwnd; /* Handle of window that receives the message */ int cbWriteNotify; /* Number of by tes written before notification */ int cbOutQueue; /* Minim um number of by tes of the output queue */ En[...]

114 Note: If the application specifies - 1 for the cbWriteN otify parameter, the WM_COMMNOT IF Y message will be sent to the specified window in the case of CV_EV ENT notification or CN_TR ANSMIT notification, but it will not be sent in the case of CN_RECEIVE notification. If the application specifies -1 for the cbOutQueue param eter, CV_EVENT noti[...]

115 EscapeCommFunction LONG EscapeCommFunction(idComDev, nFunction) int idComDev; /* I dentifier of the communication dev ice */ int nFunction; /* Code of the expanded function * / The EscapeComm Function is used to specify the communication dev ice used to execute the expanded function. < Parameter > idComDev Specifies the com munication dev[...]

116 FlushComm int FlushComm(idComDev, fnQueue) int idComDev; /* I dentifier of the communication dev ice */ int fnQueue; /* Queue to be flushed * / The FlushCom m function is used to flush out all characters from the transmission queue or reception queue of the comm unication device. < Parameter > idComDev : Specifies the comm unication devic[...]

117 GetCommError int GetCommError(idComDev, lpStat) int idComDev; /* Com munication device I D */ COMSTAT FAR *lpStat; /* Address of the dev ice status buffer */ The GetComm Error function is used to acquire the last error value and current status of the specified device. I f a communication error occurs, Windows will lock the com munication port u[...]

118 CE_TXFULL Not supported at present. The data will be passed from the transmission queue to the transmission buffer according to the I rDA protocol. It will be perform ed asynchronously with the write timing of the transm ission queue by the WriteComm function. F or example, if 2 kiloby tes of data is written in a transmission buffer 2 kiloby te[...]

119 COMSTA T structure typedef struct tagCOMSTAT { / * c m s t * / BYTE status; / * t r a n s f e r s t a t u s * / UNIT cbInQue; /* Number of characters in the reception queue */ UNIT cbOutQue; / * N u m b e r o f c h a r a c t e r s i n t h e t r a n s m i s s i o n q u e u e * / } COMSTAT; The COMSTAT structure is used to store information about[...]

120 GetCommEventMask UNIT GetCommEventMask(idComDev, fnEvtClear) int idComDev; /* Com munication device I D */ int fnEvtClear; /* Ev ent to be cleared in the event word */ The GetCommEventMask function will acquire the bit specified by the fnEvtClear mask in the event word, then clear it. < Parameter > idComDev : Specifies the comm unication [...]

121 OpenComm int OpenComm(lpszDevControl, cbInQueue, cbOutQueue) LPCSTR lpszDevControl; /* Address of the dev ice control information */ UNIT cbInQueue; /* Size of the reception queue * / UNIT cbOutQueue; /* Size of the transmission queue */ The OpenComm function will open the comm unication device. < Parameter > lpszDevControl: Pointer to a [...]

122 Note on IrDA: The OpenComm function does not support the LPT device. Since the OpenCom m function does not control the power block of IrDA, the user should turn the pow er block to ON before executing this function. On the IT-2000 the I rDA interface is assigned to CO M2 port, therefore the COM2 port should be specified. The OpenComm function o[...]

123 GetCommState int GetCommState(idComDev, lpdcb) int idComDev; /*Com munication device I D */ DCB FAR * lpdcb; /* Address of the dev ice control block structure */ The GetCommState function will acquire the device control block of the specified dev ice. < Parameter > idComDev : Specifies the device for which the DCB is to be checked. The Op[...]

124 ReadComm int ReadComm(idComDev, lpvBuf, cbRead) int idComDev; /* I D of the device to be read */ void FAR * lpvBuf; /* Address of the buffer from which bytes are read */ int cbRead; / * N u m b e r o f b y t e s t o r e a d * / The ReadComm function will read the by te data from the specified comm unication device and assume the specified num b[...]

125 SetCommBreak int SetCommBreak(idComDev) int idComDev; /* Dev ice to interrupt communication * / The SetComm Break function is used to interrupt character transmission and set the comm unication device to the break state. < Parameter > idComDev: Specifies the com munication device to be interrupted. The OpenCom m function returns this valu[...]

126 SetCommEventMask UNIT FAR *SetCommEventMask(idComDev, fuEvtMask) int idComDev; /* Com munication device to be enabled * / UNIT fuEvtMask; /* Event to be enabled * / The SetCommEventMask function will enable the ev ent included in the event word of the specified comm unication device. < Parameter > idComDev Specifies the comm unication dev[...]

127 Note: The application must enable the event using the SetCom mEventMask function before the GetComm EventMask function records the occurrence of an event. If the com munication devi ce event shows a line status error, the application should call the GetComm Error function after calling the GetComm EventMask function. Note on IrDA: Some of the e[...]

128 SetCommSta te int SetCommState(lpdcb) const DCB FAR * lpdcb; /* Address of the dev ice control block */ The SetCommState function will set the com munication device to the state that is specified by the device control block. < Paramet er > lpdcb: Pointer to the DCB structure that stores the communication settings for the devi ce. Specify [...]

129 DCB structure typedef struct tagDCB /* DCB */ { BYTE Id; /* internal device ID */ UNIT BaudRate; /* Ba ud rate * / BYTE ByteSize; /* Num ber of bits per by te (4-8) * / BYTE Parity; /* 0 = None, 1 = Odd, 2 = Even, 3 = Mark , 4 = Space */ BYTE StopBits; /* 0 = 1 bit, 1 = 1.5 bit s, 2 = 2 bits * / UNIT RlsTimeout; /* T im eo ut of RLSD set */ UNI[...]

130 The DCB structure defines the control setups of serial comm unication. < Members > Id Identifies the comm unication device. This value is set by the dev ice driver. If the m ost significant bit (MSB) is set, the D CB structure is used for a parallel comm unication device. BaudRate Indicates the baud rate representing the processing speed [...]

131 fOutxCtsFl ow Not supported. fOutxDsrFlow Not supported. fDummy Reserv ed. fDtrDisable Indicates whether to disable the DTR (data terminal ready ) signal. If this mem ber is set, the DTR signal is not used and remains off. If this m ember is cleared, the DTR signal will be sent if the device is opened, and will be turned off if the device is cl[...]

132 TransmitCommChar int TransmitCommChar(idComDev, chTransmit) int idComDev; /* Comm unication device */ char chTransmit; /* Character to be transm itted */ The TransmitCom mChar function places the specified character at the top of the specified transmission queue. < Parameter > idComDev : Specifies the communication dev ice to which charac[...]

133 UngetCommChar int UngetCommChar(idComDev, chUnget) int idComDev; /* Com munication device * / char chUnget; /* Character to be placed in the queue * / The UngetComm Char function replaces the specified character in the reception queue. A t the next read operation, this character will be read first. < Parameter > idComDev : Specifies the c[...]

134 WriteComm int WriteComm(idComDev, lpvBuf, cbWrite) int idComDev; / * C o m m u n i c a t i o n d e v i c e I D * / const void FAR * lpvBuf; /* Address of the data buffer * / int cbWrite; / * N u m b e r o f b y t e s t o w r i t e * / The WriteComm function will write to the specified com munication device. < Paramet er > idComDev: Specif[...]

135 7.9.3 Setting Up WIN.INI File The following parameters must be set in the [I rDA. COM2] section of the WIN.INI file. I f these parameters are not specified or if invalid param eters are set, communication will be perform ed according to the default values. Setup example [IrDA.COM2] IrDA=ON MaxBaudRate=115200 SizeWindow=1 SizeData=1024 Disconnec[...]

136 MaxBaudRate Sets the baud rate (for IR comm unication). It is one the negotiation param eters. P arameters less than the default value can be concatenated using ORs. Parameters 2400 Maximum baud rate is 2.4 Kbps. 9600 (default) Maximum baud rate is 9.6 K bps. 19200 Maximum baud rate is 19.2 K bps 38400 Maximum baud rate is 38.4 K bps 57600 Maxi[...]

137 MaxTurnA roundTime Sets the maxim um turnaround time. I t is one of the negotiation parameters. This is, however, fixed to 500 msec. Paramete r 500 ms. (default) Maxim um turnaround time is 500 ms. MinTurnA roundTime Sets the minim um turnaround time. I t is one of the negotiation parameters. Parameters 5 ms Minimum turnaround time is 5 ms. 10 [...]

138 Dev iceName Sets the device nam e to be registered as the "DeviceName" of the I AS attribute. A maximum of sixteen 1-by te characters can be set. The seventeenth and subsequent character will be ignored. Parameters Optional character string Device name for the "DeviceNam e" attribute Vx.xx (default) Version number of the IrD[...]

139 7.9.4 Installation Method The method used to install the I rDA driver in Windows is described here. Using WINST.EXE it is also possible to install it according to the default settings. Use the following information as a reference for manual installation or if m odifying the setup contents. The Windows3.1 IrDA driv er is installed with the follo[...]

140 Add the following to the WIN.INI file. F or information about the setup value of each entry refer to Chapter 7.9.3 "Setting Up WIN.INI F ile". Setup example [IrDA.COM2] IrDA=ON MaxBaudRate=115200 SizeWindow=1 SizeData=1024 DisconnectThresholdTime=40 MaxTurnAroundTime=500 Min TurnAroundTime=10000 NumBOF=0 DeviceNickName=devicenickname [...]

141 8. A pplication Dev elopment 8.1 Ov erview This terminal uses the I BM P C/AT architecture. Though the actual display size is 192 (H) x 384 (V) pixels, internally the area of 640 (H) x 480 (V) pixels is supported by the dedicated display driv er. It allows no lim itation on programmi ng. Therefore, if the user develops an application that makes[...]

142 8.2 Notes on Dev eloping A pplication The use of double clicks on this terminal extrem ely difficult. Develop y our application program so that only single click is enabled Any program that uses the COM port must turn on the power to it in adv ance using the system library. The power to the COM port remains on once it has been turned on, or unt[...]

143 8.3 Dev elopment Environment 8.3.1 Dev elopment Environment To develop application program s a 16-bit compiler, Microsoft C/C ++ 7.0 or later, and a com puter on which the compiler can run are required. 8.3.2 A pplication Dev elopment Library For this term inal various libraries such as the keypad library and OBR library, which is used to enhan[...]

144 These libraries do not have to be alway s used. And, in as far as standard MS-Windows is pursued, they do not hav e to be used at all. The sole exception is that the COM port power must be turned on via the sy stem library if the user wants to control the CO M port directly . 8.3.3 Simulation Driv er As explained above, the libraries for this t[...]

145 8.4 Program Dev elopment Procedure The following diagram shows the basic procedural flow used to develop an application program that runs on this terminal. The following paragraphs explain the details of each phase of the procedural flow. F i g . 8 . 3 OK NG Operati on OK <IT- 2000 side> < PC side > Creation/Edition of sourcecode Co[...]

146 8.4.1 Creation of Execution File Application developers should develop program s using various application development libraries. The following sam ple program is used to turn on and off the backlight. With this program the backlight will be turned on or off if either "1" or "0" , respectively, is entered through the num eri[...]

147 8.4.2 Debugging Through Simulation Before the debugging, SysCall.DL L (for sim ulation) must be copied to the directory of Windows System . Since the same name, Sy sCall.DLL , is used for actual debugging and for simulation, please pay your attention not to m ake copy for wrong one. When y ou execute the sample program, window will appear on sc[...]

148 Fi g. 8.5 The outline of the operation test using the simulation driver is sum marized above. Debugging can of course be performed using Microsoft' s CodeView debugger. For m ore information about Sy sCall.DLL for sim ulation driver refer to Chapter 8.5.1 "Sys tem Drive Simulator (SysCall.DLL )".[...]

149 8.4.3 Operation Check on IT-2000 (Using COM2KEY/XY) If software coordination through sim ulation has been completed, it should be transferred onto the IT-2000 for operation checks. To do this use the COM2KEY utility . The C OM2KEY utility will, when the COM port of a personal computer is connected w ith the IT-2000 via the dedicated cable (DT-9[...]

150 8.4.4 Installation of A pplication Program This section describes how to install the application program, after it has been debugged, on the actual terminal. The following table sum marizes IT- 2000 installation required after purchase. (1) Installation of m ain battery and sub-batteries (2) Calibration (3) Form atting the F-ROM drive (for m od[...]

151 Installation work : In the slot, insert the ATA card that has been created for installation and lock the card lock switch. If the term inal power is currently on, turn it off. Then press the RESET switch to initiate the System Menu. Turn the Power switch to OFF and then to ON. The card boot process will take place. If the batch files called fro[...]

152 8.5 Simulation Driv er The simulation driver is used to dev elop on a personal computer the application programs that run on the IT- 2000. The application development libraries supported for this term inal control only the hardware that is compatible with the I BM P C/AT. T his is important to rem ember if the application programs for the termi[...]

153 8.5.1 Sy stem Library Simulator (SysCall.DLL) Overv iew This system library sim ulator can be called by various libraries and application program and simulate the operations of the dedicated I T-2000 hardware. File name SysCall.DLL Note: In the developm ent tool package, the file name is “Sy sCallp.DLL ”. When you use the file, change the n[...]

154 Fi g. 8.7 On the IT- 2000 the backlight can be turned on and off by means of F n + '7' . Namely , the backlight status can be changed not only from the application program but also by the user's operation. This operation on the simulator can be perform ed by clicking on the corresponding position on the monitor screen. As shown i[...]

155 F i g . 8 . 8 SYS_SetThr esholdOfABC SYS_GetThr esholdOfABC SYS_GetBuzzerVolum e SYS_SetBuzzerVolum e SYS_GetL cdContrast SYS_SetL cdContrast SYS_LcdContrastUp SYS_LcdContrastDow n SYS_GetConnectorStatus SYS_SetConnectorStatus SYS_GetDeviceP ower SYS_SetDevicePower SYS_G etKey Click SYS_SetK eyClick SYS_GetABC SYS_SetABC SYS_G etLBStatus SYS_Ge[...]

156 Note on the simula tion: As explained previously , this simulator does not exactly sim ulate the IT-2000 operations. Moreover, some operations can not be sim ulated because of the difference between the IT-2000 and personal computer in term s of the hardware. Restrictions regarding the COM port The operation of the COM port (8-pin) of the I T-2[...]

157 8.6 Library 8.6.1 Overv iew Since the I BM P C/AT architecture has been adopted in this s y ste m , all libraries including graphic librar y supported b y Microsoft C/C++ ver. 7.0 or later versions can be used. I n addition to those, the following dedicated libraries are available for the I T - 2000 s y ste m . Na m e of library Description P a[...]

158 8.6.2 Sy stem Library Overv iew The IT- 2000 has various dedicated functions that can control the backlight and the power of various devices by software. These functions are consisted of the programs of the expanded BI OS in the ROM and the keyboard controller (refer to Chapter 6 “K eyboard Controller”.). This library is used to call the ex[...]

159 List of Libraries The following functions are supplied in the s y ste m librar y : F unction P age F unction P age Acquisition of B I OS Version 160 Software Card L ock 178 Acquisition of Me m or y Device Size 161 Acquisition of Connector Status 179 Setting/Acquisition L CD Contrast 162 K e y Click Sound ON/O F F 180 I ncreasing/Decreasing L CD[...]

160 A cquisition of BIOS Version Acquires the ROM BIOS v ersion number, which consists of the following three num bers: major num ber, minor num ber, sub-number. SYNTAX long SYS_GetBiosVersion(); INP U T None OUTPUT b23 to b16 Major num ber b15 to b8 Minor num ber b7 to b0 Sub-num ber[...]

161 A cquisition of Memory Dev ice Size If the m emory device size is designated, the total capacity of the DRAM and the num ber of NAND F ROM chips is re ad. The mem ory dev ice size i s the total capacity of all t he physi cally installed devices, and not the disc capacity . SYNTAX int SYS_GetMemCapacity(int nDevice); INP U T nDevice = device ty [...]

162 Setting/A cquisition LCD Contrast The contrast of the LCD display is affected and varied by the am bient temperature. Therefore, this terminal autom atically detects the variation of am bient temperature and determines an optim al contrast based on the acquired data. However, it may not immediately react to rapid temperature variations or be id[...]

163 Increasing/Decreasing LCD Cont rast The contrast of the LCD display varies with the ambient temperature. Therefore, this term inal automatically detects the ambient temperature and determ ines an optimal contrast based on the acquired data. However, it may not immediately react to rapid temperature variations or be ideal for each specific user.[...]

164 Sw itching Over COM2 Channel IR, 14- pin, or 3-pin comm unication interface can be selected on the COM2 port. H owever, since the 3-pin interface is an optional m eans to maintain software compatibility with other models, it is not im plemented on this terminal. SYNTAX int SYS_GetCOM2Config(); INP U T None OUTPUT = 0 Not selected (default setti[...]

165 Setting/A cquisition of Reason Mask for Reboot To acquire the reboot request reason, enable or disable “mounting on I /O Box” or use of the CI signal for boot-up. SYNTAX int SYS_GetOnEventMask(); INP U T None OUTPUT b0 = 0 Enable use of ring signal 1 Disable use of ring signal b1 = 0 Enable use of “mounting on I /O Box” 1 Disable use of[...]

166 Reboot Request This function is used to restart (reboot) the system without suspending IT-2000 operations. SYNTAX int SYS_Reboot(int nMode); INP U T nMode = Reboot type 0 Initiates the application. 1 Initiates the sy stem menu. OUTPUT = 0 Normal = - 1 P arameter error[...]

167 Setting A BO Time The ABO (Auto Backlight OFF ) function is used to automatically turn off the backlight if neither key entry nor touch-panel entry is permitted for a certain period of time. This function is used to set the ABO time. Enable ABO by selecting a number between 1 and 15, which corresponds to a period of between 20 seconds and 5 mi [...]

168 A cquisition of A BO Time This function is used to read the ABO setting. SYNTAX int SYS_GetAboTime(); INP U T None OUTPUT = 0 N o t a c t i v a t e A B O = 1 to 15 ABO time in units of 20 seconds = - 2 No response from KBC = - 3 VxD not registered[...]

169 Setting A BC (A uto Backlight Control) Status The ABC (Auto Backlight Control) function is used to sense the ambient light intensity and automatically turns ON/OFF the backlight. This function is used to enable or disable the ABC function. SYNTAX int SYS_SetABC(int nOnOff); INP U T n O n O f f = 0 O F F Other than 0 ON OUTPUT = 0 N o r m a l = [...]

170 A cquisition of A BC (Auto Backlight Control) Status The ABC (Auto Backlight Control) function is used to sense the ambient light intensity and automatically turns ON/OFF the backlight. This function acquires the current setting of the ABC function. SYNTAX int SYS_GetABC(); INP U T None OUTPUT 0 ABC in OFF status 1 ABC in ON status 2 ABC tempor[...]

171 Setting/A cquisition of A BC Threshold The ABC (Auto Backlight Control) function is used to sense the ambient light intensity and automatically turns ON/O F F the backlight. This function is used to set marginal levels across which the backlight changes from ON to OF F or from OFF to ON. If the readout on the AD converter falls below OnValue, t[...]

172 Backlight ON/OFF This function is used to forcibly turn ON or OF F the backlight. I f turned ON by this function, the backlight will remain on until Backlight OFF is triggered by the Backlight OF F function or ABO. If this function is activated under the ABC control, the ABC will be temporarily disabled, and will be enabled again when Backlight[...]

173 A cquisition of Backlight Status This function acquires the current backlight status. SYNTAX int SYS_GetBacklight(); INP U T None OUTPUT = 0 Backlight OFF = 1 Backlight ON = -2 No response from KBC = -3 VxD not registered[...]

174 Setting Buzzer Volume Sets the buzzer volume to one of four lev els: Large/Medium/Sm all/OFF. SYNTAX int SYS_SetBuzzerVolume(int nVolume); INP U T nVolume = 0 OFF 1 S m a l l 2 Medium 3 L a r g e OUTPUT = 0 Normal = - 1 P arameter error = -2 No response from KBC = -3 VxD not registered[...]

175 A cquisition of Buzzer Volume Acquires the buzzer volume as one of four levels: L arge/Medium/Sm all/O F F. SYNTAX int SYS_GetBuzzerVolume(); INP U T None OUTPUT 0 OF F 1 S m a l l 2 Medium 3 L a r g e -2 No response from KBC -3 VxD not registered[...]

176 A cquisition of Device Power Status Acquires the current power conditions (ON/O F F) of each device. SYNTAX int SYS_GetDevicePower(int Device); INP U T Device = device to be selected 2 I r D A 3 14-pin I/F 5 8-pin I/F Other Reserved OUTPUT 1 Power ON 0 Power OFF Note: This function is used to control the power to devices of this sy stem. Never [...]

177 Device Power ON/OFF Used to turn ON and OFF the power of each dev ice. SYNTAX int SYS_SetDevicePower(int Device, int OnOff); INP U T Device = device to be selected 2 I r D A 3 14-pin I/F 5 8-pin I/F Other Reserved OnOff = ON /OFF setting 0 T u r n s O F F . 1 T u r n s O N . OUTPUT 0 Normal termination Note: This function is used to control the[...]

178 Software Card Lock Sets or acquires the Lock/Unlock status of the software- type card lock switch. This machine has a card lock m echanism that is on the card case to prevent accidental rem oval of the card. This mechanism has a software driver that detects the released state of this lock and executes the appropriate file closing procedure. How[...]

179 A cquisition of Connector Status Acquires the connection setting of the I/O Box and AC adaptor. SYNTAX int SYS_GetConnectorStatus(int nType); INP U T nType = Connector ty pe 0 I / O B o x 1 AC adaptor or I/O Box OUTPUT = 0 Not connected = 1 Connected = - 1 P arameter error[...]

180 Key Click Sound ON/OFF Sets the key click sound to ON or OF F. SYNTAX int SYS_SetKeyClck(int OnOff); INP U T n O n O f f = 0 O F F O t h e r t h a n 0 O N OUTPUT = 0 Normal = -2 No response from KBC = -3 VxD not registered[...]

181 A cquisition of Key Click Sound Status Acquires the key click sound ON/OFF setting. SYNTAX int SYS_GetKeyClick(); INP U T None OUTPUT = 0 O F F = 1 O N = -2 No response from KBC = -3 VxD not registered[...]

182 A cquisition of Reboot Reason Used to acquire the reason the system was rebooted. SYNTAX int SYS_GetPowerOnFactor(); INP U T None OUTPUT b0 Power key b1 Reset button b2 Alarm b3 Ring signal b4 IT- 2000 is being set on I/O Box Note : If the reset button is pressed the sy stem menu is initiated. This m eans that an application program will never [...]

183 A cquisition of OFF Reason Acquires the reason that the system was most recently turned OF F. SYNTAX int SYS_GetPowerOffFactor(); INP U T N o n e OUTPUT b0 Power key b1 Reset switch b2 Reserved b3 LBO b4,b6, b7 Reserved b5 L B1 timeout (indicates “OF F” by the condition of battery voltage low.) b8 APO b9 Software- triggered OFF b10 to b15 R[...]

184 Setting Cancellation of Next Resume Process Sets the power-on process (Resume/Boot) for each power OF F reason. The default setting is Resume On. SYNTAX int SYS_SetResumeCondition(int nCondition); INP U T nCondition = b0 Power key 0 = Resum e On, 1 = Boot b1 to b7 Reserved b8 APO 0 = Resume On, 1 = Boot b9 Software-triggered OF F 0 = Resume On,[...]

185 A cquisition of Cancellation Stat us of Next Resume Process Acquires the power-on process setting (Resume On/Boot) for each power- off reason. SYNTAX int SYS_GetResumeCondition(); INP U T None OUTPUT b0 Power key 0 = Resume ON, 1 = Boot b1 to b7 Reserved b8 APO 0 = Resume ON, 1 = Boot b9 Software-t riggered OFF 0 = Resume ON, 1 = Boot b10 to b1[...]

186 Request of Suspend (Softw are-triggered OFF) Used to turn off the system with the software. If there is a need to specify the next boot-up process, complete "Setting Cancellation of Next Resum e P rocess" beforehand, then call this function. SYNTAX void SYS_PowerOff(); INP U T None OUTPUT None[...]

187 A cquisition of Low Battery Voltage Status An APM (Advanced Power Management) BIOS has been installed in this term inal. This function is used to directly refer the hardw are conditions which are translated into input signals for the AP M BIOS. SYNTAX int SYS_GetLBStatus(); INP U T None OUTPUT b0 Reserved b1 LB1 event : Main battery voltage low[...]

188 Setting A PO Time Used to set a time until APO (A uto Power OFF ) occurs. SYNTAX int SYS_SetApoTime (int nValue); INP U T nValue = APO time 0 Does not cause APO. 1 to 15 Causes APO in the specified-number of m inutes plus 30 seconds. The actual APO time has an error of +/- 25 seconds. OUTPUT = 0 N o r m a l = - 1 P arameter error Note : Auto Po[...]

189 A cquisition of A PO Time Acquires the currently set APO time. SYNTAX int SYS_GetApoTime(); INP U T None OUTPUT 0 D i s a b l e t h e A P O . 1 to 15 Enable the APO in the specified-number of m inutes plus 30 seconds. The actual APO time has an error of +/- 25 seconds. Note : Auto Po wer OFF will work if the power control function is active. F [...]

190 Setting Status of A larm This function is used to set the alarm so that Int4Ah will be executed at the specified tim e. If the set time precedes the currently set RTC (Real Time Clock) time, the alarm will be valid on and after the following day. I f the setup time is later than the currently set RTC time, the alarm will be valid from the speci[...]

191 A cquisition of A larm Setting This function i s used to acquire the current al arm setting m ade for the RTC (Real Tim e Clock). SYNTAX void SYS_GetAlarm(int *hour, int *min, int *sec); INP U T hour = Pointer to the area from which hours is read. min = P ointer to the area from which m inutes is read. sec = Pointer to the area from which secon[...]

192 Resetting A larm This function prohibits an INT4Ah interrupt by internally calling INT1Ah (Ah = 7). Note that neither the time data set for the RTC is erased nor is the power ON alarm setting for the SYS_SetPowerOnAlarm() function canceled by this function. If this function is called with the power ON alarm active, the alarm is temporarily rese[...]

193 Setting/A cquisition of Pow er ON A larm This terminal has a function to automatically turn on the power to the main unit at the specified tim e. This function requires t he RTC (Real Time Clock) functi on. Normally , an INT4Ah interrupt w ill occur when the sett ing is being made on t he RTC. This function makes it possible to add the function[...]

194 Setting/A cquisition of Status of Pow er Control Function This terminal has incorporated unique power control functions: the auto pow er OFF mode and DOZE m ode (CP U low-speed operation m ode). Since these functions operate based on monitoring a period free from operator' s concern over a given interval, they have the potential of affecti[...]

195 Setting Ke y Click Sound ON This function is used b y application progra m to turn ON the ke y click sound. An exa m ple of the use is, when an button i m age on the L CD screen is touched it turns ON the sound. The sound is the sa m e tone as those when ten ke y and ke y pad are pressed. The setting of ke y click sound ON/O FF controls thi s s[...]

196 8.6.3 Key pad Library Overv iew The keypad library (Padctrl.vbx) is used to perform key input with the keyboard that is graphically displayed in the screen. This library can be made available w hen it is registered as a control on the application program. This control can be set up according to the specific properties including the modification[...]

197 Input acceptance mode There are two acceptance modes for key input. Dow n acceptance mode When the pen is down on the key pad, the touched area changes to reverse video, and the corresponding keycode is generated. The reverse v ideo area will return to normal when the pen is up. Even if the pen runs outside the corresponding key area in the mid[...]

198 (1) Initiate AppStadio, then select "File"- "InstallControls". Fi g. 8.12 (2) Move to the directory where the keypad library is placed and select "padctrl.vbx", then click on the "Install" button. When "PAD CTRL .VBX "is display ed in the "Installled" column, click on the "OK"[...]

199 (3) A new button is added in the lower section of the toolbox. Howev er, if other controls have been registered already, the left hand- side figure will include more buttons. Fi g. 8.14 With the above procedure registration of the key pad to AppStadio is completed. Explained next is the method of registering the key pad in the dialog. First, ad[...]

200 (2) As the following dialog is display ed, select "Dialog" and click on the "OK" button. Fi g. 8.16 With the above operation the dialog is added as a resource. (3) Next, click on the keypad button (as shown in the low er right of the left hand-side figure) of the tool box to the pressed-in position and click inside the dialo[...]

201 (4) Modify the key pad size so that all keys can appear within the screen. Fi g. 8.18 (5) Subsequently, lay out the necessary controls such as the edit box, etc. on the dialog. As the screen size of this system is 384 x 192 (pixels), layout the controls so they can be accomm odated in this range. Fi g. 8.19[...]

202 Note: The keypad library will transmit characters to the control which is focused at. Accordingly, if the focus is placed in other control than the edit box, click on the edit box or move the focus ov er the edit box with the program that is using SetF ocus(), etc. How to use w ith VB applicat ion In order to develop an application program that[...]

203 Where VB3 is used, select "Add F ile..." from the "F ile" menu. Fi g. 8.21 (2) When the following dialog appears for VB4, click on the "Browse..." button. Fi g. 8.22[...]

204 (3) When the following dialog is display ed, move to the directory where the keypad library is placed and select "padctrl.vbx" as the file name, then click on the "OK" button. Fi g. 8.23 In the case of VB3, the following dialog will appear instead of the dialog of (2). Then move to the directory where the key pad library is [...]

205 (4) In the case of VB4, clicking on the "OK " button makes the prev ious dialog restored. Make sure that the check box at t he right of "PADCTRL.VBX" i s checked, then click on the "OK" button. Fi g. 8.25 (5) The left hand-side figures show the results where a new button has been added in the lower section of the t[...]

206 Explained next is the method of registering the " keypad" in the dialog. (1) Fi rst double-click on the "key pad" button (the lower left button in the left hand-side figure), and the "key pad" is inserted as shown in the left hand-side figure. Fi g. 8.28 (2) Then modify the size of the "key pad" so that a[...]

207 (3) Subsequently, lay out the optional controls such as the edit box, etc. properly in the dialog. Because the size of the IT- 2000 display is 384 x 192 (pixel), lay out them so that they can be fit within the range. Fi g. 8.30 Note: The keypad library will transmit characters to the control which is focused at. Accordingly, if the focus is pla[...]

208 Explanation of properties List of properties Property Name Description PadStatus Key acceptance property Specifies Up or Down acceptance. PadShow K eypad display/ non-display property Specifies display/non- display of the keypad. Key No Expansion key number property Specifies which number of key is registered in the expansion keypad. ExtNo Expa[...]

209 Key pad display/non-display property Function This is a property to sw itch between display and non-display of the keypad. Property name P adStatus Type short Value 0 = non-display 1 = display (default) Form at <In case of VC> CVBControl* m_PadCtrl; m_PadCtrl->SetNumProperty("PadShow", 0 or 1); <In case of VB> Padctrl1.[...]

210 Expansion key code property Function This is a property to set up the key code of the expansion key to be registered. Property nam e Key Code Type short Value Key code to be set Form at <In case of VC> CVBControl* m_PadCtrl; m_PadCtrl->SetNumProperty(“KeyCode”, keycode); <In case of VB> Padctrl1. KeyCode = keycode Expansion k[...]

211 Example of expansion pad operation Registration of expansion k ey pad <In case of VC> void Cclass::SetProp( void ) { HBITMAP hBmp; PIC pic; HPIC hPic; // Loads the bitm ap from resouce hBmp = LoadBitmap( AfxGetInstanceHandle(), "bitmap resource name"); pic.picData.bmp.hbitmap = hBmp; pic.picType = PICTYPE_BITMAP; hPic = AfxSetPi[...]

212 Deletion of expansion key pad <In case of VC> void Cclass::DeleteProp( int KeyNo, int ExtNo ) { m_PadCtrl->SetNumProperty( "KeyNo", 0 ); // Registration of Key No. ( 0 t o 4 7 ) m_PadCtrl->SetNumProperty( "ExtNo", 1 ); // Registration of expansion pad No. (1 to 2) m_PadCtrl->SetNumProperty( "ExtPad",[...]

213 8.6.4 OB R Library O v er v iew The OBR librar y is used to control the OBRs (Barcode Reader) fro m application progra m s developed b y the user with the C language or Visual BAS I C. I t supports the follow ing two OBRs : DT-9650BCR : Pen-type barcode reader DT-9656BCR : CCD barcode reader Note about the Libraries This librar y consists of th[...]

214 Reception Buffer This library uses two reception buffers, as shown below, so that during the processing (read) of one of the received barcodes the next barcode can be successfully received. Fi g. 8.31 The following explains the operation sequence by which codes are put into the reception buffer. When the first barcode is received, it will be te[...]

215 Data Format The reception data format is defined as follows: Barcode O Fi g. 8.32[...]

216 List of A v ailable Functions P age. F unction Description 216 OBR_O pen I nitialization of COM port and power on 217 OBR_Close Release of COM port and power off 218 OBR_Send Trans m ission of co mm and to OBR 219 OBR_Stat Acknowledg m ent of received data 220 OBR_Read Read of the received data 221 OBR_Clear I nvalidation of codes in reception [...]

217 Release of COM Port Releases the COM port and turns off the power to the COM port. SYNTAX #include "obrlib.h" void FAR PASCAL _export OBR_Close(); INP U T None OUTPUT None Note : Call this function if completing the use of the OBR (i.e. term inating the application program).[...]

218 Transmission of Command Transmits a com mand represented by a single ASCII code to the OBR. Various options including "Readout mode" , "Data transfer format", etc., can be set for this transmission. This setup does not have to be made each tim e the power is turned on if it is written in the EEP ROM. For inform ation about t[...]

219 A cknow ledgment of Receiv ed Data Validates barcode data in the reception buffer of the Library . If data is not received com pletely as barcode data after the validation, it will be acknowledged as invalid date. SYNTAX #include "obrlib.h" int FAR PASCAL _export OBR_Stat(); INP U T None OUTPUT The absolute value shows the num ber of [...]

220 Readout of Received Data Acquires the first barcode in the reception buffer and writes it to the specified buffer. The reception data SYNTA X is as follows: B a r c o d e O Fi g. 8.33 SYNTAX #include "obrlib.h" int FAR PASCAL _export OBR_Read(void far *pBuf); INP U T pBuf = Pointer to the buffer that stores the received barcode OUTPUT[...]

221 Invalidating Code in Buffer Invalidates a barcode in the reception buffer and clears the reception buffer. SYNTAX #include "obrlib.h" void FAR PASCAL _export OBR_Clear(); INP U T None OUTPUT None[...]

222 Setting ev ent of reception completion When a barcode data is received completely , specified message can be sent as user event to the specified handle. This library will send a m essage to specified window handle using the SendMessage AP I. Specified hWnd, uMsg, wParam, lParam are used as param eter for the SendMessage AP I. SYNTAX #include ?[...]

223 Setting Operation Mode / DT-9650BCR O v er v iew On this OBR various settings, as listed below, can be m ade through co mm and trans m ission. F or a list of the actual co mm ands refer to the Co mm and L ist on page 225. 1 . Specif y ing the nu m ber of read digits 2 . Specif y ing the CODE39/NW - 7 I CG code 3. Readabilit y o f code 4 . Data [...]

224 Example: To set the CODE39 C/D to "Prevent check (without changing the transfer function)" with the corresponding expanded com mands OBR_Send (“u”); OBR_Send (“A”); OBR_Send (“v”); Pow e r-save Mode Control Command Used to control the power-sav e mode of the OBR. See the following diagram . Example Fi g. 8.34 Writing Set V[...]

225 Comm a n d L i s t (Italic and bold letters indicate default value) 1 Specifying the num ber of read digits No. of digits Comm and No. of digits Comm and No. of digits Comm and 1 to 42 ^P 16 (space) 32 0 1 ^Q 17 ! 33 1 2 ^R 18 “ 34 2 3 ^S 19 # 35 3 4 ^T 20 $ 36 4 5 ^U 21 % 37 5 6 ^V 22 & 38 6 7 ^W 23 ‘ 39 7 8 ^X 24 ( 40 8 9 ^Y 25 ) 41 9[...]

226 NW-7 start/stop code T r a n s f e r N o t t r a n s f e r Change codes to uppercase characters Change codes to lowercase characters E n a b l e t r a n s f e r o f A B C c o d e D i s a b l e t r a n s f e r o f A B C c o d e [ { q r j k Yes -- Yes -- -- Yes C/D (CODE39/NW-7/2of5/CODE11) D i s a b l e c h e c k E n a b l e t r a n s f e r o f [...]

227 NW-7 C/D Disable check (without changing the transfer f u n c t i o n ) E n a b l e c h e c k / T r a n s f e r E n a b l e c h e c k / N o t t r a n s f e r D i s a b l e c h e c k / N o t t r a n s f e r D i s a b l e c h e c k / T r a n s f e r D E F [ -- -- -- -- Yes 2 of 5 C/D Disable check (without changing the transfer f u n c t i o n ) [...]

228 Setting Operation Mode / DT-9656BCR Overv iew On the OBR various settings, as listed below, can be m ade through command transm ission. For a list of actual com mands refer to the Comm and List on page 229. 1. Readability of code 2. Adding a readable code 3. Data t ransfer SYNTAX 4. Condition for the least significant digits 5. Specifying the b[...]

229 Command List Ite m Co mman d Default Read all codes A0 -- UPC only J1 -- UPC + 2 digits of supplemental only J2 -- UPC + 5 digits of supplemental only J3 -- EAN only J4 -- EAN + 2 digits of supplemental only J5 -- EAN + 5 digits of supplemental only J6 -- DTF only J7 -- ITF only J8 -- CODE39 only A2 -- NW-7 (CODABAR) only A3 -- CODE93 only A5 -[...]

230 UPC-A 1 3 d i g i t s : T r a n s f e r a l l 12 digits: Not transfer "0" header for adjusting the n u m b e r o f d i g i t s 1 2 d i g i t s : N o t t r a n s f e r C / D 11 digits: Not transfer C/D and "0" header for adjusting the number of digits E2 E3 E4 E5 Yes -- -- -- UPC-E 8 d i g i t s : T r a n s f e r a l l 7digit[...]

231 8. Read time Inf inite 2 s e c 4 s e c 6 s e c 8 s e c 10 sec 15 sec 20 sec Y0 Y1 Y2 Y3 Y4 Y5 Y6 Y7 Yes -- -- -- -- -- -- -- 9. Contrast of normal /reverse Normal contrast Both normal/reverse contrast V2 V4 Yes -- 10. No. of veri fications No verification Verification twice Verification three times Verification four times X0 X1 X2 X3 -- Yes -- [...]

232 CODE93 N o t t r a n s f e r T r a n s f e r 2M 3M Yes -- CODE128 N o t t r a n s f e r T r a n s f e r 2N 3N Yes -- MSI/Plessey N o t t r a n s f e r T r a n s f e r 2O 3O Yes -- 12. Specify write to EEPROM Z2 --[...]

233 8.6.5 YMODE M Library O v er v iew This librar y is used to transfer files fro m Windows applications using the YMODEM/bat protocol. The YMODEM librar y consists of a group of the following files. YMODEM.H Heade r fil e fo r s y ste m librar y (fo r C language) L ibYMOD. L I B YMODE M librar y fo r C language (fo r C language) YMODEM.D LL Mai n[...]

234 Error codes Each function of this library will return the following v alues as the error code. Error code Description 1 Dialog box creation error, etc. 3 Transm ission file not exist 4 Reception file creation error 5 Com munication time- out 7 Reception file write error 8 Com munication API error of Windows OpenYMODEM This function should be ca[...]

235 SendBy YMODEM This function is used to transmit a file by means of the YMODEM/bat protocol. Before this function is called, the OpenYMODEM function must hav e been called. SYNTAX #include "ymodem.h" short WINAPI _export SendByYMODEM(short iPkt, short nFiles, LPSTR *sPath, BOOL bFullFileName, BOOL bFindSubDir ) short WINAPI _export Sen[...]

236 Reciev eBy YMODEM This function is used to receive a file by means of the YMODEM/bat protocol. Before this function is called, the OpenYMODEM function must hav e been called. SYNTAX #include "ymodem.h" short WINAPI _export RecieveByYMODEM(LPCSTR cDirectory ) INP U T cDirectory = Received file storage directory (by full pathnam e) OUTP[...]

237 SetCommForYMODEM This function is used to set up the comm unication parameters (baud rate, parity, and stop bit) to be used by the YMODEM library . Before this function is called, the COM port must hav e been opened by the OpenYMODEM function. SYNTAX #include "ymodem.h" short WINAPI _export SetCommForYMODEM( long lBaud, short iParity,[...]

238 CloseYMODEM If this function is called, the use of YMODEM library is completed, and the COM port is closed. SYNTAX #include "ymodem.h" short WINAPI _export CloseYMODEM( void ) INP U T N o n e OUTPUT = 0 Normal termination = Other Refer to the error code table.[...]

239 8.6.6 FLINK Library Overv iew The FL INK library (FL INK.DLL ) is a utility used to perform communication between two I T-2000 terminals or between the term inal and a personal computer via the infrared com munication interface (IrDA). I t is a 16-bit dynam ic link library (DL L). The F LINK function is called from its external function. WIN.IN[...]

240 Setup values of WIN.INI file Set up the IrDA section of the WIN.INI as follows; [IrDA.COM2] IrDA=ON MaxBaudRate=115200 * To be set according to the comm unication speed employed. SizeWindow=1 SizeData=2048 DisconnectThresholdTime=3 MaxTurnAroundTime=500 MinTurnAroundTime=5000 NumBOF=0 DeviceNickName=devicenickname * Can be an optional character[...]

241 int DoFlink(int argc, char** argv) This executes the FL INK protocol and v arious processes. SYMTAX int DoFlink(int argc, char** argv) INP U T argc = Number of input param eters argv = Pointer to the parameter array OUTPUT: 0 Normal termination Example This is an example of transmitting the "C: test temp.c" file of my HT so that it ov[...]

242 Example This is an example of using the DoF linkForVB function to transm it the "C: test tem p.c" file on the source side so that it overwrites the "C: check " directory on the destination side . /* Code in VB */ Dim sht As Integer Dim hWnd1 As Long Dim hInst As Long ReDim Strz(3) As String hInst = GetModuleHandle("flin[...]

243 File deletion int argc = 3; char* argv[] = {“fl”, “/d”, “c: dstn_sir *.dat”} File move int argc = 4; char* argv[] = {“fl”, “/n”, “c: src_dir src.dat”, “c: dstn_dir dstn.dat” } File transmission with the optional communication param eters set int argc = 5; char* argv[] = {“fl”, “/y={38k,1,,,,,,,}”, “/s”, ?[...]

244 Communication Commands File Transmission (/S) Function This function transmits a file on the execution- side machine to the comm unication partner. If the specified destination directory does not exist on the partner side, it will be autom atically created. Starting method int argc = number of parameter arguments char* argv = { "fl", [...]

245 Parameter setup exam ples argc = 4 argv[] = {“fl” , ”/S” , ”a: info *.dat” , ”d: data ”} With this specification all files with a "DAT" extension under the " info" directory of the drive A of the execution-side m achine will be transferred to the "d: data " directory on the partner side. argv = 4 ar[...]

246 File Reception (/R) Function This function is used to receive a file that exists on the comm unication partner side by specify ing the request pathname. I f the directory specified as the reception directory does not exist on the execution side, it will be automatically created. Starting method int argc = number of param eter arguments char * a[...]

247 Parameter setup exam ples argc = 5 argv[] = {“fl” , ”/R” , ”a: test *.dat” , ”d: info *.*” , ”b: data ”} With this specification all files with a "DAT" extension under the " test" directory of the driv e A on the partner-side machine and all files under the " info" directory of the driv e D will[...]

248 File A ppend (/A ) Function This function appends the contents of a file that is specified by the append file pathnam e to a file that is specified by the target file pathnam e. Note: File contents will be appended using the binary method (i.e. if the target file ends with an EOF code, data is appended after it). Starting method int argc = 4 ch[...]

249 File Deletion (/D) Function This function deletes a file that exists on the comm unication partner side. Starting method int argc = Number of param eter arguments char* argv[] = { "fl", " /D", "deleted file pathname" [, "deleted file pathname"] } DoFlink(argc, argv) Deleted file pathnam e Specify the file[...]

250 File Move/File Rename (/N) Function This function is used to move the specified file (m ove source pathname) on the com munication partner side to the move destination pathnam e. This function is used specifically to m ove or rename files within the same drive. Starting method int argc = 4 char* argv[] = { "fl", " /N", "[...]

251 Idle Start Function This function is used to transfer the request right to the partner side. This function will be terminated if it is abnormally terminated, or if a termination designation is transm itted or received. If a script file is specified, comm unication will progress according to the contents of the specified script file that exists [...]

252 IrDA Environment Setup Commands Wait Time Setup (/L) Function This function sets up the Wait time for com munication. Starting method int argc = Number of param eter arguments char* argv[] = { "fl", "/L={, wait time for connection establishm ent, wait time for data reception/transmission,,,,}" } DoFlink(argc, argv ) If the p[...]

253 COM Environment Setup (/Y) Function This function sets up the environm ent of COM port. Starting method int argc = Number of param eter arguments char* argv[] = { "fl" , "/Y={comm unication speed, COM specification,,,,,,,}" } DoFlink(argc, argv ) If the param eters for the Y option do not have to be entered, enter only com m[...]

254 Follow ing the parameter setting shown on the previous page as exam ple, the communication specifications can be set according to the details listed in the table below. Parameter Process value Rem ark Comm unication speed 9600 bps Default COM specification COM1 (RS-232C) Data bits 8 bits Fixed Parity None Fi xed Stop bit 1 bit Fixed[...]

255 List of termination codes The following table shows the term ination codes returned by F LINK .DLL . Note that only the termination code (i.e. with no m essage) will be displayed at a termination. End Code Category Detail Code (High) (LOW) Description Normal end 00h 00h Normal end. 0DCh - 0F 5h 00h Drive (A to Z) format notice. F6h 00h P ower o[...]

256 End Code Category Detail Code Protocol Error Description 01h 00h Comm and error (undefined function code). 01h 01h Comm and error (undefined sub-function code). 01h 02h Comm and error (not execute command). 01h 03h Check sum error. 01h 04h Comm and sequence error. 01h 05h Sequence number error. 01h 06h Other protocol error. 01h 07h Parameter er[...]

257 9. Utility 9.1 Ov erview The development kit contains som e utility programs to be used as required. Calculator Utility Calculator program including m emory calculation implementing the CASI O standard specifications . Clock Utility Used to refer the date and time of the built-in clock and to set the power ON alarm. Calendar U tility Used to re[...]

258 9.2 Calculator Utility Overv iew Use this calculator utility for decim al calculations. This utility provides arithm etic calculations, mem ory calculations and the function to transfer a result of calculations to text box in application program. I t is provided as a Windows application. File Name WCALC.EXE Fi g. 9.1 Function The calculator uti[...]

259 Startup Method This utility is not stored in the basic drive (C: ). I t must be copied to RAM disk (A: ) or FROM drive (D: ) and can be started up from Windows. Basic Function Operation of the utility is perform ed by inputs from Ten key and Touch panel. Ten Key Key Description 0 to 9 I nput numeral. . (decimal) Input decimal point. - Subtracti[...]

260 9 .3 Clock Utility Overv iew The clock utility is used to reference the current tim e, set the date and time, or set an alarm. This utility is provided as a Windows utility . Fi g. 9.2 File Nam e WCLOCK.EXE Function The clock utility provides the following functions: Displays the current tim e in digital or analog mode. 12-hour sy stem or 24- h[...]

261 Setup File The display form ats for date and time, and logo can be specified at this setup file (WCL OCK.INI ). The setup file must be stored in the directory of D: WI NDOWS. If it does not exist, and WCLOCK.EXE is executed, it will be automatically created. The following shows how to specify the WCLOCK .INI. [INTL] DATE= display format of date[...]

262 9.4 Calendar Utility Overv iew Use this calendar utility for referring to dates. This utility is provided as a Windows utility. Fi g. 9.3 File Name WCAL.EXE Function The calendar utility provides the following functions: Displays a calendar for two months on one screen page. At start up, the current system date will be displayed in the top sect[...]

263 9.5 Remaining Battery Voltage Display Utility Overv iew The remaining battery voltage display utility is used to monitor the remaining v oltage of the main battery and sub-battery . This utility is provided as a Windows utility . Fi g. 9.4 File Name WCHKBATT.EXE Function Display for rem aining battery voltage of main battery The remaining batte[...]

264 9.6 FLINK Utility Overv iew The FL INK Utility is used to perform comm unication either between the IT-2000 and PC, or between two IT-2000s by means of the I rDA protocol. This utility is prov ided as DO S application. It can be called as single com mand line or as a child process of the application program. Function IrDA comm unication method [...]

265 9.6.1 Communication Parameter Setup Command (/L={,,,} Sets up comm and parameters according to the comm and specified next to "=". If the com munication environm ent command needs to be specified, this com mand must precede it. Command Specification Method FLINK /L={ maxim um IrDA speed, wait time until the connection is established, [...]

266 Example of specification FLINK /L={4M, 20, } Meaning: Communication will be perform ed with a maxim um IrDA speed of 4 Mbps, the wait time until the connection is established is 20 seconds, and the data transmission/reception wait tim e is default-set to 300 seconds.[...]

267 9.6.2 File Transmission (/S) Function This function transmits a file from the term inal machine to the host m achine. If the directory specified by the "storage destination directory name" does not exist on the host side, it will be automatically created. If the identical file name exists on the host side, it will be forcibly overwrit[...]

268 Example of specifications of st orage destination director y name Specification of root directory D: Specification of sub - directory D: TEST B I N I ncorrect specification D: TEST Note: I f the host (reception) side has a file with the identical na m e, this co mm and will forcibl y overwrite that file. However, this overw rite operation is no[...]

269 9.6.3 File Reception (/R) Function This function receives a file from the host. The objectiv e file name is specified by the full pathname (including the drive nam e) on the host. The received file is saved in the directory specified by the terminal side. I f the specified directory does not exist on the terminal, it will be autom atically crea[...]

270 Note: If the term inal (reception) side has a file with the identical name, this comm and will forcibly overwrite that file. Howev er, this overwrite operation is not unconditional. This comm and first creates a temporary file in the disk of the terminal, then it overwrites the file after transm ission has been completed. This is a safety measu[...]

271 9.6.4 File A ppend (/A ) Function This function appends (concatenates) a file on the terminal to the end of a specified file on the host. The objective file will be appended as a binary file. I n other words, the data will be concatenated after the EOF code, if one exists. This function is valid only for transmission. Any files received from th[...]

272 9.6.5 File Deletion (/D) Function This function deletes a file on the host. Startup Method FLINK /D[Option] deleted pathname [deleted pathname...] Option Option Description H If HT-to- HT communication is to be perform ed, specify this option on the term inal. Deletion by pathname Specify the objectiv e file to be deleted by its full pathname, [...]

273 9.6.6 File Mov e/Rename (/N) Function This function moves a file w ithin the same drive or renames the file on the host. A file cannot be moved into a different driv e. Startup Method FLINK /N[Option] move source pathname move destination pathname Option Option Description H If HT-to- HT communication is to be perform ed, specify this option on[...]

274 9.6.7 Idle Start Function This function passes the right of comm unication request to the terminal and enters the comm and reception wait state. This function will be terminated if it is abnormally terminated, if it transmits a designation of termination, or if reception has been com pleted. Startup Method FLINK (No specific command exists.) Ex[...]

275 9.6.8 Termination Codes and Messages In the following table, term ination codes and their error messages returned by FLI NK.EXE are described. Error Code Error Message Description Cat egory (High) Detail (Low ) Normal En d 0x00 0x00 NORMA L ENDING Normal en d. 0xDC-F5 0x00 A ZDRIVE FORMAT NOTICE Format notification of drives A to Z 0xF6 0x0 0 P[...]

276 Note: Besides th e detail codes w hich are def ined in F ile Error (INT24h) above, other error codes may be returned as f atal error code of DOS. Proto col Erro r (File) 0x04 0x00 CANNOT OVERWRITE File is “read -o nly”. IrDA Protocol Error (For deta il refer to the table on the nex t page.) 0x80 0x01 Open e rror. 0x80 0x02 Data s end error.[...]

277 9.7 XY Utility Overv iew The XY utility is used to perform com munication either between an IT-2000 and PC, or between two IT- 2000 terminals by means of XMODEM or YMODEM BATCH protocol. This utility is provided as a DOS application and should be activated as a com mand line or as child-process of the application program . File name: XY.EXE Fun[...]

278 About time stamping of files: This utility supports the function to exchange tim e stamp information between the transm itted file and received file. The time stam p information to be exchanged will be processed assuming that it is Greenwich standard time. I n contrast, the time used by the IT-2000 is the local time, and the tim e stamp of I T-[...]

279 Command Alway s specify /S or /R. This comm and must be specified as the first parameter. /R | /S Transmission or reception specification /R: File reception /S: File transm ission (Both /R and /S cannot be specified at the same tim e.) Option After the comm and, specify the appropriate options. The options must be specified in the follow ing or[...]

280 Other parameters Specify the options im mediately after (without inserting a space) the command. Options m ust be specified in the following order: /N Suppression of message display Specify this option if a copy right message or error m essage is suppressed from being outputted. /BN Specification of a baud rate (If omitted, 2 (9600 bps) is em p[...]

281 Example of specifications XY /SY A: WORK TEST.DAT T ransfers “A: WORK TEST.D AT” at transmission side. “TEST.DAT” can be copied in the current directory at reception side. XY /SY /P A: WORK TEST.DAT Transfers “A: WO RK TEST.DAT” at transmission side. “A: WO RK TEST.DAT” can be copied at reception side. I f “A : WO RK” does n[...]

282 9.8 Rev erse Video Utility Overv iew This utility is used to change the entire screen to reverse v ideo. From the nature of the FSTN sem i-transparent type L CD unit of this terminal the density of colors (tones) will be reversed. So, for example, a light color appears dark and a dark color appears light. To avoid this problem use this supplied[...]

283 9.9 COM2KEY Utility Overv iew This utility is a debug tool that allows key input at the DOS prom pt from the personal computer. If this utility is resident in memory , the data entered in COM1 will be passed to the key buffer, and the characters displayed on the DOS prompt screen will be outputted for COM1. Therefore, if this terminal is connec[...]

284 9.10 Window s Installation Utility Overv iew MS-Windows has been installed on the MASK ROM drive (E:). However, MS- Windows cannot be booted directly from the MASK ROM drive. This is because MS-Windows will overwrite som e of the INI files at start up. However, since all the files including the I NI files are initially located in the MASK ROM d[...]

285 Operation at Menu Start up WINST.EXE can run either on the I T-2000 or on a personal computer. Howev er, since the IT-2000 is not provided with an arrow key to move the bar- type cursor, use the following key operations. IT- 2000 P C Move cursor up "8" "8" or Up arrow Move cursor down "2" "2" or Down arro[...]

286 WINST.INF The WINST.I NF file is used to make installation procedure specifications for WI NST.EXE. The method used to write the WI NST.INF file is the sam e as that used for the INI file in MS-Windows. For inform ation about each setup item refer to the following table. Setup Section Description CopyOriginal= yes or no If set to "y es&quo[...]

287 Specifies the keyboard to be used. F rom the Setting colum n of the table shown below select a value to be placed on the right side of the equation. Country K ind Setting Country K ind Setting Belgian BEL G IAN Brazilian BR AZILI A British B RITISH Canadian Multil ingual CANADIAN Danish DANISH Dutch DUTCH Fin n is h FIN NIS H Fr en c h FR E N C[...]

288 Example of Using WINST.EXE Preparation of necessary files The table shown below includes files essential for setting up WINST.I NF. If, for exam ple, the application program uses the OBR library , make the following settings for WI NST.INF: UpdateDrivers=yes and UseOBR=y es. Then place OBRLIB.DL L in the same directory as WINST.EXE/WI NST.INF. [...]

289 MD G: WINDOWS COPY E: WINDOWS LOCAL G: WINDOWS If the I rDA interface is used to load COMM.DRV with the following procedure. COPY E: WINDOWS COMM.DRV G: COMM.DRV must be stored in the sam e directory as WI NST.EXE. Therefore, in the above example it is loaded onto the root directory . Copy the loaded files onto an appropriate directory in the p[...]

290 Example of execution on the IT- 2000 Directly set up the env ironment by executing WINST.EXE on the I T-2000. If WI NST.EXE and the other essential files are stored in the PC card, the card can be used for installation. Prepare the objective installation files, including WINST.EXE and WINST.INF , in the ATA card. Add a line for loading WINST.EX[...]

291 A PPENDIX A : TFORMA T.EXE In this chapter, TF ORMAT.EXE, the formatter for F -ROM drive (D:) of I T-2000, is explained. The TFORMAT.EX E is necessary to form at the drive (D:). It is resided in the basic drive (C:). The syntax of the TF ORMAT comm and is; TFORMAT [drive-letter] [/LABEL:label] [/SPARE:n] [/Y] Example of Syntax : TFORMAT 2 /SPAR[...]

292 A PPENDIX B: PC Card Driv er In this chapter, each PC card driver which is called by CON F IG.SYS or by AUTOEXEC.BA T is explained. These PC card drivers and INI file are stored in the directory , C: CARDSOF T, on the basic drive (C: ). System Soft’s Ca rdWi zard PC card solution provides OEMs with a complete software solution for integrating[...]

293 Card Identification (CA RDID.EXE) This client device driver detects the insertion and rem oval of PC cards, automatically determ ines the card type upon insertion, and then configures the card and slot/adaptor (if it is an I /O Card). SRA M Card Driver (M TSRA M.EXE) This System Soft device driver recognizes and supports SRAM cards. IDE/A TA Su[...]

294 Refer to ATA Driver Modes section which follows. Card Service Power Management Enabler (CS_A PM.EXE) CS_APM.EXE is a DOS-based background task that enables Card Services to process sy stem power managem ent Suspend/R esum e requests. When a Su spend request is initiated by system power managem ent software, CS_AP M notifies Card Services, which[...]

295 A PPENDIX C: A cquisition of Suspend/Resume Event and Power Status Overv iew Suspend/Resume event is notified by multiplex interrupt (INT2F h). If any ev ent such as power ON/OFF occurs, consequently the interrupt (INT2Fh) will occur. An application can acquire the event by catching the interrupt. Since the interrupt INT2Fh is multiplex interru[...]

296 A cquisition of Pow er Status Application can acquire current power status by calling AP M BIOS through the interrupt I NT15h. The following power statuses can be acquired by using the method. AC line status Battery status Battery flag Remaining battery life - percentage of charge Remaining battery life - time unites The functions detailed belo[...]

297 DX = R emaining battery life - tim e unit bit 15 = 0 : Time unit is in second. 1 : Time unit is in m inute bits 14 to 0 = value for second or m inutes 0 t o 7FFFh : V a li d v al ue f or se c ond or minute FF h : Unknown If function unsuccessful: Carry = 1 AH = Error code 09h : Unrecognized device I D End of the Manual[...]