ASSEMBLING.md

@@ -0,0 +1,62 @@
+# DotBot Assembling manual
+
+This document will guide you through the DotBot assembling workflow.
+
+## Material & Tools
+
+Make sure you have all required [components](./COMPONENTS.md) and that you
+eventually followed the [compopent preparation](PREPARING.md), if needed.
+
+You will just require access to an Allen screwdriver (1.5mm).
+
+<div align="center">
+  <img src="dist/images/DotBot-pcb-prepared.jpg" height="250px" alt="PCB prepared"/>
+  <img src="dist/images/DotBot-components.jpg" height="250px" alt="DotBot components"/>
+</div>
+
+## Let's go!
+
+1. Start by mounting the ball caster. For this step, you need:
+  - 2x 10mm M2 screws
+  - 1x Pololu ball caster
+  - 1x Pololu ball caster holder
+  - 1x Pololu ball caster spacer
+
+  <div align="center">
+    <img src="dist/images/DotBot-ball-caster-assembling.jpg" width="200px" alt="Ball caster assembling"/>
+  </div>
+
+  Once done it should look like this:
+
+  <div align="center">
+    <img src="dist/images/DotBot-ball-caster-mounted.jpg" width="200px" alt="Ball caster assembling"/>
+  </div>
+
+2. Mount the motors. For this step, you need:
+  - 4x 5mm M2 screws
+  - 2x motor holders
+  - 1x left motor (the one with the **black** wire soldered on the `+` pad)
+  - 1x right motor (the one with the **red** wire soldered on the `+` pad)
+
+  1. Place one of the motor in the holder, on the corresponding side (left or
+    right) of the PCB. It is important that the red wire is on **top** and on the
+    **read** side, regardless if it's the right or left motor:
+    <div align="center">
+      <img src="dist/images/DotBot-motor-with-holder.jpg" width="200px" alt="Ball caster assembling"/>
+    </div>
+  2. Screw the motor:
+    <div align="center">
+      <img src="dist/images/DotBot-motor-with-holder-mounted.jpg" width="200px" alt="Ball caster assembling"/>
+    </div>
+  3. Repeat the operation for the other motor. You should end up with the
+     following setup:
+    <div align="center">
+      <img src="dist/images/DotBot-mounted-without-wheels.jpg" width="200px" alt="Ball caster assembling"/>
+    </div>
+
+3. And last but not least, plug the JST connectors and put the wheels on the
+  motor shafts and you are done!
+
+<div align="center">
+  <img src="dist/images/DotBot-mounted.jpg" width="500px" alt="Ball caster assembling"/>
+</div>

COMPONENTS.md

@@ -0,0 +1,90 @@
+# DotBot required components
+
+## PCBs
+
+- 1x main PCB that you have to manufacture only. Some manufacturers offers
+  complete manufacturing that includes PCB and assembling the electronic
+  components. So you end-up with this:
+  <div align="center">
+    <img src="dist/images/DotBot-pcb-layout.png" width="40%" height="40%" alt="3D PCB"/>
+  </div>
+
+- (optional) 1x LH2 shield PCB
+
+  <div align="center">
+    <img src="dist/images/DotBot-lh2-pcb-layout.png" width="40%" height="40%" alt="3D LH2 PCB"/>
+  </div>
+
+## 3D printed parts
+
+For the first 3, you can also use the [3D manufacturing file](parts/DotBot-parts.3mf)
+with your 3D printer (PLA) to print them.
+
+<p align="center">
+  <img src="dist/images/DotBot-3d-printed-parts.jpg" width="200px" alt="3D printed parts"/>
+</p>
+
+- 2x PLA motor holders, [step file](parts/DotBot-motor-holder.stl)
+
+- 1x PLA ball caster spacer, [step file](parts/DotBot-ball-caster-spacer.stl)
+
+- 1x PLA ball caster holder, [step file](parts/DotBot-ball-caster-holder.stl)
+
+- (optional) 2x PLA wheel rims, [step file](parts/DotBot-wheel-rim.stl), [3mf](parts/DotBot-wheel-rims.3mf)
+
+- (optional) 2x TPE/TPU wheel tires, [step file](parts/DotBot-wheel-tire.stl), [3mf](parts/DotBot-wheel-rims.3mf)
+
+## Pololu parts
+
+- 2x Pololu 6V DC motors with 51:1 ratio, [Pololu](https://www.pololu.com/product/2379)
+
+- 1x ball caster, [Pololu](https://www.pololu.com/product/951)
+
+- 2x magnetic encoder disks, [Pololu](https://www.pololu.com/product/2599)
+
+- (optional if not using the 3D printed wheels) 2x 40x7mm diameter wheels,
+  [Pololu](https://www.pololu.com/product/1454)
+
+## Other parts
+
+- 6x threaded inserts, [Digikey](https://www.digikey.com/short/3n0vdhcv)
+
+- 4x M2 5mm long Allen screws with cylindrical head
+
+- 2x M2 10mm long Allen screws with cylindrical head
+
+- 2x 2 pins micro JST 2.0 male/female connectors, [Amazon](https://a.co/d/23qn1P9)
+
+## Estimated price
+
+We give a rough estimation (as of end of 2023) of the total price of a DotBot
+(unit price when mass producing 1k bots). Buying the motors or wheels on Pololu
+is safe but is also more expensive. For motors, it is possible to find cheaper
+and compatible alternatives with Chinese resellers. For wheels, 3D printing
+them is possible (see [COMPONENTS](COMPONENTS.md#3d-printed-parts)), much
+cheaper and fun.
+
+| Component             | Unit price ($) | # |          Total |
+| :-------------------- | -------------: | - | -------------: |
+| main PCB components   |          28.10 | 1 |          28.10 |
+| main PCB fab          |           5.00 | 1 |           5.00 |
+| shield PCB components |          18.65 | 1 |          18.65 |
+| shield PCB fab        |           1.00 | 1 |           1.00 |
+| motor                 |          16.31 | 2 |          32.62 |
+| motor (china)         |           3.00 | 2 |           6.00 |
+| ball caster           |           1.94 | 1 |           1.94 |
+| magnetic disk         |           0.45 | 2 |           0.90 |
+| JST connector         |           0.42 | 2 |           0.84 |
+| wheel (pair)          |           4.19 | 1 |           4.19 |
+| 5mm screw             |           0.15 | 4 |           0.60 |
+| 10mm screw            |           0.15 | 2 |           0.30 |
+| threaded inserts      |           0.10 | 6 |           0.60 |
+|                       |                |   | Total 1: 44.28 |
+|                       |                |   | Total 2: 63.93 |
+|                       |                |   | Total 3: 75.09 |
+|                       |                |   | Total 4: 94.74 |
+
+- **Total 1**: main PCB only, 3D printed wheels, chinese motors
+- **Total 2**: main and shield PCBs, 3D printed wheels, chinese motors
+- **Total 3**: main PCB only, Pololu motors and wheels
+- **Total 4**: main and shield PCBs, Pololu motors and wheels