Adjust slim body, organize files (#52)

- Adjust slim body to fit on 220x220mm build plate
- Organize CAD models into folders
- Organize PCB files into folders

README.md

@@ -30,3 +30,7 @@ Please cite our [paper](docs/paper/OpenBot.pdf) if you use OpenBot.
 ## Video
 
 [![OpenBot Video](https://img.youtube.com/vi/qc8hFLyWDOM/0.jpg)](https://www.youtube.com/watch?v=qc8hFLyWDOM)
+
+## Contact
+- Join our [Slack](https://join.slack.com/t/openbot-community/shared_invite/zt-hpso8cfl-JO9OVhVMdUWvR4vDXwcMGA) channel to connect with the OpenBot community. 
+- Contact us via [Email](mailto:openbot.team@gmail.com)

body/README.md

@@ -8,10 +8,14 @@ We have designed a body for a wheeled robot which relies on low-cost, readily av
 
 ## 3D printed chassis
 You will need to print the following parts in order to build your OpenBot. 
-1) body_bottom ([STL](body_bottom.stl), [STEP](body_bottom.step))
-2) body_top ([STL](body_top.stl), [STEP](body_top.step))
-3) phone_mount_bottom ([STL](phone_mount_bottom.stl), [STEP](phone_mount_bottom.step))
-4) phone_mount_top ([STL](phone_mount_top.stl), [STEP](phone_mount_top.step))
+1) body_bottom ([STL](cad/regular_body/body_bottom.stl), [STEP](cad/regular_body/body_bottom.step))
+2) body_top ([STL](cad/regular_body/body_top.stl), [STEP](cad/regular_body/body_top.step))
+3) phone_mount_bottom ([STL](cad/phone_mount/phone_mount_bottom.stl), [STEP](cad/phone_mount/phone_mount_bottom.step))
+4) phone_mount_top ([STL](cad/phone_mount/phone_mount_top.stl), [STEP](cad/phone_mount/phone_mount_top.step))
+
+Since a lot of common 3D printers have a smaller build volume, we have also made a [slim body](cad/slim_body/README.md) which fits on a 220mmx220mm build plate at 45 degrees.
+
+For printing on 3D printers with even smaller build volumes, there is also a [glueable body](cad/glue_body/README.md) which fits on a 150mmx140mm build plate. Thanks to @sloretz.
 
 On an Ultimaker S5, we achieved good results with the following settings:
 - layer height: 0.2mm
@@ -23,10 +27,6 @@ On an Ultimaker S5, we achieved good results with the following settings:
 
 We were able to print the chassis with PLA, ABS and CPE. In our experience the print was not affected very much by the print settings. However, if you have the patience, printing slower and with smaller layer height will improve the print. Also adding a support structure can improve the print, but it will require additional work to remove afterwards.
 
-Since a lot of common 3D printers have a smaller build volume, we have also made a [body_bottom_slim.stl](body_bottom_slim.stl) and [body_top_slim.stl](body_top_slim.stl) which fit on a 223x223 build plate at 45 degrees. These have not been tested, but should work fine.
-
-There is also [a version meant to be glued together](glueable_body/README.md) for printing on 3D printers with even smaller build volumes.
-
 ## Bill of materials
 
 
@@ -92,15 +92,15 @@ WARNING: The PCB was updated to version 2 and not yet tested. Here are the chang
 - Update voltage divider to 20k/10k for better precision
 - Change motor connectors to upright version for easier access
 
