Epson TM Series User manual

EPSON OPOS ADK MANUAL
APPLICATION DEVELOPMENT
GUIDE
MICR (EPSON TM Series)
Version 3.00 Feb. 2019

Notes
(1) Reproduction of any part of this documentation by any means is prohibited.
(2) The contents of this documentation are subject to change without notice.
(3) Comments and notification of any mistakes in this documentation are gratefully
accepted.
(4) This software cannot be used with other equipment that the specified.
(5) EPSON will not be responsible for any consequences resulting from the use of any
information in this documentation.
Trademarks
Microsoft®, Windows®, Windows Server®, Visual Basic® and Visual C++® are
trademarks or registered trademarks of Microsoft Corporation in the United States and/or
other countries.
EPSON® and ESC/POS® are registered trademarks of Seiko Epson Corporation.
The Bluetooth® word mark and logos are registered trademarks owned by Bluetooth SIG,
Inc.
Other product and company names used herein are for identification purposes only and
may be trademarks or registered trademarks of their respective companies.
Copyright © 2000-2019 Seiko Epson Corporation

Version 3.00 Feb. 2019
APPLICATION DEVELOPMENT GUIDE
MICR (EPSON TM Series)
iii
Contents
Section 1. Introduction.......................................................................................................... 1
Section 2. Details on Settings .............................................................................................. 2
2.1 Device Information..................................................................................................2
2.2 References of Firmware Versions ..........................................................................3
2.3 Settings of DIP Switches and Hardware.................................................................3
2.4 Setting of Devices...................................................................................................3
2.5 Port Information......................................................................................................7
Section 3. Function Details................................................................................................... 9
3.1 CheckHealth Method..............................................................................................9
3.1.1 Internal Test .................................................................................................9
3.1.2 External Test................................................................................................9
3.1.3 Interactive Test.............................................................................................9
3.2 Property Set values and Default Values............................................................... 10
3.2.1 Capability Set Value...................................................................................10
3.3 Supplementary Explanation of Functions .............................................................11
3.3.1 Valid Headers.............................................................................................11
3.3.2 Check Digit.................................................................................................12
3.4 Device Statistics...................................................................................................12
3.5 Communication Compatibility...............................................................................12
Section 4. Expanded Functions......................................................................................... 13
4.1 DirectIO Function..................................................................................................13
4.1.1 DirectIO Method.........................................................................................13
4.1.2 DirectIOEvent Event...................................................................................16
4.2 List of Commands Usable with DirectIO...............................................................16
Section 5. Device Specific Programming......................................................................... 17
5.1 Obtaining MICR Status in Real Time....................................................................17
5.2 Cleaning the MICR...............................................................................................18

Version 3.00 Feb. 2019
APPLICATION DEVELOPMENT GUIDE
MICR (EPSON TM Series)
iv
Section 6. Error Information............................................................................................... 19
6.1 ResultCode List....................................................................................................19
6.1.1 When Executing Properties........................................................................19
6.1.2 When A Method is executed.......................................................................20
6.1.3 Error Event.................................................................................................22
6.2 Remedial Actions for Principal Errors...................................................................23
Section 7. Warnings.............................................................................................................24
Section 8. Appendix.............................................................................................................25
8.1 Changes for Corresponding UPOS Release 1.7 ..................................................25
8.1.1 Return Values.............................................................................................25
8.1.2 MICR Operations by Specific Settings of Devices......................................26

Version 3.00 Feb. 2019
APPLICATION DEVELOPMENT GUIDE
MICR (EPSON TM Series)
1
Section 1. Introduction
This manual describes the method of use and related items, including device-specific
precautions, when the MICR device is used with EPSON OPOS ADK.
Before the MICR can be used, the EPSON OPOS ADK should be installed and the devices
to be used should be set using the SetupPOS utility. For setting methods, please see the
Section 2.
Compatibility mode
The compatibility mode for upward compatibility was added in OPOS Ver2.60.
For the details of the compatibility mode, please refer to “EPSON OPOS ADK MANUAL
APPLICATION DEVELOPMENT GUIDE Compatibility Mode”.

