IcosI Installation manual

IcosI Installation manual
For consumers
Document version: 1.0
IcosI version:
1.0
TABLE OF CONTENTS
Table of contents...................................................................................................................................2
About IcosI...........................................................................................................................................3
Safety warnings....................................................................................................................................4
Technical information...........................................................................................................................5
General information.........................................................................................................................5
Support.............................................................................................................................................5
Kit contents...........................................................................................................................................6
Installing the IcosI hardware................................................................................................................9
Hooking up the touch screen panel..................................................................................................9
Connecting the computer hardware...............................................................................................11
Connecting power..........................................................................................................................12
Settings.py..........................................................................................................................................16
Locations...................................................................................................................................16
Commands.................................................................................................................................16
Printer........................................................................................................................................16
Servers.......................................................................................................................................16
Profiles......................................................................................................................................17
Network.....................................................................................................................................17
Environment..............................................................................................................................17
Module settings.........................................................................................................................17
Custom buttons..........................................................................................................................18
Hooks........................................................................................................................................18
First-use introduction................................................................................................................19
IcosI installation manual – v1.0
ABOUT ICOSI
IcosI is controller host-software for 3D printing. It focuses on usability in a simple and
direct matter. It is our challenge to provide the reseller a highly configurable controller
without diminishing on the look and feel of the user interface.
IcosI installation manual – v1.0
SAFETY WARNINGS
Do not power anything until all is set-up. Also, don't disconnect anything while power is
on.
Be careful with the golden wiring of the LCD panel, it breaks easily when bend.
IcosI installation manual – v1.0
TECHNICAL INFORMATION
General information
Linux based
IcosI runs on Linux (Ubuntu 13.04) 32-bit
Computer hardware
The IcosI hardware it includes a 3.4ghz dual core processor, with integrated 3D graphics.
On board is 2GB of RAM, which can be expanded to 4GB.
Modern web technologies
IcosI is build using state of the art web technologies including:
HTML5, CSS3, jQuery, Bootstrap and webGL
IcosI backend
The IcosI backend is developed using Python. It uses MySQL (mysql.com) as database
backend and Blender (blender.org) for rendering the 3D images.
Slicing software
For slicing 3D models the latest version of the populair ope-source software Slic3r
(slic3r.org) is included with IcosI.
Support
Browser support
The following browsers are currently supported for accessing IcosI over network. For
certain features webGL is required.
Internet Explorer 9 or higher *, Firefox 24, Chrome ??
* webGL is supported in Internet Explorer 11
Megatronics / Minitronics
IcosI supports ReprapWorld.com's hardware. You can use IcosI with either Minitronics or
Megatronics. Refer to their respective datasheets for more information.
3D printer firmware
At this time only Marlin is supported. You can download a suported Marlin version from
the ReprapWorld.com website.
Certified hardware
IcosI runs on consumer grade PC hardware. The hardware needs to be certified to run
IcosI to be supported.
IcosI installation manual – v1.0
KIT CONTENTS
The IcosI kit includes the following items. The rest of the documents refer to these items
to help you install your IcosI installation. This kit doesn't include a housing for the pc
hardware, but any (mini)-ATX housing should suffice.
IcosI software
This kit includes one license of the IcosI software.
Computer hardware
A mainboard including a 3.4Ghz dual core processor and 2GB
of RAM.
Solid state disk
32GB solid state disk
LCD controller board
Controls the LCD
IcosI installation manual – v1.0
Touch screen USB adapter
Connects the touch screen to USB
Touch screen USB cable
Wiring for the touch screen USB adapter
Touch screen cable
Connects the touch screen to the touch screen USB adapter
LCD remote controller
Controls the LCD screen
LCD controller button panel
Includes buttons and an IR sensor for controlling the LCD
screen.
IcosI installation manual – v1.0
Power supply (550W)
Power supply to hook up the PC hardware
VGA cable
IcosI installation manual – v1.0
INSTALLING THE ICOSI HARDWARE
This chapter will guide you through the steps to hook up your IcosI hardware.
Hooking up the touch screen panel
First connect the button panel to the LCD controller board.
Secondly, connect the LCD panel to the LCD controller board. You can extract the black
part of the zif-header a bit. Put the golden cable into the socket and put back the black
piece. Be careful, the golden wiring can easily get torn apart.
IcosI installation manual – v1.0
Then connect the touch screen cable to the touch screen panel. Mind the coloring of the
wiring. The red wire should be on the right.
The other end of the touch screen cable goes into the touch screen USB adapter, which is
in turn hooked up to any USB port on the mainboard.
IcosI installation manual – v1.0
Connecting the computer hardware
Use the SDA cable to hook up the Solid state disk to any of the white SDA sockets on the
mainboard. Connect any of the power cables from the power supply to the solid state
drive too.
IcosI installation manual – v1.0
Connect ATX power to the main board. First connect the 24 pin power cable, then the 4
pin cable.
Lastly connect the VGA cable to the mainboard and the LCD controller board.
Connecting power
The controller board needs 5-12V. You can hook it up to Megatronics or Minitronics to
receive this power. The pictures below show how to connect the controller board to each
IcosI installation manual – v1.0
option, but you can also hook it up to you 5V or 12V power supply. Make sure the
polarization is correct. Red is +, black is -.
Megatronics supplies 5V through the 5V header, on the upper right side of the board.
You can also choose the 12V header to draw power form, which is just above the 5v
header.
IcosI installation manual – v1.0
Minitronics has a 5V header just below the heated bed output, which you can use to
power the controller board.
Once everything is set-up you can plug in the ATX power supply into your
IcosI installation manual – v1.0
ICOSI CONFIGURATION
You can immediately start using IcosI using the touch screen. To be able to use IcosI for
printing it needs some configuration, however. Configuration is done in the file
settings.py, which is accessible over you local network. To access the printer, first you
need to find out the IP address of the printer. If you have connected the main board to
your wired network, an IP address should already be assigned. If you have a wireless
network, first setup the wireless network. See paragraph wireless network for more
information.
Once the network is connected,
Go to configuration → configuration overview → network status
it shows the ip adresses currently assigned to the network interfaces (ethX for wired,
wlanX for wireless). On your computer browse the network for the printer using your file
explorer. You can connect directly to the printer using the ip-adress, for example \\<ip
address> (windows) or smb://<ip address> (linux).
There should be four shares available: macros, profiles, settings and shared. The
configuration is present under setting. Locate settings.py and open it. This file contains
all configuration for IcosI. For the first time adjusting the baudrate
(DEFAULT_SERIAL_BAUD) to the baud rate defined in your printer firmware should be
enough to allow IcosI to recognize the 3D printer. After you have made changes to the
configuration, it is necessary to reboot IcosI. See chapter “Settings.py” in the resellers
documentation for more details on the settings.
Setting up wireless network
First, make sure the wireless antenna is correctly inserted in the mainboard. To setup you wireless
network, press the wireless icon in the icon-bar in the upper right of the touch screen. If the
wireless device is recognized correctly, you are able to select a wireless network. Select the security
protocol and enter the password using the on-screen keyboard. Once the connection is estheblished,
the wireless icon will turn green.
Connecting to IcosI using your webbrowser
Once the network is setup, you can use your browser to connect to IcosI. Type in the address bar of
your browser http://<ip address>, where ip address is the address of you printer as found in the
previous paragraph.
Uploading a Slic3r profile
IcosI requires a Slic3r profile to print objects. The default Slic3r profiles probably don't match your
printer, so it's required to upload you own profile. Browse to the IcosI shared folders as described in
the first paragraph, and locate the profiles directory. The directory contains the profiles and for each
IcosI installation manual – v1.0
profile a configuration file. To start, just replace the normal.ini Slic3r profile with your own. You
can change to corresponding normal.cfg file to describe the profile to IcosI.
Defining macros
Macro's are little sequences of gcode that IcosI will execute on certain printing events. You can edit
the macro's from the macro's module located in the configuration screen. Select the macro you wish
to edit. The request box shows the command(s) send to the printer upon executing the macro. The
response box shows the regular expression to dissect the response code. You probably only want to
change the request commands.
Pre-flight check
Before starting a print, first make sure that the following steps are performed:
- Check the configuration in setttings.py to match your 3D printer
- Check the macros (especially the before, abort and after print) to match your printer, or they may
cause damage to your printer
- Upload your Slic3r profile(s)
Starting a print
Go to the home screen of IcosI, by pressing 'IcosI' in the upper left of the touch screen. Press
'choose a model' from the home screen. The library with all available models is shown. Choose a
model and select a profile. Once a profile is chosen, the slicing procedure will start followed by
starting your print.
IcosI installation manual – v1.0