View source for Repetier-Host Installation and Configuration

=Installation=

==Prerequisites==

Before you start with the installation, you should check if your computer meets the requirements. Currently available computers should have no problems at all. If you have an old computer running Windows XP you may have difficulties. The Host works on Windows XP and later and on Linux. If you have a Macintosh computer, check for the Repetier-Host Mac on this site. All you need is .NET framework 4.0 or a recent Mono installation, if you are running Linux. The only other requirement is a graphic card with OpenGL. For a good rendering performance OpenGL 1.5 or higher is needed. With lower versions you may have speed issues with live preview.

Getting the software

Go to the [http://www.geeetech.com/wiki/index.php/Repetier-Host#Download download page] and fetch the latest version for your os.

==Windows installation==

The windows version comes with a installer. After downloading run the installer and you are done. The installer already contains Slic3r and Skeinforge for slicing and python and pypy, which are needed to run Skeinforge.

==Linux installation==

The linux version comes as gzipped tar file. Move it to where you want your files and unpack its contents and run the post installation script:

  tar -xzf repetierHostLinux_1_03.tgz
  cd RepetierHost
  sh configureFirst.sh

After that you have a link in /usr/bin to the installation, so you can start it with repetierHost. Make sure you have all required Mono libraries installed. If you are in doubt, install Mono develop, which has all needed libraries as dependency.

One problem that most linux distributions have is, that the normal users are not allowed to connect to a serial console. You need to put your user into the right group. On Debian you can call:

  usermod -a -G dialout yourUserName

to add your user to the group dialout.

=Configuration=

==First start==

After the first start a dialog may pop up asking you, where your work directory should be. The latest windows versions skip this step, because the installer already created a work directory for you. You can select any directory, where you have write privileges, but it is advised to use a separate directory for this purpose.

The work directory is, where the host will put temporary stl files, sliced results and if enabled the log file.

==Configuring your printer==

The next step should be, to configure your printer so you can connect your computer with the host. Make sure your printer is connected and enabled. Some printer need special driver to access the device, so make sure the drivers are also installed. If you have uploaded the firmware to your printer, the driver is already installed.

===Printer Settings===

Go to the menu “Config”->”Printer Settings” or klick the button [[File:1printersettingsbutton.png]]. You will see a window like this:

[[File:2printersettings.png]]

At the top you see a drop down box, with the currently selected printer. At the start you have only the default printer. To create a new printer you only need to change the printer name and press “Apply”. The new printer will start with the same settings as the last selected printer.

Below the drop down box you see four tabs with most off the data stored with the printer configuration. In addition to this, for each configuration a start/end/pause/kill and five user defines scripts are stored with configuration. These can be changed in the g-code editor, which is described in a different chapter.

'''Connection'''

[[File:2printersettings.png]]

In this first tab, you set how to connect with your printer. In “Port” you select the port, where your printer is connected. At the opening of the window, all available ports were scanned and added to the list. If you connect your printer when this menue is already open, klick “Refresh Ports” to detect the new port. Select the right one. Then select the baud rate entered into the firmware. Stop bits and parity are correct for 99,9% of the printer, so leave them untouched.

The transfer protocol determines, how the host will communicate with the printer. All supported firmwares work in ASCII mode. The Repetier-Firmware also supports a binary format. The advantages of the binary format are:

*Reduced data size. Normal data is reduced to 50%.
*Better error correction.
*Less computation time needed for the firmware to parse the data.

You can leave this on “Auto detect”, which will automatically switch to binary format if Repetier-Firmware is detected. For all other firmwares, the ASCII communication is used.

The next decision is, how to send data to the firmware. The method that was planned with the first firmwares works like ping-pong. The host send a command and waits for the firmware to return an ok. This causes latencies, which can result in empty buffers if you have many small moves. To improve speed, you can allow the host to send more then one command at once. Your printer has a input buffer. As long as you are sending not more then the size of the buffer, you can send more then one command if they fit into the buffer. So if you disable the ping-pong mode, the host will send up to “Receive cache size” bytes, before it waits for the ok, telling him that the command is processed. If you are unsure on the printer buffer size select 63, which works on all printers. Firmware compiled with Arduino versions before 1.0 even allow 127 bytes.

'''Printer'''

[[File:3printersettingsprinter.png]]

The second tab defines important behavior you want. The Travel feed rate and Z-axis feed rate are used, when you move the extruder with the manual controls. The temperatures are set in the manual controls as start values. You can change them there any time.

When you turn the extruder on, you surely want to know the temperature of it. This is done by sending the M105 command to the printer. If you don’t plan to do this yourself every x seconds leave the option checked. You can also select how often you want the host to check the temperature. The default 3 seconds are a good start. With every request you get 2 entries in your log. The host will show the read temperature at the bottom in the status bar, so removing these messages from the log makes it much more readable.

Park position is where you like your extruder head the most. In the manual control you have a button to move the head to the park position. You can also tell the host to go to this position, after a print is finished.

The next check boxes define, what the printer should do, when a print is finished and if a SD card is available. If no SD card is available, the corresponding tab will not be displayed.

With “Add to comp. printing time” you define, how the host should correct the computed printing time. When the host computes the time from g-code, it assumes all moves are executed at the feed rate requested. If you do a slow print, this will be quite correct, except that it doesn’t take the time to heat the extruder/bed into account. With fast prints, the firmware needs to accelerate/decelerate a log, which increases the print time. After some prints, where you compared the computed and real printing time, you should be able to figure out how much percent you need to add to the computed time. Don’t expect to match every print. Depending on the geometry, the time will still differ a bit.

At the end you can change the moving direction in manual control for each axis.

'''Extruder'''

[[File:4printersettingsextruder.png]]

In the “Extruder” tab you can define the numbers of extruders, the max. temperatures, that are shown in the manual control. The max volume per second defines the maximum amount of filament in mm³, the extruder can melt per second.

For each extruder you can define a name, a nozzle diameter (the diameter is only used for CuraEngine), a temperature offset, which is added to the filament temperature, if this extruder is selected (this also works only with CuraEngine), a color, which is used for preview, and x and y offset, which adjusts the extruder position for multi extruder prints. Some firmwares like Repetier-Firmware correct the offset themself, so in this case offset should stay 0.

'''Printer Shape'''

[[File:5printersettingsprintershape.png]]

The “Printer Shape” tab defines your printer shape, or to be more exact the shape of your build area. The host will use this to limit your moves and to check, if your models fit onto the print bed. You can also define the position of the x and y end stop.

The dump area is a rectangular hole in your print bed, where you can drop filament. Mostly the original Mendel had this. If you don’t have a dump area, leave the option unchecked.

'''Advanced''' 

[[File:6printersettingsadvanced.png]]

The last tab is for advanced configurations, you most probably will never need. Currently it only contains a post process filter. After the slicer is done with slicing, you can start an external program with the g-code. This program must save the resulting g-code in the file named by the #out parameter.

[[File:7units.png]]

Unit Settings
The host uses internally only millimeters. Unfortunately STL and OBJ format do not contain a scaling hint. Therefore you need to select the units used for the creation. That way the host will convert the units correctly into millimeters.

===Object Placement===

Prepare all objects you want to print, so your printer can print them. Learn how to arrange them on your print bed. Rotate and scale them to your likes.

[[File:8repetier-host100.png]]

'''Workflow'''

Open the “Object Placements” tab. You will see the print area on the left side. You start with importing all STL files using the “Add Object” button [[File:9addstl.png]]. You can select multiple object files at once if you want. This must be in one of the following formats: STL, OBJ, 3DS. The host will always try to position the objects in a non overlapping way onto your bed.

'''Browsing 3D View'''

[[File:10 3dview.png]]

In this window you see your 3D objects. At the left side, you find some navigation buttons:

The first 4 buttons change the behaviour of the left mouse button. Starting at the top, you get “Rotate”[[File:11rotate.png]], “Move Viewpoint”[[File:12moveviewpoint.png]], “Move Object”[[File:13moveobject.png]] and “Zoom”[[File:14zoom.png]]. All funtions can be used with control keys, so that you don’t have to change all the time.

[[File:32view.png]]

*Control: Holding the control button, you can rotate the view with the left mouse button.
*Shift: Holding shift button you can move the view point with the left mouse button.
*Right Mouse Button: Move the object by holding the right mouse button.
*Mouse Wheel: Zoom view

With this icon [[File:15fitobject.png]],the objects will be zommed to fit exactly in the preview area.

With the next three icons [[File:Isometricview.png]](Isometric View), [[File:16frontview.png]]( Front View),[[File:Topview.png]] (Top View) you can select between predefined view orientations. You find more view options at the top View menu:

*Fit Printer (Strg+A): Zooms to fit the complete printer area into the window with maximum size.
*Fit Objects (F5): Zooms to fit all objects into the window with maximum size.
*Show Edges (Strg+E): Toggles display of triangulation edges.
*Show Faces (Strg+F): Toggles display of triangulation faces.
*Show Compass (Alt+C): Toggles display of coordinate compass at the left bottom.
*Toggle Printer ID Vies (Strg+I): Toggles the display of the printer ID on top of the right tab. Use this to distinguish the printer when you have more than one host running.

“Use Parallel Projection” [[File:17parallelview.png]] toggles between parallel and perspective projection.

[[File:18Objectplacement.png]]

[[File:19save32.png]] Here you can export all displayed objects at once. If you save them as .amf file, the object grouping and material assignments remain intact, if you save it as .stl or .obj file, everything gets combined into one object.

Add Object Here you can add objects in .stl, .obj, .amf and .3ds format.

Copy Object(s) Here you can duplicate the marked object(s) as many times as you want.


Autoposition Click here to place all objects so that they fit on the bed.

Center Object This function centers the marked object in the center of the bed.

Scale Object With this function you can scale the marked object.

If the lock is closed, all axes are changed simultaneously. If you click on the lock to unlock, you can adjust each axis separately and the object may be distorted. A click on “Scale to Maximum” enlarges the object so that it has the maximum printable size.

Rotate Object With this function you can rotate the marked object around each axis. Click on “Lay Flat” to place the object flat on the bed.


Cut Objects This option is only used to control the object and has no influence on the print. With “Position” the height of cut position is defined, “Inclination” and “Azimuth” define rotation of the cutting plane.


Selecting and moving objects

You can select one object by right clicking on it. If you press the ctrl-key while right clicking  the selected object is added. ctrl-clicking a selected object removes it from the selection.

To move the selected objects, hold the alt-key down while left clicking and dragging the objects. When you select “Top View” Top View from the left toolbar, the movements will follow your mouse movements. If you don’t, the direction of the move is not the same of the mouse movement.

Depending on your configuration, the object may start to pulse or change it’s color, if it is not entirely on the print bed. This should help you identifying printing problems, even before you start slicing.

Grouping Objects

Object groups are used only for multi extruder prints. For multi extruder prints you normally get one stl file for each color. After you loaded them, each has it’s own group, which normally causes wrong relative positioning. So you need to drag the second stl onto the first stl to merge them into one group. After merging you have to assign each file a separate extruder. Assigning the same extruder will normally cause problems during slicing.


Now it’s time to slice your objects. Open the slicer tab and continue there. More on this in the next chapter.

Continue with “Slicing”