Version 3.00 Feb. 2019
APPLICATION DEVELOPMENT GUIDE
MICR (EPSON TM Series)
2
Section 2. Details on Settings
This section describes connection configurations and how to make the settings for the
MICR devices.
2.1 Device Information
The DeviceDescription and DeviceName for each model are as follows.
Model Name I/F DeviceDescription DeviceName
S EPSON TM-U675 MICR TM-U675
P EPSON TM-U675P MICR TM-U675P
U EPSON TM-U675U MICR TM-U675U
TM-U675
E EPSON TM-U675E MICR TM-U675E
S EPSON TM-H5000II MICR TM-H5000II
P EPSON TM-H5000IIP MICR TM-H5000IIP
U EPSON TM-H5000IIU MICR TM-H5000IIU
TM-H5000II
E EPSON TM-H5000IIE MICR TM-H5000IIE
S EPSON TM-H6000III MICR TM-H6000III
P EPSON TM-H6000IIIP MICR TM-H6000IIIP
U EPSON TM-H6000IIIU MICR TM-H6000IIIU
TM-H6000III
E EPSON TM-H6000IIIE MICR TM-H6000IIIE
S EPSON TM-J7000 MICR TM-J7000
P EPSON TM-J7000P MICR TM-J7000P
U EPSON TM-J7000U MICR TM-J7000U
TM-J7000
E EPSON TM-J7000E MICR TM-J7000E
S EPSON TM-J7100 MICR TM-J7100
P EPSON TM-J7100P MICR TM-J7100P
U EPSON TM-J7100U MICR TM-J7100U
TM-J7100
E EPSON TM-J7100E MICR TM-J7100E
TM-U950 S EPSON TM-U950 MICR TM-U950
S EPSON TM-H2000 MICR TM-H2000
P EPSON TM-H2000P MICR TM-H2000P
U EPSON TM-H2000U MICR TM-H2000U
TM-H2000
E EPSON TM-H2000E MICR TM-H2000E
S EPSON TM-H6000IV MICR TM-H6000IV
P EPSON TM-H6000IVP MICR TM-H6000IVP
TM-H6000IV
U EPSON TM-H6000IVU MICR TM-H6000IVU

Version 3.00 Feb. 2019
APPLICATION DEVELOPMENT GUIDE
MICR (EPSON TM Series)
3
E EPSON TM-H6000IVE MICR TM-H6000IVE
S EPSON TM-H6000V MICR TM-H6000V
P EPSON TM-H6000VP MICR TM-H6000VP
U EPSON TM-H6000VU MICR TM-H6000VU
E EPSON TM-H6000VE MICR TM-H6000VE
TM-H6000V
B EPSON TM-H6000VB MICR TM-H6000VB
I/F indicate the connected interface.
The following is the list of the four connecting interfaces.
S: Serial
P: Parallel
U: USB
E: Ethernet
B: Bluetooth
2.2 References of Firmware Versions
Refer to the release notes (Relnote.txt).
2.3 Settings of DIP Switches and Hardware
There are no Dip Switch settings for the MICR. Refer to the manual of currently
used Printer for settings of the Printer.
2.4 Setting of Devices
The SetupPOS utility should be used for setting devices. Regarding how to use
the SetupPOS utility, please refer to the "EPSON OPOS ADK MANUAL User's
Manual (Installer/ SetupPOS/ TMUSB)".
1) Setting of Parallel interface devices
When the SetupPOS utility is used to select the device when using a Parallel port,
select devices with “P” appended to the end of the device name.
Example: TM-H6000IIIP