-If you have already ordered version 1 of the PCB ([2D view](../docs/images/pcb_2d_v1.png), [3D view](../docs/images/pcb_3d_v1.png)), you will need to adjust the firmware to read the speed sensors manually. See this [issue](https://github.com/intel-isl/OpenBot/issues/34) for more info.
+If you have already ordered [version 1](pcb/v1) of the PCB ([2D view](../docs/images/pcb_2d_v1.png), [3D view](../docs/images/pcb_3d_v1.png)), you will need to adjust the firmware to read the speed sensors manually. See this [issue](https://github.com/intel-isl/OpenBot/issues/34) for more info.
 
 The custom PCB involves the following steps:
-1) **Order the PCB**: Download the [Gerber](gerber_v2.zip) files and order the PCB at the vendor of your choice. You can also order the PCB directly on [PCBWay](https://www.pcbway.com/project/shareproject/OpenBot__Turning_Smartphones_into_Robots.html) where we have shared a project for OpenBot.
-2) **Order the components:** Download the [BOM](BOM_v2.csv) and order the compenents at the vendor of your choice, for example [LCSC](https://lcsc.com).
-3) **Assembly of the PCB:** You can either assemble the PCB yourself or have them assembled by a vendor. For automated assembly you will need the [Centroid File](centroid_file_v2.csv)
+1) **Order the PCB**: Download the [Gerber](pcb/v2/gerber_v2.zip) files and order the PCB at the vendor of your choice. You can also order the PCB directly on [PCBWay](https://www.pcbway.com/project/shareproject/OpenBot__Turning_Smartphones_into_Robots.html) where we have shared a project for OpenBot.
+2) **Order the components:** Download the [BOM](pcb/v2/BOM_v2.csv) and order the compenents at the vendor of your choice, for example [LCSC](https://lcsc.com).
+3) **Assembly of the PCB:** You can either assemble the PCB yourself or have them assembled by a vendor. For automated assembly you will need the [Centroid File](pcb/v2/centroid_file_v2.csv)
 
 You can also find vendors that will provide you a TurnKey solution covering all 3 steps. They will manufacture the PCB, source the components and assemble the PCB. This is very convenient and also not too expensive. However, delivery times are often very long (1-3 months). 
 
 When requesting a quote at [PCBWay](https://www.pcbway.com/orderonline.aspx), you can select the assembly service after uploading the Gerber file. 
 ![Assembly Service](../docs/images/assembly_service.jpg)
-In the next step, you will need to upload the [BOM](BOM.csv) and the [Centroid File](centroid_file.csv). Your quote will then be reviewed and updated within a few days. You can then choose to proceed with payment after reviewing cost and delivery time. 
+In the next step, you will need to upload the [BOM](pcb/v2/BOM_v2.csv) and the [Centroid File](pcb/v2/centroid_file_v2.csv). Your quote will then be reviewed and updated within a few days. You can then choose to proceed with payment after reviewing cost and delivery time. 

body/README_CN.md

@@ -6,10 +6,10 @@
 ## 3D打印机身
 您将需要打印以下部分用来组装您的OpenBot机器车。
 
-1) 车身底部 ([STL](body_bottom.stl), [STEP](body_bottom.step))
-2) 车身顶部 ([STL](body_top.stl), [STEP](body_top.step))
-3) 手机支架底部 ([STL](phone_mount_bottom.stl), [STEP](phone_mount_bottom.step))
-4) 手机支架顶部 ([STL](phone_mount_top.stl), [STEP](phone_mount_top.step))
+1) 车身底部 ([STL](cad/body_bottom.stl), [STEP](cad/body_bottom.step))
+2) 车身顶部 ([STL](cad/body_top.stl), [STEP](cad/body_top.step))
+3) 手机支架底部 ([STL](cad/phone_mount_bottom.stl), [STEP](cad/phone_mount_bottom.step))
+4) 手机支架顶部 ([STL](cad/phone_mount_top.stl), [STEP](cad/phone_mount_top.step))
 
 在Ultimaker S5上，我们通过以下设置获得了良好的效果：
 
@@ -22,7 +22,7 @@
 
 我们能够使用PLA，ABS和CPE打印机箱。 根据我们的经验，打印不受打印设置的影响很大。 但是，如果您有耐心，则打印速度较慢且层高度较小的纸张会改善打印质量。 另外，添加支撑结构可以改善打印效果，但是之后需要进行额外的工作才能删除。
 
