Shanghai Loogal Information Tech Co.

, Ltd
www.loogal.com

EC/ES/EP Ethernet communication protocol v0.8

1. Overview
Ethernet communication means other equipment sends command to EC/ES/EP printer by
Ethernet and get response from printer. In this way, printer is controlled. It is mainly used in
mechanical integration system, third party software control and secondary development, etc.
Taking UDP Transmission communication data packet, printer works as server side, ( IP
address:192.168.1.xx, sever port number 1025-5000(can set)), customer equipment works as
Client side.
Communication data packet takes sending/ response mechanism, customer equipment is
the sender and printer is response part
Coded format of character parameters is UTF-8

2. Process

1 / 18
 Shanghai Loogal Information Tech Co., Ltd
www.loogal.com

3. Regulations
3.1 Printer setting
Turn on printer and enter to print interface, if not press start print button, then printer is in
real time control mode.
3.2 Regulations
1. EC IP address is :192.168.1. xx, Server port number is :1025-5000
2. Receive response: When printer receives command, it will send response to control
equipment.
3. One Piece of demand has to be finished sending in 0.3 second
4. Next command can only be sent to printer when printer is already responded or after 0.5
seconds

2 / 18
 Shanghai Loogal Information Tech Co., Ltd
www.loogal.com
3.3 Command format
Command is composed of below parts

Command head: is in fixed format.

Command: command content is different according to different command
Parameters bytes quantity: it means the quantity of bytes in the command parameters.
Command parameters: Detailed content of parameters, when number of bytes is 0 s, pls
ignore this one。
CRC8 Verify：CRC8 verify code of all bytes。
3.4 Response format
1. When printer receives command from internet access., if receive right, then respond
below：

Respond head is in fixed format。

Respond code: Command that printer receives。
Parameter byte quantity received: Parameter byte quantity received (except read status
command)。
Respond parameters: command parameters received (except read status command) 。
CRC8 Verify: CRCR verify code of all bytes。

2. When printer receives command sent from internet access, if received wrong, then
respond：

3 / 18
 Shanghai Loogal Information Tech Co., Ltd
www.loogal.com

4. Details explanation of command

4.1 Start printing command
Function: Send print command to printer, and printer will enter to print status after
receiving and processing the command successfully. (judge whether command processing is
successful by reading status regularly)

If printer receives right, then respond:

4.2 Stop printing

Functions: Send stop print command to printer, printer will enter to ready status when
receive and process the command successfully. (judge whether command processing is
finished by reading status regularly). This command can also make printer recover from error
and enter to ready status/

4 / 18
 Shanghai Loogal Information Tech Co., Ltd
www.loogal.com

If printer receives right, then respond:

4.3 Trigger command

Function: Send trigger command to printer, printer will print one time when received
command. (similar to trigger the sensor for one time )

If printer receives right, then respond:

4.4 Change file

Function: send file to printer

5 / 18
 Shanghai Loogal Information Tech Co., Ltd
www.loogal.com

If printer receives right command, then respond:

If printer receives wrong command or download the file wrong, then respond:

4.5 Send real time generated data

If there is only one field in the real time data

If there is several fields in real time data, then separate by ，

6 / 18
 Shanghai Loogal Information Tech Co., Ltd
www.loogal.com

若喷码机接收正确，则应答：If print receives right, then respond:

If printer receives wrong or download wrong print file or is not in print status, then respond:

Remark:
If real time data is included in the print file, during print process, control equipment can
send real time data to printer by Ethernet, printer will print according to receive sequence.
Printer only supports real time data that is in UTF-8 format and only one real time data
(max include 8 fields) can be included in each print file. Real time data has to be all received
0.3s ahead of starting to print.
Control equipment has to wait for the response from printer after sending one real time
data. If printer responds correctly, then control equipment can continue to send next data, if
responds wrong, data has to be sent again.

4.6 Clean print head

Function: send command “clean print head” to printer, when printer receives command, it
will squeeze little ink to clean the print head

7 / 18
 Shanghai Loogal Information Tech Co., Ltd
www.loogal.com

4.7 Read status

If EC receives right, then respond:

8 / 18
 Shanghai Loogal Information Tech Co., Ltd
www.loogal.com

If ES/EP receives right, then respond:

Remark:
Print head quantity in the status data is decided by the print head quantity selected by customer when
start to print.
Status data details can refer to “ printer status data”
When unrecoverable error happens in ES/EP, printer will upload status automatically.
1. The upload content is response package of reading status command.
2. Upload port number is present communication port (UDP) +1, For example, communication port is
1000, then status upload port is 1001.
3. Printer will upload the status every 1 second, until receives the command of reading status.

