Differences between revisions 3 and 17 (spanning 14 versions)
⇤ ← Revision 3 as of 2008-09-11 02:11:47 →
Size: 3601
Editor: DannyCheung
Comment:
← Revision 17 as of 2023-04-13 01:56:31 → ⇥
Size: 4954
Editor: KafuWong
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
## page was renamed from Integrated Eftpos
Line 4: Line 5:
'''The pinpad MUST be configured to work with the PC-EFTPOS drivers. Standard units handed out from the bank will NOT have this feature.
'''		 '''The pinpad MUST be configured to work with the PC-EFTPOS drivers. Standard units handed out from the bank will NOT have this feature. '''
Line 10: Line 10:
||<tablewidth="840px" tableheight="455px"> POS Terminal ||The PC that the Pinpad is directly connected to. This is usually the terminal that the sales transaction was performed on. It should be noted that most of the EFTPOS intelligence and settings are stored here. ||
|| Pinpad || The device that swipes the customer's card and asks for the PIN number. ||
|| Eftpos Modem || The phone line modem that rings the bank's server and opens up the link to the bank. ||
|| CONTROL server || The computer from which CONTROL is being run on. ||
||PC-EFTPOS TCP/IP driver || The piece of software on the POS Terminal that allows the Pinpad Driver to commnuicate over a network ||
|| Eftpos Server || The piece of software on the POS Terminal that talks to the bank via the Eftpos Modem ||
|| Eftpos Docket Printer || The Ingenico thermal docket printer. It's only purpose is to print EFTPOS receipts. Not really necessary as CONTROL dockets should have EFTPOS details printed on them. ||		 ||<tablewidth="840px" tableheight="455px">POS Terminal ||The PC that the Pinpad is directly connected to. This is usually the terminal that the sales transaction was performed on. It should be noted that most of the EFTPOS intelligence and settings are stored here. ||
||Pinpad ||The device that swipes the customer's card and asks for the PIN number. ||
||Eftpos Modem ||The phone line modem that rings the bank's server and opens up the link to the bank. Or a internal 3G model that talk to the bank. ||
||CONTROL server ||The computer from which CONTROL is being run on. ||
||PC-EFTPOS TCP/IP driver ||The piece of software on the POS Terminal that allows the Pinpad Driver to commnuicate over a network ||
||Eftpos Server ||The piece of software on the POS Terminal that talks to the bank via the Eftpos Modem ||
||Eftpos Docket Printer ||The Ingenico thermal docket printer. It's only purpose is to print EFTPOS receipts. Not really necessary as CONTROL dockets should have EFTPOS details printed on them. ||
Line 20: Line 22:
 * the Pinpad drivers(EFTCLT.exe)
 * the Eftpos Server program (EFTSRV.exe) and
 * the PC-EFTPOS TCP/IP drivers		  * the Pinpad drivers(EFTCLT.exe) come from linkly installer
 * the Eftpos Server program (EFTSRV.exe) come from linkly installer
 * the PC-EFTPOS TCP/IP drivers (eftcltcp.exe) https://customers.creativecomputing.com.au/tjmnq/
Line 25: Line 28:
To install, simply run the install programs. To install,
Line 27: Line 30:
== Linux ==  1. Run the install programs '''(follow instructions provided by the bank down to the letter. Don't plug in anything until instructions say so).'''
 1. Create a rule in the firewall to allow incoming connections to TCP port 6005

'''NB''': There are instances when PC-Client is disappearing after the reboot. You should run ''NoConfig_PC-EFTPOS-setup.''exe from URL http://www.pceftpos.com.au/files/releasecd/

