|
|
| (78 intermediate revisions by 9 users not shown) |
| Line 1: |
Line 1: |
| | {{EggBotDocs}} | | {{EggBotDocs}} |
| − |
| |
| | | | |
| | Eggbot is designed to work well on Mac, Windows, and Linux computers. To use it, you'll need to install certain software on your computer. | | Eggbot is designed to work well on Mac, Windows, and Linux computers. To use it, you'll need to install certain software on your computer. |
| | | | |
| | + | The EggBot extensions for Inkscape are included with, and installed by, the AxiDraw software installers. To install the software please follow the specific directions for your platform on the [https://wiki.evilmadscientist.com/index.php?title=Axidraw_Software_Installation&oldid=4104 AxiDraw installation page]. Detailed instructions are provided for Mac, Windows, and Linux computers. (We are currently recommending software install version 3.9.4 for EggBot users; the installation page link goes to the version for 3.9.4.) |
| | | | |
| − | The Eggbot software actually consists of several different parts:
| + | == Example files == |
| − | # Inkscape, the superb freeware vector graphics application
| |
| − | # The Eggbot extensions for Inkscape, which let you control the Eggbot from within Inkscape
| |
| − | # The Eggbot USB driver, on Windows systems.
| |
| − | | |
| − | | |
| − | Optionally but suggested, you may also want to download the set of example files from the [
| |
| − | (If you have not already, you may also want to download the set of example files from the [https://code.google.com/p/eggbotcode/downloads/list?can=2&q=label%3AFeatured+example EggBotCode Google Code site].)
| |
| − | | |
| − | | |
| − | The particulars of installation depend on the operating system:
| |
| − | | |
| − | | |
| − | == Mac ==
| |
| − | | |
| − | 1. Download and install the latest version of Inkscape (version 0.48.2 or newer) from [http://inkscape.org/en/download/ the download page] at Inkscape.org.
| |
| − |
| |
| − | :* Install Inkscape in the default location, the main "Applications" folder.
| |
| − | :*Note that inkscape is an X11 application, and will require that X11 or XQuartz is installed on your Mac.
| |
| − | :: For MacOS 10.6 and newer (Snow Leopard, Lion, Mountain Lion, Mavericks, Yosemite, etc.), download and install the latest release of [http://xquartz.macosforge.org/trac/wiki XQuartz].
| |
| − | :: For MacOS 10.5 (Leopard), download and install the "Final Leopard Release," from the [http://xquartz.macosforge.org/trac/wiki/Releases XQuartz site].
| |
| − | :: For MacOS 10.4, use the X11 that came on your system installer disks.
| |
| − | :* If you need additional assistance for installing Inkscape, you may be able to find good advice at the [http://wiki.inkscape.org/wiki/index.php/InstallHelp the Inkscape wiki] and/or the [http://www.inkscapeforum.com/ Inkscape Forums]. ''Please do not use Inkscape support resources for Eggbot-specific issues-- see note below about troubleshooting.''
| |
| − | | |
| − | | |
| − | 2. Download and install the Eggbot Extensions for Inkscape
| |
| − | | |
| − | :* New "pre-releaser" installer now available for Mac, available at [https://github.com/evil-mad/EggBot/releases/latest github]. Download and open the DMG (disk image) file. Run the EggBot Installer, and (optionally) copy the EggBot Example set onto your drive.
| |
| − | | |
| − | :IF you have difficulty with that method:
| |
| − | :* For MacOS 10.4 - 10.9 (Mavericks): Download the Mac installer package from the [https://code.google.com/p/eggbotcode/downloads/detail?name=EggBot2.3.1.r4s.zip Google Code site]. Run the installer (a standard Mac installer package) to install the Eggbot extensions.
| |
| − | :* Alternate method, Manual installation (currently required for MacOS 10.10 Yosemite): Download the latest version of the Inkscape extension (''not'' the mac installer) from the [http://code.google.com/p/eggbotcode/downloads/list?q=label:Featured EggBotCode Google Code site]. Copy the entire contents of the Eggbot software archive to /Applications/Inkscape.app/Contents/Resources/extensions/ and restart Inkscape.
| |
| − | :: ''Caution'': There is a [http://bugs.launchpad.net/inkscape/+bug/819209 well-known conflict] between some versions of Inkscape and MacOS, that can cause an error message that begins with "The fantastic lxml wrapper for libxml2...." The Mac installer package contains a patch that works around this issue, for MacOS 10.6 - 10.9, but will cause the issue on MacOS 10.10 (Yosemite).
| |
| − | :: Note for MacOS 10.4: You may also need to install Python 2.5, if your system does not already have it.
| |
| − | :* The "Eggbot" submenu should appear in the Extensions menu of Inkscape after you restart Inkscape.
| |
| − | | |
| − | | |
| − | 3. Troubleshooting
| |
| − | | |
| − | : Your software should now be set up to work correctly.
| |
| − | :* If copy and paste are not working correctly in Inkscape, open the X11 preferences dialog, and disable the "Update Pasteboard when CLIPBOARD changes" option.
| |
| − | :* If you encounter difficulty installing the Eggbot extensions for Inkscape (or with plotting, in the next stage), please request assistance through the Eggbot mailing list or forum, which you can find on our [[Eggbot|front page]].
| |
| − | :* If there is any chance that a problem you encounter is specific to Eggbot software or hardware, it is important that you do not directly seek assistance through Inkscape's support resources. You're much more likely to get your problem solved by asking people who know about Eggbot. And, we'd like the Inkscape team to be ready to help us when we do encounter Inkscape-specific issues.
| |
| − | | |
| − | == Windows ==
| |
| − | | |
| − | 1. Download and install the latest version of Inkscape (we recommend version 0.48.2) from [http://inkscape.org/en/download/ the download page] at Inkscape.org.
| |
| − | | |
| − | :* Install Inkscape in the default location, the main "Program Files" folder (or "Program Files (x86)" on newer systems).
| |
| − | :* If you need additional assistance for installing Inkscape, you may be able to find good advice at the [http://wiki.inkscape.org/wiki/index.php/InstallHelp the Inkscape wiki] and/or the [http://www.inkscapeforum.com/ Inkscape Forums]. ''Please do not use Inkscape support resources for Eggbot-specific issues-- see note below about troubleshooting.''
| |
| − | | |
| − | | |
| − | 2. Download and install the Eggbot extensions for Inkscape
| |
| − | | |
| − | :* Recommended method: Download the latest version of the Windows installer package from the [https://code.google.com/p/eggbotcode/downloads/detail?name=EB_Ext_2_2_2_r3.exe EggBotCode Google Code site]. Run the installer (a standard Windows installer package) to install the Eggbot extensions. The installer has been tested to work from XP through Win7.
| |
| − | :* Alternate method, Manual installation: Download the latest version of the Inkscape extension (''not'' the Windows installer) from the [https://code.google.com/p/eggbotcode/downloads/list?can=2&q=featured+manual EggBotCode Google Code site]. Copy the entire contents of the Eggbot software archive into (Program files)\Inkscape\share\extensions\ and restart Inkscape.
| |
| − | :* The "Eggbot" submenu should appear in the Extensions menu of Inkscape after you restart Inkscape.
| |
| − | | |
| − | | |
| − | 3. Download and install the Windows USB driver for Eggbot
| |
| − | | |
| − | :* This driver is necessary for Windows to recognize the Eggbot USB device.
| |
| − | :* Recommended method: Download the latest version of the Windows USB Driver (the "UBW driver") installer package from the [https://code.google.com/p/eggbotcode/downloads/detail?name=UBWDriverInstaller_v20.exe EggBotCode Google Code site]. It is called UBWDriverInstaller_v20.exe. Run the application. Click on the Installer Drivers button. When it is finished, close the application. The USB driver installer has been tested to work from XP through Windows 8 (32 and 64bit). Note that Windows (by default) hides the ".exe" extension of the filename, so after you unzip the downloaded file, double click on the USBDriverInstaller application even if it doesn't have .exe at the end of its name.)
| |
| − | :* When you plug in your EggBot to your computer, the drivers will already be installed, and you can tell Windows to search for the drivers (XP) or allow the drivers to be installed when you connect (Vista and Windows 7).
| |
| − | :* Alternate method: Download the USB driver itself from [http://schmalzhaus.com/EBB/EBF/EBB_inf.zip]. Extract the files and point Windows to the inf file when asked for drivers when you connect your EggBot. Note that if you use Vista or Windows 7 and you use this method, Windows will silently fail when you plug in your EggBot for the first time, and you will need to go to the Device Manager and manually install the drivers for the device from there.
| |
| − | | |
| − | | |
| − | | |
| − | 4. Troubleshooting
| |
| − | | |
| − | : Your software should now be set up to work correctly.
| |
| − | :* If, when trying to run USBDriverInstaller.exe, you get a "Application failed to initialize (0x0000135)" error, it means that your copy of Windows does not have the .Net libraries installed. This is straightforward to fix - go to [http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=17718] and run the installer from Microsoft, then run USBDriverInstaller again.
| |
| − | :* If you encounter difficulty installing the Eggbot extensions for Inkscape (or with plotting, in the next stage), please request assistance through the Eggbot mailing list or forum, which you can find on our [[Eggbot|front page]].
| |
| − | :* If there is any chance that a problem you encounter is specific to Eggbot software or hardware, it is important that you do not directly seek assistance through Inkscape's support resources. You're much more likely to get your problem solved by asking people who know about Eggbot. And, we'd like the Inkscape team to be ready to help us when we do encounter Inkscape-specific issues.
| |
| − | | |
| − | == Linux ==
| |
| − | | |
| − | The Eggbot extension for Inkscape has been developed and tested extensively under Ubuntu 10.04 - 12.04.
| |
| − | We expect it to work equally well in most Ubuntu derivatives and other distributions where Inkscape is known to work. However, ''we do not have the capability to test every distribution''.
| |
| − | | |
| − | | |
| − | Ubuntu install instructions:
| |
| − | :* Use the Ubuntu Software Center to install Inkscape 0.47 or newer (0.48 or newer is recommended.)
| |
| − | :* Launch Inkscape from the Applications menu, and then quit it.
| |
| − | :* Download the latest Inkscape extension .ZIP file from the downloads section of [http://code.google.com/p/eggbotcode/downloads/list?q=label:Featured EggBotCode Google Code site].
| |
| − | :* From the "Places" menu, open your Home Folder.
| |
| − | :* From the "View" menu select "Show hidden files" -- the .config folder should be visible.
| |
| − | :* Place the contents of the folder inside the ZIP archive inside .config/inkscape/extensions/
| |
| − | :* Add your user account to the "dialout" group. (See below for details.)
| |
| − | :* Log out and log back in, for that group change to take effect.
| |
| − | :* The "Eggbot" submenu should appear in the Extensions menu of Inkscape when you start Inkscape.
| |
| − | | |
| | | | |
| − | About adding your user account to the "dialout" group:
| + | Optionally but suggested, you may also want to download the set of example files for Eggbot. A direct download link is [https://github.com/evil-mad/EggBot/releases/download/v2.8.1/EggBotExamples_v281.zip here]; the files are hosted on the [https://github.com/evil-mad/EggBot/releases/latest EggBot Releases page] at GitHub. |
| − | : In recent Linux releases (e.g., Ubuntu 12 and newer), it is also necessary to change your user permissions, to explicitly grant access to the USB port where the Eggbot is located. This can be done by adding your user group to the "dialout" user group on your system.
| |
| | | | |
| − | :* Open up a terminal window
| |
| − | :* For most distributions (including Fedora and Ubuntu), enter the command "sudo usermod -a -G dialout <myUserName>" <return>, replacing the <myUserName> part with the user that is running Inkscape (and without the quotation marks or angle brackets!).
| |
| − | ::* If you are unsure of your user name, enter the command "whoami" <return>, and the computer will happily remind you.
| |
| − | ::* If you are unsure whether you are already in the "dialup" group, enter the command "groups" <return>, and the computer will list the groups that you are in.
| |
| − | :* After changing groups, you need to log out and log back in for the change to take effect.
| |
| | | | |
| | | | |
| − | sudo usermod -a -G dialout <myUserName>"
| + | == Firmware Update == |
| | | | |
| − | Debian Wheezy install instructions(command line):
| + | We encourage EggBot users to update the latest firmware version. Once your EggBot software is up and running, you can check which version of the firmware you have by selecting the "Manual" tab of EggBot Control, picking "Check EBB Version" from the menu there, and clicking Apply. |
| − | :* Download the latest Inkscape extension .ZIP file from the downloads section of [http://code.google.com/p/eggbotcode/downloads/list?q=label:Featured EggBotCode Google Code site].
| |
| − | :* Open up a terminal window, enter the command ,<return>, where you type your user name instead of ''UserName'' (And, no quotation marks.):
| |
| − | "sudo apt-get install inkscape"
| |
| − | "sudo apt-get install unzip python-lxml"
| |
| − | unzip the latest Inkscape extension .ZIP file into
| |
| − | /home/'UserName'/.config/inkscape/extensions
| |
| − | Than you can use the Eggbot extension for Inkscape by type:
| |
| − | "inkscape" <return>
| |
| | | | |
| − | Troubleshooting
| + | EBB Firmware versions 2.4.6 and newer contain performance improvements and bug fixes that can prevent certain types of errors. |
| − | : If your permissions are not correct (your user is not in the dialout group), you may get consistent "Unable to find an Eggbot" type error messages.
| |
| − | : If the Eggbot menu doesn't appear in Inkscape, verify that when you've extract the zip file, all the .py files are inside .config/inkscape/extensions/ folder (you might have extracted the entire eggbot folder, and .py files might be misplaced)
| |
| | | | |
| − | === Additional known-working distributions and configurations ===
| + | To update your firmware, please follow the directions [[Updating_EBB_firmware|here]]. |
| − | If you do use Eggbot under Linux, please feel free to add your (working) configuration to this list (started November 2013-- not extensive!)
| |
| − | * Ubuntu 12.04 with Inkscape 0.48.2 - 0.48.4
| |
| − | * Fedora Core 18 with Inkscape 0.48.4
| |
| − | * Debian 7 Wheezy with Inkscape 0.48.3.1
| |
Eggbot is designed to work well on Mac, Windows, and Linux computers. To use it, you'll need to install certain software on your computer.
The EggBot extensions for Inkscape are included with, and installed by, the AxiDraw software installers. To install the software please follow the specific directions for your platform on the AxiDraw installation page. Detailed instructions are provided for Mac, Windows, and Linux computers. (We are currently recommending software install version 3.9.4 for EggBot users; the installation page link goes to the version for 3.9.4.)
Optionally but suggested, you may also want to download the set of example files for Eggbot. A direct download link is here; the files are hosted on the EggBot Releases page at GitHub.
We encourage EggBot users to update the latest firmware version. Once your EggBot software is up and running, you can check which version of the firmware you have by selecting the "Manual" tab of EggBot Control, picking "Check EBB Version" from the menu there, and clicking Apply.
EBB Firmware versions 2.4.6 and newer contain performance improvements and bug fixes that can prevent certain types of errors.