-由于许多常见的3D打印机的构建体积较小，因此我们还制作了一个[body_bottom_slim.stl](./body_bottom_slim.stl) 和[body_top_slim.stl](./body_top_slim.stl)，它们以45度安装在223x223构建板上。 这些未经测试，但应该可以正常工作。
+由于许多常见的3D打印机的构建体积较小，因此我们还制作了一个[body_bottom_slim.stl](./cad/slim_body/slim_body_bottom.stl) 和[body_top_slim.stl](./cad/slim_body/body_top_slim.stl)，它们以45度安装在220x220构建板上。 这些未经测试，但应该可以正常工作。
 
 ## 配件购买：
 
@@ -132,14 +132,14 @@
 如果您已经订购了版本1的PCB（[2D视图]（../docs/images/pcb_2d_v1.png），[3D视图]（../docs/images/pcb_3d_v1.png))，则需要 调整固件以手动读取速度传感器。 有关更多信息，请参见此[issue]（https://github.com/intel-isl/OpenBot/issues/34)。
 
 定制PCB包括以下步骤:
-1) **购买 PCB**: 下载[Gerber](gerber_v2.zip) 文件 并选择供应商处订购PCB。 你也可以直接在[PCBWay](https://www.pcbway.com/project/shareproject/OpenBot__Turning_Smartphones_into_Robots.html)上订购PCB，在那里我们共享了一个OpenBot项目。
-2) **订购组件:** 下载[BOM](BOM_v2.csv)并在您选择的供应商处订购组件，例如[LCSC](https://lcsc.com)。
-3) **PCB组装:** 你可以自己组装PCB，也可以让供应商来组装。对于自动装配，您将需要[Centroid文件](centroid_file_v2.csv)
+1) **购买 PCB**: 下载[Gerber](pcb/v2/gerber_v2.zip) 文件 并选择供应商处订购PCB。 你也可以直接在[PCBWay](https://www.pcbway.com/project/shareproject/OpenBot__Turning_Smartphones_into_Robots.html)上订购PCB，在那里我们共享了一个OpenBot项目。
+2) **订购组件:** 下载[BOM](pcb/v2/BOM_v2.csv)并在您选择的供应商处订购组件，例如[LCSC](https://lcsc.com)。
+3) **PCB组装:** 你可以自己组装PCB，也可以让供应商来组装。对于自动装配，您将需要[Centroid文件](pcb/v2/centroid_file_v2.csv)
 
 您还可以找到供应商，他们将为您提供涵盖所有3个步骤的全套解决方案。他们将生产PCB，提供组件和组装PCB。这非常方便，也不太贵。然而，交货时间通常很长(1-3个月)。
 
 当在[PCBWay](https://www.pcbway.com/orderonline.aspx)请求报价时，您可以在上传Gerber文件后选择组装服务。
 
 ![Assembly Service](../docs/images/assembly_service.jpg)
 
-在下一步中，您将需要上传[BOM](BOM.csv)和[Centroid File](centroid_file.csv)。 您的报价将在几天之内进行审核和更新。 然后，您可以在查看成本和交货时间后选择继续付款。
+在下一步中，您将需要上传[BOM](pcb/v2/BOM_v2.csv)和[Centroid File](pcb/v2/centroid_file_v2.csv)。 您的报价将在几天之内进行审核和更新。 然后，您可以在查看成本和交货时间后选择继续付款。

body/cad/glue_body/README.md

@@ -0,0 +1,24 @@
+# Glueable Body
+
+Some 3D printers have build volumes that are too small to print the full size OpenBot body.
+This folder contains the OpenBot body split into 4 pieces.
+It can be printed with a build plate as small as 150mmx140mm, and then glued together.
+
+![Glueable Body](../../../docs/images/glue_body.jpg)
+
+## Parts
+
+Required parts:
+
+1) `glue_body_bottom_A` ([STL](glue_body_bottom_A.stl), [STEP](glue_body_bottom_A.step))
+2) `glue_body_bottom_B` ([STL](glue_body_bottom_B.stl), [STEP](glue_body_bottom_B.step))
+3) `glue_body_top_A` ([STL](glue_body_top_A.stl), [STEP](glue_body_top_A.step))
+4) `glue_body_top_B` ([STL](glue_body_top_B.stl), [STEP](glue_body_top_B.step))
+
+Optional parts:
+
+These pieces give extra surface area for gluing, which can help if your print experiences warping.
+
+* `glue_connector_bottom` ([STL](glue_connector_bottom.stl), [STEP](glue_connector_bottom.step))
+* `glue_connector_top_A` ([STL](glue_connector_top_A.stl), [STEP](glue_connector_top_A.step))
+* `glue_connector_top_B` ([STL](glue_connector_top_B.stl), [STEP](glue_connector_top_B.step))

