VeriFone e265, User And Best Practices Manual

Page 1: ...Verifone Part Number DOC087 080 EN A Revision A e355 e265 User and Best Practices Guide...

Page 2: ...ple or sample program before placing the software into productive use This document including without limitation the examples and software programs is supplied As Is Verifone Inc 1 800 Verifone www ve...

Page 3: ...rame 13 iOS Android Windows Protocols 13 Bluetooth Support 14 Wi Fi Support 14 VTM on the Display 14 Software Changes for PCI4 14 Charging Schemes 14 Software Packaging 14 CHAPTER 2 Architecture Stand...

Page 4: ...Power Modes 39 Off 39 Active 39 Sleep 39 Power Environment Variables 40 Power Best Practices 40 Battery Status LED 42 CHAPTER 5 Special Features Pass Through Mode 43 Persistent Pass Through 43 Enablin...

Page 5: ...2 Software Versions 63 CHAPTER 7 Logging Options OS Logging Support 65 DEBUG Serial 65 LOG File Based 66 Configuration Variables 67 EOS Log Library 67 EOS Configuration Variables 67 Application Loggin...

Page 6: ...CONTENTS 6 E355 E265 USER AND BEST PRACTICES GUIDE...

Page 7: ...355 Related Documentation To learn more about the e355 terminal refer to the following set of documents e355 Quick Installation Guide VPN DOC087 062 EN e355 Installation Guide VPN DOC087 063 EN e355 F...

Page 8: ...Blue Text in blue indicates terms that are cross referenced See Conventions and Acronyms Italics Italic typeface indicates book titles or emphasis You must install a roll of thermal sensitive paper in...

Page 9: ...PAN Personal Area Network PD Power Delivery controller for Windows charging PWM PAYware Mobile Reader mPOS SSP Secure Simple Pairing SPP Serial Port Profile of Bluetooth VTM Verix Terminal Manager XPI...

Page 10: ...PREFACE Conventions and Acronyms 10 E355 E265 USER AND BEST PRACTICES GUIDE...

Page 11: ...ce and e355 connection is either wired or wireless Wired connection is via USB interface and modular frame and wireless connection is via Bluetooth and optional frame Device Features e355 offers the f...

Page 12: ...t panel Figure 1 Front Panel Features Figure 2 shows the terminal features on the back panel Figure 2 Back Panel Features LCD DISPLAY KEYPAD 2D IMAGER BARCODE BUTTON POWER LED INDICATOR SIDE MICRO USB...

Page 13: ...ing support of same virtual communication ports COM1A COM1B COM1C COM1D and COM1E over the protocols iAP1 iAP2 or PMR MUX2 used to communicate with smart device Modular frame e355 can dock into differ...

Page 14: ...check Pre expired passwords for key loading menus in VTM for RKL ADE and IPP keys Full system integrity check file system integrity and binary files authentication at every boot up OS software harden...

Page 15: ...ia Wi Fi Access Point Bluetooth Access Point or Tethered Host via BT PAN Profile Key Points in this set up 1 GO configuration variable is set to payment application 2 Disables the start up of Control...

Page 16: ...displaying messages on the LCD screen The e355 provides five virtual communication ports to the applications which are multiplexed over USB or Bluetooth interface The iAP1 iAP2 and PMR MUX2 protocols...

Page 17: ...30 pin connector uses iAP1 protocol to communicate with e355 Both iAP1 and iAP2 protocols use the same protocol strings on iOS device For more information on communicating with accessory using protoco...

Page 18: ...The e355 sends a Connect event to its application when application on the smart device opens the port for communication The e355 sends a Disconnect event to its application when application on smart d...

Page 19: ...opened the corresponding device Prototype Int open const char devname int attributes Parameters Return Values Positive integer device handle if successful or 1 with errno set to an error code if erro...

Page 20: ...kely that the kernel task can t keep up with the incoming packets If the FIFO overflows the entire message packet is dropped When packets are internally dropped log messages are generated The end to e...

Page 21: ...eceived There are a total of 7 transmit buffers shared among all channels If a communication protocol attempts to write when there are no buffers the error ENOSPC is returned Each buffer allows up to...

Page 22: ...Byte 4 The status byte described below The event cause bits are set when an event is sent to the application The application can read the bits to determine the cause of the event The event cause bits...

Page 23: ...iven device The following event bits must not be assigned EVT_USER EVT_SHUTDOWN and EVT_SYSTEM Any attempt to violate these rules will result in set_event_bit returning 1 and errno being set to EINVAL...

Page 24: ...an error code iap_get_keypad_state Copies the keypad status to the given buffer The first byte is the Enable State The second byte is the Beep State The two status bytes are as follows Enable State 0...

Page 25: ...es Apple authentication coprocessor to validate e355 as valid Apple accessory before being able to communicate with iOS device The frame ID value selects the iAP2 protocol early on during the e355 pow...

Page 26: ...er is a 1 byte ASCII number from 2 to 6 to specify the channel number The crc field is a 16 bit CRC of the complete message including the 2 byte header and the command message data Command 0xFF 0x5A i...

