7526 DCT Reference

Programming Support Diskette

• CFRAPI26.LIB

  This library file includes the Custom Function Routine APIs to the 7526's built-in microcode, and special C run-time startup code which makes it possible for C programs to operate in the 7526's environment.

• CFRAPI26.H

  This C header file includes function prototypes for the CFR API routines, definitions for function arguments, and return codes.

• SMPCFR26.C

  This is a sample Custom Function Routine for the 7526 which demonstrates the implementation of several useful extensions to the terminal's transaction programming command set:

  • Send to and receive from optional RS-232 serial ports.
  • Parallel printer port spooler.
  • Deluxe keypad/scanner input routine.
  • Wait for user variable to be set.
  • String comparison of two user variable's contents.
  • Integer comparison of two user variable's contents.
  • Arithmetic (+, &minus, *, and /) operations on integers in 2 user variables.
  • Retrieving and formatting the current time and date into a user variable(s).
  • Clearing the display screen so a special message may be displayed, and then restoring the original text.
  • Controlling of two employee entrance/exit gates using two bar code readers connected to a single 7526 terminal. When used with the High Performance Bar Code Reading Coprocessor feature, this CFR function allows simultaneous bar code reads on both sensor ports, and then pseudo-simultaneous validation of each read and operation of indicator lights and gate locks connected to DO points.
  • Sample a digital input counter and place the resulting numeric string into a user variable, reset a counter to zero, increment or decrement a counter.
  • Sample the rate at which digital inputs are switching (for a definable sample period).
  • Variable time delay with 5 millisecond resolution and accuracy.
  • Check contents of a user variable for uniqueness among the last 10 inputs (i.e. to avoid counting or processing the same bar coded item more than once).

  Refer to the source code header area for details on usage of each of these functions. The source file is arranged with each function isolated within code blocks which can be skipped during compilation using #if defined statements. Simply comment-out the #define statement for each function to prevent it from being compiled into the executable program. This allows easy tailoring of the source to produce a CFR with only the functions required while minimizing code and data area sizes.

• Various compiled (.EXE) CFR files. Refer to the READ.ME file on the diskette for details of the function built into each executable.
• SMPCFR26.INF

  Online documentation for the sample CFR. Use OS/2's VIEW.EXE to read the document.

• CFR26LIB

  A directory of useful code functions in source and library form.

• DOORCTRL.C

  This sample CFR demonstrates the use of the DataFile API to gain access to a validation file resident on the 7526. The CFR finds whether an employee badge is present in the beginning of any record, and then examines the work schedule data in the remainder of the record to determine if the employee is allowed to clock-in to work at this time on this day of the week.

• DOORCTRL.EXE A compiled and linked version of the DOORCTRL.C program with all functions included in the executable code.
• READ.ME

  This file includes further descriptions of the sample CFRs and also includes information on any samples or other files which were added to the diskette subsequent to the printing of this manual.

• DOWNLOAD.TXT Information concerning the programming steps needed to fixup and download a CFR.