wizarPOS - User contributions [en]

Developed by zxing,zbar

2018-04-20T10:00:24Z

Zzy nouse:

Zxing and Zbar are both open-source to scan barcodes or 2-D "graphical barcodes" and retrieve the data encoded.
==== Zxing ====
ZXing refer to short for Zebra Crossing. It is implement in the Barcode Scanner (application) that is an Android app.You can visit the website of Barcode Scanner or download the project from Google

==== Zbar ====
ZBar is an open-source C barcode reading library with C++, Python, Perl, and Ruby bindings. It is also implemented on Linux and Microsoft Windows as a command-line application, and as an iPhone application

Camera info for different type POS

2018-04-20T09:59:27Z

Zzy nouse: Created page with "different POS, different camera ===== W1 ===== ===== Q1 ===== ===== Q2/K2 ===== ===== M2 ====="

different POS, different camera
===== W1 =====
===== Q1 =====
===== Q2/K2 =====
===== M2 =====

Developed by zxing,zbar

2018-04-20T09:48:38Z

Zzy nouse:

Zxing and Zbar are both open-source to scan barcodes or 2-D "graphical barcodes" and retrieve the data encoded.
===== Zxing =====
ZXing refer to short for Zebra Crossing. It is implement in the Barcode Scanner (application) that is an Android app.You can visit the website of Barcode Scanner or download the project from Google

===== Zbar =====
ZBar is an open-source C barcode reading library with C++, Python, Perl, and Ruby bindings. It is also implemented on Linux and Microsoft Windows as a command-line application, and as an iPhone application

Developed by zxing,zbar

2018-04-20T09:26:52Z

Zzy nouse: /* Zbar */

Zxing and Zbar are both open-source to scan barcodes or 2-D "graphical barcodes" and retrieve the data encoded.
===== Zxing =====
ZXing refer to short for Zebra Crossing. It is implement in the Barcode Scanner (application) that is an Android app.You can visit the website of Barcode Scanner or download the project from Google

===== Zbar =====
ZBar is an open-source C barcode reading library with C++, Python, Perl, and Ruby bindings.[2][3] It is also implemented on Linux and Microsoft Windows as a command-line application,[4] and as an iPhone application

Developed by zxing,zbar

2018-04-20T09:25:08Z

Zzy nouse: /* Zxing */

Developed by zxing,zbar

2018-04-20T09:17:42Z

Zzy nouse: /* Zxing */

Zxing and Zbar are both open-source to scan barcodes or 2-D "graphical barcodes" and retrieve the data encoded.
===== Zxing =====
ZXing refer to short for Zebra Crossing. It imcom

===== Zbar =====

Developed by zxing,zbar

2018-04-20T09:15:34Z

Zzy nouse: Created page with "Zxing and Zbar are both open-source to scan barcodes or 2-D "graphical barcodes" and retrieve the data encoded. ===== Zxing ===== ===== Zbar ====="

Zxing and Zbar are both open-source to scan barcodes or 2-D "graphical barcodes" and retrieve the data encoded.
===== Zxing =====
===== Zbar =====

Developed by scan service

2018-04-20T08:43:12Z

Zzy nouse:

The scan service ，allows an Android device with imaging hardware (camera) to scan barcodes or 2-D "graphical barcodes" and retrieve the data encoded .Information encoded often includes web addresses, geographical coordinates, and small pieces of text, in addition to commercial product codes. The Android-based system is given similar functionality to a hardware barcode reader.

This application supports many different types of barcode, including those used to identify products in commerce. The Barcode Scanner can automatically search the Web to identify a product with a barcode and use, for example, price-comparison information.

The application can decode several 2-D codes including the widely-used QR and Data Matrix codes. QR codes are often embedded in websites; Barcode Scanner can open a browser at the encoded site, for example, facilitating the download of an application.

==== Introduction ====

There are many applications are developed based on smart POS. In one thing, many of the Smart POS developers also have POS industry background,but not professional Android developers. So when they start developing applications, they want to be provided with a convenient scan API by WizarPOS, instead of learning Zxing/Zbar themselves.In other thing,from the hardware point of view, the scan parts used on smart POS, are not necessarily the standard camera, there will be some transformation. In some cases, the scan part will be required to be a specialized hardware. Therefore, the direct use of Zxing/Zbar is not really applicable for WizarPOS smart POS, but need some modification and customization.
For the reasons above, we consider to develop WizarPOS Scan Services to facilitate the third party developers in developing applications with scan function.

==== Interface ====
===== scanBarcode =====
scanBarcode is a synchronous calling interface.

After the application calls the interface, the scan service opens the camera defined by the scan parameter and then starts the scan. Once getting the result of scanning, the camera is closes and the results are returned immediately.

Parameter: Scan parameter

Return: Scan result

===== startScan =====
startScan is an asynchronous call interface and indicating the continuous scanning is started.

After the application calls this interface, the scan service opens the camera defined by the scan parameter and starts the scan. After every single scanning, the results will be returned during the callback. After each callback is done, the next scanning continue to run starts.

Parameter:Scan parameter, IScanCallBack

Return: void

===== foundBarcode =====

foundBarcode is a function of IScanCallBack that is a parameter of previous interface.

The caller can get the Scan Result through this interface. When this interface is called, the scan service is in the pause state, and when the call in returned, then the next scanning will be continued.
You can turn off the scan service that is in pause with “stopScan” that is another interface .

Parameter: ScanResult

Return:Void

===== stopScan =====

This interface Stops the continuous scan, and closes the scan service's UI.

After stop, other callers can call startScan, or scanBarcode interface.

Return: true / false.

==== Description ====
===== Scan Parameter =====
Scan Parameter is a parameter object, it defines the parameters that need by the scan service.
method: set(String key, String value) (Value Not case sensitive)

{| class="wikitable"
|-
| Key
| Value Type
| Value
| Description

|-
| window_top || int || Default: 0,Range: >0 || The distance to the screen top. Effect in overlaymode.(dp)

|-
| window_left || int || Default: 0,Range: >0 || The distance to the screen left. Effect in overlaymode.(dp)

|-
| window_width || int || Default: screen width,Range: >0 || Screen width. Effect in overlaymode.(dp)

|-
| window_height || int || Default: screen ,Range: >0 || Screen hight. Effect in overlaymode.(dp)

|-
| enable_scan_section || boolean || Default: true|| False: all the display window is the area for scanner, remove the scanner frame.
True: customize the area of the scanner, has a scanner frame, the other part is semitransparent, the scanner frame is in center, can adjust the width or the height of the scanner frame.

|-
| scan_section_width || int || Default: 300dip,Range: >0 || The width of the scanner frame.

|-
| scan_section_height || int || Default: 300dip,Range: >0 || The height of the scanner frame.

|-
| display_scan_line || String || Default: moving,Range: No/fixed/moving || Display the red line in scanner area.
NO: Not display
Fixed: In center
Moving: Move up and down.(dp)

|-
| enable_flash_icon || boolean || Default(W1|Q1): (T|F) || Whether to display the hover button of controlling the flash.

|-
| enable_switch_icon || boolean || Default: T || Whether to display the hover button of switching camera.

|-
| enable_indicator_light || boolean || Default: F || Whether to display the indicator light button, only supported in Q1.

|-
| decodeformat || String || Default: BARCODE_ALL|| Decode format range.Default is BARCODE_ALL,the formats are separated by “,”.

|-
| decoder_mode || int || Default: 2,Range:0-2 || Decode mode:
0: mode1
1: mode2
2: mode3

|-
| enable_return_image || boolean || Default: F || Whether to return the scanned image.

|-
| camera_index || int || Default: 0,Range:0-2 || 0: fixed camera.
1:zomm camera.
2:customer display camera

|-
| scan_time_out || long (ms) || Default: -1,Range: >0 || <=0:scan forever
>0:scan with timeout,when timeout, return timeout error, only effected in synchronized interface.

|-
| scan_section_border_color || int || Default: Color.WHITE || The color of scan border, use Color.argb

|-
| scan_section_corner_color || int || Default: Color.argb(0xFF,0x21, 0xDB, 0xD5) || The color of the scan corner

|-
| scan_section_line_color || int || Default: Color.RED || The color of the scan line

|-
| scan_tip_textSize || int || Default: 15 || The size of the tip text Unit: sp

|-
| scan_tip_textColor || int || Default: Color.WHITE || The distance between the tip text and the bottom of the screen Unit: dp

|-
| scan_tip_textMargin || int || Default: 30|| The distance between thetip text and the bottom of the screen Unit: dp

|-
| flash_light_state || boolean || Default: F || Initial state of indicator light
true: opened
false: closed

|-
| indicator_light_state || iboolean || Default: F || Initial state of indicator light
true: opened
false: closed

|-
| scan_mode || String || Default: dialog || Scanner window mode dialog: activity with specified UI
overlay:only has scanner window, without UItitles, UI buttons, the scanner window on top of other UI activities

|-
| scan_camera_exposure || int || Default: 0 || Camera exposure compensation for zoom camera

|-
| scan_time_limit || int || Default: 50 || The max decode time

|-
| enable_mirror_scan || boolean || Default: T || Enable mirror scan Default is true, opened

|}
===== Scan Mode =====
In dialog mode, the scanner UI has drawed by the camera scanner service, the third app don’t need to consider about the UI.

In overlay mode, the camera scanner service only provide the scanner window, the window will display on top of the third app UI. So the third app can draw the UI by itself, such as the title, the buttons. In this mode, if the app need to switch the camera, the flash light, the indicator light, it must use the broadcast like belows:
* <big>Camera</big>:

Broadcast Action : com.wizarpos.scanner.setcamera

Broadcast Key: overlay_config

Value: 0 Fixed camera;1 zoom camera; 2 customer display* camera

* <big>Flash light</big>:
Broadcast Action : com.wizarpos.scanner.setflashlight

Broadcast Key: overlay_config

Value: true opened; false closed

* <big>Indicator light</big>:
Broadcast Action : com.wizarpos.scanner.setindicator

Broadcast Key : overlay_config

