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

Merge pull request #191 from python-escpos/update-raspi-doc 

update doc-page on Raspi
This commit is contained in:
Patrick Kanzler 2016-12-07 21:01:27 +01:00 committed by GitHub
parent 211e7db22c bd57c01794
commit 78604573f3
1 changed files with 41 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

59
doc/user/raspi.rst
View File

@ -2,16 +2,28 @@
Raspberry Pi
************
This instructions were tested on Raspbian.
:Last Reviewed: 2016-12-07
Unless you have done any distro with libusb-1.0 on the Raspberry Pi, the
following instructions should works fine on your raspberry distro.
This instructions were tested on Raspbian.
.. warning:: You should **never** directly connect an printer with RS232-interface (serial port) directly to
a Raspberry PI or similar interface (e.g. those simple USB-sticks without encasing). Those interfaces are
based on 5V- or 3,3V-logic (the latter in the case of Raspberry PI). Classical RS232 uses 12V-logic and would
**thus destroy your interface**. Connect both systems with an appropriate *level shifter*.
Normal installation
-------------------
Normally you should be able to install the library just like on any other
Linux distribution. Please be reminded that the newer versions are not in Debian
and thus not in Raspbian.
However, you can just install with `pip`. For more details on this
check the :doc:`installation-manual <installation>`.
If this works for you, you don't need to continue reading this part.
If not, please check if the rest might help you.
Should you have any problems, do not hesitate to contact the maintainer, since you
might have found a bug in the code or documentation.
Dependencies
------------
@ -19,13 +31,15 @@ First, install the packages available on Raspbian.
::
# apt-get install python-imaging python-serial python-setuptools
apt-get install python-imaging python-serial python-setuptools
PyUSB
^^^^^
.. todo:: The freshness of this part is not verified. Please take it with a grain of salt or help updating it.
PyUSB 1.0 is not available on Ubuntu, so you have to download and
install it manually
install it manually.
1. Download the latest tarball from
`Sourceforge <http://sourceforge.net/projects/pyusb/files/>`__
@ -35,23 +49,32 @@ install it manually
::
# wget ...
# unzip pyusb*.zip
# cd pyusb*
# python setup.py build
# sudo python setup.py install
unzip pyusb*.zip
cd pyusb*
python setup.py build
sudo python setup.py install
python-qrcode
^^^^^^^^^^^^^
You can install qrcode just from pip with
::
sudo pip install qrcode
Otherwise you can install it manually. If in doubt please check the documentation of the
`python-qrcode`-project.
1. Checkout the code from github
2. Install the library
::
# git clone https://github.com/lincolnloop/python-qrcode
# cd python-qrcode
# python setup.py build
# sudo python setup.py install
git clone https://github.com/lincolnloop/python-qrcode
cd python-qrcode
python setup.py build
sudo python setup.py install
Installation
------------
@ -64,10 +87,10 @@ If you have installed pyusb for libusb-1.0 then you need to:
::
# git clone --recursive https://github.com/manpaz/python-escpos.git
# cd python-escpos
# python setup.py build
# sudo python setup.py install
git clone --recursive https://github.com/python-escpos/python-escpos.git
cd python-escpos
python setup.py build
sudo python setup.py install
Now you can attach your printer and and test it with the example code in
the project's `home <https://github.com/manpaz/python-escpos>`__
the project's set of examples. You can find that in the `project-repository <https://github.com/python-escpos/python-escpos>`__.