Skip to content

Sources

Info

Work in progress. This page will contain links to:

  • Source files for hardware designs.
  • Source files for firmware.
  • Source files for software.

Licencing terms should be pointed out for each kind of content, and open source software/hardware used by the project.

The Pipettin Bot is an open-source hardware project that anyone can contribute to. Firmware and software sources are also available.

Licensing terms can be found here.

The project is built using open tools like FreeCAD. We want to make it easy for people to get involved and help us develop the project, and have developed it using open-source tools only.

Quick links:

Hardware

The Pipettin Bot project is open source; you can find all the hardware source files on GitLab and on this wiki, including schematics and FreeCAD files.

Since the Pipettin Bot is open source hardware, it was developed using open source tools, specifically FreeCAD for the hardware design. We developed our project using FreeCAD version 0.20.1 or greater.

We hope this will help you learn how the project works and contribute with your modifications.

Our Pipetting Bot's hardware and design documents are released under the CERN Open Hardware License S 2.0 (strongly reciprocal). If you have any questions about the license, please refer to the License text and the licensing section of this wiki for an understanding of the permissions and restrictions associated with the design files.

Here is a list of links to CAD sources and exports for each part of the robot.

Component Bill of Materials CADs at GitLab
Full Sources BOM GitLab
Structural Frame BOM GitLab
Baseplate BOM GitLab
Backpanel BOM GitLab
Motion system BOM GitLab
Tool-changer BOM GitLab
Tools & tool-posts BOM GitLab
Electronics1 BOM GitLab

Software

The main repo, including all components as submodules, can be found at GitLab: https://gitlab.com/pipettin-bot/pipettin-bot/-/tree/master/code

Software overview

An overview of Pipettin Bots software (controllers, APIs, Web App and Database) is available in the technical overview.

Repository Link
piper https://gitlab.com/pipettin-bot/pipettin-piper
GUI https://gitlab.com/pipettin-bot/pipettin-gui
Newt https://gitlab.com/pipettin-bot/pipettin-newt
Mix protocol generator https://gitlab.com/pipettin-bot/pipettin-mix
Device manager https://gitlab.com/pipettin-bot/pipettin-coorder
PyLabRobot fork https://gitlab.com/pipettin-bot/forks/pylabrobot

Firmware

Firmware is the software that controls the electronics of the robot. It is responsible for the motion of the motors, reading from sensors, and the communication with the computer.

Klipper

The project has moved from GRBL to Klipper, but will stick with Arduino UNO + CNC shield for the DIY version of the electronics.

Klipper will run on many more MCUs than the Arduino UNO, and is also Open Source Software. Using more expensive boards (e.g. the Duet2) with Klipper is very straightforward, as long as their microprocessors are supported.

Firmware source: https://gitlab.com/pipettin-bot/forks/firmware/klipper

We also use other software components associated to the Klipper project, which we refer to as the "Klipper software stack".

Licensing terms can be found in the repositories.

Equipment

Warning

Work in progress. Most equipment mentioned below is not yet ready for automation.

Pipettin Bot can also interact with an active "benchtop" equipment, such as colorimeters, heater blocks, among others.

To learn more about Pipettin Bot's equipment visit the technical overview.

Info

A guide on how to do this is due. In short, a "plugin" module must be added to piper, and custom actions must be added to protocols.

Visual identity

Logos and all visual identity of the OLA and Pipettin Bot are not shared for free use.

All rights reserved.

pipettinbotlogo.png

olalog.png

  1. The Arduino, CNC-Shield, Duet, and Raspberry Pi boards are open source hardware designs. Model files for them can be found on the internet (e.g. search for "Raspberry Pi 4 dimensions" on your favourite search engine). ↩