Reformatted and added more sections
This commit is contained in:
parent
fa8d961e6d
commit
4795664cbe
65
README.md
65
README.md
|
@ -3,16 +3,7 @@ ESCPOS
|
||||||
|
|
||||||
Python library to manipulate ESC/POS Printers.
|
Python library to manipulate ESC/POS Printers.
|
||||||
|
|
||||||
1. Dependencies
|
Description
|
||||||
------------------------------------------------------------------
|
|
||||||
|
|
||||||
In order to start getting access to your printer, you must ensure
|
|
||||||
you have previously installed the following python modules:
|
|
||||||
|
|
||||||
* pyusb (python-usb)
|
|
||||||
* PIL (Python Image Library) or Pillow (recommended)
|
|
||||||
|
|
||||||
2. Description
|
|
||||||
------------------------------------------------------------------
|
------------------------------------------------------------------
|
||||||
|
|
||||||
Python ESC/POS is a library which lets the user have access to all
|
Python ESC/POS is a library which lets the user have access to all
|
||||||
|
@ -32,11 +23,50 @@ Also, this module handles some hardware functionalities like, cut
|
||||||
paper, carrier return, printer reset and others concerned to the
|
paper, carrier return, printer reset and others concerned to the
|
||||||
carriage alignment.
|
carriage alignment.
|
||||||
|
|
||||||
3. Define your printer
|
|
||||||
|
Dependencies
|
||||||
------------------------------------------------------------------
|
------------------------------------------------------------------
|
||||||
|
|
||||||
|
In order to start getting access to your printer, you must ensure
|
||||||
|
you have previously installed the following python modules:
|
||||||
|
|
||||||
|
* pyusb (python-usb)
|
||||||
|
* PIL (Python Image Library) or Pillow (recommended)
|
||||||
|
|
||||||
|
|
||||||
|
Feature List
|
||||||
|
------------------------------------------------------------------
|
||||||
|
|
||||||
|
* Support for the following interfaces
|
||||||
|
* USB
|
||||||
|
* Serial
|
||||||
|
* Network
|
||||||
|
* File
|
||||||
|
|
||||||
|
* Commands include
|
||||||
|
* Text and image positioning
|
||||||
|
* Text formatting
|
||||||
|
* Opening cash drawers
|
||||||
|
* Full/Partial cuts
|
||||||
|
* Barcodes and QR Codes
|
||||||
|
* Images and image scaling
|
||||||
|
* Chinese character support
|
||||||
|
|
||||||
|
TODO
|
||||||
|
------------------------------------------------------------------
|
||||||
|
|
||||||
|
* Testing
|
||||||
|
* Possibly a virtual printer in the far future
|
||||||
|
* Provide install instructions
|
||||||
|
* Provide API documentation
|
||||||
|
|
||||||
|
USB Quickstart
|
||||||
|
------------------------------------------------------------------
|
||||||
|
|
||||||
|
### Find your printer ###
|
||||||
|
|
||||||
Before start create your Python ESC/POS printer instance, you must
|
Before start create your Python ESC/POS printer instance, you must
|
||||||
see at your system for the printer parameters. This is done with
|
see at your system for the printer parameters. On Linux this is done with
|
||||||
the 'lsusb' command.
|
the 'lsusb' command.
|
||||||
|
|
||||||
First run the command to look for the "Vendor ID" and "Product ID",
|
First run the command to look for the "Vendor ID" and "Product ID",
|
||||||
|
@ -62,8 +92,7 @@ By default the "Interface" number is "0" and the "Output Endpoint"
|
||||||
address is "0x82", if you have other values then you can define
|
address is "0x82", if you have other values then you can define
|
||||||
with your instance.
|
with your instance.
|
||||||
|
|
||||||
4. Define your instance
|
### Define a printer instance and send commands ###
|
||||||
------------------------------------------------------------------
|
|
||||||
|
|
||||||
The following example shows how to initialize a printer over USB.
|
The following example shows how to initialize a printer over USB.
|
||||||
|
|
||||||
|
@ -80,11 +109,13 @@ The following example shows how to initialize a printer over USB.
|
||||||
p.qr('this is a piece of code')
|
p.qr('this is a piece of code')
|
||||||
p.cut()
|
p.cut()
|
||||||
|
|
||||||
5. Links
|
Links
|
||||||
------------------------------------------------------------------
|
------------------------------------------------------------------
|
||||||
|
|
||||||
Please visit project homepage at:
|
Project homepage originally at:
|
||||||
|
|
||||||
http://repo.bashlinux.com/projects/escpos.html
|
http://repo.bashlinux.com/projects/escpos.html
|
||||||
|
|
||||||
Manuel F Martinez <manpaz@bashlinux.com>
|
By Manuel F Martinez <manpaz@bashlinux.com>
|
||||||
|
|
||||||
|
Forked from https://code.google.com/p/python-escpos/
|
||||||
|
|
Loading…
Reference in New Issue