From 190660a88ba2aa50a9a8a5e057cc965b122dd8d1 Mon Sep 17 00:00:00 2001 From: Brendan Erwin Date: Mon, 15 Aug 2011 22:15:14 -0300 Subject: [PATCH 1/5] Updates to markdown and added OS X Lion instructions. --- README | 102 +++++++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 100 insertions(+), 2 deletions(-) diff --git a/README b/README index d8c2e2d..2c2ab6e 100644 --- a/README +++ b/README @@ -5,6 +5,7 @@ Printrun consists of printcore, pronsole and pronterface, and a small collection 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 + INSTALLING DEPENDENCIES On Windows, download the following, and install in this order: @@ -14,12 +15,109 @@ http://downloads.sourceforge.net/wxpython/wxPython2.8-win32-unicode-2.8.12.0-py2 http://launchpad.net/pyreadline/trunk/1.7/+download/pyreadline-1.7.win32.exe On Ubuntu/debian, do: -sudo apt-get install python-serial python-wxgtk2.8 +sudo apt-get install pThis is a python-based host software for reprap printers, in various forms. + +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 + +# INSTALLING DEPENDENCIES + +## Windows +Download the following, and install in this order: + 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 + 4. http://launchpad.net/pyreadline/trunk/1.7/+download/pyreadline-1.7.win32.exe + +## Ubuntu/Debian +`sudo apt-get install python-serial python-wxgtk2.8` + +## Fedora 15 +`sudo yum install pyserial wxpython` + +## Mac OS X Lion + + 1. Ensure that the active Python is the system version. + (`brew uninstall python` or other appropriate incantations) + 2. Download an install wxPython version 2.9-Carbon (its the Cocoa + version doesn't work) + 3. Download and unpack pyserial from http://pypi.python.org/packages/source/p/pyserial/pyserial-2.5.tar.gz + 4. in a terminal, change to the folder you unzipped to, then type in: + `sudo python setup.py install` + +The tools will run just fine in 64bit on Lion, you don't need to mess +with any of the 32bit settings + +## Mac OS X (pre Lion) +Download and install: +http://downloads.sourceforge.net/wxpython/wxPython2.8-osx-unicode-2.8.12.0-universal-py2.6.dmg +Grab the source for pyserial from http://pypi.python.org/packages/source/p/pyserial/pyserial-2.5.tar.gz +Unzip pyserial to a folder. Then, in a terminal, change to the folder you unzipped to, then type in: +defaults write com.apple.versioner.python Prefer-32-Bit -bool yes +sudo python setup.py install + +Alternatively, you can run python in 32 bit mode by setting the following environment variable before running the setup.py command: +export VERSIONER_PYTHON_PREFER_32_BIT=yes + +Then repeat the same with http://launchpad.net/pyreadline/trunk/1.7/+download/pyreadline-1.7.zip + +# USING PRONTERFACE + +To use pronterface, you need: +python (ideally 2.6.x or 2.7.x), +pyserial (or python-serial on ubuntu/debian), +pyreadline (not needed on Linux) and +wxPython + +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. + +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 pronterface.py + +# USING PRONSOLE + +To use pronsole, you need: +python (ideally 2.6.x or 2.7.x), +pyserial (or python-serial on ubuntu/debian) and +pyreadline (not needed on Linux) + +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: + +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() + +ython-serial python-wxgtk2.8 On Fedora 15 do: sudo yum install pyserial wxpython -On Mac OS X, download and install: +On Mac OS X Lion: + + 1. Ensure that the active Python is the system version. (`brew uninstall python` or other appropriate incantations). + + +On Mac OS X (pre Lion), download and install: http://downloads.sourceforge.net/wxpython/wxPython2.8-osx-unicode-2.8.12.0-universal-py2.6.dmg Grab the source for pyserial from http://pypi.python.org/packages/source/p/pyserial/pyserial-2.5.tar.gz Unzip pyserial to a folder. Then, in a terminal, change to the folder you unzipped to, then type in: From ea5074b8e015a018c2b4deeb3dddae3c2ef7f449 Mon Sep 17 00:00:00 2001 From: Brendan Erwin Date: Mon, 15 Aug 2011 21:19:38 -0400 Subject: [PATCH 2/5] renamed the file so github will format it. --- README => README.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename README => README.md (100%) diff --git a/README b/README.md similarity index 100% rename from README rename to README.md From a7a75b55d9f73ee3a757ad59ecb8f88585b760dd Mon Sep 17 00:00:00 2001 From: Brendan Erwin Date: Mon, 15 Aug 2011 21:21:27 -0400 Subject: [PATCH 3/5] stupid paste issue fixed --- README.md | 83 ------------------------------------------------------- 1 file changed, 83 deletions(-) diff --git a/README.md b/README.md index 2c2ab6e..b0e2fe1 100644 --- a/README.md +++ b/README.md @@ -1,22 +1,3 @@ -This is a python-based host software for reprap printers, in various forms. - -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 - -INSTALLING DEPENDENCIES - -On Windows, download the following, and install in this order: -http://python.org/ftp/python/2.7.2/python-2.7.2.msi -http://pypi.python.org/packages/any/p/pyserial/pyserial-2.5.win32.exe -http://downloads.sourceforge.net/wxpython/wxPython2.8-win32-unicode-2.8.12.0-py27.exe -http://launchpad.net/pyreadline/trunk/1.7/+download/pyreadline-1.7.win32.exe - -On Ubuntu/debian, do: -sudo apt-get install pThis is a python-based host software for reprap printers, in various forms. - 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 @@ -107,68 +88,4 @@ p.pause() p.resume() p.disconnect() -ython-serial python-wxgtk2.8 - -On Fedora 15 do: -sudo yum install pyserial wxpython - -On Mac OS X Lion: - - 1. Ensure that the active Python is the system version. (`brew uninstall python` or other appropriate incantations). - - -On Mac OS X (pre Lion), download and install: -http://downloads.sourceforge.net/wxpython/wxPython2.8-osx-unicode-2.8.12.0-universal-py2.6.dmg -Grab the source for pyserial from http://pypi.python.org/packages/source/p/pyserial/pyserial-2.5.tar.gz -Unzip pyserial to a folder. Then, in a terminal, change to the folder you unzipped to, then type in: -defaults write com.apple.versioner.python Prefer-32-Bit -bool yes -sudo python setup.py install - -Alternatively, you can run python in 32 bit mode by setting the following environment variable before running the setup.py command: -export VERSIONER_PYTHON_PREFER_32_BIT=yes - -Then repeat the same with http://launchpad.net/pyreadline/trunk/1.7/+download/pyreadline-1.7.zip - -USING PRONTERFACE - -To use pronterface, you need: -python (ideally 2.6.x or 2.7.x), -pyserial (or python-serial on ubuntu/debian), -pyreadline (not needed on Linux) and -wxPython - -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. - -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 pronterface.py - -USING PRONSOLE - -To use pronsole, you need: -python (ideally 2.6.x or 2.7.x), -pyserial (or python-serial on ubuntu/debian) and -pyreadline (not needed on Linux) - -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: - -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() From 7f8a750eeef1eb6d6f94d49736b163ab2876a542 Mon Sep 17 00:00:00 2001 From: Brendan Erwin Date: Mon, 15 Aug 2011 21:26:47 -0400 Subject: [PATCH 4/5] more markdown updates --- README.md | 39 +++++++++++++++++++-------------------- 1 file changed, 19 insertions(+), 20 deletions(-) diff --git a/README.md b/README.md index b0e2fe1..2827de1 100644 --- a/README.md +++ b/README.md @@ -33,25 +33,24 @@ The tools will run just fine in 64bit on Lion, you don't need to mess with any of the 32bit settings ## Mac OS X (pre Lion) -Download and install: -http://downloads.sourceforge.net/wxpython/wxPython2.8-osx-unicode-2.8.12.0-universal-py2.6.dmg -Grab the source for pyserial from http://pypi.python.org/packages/source/p/pyserial/pyserial-2.5.tar.gz -Unzip pyserial to a folder. Then, in a terminal, change to the folder you unzipped to, then type in: -defaults write com.apple.versioner.python Prefer-32-Bit -bool yes -sudo python setup.py install + 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: + `defaults write com.apple.versioner.python Prefer-32-Bit -bool yes` + `sudo python setup.py install` Alternatively, you can run python in 32 bit mode by setting the following environment variable before running the setup.py command: -export VERSIONER_PYTHON_PREFER_32_BIT=yes +`export VERSIONER_PYTHON_PREFER_32_BIT=yes` Then repeat the same with http://launchpad.net/pyreadline/trunk/1.7/+download/pyreadline-1.7.zip # USING PRONTERFACE To use pronterface, you need: -python (ideally 2.6.x or 2.7.x), -pyserial (or python-serial on ubuntu/debian), -pyreadline (not needed on Linux) and -wxPython + * python (ideally 2.6.x or 2.7.x), + * pyserial (or python-serial on ubuntu/debian), + * pyreadline (not needed on Linux) and + * wxPython 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. @@ -65,9 +64,9 @@ The "skeinforge" folder must be in the same folder as pronterface.py # USING PRONSOLE To use pronsole, you need: -python (ideally 2.6.x or 2.7.x), -pyserial (or python-serial on ubuntu/debian) and -pyreadline (not needed on Linux) + * python (ideally 2.6.x or 2.7.x), + * pyserial (or python-serial on ubuntu/debian) and + * pyreadline (not needed on Linux) 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" @@ -81,11 +80,11 @@ To use printcore you need python (ideally 2.6.x or 2.7.x) and pyserial (or pytho 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: -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() + 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() From 94afd620a1c39f6cb10d597f36a472e34ad16ab4 Mon Sep 17 00:00:00 2001 From: Brendan Erwin Date: Mon, 15 Aug 2011 22:33:58 -0300 Subject: [PATCH 5/5] Edited online so I could more easily see the results of my edits. --- README.md | 17 ++++++++++------- 1 file changed, 10 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 2827de1..9356d71 100644 --- a/README.md +++ b/README.md @@ -8,6 +8,7 @@ Printrun consists of printcore, pronsole and pronterface, and a small collection ## Windows Download the following, and install in this order: + 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 @@ -21,25 +22,25 @@ Download the following, and install in this order: ## Mac OS X Lion - 1. Ensure that the active Python is the system version. - (`brew uninstall python` or other appropriate incantations) - 2. Download an install wxPython version 2.9-Carbon (its the Cocoa - version doesn't work) + 1. Ensure that the active Python is the system version. (`brew uninstall python` or other appropriate incantations) + 2. Download an install [wxPython version 2.9-Carbon](http://wxpython.org/download.php#unstable) (the Cocoa version doesn't work) 3. Download and unpack pyserial from http://pypi.python.org/packages/source/p/pyserial/pyserial-2.5.tar.gz - 4. in a terminal, change to the folder you unzipped to, then type in: - `sudo python setup.py install` + 4. In a terminal, change to the folder you unzipped to, then type in: `sudo python setup.py install` The tools will run just fine in 64bit on Lion, you don't need to mess -with any of the 32bit settings +with any of the 32bit settings. ## Mac OS X (pre Lion) 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: + `defaults write com.apple.versioner.python Prefer-32-Bit -bool yes` + `sudo python setup.py install` Alternatively, you can run python in 32 bit mode by setting the following environment variable before running the setup.py command: + `export VERSIONER_PYTHON_PREFER_32_BIT=yes` Then repeat the same with http://launchpad.net/pyreadline/trunk/1.7/+download/pyreadline-1.7.zip @@ -47,6 +48,7 @@ Then repeat the same with http://launchpad.net/pyreadline/trunk/1.7/+download/py # USING PRONTERFACE To use pronterface, you need: + * python (ideally 2.6.x or 2.7.x), * pyserial (or python-serial on ubuntu/debian), * pyreadline (not needed on Linux) and @@ -64,6 +66,7 @@ The "skeinforge" folder must be in the same folder as pronterface.py # USING PRONSOLE To use pronsole, you need: + * python (ideally 2.6.x or 2.7.x), * pyserial (or python-serial on ubuntu/debian) and * pyreadline (not needed on Linux)