== Linux(only toodyay , morris and sons) ==
 1. Make sure libXp rpm is already installed
 {{{
# yum install libXp
}}}
Line 34: Line 46:
# rpm -i j2re-1_4_2_01-i586.rpm}}} # rpm -i j2re-1_4_2_01-i586.rpm
}}}
Line 37: Line 50:
# scp sam.crecom.com.au:/u/ccdev/eftpos/neweftposinstall.tgz .}}} # scp sam.crecom.com.au:/u/ccdev/eftpos/neweftposinstall.tgz .
}}}
Line 41: Line 55:
# tar xvzf neweftposinstall.tgz}}} # tar xvzf neweftposinstall.tgz
}}}
Line 44: Line 59:
# cp -r ./u/eftpos /u/}}} # cp -r ./u/eftpos /u/
}}}
Line 47: Line 63:
# type java }}} # type java
}}}
Line 50: Line 67:
# Ensure that the driver script knows where the java executable is. /usr/local/java/bin/java .....}}} # Ensure that the driver script knows where the java executable is. /usr/local/java/bin/java .....
}}}
Line 53: Line 71:
# /u/eftpos/eftlclt/run}}} # /u/eftpos/eftlclt/run
}}}
Line 56: Line 75:
# tail /u/eftpos/eftclt/eftpos.log}}}
 1. Look for errors relating to the file javax.com.properties and where Java expects the file to be. In the following examples, we will assume that place to be /usr/share/jvm/java-1.4.2/jre/lib
 1. Copy javax.com.properties to where Java wants it to be		 # tail /u/eftpos/eftclt/eftpos.log
}}}
 1. Look for errors relating to the file javax.com.properties and where Java expects the file to be. In the following examples, we will assume that place to be {{{ /usr/share/jvm/java-1.4.2/jre/lib}}}
 1. Copy {{{ javax.com.properties}}} to where Java wants it to be
Line 60: Line 80:
# cp ./usr/java/j2re1.4.2_01/lib/javax.com.properties /usr/share/jvm/java-1.4.2/jre/lib/}}} # cp ./usr/java/j2re1.4.2_01/lib/javax.com.properties /usr/share/jvm/java-1.4.2/jre/lib/
}}}
 1. Add the shop user and ccc to the groups lock and uucp. Edit /etc/group
 {{{
uucp:x:14:uucp,ccc,shop
lock:x:54:ccc,shop
}}}
Line 64: Line 90:
# cp -r ./usr/java/j2re1.4.2_01/lib/i386/librxtx* /usr/share/jvm/java-1.4.2/jre/lib/}}} # cp -r ./usr/java/j2re1.4.2_01/lib/i386/librxtx* /usr/share/jvm/java-1.4.2/jre/lib/
}}}
Line 67: Line 94:
# /u/eftpos/eftclt/run}}}
 1. Add the following line to /etc/inittab		 # /u/eftpos/eftclt/run
}}}
 1. Add the following line to {{{ /etc/X11/xinit/Xclients}}}
Line 70: Line 98:
eft:345:respawn:/u/eftpos/eftclt/run}}} ...
# Add this line
exec /u/eftpos/eftclt/run &
exec fvwm
}}}

== How to test if PC-EFTPOS connection is working from Control ==
 1. Close all instances of sieat.
 1. Open up a terminal or xterm on client's session.
 1. Run our internal test program "igcomin".
 1. Select "Control Panel". This should talk to TCP/IP client, and then eftclt.exe and bring up on top of everything the PC-EFTPOS control panel.
 1. If this works, that means Control can talk to the eftpos client.

----
[[CategoryEFTPOS]]

Installing PC-EFTPOS drivers

Control has an integrated EFTPOS feature that communicates with the PC-EFTPOS drivers for Ingenico EFTPOS equipment.

The pinpad MUST be configured to work with the PC-EFTPOS drivers. Standard units handed out from the bank will NOT have this feature.

The POS terminal (that the pinpad is connected) can be running either Linux or Windows.

Terminology

POS Terminal

The PC that the Pinpad is directly connected to. This is usually the terminal that the sales transaction was performed on. It should be noted that most of the EFTPOS intelligence and settings are stored here.

Pinpad

The device that swipes the customer's card and asks for the PIN number.

Eftpos Modem

The phone line modem that rings the bank's server and opens up the link to the bank. Or a internal 3G model that talk to the bank.

CONTROL server

