setop
/
python-escpos
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

fix is_online() (#282) 

* fix is_online

* fix sphinx formatting

* reword
This commit is contained in:
Thijs Triemstra 2018-05-02 09:25:04 +02:00 committed by Patrick Kanzler
parent 6e09fd1e97
commit 4390dc4a9c
1 changed files with 22 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
src/escpos/escpos.py
View File

@ -828,30 +828,41 @@ class Escpos(object):
self._raw(PANEL_BUTTON_OFF) self._raw(PANEL_BUTTON_OFF)
def query_status(self, mode): def query_status(self, mode):
""" Queries the printer for its status, and returns an array of integers containing it. """
Queries the printer for its status, and returns an array of integers containing it.
:param mode: Integer that sets the status mode queried to the printer. :param mode: Integer that sets the status mode queried to the printer.
RT_STATUS_ONLINE: Printer status. - RT_STATUS_ONLINE: Printer status.
RT_STATUS_PAPER: Paper sensor. - RT_STATUS_PAPER: Paper sensor.
:rtype: array(integer)""" :rtype: array(integer)
"""
self._raw(mode) self._raw(mode)
time.sleep(1) time.sleep(1)
status = self._read() status = self._read()
return status return status
def is_online(self): def is_online(self):
""" Queries the printer its online status. """
When online, returns True; False otherwise. Queries the online status of the printer.
:rtype: bool: True if online, False if offline."""
:returns: When online, returns ``True``; ``False`` otherwise.
:rtype: bool
"""
status = self.query_status(RT_STATUS_ONLINE) status = self.query_status(RT_STATUS_ONLINE)
if len(status) == 0: if len(status) == 0:
return False return False
return not (status & RT_MASK_ONLINE) return not (status[0] & RT_MASK_ONLINE)
def paper_status(self): def paper_status(self):
""" Queries the printer its paper status. """
Queries the paper status of the printer.
Returns 2 if there is plenty of paper, 1 if the paper has arrived to Returns 2 if there is plenty of paper, 1 if the paper has arrived to
the near-end sensor and 0 if there is no paper. the near-end sensor and 0 if there is no paper.
:rtype: int: 2: Paper is adequate. 1: Paper ending. 0: No paper."""
:returns: 2: Paper is adequate. 1: Paper ending. 0: No paper.
:rtype: int
"""
status = self.query_status(RT_STATUS_PAPER) status = self.query_status(RT_STATUS_PAPER)
if len(status) == 0: if len(status) == 0:
return 2 return 2
@ -867,7 +878,7 @@ class EscposIO(object):
"""ESC/POS Printer IO object """ESC/POS Printer IO object
Allows the class to be used together with the `with`-statement. You have to define a printer instance Allows the class to be used together with the `with`-statement. You have to define a printer instance
and assign it to the EsposIO-class. and assign it to the EscposIO class.
This example explains the usage: This example explains the usage:
.. code-block:: Python .. code-block:: Python