Version 3.00 Feb. 2019
APPLICATION DEVELOPMENT GUIDE
MICR (EPSON TM Series)
4
2) Setting of USB interface devices
When the SetupPOS utility is used to select the device when using an USB port,
select devices with “U” appended to the end of the device name.
Example: TM-H6000IIIU
3) Setting of Ethernet interface devices
When the SetupPOS utility is used to select the device when using an Ethernet
port, select devices with “E” appended to the end of the device name.
Example: TM-H6000IIIE
4) Setting of Bluetooth interface devices
When using a printer with Bluetooth I/F specifications,
Select the COM port of the Bluetooth device in the Create New window of
TMPORT.
Notes: Bluetooth interface only support TM-H6000V.
5) Device Specific Settings
MICR’s specific setting should be done after specifying the Device to use in
“Device Specific Settings” dialog box of SetupPOS Utility. The following items
are able to set in the dialog box.
yError handling options during Check insertion
yCheck Font
yRegarding how to set with “Device Specific Settings”, please refer to
“EPSON OPOS ADK MANUAL User's Manual (Installer/ SetupPOS/
TMUSB)”.
z“Error handling options during Check insertion setting.”
Sets how you want to be notified if an error is fired during Check insertion.
•“Issue an Error Event for every error occurrence during Check insertion.
(applicable for UPOS 1.7 and subsequent releases)” radio button
(here after, referred without (applicable for UPOS 1.7 and subsequent
releases))
Under the setting that this button is marked, EndInsertion method is
considered to be succeed when check insertion by execution of
EndInsertion method is done normally, regardless of whether the read
data is illegal.
The conditions of the read data and reading operation of MICR are

Version 3.00 Feb. 2019
APPLICATION DEVELOPMENT GUIDE
MICR (EPSON TM Series)
5
notified by events.
This operation is the UPOS Release 1.7 and subsequent releases
applied operation.
•“Issue an Error Event for specified error occurrence during Check
insertion.” radio button
Under the setting that this button is marked, EndInsertion method is
considered to be succeeded upon normal completion of analysis of the
data that is read from a check inserted by the method.
When the read data of MICR is normal or the data contains not
analyzable characters, these conditions are notified by events.
Whether the read data and reading operation of MICR are illegal are
indicated by the set value of ResultCode and ResultCodeExtended
properties.
This operation is the same as the default operation of UPOS Release
1.6 (previous versions of Ver. 2.30) applied operation.
Default setting of above radio buttons is ”Issue an Error Event for every error
occurrence during Check insertion.”.
Regarding the variety of events and values of ResultCode and
ResultCodeExtended are described, please refer to the Section 8 of this
manual.
z“Automatic check remove on read error” check box:
This check box setting can be done only when ”Issue an Error Event for
specified error occurrence during Check insertion.” radio button under “Error
handling options during Check insertion” is selected.
This check box is inapplicable when “Issue an Error Event for every error
occurrence during Check insertion.” is selected.
When a read data is in those conditions as below, the check is removed:
1.The entire data is incorrect. (Neither an incorrect insertion, nor an
incorrect sheet, etc.)
2.Longer than the prescribed length
3.Blank check sheet
If one of the data is read as “?”, the check will not be removed.
For the EPSON TM-U950, this setting is the default and cannot be changed.
The TM-U950 cannot translate error data as “?”.

Version 3.00 Feb. 2019
APPLICATION DEVELOPMENT GUIDE
MICR (EPSON TM Series)
6
z“Fire ErrorEvent on check digit parity error” check box:
This check box setting can be done only when ”Issue an Error Event for
specified error occurrence during Check insertion.” radio button under “Error
handling options during Check insertion” is selected.
This check box is inapplicable when “Issue an Error Event for every error
occurrence during Check insertion.” is selected.
Judging whether a TransitNumber (nine digits number) is normal. If it is illegal,
then notified by the ErrorEvent (RCE = OPOS_EMICR_DIGITERROR).
It can be executed only when the whole data is read normally, and the
TransitNumber has nine digits number.
z“Check font”
Sets the read font for reading checks. Selects a type of the
check to be used.
Reads checks and analyzes the read data, then sets them to its properties.
•“E-13B” radio button
•“CMC7” radio button
Default setting is ”E-13B”.