5. Printer status data

ARM version number：0Xxx
FPGA version number：0Xxx
Printer work status：0Xxx
Printer error status：0Xxx
Bytes reserved：0X00
Trigger times：0Xxxxx
Print times：0Xxxxx
Current production line speed：0Xxx unit: m/min
Cartridge type：0Xxx
Print head error status：0Xxx

9 / 18
 Shanghai Loogal Information Tech Co., Ltd
www.loogal.com
Rest ink capacity：0Xxx Cartridge rest ink percentage, unit: %

5.1 Printer work status

Printer status Parameter Phenomenon Remark
value
status: Idle/Ready 0x00 Green light always on
status: Print 0x01 green light flashes slowly
status: Self check 0x02 Green light flashes quickly
status: Clean print head 0x03 Green light flashes quickly
status: in spit mode 0x04 Green light flashes quickly
status: processing 0x05 Green light flashes quickly
command
status: Firmware upgrade 0x06 Green light flashes quickly
status: Software update 0x07 Green light flashes quickly
5.2 （EC printer）Error status
Parameter
Printer error status Phenomenon Remark
value
No error 0
Red light
Self- check error(start to print ) 1 Contact Supplier
flashes slowly
Adjust the real time
Real time data is not received when Red light
2 data speed to match
printer is in real time mode (in printing) flashes quickly
with print speed
Red light
Data overtime in print head ( in printing) 3 Lower print speed
flashes quickly
Red light
No file to print 4 Contact Supplier
flashes quickly
Red light
No relative font 5 Contact Supplier
flashes quickly
File error ( start to print )

Red light
6 Pls reedit file
flashes quickly

Font issue or not receive the static image

(start to print)
Red light Pls update font or
7
flashes quickly send image

Cannot find this character in the font (in 8 Red light Pls update font
printing) flashes quickly
Using the character encoding that is not

10 / 18
 Shanghai Loogal Information Tech Co., Ltd
www.loogal.com
supported ( in printing)
bitmap is not monochromatic in printing）
Red light Page length value
Easyjet run out of memory 9
flashes quickly is too big
Red light
missing static image 10
flashes quickly Restart to print

Same RFID chip issue ( Lock the print Red light

11 Back to Loogal to
head) flashes quickly
reset
there is error when save RFID chip
Red light Back to Loogal for
information to Flash（ Flash chip in print 12
flashes quickly repair
head is wrong ）
5.3 （ES /EP printer）Error status
Please refer to return parameter value listed in below chart, 0 means normal. In printing
process, if not 0, then will wait for control equipment to send command ( ink lack error will
not affect print, but need to pay attention to print quality. When print quality is not good , pls
change cartridge)
1.1.1 Print file error 0x2

Dialog box in software Return Warning light Reasons& Solutions

interface parameter
value
Wrong system time is detected
Red light flashes when saving file.
Error: Print file 01 0x2001
quickly Please change battery and set right
time.
Red light flashes
Error: Print file 02 0x2002 Print file is damaged, please delete
quickly old file and create a new one
Red light flashes
Error: Print file 03 0x2003 Cannot find print file, pls edit file in
quickly right method
Databased print is finished, please
Red light flashes
Error: Print file 04 0x2004 reedit print file and set start data of
quickly database
Red light flashes Counter reaches the end, please
Error: Print file 05 0x2005
quickly reedit print file or adjust start page.
Red light flashes
Error: Print file 06 0x2006 Image is not found
quickly
Red light flashes
Error: Print file 07 0x2007 Field of data is not found
quickly
Error: Print file 08 0x2008 Red light flashes Not select print head

11 / 18
 Shanghai Loogal Information Tech Co., Ltd
www.loogal.com
quickly

1.1.2 Error list happened in controller

Dialog box in software Return Warning light Reasons& Solutions

interface parameter
value
01 Error: controller 0x3001 Red light flashes Printer is not registered, pls return for
detection quickly repair
Error: controller detection Red light flashes
0x3002 RAM detection failed, return for repair
02 quickly
Error: controller detection Red light flashes EEPROM detection failed, return for
0x3003
03 quickly repair
Error: controller detection Red light flashes
0x3004 Data error inside controller, upgrade
04 quickly

Dialog box in software parameter

interface value Warning light Reasons& Solutions

Error: Abnormal power After cancelling, print will recover.

0x400?
off :01 Normal power off next time.

Error: Abnormal power Red light flashes Continuous abnormal power off for a
0x4005 few times, hardware is broken, pls
off :02 quickly return for repair
? is the times that printer is in abnormal power off, hardware will be damaged if over 5
times.