Value: true opened; false closed

Sample Code:
<syntaxhighlight lang="java" line='line'>
// open the flash light
Intent intent = new Intent();
intent.setAction(ScanParameter.BROADCAST_SET_FLASHLIGHT);
intent.putExtra(ScanParameter.BROADCAST_VALUE, true);
sendBroadcast(intent);
</syntaxhighlight>

===== Scan Result =====

{| class="wikitable"
|-
| Field
| Type
| Description

|-
| resultCode || int || >=0: Success
<0: Failure
(See also Error Code)

|-
| text || String || The text result, return null when error occurred, the format of the text is UTF-8, if need the other format, please get the raw buffer and change by yourself.

|-
| rawBuffer || Byte[] || The raw buffer

|-
| bitmap || Bitmap || The scanned image, it will return when set the parameter enable_return_image is true.

|-
| barcodeFormat || String || barcodeFormat, see Appendix
|}

===== Error Code =====

{| class="wikitable"
|-
| Value
| Description

|-
| 1 || Success

|-
| 0 || Cancel

|-
| 2 || The scan UI fully display

|-
| -1 || The service has been occupied

|-
| -2 || Can not open the camera

|-
| -3 || Scan timeout

|-
| -3 || Illegal parameter

|}

==== Getting Started ====
The scan service use AIDL, so the third app must include the AIDL files which provided by WizarPOS.
===== Bind service =====
Sample code:
<syntaxhighlight lang="java" line='line'>
AidlController.getInstance().startScanService(this, this);
.
.
private IScannService scanService; //Scanner service
private ServiceConnection scanConn;
@Override
public void serviceConnected(Object objService, ServiceConnection connection) {
if(objService instanceof IScannService){
scanService = (IScannService) objService;
scanConn = connection;
}
}
.
.
if(scanService != null){
this.unbindService(scanConn);
scanService = null;
scanConn = null;
}
</syntaxhighlight>
==== Appendix ====
===== Barcode Format =====
Example:
<syntaxhighlight lang="java" line='line'>
ScanParameter parameter = new ScanParameter();
parameter.set(ScanParameter.KEY_DECODEFORMAT, " SymbologyType_Aztec, ITF ");
</syntaxhighlight>
compound barcode format
{| class="wikitable"
|-
| BARCODE_ALL
| Includes all the barcodes in the table

|-
| BARCODE_1D || Includes all the 1D barcodes in the table

|-
| BARCODE_2D || Includes all the 2D barcodes in the table

|}

Barcode format
{| class="wikitable"
|-
| AZTEC || 2D barcode

|-
| DATAMATRIX || 2D barcode

|-
| QR || 2D barcode

|-
| MAXICODE || 2D barcode

|-
| PDF417 || 2D barcode

|-
| CODABAR || 1D barcode

|-
| CODE39 || 1D barcode

|-
| CODE93 || 1D barcode

|-
| CODE128 || 1D barcode

|-
| EAN8 || 1D barcode

|-
| EAN13 || 1D barcode

|-
| ITF || 1D barcode(Interleaved Two of Five)

|-
| RSS_14 || 1D barcode

|-
| RSS_EXPANDED || 1D barcode

|-
| UPCA || 1D barcode

|-
| UPCE || 1D barcode

|-
| CODE11 || 1D barcode

|}

Developed by scan service

2018-04-20T08:29:54Z

2018-04-20T08:01:57Z

Zzy nouse: /* Scan Mode */

Developed by scan service

2018-04-20T08:01:40Z

Zzy nouse: /* Scan Mode */

The scan service ，which is an app and started by using AIDL and the third apps custom their UI through by transfer some parameters, provides convenient services that include scaning bar code and getting result of scanning for comsumers.

==== Introduction ====

There are many applications are developed based on smart POS. In one thing, many of the Smart POS developers also have POS industry background,but not professional Android developers. So when they start developing applications, they want to be provided with a convenient scan API by WizarPOS, instead of learning Zxing/Zbar themselves.In other thing,from the hardware point of view, the scan parts used on smart POS, are not necessarily the standard camera, there will be some transformation. In some cases, the scan part will be required to be a specialized hardware. Therefore, the direct use of Zxing/Zbar is not really applicable for WizarPOS smart POS, but need some modification and customization.
For the reasons above, we consider to develop WizarPOS Scan Services to facilitate the third party developers in developing applications with scan function.

==== Interface ====
===== scanBarcode =====
scanBarcode is a synchronous calling interface.

After the application calls the interface, the scan service opens the camera defined by the scan parameter and then starts the scan. Once getting the result of scanning, the camera is closes and the results are returned immediately.

Parameter: Scan parameter

Return: Scan result

===== startScan =====
startScan is an asynchronous call interface and indicating the continuous scanning is started.

After the application calls this interface, the scan service opens the camera defined by the scan parameter and starts the scan. After every single scanning, the results will be returned during the callback. After each callback is done, the next scanning continue to run starts.

Parameter:Scan parameter, IScanCallBack

Return: void

===== foundBarcode =====

foundBarcode is a function of IScanCallBack that is a parameter of previous interface.

The caller can get the Scan Result through this interface. When this interface is called, the scan service is in the pause state, and when the call in returned, then the next scanning will be continued.
You can turn off the scan service that is in pause with “stopScan” that is another interface .

Parameter: ScanResult

Return:Void

===== stopScan =====

This interface Stops the continuous scan, and closes the scan service's UI.

After stop, other callers can call startScan, or scanBarcode interface.

Return: true / false.

==== Description ====
===== Scan Parameter =====
Scan Parameter is a parameter object, it defines the parameters that need by the scan service.
method: set(String key, String value) (Value Not case sensitive)

{| class="wikitable"
|-
| Key
| Value Type
| Value
| Description

|-
| window_top || int || Default: 0,Range: >0 || The distance to the screen top. Effect in overlaymode.(dp)

|-
| window_left || int || Default: 0,Range: >0 || The distance to the screen left. Effect in overlaymode.(dp)

|-
| window_width || int || Default: screen width,Range: >0 || Screen width. Effect in overlaymode.(dp)

|-
| window_height || int || Default: screen ,Range: >0 || Screen hight. Effect in overlaymode.(dp)

|-
| enable_scan_section || boolean || Default: true|| False: all the display window is the area for scanner, remove the scanner frame.
True: customize the area of the scanner, has a scanner frame, the other part is semitransparent, the scanner frame is in center, can adjust the width or the height of the scanner frame.

|-
| scan_section_width || int || Default: 300dip,Range: >0 || The width of the scanner frame.

|-
| scan_section_height || int || Default: 300dip,Range: >0 || The height of the scanner frame.

|-
| display_scan_line || String || Default: moving,Range: No/fixed/moving || Display the red line in scanner area.
NO: Not display
Fixed: In center
Moving: Move up and down.(dp)

|-
| enable_flash_icon || boolean || Default(W1|Q1): (T|F) || Whether to display the hover button of controlling the flash.

|-
| enable_switch_icon || boolean || Default: T || Whether to display the hover button of switching camera.

|-
| enable_indicator_light || boolean || Default: F || Whether to display the indicator light button, only supported in Q1.

|-
| decodeformat || String || Default: BARCODE_ALL|| Decode format range.Default is BARCODE_ALL,the formats are separated by “,”.

|-
| decoder_mode || int || Default: 2,Range:0-2 || Decode mode:
0: mode1
1: mode2
2: mode3

|-
| enable_return_image || boolean || Default: F || Whether to return the scanned image.

|-
| camera_index || int || Default: 0,Range:0-2 || 0: fixed camera.
1:zomm camera.
2:customer display camera

|-
| scan_time_out || long (ms) || Default: -1,Range: >0 || <=0:scan forever
>0:scan with timeout,when timeout, return timeout error, only effected in synchronized interface.

|-
| scan_section_border_color || int || Default: Color.WHITE || The color of scan border, use Color.argb

|-
| scan_section_corner_color || int || Default: Color.argb(0xFF,0x21, 0xDB, 0xD5) || The color of the scan corner

|-
| scan_section_line_color || int || Default: Color.RED || The color of the scan line

|-
| scan_tip_textSize || int || Default: 15 || The size of the tip text Unit: sp

|-
| scan_tip_textColor || int || Default: Color.WHITE || The distance between the tip text and the bottom of the screen Unit: dp

|-
| scan_tip_textMargin || int || Default: 30|| The distance between thetip text and the bottom of the screen Unit: dp

|-
| flash_light_state || boolean || Default: F || Initial state of indicator light
true: opened
false: closed

|-
| indicator_light_state || iboolean || Default: F || Initial state of indicator light
true: opened
false: closed

|-
| scan_mode || String || Default: dialog || Scanner window mode dialog: activity with specified UI
overlay:only has scanner window, without UItitles, UI buttons, the scanner window on top of other UI activities

|-
| scan_camera_exposure || int || Default: 0 || Camera exposure compensation for zoom camera

|-
| scan_time_limit || int || Default: 50 || The max decode time

|-
| enable_mirror_scan || boolean || Default: T || Enable mirror scan Default is true, opened

|}
===== Scan Mode =====
In dialog mode, the scanner UI has drawed by the camera scanner service, the third app don’t need to consider about the UI.

In overlay mode, the camera scanner service only provide the scanner window, the window will display on top of the third app UI. So the third app can draw the UI by itself, such as the title, the buttons. In this mode, if the app need to switch the camera, the flash light, the indicator light, it must use the broadcast like belows:

* <big>Camera</big>:

Broadcast Action : com.wizarpos.scanner.setcamera

Broadcast Key: overlay_config

Value: 0 Fixed camera;1 zoom camera; 2 customer display* camera

* <big>Flash light</big>:
Broadcast Action : com.wizarpos.scanner.setflashlight

Broadcast Key: overlay_config

Value: true opened; false closed

* <big>Indicator light</big>:
Broadcast Action : com.wizarpos.scanner.setindicator

Broadcast Key : overlay_config

Value: true opened; false closed

===== Scan Result =====
===== Error Code =====

Developed by scan service

