Skip to content

Commit

Permalink
rename folders
Browse files Browse the repository at this point in the history
  • Loading branch information
CamDavidsonPilon committed May 1, 2024
1 parent 5b5964c commit ce87e56
Show file tree
Hide file tree
Showing 17 changed files with 1,003 additions and 0 deletions.
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
---
title: Before you begin assembly
slug: /20ml-v11-hardware-setup-intro
hide_table_of_contents: true
---

import AssemblyInstructionBlock from '@site/src/components/AssemblyInstructionBlock';
import Highlight from '@site/src/components/Highlight';
import Admonition from '@theme/Admonition';

import * as colors from '@site/src/components/constants';


<Admonition type="info" title="Info">
You can expect the assembly to take approximately 20-30 minutes.
</Admonition>

-------

<AssemblyInstructionBlock title="Step 1: Necessary tools" images={["user-guide/hardware-assembly/rpi_types.jpg","user-guide/hardware-assembly/screwdriver.jpg"]}>

You will need the following items to assemble your Pioreactor:

1. Your own Raspberry Pi (RPi). Displayed are three examples.
2. A Philip's head screwdriver.
3. The Pioreactor 20ml v1.1 kit.

</AssemblyInstructionBlock>

-------

<AssemblyInstructionBlock title="Step 2: Use all the information available to you" images={["user-guide/hardware-assembly/instructions.png", "user-guide/hardware-assembly/label_reference.jpg"]}>

- Before starting a step, read all instructions and view all photos at the bottom of each step.
- Most of the labels are scaled 1:1 and can be used to identify parts.

:::info
Missing a part? Email us at `[email protected]`, we're happy to help.
:::


</AssemblyInstructionBlock>

-------

<AssemblyInstructionBlock title="Step 3: Electronics protection" images={["user-guide/hardware-assembly/nav_antistatic_polyzip_bags.png"]}>

Here are some tips to prevent damage to the electronics:
- **Keep the electronics inside the ESD bag** right until you are asked to install them.
- **Always touch the sides of the board** while manipulating with it. Avoid touching the chips, capacitors, and other parts of the electronics.
- **Before you touch the electronics**, use any conductive (steel) structure nearby to neutralize any electro-static energy.
- **Be extra cautious in rooms with carpets**, which are a source of electrostatic energy.
- Clothes made of wool and certain synthetic fabrics can easily gather static electricity. It is safer to wear **cotton clothing**.

</AssemblyInstructionBlock>

-------

<AssemblyInstructionBlock title="Step 4: We are here for you!" images={["user-guide/hardware-assembly/upgrade-version/finished-upgraded-version.png"]}>

- If you get stuck, missing a piece, or are unsure of something, **let us know**!
- You can reach out to us at `[email protected]`!
- Continue to the [next assembly instructions](/user-guide/rpi-hat-assembly).

</AssemblyInstructionBlock>
Original file line number Diff line number Diff line change
@@ -0,0 +1,107 @@
---
title: Assembling the Raspberry Pi and the HAT
slug: /20ml-v11-rpi-hat-assembly
hide_table_of_contents: true
---

import AssemblyInstructionBlock from '@site/src/components/AssemblyInstructionBlock';
import Highlight from '@site/src/components/Highlight';
import * as colors from '@site/src/components/constants';

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';


<AssemblyInstructionBlock title="Step 1: Necessary parts" images={["user-guide/hardware-assembly/upgrade-version/hat-pieces.png", "user-guide/hardware-assembly/gpio_check_A.jpg", "user-guide/hardware-assembly/gpio_check_B.jpg"]}>

1. You will need:
* A Raspberry Pi of your choosing. Displayed are three options - you just need one.
* <Highlight color={colors.blue}>Hex nuts (4x)</Highlight>
* <Highlight color={colors.red}>12mm hex standoffs (4x)</Highlight>
* <Highlight color={colors.magenta}>12mm hex standoffs-with-6mm-screws (4x)</Highlight>
* <Highlight color={colors.green}>10mm screws (4x)</Highlight>
* <Highlight color={colors.orange}>Bottom faceplate</Highlight>
* <Highlight color={colors.teal}>HAT PCB</Highlight>


2. Check the GPIO pins on the <Highlight color={colors.teal}>HAT PCB</Highlight> to confirm that they are straight and not touching another GPIO pin.

</AssemblyInstructionBlock>

-----

<Tabs>
<TabItem value="a_or_b" label="Raspberry Pi A or B instructions" default>


<AssemblyInstructionBlock title="Step 2: Assemble the bottom faceplate" images={["user-guide/hardware-assembly/upgrade-version/bottom-faceplate.png","user-guide/hardware-assembly/upgrade-version/bottom-faceplate-screwed.png","user-guide/hardware-assembly/upgrade-version/rpi-no-standoffs.png"]}>


