Unitech MR350MKII manual Programming by JobGen PRO, Programming by C/C++

Page 82

5.1.1. Programming by JobGen PRO

The JOB GENerator PROfessional (JobGenPRO) is an MS-DOS based software for developing applications for MR350MKII. With JobGenPRO, application developers may create an application program easily by defining the transactions, attributes of data fields and operation flow without writing program code. An executable program generated by JobGenPRO can be downloaded and run on the MR350 MKII then.

A JobGenPRO application consists of three files with same filename and different file extension:

.CFG Configuration of environment, communication and I/O interfaces of terminal.

.JB2 Definition of transactions, data fields and operation flow.

.EXE Execution program generated by JobGenPRO after linked a defined application.

The main features of JobGenPRO are listed below:

?Interactive user interface with pop-up windows.

?Define system configuration of the MR350 MKII.

?Define data fields and process flow.

?Download a JobgenPRO application to the MR350 MKII with lookup data files.

?Upload the collected data files from MR350 MKII to PC.

?Print specification of a JobgenPRO application for documentation.

?Application simulation on PC.

5.1.2. Programming by C/C++

The Unique advantage of MR350MKII is to give application programmer the power of the industry standard personal computer. Programmers develop MR350MKII applications by using standard C language and off-the-shelf Microsoft C / Borland C compiler on personal computers. The complied executable code is then download to MR350MKII through RS-232 / RS-485 link using Multipoint download.

Borland/Microsoft C/C++ compiler supports a superset of standard C programming language. MR350MKII provides the standard ANSI C functionality. As a result, some Microsoft extensions or DOS specific functions are not supported. For detail standard C function that are supported by MR350MKII firmware, please refer to Appendix A.

Unitech also provide a utility C (485LIB.C) library for user to develop their application program. The 350LIB.C incorporates a rich set of libraries to interface

5-81

Image 82

Contents Programming Reference Manual September 2001Introduction Table of Contents RS-485 port serial I/O using General Control Commands Error! Bookmark not defined System Kernel Application Programming InterfaceKeypad Subsystem Display SubsystemCommunication Subsystem Point to point modeMulti-point mode Real time clock subsystem? MS-KermitSEND file name Download Program in Point-to-point modeBar code / Magnetic stripe / Proximity / ICC ? MS-KermitGET file nameDownload Program in Multi-point mode COM1-4?Then, the screen will display MR350MKIISet beepers volume Page Device Control Table DevconfigData Structure Type DefinitionBarcode Control Table BarcodeconfigType Definition Byte ComconfigCommunication Control Table of Host port WordTerminal Control Table available for host port only Page Page Clear screen O Function CallsLCD Display INT 10H Set cursor typeGet cursor position 1A Enable/disable LCD Backlight INT 21HScroll screen Communication Environment Setup 1C Select COM1 or COM2 as the host portXON/XOFF Set host port protocol1C Set serial port flow control CTS/RTSSet COM1 port as RS485 or modem 1C Setup multi-point address1C Set polling timeout duration Host Port for Multi-point Protocol I/O INT21HOutput data Read host portCheck if Busy-port Serial I/O for RS-232 and RS-485 RS-232 port serial I/O using INT 34HInput data Set Communication parameters Disable RS-232 portBIT # Page Read CTS signal of RS-232 port Set RTS signal of RS-232 portRS-485 port serial I/O using INT 33H Enable RS-485 port for serial I/O Disable RS-485 port for serial I/OInt860x33,s,s Open RS-485 multi-bus to send out data Close RS-485 multi-bus release RS-485 bus Read Photo Coupler Level state INT 08H Relay Output / Digit Input / Buzzer / LED IndicatorSet LED indicator ON/OFF LOWClose Activate/Deactivate Relay ports INT 09HOpen 1A Buzzer On/OffAlarm On/Off 1A Set buzzer volumeGet Security state 21H Enable/Disable External reader port Internal/ External reader Port INT 21HRead Internal port CodabarEnable/disable Internal reader 1F Get Decoder status of Wiegand Format Proximity reader EAN/UPC 1F Enable the decoding of a barcode symbology1A Check lithium battery level Miscellaneous INT 21HSet interrupt vector 1B Get Address ID of the terminalGet interrupt vector Get free disk cluster 1E Change the Keyboard mapAscii code corresponded to scan code in Numeric mode Ascii code vs. scan code cross reference table numeric modeDOS Manager Ascii code corresponded to scan code in Alphabetic modeWrite stdout Write stdaux COM2 RS-232 port Read stdaux COM2 RS-232 portRead / Write stdin or return 0 if none is ready Read stdin wait if no key Write character string to stdoutDate/Time 0A Keyboard buffer inputKeyhit check 2A Get System dateSet System date 2C Get System clockFile Manager 2D Set System clock3C Create or truncate file 3D Open file Close file3F Read file Write fileDelete file Move file pointerGet file attribute Rename a fileFree allocated memory Modify allocated blockThis page is blank Host ESC Commands General Control CommandsExecute Flash ROM program ESC X/ROM filename Abort ESC aExecute ESC X filename Directory ESC DDisable UPS battery ESC F Autoboot ESC O program namePassword ESC P password Get RAM size ESC GConfiguration Commands Barcode symbology Configuration ESC B Device Configuration ESCDate/Time Configuration ESC M Upload ESC U filename File Transfer CommandsDownload ESC L filename Multipoint ProtocolCS2 CMDCS1 STX ESC L a . E X E CS1 CS2 AddrTerminal Transmissions Host TransmissionsProtocol Operation ESC 0 Application data CommandsSTX ESC ESC B Enable/disable the decoding of barcode symbologies ESC 9 Send diagnostic test dataESC a Soft Reset, Restart, or Abort ESC C Write communication configuration table to MR350MKIIESC D/ROM Read directory of Flash ROM to host ESC F Disable UPS battery to supply powerESC D Read directory of RAM disk to host ESC E Erase a file from the MR350MKII directoryESC I Get filename of current executing program ESC H Hard Reset and initiate power on testESC G/ROM Get MR350MKIIs Flash ROM size ESC J Check if file existed or notESC L Transfer file to MR350MKII ESC N Set Buzzer VolumeESC K Set keyboard locking ESC M Write date and time to MR350MKIIESC V Write device configuration table to MR350MKII ESC P Set supervisor password maxi charactersESC T Write terminal configuration table to MR350MKII ESC O/ROM Set auto-execution program on ROMESC X Start program execution ESC Commands Added for MV1100 Fingerprint ModuleESC v Get Terminal ID and version no ESC X Start program execution on ROMSTX ESC $D Result CS1 CS2 ETX STX ESC $D CS1 CS2 AddrNAK Result STX ESC $E Result CS1 CS2 ETX NAK STX ESC $F Result QUALITY, Content CS1 CS2 ETX NAKESC $E Erase Template ESC $F Enroll and Store Template on MR350 MkiiESC $G Enroll and Store Template on MV1100 ESC $H Verify TemplateESC $I Verify ID ESC $L Download TemplateESC $S Set Globe Threshold ESC $S Get Globe ThresholdESC $U Upload Template ESC $V Get VersionPage How to programning ? Programming MR350 MkiiProgramming by JobGen PRO Programming by C/C++Programming communication program Contains of the Demo Disk Data Conversion Buffer ManipulationCharacter Classification and Conversion File HandlingString Manipulation Memory AllocationPorcess Control exit Searching and Sorting MS-DOS Interface