1.1.3 Error list happened in print head

0x5*?? * stands for the print head/cartridge number, ？？ is subcode of error

Return Warning light Reasons& Solutions
Dialog box in software
parameter
interface
value
Not receive the DOUT data
1) Select wrong print head
Error: NOx. Print head Red light flashes 2) Connection cable loosen, damaged
0x5*01
detection 01 quickly or not connected。
3) Hardware is damaged, trouble shoot
by error reasons or return to repair

12 / 18
 Shanghai Loogal Information Tech Co., Ltd
www.loogal.com
1.1.4 Cartridge error

0x6*?? * is print head/cartridge number, ?? is subcode of error

Return
Dialog box in software
parameter Warning light Reasons& Solutions
interface
value
Error: NOx cartridge Red light flashes Cartridge lock number does not match
0x6*01
detection 01 slowly with printer, change cartridge
Error: NOx cartridge Red light flashes Failed to read the chip on the cartridge,
0x6*02
detection 02 slowly change cartridge
Error: NOx cartridge Red light flashes Not read the cartridge chip, chip is
0x6*03
detection 03 slowly damaged, change cartridge
Module that read cartridge chips does
Error: NOx cartridge Red light flashes
0x6*04 not work, change cartridge or return for
detection 04 slowly repair
Return
Dialog box in software
parameter Warning light Reasons& Solutions
interface
value
Cartridge print capacity has reached to
specified value, is displayed in the
Yellow light
0x6*05 printer ink capacity interface. Click
Error: NOx lack of ink 05 flashes slowly enter to go into print and change
cartridge
Return
Dialog box in software
parameter Warning light Reasons& Solutions
interface
value
Cartridge print capacity has reached to
Red light flashes specified value over 130%, pls stop
Error: NOx lack of ink 05 0x6*06
slowly printing compulsory and change
cartridge

1.1.5 Print head communication error 0x7

0x7*?? * is print head/cartridge number, ?? is subcode of error

Dialog box in software Return
Warning light Reasons& Solutions
interface code
Error: NOx print head Not receive response from print head
Red light control board for 3 continuous times,
communication 01 0x7*01
flashes quickly print head selection is wrong or return
for repair
Error: NOx print head 0x7*02 Red light Receive the response error package
13 / 18
 Shanghai Loogal Information Tech Co., Ltd
www.loogal.com
communication 02 from print head control board for 3
flashes quickly
continuous times
Error: NOx print head 连续 3 次喷头控制板应答包校验出错
Red light Print head control board response
communication 03 0x7*03
flashes quickly package verify has error for 3
continuous times
Error: NOx print head Red light Communication is not stable (frequency
0x7*04 that has response error is over 30%)
communication 04 flashes quickly
Error: NOx print head Red light Receive the print data when printer is in
0x7*05 idle status
communication 05 flashes quickly
Error: NOx print head Red light
0x7*06 Failed to check print head status
communication 06 flashes quickly
Error: NOx print head Red light Print head set return overtime
0x7*07
communication 07 flashes quickly
Error: NOx print head Red light Failed to start printing
0x7*08
communication 08 flashes quickly
Error: NOx print head Red light Command of starting printing return is
0x7*09 over time
communication 09 flashes quickly
Error: NOx print head Red light Failed to send data for 3 continuous
0x7*0A times
communication 0A flashes quickly
Error: NOx print head Red light Communication error, information
0x7*0B received is less than byte
communication 0B flashes quickly
Error: NOx print head Red light Received printer data when the print
0x7*0C data buffer is already full
communication 0C flashes quickly
Error: NOx print head Red light Print data package number is wrong
0x7*0D
communication 0D flashes quickly
Error: NOx print head Red light Data length in the zip package is not
0x7*0E right
communication 0E flashes quickly
Error: NOx print head Red light Print data length is one page is not right
0x7*0F
communication 0F flashes quickly
Error: NOx print head Red light Data ends format in one page is not
0x7*10 right
communication 10 flashes quickly

1.1.6 Other errors 0x8

Return
Dialog box in software
parameter Warning light Reasons & Solutions
interface
value
14 / 18
 Shanghai Loogal Information Tech Co., Ltd
