Merge branch 'torsion-springs'

Author: Mercuso

docs/HEAD_MOUNT_ASSEMBLY.md

@@ -1,12 +1,11 @@
 # Head mount assembly
 
 ## Tools
-For this assembly, you need the following tools:
-- Screwdriver
-- 2.5mm  Allen key
+For this assembly, you need the following tools:  
+- Screwdriver  
 
 ## Parts
-Check the complete parts list with detailed description and where to find them in the [PARTS documentation](PARTS.md)    
+Check the complete parts list with detailed description and where to find them in the [PARTS documentation](PARTS.md)  
 
 For this step, you need the following plastic parts:
 - servo_mount (x2)
@@ -15,9 +14,8 @@ For this step, you need the following plastic parts:
 
 Fasteners:
 - M2x8 screws (x2)
-- M3X20 screws (x2)
+- M2X20 screws (x2)
 - M2 nuts (x2)
-- M3 nuts (x2)
 
 Electronics:
 - Micro Servo sg90 servo motor kit (x2)
@@ -26,61 +24,101 @@ Electronics:
 
 Other:
 - silicone brush (x2)
+- torsion spring (x2)
 
 ## Assembly
 
+### Torsion spring preparation
+This is the hardest part of the assembly. The torsion spring legs should be bent by 90 degrees angle as it is shown on the picture
+
+![spring_dimensions](https://github.com/user-attachments/assets/f475abd2-5e5a-442e-8abd-ef8c4ab4f65a)
+
+### Clip preparation
+
+Insert M2 nut into the servo mount clip  
+Use screw to simplify this process. The nut hole is stiff, do not afraid to use force to insert it
+
+![servo_mount_clip_insert_m2_nut](https://github.com/user-attachments/assets/1f66ed0a-fc24-4836-a30b-e63923445708)
+
+Insert the spring into the servo mount clip  
+If the spring leg sticks over the side of the clip, cut it off  
+> [!WARNING]
+> Be careful while cutting off the spring tip. The piece can fly away in unpredictable directions and damage your eyes
+
+![insert_torsion_spring_into_servo_mount_clip](https://github.com/user-attachments/assets/f78bd6d7-50f5-4dd2-9744-0685a4aa84fd)
+![spring_insertion_result](https://github.com/user-attachments/assets/d3db099e-5fbb-41ed-95bf-a614342acbe7)
+
+Align servo mount holes with servo mount clip hole as shown on the picture, the torsion spring leg should come into the servo mount groove
+Cut off the part of the spring leg that sticks outside
+> [!WARNING]
+> Be careful while cutting off the spring tip. The piece can fly away in unpredictable directions and damage your eyes
+
+![join_servo_mount_parts](https://github.com/user-attachments/assets/4f65fec5-5f62-4234-a5be-ca7b982ba9a1)
+
+Join parts with M2X20 screw. Make sure that screw came out into the servo mount hole from the opposite side. Be careful at this moment - if holes are not aligned, the screw can break the bracket  
+Do not overtighten the screw. The parts should move freely
+
+![fix_servo_mount_parts](https://github.com/user-attachments/assets/dd5187e2-640b-4e42-80e9-b4a36666335c)
+
+Repeat the same steps with another servo mount system
+
 ### Clip mounting
 put the plastic clip to the upper part of the headset strap system
-![servo-mount-step-1-1](https://github.com/user-attachments/assets/7f185f6a-f346-43dd-8878-3331bbeff14c)
 
+![clip_mount_s1](https://github.com/user-attachments/assets/1ae62a53-0527-4f06-a204-dc9ebe0c5c53)
 
-insert the nut from the top and screw from the bottom  
+insert the screw from the bottom  
 Tighten the screw  
 > [!WARNING]
 > Be careful, don't damage the headset lenses!
 
-![servo-mount-step-1-2](https://github.com/user-attachments/assets/9143aaf4-5f21-4ac7-93cd-9a43287ea648)
-![servo-mount-step-1-3](https://github.com/user-attachments/assets/d51cf17d-2677-46df-8542-f41b150570b8)
-
+![clip_mount_s2](https://github.com/user-attachments/assets/41b5acbe-54fb-4376-871d-402a4e173e7b)
 
 Do the same on the opposite side
 
-### Fixing the servo motors in the servo mounts
-Insert the motor to the motor mount as it is shown on the picture
-Pay attention to the motor shaft, it should be on the side that is opposite to the supports
-Use the screws to fix it. The screws should be included into the motor kit
-![servo-mount-step-1-4](https://github.com/user-attachments/assets/9da8416c-3f3d-47b9-b896-2445258f8fc9)
-![servo-mount-step-1-5](https://github.com/user-attachments/assets/7af3e982-42a2-42ef-a9bb-ec08caeb8b2a)
+### Servo motors preparation
+This step assumes that the firmware is already uploaded on the ESP-32 board  
+Before fixing servo motors in servo mounts, the motors should be calibrated and then the levers should be fixed in correct position  
 
-Position the servo mount on the clip as it is shown on the picture and insert the screw. Insert the nut from the opposite side. Slightly tighten the screw. The servo mount should rotate freely for the further adjustments
-![servo-mount-step-1-6](https://github.com/user-attachments/assets/38e3784d-770f-4c55-b6d8-88fce4843c08)
-![servo-mount-step-1-7](https://github.com/user-attachments/assets/01e456b3-c5f8-455d-b086-78102153fb15)
-![servo-mount-step-1-8](https://github.com/user-attachments/assets/559bb3f3-3ba7-4b5e-a258-3f90b45cf8ce)
+connect motors to the extension board as shown on the picture. The corresponding line of pins is closer to the side where the motor should be placed  
+Then connect power supply to the board or reload it if it is already connected. The motors shafts should move to the default position once board connected to WiFi network
 
-Connect the motor to the microcontroller. The left servo motor should be connected to P12, right - to P14. Connect the microcontroller to a power source and wait until it connects to the WiFi network
-![servo-mount-step-1-9](https://github.com/user-attachments/assets/17d40793-98be-4f03-8ca9-3f48ff4fe1ce)
+![connect_motors](https://github.com/user-attachments/assets/8329b4f5-1fb6-4b7a-9598-a5676660c201)
 
-Once the connection is established, it should move the motor shaft to its start position
+Put the lever adapter to the lever
 
-Put on the lever adapter. It is needed to attach the silicone brush
 ![servo-mount-step-1-10](https://github.com/user-attachments/assets/2ade0d75-eb10-4c16-8df8-7f4d59f38bf8)
 
-Put on the silicone brush
-![servo-mount-step-1-11](https://github.com/user-attachments/assets/4276da5d-9c46-44d9-b061-24c7825bc241)
+Put the lever to the motor shaft in postion as shown on the picture
+The picture shows the lever position for the left side (right side if you look to a headset from front)
 
-Position the lever as it is shown in the picture below and tighten the screw. This small screw should be included into the motor kit
-![servo-mount-step-1-12](https://github.com/user-attachments/assets/12736c28-6c6a-4394-b3e7-d15bb98fd760)
-![servo-mount-step-1-13](https://github.com/user-attachments/assets/5ecdb903-3cae-4ac5-a060-8a1cb5b7f246)
+![lever_position](https://github.com/user-attachments/assets/d25366bb-54a8-46d6-a342-b4c56e8bdc52)
 
-Repeat same steps for the opposite side. All the parts relative positions should be mirrored
+You can test the lever movement usiing web UI testing tool. Make sure that the lever left and right extreme positions are simmetric
 
-### Final adjustments
-Put on the headset, move down the servo mounts and check the contact with your head during movements. Adjust their position by moving the clips horizontally and rotating the servo mounts. Take out headset and tighten the screws to fix the servo moounts
-![servo-mount-step-1-14](https://github.com/user-attachments/assets/e3ba786c-a002-4317-a7ef-26079a6bbd09)
-![servo-mount-step-1-15](https://github.com/user-attachments/assets/e428a879-900e-4de3-8d35-e54031898c19)
+Adjust the lever position if needed
 
-### Final result
-![servo-mount-step-1-16](https://github.com/user-attachments/assets/4853316f-0fd0-4193-b0ee-1833caf0e85f)
-![servo-mount-step-1-17](https://github.com/user-attachments/assets/23313ad3-3d1b-4337-8863-fd12ab3436be)
-![servo-mount-step-1-18](https://github.com/user-attachments/assets/a0aabb1b-0e08-4108-ac25-18561791dd73)
+Fix the lever on the motor shaft using the small screw from the motor kit
+
+![fix_lever](https://github.com/user-attachments/assets/8b49d809-bfc5-44dc-818c-e0b755313c3a)
+
+### Fixing the servo motors in the servo mounts
+Insert the motor to the motor mount as it is shown on the picture  
+Pay attention to the motor shaft, it should be on the side that is opposite to the supports  
+
+![insert_motor](https://github.com/user-attachments/assets/e4d13483-400a-4a10-a3c3-ab0cf3f04375)
 
+Use the screws to fix it. The screws should be included into the motor kit 
+
+![fix_motor](https://github.com/user-attachments/assets/3f636ad9-7ab1-453e-bace-ef1880fb41d8)
+
+Put on the silicone brush
+
+![put_on_brush](https://github.com/user-attachments/assets/83e4d8c4-f8d3-428c-957f-8c610845ea83)
+
+Repeat same steps for the opposite side
+
+### Final result
+![final_result_up](https://github.com/user-attachments/assets/5a97388b-4c72-4012-9e18-35af111299e0)
+![final_result_profile](https://github.com/user-attachments/assets/d0c5ea6c-4eef-4e2c-9f93-af289d4918ae)
+![final_result_front](https://github.com/user-attachments/assets/bdb409ea-2412-40c6-8525-c2140daa98bb)

docs/PARTS.md

@@ -45,6 +45,15 @@ Link to the device: https://www.aliexpress.com/item/1005005692082758.html
 The brushes can be easily removed without damaging anything, so this device remains operational  
 If you found the similiar silicone brushes that can be bought standalone - please let me know!  
 
+## Torsion springs
+Can be bought somewhere (for example, [on Aliexpress](https://www.aliexpress.com/item/1005007436082760.html)) or taken off from a hair clamp that have torsion spring  
+Required dimensions:  
+External diameter - 3.8-4mm  
+Number of laps - up to 8  
+Wire diameter - 0.7mm  
+The number of laps can vary, depending on desired pressure of a brush to a head  
+You can also try to experiment with other parameters. The main requirement - the internal diameter should be slightly bigger than 2mm to be able to insert the screw that works as an axis
+
 ## Printable parts
 The following parts can be printed on FDM printer: