Reformatted and added more sections

This commit is contained in:
Davis Goglin 2014-03-14 10:01:15 -07:00
parent fa8d961e6d
commit 4795664cbe
1 changed files with 49 additions and 18 deletions

View File

@ -3,16 +3,7 @@ ESCPOS
Python library to manipulate ESC/POS Printers.
1. 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)
2. Description
Description
------------------------------------------------------------------
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
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
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.
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
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.
@ -80,11 +109,13 @@ The following example shows how to initialize a printer over USB.
p.qr('this is a piece of code')
p.cut()
5. Links
Links
------------------------------------------------------------------
Please visit project homepage at:
Project homepage originally at:
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/