build guide images and contents

README.md

@@ -14,7 +14,7 @@ OpenClino is designed to be simple, accessible, affordable, and **reliable**. It
 
 ## Documentation
 
-![Clinostat build!](docs/images/build_guide/exploded_view.jpg "explodedView")
+![Clinostat build!](docs/images/build_guide/0_exploded_view.jpg "explodedView")
 
 
 I have provided:

docs/1_documentation.md

@@ -1,13 +1,7 @@
-# OpenClino - Introduction
-
-What is a clinostat?
-
-Problem statement.
-
+# OpenClino
 
 ## Contents list
 
-
 ## Notation
 
 Definitions
@@ -22,13 +16,11 @@ motor mount
 motor enclosure
 which is x and y
 
+## Code
 
-
-## code
-
-c++
-control multiple motors
-acceleration
-docstrings
+The code is work in progress, it requires the following:
+ - control multiple motors
+ - acceleration
+ - docstrings
 
 

docs/2_BOM.md

@@ -6,18 +6,18 @@
 - #2 x nema 17 motors
 - #2 x stepper motor controllers (A4988)
 - #2 x 180mm GT2 belts
-- #1 x 220mm GT2 belt
+- #1 x 500mm GT2 belt
 - #2 x stepper motor pulleys
 - #1 x 1mx20mmx20mm aluminium extrusion
-- #12 x 8mm skateboard bearings
+- #12 x 8mm (ID) skateboard bearings
 
 Hardware
 - #4 x m8 by 60mm hex bolts
 - #2 x m8 by 100mm hex bolts
 - #8 x m3 alan bolts
 - #12 x m5 alan bolts
 
-- 1KG of your printing filament of choice
+- 1KG of your printing filament of choice.
 
 ## To Print
 

docs/3_build_guide.md

@@ -1,13 +1,22 @@
 
 # OpenClino Build Guide
+<img src="images/build_guide/0_exploded_view.jpg" alt="y_turn" width="400"/>
 
-![Clinostat build!](images/build_guide/exploded_view.jpg "explodedView")
 
+## Contents
 
