Select your printer model

Parameters are refined by the selected printer.

setPrinterSettingEx


Changes the set value of the printer setting in JSON format.

For the JSON used in this API, use the printer information JSON acquired with the getPrinterSettingEx API.

Do not use the printer information JSON acquired from another model.

Before executing the API, you can execute the verifyPassword API to make sure this API uses the correct password.

Execute the getPrinterSettingEx API after executing this API, and check that the printer settings have been changed correctly.

This API error status is the API processing result.

The processing result of the devices using this API is notified to the listener method set by the setSetPrinterSettingExListener API of the Printer class.

Do not execute this API in continuation without checking the processing result with the callback method.

Syntax

 
public void setPrinterSettingEx(int timeout, java.lang.String jsonString, java.lang.String administratorPassword) throws Epos2Exception

Parameter

timeout

Specifies the timeout period before completion of command transmission in milliseconds.

Value

Description

Integer from 5000 to 60000

Timeout period (in milliseconds)

Printer.PARAM_DEFAULT

Specifies the default value (30000).

jsonString

Specifies the set value of the printer setting in JSON format.

Refer to JSON_Spec_sheet_revx.pdf included in the package for more information.

administratorPassword

Specify the administrator password set in the printer.

Refer to the printer's Technical Reference Guide for the initial administrator password.

If no administrator password is set for the printer, specify "null."

Exception

When the process fails, Epos2Exception with one of the following error status occurs.

Error status

Description

ERR_PARAM

An invalid parameter was passed.

ERR_ILLEGAL

This API was called while no communication had been started.

ERR_MEMORY

Sufficient memory required for processing could not be allocated.

ERR_FAILURE

An unknown error occurred.

ERR_TYPE_INVALID

The device type is different.

ERR_PROCESSING

Could not run the process.

Supplementary explanation

  • This API cannot be used simultaneously with other APIs.
    After executing this API, do not execute any other API until the callback is returned.
  • Do not turn off the power supply to the printer while executing this API.
  • Immediately after starting the printer, do not execute this API until the LED is lit.
    Execution takes time, and a timeout error may occur.
  • If communication with the printer is disconnected during execution of this API, the printer may become unable to operate. In such a case, turn the power supply to the printer off and then on again.
  • Communication with the printer disconnects as the printer automatically restarts during execution of this API. Reconnect as necessary.
    In a network environment that uses DHCP, the IP address may change due to restart of the printer.
    In such a case, search for the printer using Discovery class and reconnect.
    When connected via USB, the USB device node may change due to restart of the printer.
    If the identifier is omitted in the target parameter of connect ("USB:"), the connection status can be retained even if the device node changes.
  • This API can be used in the system configuration of the TM printer model and customer display model.
    With the system configuration of the TM printer + DM-D + barcode scanner model, this API can be used when connecting via Bluetooth and USB.
  • This API cannot be used with SSL/TLS communication.
  • When this API is used with the system configuration of a TM printer + DM-D + barcode scanner model Wi-Fi/Ethernet connection and POS terminal model, ERR_TYPE_INVALID is returned.
  • It may take some time to change printer settings depending on the printer used or the connection method with the printer.
  • If this API is executed in a non-supported printer, CODE_SUCCESS is stored in the setSetPrinterSettingExListener API code, but printer settings will not be executed.
 

Quick Access

  • [Name]
  • [Format]
  • [Range]
  • [Description]
  • [Notes]

Epson ePOS SDK includes patented or patent pending functions. The contents must not be disclosed to third parties.


Epson ePOS SDK for Android

Jump to the top