        Sample Program for Operating TSE in Epson Fiscal printer
        ========================================================

	                                                  EPSON EUROPE
                                                            MARCH 2021							

1. GENERAL
----------
  + Epson TSE Sample Program for Windows

  *IMPORTANT NOTE*
  This Application is intended for demonstration purposes only and not for production environment.

2. FILES
--------
   + SRC                  - contains the source code of the sample tool.
   + BIN/EpsonTseDemo.exe - sample tool executable file (32-bit) version: 2.4.1

3. TOOL USAGE
-------------
EpsonTseDemo.exe  <required> <optional>

[Required]
  -mX: X=<Access Method>. Default is -m0.
    0 :ACCESS_BY_SERIAL_ESCPOS
    1 :ACCESS_BY_NETWORK_ESCPOS
    2 :ACCESS_BY_EPOS_DEVICE_XML
  -iX: X=<Port Identifier> (COM port/IP Address) e.g. -iCOM1, -i192.168.1.132

[Optional]
  -tX: X=<TSE Handle>. Default is "local_TSE"
[Optional - for setting logs]
  -wX: X=<Log level>.
    0: Disabled, 1: Error, 2: Warning, 3: Info,
    4: Trace, 5: Verbose
  -x1: Enable logging on DebugViewer.
  -y1: Enable logging on File.
  -z1: Enable logging on Standard Output.

[EXAMPLE]
            EpsonTseDemo.exe  -m0   -iCOM1
            EpsonTseDemo.exe  -m1   -i192.168.192.168
            EpsonTseDemo.exe  -m2   -i192.168.192.168    -tTSE1_xxxx
[To get the list of TSE devices connected to a server]
            EpsonTseDemo.exe  -m2   -i<server's ip address>
	   
*Testing with Logical Serial (Physical USB) connection:
      1. Install the Virtual Port Driver (VPD).
	     https://download.epson-biz.com/modules/pos/index.php?page=single_soft&cid=6175&scat=36&pcat=3
      2. Connect to the printer using USB.
      3. Run the VPD.
	     Choose a COM port (e.g. COM5) and then click the "Assign Port" button.
	     Select the printer connected with USB and then click "OK" Button.
      4. Test with the Sample Application.
	     e.g. EpsonTseDemo.exe  -m0   -iCOM5

4. HISTORY
----------
  Version 2.4.1 - (16.March.2021)
    + Improved filtered export processing for WindowsXP (EXPORT_INCOMPLETE_SEARCHING).
    + Added support for null character before the end of the stream in processData and additionalData.
    + Added support for using hexstring (binary data) as input for processData and additionalData.
  Version 2.4.0 - (18.November.2020)
    + Adjusted timeout values in ESC/POS.
    + Fixed issue regarding the wrong "remainingRetries" value returned by UnblockUser().
    + Added support for GetRawStorageSmartInfo(), GetStorageSmartInfo().
    + Added support for the new parameters in GetLastTransactionResponse() that returns the signature and serial number associated with the transaction.
    + Improved the parsing of results. Minimized the usage of std::regex in parsing results.
    + Improved the mechanism that handles unclosed TSE.
    + Added support for EPOS_DEVICE_XML_PORT in the config file.
    + Fixed minor issues in UI.
  Version 2.3.0 - (26.June.2020)
    + Added new option under the Admin menu to allow user to manually input date/time when executing UpdateTime on TSE.
    + Added support for a config file to allow changing of no. of connect attempt and log file size limit.	
    + Fixed the issue related to the testapp's login status synchronization with the TSE.
    + Fixed issues in UI to allow input of string with whitespace.
    + Fixed issue related to getting the list of IDs where elements contain whitespace/s.
    + Improved the handling of error caused by invalid response.
  Version 2.2.0 - (28.May.2020)
    + Fixed issue on Windows directory for TSE config/log files.
    + Changed the isDataImportInProgress to isTransactionInProgess in GetStorageInfo().
    + Updated the process in executing Factory reset.
    + Updated the process in getting the TSE Id.
    + Other fixes related to error handling.
    + Added UpdateTimeRDC() to manually adjust the TSE time (for RDC only).
  Version 2.1.0 - (30.April.2020)
    + Added support for getting list of TSE devices.
    + Improved the log support.
    + Other fixes
  Version 2.0.0 - (04.December.2019)
    + Fixed the crash issue when executing "[13] Get Export Data (Export Filtered By Period Of Time)".
    + Removed unnecessary hashing (SHA256) of ProcessData and AdditionalData in StartTransaction and FinishTransaction.
    + Increased the timeout for network connection.
    + Added support for Windows XP.
    + Added support for Fiscal Device Servers (EPS TSE-3 and EPS TSE-8).
    + Added support for Windows driver.
    + some other minor changes
  Version 1.0.1 - (October.2019)
    + Initial Release