Reliance Status

This command provides a wealth of information about the printers current status. The command will always receive a response unless the printer is offline (powered down, disconnected, etc.) or paper is actively being fed through the printer. A numeric argument is provided which controls the meaning of each bit in the returned byte(s). There is some duplication between fields for legacy support reasons but you effectively have access to all error and status conditions.

Tip

See realtime status examples on Github: Thermal Talk API


Real Time Status - $10 $04 rel

Transmits the printer status in real time.

Format:

Hex       $10  $04 n

ASCII     DLE  EOT n

Decimal   16   04   n

Notes:
  • This command is processed in real time. The reply to this command is sent whenever it is received and does not wait for previous ESC/POS commands to be executed first.

Range:

n = 1 , 2, 3, 4, n = 17, n = 20

n

Status

1

Transmit the printer status

2

Transmit the off-line printer status

3

Transmit error status

4

Transmit paper roll sensor status

17

Transmit the print status

20

Transmit Full Status (6 Byte Reply)

n=1 ($01) Printer Status:

BIT

OFF/ON

HEX

DECIMAL

DESCRIPTION

0

-

-

-

Reserved

1

-

-

-

Reserved

2

-

-

-

Reserved

3

Off

00

0

Online

On

08

8

Offline

4

-

-

-

Reserved

5

-

-

-

Reserved

6

-

-

-

Reserved

7

-

-

-

Reserved

n=2 ($02) Offline Status:

BIT

OFF/ON

HEX

DECIMAL

DESCRIPTION

0

-

-

-

Reserved

1

-

-

-

Reserved

2

Off

00

0

Cover is closed

On

04

4

Cover is open

3

Off

00

0

Paper is not fed with DIAG button

On

08

8

Paper is fed with DIAG button

4

-

-

-

Reserved

5

Off

00

0

Paper is present

On

20

32

Printing stopped due to paper end

6

Off

00

0

No error

On

40

64

Error

7

-

-

-

Reserved

Note

DIAG Button: This bit is always set because our diagnostic button is always enabled.

Note

Error: This bit means that any error has been reported. Query the other status commands to determine the precise error.

n=3 ($03) Error Status:

BIT

OFF/ON

HEX

DECIMAL

DESCRIPTION

0

-

-

-

Reserved

1

-

-

-

Reserved

2

-

-

-

Reserved

3

Off

00

0

Cutter Okay

On

08

8

Cutter Error

4

-

-

-

Reserved

5

Off

00

0

No unrecoverable error

On

20

32

Unrecoverable error

6

Off

00

0

No auto-recoverable error

On

40

64

Auto-recoverable error

7

-

-

-

Reserved

n=4 ($04)Roll Sensor:

BIT

OFF/ON

HEX

DECIMAL

DESCRIPTION

0

-

-

-

Reserved

1

-

-

-

Reserved

2,3

Off

00

0

Paper present in abundance

On

0C

12

Paper low

4

-

-

-

Reserved

5,6

Off

00

0

Paper present

On

60

96

Paper not present

7

-

-

-

Reserved

n=17 ($11) Print Status:

BIT

OFF/ON

HEX

DECIMAL

DESCRIPTION

0

-

-

-

Reserved

1

-

-

-

Reserved

2

Off

00

0

Paper motor off

On

04

4

Paper motor on

3

-

-

-

Reserved

4

-

-

-

Reserved

5

Off

00

0

Paper present

On

20

32

Printing stopped due to paper end

6

-

-

-

Reserved

7

-

-

-

Reserved

n=20 ($14) Full Status:

1st Byte = $10 (DLE)

2nd Byte = $0F

3rd Byte

BIT

OFF/ON

HEX

DECIMAL

DESCRIPTION

0

Off

00

0

Paper Present

On

01

1

Paper Not Present

1

-

-

-

Reserved

2

Off

00

0

Paper present in abundance

On

04

4

Near paper end

3

-

-

-

Reserved

4

-

-

-

Reserved

5

Off

00

0

Ticket not present at output

On

20

32

Ticket present at output

6

-

-

-

Reserved

7

-

-

-

Reserved

4th Byte

BIT

OFF/ON

HEX

DECIMAL

DESCRIPTION

0

Off

00

0

Cover is closed

On

01

1

Cover is open

1

Off

00

0

Cover is closed

On

02

2

Cover is open

2

-

-

-

Reserved

3

Off

00

0

Paper motor off

On

08

8

Paper motor on

4

-

-

-

Reserved

5

Off

00

0

DIAG button released

On

20

32

DIAG button pressed

6

-

-

-

Reserved

7

-

-

-

Reserved

5th Byte

BIT

OFF/ON

HEX

DECIMAL

DESCRIPTION

0

Off

00

0

Head temperature ok

On

01

1

Head temperature ok

1

Off

00

0

No Communication Error

On

02

2

RS232 Error

2

-

-

-

Reserved

3

Off

00

0

Power supply voltage ok

On

08

8

Power supply voltage error

4

-

-

-

Reserved

5

-

-

-

Reserved

6

Off

00

0

Free paper path

On

40

64

Paper jam

7

-

-

-

Reserved

6th Byte

BIT

OFF/ON

HEX

DECIMAL

DESCRIPTION

0

Off

00

0

Cutter ok

On

01

1

Cutter error

1

-

-

-

Reserved

2

-

-

-

Reserved

3

-

-

-

Reserved

4

-

-

-

Reserved

5

-

-

-

Reserved

6

-

-

-

Reserved

7

-

-

-

Reserved

Default:

None

Related:

None

Example of No Paper:
write("\x10\x04\x04")   # Paper Roll Status
>>> 0b01101100          # $6C or 108, this means that there is no paper
Example of Low Paper:
write("\x10\x04\x04")   # Paper Roll Status
>>> 0b00001100          # $0C or 12, this means that the paper level is low

Get Ticket Status - $1D $7A rel

Transmits a single-byte ticket and printer status using the Epic950 TITO convention.

Format:

Hex       $1D  $7A

ASCII     GS   z

Decimal   29   122

Response:

Single status byte.

Notes:
  • This status byte follows the Epic950 convention for TITO status.

  • Bit 3 is always set to 1.

BIT

VALUE = 0

VALUE = 1

NOTES

0

Ticket not low

Ticket low

Paper-low sensor

1

Ticket not in printer

Ticket in printer

Paper in printer sensor

2

RESERVED (Always 0)

N/A

Top-of-form (unsupported)

3

N/A

Always 1

Fixed, Epic 950 convention

4

RESERVED (Always 0)

N/A

Barcode-complete (unsupported)

5

QR NOT printed

QR printed

Validation complete

6

Ticket not in path

Ticket in path

Printed ticket still in exit

7

No paper jam

Paper jam

Jam sensor / stall detection

Default:

None

Related:

None

Clear Validation Complete Flag - $1B $41 rel

Clears the QR printed (validation complete) flag used by Get Ticket Status bit 5.

Format:

Hex       $1B  $41

ASCII     ESC  A

Decimal   27   65

Response:

None.

Notes:
  • This command manually clears the validation-complete state.

  • After this command is processed, bit 5 of $1D $7A returns 0 until the next validation/QR complete event sets it again.

Default:

None

Related:

Get Ticket Status - $1D $7A