1. If using a half-size Raspberry Pi (aka a Zero model), switch to the tab above called "Raspberry Pi Zero" to see Zero specific instructions.

:::tip
The 40 GPIO pins (standing for general-purpose input/output) form a distinct row on one side of the Raspberry Pi. Note the orientation of these pins to help you assemble correctly!
:::

2. Orientation: the base will have a flat edge and an edge with an indent. The GPIO pins sit along the <Highlight color={colors.blue}>indent</Highlight>, seen on the left in the images.
3. Insert the <Highlight color={colors.red}>10mm screws</Highlight> into the holes.
4. Hand screw a <Highlight color={colors.magenta}>hex nut</Highlight> onto each screw.
5. Place the Raspberry Pi on top, aligning the holes, with the <Highlight color={colors.green}>GPIO pins</Highlight> on the left. Note: your Raspberry Pi may look different than the one displayed.


</AssemblyInstructionBlock>

-----

<AssemblyInstructionBlock title="Step 3: Placing the HAT PCB on top" images={["user-guide/hardware-assembly/upgrade-version/rpi-with-standoffs.png","user-guide/hardware-assembly/upgrade-version/gpio-unpushed.png","user-guide/hardware-assembly/upgrade-version/gpio-pushed.png", "user-guide/hardware-assembly/upgrade-version/standoff-on-hat.png"]}>

1. Hand screw on the <Highlight color={colors.blue}>12mm hex standoffs-with-6mm-screw</Highlight> in each corner.
2. Place the HAT PCB on top. <Highlight color={colors.red}>Push down *from the corners*</Highlight> to secure it in place. The HAT PCB's GPIO connector will line up with the RPi's GPIO pins and may require a slight force to compress down. You can also use the next Tip below to help apply force.

3. Hand screw the <Highlight color={colors.green}>12mm hex standoffs</Highlight> in each corner, on top of the HAT.

:::tip
By screwing down the standoffs, they'll help compress the HAT onto the RPi, too.
:::

4. Put this aside and proceed to the next page.

</AssemblyInstructionBlock>



</TabItem>
<TabItem value="zero" label="Raspberry Pi Zero / Zero 2 instructions">
<AssemblyInstructionBlock title="Step 2: Assemble the bottom faceplate" images={["user-guide/hardware-assembly/upgrade-version/bottom-faceplate.png","user-guide/hardware-assembly/upgrade-version/hex-one-side.png","user-guide/hardware-assembly/upgrade-version/rpi-zero.png"]}>

:::tip
The 40 GPIO pins (standing for general-purpose input/output) form a distinct row on one side of the Raspberry Pi. Note the orientation of these pins to help you assemble correctly!
:::

1. Orientation: the base will have a flat edge and an edge with an indent. The GPIO pins sit along the <Highlight color={colors.blue}>indent</Highlight>, seen on the left in the images.
2. Insert the 10mm screws into the <Highlight color={colors.red}>holes</Highlight>.
3. Hand screw the <Highlight color={colors.magenta}>hexnuts</Highlight> on the screws along the flat edge of the bottom faceplate. Hexnuts are only needed on one side because of the size of the Raspberry Pi Zero.
4. Place the Raspberry Pi along the indented edge of the faceplate, with the <Highlight color={colors.green}>GPIO pins</Highlight> on the left.
5. Hand screw on the <Highlight color={colors.blue}>12mm hex standoffs-with-6mm-screw</Highlight> in each corner.

</AssemblyInstructionBlock>


-----

<AssemblyInstructionBlock title="Step 3: Placing the HAT PCB ontop" images={["user-guide/hardware-assembly/upgrade-version/gpio-unpushed.png","user-guide/hardware-assembly/upgrade-version/gpio-pushed.png", "user-guide/hardware-assembly/upgrade-version/standoff-on-hat.png"]}>

1. Place the HAT on top. <Highlight color={colors.red}>Push down</Highlight> to secure it in place. The HAT PCB's GPIO connector will line up with the RPi's GPIO pins, and may require a slight force to compress down. You can also use the next Tip below to help apply force.

2. Hand screw the <Highlight color={colors.green}>12mm hex standoffs</Highlight> in each corner, on top of the HAT.

:::tip
By screwing down the standoffs, you can use these standoffs to help compress the HAT onto the RPi, too.
:::

3. Put this aside and proceed to the next page.

</AssemblyInstructionBlock>

</TabItem>
</Tabs>
Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
---
title: Wetware assembly
slug: /20ml-v11-wetware-assembly
hide_table_of_contents: true
---

