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

revise user/printers

Browse Source
This commit is contained in:
Patrick Kanzler 2023-08-10 01:11:09 +02:00
parent aacc392c9a
commit bfabd484b9
1 changed files with 28 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

40
doc/user/printers.rst
View File

@ -1,15 +1,18 @@
Printers Printers
======== ========
:Last Reviewed: 2022-11-25 :Last Reviewed: 2023-08-10
As of now there are 7 different type of printer implementations. As of now there are 8 different types of printer implementations.
USB USB
--- ---
The USB-class uses pyusb and libusb to communicate with USB-based The USB-class uses pyusb and libusb to communicate with USB-based
printers. Note that this driver is not suited for USB-to-Serial-adapters printers.
and similiar devices, but only for those implementing native USB.
.. note::
This driver is not suited for USB-to-Serial-adapters
and similiar devices, but only for those implementing native USB.
.. autoclass:: escpos.printer.Usb .. autoclass:: escpos.printer.Usb
:members: :members:
@ -44,20 +47,24 @@ This driver is based on the socket class.
Troubleshooting Troubleshooting
^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^
Problems with a network-attached printer can have numerous causes. Make sure that your device has a proper IP address. Problems with a network-attached printer can have numerous causes.
Often you can check the IP address by triggering the self-test of the device. As a next step try to send text Make sure that your device has a proper IP address.
manually to the device. You could use for example: Often you can check the IP address by triggering the self-test of the device.
As a next step try to send text manually to the device.
You could use for example:
:: ::
echo "OK\n" | nc IPADDRESS 9100 echo "OK\n" | nc IPADDRESS 9100
# the port number is often 9100 # the port number is often 9100
As a last resort try to reset the interface of the printer. This should be described in its manual. As a last resort try to reset the interface of the printer.
This should be described in its manual.
File File
---- ----
This printer "prints" just into a file-handle. Especially on \*nix-systems this comes very handy. This printer "prints" just into a file-handle.
Especially on \*nix-systems this comes very handy.
.. autoclass:: escpos.printer.File .. autoclass:: escpos.printer.File
:members: :members:
@ -67,8 +74,8 @@ This printer "prints" just into a file-handle. Especially on \*nix-systems this
Dummy Dummy
----- -----
The Dummy-printer is mainly for testing- and debugging-purposes. It stores The Dummy-printer is mainly for testing- and debugging-purposes.
all of the "output" as raw ESC/POS in a string and returns that. It stores all of the "output" as raw ESC/POS in a string and returns that.
.. autoclass:: escpos.printer.Dummy .. autoclass:: escpos.printer.Dummy
:members: :members:
@ -94,10 +101,19 @@ Supports local and remote CUPS printers.
The printer must be properly configured in CUPS administration. The printer must be properly configured in CUPS administration.
The connector spawns a new sub-process where the command lp is executed. The connector spawns a new sub-process where the command lp is executed.
No dependencies required, but somehow the print queue will affect some print job such as barcode. No dependencies required, but somehow the print queue will affect some
print job such as barcode.
.. autoclass:: escpos.printer.LP .. autoclass:: escpos.printer.LP
:members: :members:
:special-members: :special-members:
:member-order: bysource :member-order: bysource
:noindex: :noindex:
Win32Raw
--------
This driver uses a native WIN32 interface of Windows in order to print.
Please refer to the code for documentation as this driver is currently
not included in the documentation build.
.. todo:: Include Win32Raw in documentation build