Page 27: ...to 6 to specify the channel number The crc field is a 16 bit CRC of the complete message including the 2 byte header and the data field Table 11 PMR MUX2 Error Codes Error Code Code Name Description...

Page 28: ...ices compliant with PCI4 security standard OS release versions include build date for example QTE50301 20151006 or WTE50301 20151006 For more information on the Verix Operating System refer to Verix e...

Page 29: ...tions are launched by the control application using the configuration variable VXAPPx In Standalone mode Payment application is the GO application VXAPPx In Mobile PINpad mode the user applications ot...

Page 30: ...ace USB lightning Bluetooth and message protocol iAP1 iAP2 PMR MUX2 Channel Application communicates with BT_MGR application via pipe interface for Bluetooth profile connection management User Applica...

Page 31: ...n frame connector iPad mini Frame Key Points This frame is with 8 pin Lightning connector e355 is an accessory to iPad mini device As an accessory e355 cannot wake up iPad mini iAP2 protocol is used o...

Page 32: ...connected to frame No barcode trigger buttons on iPad 2 frame Figure 9 Frame for iPad 2 iPod 6 Frame Key Points This frame is with an 8 pin Lightning connector e355 is an accessory to iPod 6 device As...

Page 33: ...is not accessible for USB downloads when e355 is in Android Windows frame configuration Android Frame Key Points This frame is with Micro USB type B connector e355 is an accessory to Android device As...

Page 34: ...ternal AC power is connected to frame Barcode trigger buttons are available on Windows frame Communication link is broken between e355 and Windows device when external AC power is connected to frame S...

Page 35: ...fer to Verix eVo Bluetooth Manager Users Guide VPN DOC00327 Supported Profiles The following profiles are supported Serial Port Profile SPP The e355 supports SPP for both Client Server modes The BT_MG...

Page 36: ...ce turn off Bluetooth reset device turn on Bluetooth it will then most of the time pop up numeric comparison window If you don t mind that you can just press OK on the connecting device and it will st...

Page 37: ...cific to Mobile PINpad mode and charges one device at a time For example it will charge e355 first and then the smart device second A Micro USB charging cable needs to be attached to side Micro USB po...

Page 38: ...s Red key held down for 4 seconds but blocked when smart device attached via Lightning USB Critical low battery level is reached battery voltage 3 35 v SVC_SHUTDOWN API is called from application or V...

Page 39: ...vent or SVC_WAIT the processor is then slowed This happens immediately and just as quickly the system can transition back to Active Run state when work arrives to wake up an application It is not poss...

Page 40: ...iseconds and range is 20000 to 600000 milliseconds OFF configuration variable is for specifying applications idle time before power off state Default value is 10800 seconds or 3 HRS and range is 300 5...

Page 41: ...er because physical hardware is not controlled Leaving Wi Fi open or closed depends on the application use case There is significant initialization overhead during open The device stays in lowest powe...

Page 42: ...on flow Sleepwalking API API set_backlight_control enables sleep walking This allows application to control display backlight instead of the OS controlling display on off during wake up sleep Dark wak...

Page 43: ...onnected between PC and the side port of e355 Data connection between e355 and smart device is disconnected in pass through mode Charging the e355 is not possible through the side Micro USB port in pa...

Page 44: ...rough 2 Disconnect the USB cable either from the side Micro USB port of e355 or the USB port of PC Mac 24 Hour Restart As part of PCI PTS4 requirement the terminal is forced to restart at least once f...

Page 45: ...een simultaneously press the ENTER and 7 keys The default factory set system password is 166831 Use the following key sequence to enter this password 1 6 6 8 3 1 ENTER After entering the correct passw...

Page 46: ...lays BATTERY NOT CALIBRATED to inform to initialize and condition the battery Figure 13 Copyright Notice Screen The startup screen shows a tamper message when an attempt to break into the system has b...

Page 47: ...ure 15 Cell Phone Style Keypad with Multiple Characters Assigned per Key Menus Below are sample VTM menu screens Figure 16 VTM Menus 1 and 2 1QZ 2ABC 3DEF 4GHI 5JKL 6MNO 7PRS 8TUV 9WXY 0 SP X Cancel C...

Page 48: ...ries of prompts Edit Parameters This submenu provides the editor for configuration files to add or change configuration parameters User is prompted to select file group number and configuration file a...

Page 49: ...le app selection will download files into group 1 only multi app selection will download clear files in multiple groups Select either Full dnld or Partial dnld a full download will delete all files in...

Page 50: ...s displayed when signature and certificates are verified otherwise FAILED message is displayed Installation is incomplete after a FAILED message Figure 18 e355 and PC Download via Serial COM1 Port If...

Page 51: ...Enter VTM s default password 166831 3 Press ENTER 4 Wait for VTM Menu 1 5 Select 3 for Download 6 Press ENTER to select default file group 1 7 Enter file group default password 166831 8 Press ENTER 9...

Page 52: ...if some other program in PC already has access to this comm port If you are using a dongle check the UART USB switch setting and ensure that USB is set DDL Utility Direct Download Utility DDL is used...