import AssemblyInstructionBlock from '@site/src/components/AssemblyInstructionBlock';
import Highlight from '@site/src/components/Highlight';
import * as colors from '@site/src/components/constants';

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

<AssemblyInstructionBlock title="Step 1: Inserting the O-rings" images={["user-guide/hardware-assembly/upgrade-version/oring-to-vial-holder.png", "user-guide/hardware-assembly/upgrade-version/oring-groove.png", "user-guide/hardware-assembly/upgrade-version/thin-oring-into-top.png", "user-guide/hardware-assembly/upgrade-version/thick-oring-into-bottom.png",
"user-guide/hardware-assembly/upgrade-version/vial-holders-with-orings.png"]}>

:::note
The vial holder of the v1.1 comes in two halves; a top vial holder and a bottom vial holder. Both have sections to insert O-rings for a more secure hold on your vials and increased protection against leaks. The <Highlight color={colors.magenta}>thinner O-ring (#024)</Highlight> fits into the top piece. The <Highlight color={colors.orange}>thicker O-ring (#121)</Highlight> lines the bottom piece. The O-rings are lubricated with a silicone-based lube.
:::

1. The top vial holder has <Highlight color={colors.blue}>a groove within the body</Highlight> where the <Highlight color={colors.magenta}>thinner #024 O-ring</Highlight> sits. Carefully insert the O-ring using your fingers. Make sure to not twist the O-ring.
2. Run your finger inside the vial holder, pushing the O-ring into place to ensure a snug fit.
3. The bottom vial holder has a groove for the <Highlight color={colors.orange}>thicker #121 O-ring</Highlight>. The O-ring will sit between the base of the holder and the heater PCB. Carefully insert the O-ring using your fingers. Make sure to not twist the O-ring.
4. Push the O-ring into place to ensure a snug fit.

</AssemblyInstructionBlock>

-------

<AssemblyInstructionBlock title="Step 2: Attach the window cover" images={["user-guide/hardware-assembly/upgrade-version/window-cover-parts.png", "user-guide/hardware-assembly/upgrade-version/window-screw.png"]}>

1. Place the window cover over the window. It should fit snuggly.
2. Attach it using <Highlight color={colors.red}>four 4mm screws</Highlight> (2 provided in the upgrade kit, and 2 previously used in the old v1.0).

</AssemblyInstructionBlock>

-------

<AssemblyInstructionBlock title="Step 3: Connect the flex cable" images={["user-guide/hardware-assembly/upgrade-version/non-attached-heater-pcb.png","user-guide/hardware-assembly/upgrade-version/attached-heater-pcb.png"]}>


1. On the heater PCB, locate the white-&-beige cable connector, <Highlight color={colors.red}>pull the beige-colored tabs outward</Highlight> to open it.
2. <Highlight color={colors.green}>Insert the flex cable</Highlight> blue side down, copper side up, into the cable connector.
3. Then <Highlight color={colors.orange}>push the beige tabs back in</Highlight> to secure the flex cable.


</AssemblyInstructionBlock>

------

<AssemblyInstructionBlock title="Step 4: Place and secure the heater PCB" images={["user-guide/hardware-assembly/upgrade-version/heater-cable-hole.png", "user-guide/hardware-assembly/upgrade-version/pull-heater-cable.png", "user-guide/hardware-assembly/upgrade-version/apply-pressure.png", "user-guide/hardware-assembly/upgrade-version/screw-in-flat-5mm.png", "user-guide/hardware-assembly/upgrade-version/replace-thermal-pad.png"]}>



1. Insert the other end of the flex cable <Highlight color={colors.red}>below the O-ring and into the groove</Highlight>. Pull it through.
2. <Highlight color={colors.magenta}>Apply pressure</Highlight> on the back of the heater PCB so that it lies flat on the O-ring. Maintain this pressure for the next steps.
3. Flip the holder and insert the <Highlight color={colors.green}>two flat M2.5-CS 5mm screws</Highlight> into the holes.
4. **While maintaining pressure**, take turns screwing each in until both are secure, and the heater pcb is securely attached to the bottom vial holder.

</AssemblyInstructionBlock>

-----

<AssemblyInstructionBlock title="Step 5: Placing the heating pad" images={["user-guide/hardware-assembly/upgrade-version/sticky-side.png","user-guide/hardware-assembly/upgrade-version/remove-blue.png","user-guide/hardware-assembly/upgrade-version/remove-blue-2.png"]}>

1. Remove the _clear_ plastic from one side of the thermal pad.
2. Place on the flat (aluminum) part of the heating PCB. Apply downwards pressure to secure it.
3. Remove the blue protective plastic on top of the thermal pad.


</AssemblyInstructionBlock>

-----

<AssemblyInstructionBlock title="Step 6: Complete the vial holder" images={["user-guide/hardware-assembly/upgrade-version/twist-vial-holders-together.png"]}>

1. Screw the top and bottom vial holder sections together.
2. Set this aside and proceed to the next page.

</AssemblyInstructionBlock>
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
---
title: Attaching the wetware to the HAT asssembly
slug: /20ml-v11-putting-it-together
hide_table_of_contents: true
---

import AssemblyInstructionBlock from '@site/src/components/AssemblyInstructionBlock';
import Highlight from '@site/src/components/Highlight';
import * as colors from '@site/src/components/constants';

<AssemblyInstructionBlock title="Step 1: Necessary parts" images={["user-guide/hardware-assembly/stirring_parts.jpg"]}>

* <Highlight color={colors.blue}>Fan</Highlight>
* <Highlight color={colors.red}>Top faceplate</Highlight> (will have 4 x 30mm screws in it)
* <Highlight color={colors.orange}>One 5mm screw</Highlight>

:::info
The fan and top faceplate come assembled - leave them together. If they are not assembled, attach the fan onto the faceplate with the cable oriented toward the side labelled "PWM".
:::

</AssemblyInstructionBlock>


-----

<AssemblyInstructionBlock title="Step 2: Securing the vial holder" images={["user-guide/hardware-assembly/upgrade-version/fan-onto-top-faceplate.png", "user-guide/hardware-assembly/upgrade-version/completed-fan-assembly.png", "user-guide/hardware-assembly/upgrade-version/join-vial-holder-and-fan.png", "user-guide/hardware-assembly/upgrade-version/flat-flex-follows-arrow.png", "user-guide/hardware-assembly/upgrade-version/tighten-30mm-screws.png"]}>

1. Push the <Highlight color={colors.red}>fan onto the top faceplate</Highlight>, orienting it such that the wire is pointing towards the button.
2. Place the vial holder on top of the <Highlight color={colors.green}>four ends of the 30mm screws</Highlight>. The screw ends should fit into four holes on the bottom of the vial holder. The flat flex cable should follow the <Highlight color={colors.orange}>arrow on the faceplate</Highlight>.
3. Holding it together, finish screwing the <Highlight color={colors.blue}>silver screws</Highlight> on the bottom of the faceplate. The screws will enter square nuts in the vial holder. Do not overtighten.

:::caution
You should not feel resistance when tightening the screws into the square nuts. If you encounter resistance, unscrew and inspect the screw for any plastic debris.
:::

4. The screw heads will be flush with the faceplate, and there should be no screw threads showing between the vial holder and the faceplate.


</AssemblyInstructionBlock>

-----

<AssemblyInstructionBlock title="Step 3: Button extension" images={["user-guide/hardware-assembly/upgrade-version/apply-force-button-extension.png", "user-guide/hardware-assembly/upgrade-version/completed-button-extension.png"]}>

The top faceplate now comes with a button extension to provide easier access when pushing the button.

1. Flip over the assembly.
2. Insert the 10mm screw into the hole under the button extension.
3. Place <Highlight color={colors.red}>one finger behind the extension</Highlight> and <Highlight color={colors.magenta}>apply torque with the other hand</Highlight> until the screw is secure in the hole. This may require a lot of force.

</AssemblyInstructionBlock>

-------

<AssemblyInstructionBlock title="Step 4: Putting it all together" images={["user-guide/hardware-assembly/upgrade-version/attach-assembly-to-hat.png", "user-guide/hardware-assembly/upgrade-version/screw-assembly-to-hat.png",
"user-guide/hardware-assembly/upgrade-version/fasten-heater-cable.png", "user-guide/hardware-assembly/upgrade-version/connect-pwm-one.png"]}>

1. <Highlight color={colors.blue}>Place the vial holder assembly onto the Raspberry Pi/HAT</Highlight>. The GPIO pins align with the side notch of the faceplate.
2. Using the <Highlight color={colors.red}>6mm screws</Highlight>, attach the top and bottom pieces in each corner.
3. Check that the screw for the button extension is in the right position.
4. Open the <Highlight color={colors.orange}>flat flex cable connector</Highlight> on the HAT by pulling the tabs outward, like done previously. Insert the flex cable copper-side up.
5. <Highlight color={colors.green}>Push the tabs inward</Highlight> to secure the flex cable.
6. Insert the stirring power connector into <Highlight color={colors.magenta}>PWM channel 1</Highlight> (unlabelled).
7. Continue to the next page.


</AssemblyInstructionBlock>
Loading

0 comments on commit ce87e56

Please sign in to comment.