basics [Smoothieware]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
== Smoothie basics

Here are some basic notions and pointers about Smoothie.

Smoothie is a [[http://en.wikipedia.org/wiki/Firmware|firmware]]. 

That is a program that executes on a [[http://en.wikipedia.org/wiki/Microcontroller|micro-controller]], basically a very simple/small computer used for very specific tasks.

The micro-controller is located on a controller board, for example [[Smoothieboard]], where it executes the Smoothie firmware.

This program receives instructions from your computer ( typically [[http://reprap.org/wiki/G-code|G-code]], generated by [[http://en.wikipedia.org/wiki/Computer-aided_manufacturing|CAM software]] ), and executes them, for example by moving stepper motors in a coordinated fashion, and operating tools.

If you are curious, you can find a list of G-codes for Smoothie, and their explanation, [[/supported-g-codes|here]].

This allows you to use Smoothie to execute [[http://en.wikipedia.org/wiki/Numerical_control|CNC]] operations.

Some examples of workflow : 

<callout type="primary" icon="true" title=" 3D printer">

* Create a [[http://en.wikipedia.org/wiki/3D_modeling|3D model]] using 3D drawing ( [[http://en.wikipedia.org/wiki/Computer-aided_design|CAD]] software ), for example [[http://www.openscad.org/|OpenSCAD]].
* Export this model as a [[http://en.wikipedia.org/wiki/STL_%28file_format%29|STL]] file, that is the standard file format generally currently used for 3D models exported for 3D printing.
* Use [[http://en.wikipedia.org/wiki/Computer-aided_manufacturing|CAM software]] like [[http://slic3r.org/|Slic3r]], to convert the STL file into a G-code file.
* Connect host software like [[Pronterface]] to your [[Smoothieboard]] via the USB cable. 
* Instruct the host software to start the print.
* The host software will stream the G-code to the [[Smoothieboard]], which will execute each G-code command in sequence
* The motors move, the extruder extrudes, and a nice-looking 3D printed object gets created.

</callout>

<callout type="primary" icon="true" title=" CNC milling machine">

* Create a 2D or [[http://en.wikipedia.org/wiki/3D_modeling|3D model]] using 2D or 3D drawing ( [[http://en.wikipedia.org/wiki/Computer-aided_design|CAD]] ) software, for example [[http://www.openscad.org/|OpenSCAD]].
* Export this model as a [[http://en.wikipedia.org/wiki/STL_%28file_format%29|STL]] or [[http://fr.wikipedia.org/wiki/Drawing_eXchange_Format|DXF]] file, STL is generally used for 3D milling operations ( for example surface carving ), and DXF for 2D or [[http://en.wikipedia.org/wiki/2.5D|2.5D]] milling operations ( for example contour or drilling ).
* Use [[http://en.wikipedia.org/wiki/Computer-aided_manufacturing|CAM software]] like [[http://www.cambam.info/|CamBam]], to convert the file into a G-code file.
* Connect host software like [[Pronterface]] to your [[Smoothieboard]] via the USB cable. 
* Instruct the host software to start the operation.
* The host software will stream the G-code to the [[Smoothieboard]], which will execute each G-code command in sequence
* The motors move, spindle spindles, and a milled object gets carved out of material.

The workflow is very similar for a laser cutter, as it is essentially a CNC mill with a very very thin tool ( the laser beam ).

</callout>

== Smoothie adventure

When setting up a machine to be controlled by a [[Smoothieboard]], the process is generally as follows :

* Before anything else, read the guide for your machine type : [[/3d-printer-guide|3D printer guide]], [[/laser-cutter-guide|laser cutter guide]] or [[/cnc-mill-guide|cnc mill guide]], in its entirety.
* If using Windows, install the [[/windows-drivers|driver]].
* Install some [[/software|software]] to talk to the board.
* Connect your board to your computer via [[usb]] or [[/network|ethernet]] and practice talking to it.
* Now following the guide, start plugging peripherals into your board, and editing your [[/configuring-smoothie|configuration]] accordingly.
* Test each thing before moving on the the next, it helps make sure if there is a problem you know exactly where it happens.
* Once everything works, you can start using your machine to fabricate things.

== Communication

You can't do anything if you can't talk to your [[Smoothieboard]].

The usual way to do so is to simply connect a USB cable to your Smoothieboard, then to your computer, and then to connect your host software to the Smoothieboard.

See your host software of choice's documentation on this matter.

The Host software will then provide you with a graphical user interface to interact with your Smoothieboard ( and therefore with your machine ), and you shouldn't have to worry about communication more than this.

<callout type="info" icon="true" title=" Going further">

* Aside from connecting via the USB cable, you can also use the on-board Ethernet connector to interface with the board, see [[Ethernet]]. This provides a telnet interface ( similar to the Serial/USB interface the USB cable offers ), and a Web interface. One advantage of this is that Ethernet is less prone to suffer from [[http://en.wikipedia.org/wiki/Electromagnetic_interference|Electromagnetic interference]] problems than USB.
* Smoothieboard has an on-board SD card. Instead of using your host software to stream your G-code program line by line, you can also upload it all at once to the SD card, then execute it from there. This removes the bottleneck of communication while printing ( though that is very rarely a problem ). See [[http://smoothieware.org/printing-from-sd-card|Printing from the SD Card]].
* Smoothie has a set of commands you can use to interact with and configure the board. See [[http://smoothieware.org/console-commands|Console Commands]]
* The G-codes that Smoothie understands are listed at [[http://smoothieware.org/supported-g-codes|Supported G-codes]].

</callout>

== Electricity

When reading this documentation, [[https://pics.me.me/Instagram-Pictorial-representation-of-ohms-law-engineering-d05c8e.png|understanding]] of basic principles of electricity will be expected and can not be done without. 

Here are a few videos to refresh your memory : 

=== What is electricity

<html>
<center>
<iframe width="560" height="315" src="https://www.youtube.com/embed/mc979OhitAg" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
</center>
</html>

=== What are Amps

<html>
<center>
<iframe width="560" height="315" src="https://www.youtube.com/embed/8gvJzrjwjds" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
</center>
</html>

=== What are Volts

<html>
<center>
<iframe width="560" height="315" src="https://www.youtube.com/embed/TBt-kxYfync" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
</center>
</html>

=== What is resistance

<html>
<center>
<iframe width="560" height="315" src="https://www.youtube.com/embed/NfcgA1axPLo" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
</center>
</html>

=== What are Watts

<html>
<center>
<iframe width="560" height="315" src="https://www.youtube.com/embed/VSpB3HivkhY" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>
</center>
</html>

There is very little math in these videos ( except the last one ), if you have a hard time with what's still there, we warmly recommend heading over to [[https://www.khanacademy.org/|Khan Academy]]'s math videos for easy to digest courses.

If you want to go further on this subject, you can also follow this [[https://www.khanacademy.org/science/electrical-engineering/introduction-to-ee|basic Electrical Engineering]] video course.