2018-04-20T08:00:45Z

Zzy nouse: /* Scan Mode */

The scan service ，which is an app and started by using AIDL and the third apps custom their UI through by transfer some parameters, provides convenient services that include scaning bar code and getting result of scanning for comsumers.

==== Introduction ====

There are many applications are developed based on smart POS. In one thing, many of the Smart POS developers also have POS industry background,but not professional Android developers. So when they start developing applications, they want to be provided with a convenient scan API by WizarPOS, instead of learning Zxing/Zbar themselves.In other thing,from the hardware point of view, the scan parts used on smart POS, are not necessarily the standard camera, there will be some transformation. In some cases, the scan part will be required to be a specialized hardware. Therefore, the direct use of Zxing/Zbar is not really applicable for WizarPOS smart POS, but need some modification and customization.
For the reasons above, we consider to develop WizarPOS Scan Services to facilitate the third party developers in developing applications with scan function.

==== Interface ====
===== scanBarcode =====
scanBarcode is a synchronous calling interface.

After the application calls the interface, the scan service opens the camera defined by the scan parameter and then starts the scan. Once getting the result of scanning, the camera is closes and the results are returned immediately.

Parameter: Scan parameter

Return: Scan result

===== startScan =====
startScan is an asynchronous call interface and indicating the continuous scanning is started.

After the application calls this interface, the scan service opens the camera defined by the scan parameter and starts the scan. After every single scanning, the results will be returned during the callback. After each callback is done, the next scanning continue to run starts.

Parameter:Scan parameter, IScanCallBack

Return: void

===== foundBarcode =====

foundBarcode is a function of IScanCallBack that is a parameter of previous interface.

The caller can get the Scan Result through this interface. When this interface is called, the scan service is in the pause state, and when the call in returned, then the next scanning will be continued.
You can turn off the scan service that is in pause with “stopScan” that is another interface .

Parameter: ScanResult

Return:Void

===== stopScan =====

This interface Stops the continuous scan, and closes the scan service's UI.

After stop, other callers can call startScan, or scanBarcode interface.

Return: true / false.

==== Description ====
===== Scan Parameter =====
Scan Parameter is a parameter object, it defines the parameters that need by the scan service.
method: set(String key, String value) (Value Not case sensitive)

{| class="wikitable"
|-
| Key
| Value Type
| Value
| Description

|-
| window_top || int || Default: 0,Range: >0 || The distance to the screen top. Effect in overlaymode.(dp)

|-
| window_left || int || Default: 0,Range: >0 || The distance to the screen left. Effect in overlaymode.(dp)

|-
| window_width || int || Default: screen width,Range: >0 || Screen width. Effect in overlaymode.(dp)

|-
| window_height || int || Default: screen ,Range: >0 || Screen hight. Effect in overlaymode.(dp)

|-
| enable_scan_section || boolean || Default: true|| False: all the display window is the area for scanner, remove the scanner frame.
True: customize the area of the scanner, has a scanner frame, the other part is semitransparent, the scanner frame is in center, can adjust the width or the height of the scanner frame.

|-
| scan_section_width || int || Default: 300dip,Range: >0 || The width of the scanner frame.

|-
| scan_section_height || int || Default: 300dip,Range: >0 || The height of the scanner frame.

|-
| display_scan_line || String || Default: moving,Range: No/fixed/moving || Display the red line in scanner area.
NO: Not display
Fixed: In center
Moving: Move up and down.(dp)

|-
| enable_flash_icon || boolean || Default(W1|Q1): (T|F) || Whether to display the hover button of controlling the flash.

|-
| enable_switch_icon || boolean || Default: T || Whether to display the hover button of switching camera.

|-
| enable_indicator_light || boolean || Default: F || Whether to display the indicator light button, only supported in Q1.

|-
| decodeformat || String || Default: BARCODE_ALL|| Decode format range.Default is BARCODE_ALL,the formats are separated by “,”.

|-
| decoder_mode || int || Default: 2,Range:0-2 || Decode mode:
0: mode1
1: mode2
2: mode3

|-
| enable_return_image || boolean || Default: F || Whether to return the scanned image.

|-
| camera_index || int || Default: 0,Range:0-2 || 0: fixed camera.
1:zomm camera.
2:customer display camera

|-
| scan_time_out || long (ms) || Default: -1,Range: >0 || <=0:scan forever
>0:scan with timeout,when timeout, return timeout error, only effected in synchronized interface.

|-
| scan_section_border_color || int || Default: Color.WHITE || The color of scan border, use Color.argb

|-
| scan_section_corner_color || int || Default: Color.argb(0xFF,0x21, 0xDB, 0xD5) || The color of the scan corner

|-
| scan_section_line_color || int || Default: Color.RED || The color of the scan line

|-
| scan_tip_textSize || int || Default: 15 || The size of the tip text Unit: sp

|-
| scan_tip_textColor || int || Default: Color.WHITE || The distance between the tip text and the bottom of the screen Unit: dp

|-
| scan_tip_textMargin || int || Default: 30|| The distance between thetip text and the bottom of the screen Unit: dp

|-
| flash_light_state || boolean || Default: F || Initial state of indicator light
true: opened
false: closed

|-
| indicator_light_state || iboolean || Default: F || Initial state of indicator light
true: opened
false: closed

|-
| scan_mode || String || Default: dialog || Scanner window mode dialog: activity with specified UI
overlay:only has scanner window, without UItitles, UI buttons, the scanner window on top of other UI activities

|-
| scan_camera_exposure || int || Default: 0 || Camera exposure compensation for zoom camera

|-
| scan_time_limit || int || Default: 50 || The max decode time

|-
| enable_mirror_scan || boolean || Default: T || Enable mirror scan Default is true, opened

|}
===== Scan Mode =====
In dialog mode, the scanner UI has drawed by the camera scanner service, the third app don’t need to consider about the UI.

In overlay mode, the camera scanner service only provide the scanner window, the window will display on top of the third app UI. So the third app can draw the UI by itself, such as the title, the buttons. In this mode, if the app need to switch the camera, the flash light, the indicator light, it must use the broadcast like belows:

* Camera:
Broadcast Action : com.wizarpos.scanner.setcamera
Broadcast Key: overlay_config
Value: 0 Fixed camera;1 zoom camera; 2 customer display* camera

* Flash light:
Broadcast Action : com.wizarpos.scanner.setflashlight
Broadcast Key: overlay_config
Value: true opened; false closed

* Indicator light:
Broadcast Action : com.wizarpos.scanner.setindicator
Broadcast Key : overlay_config
Value: true opened; false closed

===== Scan Result =====
===== Error Code =====

Developed by scan service

2018-04-20T07:59:31Z

Zzy nouse: /* Scan Mode */

The scan service ，which is an app and started by using AIDL and the third apps custom their UI through by transfer some parameters, provides convenient services that include scaning bar code and getting result of scanning for comsumers.

==== Introduction ====

There are many applications are developed based on smart POS. In one thing, many of the Smart POS developers also have POS industry background,but not professional Android developers. So when they start developing applications, they want to be provided with a convenient scan API by WizarPOS, instead of learning Zxing/Zbar themselves.In other thing,from the hardware point of view, the scan parts used on smart POS, are not necessarily the standard camera, there will be some transformation. In some cases, the scan part will be required to be a specialized hardware. Therefore, the direct use of Zxing/Zbar is not really applicable for WizarPOS smart POS, but need some modification and customization.
For the reasons above, we consider to develop WizarPOS Scan Services to facilitate the third party developers in developing applications with scan function.

==== Interface ====
===== scanBarcode =====
scanBarcode is a synchronous calling interface.

After the application calls the interface, the scan service opens the camera defined by the scan parameter and then starts the scan. Once getting the result of scanning, the camera is closes and the results are returned immediately.

Parameter: Scan parameter

Return: Scan result

===== startScan =====
startScan is an asynchronous call interface and indicating the continuous scanning is started.

After the application calls this interface, the scan service opens the camera defined by the scan parameter and starts the scan. After every single scanning, the results will be returned during the callback. After each callback is done, the next scanning continue to run starts.

Parameter:Scan parameter, IScanCallBack

Return: void

===== foundBarcode =====

foundBarcode is a function of IScanCallBack that is a parameter of previous interface.

The caller can get the Scan Result through this interface. When this interface is called, the scan service is in the pause state, and when the call in returned, then the next scanning will be continued.
You can turn off the scan service that is in pause with “stopScan” that is another interface .

Parameter: ScanResult

Return:Void

===== stopScan =====

This interface Stops the continuous scan, and closes the scan service's UI.

After stop, other callers can call startScan, or scanBarcode interface.

Return: true / false.

==== Description ====
===== Scan Parameter =====
Scan Parameter is a parameter object, it defines the parameters that need by the scan service.
method: set(String key, String value) (Value Not case sensitive)