body/phone_mount_bottom.step → body/cad/phone_mount/phone_mount_bottom.step

@@ -10,7 +10,7 @@ FILE_DESCRIPTION(
 
 FILE_NAME(
 /* name */ 
-'/Users/matthia1/Documents/Github/OpenBot/body/phone_mount_bottom.step',
+'phone_mount_bottom.step',
 
 /* time_stamp */ '2020-09-10T14:04:38+02:00',
 /* author */ (''),

body/phone_mount_top.step → body/cad/phone_mount/phone_mount_top.step

@@ -10,7 +10,7 @@ FILE_DESCRIPTION(
 
 FILE_NAME(
 /* name */ 
-'/Users/matthia1/Documents/Github/OpenBot/body/phone_mount_top.step',
+'phone_mount_top.step',
 /* time_stamp */ '2020-09-10T14:04:59+02:00',
 /* author */ (''),
 /* organization */ (''),

body/body_bottom.step → body/cad/regular_body/body_bottom.step

@@ -10,7 +10,7 @@ FILE_DESCRIPTION(
 
 FILE_NAME(
 /* name */ 
-'/Users/matthia1/Documents/Github/OpenBot/body/body_bottom.step',
+'body_bottom.step',
 /* time_stamp */ '2020-08-29T02:03:10+02:00',
 /* author */ (''),
 /* organization */ (''),

body/body_top.step → body/cad/regular_body/body_top.step

@@ -10,7 +10,7 @@ FILE_DESCRIPTION(
 
 FILE_NAME(
 /* name */ 
-'/Users/matthia1/Documents/Github/OpenBot/body/body_top.step',
+'body_top.step',
 /* time_stamp */ '2020-08-29T02:02:32+02:00',
 /* author */ (''),
 /* organization */ (''),

body/cad/slim_body/README.md

@@ -0,0 +1,20 @@
+# Slim Body
+
+Some 3D printers have build volumes that are too small to print the full size OpenBot body.
+This folder contains the slim version of the OpenBot body.
+It can be printed with a build plate of 220mmx220mm when the parts are rotated 45 degrees.
+
+![Slim Body](../../../docs/images/slim_body.jpg)
+
+
+## Parts
+
+1) `slim_body_bottom` ([STL](slim_body_bottom.stl), [STEP](slim_body_bottom.step))
+2) `slim_body_top` ([STL](slim_body_top.stl), [STEP](slim_body_top.step))
+
+In order to make it fit you may have to adjust the following settings to get the maximum print area.
+- Set *Build Plate Adhesion Type* to "None" (Brim, Skirt and Raft increase the overall size of your print)
+- Disable prime blob (in *Build Plate* section)
+- Disable the second extruder (if your printer has one)
+
+If you do have a little extra space (223mmx223mm), you can also print the `slim_body_top_rim` ([STL](slim_body_top_rim.stl), [STEP](slim_body_top_rim.step)). It has a slightly larger rim making it easier to take the top off.