setup guide

documentation/setup_guide.md

@@ -1,13 +0,0 @@
-# Troubleshooting Common Problems
-
-## Checklist for New Devices
-
-1. **Was the mechanical limit pin added to the rotor?**  
-   This pin is required for proper homing of the device.
-
-2. **Are the screws that secure the rotor to the motor shaft installed?**  
-   If the rotor is not firmly attached, it may slip slightly during homing or other movements, which can lead to positioning errors.
-
-3. **Is the homing direction correct?**  
-   During the homing command (`G28`), the end effector should move toward the base.  
-   If it moves in the opposite direction, rewire the motor to reverse its direction.

documentation/setup_guide/setup_guide.md

@@ -0,0 +1,30 @@
+# Setup Guide
+
+This guide walks you through the setup of your new **Open Micro-Manipulator** device.
+
+## Checklist for New Devices
+
+1. **Was the mechanical limit pin added to the rotor?**  
+   This pin is required for proper homing of the device.
+
+<div style="display: flex;">
+    <img src="mechanical_limit_pin.jpg" alt="Mechanical Limit Pin" width="20%">
+</div>
+
+
+2. **Are the screws that secure the rotor to the motor shaft installed?**  
+   If the rotor is not firmly attached, it may slip imperceptibly during homing or other movements, leading to problems during calibration and homing.
+
+3. **Is the homing direction correct?**  
+   During the homing command (`G28`), the end effector should move toward the base.  
+   If it moves in the opposite direction, rewire the motor to reverse its direction.
+
+
+## Calibration and Checking the Encoders
+
+You can use the calibration plotter to check if your encoders are working as expected.
+On the left you see a good calibration on the right a bad calibration.
+<div style="display: flex; gap: 2%;">
+  <img src="good_calibration.jpg" alt="GoodCalibration" width="49%">
+  <img src="bad_calibration.jpg" alt="BadCalibration" width="49%">
+</div>