{| class="wikitable"
|-
| Key
| Value Type
| Value
| Description

|-
| window_top || int || Default: 0,Range: >0 || The distance to the screen top. Effect in overlaymode.(dp)

|-
| window_left || int || Default: 0,Range: >0 || The distance to the screen left. Effect in overlaymode.(dp)

|-
| window_width || int || Default: screen width,Range: >0 || Screen width. Effect in overlaymode.(dp)

|-
| window_height || int || Default: screen ,Range: >0 || Screen hight. Effect in overlaymode.(dp)

|-
| enable_scan_section || boolean || Default: true|| False: all the display window is the area for scanner, remove the scanner frame.
True: customize the area of the scanner, has a scanner frame, the other part is semitransparent, the scanner frame is in center, can adjust the width or the height of the scanner frame.

|-
| scan_section_width || int || Default: 300dip,Range: >0 || The width of the scanner frame.

|-
| scan_section_height || int || Default: 300dip,Range: >0 || The height of the scanner frame.

|-
| display_scan_line || String || Default: moving,Range: No/fixed/moving || Display the red line in scanner area.
NO: Not display
Fixed: In center
Moving: Move up and down.(dp)

|-
| enable_flash_icon || boolean || Default(W1|Q1): (T|F) || Whether to display the hover button of controlling the flash.

|-
| enable_switch_icon || boolean || Default: T || Whether to display the hover button of switching camera.

|-
| enable_indicator_light || boolean || Default: F || Whether to display the indicator light button, only supported in Q1.

|-
| decodeformat || String || Default: BARCODE_ALL|| Decode format range.Default is BARCODE_ALL,the formats are separated by “,”.

|-
| decoder_mode || int || Default: 2,Range:0-2 || Decode mode:
0: mode1
1: mode2
2: mode3

|-
| enable_return_image || boolean || Default: F || Whether to return the scanned image.

|-
| camera_index || int || Default: 0,Range:0-2 || 0: fixed camera.
1:zomm camera.
2:customer display camera

|-
| scan_time_out || long (ms) || Default: -1,Range: >0 || <=0:scan forever
>0:scan with timeout,when timeout, return timeout error, only effected in synchronized interface.

|-
| scan_section_border_color || int || Default: Color.WHITE || The color of scan border, use Color.argb

|-
| scan_section_corner_color || int || Default: Color.argb(0xFF,0x21, 0xDB, 0xD5) || The color of the scan corner

|-
| scan_section_line_color || int || Default: Color.RED || The color of the scan line

|-
| scan_tip_textSize || int || Default: 15 || The size of the tip text Unit: sp

|-
| scan_tip_textColor || int || Default: Color.WHITE || The distance between the tip text and the bottom of the screen Unit: dp

|-
| scan_tip_textMargin || int || Default: 30|| The distance between thetip text and the bottom of the screen Unit: dp

|-
| flash_light_state || boolean || Default: F || Initial state of indicator light
true: opened
false: closed

|-
| indicator_light_state || iboolean || Default: F || Initial state of indicator light
true: opened
false: closed

|-
| scan_mode || String || Default: dialog || Scanner window mode dialog: activity with specified UI
overlay:only has scanner window, without UItitles, UI buttons, the scanner window on top of other UI activities

|-
| scan_camera_exposure || int || Default: 0 || Camera exposure compensation for zoom camera

|-
| scan_time_limit || int || Default: 50 || The max decode time

|-
| enable_mirror_scan || boolean || Default: T || Enable mirror scan Default is true, opened

|}
===== Scan Mode =====
In dialog mode, the scanner UI has drawed by the camera scanner service, the third app don’t need to consider about the UI.

In overlay mode, the camera scanner service only provide the scanner window, the window will display on top of the third app UI. So the third app can draw the UI by itself, such as the title, the buttons. In this mode, if the app need to switch the camera, the flash light, the indicator light, it must use the broadcast like belows:

* Camera:
# Broadcast Action : com.wizarpos.scanner.setcamera
# Broadcast Key: overlay_config
# Value: 0 Fixed camera;1 zoom camera; 2 customer display* camera

* Flash light:
* Broadcast Action : com.wizarpos.scanner.setflashlight
* Broadcast Key: overlay_config
* Value: true opened; false closed
* Indicator light:
*
* Broadcast Action : com.wizarpos.scanner.setindicator
* Broadcast Key : overlay_config
* Value: true opened; false closed

===== Scan Result =====
===== Error Code =====

Developed by scan service

The scan service is an app and started by using AIDL. The third apps custom their UI through by transfer some parameters.
===== Introduction =====
There are many applications are developed based on smart POS. In one thing, many of the Smart POS developers also have POS industry background,but not professional Android developers. So when they start developing applications, they want to be provided with a convenient scan API by WizarPOS, instead of learning Zxing/Zbar themselves.In other thing,from the hardware point of view, the scan parts used on smart POS, are not necessarily the standard camera, there will be some transformation. In some cases, the scan part will be required to be a specialized hardware. Therefore, the direct use of Zxing/Zbar is not really applicable for WizarPOS smart POS, but need some modification and customization.
For the reasons above, we consider to develop WizarPOS Scan Services to facilitate the third party developers in developing applications with scan function.

2018-04-18T08:27:05Z

Zzy nouse: /* ESC ! n(Ⅰ) */

== ESC Commands==

=== HT ===
{| class="wikitable"
|-
! HT !!
|-
| Name|| Horizontal tab
|-
| Format|| ASCII HT

Hex 09

Decimal 9

|-
| Description|| Move the print position to the next tab position.

* If no tab position is set (it is default setting), this command will be ignored

* The tab position is set by ESC D

* If the tab position exceeds the print area, printing position will be moved to the starting position of next line (Considering as a line is full, print the data and feed one line).

|-
| Reference|| ESC D
|}

=== LF ===
{| class="wikitable"
|-
! LF !!
|-
| Name|| Print and feed paper
|-
| Format|| ASCII LF

Hex 0A

Decimal 10

|-
| Description|| Print the data in the printer buffer, then feed paper for one line

according to the current line space settings. After printing, the print

position moves to the beginning of the line.

|-
| Reference|| ESC 2，ESC 3
|}
=== CR ===
{| class="wikitable"
|-
! CR !!
|-
| Name|| Carriage return
|-
| Format|| ASCII CR

Hex 0D

Decimal 13

|-
| Description|| Adjust the print position to the starting position of this line and line
feed.

|-
| Reference|| LF
|}

=== ESC SP ===
{| class="wikitable"
|-
! ESC SP !!
|-
| Name|| Set the right-side character space
|-
| Format|| ASCII ESC SP n

Hex 1B 20 n

Decimal 27 32 n

|-
| Description|| Set the right right-side character space is [n×0.125mm]
* For double width mode, the character right margin is double than normal mode.
* The command will not effective to Chinese characte

|-
| Default|| n=0
|}

=== ESC ! (Ⅰ) ===
{| class="wikitable"
|-
! ESC ! n !!
|-
| Name|| set the font type
|-
| Format|| ASCII ESC ! n

Hex 1B 21 n

Decimal 27 33 n

|-
| Description|| Set the font type (italic, border, bold, double width, double height,
inverse or underline). And the bit definitions of parameter n are
shown as follows table

|-
| Reference|| ESC -, ESC E, GS !
|-
| Default|| n=0
|}

=== ESC ! n（Ⅱ） ===
{| class="wikitable"
|-
| Bit
| On/off
| Hex
| Decimal
| Function
|-
| 0 || off || 00 || 0 || Character type A (12×24)
|-
| 0 || on || 01 || 1 || Character type B (9×17)
|-
| 4 || off || 00 || 0 || Double-height mode off
|-
| 4 || on || 10 || 16 || Double-height mode on
|-
| 5 || off || 00 || 0 || Double-width mode off
|-
| 5 || on || 20 || 32 || Double-width mode on
|-
| 7 || off || 00 || 0 || Underline mode off
|-
| 7 || on || 80 || 128 || Underline mode on
|}
* If set double-width and double-height at the same time, quadrupled thecharacter size.
* Can not underline the blank generated by HT or the rotate 90 character.
* The width of under line set by ESC -, have not affected by the character size.
* ESC M also can set character type.
* ESC – also can turn on/off underline.
* GS ! also can set character size.

=== ESC $ nL nH ===
{| class="wikitable"
|-
! ESC $ nL nH !!
|-
| Name|| Set the absolute print position
|-
| Format|| ASCII ESC $ nL nH

Hex ESC $ nL nH

Decimal 27 36 nL nH

|-
| Parameter Range||
* 0≤nL≤255
* 0≤nH≤255
|-
| Description|| Moves the print position to a location in a distance of (nL + nH × 256) dots from
the starting position for printing

|-
| Reference|| ESC \
|}

=== ESC * m nL nH ===
{| class="wikitable"
|-
! ESC * m nL nH d1...dk!!
|-
| Name|| Select bit-image mode
|-
| Format|| ASCII ESC * m nL nH d1...dk

Hex 1B 2A m nL nH d1...dk

Decimal 27 42 m nL nH d1...dk

|-
| Parameter Range||
* m = 0,1,32,33
* 0≤nL≤255
* 0≤nH≤3
* 0≤d≤255
|-
| Description|| Stores the bit image data in the print buffer using the mode specified
by bit image mode m, nl and nh specifies a bit image in the horizontal direction
as(nl+256×nh) dots, [d]k specifies the bit image data (column format)
k indicates the amount of bit image data, but it does not need to be
transmitted..

|-
| Note||
* If m is out of Parameter Range, the nL and the other data will regard as the normal data.
* If the bit image exceeds one line of print area, the excess part will be Ignored.
* Data [d]k specifies a bit printed to 1 and not printed to 0.
* Bold, double-strike, underline, character size, upside-down, black/white command will not affect to the command.
|}

=== ESC - n ===
{| class="wikitable"
|-
! ESC - n !!
|-
| Name|| Turn underline mode on/off
|-
| Format|| ASCII ESC - n

Hex 1B 2D n

Decimal 27 45 n

|-
| Description|| Turns underline mode on or off using n as follows
* if n= 0 or 48, Turns off underline mode
* if n=1 or 49, Turns on underline mode (1-dot thick)
* if n=2 or 50, Turns on underline mode (2-dots thick)

|-
| Note||
Can not underline the blank generated by HT or the rotate 90 character.
Default width is 1-dot thick.
The thick is not affected by the character size.
ESC ! can also turn on/off underline.
|-
| Default|| n=0
|-
| Reference|| ESC !
|}

=== ESC 2 ===
{| class="wikitable"
|-
! ESC 2 !!
|-
| Name|| Set the line space to a default value 3mm
|-
| Format|| ASCII ESC 2

Hex 1B 32

Decimal 27 50

|-
| Description||Set the line space to a default value 3mm(24×0.125mm)

|-
| Reference|| ESC 3
|}

=== ESC 3 ===
{| class="wikitable"
|-
! ESC 3 !!
|-
| Name|| Set the line space to n dots
|-
| Format|| ASCII ESC 3 n

Hex 1B 33 n

Decimal 27 51 n

|-
| Description|| ASet the line space to n dots

|-
| Default|| n=24
|-
| Reference|| ESC 2
|}