-TODO
-Add pictures and definitions
-Electronics guide
-
+- [OpenClino Build Guide](#openclino-build-guide)
+  - [Contents](#contents)
+  - [3D Printing](#3d-printing)
+  - [Hardware](#hardware)
+    - [Tools required:](#tools-required)
+    - [Build Instructions:](#build-instructions)
+      - [**1 - Build y\_turn.**](#1---build-y_turn)
+      - [**2 - Combiningx and y bodies.**](#2---combiningx-and-y-bodies)
+      - [**3 - x\_pulley and m2y pulley.**](#3---x_pulley-and-m2y-pulley)
+      - [**4 - Build the base.**](#4---build-the-base)
+      - [**5 - Final Assembly.**](#5---final-assembly)
+  - [Electronics](#electronics)
 
 
 ## 3D Printing
@@ -27,93 +36,148 @@ We will build the sub assemblies: y_turn, bodies, and the base, and the final st
 
 ### Tools required:
 
-    - Spanner/wrench: Number 13 metric (same as a skateboard).
-    - Alan keys: 3 mm for the base.
-                 2 mm for the motors and bodies.
-                 1.5 mm for the motor pulley grub screw.
+- Spanner/wrench: Number 13 metric (same as a skateboard).
+- Alan keys: 3 mm for the base.
+            2 mm for the motors and bodies.
+            1.5 mm for the motor pulley grub screw.
 
 ### Build Instructions:
 
-    1 - Build y_turn.
+#### **1 - Build y_turn.**
+
+   a) Place the washers between the bolthead/nut and the bearing.
+      **NOTE**: Don't tighten the nuts too much as this will introduce a lot of unwanted friction.
+
+<img src="images/build_guide/1_y_turn.jpg" alt="y_turn" width="400"/>
+
+#### **2 - Combiningx and y bodies.**
+
+   a) Push fit bearings to the y_guide and the x body. 
+
+<img src="images/build_guide/2_combine.jpg" alt="combine" width="400"/>
+
+   b) Install bolts through the x and y body, make sure to put a washer on each side of the bearing.
+
+<img src="images/build_guide/3_bolt.jpg" alt="combine" width="400"/>
+
+   c) Install y_pulley and y_guide, with washers in between. 
+
+   **NOTE**: Remember to add the y belt before the nut!
+
+   The hex nuts can be push fit into the x body.
+
+   Tighten the y_pulley grub screw so that it rotates with the y body.
+
+   **NOTE**: the grub screw design of the y pully relies on a threaded insert that needs to be installed with a soldering iron.
+         I will endeavor to make one that has a normal hex nut.
+
+<img src="images/build_guide/3_y_guide.jpg" alt="combine" width="400"/>
 
-        a) Place the washers between the nuts and the bearing.
-           NOTE: Don't tighten the nuts too much as this will introduce a lot of unwanted friction.
 
-    2 - Combining x and y bodies.
-        a) Push fit bearings to the y_guide and the x body. 
+   d) Install the y_turn into the x body. The hex nuts can be push fit into the x body.
 
-        b) Install bolts through the y and xbody, make sure to put a washer in between the bodies!
+<img src="images/build_guide/3_y_turn.jpg" alt="combine" width="400"/>
 
-        c) Install y_pulley and y_guide, with washers in between. 
-           NOTE: Remember to add the y belt before the nut!
-           The hex nuts can be push fit into the x body.
-           Tighten the y_pulley grub screw so that it rotates with the y body.
-           NOTE: the grub screw design of the y pully relies on a threaded insert that needs to be installed with a soldering iron.
-                I will endeavor to make one that has an inserted hex nut.
 
-        d) Install the y_turn into the x body. The hex nuts can be push fit into the x body.
+   e) Ensure everything rotates smoothly. The Nylock nuts don't have to be tightened, just enough so that it doesn't shake.
 
-        e) Ensure everything rotates smoothly. The Nylock nuts don't have to be tightened, just enough so that it doesn't shake.
-
-    3 - x_pulley and m2y pulley.
-        Now that x and y are combined, lets add the x_pulley and m2y pulley.
+#### **3 - x_pulley and m2y pulley.**
 
-        a) x_pulley: push fit the x pulley into the body, and place washers in for now.
+   Now that x and y are combined, lets add the x_pulley and m2y pulley.
 
-        b) m2y pulley: push fit two bearings into the m2y pulley and add washers for now.
-           NOTE: the tricky part here is making sure the long belt doesnt scrape the motor, 
-           so remember to keep the wider part of the m2y close to the x body, 
-           and place 2 washers between the x body and the x body.
+   a) x_pulley: push fit the x pulley into the body, and place washers in for now. You might have to sand the pins on the x_pulley.
 
-        We have now fully combined x and y bodies!
+<img src="images/build_guide/4_x_pulley.jpg" alt="combine" width="400"/>
 
-    4 - Build the base.
-        a) Install the motor pulleys.
-           Make sure to align the notch in the motor shaft with one of the grub screws in the pulley.
-           Keep the motors loose for now as you will need to tension the belts later.
-           Repeat for both sides.
+   b) m2y pulley: push fit two bearings into the m2y pulley and add washers for now.
+
+      **NOTE**: the tricky part here is making sure the long belt doesnt scrape the motor like step 5e, 
+
+      so remember to keep the wider part of the m2y close to the x body, 
+
+      and place 2 or 3washers between the x body and the m2y pulley.
+
+<img src="images/build_guide/4_x_pulley.jpg" alt="combine" width="400"/>
 
-        b) Install the motor to the motor mount using 4 hex screws.
-           You can also push fit the bearings into the motor mount.
-           Repeat for both sides.
+   We have now fully combined x and y bodies!
 
-        c) Push fit the bearings into the motor_mount and motor_enclosure.
+<img src="images/build_guide/4_combined.jpg" alt="combine" width="400"/>
+
+ #### **4 - Build the base.**
 
