Update the 3d printing guide.

doublehan07 · doublehan07 · commit 14c63ca4654b · 2025-06-22T10:32:20.000-07:00
diff --git a/docs/_static/quick_start/3d_print/1_makerworld.jpg b/docs/_static/quick_start/3d_print/1_makerworld.jpg
diff --git a/docs/chapters/getting_started.md b/docs/chapters/getting_started.md
@@ -5,7 +5,7 @@
 :maxdepth: 1
 
 ../quick_start/01_pcba.rst
-../quick_start/02_3d_print.md
+../quick_start/02_3d_print.rst
 ../quick_start/03_flash_firmware.md
 ../quick_start/04_assemble_glove.md
 ../quick_start/05_make_it_move.md
@@ -15,7 +15,7 @@
 
 1. Check our [hardware bill of materials (BOM)](#hardware-bill-of-materials) to make sure you have everything.
 2. [Order the PCBA](../quick_start/01_pcba.rst).
-3. [Print the mechanical structures](../quick_start/02_3d_print).
+3. [Print the mechanical structures](../quick_start/02_3d_print.rst).
 4. The whole system has been tested under **Ubuntu 20.04**.
 
 (hardware-bill-of-materials)=
@@ -24,10 +24,10 @@
 | Component                                | Quantity | Purchase Link | Purchase Link (China) |
 | :--------------------------------------- | -------: | :------------ | :-------------------- |
 | **3D Print Filament**                    |          |               |                       |
-| Bambu PETG Basic (Gold)                  |        1 |[Bambu Store](https://us.store.bambulab.com/products/petg-hf?id=42735939649672)|[JD](https://item.jd.com/10076951987144.html)|
-| Bambu PETG HF (White)                    |        1 |[Bambu Store](https://us.store.bambulab.com/products/petg-hf?id=42735939846280)|[JD](https://item.jd.com/10098873650763.html)|
-| Bambu Support for PLA/PETG               |        1 |[Bambu Store](https://us.store.bambulab.com/products/support-for-pla-petg)|[JD](https://item.jd.com/10100641558676.html)|
-| Bambu TPU for AMS (White)                |        1 |[Bambu Store](https://us.store.bambulab.com/products/tpu-for-ams?id=43059884720264)|[JD](https://item.jd.com/10120952202960.html)|
+| Bambu PETG Basic (Gold)                  |        1 |[Bambu Store](https://us.store.bambulab.com/products/petg-hf?id=42735939649672)|[Taobao](https://detail.tmall.com/item.htm?id=816799102364)|
+| Bambu PETG HF (White)                    |        1 |[Bambu Store](https://us.store.bambulab.com/products/petg-hf?id=42735939846280)|[Taobao](https://detail.tmall.com/item.htm?id=816799102364)|
+| Bambu Support for PLA/PETG               |        1 |[Bambu Store](https://us.store.bambulab.com/products/support-for-pla-petg)|[Taobao](https://detail.tmall.com/item.htm?abbucket=9&id=813808728827)|
+| Bambu TPU for AMS (White)                |        1 |[Bambu Store](https://us.store.bambulab.com/products/tpu-for-ams?id=43059884720264)|[Taobao](https://detail.tmall.com/item.htm?abbucket=9&id=847975695749&skuId=5633828620351)|
 | **Dynamixel Parts**                      |          |               |                       |
 | Dynamixel XC330-M288-T                   |        2 |[Dynamixel Store](https://www.robotis.us/dynamixel-xc330-m288-t/)|[Taobao](https://item.taobao.com/item.htm?_u=m2pu41081584&id=660146504579&skuId=4941606395637)|
 | Dynamixel XL330-M288-T                   |        3 |[Dynamixel Store](https://www.robotis.us/dynamixel-xl330-m288-t/)|[Taobao](https://item.taobao.com/item.htm?_u=m2pu410853f0&id=648175925849)|
diff --git a/docs/chapters/the_software.md b/docs/chapters/the_software.md
@@ -1,3 +1,25 @@
 # Software
 
-🚀 Content coming soon. Thanks for your patience!
+## communication between pc and board
+uart package
+vibration package
+udp
+
+## servo datapath
+udp
+
+## haptic+force feedback
+readings from the force sensor
+threshold to enable force feedback (servo.torque enable)
+    - to adjust the stiffness of force feedback, simply adjust the Kp
+threshold to enable vibration (glove_mcu -> send vibration command)
+    - to adjust the vibration pattern (command -> ti library), duration
+
+## pink fk and ik
+add site name at xml files
+
+## the scale factor
+The goal is to maintain consistency: when thumb and index touched in the real world, the thumb and index of the dexterous hand should also be touched together.
+
+finger length discrepancy -> scale
+finger distance discrepancy -> shift
diff --git a/docs/hardware/02_mechanical.md b/docs/hardware/02_mechanical.md
@@ -7,3 +7,7 @@ You can view the 3D model of DOGlove on Onshape. The model can be exported to So
 ![Onshape Model Preview](../_static/hardware/onshape_model.jpg)
 
 
+## Linkage length
+current design length (table)
+solidwords screenshots (hole to hole distance)
+improper length lead to failure
diff --git a/docs/quick_start/02_3d_print.md b/docs/quick_start/02_3d_print.md
diff --git a/docs/quick_start/02_3d_print.rst b/docs/quick_start/02_3d_print.rst
@@ -0,0 +1,81 @@
+3D Printing Guide
+===================
+
+This guide is optimized for the **Bambu P1S Combo (P1SC)** printer using official Bambu filaments.
+
+Materials List
+--------------
+
+.. list-table::
+   :header-rows: 1
+   :widths: 30 10 30 30
+
+   * - Component
+     - Quantity
+     - Purchase Link
+     - Purchase Link (China)
+   * - **3D Print Filament**
+     - 
+     - 
+     - 
+   * - Bambu PETG Basic (Gold)
+     - 1
+     - `Bambu PETG Basic Gold <https://us.store.bambulab.com/products/petg-hf?id=42735939649672>`_
+     - `Taobao PETG Basic <https://detail.tmall.com/item.htm?id=816799102364>`_
+   * - Bambu PETG HF (White)
+     - 1
+     - `Bambu PETG HF White <https://us.store.bambulab.com/products/petg-hf?id=42735939846280>`_
+     - `Taobao PETG HF <https://detail.tmall.com/item.htm?id=816799102364>`_
+   * - Bambu Support for PLA/PETG
+     - 1
+     - `Bambu Support <https://us.store.bambulab.com/products/support-for-pla-petg>`_
+     - `Taobao Support <https://detail.tmall.com/item.htm?abbucket=9&id=813808728827>`_
+   * - Bambu TPU for AMS (White)
+     - 1
+     - `Bambu TPU <https://us.store.bambulab.com/products/tpu-for-ams?id=43059884720264>`_
+     - `Taobao TPU <https://detail.tmall.com/item.htm?abbucket=9&id=847975695749&skuId=5633828620351>`_
+
+Printing with Bambu Studio
+--------------------------
+
+If you're using a Bambu printer:
+
+#. Visit our `MakerWorld model page <https://makerworld.com/en/models/1476400-doglove#profileId-1541008>`_.
+#. Click **Open in Bambu Studio**.
+#. Match the filament colors with those loaded in your AMS.
+#. Start the print.
+
+.. image:: ../_static/quick_start/3d_print/1_makerworld.jpg
+
+.. tip::
+
+   We recommend using **Bambu Liquid Glue for Build Plate** to improve first-layer adhesion.
+
+   `Buy here <https://us.store.bambulab.com/products/liquid-glue-for-build-plate>`_, `购买链接 <https://detail.tmall.com/item.htm?abbucket=13&detail_redpacket_pop=true&id=698882119427>`_
+
+.. note::
+
+   Bambu PETG Basic (Gold) may be out of stock.
+
+   You can substitute it with Bambu PETG HF (Yellow) or any other PETG HF color of your choice.
+
+Printing on Non-Bambu Printers
+------------------------------
+
+For users of other 3D printers, here are some material and profile suggestions:
+
+- **Joints & Fingers**: PETG
+
+  - Use a strong-print profile: 50% sparse infill, 50% infill/wall overlap, 10 wall loops
+
+- **Palm**: PETG or PLA
+
+  - Use a standard print profile: low infill density and fewer wall loops to reduce weight
+
+- **TPU Components**: Use the softest TPU possible for comfort when contacting the skin
+
+.. note::
+
+   Bambu AMS supports TPU 68D.
+
+   If your printer allows, consider softer filaments like TPU 90A or TPU 85A.
diff --git a/docs/quick_start/03_flash_firmware.md b/docs/quick_start/03_flash_firmware.md
@@ -1,2 +1,11 @@
 # Flash the Firmware
-🚀 Content coming soon. Thanks for your patience!
+First you need to download the latest firmware here[GitHub release].
+
+Then you need tool to flash the firmware into the STM32 MCU(Micro controllers).
+
+For Windows, you may use [STM32Programmar], for MacOS and Ubuntu, we suggest [openocd].
+
+pip install openocd
+openocd flash xxxxxx
+
+If everything goes well, you might see 'flash verify ok' notice.
diff --git a/docs/quick_start/04_assemble_glove.md b/docs/quick_start/04_assemble_glove.md
@@ -1,2 +1,16 @@
 # Glove Assembly
-🚀 Content coming soon. Thanks for your patience!
+1. Prepare the cables
+./cable.mp4
+
+2. Solder the encoders
+./encoder.mp4
+
+[Notice:] For soldering tips, you may check [YouTube] tutorials.
+
+3. Assemble the index/middle/ring/pinky joint
+
+4. Assemble the thumb joint
+
+5. Assemble the palm
+
+6. Wrap the cable
diff --git a/docs/quick_start/05_make_it_move.md b/docs/quick_start/05_make_it_move.md
@@ -1,2 +1,7 @@
 # Make it Move
-🚀 Content coming soon. Thanks for your patience!
+1. Wire connection
+- encoder datapath
+- servo datapath
+- power tree
+2. Status LED check
+3. test script