=== ESC SO ===
{| class="wikitable"
|-
! ESC SO !!
|-
| Name|| Turn on double width mode
|-
| Format|| ASCII ESC SO n

Hex 1B 0E n

Decimal 27 14 n
|-
| Parameter Range|| 0≤n≤255
|-
| Description|| Turn on double width mode

|-
| Note|| Use LF or ESC DC4 to turn off
|-
| Default|| n=2
|}

=== ESC DC4 ===
{| class="wikitable"
|-
! ESC DC4 !!
|-
| Name|| Turn off double width mode
|-
| Format|| ASCII ESC DC4 n

Hex 1B 14 n

Decimal 27 20 n
|-
| Parameter Range|| 0≤n≤255

|-
| Description|| Turn off double width mode

|-
| Default|| n=2
|-
| Note|| The value of n is same with the n in turn on command
|}

=== ESC @ ===
{| class="wikitable"
|-
! ESC @ !!
|-
| Name|| Initialize the printer
|-
| Format|| ASCII ESC @

Hex 1B 40

Decimal 27 64

|-
| Description|| Reset the printer, the print mode reset to the default setting

|-
| Note|| Can not clear the data in receive buffer
|}

=== ESC B ===
{| class="wikitable"
|-
! ESC B !!
|-
| Name|| Set the left margin
|-
| Format|| ASCII ESC B n

Hex 1B 42 n

Decimal 27 66 n

|-
| Parameter Range|| 0≤n≤47

|-
| Description|| Set the left margin

|-
| Note|| This command just affects the character, doesn’t affect the Chinese

|-
| Default|| n=0
|}

=== ESC D ===
{| class="wikitable"
|-
! ESC D !!
|-
| Name|| Set horizontal tab positions
|-
| Format|| ASCII ESC D n1...nk NUL

Hex 1B 44 n1...nk 00

Decimal 27 68 n1...nk 0

|-
| Parameter range ||
* 1≤n≤255
* 0≤k≤32

|-
| Description||Set the horizontal tab positions, the meanings of parameters are as follows:
n1..nk are horizontal tab position (Unit: 8 dots), NULL is a stop character
|-
| Note||
# Horizontal tab position stored as a data, the data value is [character width×n] measured from the line begin.
# When this command is used, any previous horizontal tab settings will be canceled.
# The tab position can be switched by HT command
# The max set value is 32(k=32), larger than 32, the larger data will regard as normal data.
# Transmit [d]k in ascending order and place a NULL code at the end.
# When dk is less than or equal to dk-1, horizontal tab setting is finished, and the following data will be processed as normal data.
# ESC D NUL will cancel the horizontal tab position.
# Even the character width change, the set tab position will not change.

|-
| Defualt|| Default tab position is character type A(12×24), the eight character space
(column 9,17,25 ...)
|-
| Reference|| HT
|}

=== ESC E ===
{| class="wikitable"
|-
! ESC E !!
|-
| Name|| Turn bold mode on/off
|-
| Format|| ASCII ESC E n

Hex 1B 45 n

Decimal 27 69 n

|-
| Parameter range|| 0≤n≤255

|-
| Descriptiopn|| Turns bold mode on or off using n as follows:
If n = 0, turn off the bold, if n = 1, turn on the bold.

|-
| Default|| n = 0

|-
| Reference|| ESC !
|}

=== ESC J ===
{| class="wikitable"
|-
! ESC J !!
|-
| Name|| Print and feed paper for n dots
|-
| Format|| ASCII ESC J n

Hex 1B 4A n

Decimal 27 74 n

|-
| Parameter range || 0≤n≤255

|-
| Description||Print the data in the printer buffer and feed paper for n dots(0.125mm per
dot)

|-
| Note||
* After printing, the print position moves to the beginning of the line.
* This has not affected the set value by ESC 2 or ESC 3.

|}

=== ESC G ===
{| class="wikitable"
|-
! ESC G !!
|-
| Name|| Print and feed paper
|-
| Format|| ASCII ESC G n

Hex 1B 47 n

Decimal 27 71 n

|-
| Parameter range|| 0≤n≤255

|-
| Description|| Turn double-strike mode on/off:
* 0: turn off double-strike
* 1: turn on double-strike。

|-
| Note|| The double-strike has the same print with bold print

|-
| Default|| n=0

|-
| Reference|| ESC E
|}

=== ESC M ===
{| class="wikitable"
|-
! ESC M !!
|-
| Name|| Select the character type
|-
| Format|| ASCII ESC M n

Hex 1B 4D n

Decimal 27 77 n

|-
| Parameter range|| n = 0,1,48,49

|-
| Description|| Select character type:
If n=0 or 48,Character type A (12×24)
If n=1 or 49,Character type B (9×17)

|-
| Reference|| ESC!
|}

=== ESC R ===
{| class="wikitable"
|-
! ESC R !!
|-
| Name|| Select international character
|-
| Format|| ASCII ESC R n

Hex 1B 52 n

Decimal 27 82 n
|-
| Parameter range|| 0≤n≤255

|-
| Description|| Selects an international character set n as follows::
* n=0 refer to U.S.A
* n=1 refer to France
* n=2 refer to Germany
* n=3 refer to U.K.
* n=4 refer to Denmark I
* n=5 refer to Sweden
* n=6 refer to Italy
* n=7 refer to Spain I
* n=8 refer to Japan
* n=9 refer to Norway
* n=10 refer to Denmark II
* n=11 refer to refer to Spain II
* n=12 refer to Latin America
* n=13 refer to Korea
* n=14 refer to Slovenia/Croatia
* n=15 refer to China
* n=16 refer to Vietnam
* n=17 refer to Arabia
* n=101 refer to ISO-8859-1
* n=102 refer to ISO-8859-2
* n=103 refer to ISO-8859-3
* n=104 refer to ISO-8859-4
* n=105 refer to ISO-8859-5
* n=107 refer to ISO-8859-7
* n=109 refer to ISO-8859-9
* n=113 refer to ISO-8859-13
* n=115 refer to ISO-8859-15
* n=130 refer to GB13030-2000
|-
| Default || n=0(Suggest to use n >100)
|}

=== ESC V ===
{| class="wikitable"
|-
! ESC V !!
|-
| Name|| Turn 90° clockwise rotation mode on/off
|-
| Format|| ASCII ESC V n

Hex 1B 56 n

Decimal 27 86 n

|-
| Parameter range|| n = 0,1,48,49

|-
| Description|| Turn 90° clockwise rotation mode on/off using n as follows:
* If n=0 or 48, Turns off 90°clockwise rotation mode
* If n=1 or 49, Turns on 90°clockwise rotation mode

|-
| Note|| Underline is not effective for the rotation characters

|-
| Default|| n=0

|-
| Reference|| ESC !，ESC -
|}

=== ESC \ ===
{| class="wikitable"
|-
! ESC \ !!
|-
| Name|| Print and feed paper
|-
| Format|| ASCII ESC \ nL nH

Hex 1B 5C nL nH

Decimal 27 92 nL nH

|-
| Parameter range||
* 0≤nL≤255
* 0≤nH≤255

|-
| Description || Moves the print position to a location in a distance of (nL + nH × 256) dots from the current position

|-
| Note||
* If the position is not in print area, the set will be ignored.
* If the set position is in right of the current position, the distance N is nL+nH ×256=N
* If the set position is in left of the current position, the distance N is: nL+nH×256=65536-N

|-
| Reference|| ESC $

|}

=== ESC a ===
{| class="wikitable"
|-
! ESC a !!
|-
| Name|| Set the print alignment mode(left, center or right)
|-
| Format|| ASCII ESC a n

Hex 1B 61 n

Decimal 27 97 n

|-
| Parameter range|| n=0,1,2,48,49,50

|-
| Description|| Align all data in a line, the meanings of n value are as follows:
* If n = 0,48, mode is left
* If n = 1,49, mode is center
* If n = 2,50, mode is right

|-
| Note|| The settings by this command are effective at the line begin

|-
| Default|| n=0
|}

=== ESC d ===
{| class="wikitable"
|-
! ESC d !!
|-
| Name|| Print and feed paper for n lines
|-
| Format|| ASCII ESC d n

Hex 1B 64 n

Decimal 27 100 n

|-
| Parameter range|| 0≤n≤255

|-
| Description|| Print the data in the printer buffer and feed paper for n lines

|-
| Note||
* After printing, the print position moves to the beginning of the line.
* The line space is set by ESC 2 or ESC 3.

|-
| Reference|| ESC 2，ESC 3
|}

=== ESC t ===
{| class="wikitable"
|-
! ESC t !!
|-
| Name|| Select character code table
|-
| Format|| ASCII ESC t n

Hex 1B 74 n

Decimal 27 116 n

|-
| Parameter range || 0≤n≤255

|-
| Description|| Selects an code n from the character code table as follows:
n Character code table
0 PC437: USA, Standard Europe
1 Katakana
2 PC850: Multilingual
3 PC860: Portuguese
4 PC863: Canadian-French
5 PC865: Nordic
11 PC851: Greek
12 PC853: Turkish
13 PC857: Turkish
14 PC737: Greek
15 ISO8859-7: Greek
16 WPC1252
17 PC866: Cyrillic #2
18 PC852: Latin2
19 PC858: Euro
20 KU42: Thai
21 TIS11: Thai
26 TIS18: Thai
30 TCVN-3: Vietnamese I
31 TCVN-3: Vietnamese II
32 PC720: Arabic
33 WPC775: Baltic Rim
34 PC855: Cylillic
35 PC861: Icelandic
36 PC862: Hebrew
37 PC864: Arabic
38 PC869: Greek
39 ISO8859-2: Latin2
40 ISO8859-15: Latin9
41 PC1098: Farsi
42 PC1118: Lithuanian
43 PC1119: Lithuanian
44 PC1125: Ukrainian
45 WPC1250: Latin 2
46 WPC1251: Cyrillic
47 WPC1253: Greek
48 WPC1254: Turkish
49 WPC1255: Hebrew
50 WPC1256: Arabic
51 WPC1257: Baltic Rim
52 WPC1258: Vietnamese
53 KZ1048: Kazakhstan

|-
| Default|| n=0(Suggest to use ESC R command to replace this command)
|}

===ESC { ===
{| class="wikitable"
|-
! ESC { !!
|-
| Name|| Turn upside-down printing mode on/off
|-
| Format|| ASCII ESC { n

Hex 1B 7b n

Decimal 27 123 n

|-
| Parameter range|| 0≤n≤255

|-
| Description||turns upside-down print mode on or off:
* 0 Upside-down print mode is turned off
* 1 Upside-down print mode is turned on

|-
| Note||The settings by this command are effective at the line begin.

|}

=== GS ! ===
{| class="wikitable"
|-
! GS ! !!
|-
| Name||Select character size
|-
| Format|| ASCII GS ! n

Hex 1D 21 n

Decimal 29 33 n

|-
| Parameter range|| 0≤n≤255

|-
| Description|| Function description Character height is set by the bit0~bit3 of n, and character
width is set by bit4~bit7 of n.

|-
| Note||
* If n is our of range, the command will be ignored.
* Use ESC ! also can turn on/off double-width and double height

|-
| Reference|| ESC !
|}

=== GS B ===
{| class="wikitable"
|-
! GS B !!
|-
| Name|| Turn black/white inverse printing mode on/off
|-
| Format|| ASCII GS B n

Hex 1D 412 n

Decimal 29 66 n

|-
| Parameter range|| 0≤n≤255

|-
| Description|| turns upside-down print mode on or off.
* 0 Black/white inverse printing mode is turned off
* 1 Black/white inverse printing mode is turned on
|-
| Note||
* Also effective the blank set by ESC SP.
* Not effective the blank set by HT、ESC $ and ESC \.
* Not effective the line space.
* This command prior to the underline mode, but can not cancel the underline mode.

|-
| Default||n=0
|}

=== GS v 0 ===
{| class="wikitable"
|-
! GS v 0 !!
|-
| Name|| Print raster bit image
|-
| Format|| ASCII GS v 0 m xL xH yL yH d1...dk

Hex 1D 76 30 m xL xH yL yH d1...dk

Decimal 29 118 48 m xL xH yL yH d1...dk

|-
| Parameter range||
* 0≤m≤3
* 48≤m≤51
* 0≤xL≤255
* 0≤xH≤255,1≤(xL+xH×256)≤128
* 0≤yL≤255
* 0≤yH≤8,1≤(yL+yH×256)≤4095
* 0≤d≤255
* k=(xL+xH×256)×(yL+yH×256)(k>0)

|-
| Description|| Print raster bit image, the meanings of parameter m are as follows:
{| class="wikitable"
|-
| m || Mode || Vertical dot density ||Horizontal dot density

|-
| 0, 48|| Normal ||203.2 dpi || 203.2 dpi

|-
| 1, 49|| Double width ||203.2 dpi ||101.6 dpi

|-
| 2, 50|| Double height||101.6 dpi ||203.2 dpi

|-
|3, 51 ||Double width & double height||101.6 dpi ||101.6 dpi
|}

|-
| Note||
* xL, xH specifies (xL + xH × 256) bytes in horizontal direction forthe bit image.
* yL, yH specifies (yL + yH × 256) dots in vertical direction for the bit image.
* [d]k specifies the bit image data (raster format). k indicates the number of bit image data. k is an explanation parameter; therefore, it does not need to be transmitted
* The print mode command will not affect the command.
* The data out print are will be ignored.
* The print position can be set by HT, ESC $, ESC \, GS L.
* ESC a can affect the raster image.

|-
| Reference|| ESC 2，ESC 3
|}

=== DC2 * ===
{| class="wikitable"
|-
!DC2 * !!
|-
| Name|| Bitmap print
|-
| Format|| ASCII DC2 * r n d1...dn

Hex 12 2A r n d1...dn

Decimal 18 42 r n d1...dn

|-
| Parameter range||
* 0≤n≤255
* 0<r≤255

|-
| Description||
* Print the assigned height bitmap.
* r:height
* n:width
* only effective when no data in print buffer
* the print mode command will not affect this bitmap.
* The data out of print area will be decrypted.
* Dn is the print data, 1 will print, 0 will not print

|}

=== DC2 V ===
{| class="wikitable"
|-
! DC2 V !!
|-
| Name|| MSB Bitmap print
|-
| Format|| ASCII DC2 V n nL nH d1...d48

Hex 12 56 nL nH d1...d48

Decimal 18 86 nL nH d1...d48

|-
| Parameter range|| 0<nL+nH×256

|-
| Description||
* Print the MSB bitmap, the width is 384.
* The height of the bitmap is nL+nH×256.
* Only effective when no data in print buffer
* The print mode command will not affect this bitmap.
* The data out of print area will be decrypted.
* Dn is the print data, 1 will print, 0 will not print.
|}

=== DC2 v ===
{| class="wikitable"
|-
! DC2 v !!
|-
| Name|| LSB Bitmap print
|-
| Format|| ASCII DC2 v n nL nH d1...d48

Hex 12 76 nL nH d1...d48

Decimal 18 118 nL nH d1...d48

|-
| Parameter range|| 0<nL+nH×256

|-
| Description||
* Print the LSB bitmap, the width is 384.
* The height of the bitmap is nL+nH×256.
* Only effective when no data in print buffer
* The print mode command will not affect this bitmap.
* The data out of print area will be decrypted.
* Dn is the print data, 1 will print, 0 will not print.
|}

=== DC2 T ===
{| class="wikitable"
|-
! DC2 T !!
|-
| Name|| Print test page
|-
| Format|| ASCII DC2 T

Hex 12 54

Decimal 18 84

|-
| Description||Print test page

|}

=== ESC A ===
{| class="wikitable"
|-
! ESC A !!
|-
| Name|| Check print module version
|-
| Format|| ASCII ESC A

Hex 1B 41

Decimal 27 65

|-
| Description|| Send the check command, then read the return value. The return value is 32 bytes(char[32])

|}

=== ESC > ===
{| class="wikitable"
|-
! ESC > !!
|-
| Name|| Check the font library head info
|-
| Format|| ASCII ESC >

Hex 1B 3E

Decimal 27 62

|-
| Description|| Send the check command, then read the return value. The return value is 128 bytes.
* char magic[8];
* int version;
* int size;
* int offset;
* char md5[16]
* char time[24];
* char reserve[2];
* char describe[64];
* char unuse;
* char checksum

|}

=== GS E ===
{| class="wikitable"
|-
! GS E !!
|-
| Name|| Set print density
|-
| Format|| ASCII GS E n

Hex 1D 45 n

Decimal 29 69 n

|-
| Parameter range|| 0≤n≤3

|-
| Description||
{| class="wikitable"
|-
| n || description

|-
| 0|| lighter

|-
| 1|| light

|-
| 2|| dark

|-
| 3|| darker

|}

|-
| Note||This setting will effect all the time until power off the printer or reset the
command

|-
| Default|| n=1
|}

ESC Commands

2018-04-18T08:26:53Z

Zzy nouse: /* ESC SP n */

== ESC Commands==

=== HT ===
{| class="wikitable"
|-
! HT !!
|-
| Name|| Horizontal tab
|-
| Format|| ASCII HT

Hex 09

Decimal 9

|-
| Description|| Move the print position to the next tab position.

* If no tab position is set (it is default setting), this command will be ignored

* The tab position is set by ESC D

* If the tab position exceeds the print area, printing position will be moved to the starting position of next line (Considering as a line is full, print the data and feed one line).

|-
| Reference|| ESC D
|}

=== LF ===
{| class="wikitable"
|-
! LF !!
|-
| Name|| Print and feed paper
|-
| Format|| ASCII LF

Hex 0A

Decimal 10

|-
| Description|| Print the data in the printer buffer, then feed paper for one line

according to the current line space settings. After printing, the print

position moves to the beginning of the line.

|-
| Reference|| ESC 2，ESC 3
|}
=== CR ===
{| class="wikitable"
|-
! CR !!
|-
| Name|| Carriage return
|-
| Format|| ASCII CR

Hex 0D

Decimal 13

|-
| Description|| Adjust the print position to the starting position of this line and line
feed.

|-
| Reference|| LF
|}

=== ESC SP ===
{| class="wikitable"
|-
! ESC SP !!
|-
| Name|| Set the right-side character space
|-
| Format|| ASCII ESC SP n

Hex 1B 20 n

Decimal 27 32 n

|-
| Description|| Set the right right-side character space is [n×0.125mm]
* For double width mode, the character right margin is double than normal mode.
* The command will not effective to Chinese characte

|-
| Default|| n=0
|}

=== ESC ! n(Ⅰ) ===
{| class="wikitable"
|-
! ESC ! n !!
|-
| Name|| set the font type
|-
| Format|| ASCII ESC ! n

Hex 1B 21 n

Decimal 27 33 n

|-
| Description|| Set the font type (italic, border, bold, double width, double height,
inverse or underline). And the bit definitions of parameter n are
shown as follows table

|-
| Reference|| ESC -, ESC E, GS !
|-
| Default|| n=0
|}

=== ESC ! n（Ⅱ） ===
{| class="wikitable"
|-
| Bit
| On/off
| Hex
| Decimal
| Function
|-
| 0 || off || 00 || 0 || Character type A (12×24)
|-
| 0 || on || 01 || 1 || Character type B (9×17)
|-
| 4 || off || 00 || 0 || Double-height mode off
|-
| 4 || on || 10 || 16 || Double-height mode on
|-
| 5 || off || 00 || 0 || Double-width mode off
|-
| 5 || on || 20 || 32 || Double-width mode on
|-
| 7 || off || 00 || 0 || Underline mode off
|-
| 7 || on || 80 || 128 || Underline mode on
|}
* If set double-width and double-height at the same time, quadrupled thecharacter size.
* Can not underline the blank generated by HT or the rotate 90 character.
* The width of under line set by ESC -, have not affected by the character size.
* ESC M also can set character type.
* ESC – also can turn on/off underline.
* GS ! also can set character size.

=== ESC $ nL nH ===
{| class="wikitable"
|-
! ESC $ nL nH !!
|-
| Name|| Set the absolute print position
|-
| Format|| ASCII ESC $ nL nH

Hex ESC $ nL nH

Decimal 27 36 nL nH

|-
| Parameter Range||
* 0≤nL≤255
* 0≤nH≤255
|-
| Description|| Moves the print position to a location in a distance of (nL + nH × 256) dots from
the starting position for printing

|-
| Reference|| ESC \
|}

=== ESC * m nL nH ===
{| class="wikitable"
|-
! ESC * m nL nH d1...dk!!
|-
| Name|| Select bit-image mode
|-
| Format|| ASCII ESC * m nL nH d1...dk

Hex 1B 2A m nL nH d1...dk

Decimal 27 42 m nL nH d1...dk

|-
| Parameter Range||
* m = 0,1,32,33
* 0≤nL≤255
* 0≤nH≤3
* 0≤d≤255
|-
| Description|| Stores the bit image data in the print buffer using the mode specified
by bit image mode m, nl and nh specifies a bit image in the horizontal direction
as(nl+256×nh) dots, [d]k specifies the bit image data (column format)
k indicates the amount of bit image data, but it does not need to be
transmitted..

|-
| Note||
* If m is out of Parameter Range, the nL and the other data will regard as the normal data.
* If the bit image exceeds one line of print area, the excess part will be Ignored.
* Data [d]k specifies a bit printed to 1 and not printed to 0.
* Bold, double-strike, underline, character size, upside-down, black/white command will not affect to the command.
|}

=== ESC - n ===
{| class="wikitable"
|-
! ESC - n !!
|-
| Name|| Turn underline mode on/off
|-
| Format|| ASCII ESC - n

Hex 1B 2D n

Decimal 27 45 n

|-
| Description|| Turns underline mode on or off using n as follows
* if n= 0 or 48, Turns off underline mode
* if n=1 or 49, Turns on underline mode (1-dot thick)
* if n=2 or 50, Turns on underline mode (2-dots thick)

|-
| Note||
Can not underline the blank generated by HT or the rotate 90 character.
Default width is 1-dot thick.
The thick is not affected by the character size.
ESC ! can also turn on/off underline.
|-
| Default|| n=0
|-
| Reference|| ESC !
|}

=== ESC 2 ===
{| class="wikitable"
|-
! ESC 2 !!
|-
| Name|| Set the line space to a default value 3mm
|-
| Format|| ASCII ESC 2

Hex 1B 32

Decimal 27 50

|-
| Description||Set the line space to a default value 3mm(24×0.125mm)

|-
| Reference|| ESC 3
|}

=== ESC 3 ===
{| class="wikitable"
|-
! ESC 3 !!
|-
| Name|| Set the line space to n dots
|-
| Format|| ASCII ESC 3 n

Hex 1B 33 n

Decimal 27 51 n

|-
| Description|| ASet the line space to n dots

|-
| Default|| n=24
|-
| Reference|| ESC 2
|}

=== ESC SO ===
{| class="wikitable"
|-
! ESC SO !!
|-
| Name|| Turn on double width mode
|-
| Format|| ASCII ESC SO n

Hex 1B 0E n

Decimal 27 14 n
|-
| Parameter Range|| 0≤n≤255
|-
| Description|| Turn on double width mode

|-
| Note|| Use LF or ESC DC4 to turn off
|-
| Default|| n=2
|}

=== ESC DC4 ===
{| class="wikitable"
|-
! ESC DC4 !!
|-
| Name|| Turn off double width mode
|-
| Format|| ASCII ESC DC4 n

Hex 1B 14 n

Decimal 27 20 n
|-
| Parameter Range|| 0≤n≤255

|-
| Description|| Turn off double width mode

|-
| Default|| n=2
|-
| Note|| The value of n is same with the n in turn on command
|}

=== ESC @ ===
{| class="wikitable"
|-
! ESC @ !!
|-
| Name|| Initialize the printer
|-
| Format|| ASCII ESC @

Hex 1B 40

Decimal 27 64

|-
| Description|| Reset the printer, the print mode reset to the default setting

|-
| Note|| Can not clear the data in receive buffer
|}

=== ESC B ===
{| class="wikitable"
|-
! ESC B !!
|-
| Name|| Set the left margin
|-
| Format|| ASCII ESC B n

Hex 1B 42 n

Decimal 27 66 n

|-
| Parameter Range|| 0≤n≤47

|-
| Description|| Set the left margin

|-
| Note|| This command just affects the character, doesn’t affect the Chinese

|-
| Default|| n=0
|}

=== ESC D ===
{| class="wikitable"
|-
! ESC D !!
|-
| Name|| Set horizontal tab positions
|-
| Format|| ASCII ESC D n1...nk NUL

Hex 1B 44 n1...nk 00

Decimal 27 68 n1...nk 0

|-
| Parameter range ||
* 1≤n≤255
* 0≤k≤32

|-
| Description||Set the horizontal tab positions, the meanings of parameters are as follows:
n1..nk are horizontal tab position (Unit: 8 dots), NULL is a stop character
|-
| Note||
# Horizontal tab position stored as a data, the data value is [character width×n] measured from the line begin.
# When this command is used, any previous horizontal tab settings will be canceled.
# The tab position can be switched by HT command
# The max set value is 32(k=32), larger than 32, the larger data will regard as normal data.
# Transmit [d]k in ascending order and place a NULL code at the end.
# When dk is less than or equal to dk-1, horizontal tab setting is finished, and the following data will be processed as normal data.
# ESC D NUL will cancel the horizontal tab position.
# Even the character width change, the set tab position will not change.

|-
| Defualt|| Default tab position is character type A(12×24), the eight character space
(column 9,17,25 ...)
|-
| Reference|| HT
|}

=== ESC E ===
{| class="wikitable"
|-
! ESC E !!
|-
| Name|| Turn bold mode on/off
|-
| Format|| ASCII ESC E n

Hex 1B 45 n

Decimal 27 69 n

|-
| Parameter range|| 0≤n≤255

|-
| Descriptiopn|| Turns bold mode on or off using n as follows:
If n = 0, turn off the bold, if n = 1, turn on the bold.

|-
| Default|| n = 0

|-
| Reference|| ESC !
|}

=== ESC J ===
{| class="wikitable"
|-
! ESC J !!
|-
| Name|| Print and feed paper for n dots
|-
| Format|| ASCII ESC J n

Hex 1B 4A n

Decimal 27 74 n

|-
| Parameter range || 0≤n≤255

|-
| Description||Print the data in the printer buffer and feed paper for n dots(0.125mm per
dot)

|-
| Note||
* After printing, the print position moves to the beginning of the line.
* This has not affected the set value by ESC 2 or ESC 3.

|}

=== ESC G ===
{| class="wikitable"
|-
! ESC G !!
|-
| Name|| Print and feed paper
|-
| Format|| ASCII ESC G n

Hex 1B 47 n

Decimal 27 71 n

|-
| Parameter range|| 0≤n≤255

|-
| Description|| Turn double-strike mode on/off:
* 0: turn off double-strike
* 1: turn on double-strike。

|-
| Note|| The double-strike has the same print with bold print

|-
| Default|| n=0

|-
| Reference|| ESC E
|}

=== ESC M ===
{| class="wikitable"
|-
! ESC M !!
|-
| Name|| Select the character type
|-
| Format|| ASCII ESC M n

Hex 1B 4D n

Decimal 27 77 n

|-
| Parameter range|| n = 0,1,48,49

|-
| Description|| Select character type:
If n=0 or 48,Character type A (12×24)
If n=1 or 49,Character type B (9×17)

|-
| Reference|| ESC!
|}

=== ESC R ===
{| class="wikitable"
|-
! ESC R !!
|-
| Name|| Select international character
|-
| Format|| ASCII ESC R n

Hex 1B 52 n

Decimal 27 82 n
|-
| Parameter range|| 0≤n≤255

|-
| Description|| Selects an international character set n as follows::
* n=0 refer to U.S.A
* n=1 refer to France
* n=2 refer to Germany
* n=3 refer to U.K.
* n=4 refer to Denmark I
* n=5 refer to Sweden
* n=6 refer to Italy
* n=7 refer to Spain I
* n=8 refer to Japan
* n=9 refer to Norway
* n=10 refer to Denmark II
* n=11 refer to refer to Spain II
* n=12 refer to Latin America
* n=13 refer to Korea
* n=14 refer to Slovenia/Croatia
* n=15 refer to China
* n=16 refer to Vietnam
* n=17 refer to Arabia
* n=101 refer to ISO-8859-1
* n=102 refer to ISO-8859-2
* n=103 refer to ISO-8859-3
* n=104 refer to ISO-8859-4
* n=105 refer to ISO-8859-5
* n=107 refer to ISO-8859-7
* n=109 refer to ISO-8859-9
* n=113 refer to ISO-8859-13
* n=115 refer to ISO-8859-15
* n=130 refer to GB13030-2000
|-
| Default || n=0(Suggest to use n >100)
|}

=== ESC V ===
{| class="wikitable"
|-
! ESC V !!
|-
| Name|| Turn 90° clockwise rotation mode on/off
|-
| Format|| ASCII ESC V n

Hex 1B 56 n

Decimal 27 86 n

|-
| Parameter range|| n = 0,1,48,49

|-
| Description|| Turn 90° clockwise rotation mode on/off using n as follows:
* If n=0 or 48, Turns off 90°clockwise rotation mode
* If n=1 or 49, Turns on 90°clockwise rotation mode

|-
| Note|| Underline is not effective for the rotation characters

|-
| Default|| n=0

|-
| Reference|| ESC !，ESC -
|}

=== ESC \ ===
{| class="wikitable"
|-
! ESC \ !!
|-
| Name|| Print and feed paper
|-
| Format|| ASCII ESC \ nL nH

Hex 1B 5C nL nH

Decimal 27 92 nL nH

|-
| Parameter range||
* 0≤nL≤255
* 0≤nH≤255

|-
| Description || Moves the print position to a location in a distance of (nL + nH × 256) dots from the current position

|-
| Note||
* If the position is not in print area, the set will be ignored.
* If the set position is in right of the current position, the distance N is nL+nH ×256=N
* If the set position is in left of the current position, the distance N is: nL+nH×256=65536-N

|-
| Reference|| ESC $

|}

=== ESC a ===
{| class="wikitable"
|-
! ESC a !!
|-
| Name|| Set the print alignment mode(left, center or right)
|-
| Format|| ASCII ESC a n

Hex 1B 61 n

Decimal 27 97 n

|-
| Parameter range|| n=0,1,2,48,49,50

|-
| Description|| Align all data in a line, the meanings of n value are as follows:
* If n = 0,48, mode is left
* If n = 1,49, mode is center
* If n = 2,50, mode is right

|-
| Note|| The settings by this command are effective at the line begin

|-
| Default|| n=0
|}

=== ESC d ===
{| class="wikitable"
|-
! ESC d !!
|-
| Name|| Print and feed paper for n lines
|-
| Format|| ASCII ESC d n

Hex 1B 64 n

Decimal 27 100 n

|-
| Parameter range|| 0≤n≤255

|-
| Description|| Print the data in the printer buffer and feed paper for n lines

|-
| Note||
* After printing, the print position moves to the beginning of the line.
* The line space is set by ESC 2 or ESC 3.

|-
| Reference|| ESC 2，ESC 3
|}

=== ESC t ===
{| class="wikitable"
|-
! ESC t !!
|-
| Name|| Select character code table
|-
| Format|| ASCII ESC t n

Hex 1B 74 n

Decimal 27 116 n

|-
| Parameter range || 0≤n≤255

|-
| Description|| Selects an code n from the character code table as follows:
n Character code table
0 PC437: USA, Standard Europe
1 Katakana
2 PC850: Multilingual
3 PC860: Portuguese
4 PC863: Canadian-French
5 PC865: Nordic
11 PC851: Greek
12 PC853: Turkish
13 PC857: Turkish
14 PC737: Greek
15 ISO8859-7: Greek
16 WPC1252
17 PC866: Cyrillic #2
18 PC852: Latin2
19 PC858: Euro
20 KU42: Thai
21 TIS11: Thai
26 TIS18: Thai
30 TCVN-3: Vietnamese I
31 TCVN-3: Vietnamese II
32 PC720: Arabic
33 WPC775: Baltic Rim
34 PC855: Cylillic
35 PC861: Icelandic
36 PC862: Hebrew
37 PC864: Arabic
38 PC869: Greek
39 ISO8859-2: Latin2
40 ISO8859-15: Latin9
41 PC1098: Farsi
42 PC1118: Lithuanian
43 PC1119: Lithuanian
44 PC1125: Ukrainian
45 WPC1250: Latin 2
46 WPC1251: Cyrillic
47 WPC1253: Greek
48 WPC1254: Turkish
49 WPC1255: Hebrew
50 WPC1256: Arabic
51 WPC1257: Baltic Rim
52 WPC1258: Vietnamese
53 KZ1048: Kazakhstan

|-
| Default|| n=0(Suggest to use ESC R command to replace this command)
|}

===ESC { ===
{| class="wikitable"
|-
! ESC { !!
|-
| Name|| Turn upside-down printing mode on/off
|-
| Format|| ASCII ESC { n

Hex 1B 7b n

Decimal 27 123 n

|-
| Parameter range|| 0≤n≤255

|-
| Description||turns upside-down print mode on or off:
* 0 Upside-down print mode is turned off
* 1 Upside-down print mode is turned on

|-
| Note||The settings by this command are effective at the line begin.

|}

=== GS ! ===
{| class="wikitable"
|-
! GS ! !!
|-
| Name||Select character size
|-
| Format|| ASCII GS ! n

Hex 1D 21 n

Decimal 29 33 n

|-
| Parameter range|| 0≤n≤255

|-
| Description|| Function description Character height is set by the bit0~bit3 of n, and character
width is set by bit4~bit7 of n.

|-
| Note||
* If n is our of range, the command will be ignored.
* Use ESC ! also can turn on/off double-width and double height

|-
| Reference|| ESC !
|}

=== GS B ===
{| class="wikitable"
|-
! GS B !!
|-
| Name|| Turn black/white inverse printing mode on/off
|-
| Format|| ASCII GS B n

Hex 1D 412 n

Decimal 29 66 n

|-
| Parameter range|| 0≤n≤255

|-
| Description|| turns upside-down print mode on or off.
* 0 Black/white inverse printing mode is turned off
* 1 Black/white inverse printing mode is turned on
|-
| Note||
* Also effective the blank set by ESC SP.
* Not effective the blank set by HT、ESC $ and ESC \.
* Not effective the line space.
* This command prior to the underline mode, but can not cancel the underline mode.

|-
| Default||n=0
|}

=== GS v 0 ===
{| class="wikitable"
|-
! GS v 0 !!
|-
| Name|| Print raster bit image
|-
| Format|| ASCII GS v 0 m xL xH yL yH d1...dk

Hex 1D 76 30 m xL xH yL yH d1...dk

Decimal 29 118 48 m xL xH yL yH d1...dk

|-
| Parameter range||
* 0≤m≤3
* 48≤m≤51
* 0≤xL≤255
* 0≤xH≤255,1≤(xL+xH×256)≤128
* 0≤yL≤255
* 0≤yH≤8,1≤(yL+yH×256)≤4095
* 0≤d≤255
* k=(xL+xH×256)×(yL+yH×256)(k>0)

|-
| Description|| Print raster bit image, the meanings of parameter m are as follows:
{| class="wikitable"
|-
| m || Mode || Vertical dot density ||Horizontal dot density

|-
| 0, 48|| Normal ||203.2 dpi || 203.2 dpi

|-
| 1, 49|| Double width ||203.2 dpi ||101.6 dpi

|-
| 2, 50|| Double height||101.6 dpi ||203.2 dpi

|-
|3, 51 ||Double width & double height||101.6 dpi ||101.6 dpi
|}

|-
| Note||
* xL, xH specifies (xL + xH × 256) bytes in horizontal direction forthe bit image.
* yL, yH specifies (yL + yH × 256) dots in vertical direction for the bit image.
* [d]k specifies the bit image data (raster format). k indicates the number of bit image data. k is an explanation parameter; therefore, it does not need to be transmitted
* The print mode command will not affect the command.
* The data out print are will be ignored.
* The print position can be set by HT, ESC $, ESC \, GS L.
* ESC a can affect the raster image.

|-
| Reference|| ESC 2，ESC 3
|}

=== DC2 * ===
{| class="wikitable"
|-
!DC2 * !!
|-
| Name|| Bitmap print
|-
| Format|| ASCII DC2 * r n d1...dn

Hex 12 2A r n d1...dn

Decimal 18 42 r n d1...dn

|-
| Parameter range||
* 0≤n≤255
* 0<r≤255

|-
| Description||
* Print the assigned height bitmap.
* r:height
* n:width
* only effective when no data in print buffer
* the print mode command will not affect this bitmap.
* The data out of print area will be decrypted.
* Dn is the print data, 1 will print, 0 will not print

|}

=== DC2 V ===
{| class="wikitable"
|-
! DC2 V !!
|-
| Name|| MSB Bitmap print
|-
| Format|| ASCII DC2 V n nL nH d1...d48

Hex 12 56 nL nH d1...d48

Decimal 18 86 nL nH d1...d48

|-
| Parameter range|| 0<nL+nH×256

|-
| Description||
* Print the MSB bitmap, the width is 384.
* The height of the bitmap is nL+nH×256.
* Only effective when no data in print buffer
* The print mode command will not affect this bitmap.
* The data out of print area will be decrypted.
* Dn is the print data, 1 will print, 0 will not print.
|}

=== DC2 v ===
{| class="wikitable"
|-
! DC2 v !!
|-
| Name|| LSB Bitmap print
|-
| Format|| ASCII DC2 v n nL nH d1...d48

Hex 12 76 nL nH d1...d48

Decimal 18 118 nL nH d1...d48

|-
| Parameter range|| 0<nL+nH×256

|-
| Description||
* Print the LSB bitmap, the width is 384.
* The height of the bitmap is nL+nH×256.
* Only effective when no data in print buffer
* The print mode command will not affect this bitmap.
* The data out of print area will be decrypted.
* Dn is the print data, 1 will print, 0 will not print.
|}

=== DC2 T ===
{| class="wikitable"
|-
! DC2 T !!
|-
| Name|| Print test page
|-
| Format|| ASCII DC2 T

Hex 12 54

Decimal 18 84

|-
| Description||Print test page

|}

=== ESC A ===
{| class="wikitable"
|-
! ESC A !!
|-
| Name|| Check print module version
|-
| Format|| ASCII ESC A

Hex 1B 41

Decimal 27 65

|-
| Description|| Send the check command, then read the return value. The return value is 32 bytes(char[32])

|}

=== ESC > ===
{| class="wikitable"
|-
! ESC > !!
|-
| Name|| Check the font library head info
|-
| Format|| ASCII ESC >

Hex 1B 3E

Decimal 27 62

|-
| Description|| Send the check command, then read the return value. The return value is 128 bytes.
* char magic[8];
* int version;
* int size;
* int offset;
* char md5[16]
* char time[24];
* char reserve[2];
* char describe[64];
* char unuse;
* char checksum

|}

=== GS E ===
{| class="wikitable"
|-
! GS E !!
|-
| Name|| Set print density
|-
| Format|| ASCII GS E n

Hex 1D 45 n

Decimal 29 69 n

|-
| Parameter range|| 0≤n≤3

|-
| Description||
{| class="wikitable"
|-
| n || description

|-
| 0|| lighter

|-
| 1|| light

|-
| 2|| dark

|-
| 3|| darker

|}

|-
| Note||This setting will effect all the time until power off the printer or reset the
command

|-
| Default|| n=1
|}