-        d) Install the enclosures and motor mounts to the aluminium rails.
-           Keep all the screws loose for now, it will take a low of wiggling to align everything!
+<img src="images/build_guide/5_start.jpg" alt="combine" width="400"/>
 
-    5 - Final Assembly.
-        You should now have two assemblies; the base, and the x+y bodies.
+   a) Install the motor pulleys.
+
+   Make sure to align the notch in the motor shaft with one of the grub screws in the pulley.
+
+   Keep the motors loose for now as you will need to tension the belts later.
+
+   Repeat for both sides.
 
-        a) Add the short belts to the x_pulley and m2y_pulley.
+<img src="images/build_guide/5_motor_pulley.jpg" alt="combine" width="200"/>
+<img src="images/build_guide/5_motor.jpg" alt="combine" width="200"/>
 
-        b) Mount the x_body assembly to the base.
-           Remember to add a washer between the pulleys and the motor_mount bearings.
+   b) Install the motor to the motor mount using 4 hex screws.
 
-        c) Tighten the long bolts but not too much, as it might break the mounts and enclosures.
-           Again you don't want anything to be tight, make sure it all spins smoothly.
+   You can also push fit the bearings into the motor mount.
 
-        d) Hook the short belts to the motor pulley.
-           You will have to lift the motors up to attach the belt, then tension the belt and tighten the motor screws.
+   Repeat for both sides.
 
-        e) This step is just to ensure that the y belt (short) m2y belt (long) don't interfere.
-           This is the tightest tolerance in the clinostat.
+<img src="images/build_guide/5_motor_mount.jpg" alt="combine" width="400"/>
 
-        f) Finally, only after installing everything and ensuring both axes rotate smoothly should you tighten the base.
+   c) Push fit the bearings into the motor_mount and motor_enclosure.
 
-Make sure every pulley and axis rotates smoothly with the push of a pinky. If there is friction anywhere due to
+<img src="images/build_guide/5_motor_enclosure.jpg" alt="combine" width="400"/>
 
+   d) Install the enclosures and motor mounts to the aluminium rails.
+
+   Keep all the screws loose for now, it will take a low of wiggling to align everything!
 
+<img src="images/build_guide/5_motor_base.jpg" alt="combine" width="400"/>
 
+#### **5 - Final Assembly.**
 
+   You should now have two assemblies; the base, and the x+y bodies.
 
+<img src="images/build_guide/6_start.jpg" alt="combine" width="400"/>
 
+   a) Add the short belts to the x_pulley and m2y_pulley.
 
+   b) Mount the x_body assembly to the base.
+
+   Remember to add a washer between the pulleys and the motor_mount bearings.
 
+<img src="images/build_guide/6_bolts.jpg" alt="combine" width="400"/>
+
+   c) Tighten the long bolts but not too much, as it might break the mounts and enclosures.
+
+   Again you don't want anything to be tight, make sure it all spins smoothly.
+
+<img src="images/build_guide/6_nuts.jpg" alt="combine" width="400"/>
+
+   d) Hook the short belts to the motor pulley.
+
+   You will have to lift the motors up to attach the belt, then tension the belt and tighten the motor screws.
+
+<img src="images/build_guide/6_x_belt.jpg" alt="combine" width="400"/>
+
+   e) This step is just to ensure that the y belt (short) m2y belt (long) don't interfere.
+
+   This is the tightest tolerance in the clinostat.
+
+<img src="images/build_guide/6_tricky.jpg" alt="combine" width="400"/>
+
+   f) Finally, only after installing everything and ensuring both axes rotate smoothly should you tighten the base.
+
+<img src="images/build_guide/6_finito.jpg" alt="combine" width="400"/>
+
+Make sure every pulley and axis rotates smoothly. If there is friction anywhere you might have to loosen the bolts or sand down interference.
 
 ## Electronics
 
+**Note**: be careful with the electronics as they can start a fire! This must be done with adult supervision.
+
 I would recommend building this onto a breadboard so you are comfortable with the pieces before final soldering.
 
 TODO
-