diff --git a/README.md b/README.md
index 8b0e44c..88e47b5 100644
--- a/README.md
+++ b/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:
diff --git a/docs/1_documentation.md b/docs/1_documentation.md
index d358356..18a9289 100644
--- a/docs/1_documentation.md
+++ b/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
diff --git a/docs/2_BOM.md b/docs/2_BOM.md
index 763d395..6729ce5 100644
--- a/docs/2_BOM.md
+++ b/docs/2_BOM.md
@@ -6,10 +6,10 @@
- #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
@@ -17,7 +17,7 @@ Hardware
- #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
diff --git a/docs/3_build_guide.md b/docs/3_build_guide.md
index d0f2547..fe93260 100644
--- a/docs/3_build_guide.md
+++ b/docs/3_build_guide.md
@@ -1,13 +1,22 @@
# OpenClino Build Guide
+
-![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.
+
+
+
+#### **2 - Combiningx and y bodies.**
+
+ a) Push fit bearings to the y_guide and the x body.
+
+
+
+ b) Install bolts through the x and y body, make sure to put a washer on each side of the bearing.
+
+
+
+ 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.
+
+
- 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!
+
- 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!
+
- 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.
+
+
- 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.
+
+
+ #### **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!
+
- 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.
+
+
- 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.
+
- 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
+
+ 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!
+
+#### **5 - Final Assembly.**
+ You should now have two assemblies; the base, and the x+y bodies.
+
+ 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.
+
+
+ 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.
+
+
+
+ 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.
+
+
+
+ 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.
+
+
+
+ f) Finally, only after installing everything and ensuring both axes rotate smoothly should you tighten the base.
+
+
+
+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
-
diff --git a/docs/images/build_guide/exploded_view.jpg b/docs/images/build_guide/0_exploded_view.jpg
similarity index 100%
rename from docs/images/build_guide/exploded_view.jpg
rename to docs/images/build_guide/0_exploded_view.jpg
diff --git a/docs/images/build_guide/1_y_turn.jpg b/docs/images/build_guide/1_y_turn.jpg
new file mode 100644
index 0000000..d99a15a
Binary files /dev/null and b/docs/images/build_guide/1_y_turn.jpg differ
diff --git a/docs/images/build_guide/2_combine.jpg b/docs/images/build_guide/2_combine.jpg
new file mode 100644
index 0000000..abe9e82
Binary files /dev/null and b/docs/images/build_guide/2_combine.jpg differ
diff --git a/docs/images/build_guide/3_bolt.jpg b/docs/images/build_guide/3_bolt.jpg
new file mode 100644
index 0000000..3dfbfd7
Binary files /dev/null and b/docs/images/build_guide/3_bolt.jpg differ
diff --git a/docs/images/build_guide/3_y_guide.jpg b/docs/images/build_guide/3_y_guide.jpg
new file mode 100644
index 0000000..e575ef5
Binary files /dev/null and b/docs/images/build_guide/3_y_guide.jpg differ
diff --git a/docs/images/build_guide/3_y_turn.jpg b/docs/images/build_guide/3_y_turn.jpg
new file mode 100644
index 0000000..37c0dea
Binary files /dev/null and b/docs/images/build_guide/3_y_turn.jpg differ
diff --git a/docs/images/build_guide/4_combined.jpg b/docs/images/build_guide/4_combined.jpg
new file mode 100644
index 0000000..535ac2e
Binary files /dev/null and b/docs/images/build_guide/4_combined.jpg differ
diff --git a/docs/images/build_guide/4_x_pulley.jpg b/docs/images/build_guide/4_x_pulley.jpg
new file mode 100644
index 0000000..f1f57b9
Binary files /dev/null and b/docs/images/build_guide/4_x_pulley.jpg differ