Hardware Setup
Choose the rig and the gripper endpoint on each arm, design a new endpoint, and set which pipettes connect at startup.
Two dialogs in the header menu (the vertical dots) describe the hardware the backend runs: Hardware Setup and Pipettes. Every change in them restarts the backend, which interrupts a run in progress. Make changes between runs.
Hardware Setup
The dialog has two parts.
Rig setup shows the setup the backend runs ("Running: …") and its arms.
- In the cloud you can move the project onto another rig available to your organization: pick it, then Restart on this setup. The backend restarts on that rig, and anything unsaved in the 3D view is lost.
- On a deployed box the setup is fixed to the box's configuration and the section is read-only.
Gripper endpoints has one row per arm (Left arm, Right arm; one row on a single-arm rig). Each row shows the endpoint fitted now (live: …) and a list to choose another. The endpoint sets the tool geometry and the tool centre point the planner drives to.
- The list shows each endpoint by its identifier:
stockfirst, then the other endpoints available on this backend, including any you designed. - When your choice differs from what is live, the dialog warns "Applying will restart the backend and interrupt any in-progress run."
- Apply & Restart applies the choice and restarts the backend. Cancel leaves everything as it was.
On a deployed box, the endpoint you choose must match the tool physically fitted to the arm. A mismatch puts the planned tool tip in the wrong place.
Designing an endpoint
Design a new endpoint from a URDF or mesh… opens Design a gripper endpoint: a 3D view on the left and the Endpoint designer panel on the right.
- Name: the identifier the endpoint will have in the list.
- Geometry: upload a part for Left finger and Right finger: an
.stl,.objor.plymesh, or a.zipof a URDF with its meshes. Then place each part on its finger pad in the 3D view. - Jaw opening: how far apart the fingers sit in the preview.
- Collision spheres / finger: how many spheres stand in for each finger in collision checks (3 to 24).
- Tool tip (TCP z): Snap to tip places the tool centre point at the tip of the endpoint. You can move it in the 3D view.
- Fit to arm: tick the arm or arms that get the endpoint.
Confirm & Restart writes the endpoint, fits it to the ticked arms, and restarts the backend. The app returns to Home when the backend is back.
Pipettes
The Pipettes dialog lists the pipettes of the rig and which of them connect at startup. Pipettes connect during startup only, so Apply & Restart always restarts the backend.
- Use pipettes on this rig switches all pipettes on or off. If the box's configuration fixes this switch, it is read-only and the dialog says so.
- Each row has an on/off switch, the name skills use for the pipette, its Bluetooth device name, a dot that is green when connected, and a remove button.
- Scan for devices searches for pipettes in Bluetooth range; Add puts a found device in the list. Add manually adds an empty row.
- Apply & Restart stays disabled until something changed and every row has both names.
A pipette that dropped its connection can be reconnected without a restart: Reconnect pipette in the Hardware indicator, or the pipette button next to Run on the Workflow Editor. Both reconnect and home it.
Updated 9 days ago