The computer from which CONTROL is being run on.

PC-EFTPOS TCP/IP driver

The piece of software on the POS Terminal that allows the Pinpad Driver to commnuicate over a network

Eftpos Server

The piece of software on the POS Terminal that talks to the bank via the Eftpos Modem

Eftpos Docket Printer

The Ingenico thermal docket printer. It's only purpose is to print EFTPOS receipts. Not really necessary as CONTROL dockets should have EFTPOS details printed on them.

Windows

The terminal should have:

The CONTROL server will talk to the Pinpad driver via the Ingenico TCP/IP drivers. The drivers then talk to the Pinpad via the serial port. If the Pinpad does not have a built-in modem, it will need to use the Eftpos Server program to communicate with the bank or an upstream Eftpos server.

To install,

  1. Run the install programs (follow instructions provided by the bank down to the letter. Don't plug in anything until instructions say so).

  2. Create a rule in the firewall to allow incoming connections to TCP port 6005

NB: There are instances when PC-Client is disappearing after the reboot. You should run NoConfig_PC-EFTPOS-setup.exe from URL http://www.pceftpos.com.au/files/releasecd/

Linux(only toodyay , morris and sons)

  1. Make sure libXp rpm is already installed 
    # yum install libXp
  2. Download Sun's Java version 1.4.2_01. This MUST be the one from Sun Microsystems and not the one from Gnu. 
    # scp sam.crecom.com.au:/u2/programs/j2re-1_4_2_01-linux-i586.rpm .
  3. Install Java 
    # rpm -i j2re-1_4_2_01-i586.rpm
  4. Copy the eftpos tarball from sam 
    # scp sam.crecom.com.au:/u/ccdev/eftpos/neweftposinstall.tgz .
  5. Unpack the tarball 
    # tar xvzf neweftposinstall.tgz
  6. Copy the drivers into place 
    # cp -r ./u/eftpos /u/
  7. Find the location of the java executable 
    # type java
  8. Edit the /u/eftpos/eftclt/run script 
    # Ensure that the driver script knows where the java executable is. /usr/local/java/bin/java .....
  9. Run the eftpos client driver script. Nothing will happen. If anything, it will give errors 
    # /u/eftpos/eftlclt/run
  10. Check the eftpos client error file 
    # tail /u/eftpos/eftclt/eftpos.log

  11. Look for errors relating to the file javax.com.properties and where Java expects the file to be. In the following examples, we will assume that place to be  /usr/share/jvm/java-1.4.2/jre/lib

  12. Copy  javax.com.properties to where Java wants it to be 

    # cp ./usr/java/j2re1.4.2_01/lib/javax.com.properties /usr/share/jvm/java-1.4.2/jre/lib/
  13. Add the shop user and ccc to the groups lock and uucp. Edit /etc/group 
    uucp:x:14:uucp,ccc,shop
lock:x:54:ccc,shop

  14. Copy the RxTx serial and comm modules for Java 

    # cp -r ./usr/java/j2re1.4.2_01/lib/ext/ /usr/share/jvm/java-1.4.2/jre/lib/
# cp -r ./usr/java/j2re1.4.2_01/lib/i386/librxtx* /usr/share/jvm/java-1.4.2/jre/lib/
  15. Run the eftpos driver script, test and troubleshoot 
    # /u/eftpos/eftclt/run

  16. Add the following line to  /etc/X11/xinit/Xclients 

    ...
# Add this line
exec /u/eftpos/eftclt/run &
exec fvwm

How to test if PC-EFTPOS connection is working from Control

  1. Close all instances of sieat.
  2. Open up a terminal or xterm on client's session.
  3. Run our internal test program "igcomin".
  4. Select "Control Panel". This should talk to TCP/IP client, and then eftclt.exe and bring up on top of everything the PC-EFTPOS control panel.
  5. If this works, that means Control can talk to the eftpos client.

CategoryEFTPOS

Installing_Eftpos_Drivers (last edited 2023-04-16 23:39:57 by JonCo)