User Guide

Note: Under construction. See issue https://gitlab.com/pipettin-bot/pipettin-grbl/-/issues/52.

Will cover:

Link back to the index.md.

Step 1: First-run setup

Note: This section is missing a proper tutorial.

Note: This section takes a couple hours.

Follow the setup guide: 01_setup.md

Step 2: Place physical objects

The basic idea is to place objects along the 3D-printed curbs. Use these to align the objects easily, precisely and repeatably, to the workspace's surface.

  1. Place the baseplate on the aluminium frame.
    • Make sure that the contact points are correctly aligned with the slots one the aluminium profile. It must sit in place firmly.
  2. Place some curbs on the baseplate.
    • Try to form corners at different places. This shape will be useful to align objects in the next step.
  3. Place and align your objects on the baseplate, for example:
    • One p200 tip rack with tips.
    • One tube rack with some tubes.
    • A "discard tray" should be placed just below the tip-ejection post.

The relative placement of physical objects on the baseplate must correspond with the position of virtual objects in the GUI's workspace. This will be setup on the next step.

modulitos2.png

Curbs on the baseplate.

corners.jpg

At first the objects are free to move. The curbs (the white 3D-printed part in "L" shape) should be square with the machines coordinates, and will help align the objects, in both position and angle.

overview.jpg

Once in place, the position of the objects must be calibrated in the GUI, such that the virtual representation is perfectly aligned with the physical objects.

Step 3: Align and calibrate platforms

Note: This section is missing a proper tutorial.

Follow the calibration guide: 02_calibration.md

Step 4: Find your Pi's local IP address

If you do not know your Pi's IP, follow the relevant section of the "setup" guide.

Step 5: Create a virtual workspace

Note: This section is missing a proper tutorial.

A quick video example is available, demonstrating how to operate the GUI to setup a workspace, its contents, and a protocol. Watch the videos here: photos.app.goo.gl/L4CYRKD2wZrmArp87

Note: The videos are not meant to be self-explanatory. Specially the last one; I recorded it as a placeholder until I make a decent usage guide.

Steps:

  1. Open the GUI by pointing your browser to the Pi's IP address on your local network, on port 3333 (e.g. 192.168.0.12:3333).
  2. Click on the "Workspace" drop-down menu.
  3. Select "New" to create a workspace.
  4. Click on the "Save" icon (the diskette) to save the new workspace and give it a name.
  5. A "Workspace saved" message should appear.

TO-DO:

Step 6: Add platforms to the workspace

Note: This section is missing a proper tutorial.

  1. addplatformmenu
  2. addtipbox
  3. dragtipbox
  4. addmoreplatforms
  5. selectitems
  6. itemsselected
  7. additemstotiprackmenu
  8. tipsadded
  9. itemselectedclick
  10. addtubemenu
  11. addtuberesult
  12. moretubesselected
  13. moretubesadded

Step 7: Create a protocol

Note: This section is missing a proper tutorial.

Step 8: Pre-run considerations

Note: This section is missing a proper tutorial.

Step 9: Run the protocol

Note: This section is missing a proper tutorial.