www.loogal.com
Error: print overspeed 01 Red light 01 Line speed is over max print speed
0x8001 of printer
flashes quickly
Error: print overspeed Red light 02 Printer cannot process data in time
0x8002
0102 flashes quickly
1) When sensor detects the object,
printer does not receive the real
time data that needs printing.
2) when sensor detects object,
printer cannot transfer the real
time data to printer data in
time. 3) Static electricity and
Error: print overspeed Red light
0x8003 electromagnetic interference
0103 flashes quickly affect the data transfer
A) Solutions: 1) increase the data
send speed 2) increase distance
from sensor to print head 3)
improve the working
environment, decrease
electromagnetic interference

5.4 Print head error status

Print head error Parameter Phenomenon Remark

value
Normal 0x00
Print head self-check fails 0x01 Red light flashes slowly check print had
Print head verify fails 0x02 Red light flashes slowly change to Loogal verify
cartridge
Ink will be finished, lack 0x03 Red light flashes slowly, Change cartridge
of ink green light flashes slowly
Ink finished, Out of ink 0x04 Red light flashes slowly Change cartridge
Cartridge does not match 0x06 Red light flashes slowly Contact supplier
Print head self-check error: SysStatus.head_ErrSta!= 0

Others: Check SysStatus. HP_VER_STATUS

SysStatus.HP_VER_STATUS == 30：Cartridge does not match ( is 06)

SysStatus.HP_VER_STATUS ==其它不为零时，喷头验证失败 Others is not 0, cartridge verify fails（ is

02)

6. CRC8 Verify original code

0x31(多项式：x8+x5+x4+1，100110001)） From high level to low level

15 / 18
 Shanghai Loogal Information Tech Co., Ltd
www.loogal.com

6.1 C code

static const unsigned char crc_table[] =

{ 0x00,0x31,0x62,0x53,0xc4,0xf5,0xa6,0x97,0xb9,0x88,0xdb,0xea,0x7d,0x4c,0x1f,0x2e,
0x43,0x72,0x21,0x10,0x87,0xb6,0xe5,0xd4,0xfa,0xcb,0x98,0xa9,0x3e,0x0f,0x5c,0x6d,
0x86,0xb7,0xe4,0xd5,0x42,0x73,0x20,0x11,0x3f,0x0e,0x5d,0x6c,0xfb,0xca,0x99,0xa8,
0xc5,0xf4,0xa7,0x96,0x01,0x30,0x63,0x52,0x7c,0x4d,0x1e,0x2f,0xb8,0x89,0xda,0xeb,
0x3d,0x0c,0x5f,0x6e,0xf9,0xc8,0x9b,0xaa,0x84,0xb5,0xe6,0xd7,0x40,0x71,0x22,0x13,
0x7e,0x4f,0x1c,0x2d,0xba,0x8b,0xd8,0xe9,0xc7,0xf6,0xa5,0x94,0x03,0x32,0x61,0x50,
0xbb,0x8a,0xd9,0xe8,0x7f,0x4e,0x1d,0x2c,0x02,0x33,0x60,0x51,0xc6,0xf7,0xa4,0x95,
0xf8,0xc9,0x9a,0xab,0x3c,0x0d,0x5e,0x6f,0x41,0x70,0x23,0x12,0x85,0xb4,0xe7,0xd6,
0x7a,0x4b,0x18,0x29,0xbe,0x8f,0xdc,0xed,0xc3,0xf2,0xa1,0x90,0x07,0x36,0x65,0x54,
0x39,0x08,0x5b,0x6a,0xfd,0xcc,0x9f,0xae,0x80,0xb1,0xe2,0xd3,0x44,0x75,0x26,0x17,
0xfc,0xcd,0x9e,0xaf,0x38,0x09,0x5a,0x6b,0x45,0x74,0x27,0x16,0x81,0xb0,0xe3,0xd2,
0xbf,0x8e,0xdd,0xec,0x7b,0x4a,0x19,0x28,0x06,0x37,0x64,0x55,0xc2,0xf3,0xa0,0x91,
0x47,0x76,0x25,0x14,0x83,0xb2,0xe1,0xd0,0xfe,0xcf,0x9c,0xad,0x3a,0x0b,0x58,0x69,
0x04,0x35,0x66,0x57,0xc0,0xf1,0xa2,0x93,0xbd,0x8c,0xdf,0xee,0x79,0x48,0x1b,0x2a,
0xc1,0xf0,0xa3,0x92,0x05,0x34,0x67,0x56,0x78,0x49,0x1a,0x2b,0xbc,0x8d,0xde,0xef,
0x82,0xb3,0xe0,0xd1,0x46,0x77,0x24,0x15,0x3b,0x0a,0x59,0x68,0xff,0xce,0x9d,0xac
}；

unsigned char cal_crc_table(unsigned char *ptr, unsigned char len)

