From bfabd484b9af3438b45c3874558518494c017153 Mon Sep 17 00:00:00 2001 From: Patrick Kanzler Date: Thu, 10 Aug 2023 01:11:09 +0200 Subject: [PATCH] revise user/printers --- doc/user/printers.rst | 40 ++++++++++++++++++++++++++++------------ 1 file changed, 28 insertions(+), 12 deletions(-) diff --git a/doc/user/printers.rst b/doc/user/printers.rst index 051ef3b..36ef3a8 100644 --- a/doc/user/printers.rst +++ b/doc/user/printers.rst @@ -1,15 +1,18 @@ 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 --- 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 -and similiar devices, but only for those implementing native USB. +printers. + +.. 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 :members: @@ -44,20 +47,24 @@ This driver is based on the socket class. Troubleshooting ^^^^^^^^^^^^^^^ -Problems with a network-attached printer can have numerous causes. Make sure that your device has a proper IP address. -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: +Problems with a network-attached printer can have numerous causes. +Make sure that your device has a proper IP address. +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 # 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 ---- -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 :members: @@ -67,8 +74,8 @@ This printer "prints" just into a file-handle. Especially on \*nix-systems this Dummy ----- -The Dummy-printer is mainly for testing- and debugging-purposes. It stores -all of the "output" as raw ESC/POS in a string and returns that. +The Dummy-printer is mainly for testing- and debugging-purposes. +It stores all of the "output" as raw ESC/POS in a string and returns that. .. autoclass:: escpos.printer.Dummy :members: @@ -94,10 +101,19 @@ Supports local and remote CUPS printers. The printer must be properly configured in CUPS administration. 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 :members: :special-members: :member-order: bysource :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