2011-08-16 01:15:14 +00:00
|
|
|
Printrun consists of printcore, pronsole and pronterface, and a small collection of helpful scripts.
|
|
|
|
|
|
|
|
* printcore.py is a library that makes writing reprap hosts easy
|
|
|
|
* pronsole.py is an interactive command-line host software with tabcompletion goodness
|
|
|
|
* pronterface.py is a graphical host software with the same functionality as pronsole
|
2012-06-05 15:14:50 +00:00
|
|
|
* webinterface.py is a browser-usable remote control function for Pronterface
|
2011-08-16 01:15:14 +00:00
|
|
|
|
|
|
|
# INSTALLING DEPENDENCIES
|
|
|
|
|
|
|
|
## Windows
|
2012-01-18 16:56:01 +00:00
|
|
|
|
|
|
|
A precompiled version is available at http://koti.kapsi.fi/~kliment/printrun/
|
|
|
|
|
2011-08-16 01:15:14 +00:00
|
|
|
Download the following, and install in this order:
|
2011-08-16 01:33:58 +00:00
|
|
|
|
2011-08-16 01:15:14 +00:00
|
|
|
1. http://python.org/ftp/python/2.7.2/python-2.7.2.msi
|
|
|
|
2. http://pypi.python.org/packages/any/p/pyserial/pyserial-2.5.win32.exe
|
|
|
|
3. http://downloads.sourceforge.net/wxpython/wxPython2.8-win32-unicode-2.8.12.0-py27.exe
|
2011-11-14 11:10:19 +00:00
|
|
|
4. http://launchpad.net/pyreadline/1.7/1.7/+download/pyreadline-1.7.win32.exe
|
2012-01-18 16:56:01 +00:00
|
|
|
5. http://pyglet.googlecode.com/files/pyglet-1.1.4.zip
|
|
|
|
|
|
|
|
For the last one, you will need to unpack it, open a command terminal,
|
|
|
|
go into the the directory you unpacked it in and run
|
|
|
|
`python setup.py install`
|
2011-11-14 11:10:19 +00:00
|
|
|
|
2011-08-16 01:15:14 +00:00
|
|
|
## Ubuntu/Debian
|
2012-01-18 16:56:01 +00:00
|
|
|
`sudo apt-get install python-serial python-wxgtk2.8 python-pyglet`
|
2011-08-16 01:15:14 +00:00
|
|
|
|
|
|
|
## Fedora 15
|
2012-01-18 16:56:01 +00:00
|
|
|
`sudo yum install pyserial wxpython pyglet`
|
2011-08-16 01:15:14 +00:00
|
|
|
|
|
|
|
## Mac OS X Lion
|
|
|
|
|
2012-01-18 16:56:01 +00:00
|
|
|
A precompiled version is available at http://koti.kapsi.fi/~kliment/printrun/
|
|
|
|
|
2011-08-16 01:33:58 +00:00
|
|
|
1. Ensure that the active Python is the system version. (`brew uninstall python` or other appropriate incantations)
|
2011-12-07 11:36:16 +00:00
|
|
|
2. Download an install [wxPython2.8-osx-unicode] matching to your python version (most likely 2.7 on Lion,
|
|
|
|
check with: python --version) from: http://wxpython.org/download.php#stable
|
2011-12-12 19:52:23 +00:00
|
|
|
Known to work PythonWX: http://superb-sea2.dl.sourceforge.net/project/wxpython/wxPython/2.8.12.1/wxPython2.8-osx-unicode-2.8.12.1-universal-py2.7.dmg
|
2011-08-16 01:15:14 +00:00
|
|
|
3. Download and unpack pyserial from http://pypi.python.org/packages/source/p/pyserial/pyserial-2.5.tar.gz
|
2011-08-16 01:33:58 +00:00
|
|
|
4. In a terminal, change to the folder you unzipped to, then type in: `sudo python setup.py install`
|
2012-01-18 16:56:01 +00:00
|
|
|
5. Repeat 4. with http://http://pyglet.googlecode.com/files/pyglet-1.1.4.zip
|
2011-08-16 01:15:14 +00:00
|
|
|
|
2011-10-10 18:38:20 +00:00
|
|
|
The tools will probably run just fine in 64bit on Lion, you don't need to mess
|
|
|
|
with any of the 32bit settings. In case they don't, try
|
|
|
|
5. export VERSIONER_PYTHON_PREFER_32_BIT=yes
|
|
|
|
in a terminal before running Pronterface
|
2011-08-16 01:15:14 +00:00
|
|
|
|
|
|
|
## Mac OS X (pre Lion)
|
2012-01-18 16:56:01 +00:00
|
|
|
|
|
|
|
A precompiled version is available at http://koti.kapsi.fi/~kliment/printrun/
|
|
|
|
|
2011-08-16 01:26:47 +00:00
|
|
|
1. Download and install http://downloads.sourceforge.net/wxpython/wxPython2.8-osx-unicode-2.8.12.0-universal-py2.6.dmg
|
|
|
|
2. Grab the source for pyserial from http://pypi.python.org/packages/source/p/pyserial/pyserial-2.5.tar.gz
|
|
|
|
3. Unzip pyserial to a folder. Then, in a terminal, change to the folder you unzipped to, then type in:
|
2011-08-16 01:33:58 +00:00
|
|
|
|
2011-08-16 01:26:47 +00:00
|
|
|
`defaults write com.apple.versioner.python Prefer-32-Bit -bool yes`
|
2011-08-16 01:33:58 +00:00
|
|
|
|
2011-08-16 01:26:47 +00:00
|
|
|
`sudo python setup.py install`
|
2011-08-16 01:15:14 +00:00
|
|
|
|
|
|
|
Alternatively, you can run python in 32 bit mode by setting the following environment variable before running the setup.py command:
|
2011-08-16 01:33:58 +00:00
|
|
|
|
2011-10-31 23:10:21 +00:00
|
|
|
This alternative approach is confirmed to work on Mac OS X 10.6.8.
|
|
|
|
|
2011-08-16 01:26:47 +00:00
|
|
|
`export VERSIONER_PYTHON_PREFER_32_BIT=yes`
|
2011-08-16 01:15:14 +00:00
|
|
|
|
2011-10-31 23:10:21 +00:00
|
|
|
`sudo python setup.py install`
|
|
|
|
|
2012-01-18 16:56:01 +00:00
|
|
|
Then repeat the same with http://http://pyglet.googlecode.com/files/pyglet-1.1.4.zip
|
2011-08-16 01:15:14 +00:00
|
|
|
|
|
|
|
# USING PRONTERFACE
|
|
|
|
|
|
|
|
To use pronterface, you need:
|
2011-08-16 01:33:58 +00:00
|
|
|
|
2011-08-16 01:26:47 +00:00
|
|
|
* python (ideally 2.6.x or 2.7.x),
|
|
|
|
* pyserial (or python-serial on ubuntu/debian),
|
2012-01-18 16:56:01 +00:00
|
|
|
* pyglet
|
2011-08-16 01:26:47 +00:00
|
|
|
* pyreadline (not needed on Linux) and
|
|
|
|
* wxPython
|
2011-08-16 01:15:14 +00:00
|
|
|
|
|
|
|
Download and install the above, and start pronterface.py
|
|
|
|
Select the port name you are using from the first drop-down, select your baud rate, and hit connect.
|
|
|
|
Load an STL (see the note on skeinforge below) or GCODE file, and you can upload it to SD or print it directly.
|
|
|
|
The "monitor printer" function, when enabled, checks the printer state (temperatures, SD print progress) every 3 seconds.
|
|
|
|
The command box recognizes all pronsole commands, but has no tabcompletion.
|
|
|
|
|
2012-06-05 15:14:50 +00:00
|
|
|
If you want to load stl files, you need to install a slicing program such as Slic3r and add its path to the settings.
|
|
|
|
See the Slic3r readme for more details on integration.
|
|
|
|
|
|
|
|
# Using the browser interface
|
|
|
|
|
|
|
|
To run the web interface, install Cherrypy and run Pronterface as described above.
|
|
|
|
The www server will start on the port/address you have chosen.
|
|
|
|
|
|
|
|
## Webinterface Dependencies
|
|
|
|
|
|
|
|
Cherrypy is required for the web interface. Download and install it by opening a
|
|
|
|
command prompt in its directory and running python setup.py install.
|
|
|
|
|
|
|
|
## Webinterface Configuration
|
|
|
|
* The Web interface port / ip is configurable in http.config
|
|
|
|
* The Default User / Password can be set in auth.config
|
|
|
|
|
|
|
|
## Webinterface Styling
|
|
|
|
* css/style.css can be modified to change the style of the Web Interface.
|
|
|
|
|
|
|
|
|
2011-08-16 01:15:14 +00:00
|
|
|
|
|
|
|
# USING PRONSOLE
|
|
|
|
|
|
|
|
To use pronsole, you need:
|
2011-08-16 01:33:58 +00:00
|
|
|
|
2011-08-16 01:26:47 +00:00
|
|
|
* python (ideally 2.6.x or 2.7.x),
|
|
|
|
* pyserial (or python-serial on ubuntu/debian) and
|
|
|
|
* pyreadline (not needed on Linux)
|
2011-08-16 01:15:14 +00:00
|
|
|
|
|
|
|
Start pronsole and you will be greeted with a command prompt. Type help to view the available commands.
|
|
|
|
All commands have internal help, which you can access by typing "help commandname", for example "help connect"
|
|
|
|
|
|
|
|
If you want to load stl files, you need to put a version of skeinforge (doesn't matter which one) in a folder called "skeinforge".
|
|
|
|
The "skeinforge" folder must be in the same folder as pronsole.py
|
|
|
|
|
|
|
|
# USING PRINTCORE
|
|
|
|
|
|
|
|
To use printcore you need python (ideally 2.6.x or 2.7.x) and pyserial (or python-serial on ubuntu/debian)
|
|
|
|
See pronsole for an example of a full-featured host, the bottom of printcore.py for a simple command-line
|
|
|
|
sender, or the following code example:
|
|
|
|
|
2011-08-16 01:26:47 +00:00
|
|
|
p=printcore('/dev/ttyUSB0',115200)
|
|
|
|
p.startprint(data) # data is an array of gcode lines
|
|
|
|
p.send_now("M105") # sends M105 as soon as possible
|
|
|
|
p.pause()
|
|
|
|
p.resume()
|
|
|
|
p.disconnect()
|
2011-08-16 01:15:14 +00:00
|
|
|
|
2012-01-23 11:17:28 +00:00
|
|
|
# LICENSE
|
2011-05-10 07:59:28 +00:00
|
|
|
|
2012-01-23 11:36:49 +00:00
|
|
|
```
|
|
|
|
Printrun is free software: you can redistribute it and/or modify
|
|
|
|
it under the terms of the GNU General Public License as published by
|
|
|
|
the Free Software Foundation, either version 3 of the License, or
|
|
|
|
(at your option) any later version.
|
|
|
|
|
|
|
|
Printrun is distributed in the hope that it will be useful,
|
|
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
GNU General Public License for more details.
|
|
|
|
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
|
|
along with Printrun. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
```
|