{ unsigned char crc = 0x00;
while (len--)
{ crc = crc_table[crc ^ *ptr++];
}
return (crc);
}

6.2 C# code
public class CRC8
{
/// <summary>
/// CRC8 位校验表
/// </summary>
private byte[] CRC8Table = new byte[] {

0x00,0x31,0x62,0x53,0xc4,0xf5,0xa6,0x97,0xb9,0x88,0xdb,0xea,0x7d,0x4c,0x1f,0x
2e,
0x43,0x72,0x21,0x10,0x87,0xb6,0xe5,0xd4,0xfa,0xcb,0x98,0xa9,0x3e,0x0f,0x5c,
0x6d,

16 / 18
 Shanghai Loogal Information Tech Co., Ltd
www.loogal.com
0x86,0xb7,0xe4,0xd5,0x42,0x73,0x20,0x11,0x3f,0x0e,0x5d,0x6c,0xfb,0xca,0x99,
0xa8,
0xc5,0xf4,0xa7,0x96,0x01,0x30,0x63,0x52,0x7c,0x4d,0x1e,0x2f,0xb8,0x89,0xda,
0xeb,
0x3d,0x0c,0x5f,0x6e,0xf9,0xc8,0x9b,0xaa,0x84,0xb5,0xe6,0xd7,0x40,0x71,0x22,
0x13,
0x7e,0x4f,0x1c,0x2d,0xba,0x8b,0xd8,0xe9,0xc7,0xf6,0xa5,0x94,0x03,0x32,0x61,
0x50,
0xbb,0x8a,0xd9,0xe8,0x7f,0x4e,0x1d,0x2c,0x02,0x33,0x60,0x51,0xc6,0xf7,0xa4,
0x95,
0xf8,0xc9,0x9a,0xab,0x3c,0x0d,0x5e,0x6f,0x41,0x70,0x23,0x12,0x85,0xb4,0xe7,
0xd6,
0x7a,0x4b,0x18,0x29,0xbe,0x8f,0xdc,0xed,0xc3,0xf2,0xa1,0x90,0x07,0x36,0x65,
0x54,
0x39,0x08,0x5b,0x6a,0xfd,0xcc,0x9f,0xae,0x80,0xb1,0xe2,0xd3,0x44,0x75,0x26,
0x17,
0xfc,0xcd,0x9e,0xaf,0x38,0x09,0x5a,0x6b,0x45,0x74,0x27,0x16,0x81,0xb0,0xe3,
0xd2,
0xbf,0x8e,0xdd,0xec,0x7b,0x4a,0x19,0x28,0x06,0x37,0x64,0x55,0xc2,0xf3,0xa0,
0x91,
0x47,0x76,0x25,0x14,0x83,0xb2,0xe1,0xd0,0xfe,0xcf,0x9c,0xad,0x3a,0x0b,0x58,
0x69,
0x04,0x35,0x66,0x57,0xc0,0xf1,0xa2,0x93,0xbd,0x8c,0xdf,0xee,0x79,0x48,0x1b,
0x2a,
0xc1,0xf0,0xa3,0x92,0x05,0x34,0x67,0x56,0x78,0x49,0x1a,0x2b,0xbc,0x8d,0xde
,0xef,
0x82,0xb3,0xe0,0xd1,0x46,0x77,0x24,0x15,0x3b,0x0a,0x59,0x68,0xff,0xce,0x9d,
0xac
};

public byte CRC(byte[] buffer)

{
return CRC(buffer, buffer.Length);
}

public byte CRC(byte[] buffer, int len)

{
byte crc = 0;
if (buffer == null)
{
throw new ArgumentNullException("buffer");
}

for (int i = 0; i < len; i++)

{
crc = CRC8Table[crc ^ buffer[i]];
17 / 18
 Shanghai Loogal Information Tech Co., Ltd
www.loogal.com
}
return crc;
}
}

7. Explanations of the error that ES/EP will happen in print process

If the error listed in the form is detected in printer print process, print error will happen,
and error information dialog box will appear in the software at this time and quit printing. If
printer is in external equipment real time control mode, please obtain the error information by
regular checking status ( error status field in the status data ( two bytes, lower byte is in front),
0 means no error) It can cancel the error dialog box and restart the print process by sending
stop print command

For example: Printing started, real time data needed has not been sent, but sensor is
triggered. In this case, print error will happen, quit printing and error information dialog will
appear, indicating “ print overspeed 3”. In real time control mode, by checking status, it will
get the error status “8003”. Meanwhile, user can send stop print command to cancel error
dialog. User has to send the real time data needed before triggering the sensor to avoid the
printer error.

18 / 18