Page 53: ...ith or delete split files files of resumable download delete current group files and delete files in all groups Terminal Info This submenu displays e355 unit information as follows Serial number Perma...

Page 54: ...ys VALID DATA for each track An error generates one of the following error messages for each track ERROR NO DATA NO START NO END LRC ERR PARITY ERR and REVERSE END VoyLib 03 090000 VxOS11 PSCR Build 1...

Page 55: ...tactless reader OS Version QTE50301 20160513 and later supports this contactless diag Figure 24 Contactless Diag Menu Options Barcode Diagnostic 1 Turn ON Scanner 2 Turn OFF Scanner Scanned Data Barco...

Page 56: ...ltage current temperature full and remaining charge capacities and battery conditioner selection Current value is in mAmps Negative value indicates battery discharge and positive value indicates batte...

Page 57: ...01 20160601 and later Figure 28 ADE KSN Info Screens License Listing FE Feature Enablement FE licenses are displayed in this option Currently FE supports ADE only The ADE feature tag value is displaye...

Page 58: ...xecute an illegal instruction TASK task number indicates type of task that was currently executed 1 Verix Terminal Manager 2 First User Task TIME time of crash clock time of the error in the format YY...

Page 59: ...ease the contrast of LCD by 1 at a time Keypad backlight control is not available in e355 Figure 32 Console Manager Menu Options VERIX CLOCK MANAGER 1 Increment Hour Current Time 16 09 21 New Time HH...

Page 60: ...it key RKL RSA key and ADE key loading menus and the presence status of the keys VTM PASSWORD MGR New ________________________ 2 TERMINAL MGR Entry VTM PASSWORD MGR VTM PASSWORD MGR Again ____________...

Page 61: ...be changed before loading RKL key s Selecting Reset password menu option will not cause RKL keys to be erased only password will reset to default value RKL keys are injected at deployment centers only...

Page 62: ...not cause keys to be erased ADE Status ADE status menu will show the key presence status of each engine ADE ON OFF status and ADE feature enablement status ADE is turned ON when at least one ADE key i...

Page 63: ...05 MOD usbax77 01 01 B04 MOD ls_c2 01 25 B05 MOD usbd_02 01 01 B08 MOD sdwldrv 02 10 B09 6 7 6 7 VTM SOFTWARE VERSIONS MOD btdrvr 02 15 B14 MOD bcr_com 01 01 B08 MOD usb_apl 01 01 B06 MOD frm_mgr 01 0...

Page 64: ...SYSTEM MODE VTM Software Versions 64 E355 E265 USER AND BEST PRACTICES GUIDE...

Page 65: ...f OS and application logs DEBUG Serial Log data will be written to COM1 or debug port based on setting DEBUG 1 or 4 In case of DEBUG 1 The COM1 port will be unavailable for download or any other purpo...

Page 66: ...d U are supported 1 for COM1 port and U for USB device port Incremental logs can be obtained by going to the password prompt screen uploading the log and then cancelling VTM password entry prompt This...

Page 67: ...tional filters which are evaluated at run time Statement is only logged if the filter evaluates to true Filters will control the amount of log data Logged data includes task and source file informatio...

Page 68: ...to RAM memory in a circular buffer of size 1MB RAM memory logging is faster when compared to FLASH file based memory logging and it avoids any read disturbance issues in memory RAM memory logs are era...

Page 69: ...totype void logdump log_severity severity char tag void addr int len Parameters Severity Any of define values from list LOG_DEBUG LOG_INFO LOG_NOTICE LOG_WARNING LOG_ERROR LOG_CRITICAL LOG_ALERT LOG_E...

Page 70: ...LOGGING OPTIONS logdump 70 E355 E265 USER AND BEST PRACTICES GUIDE...

Page 71: ...tion Certpath txt Text file containing the path of CustCert crt signer certificate of package Required for legacy reasons The downloader application looks at the path name of signer cert from this fil...

Page 72: ...ge package name and version number you need to first convert this file to text format using VLR utility tool which is available in SDK vlr a c version sys version txt is the command to convert to text...

Page 73: ...config config txt is the command to convert to text file vlr c config txt config is the command to convert to compressed format Sample Content of config File The config may contain the following or m...

Page 74: ...SOFTWARE PACKAGE Downloading 74 E355 E265 USER AND BEST PRACTICES GUIDE...

Page 75: ...rogrammers Guide VPN DOC087 070 EN Pipe Interface Verison V01 15 01 and later of the control and barcode applications support pipe interface These are OS pipes that allow user applications specified b...

Page 76: ...CONTROL AND BARCODE APPLICATIONS Pipe Interface 76 E355 E265 USER AND BEST PRACTICES GUIDE...

Page 77: ...t the following key features Table 15 Comparison of Key Features Feature e265 e355 Display Monochrome 160 x 120 Color 320 x 240 Frame Support No frame connector 8 pin frame connector Barcode Scanner N...

Page 78: ...e355 e265 User and Best Practices Guide Verifone Part Number DOC087 080 EN A Revision A Verifone Inc 1 800 Verifone www verifone com...