Easy Check ATM TS-171 communication driver

 

Easy Check ATM TS-171 communication driver is the driver to communicate with credit card payment equipment of KICC in Korea.

 

1. Read Settings

 

<Figure 1> is read setting example of Easy Check ATM TS-171 communication driver.

<Figure 1>  Read setting example of Easy Check ATM TS-171 communication driver

Device part of  <Figure 1> input Com Port(COM3), Baud Rate(57600), Parity Bit(0), Data Bit(8), Stop Bit(1) respectively, according to setting of controller.

In protocol option part, you can set 'card data read timeout after payment'( 3 ~ 255 seconds, default = 40 ).

 

Easy Check ATM TS-171 communication driver read schedule

Easy Check ATM TS-171 communication driver's read schedule input 'READ' one line.

 

If you click the icon  in protocol option part at <Figure 1>, you can see the dialog box such as <Figure 2>.

you can also set card data read timeout after payment by using the part of ¡®Card Data Read Timeout¡¯ shown in <Figure 2>.

<Figure 2> Example of Easy Check ATM TS-171 communication driver¡¯s Option dialog box

 

2. Write settings

You can print, payment, ... by using 'write settings'. 

 

Digital Write

Digital write and analog write have the same setting parameters except output value. 

 

Analog Write 

Analog write setting parameters are as follows:

1)  PORT                   Port no. (0 ~ 255)

2)  STATION             monthly installment plan when CREDIT, CANCEL write command

2 ~ 99 = monthly installment plan,

0, 1 = lump sum payment.

3)  ADDRESS          readed status data saving start address for setting( payment response, ..., decimal unit  ).

4)  Extra1                  writte command = CREDIT, INIT, PRINT, CANCEL.

5) Extra2                   option for write command.

CREDIT, CANCEL write command  :  0 = 10% VAT,   1 = 0% VAT,

PRINT write command : number of printing control data file( 0 ~ 255 ).

filename = ¡®work folder\SCAN\PrintData_%03d.ini¡¯

%03d = 000 ~ 255 Extra2 number.

 

<Table 1> is write command and contents for Easy Check ATM TS-171 communication driver.

<Table 2> is status data and contents for write command.

<Table 3> is data saving address and contents for CREDIT write command.

Write command Contents

Output value

Readed status data
CREDIT payment request command

sum for payment request

( greater than 0 )

save status data from ADDRESS,

refer to <Table 2>, <Table 3>
CANCEL payment cancel command

sum for payment cancel

( greater than 0 )

save status data from ADDRESS,

refer to <Table 2>, <Table 3>
INIT initialization command for default status

don't care

save readed status data at ADDRESS,

refer to <Table 2>, error when initializing status
PRINT printing command

save readed status data at ADDRESS,

refer to <Table 2>
<Table 1> Write command and contents for Easy Check ATM TS-171 communication driver

status value

Contetns

Remarks

0

initialization status (don't communicate)

 

1

OK

 

2

writing

 

3

error (timeoot, NAK, ...)

 

4

waiting for OK

when CREDIT command
<Table 2> Status data and contents for write command
Data saving address Contents Saving memory

Remarks
ADDRESS + 0 status data ( refer to <Table 2> ) WORD/DWORD/FLOAT

 
ADDRESS + 1 code of payment WORD/DWORD/FLOAT/STRING memory

1= credit payment, 2 = cancel payment for same day, 3= credit return refund, 4 = IC credit payment,

5 = IC cancel payment same day,

6 = IC credit return refund,

7 = Cash Receipt payment, 8 = cancel Cash Receipt,

9 = Cash Receipt payment  Issuing voluntary,

10 = Check lookup,

11 = MSR card request/response,

12 = re-request last data to CAT,

13 = clear request last data to CAT,

0 = new(added) payment code.
ADDRESS + 2 response code

 

0 = normal, other = Error.
ADDRESS + 3 WORD/DWORD/FLOAT memory : amount of payment(sum)
STRING memory : TID string

when error response code( 1 ~ 4)

save 0 for all WORD/DWORD/FLOAT memory and 'space' to STRING memory
ADDRESS + 4 WORD/DWORD/FLOAT memory : service charge
STRING memory : WCC string(1digit)
ADDRESS + 5 WORD/DWORD/FLOAT memory : VAT
STRING memory : string of card number
ADDRESS + 6 installment/cash/cash type(2digit)

save only STRING memory
ADDRESS + 7 string for sum payment
ADDRESS + 8 string for service charge
ADDRESS + 9 string for VAT
ADDRESS + 10 string for payment number(12digit)
ADDRESS + 11 string for payment date, time (12digit)
ADDRESS + 12 string for Issuer code(3digit)
ADDRESS + 13 string for card company name(20digit)
ADDRESS + 14 string for Merchant code(12digit)
ADDRESS + 15 string for buying company code(3digit)
ADDRESS + 16 string for buying company name(20digit)
ADDRESS + 17 string for POS deal number(20digit)
ADDRESS + 18 string for DSC delimiter character(1digit)
<Table 3> Data saving address and contents for CREDIT write command

<Table 4> is control character input method for PRINT write command. 

Input method

Contents

Remarks

filename

work folder\SCAN\PrintData_%03d.ini

%03d = 000 ~ 255 

value of Extra2

input method

for control character

1. use specified control character. (refer to user's manual)

2. input 'enpty' data for blank line.

3. input at one line for printed data at a line.

4. input data by ASCII data format.

5. use ¡®/¡¯ character and hex-decimal number for control character, etc. example) /02  = STX

6. use ¡®//¡¯ for  ¡®/¡¯ character.

 
<Table 4> Control character input method for PRINT write command

Write example 1)

PORT:0,  station:0, ADDRESS:0050, Extra1:CREDIT,  Extra2 : 0

The setting parameter shown above is payment request example. ( VAT = 10% )

After writing, the readed status data save from 50 WORD/DWORD/FLOAT/STRING memory. ( refer to <Table 3> )

 

Write example 2)

PORT:0,  station:0, ADDRESS:0150, Extra1:PRINT,  Extra2 : 2

The setting parameter shown above is control data printing example. The control data read from ¡®work folder\SCAN\PrintData_002.ini' file.

After writing, the readed status data save at 150 WORD/DWORD/FLOAT/STRING memory. ( refer to <Table 2> )

 

3. connection of communication cable and main power

Connection of communication cable and main power are as follows.

 

Connection of communication cable

Please connect USB cable to Easy Check ATM TS-171 equipment.

Also, install USB serial driver of  KICC.

<Figure 3> is appearance of Easy Check ATM TS-171 equipment and Easy Pad. 

1.png
<Figure 3> Appearance of Easy Check ATM TS-171 equipment and Easy Pad

 

Connection of main power

Please connect main AC power to Easy Check ATM TS-171 equipment.