QB Robotics qb SoftClaw Configuration guide

PLEASE READ CAREFULLY THESE INSTRUCTIONS BEFORE USE. DO NOT DISCARD: KEEP FOR FUTURE REFERENCE.

General Manual

RELEASE  —
Dear customer,
Thank you for purchasing our product.





The present document provides information at best of our knowledge at the time of
publication. This document could present differences from the product and it is
subject to changes without notice: the latest version is available on our webpage
www.qbrobotics.com.
qbroboticss.r.l. does not assume any responsibility for errors or omissions.
In nocaseqbroboticss.r.l. will be responsible for any loss, problems or damages to
persons or property arising from the use of this document.
The qb® logo and qbrobotics® are registered trademarks of qbrobotics s.r.l. In the
following, the indications of (R) are omitted.

Table of Contents
1 Preface .......................................................................................................................... 1
1.1 Using this document 1
1.2 Symbols and conventions 1
1.3 Kit content 2
2 Safety............................................................................................................................. 3
2.1 Intended use 3
2.2 Safety instructions 3
2.3 EC Directives on product safety 3
2.4 Environmental conditions 4
2.5 Environmental safety 4
3 Technical data .............................................................................................................. 5
3.1 Mechanical dimensions 5
3.2 Center of Mass 5
3.3 Mechanical characteristics 6
3.4 Electrical characteristics 7
3.5 Tool connector pinout 8
3.6 Pad exchange system 9
4 Description ..................................................................................................................11
4.1 General 11
4.2 Characteristics and key features 12
4.3 Standard customization 12
5 Mounting and wiring ..................................................................................................13
5.1 Tool mounting 13
5.2 Cable connections 14
6 Software .......................................................................................................................18
6.1 ROS 18
6.2 C API library 27
6.3 Configuration GUI 30
7 Maintenance and warranty........................................................................................33
7.1 General 33
8 FAQ and troubleshooting ...........................................................................................35
8.1 The USB flash drive is not working 35
8.2 PC drivers and requirements 35

4 —PREFACE
GENERAL MANUAL —MAR 18, 2022 —RELEASE:V1.0.0
1 Preface
1.1 Using this document
The documentation must always be complete and in a perfectly readable state.
Keep the document accessible to the operating and, if necessary, maintenance personnel at all times.
Pass the document to any subsequent owner or user of the product.
1.2 Symbols and conventions
STYLE DESCRIPTION
Identifies information about practice or circumstances that can lead to
critical damages on the device and to personal injury.
Attentions help you identify a hazard, avoid a hazard and recognize the
consequence.
Identifies information about practice or circumstances that can lead to
damages on the device and to personal injury.
Attentions help you identify a hazard, avoid a hazard and recognize the
consequence.
Identifies remarkable information and additional notes.
CRITICAL:
...

WARNING:
...

NOTE:
...


SOFTCLAW —2

•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
STYLE DESCRIPTION
Identifies tips and highlights.
Identifies the required tool to be used during the described assembly phase.
Monospaced text Identifies file paths, file names and software functions.
1.3 Kit content
The kit consists of:
N.1 qb SoftClaw;
N.1 ISO 9409-1-50-4-M6 tool flange adapter;
24 VDC power supply unit with cables;
N.1 main cable of 3m;
N.1 USB to RS485 converter with extension cord;
N. 1 set of magnetic pads;
N.1 USB flash drive:
URCap v3 (Polyscope versions 3.8+, 5.2+)
Manual;
Datasheet;
N.1 cylindrical pin EN ISO 8734 A d6x14 h6;
N.4 metrical screws EN ISO 4762 M6x10;
N.8 metrical screws EN ISO 10642 M3x8;
N.1 2 mm Allen hex key;
N.1 5 mm Allen hex key.

Optionals:
ISO 9409-1-40-4-M6 tool flange adapter;
ISO 9409-1-31.5-4-M5 tool flange adapter;
Kinova Gen3 tool flange adapter.
TIPS:
...


3 —SAFETY
GENERAL MANUAL —MAR 18, 2022 —RELEASE:V1.0.0
•
•
2 Safety
2.1 Intended use
The product design is intended for grasping objects up to 3700 g.
Fragile, sharp or sharp-edged objects shall not be grasped.
Objects having the main dimension greater than 200 mm shall not be grasped.
The product is intended for installation on robotic arms: the safety features are established only for use
as described in this document.
The safety of the product cannot be guaranteed in case of inappropriate use. One, single, inappropriate
use can result in a permanent damage to the safety of the product.
2.2 Safety instructions
2.3 EC Directives on product safety
The following EC directives on product safety must be observed.
If the product is being used outside the UE, international, national and regional directives must be
also observed.
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
Check that all the content is intact after removing it from the packaging.
The device can be used only by specially trained staff.
Disconnect the power supply before installation, cleaning or maintenance operations.
Make sure that no residual energy remains in the system.
Always operate the product within the specifications defined.
Keep away from children and pets. Always set off or unplug when not in use.
Never use aerosol products, petroleum based lubricants or other flammable products on
or near the end-effectors.
Do not use any damaged power cable, plug, or loose outlet. It may cause damages to the
product or injury to people.
Do not touch electrical components to avoid damages due to electrostatic charges.
Make sure the end-effector is properly and securely bolted in place and cabled.
Do not use if damaged or defective. Do not disassemble.
Do not insert any objects between moving parts of the fingers.
Keep head and face outside the reach of the end-effector.
Do not wear loose clothing or jewelry when working with the end-effector.
Disrespect of these precautions can affect safety of the device.


SOFTCLAW —4

2.3.1 Machinery Directive (2006/42/EC)
Because of their small size, no serious threats to life or physical condition can normally be expected from
electric miniature drivers. Therefore, the Machinery Directive does not apply to our products. The
products described here are not "incomplete machines", so installation instructions are not normally
issued by qbrobotics.
2.3.2 Low Voltage Directive (2014/35/EU)
The Low Voltage Directive applies for all electrical equipment with a nominal voltage of 75 to 1500 V DC
and 50 to 1000 V AC. The products described in this device manual do not fall within the scope of this
directive, since they are intended for lower voltages.
2.4 Environmental conditions
Wrong environmental and operating conditions can lead to injuries, product damages and/or significant
reduction to the product's life.
2.5 Environmental safety
The qb SoftClaw must be disposed of in accordance with the applicable national laws, regulations and
standards.
All the components of this product have been chosen in accordance with the EU RoHS directive 2011/65/
EU: they are produced with restricted use of hazardous substances to protect the environment.
Observe national registration requirements for importers according to EU WEEE Directive 2012/19/EU.
•
•
•
•
•
•
•
•
•
•
Any use or application deviating from intended use is deemed to be impermissible misuse.
This includes, but is not limited to:
Use before performing a risk assessment;
Use outside the permissible operational conditions and specifications;
Use in not low-dust environment;
Use in places with high temperature or humidity;
Use in wet places;
Use in potentially explosive atmospheres;
Use in medical and life critical applications;
Use close to a human's head, face and eye area;
Use as a climbing aid;
Use in outdoor applications.


5 —TECHNICAL DATA
GENERAL MANUAL —MAR 18, 2022 —RELEASE:V1.0.0
3 Technical data
3.1 Mechanical dimensions
The figurebelow shows the overall dimensions of the qb SoftClaw; distancesand tolerances in the
drawing are noted in millimeters[mm]and degrees[°].
Figure 1. — qb SoftClaw drawings
3.2 Center of Mass
The following table gives also the position of the Center of Mass of the SoftClaw and defines its Coordinate
System, like depicted in the following schemes.
Be aware that the above figure may be out of scale.


SOFTCLAW —6

UNIT LEFT
CoM x coordinate, OTX [mm] 1
CoM y coordinate, OTY [mm] 53
CoM z coordinate, OTZ [mm] 1
Weight [kg] 0.780
Center of Mass, OT, is evaluated w.r.t. ΣMconsidering the device mounted with its fixed finger facing the
ground, cf. the figures below.

Figure 2. — Robot Tool Coordinate System

On the left, it is represented the mechanical interface coordinate system ΣM(OM; XM, YM, ZM)of an
articulated robot, as defined by ISO 9787:2013. In particular, the center of the coordinate system, OM, is
on the interface surface of the robot tool flange and the ZMaxis is coincident with the tool flange axis of
symmetry.Riis the i-th revolute joint of the robot and(O1; X1, Y1, Z1)is the base coordinate system of the
robot.
On the right,there is the Tool Coordinate System,ΣT(OT; XT, YT, ZT), of the qbSoftClaw and the center,OT,
coincides with the center of mass of the device and its position is defined by the distance fromOM. TheZT
axis is normal to the palm, outgoing positive, and theYTaxis follows the proximal-distal direction and
orientation.
3.3 Mechanical characteristics
MINIMUM NOMINAL MAXIMUM
Payload [kg] — — 3.70
All coordinate systems here described follow the orthogonal right-hand rule.


7 —TECHNICAL DATA
GENERAL MANUAL —MAR 18, 2022 —RELEASE:V1.0.0
MINIMUM NOMINAL MAXIMUM
Grasping force [N] 0.5 —64.0
Grasping time [s] — — 1.0
Releasing time [s] — — 1.0
Look at the graph for details.


3.4 Electrical characteristics
MINIMUM NOMINAL MAXIMUM
Power supply
voltage
[VDC] 23.1 24 24.8
Power
consumption
[W] —3 22

SOFTCLAW —8

1 https://www.phoenixcontact.com/online/portal/us?uri=pxc-oc-itemdetail:pid=1424232
2 https://www.phoenixcontact.com/online/portal/us?uri=pxc-oc-itemdetail:pid=1404192
•
•
•
•
•
MINIMUM NOMINAL MAXIMUM
Current limit [A] —0.90 *
Operational time [s] — — 300
Duty cycle [%] — — 69
Operating
temperature
[°C] -5 20 50
Relative humidity
**
[%] 5 —80
Typical noise level [dB] —<50 —
* Starting spike current may be greater, but it is instantaneous.
** Only the non-condensing case is to be considered.
3.5 Tool connector pinout
On the qb SoftClaw flange there is aPhoenix Contact 8-position M8 connector, A-coded, withgold-plated
copper alloy contacts — Part Number: 14242321.
The main cable of the qb SoftClaw is a Phoenix contact 3mfree cable end with angled socket — Part
Number: 14041922
The RS485 protocol characteristics are as follow:
8 bit;
no parity;
1 stop bit;
no flow control;
2M baud rate.

9 —TECHNICAL DATA
GENERAL MANUAL —MAR 18, 2022 —RELEASE:V1.0.0
•
•
# WIRE COLOR DESCRIPTION
1 White RS485+ 
2 Brown RS485-
3 Green internal
4 Yellow internal
5 Gray 24V ***
6 Pink GND ***
7 Blue 24V ***
8 Red GND ***
*** 24VDC and GND must be provided by an isolated Power Supply Unit.


3.6 Pad exchange system
The fingers are provided of magnetic system to easy setup the gripper with desired kind of soft interface.
You can directly place the pad on its socket and it will be automatically constrained.
Figure 3. — Magnetic soket on the finger (2) and magnetic pad (1).
The pad is also designed to allow the assembly without magnets in order to avoid possible issues coming
from magnetic fields, so directly by a screw:
use the 2 mm Allen wrench to remove the finger's magnet;
usethe same tool to assebly the pad, through the central hole on the surface.
Any error in the pins connection may cause irremediable damages to the device.


SOFTCLAW —10

Figure 4. — Different kind of available pad from qbrobotics (not included).
Only flat pad is provided in the kit. For different or customized pad, please ask a quotation to qbrobotics.

11 —DESCRIPTION
GENERAL MANUAL —MAR 18, 2022 —RELEASE:V1.0.0
•
•
•
•
•
4 Description
4.1 General
The qb SoftClaw is a compact, light and versatile Variable Stiffness Gripper. It's able to grasp objects of the
most disparate nature, exploiting the intrinsicmechanical intelligence of its variable stiffness system,
without the use of any type of sensorson the contact surfaces or specific algorithms on the absorbed
current by the motors.
The custom-made electronic board inside the qb SoftClaw is composed of a logic stage for communication
and low-level computation, and a power stage for motion control. This, together with two DC motor and
its encoders, establishes a simple position and current control feedback regulated by a properly tuned PID
controller.
The qb SoftClaw does not use Common Industrial Protocols (CIP) or other industrial standards for I/O
communication due to historical design and technical reasons.
I/O data basically refers as measurements from the device, commands to the device, and parameters
from/to the device. These are handled in a custom package format as follows
2-byte — common preamble;
1-byte — target slave id;
1-byte — payload length;
n-byte — payload;
1-byte — checksum for communication integrity.
A custom-made single-master-multiple-slave (SMMS) serial communication protocol is implemented to:
send commands to the connected devices;
read measurements from the connected devices (motor position and/or current);
get and set configuration parameters.
4.1.1 Control Modes
The qb SoftClaw can be controlled by two differentmodalities:
Position: itis the control mode that most closely approaches the operation of a classic gripper. In this
modality the user can control bothpositionand stiffness. The first parameter is used to set the
angular position of the qb SoftClaw movable arm, the second oneallows the elasticity of the arm itself
to be adjusted. Higher values of stiffness indicates a greater rigidity of the gripper during the grasp;
on the contrary lower values allows soft grips.
Deflection:it is the control mode that allows the user to regulate the grip force during the grasp. This
modality does not requires anytype of sensorson the contact surfaces or specific algorithms on the
absorbed current by the motors, but exploits themechanical intelligence of the qb SoftClaw. In this
modality the movable arm is controlled to close completely towards the fixed part for each

SOFTCLAW —12

3 mailto:[email protected]
•
•
•
•
•
•
•
•
•
commanded value. Small values allow to grip fragile and low-weight objects; on the contrary higher
values can be used for heavy and rigid objects.
4.2 Characteristics and key features
Adaptive grasp;
Variable Stiffness grasp;
Interchangeable fingertips;
Up to 64 N grasping force*;
Up to 3.7 kg maximum payload*;
Maximum closure time of 1.0 s;
Total weight of 780 g (including aluminium flange and screws);
ROS packages and general C++ API available;
* Grasp forces and payloads highly depend on object dimensions and approaching strategy (cf. Mechanical
Characteristics(see Page 5)).
4.3 Standard customization
Mechanical flange adapters for non-standard robot flanges;
We may evaluate other customization for special partners; for requests, please contact our
sales team3.


13 —MOUNTING AND WIRING
GENERAL MANUAL —MAR 18, 2022 —RELEASE:V1.0.0
5 Mounting and wiring
5.1 Tool mounting
The qb SoftClaw Kit allows you to connect the device to your robot arm.
To assemble the device on the robot arm, please follow thefollowing instructions:
# INSTRUCTIONS
1 Insert (1) into the 6 mm hole on the robot wrist.
2 Center (2) on the wrist diameter 63 mm, taking care that the
cylindrical pin (1) fits into one of the four d6 reamed through holes.
3 Fasten (2) to the robot wrist by tightening the four screws (3).
You need the 5 mm Allen wrench.
Use only the screws provided within the package. Longer screws could damage the robot or
the end-effector.


SOFTCLAW —14

# INSTRUCTIONS
4 Center (4) on the diameter 63 mm of (2), taking care that the plug
fits into one of the four d6 mm through holes.
5 Fix axially the device by tightening the 8 screws (5).
You need the 2 mm Allen wrench.
Table 1. — Installation guidelines of the qb SoftClaw on robot arm.
5.2 Cable connections
To correctly wire the SoftClaw please follow the instructions in the table, using the provided kit.

15 —MOUNTING AND WIRING
GENERAL MANUAL —MAR 18, 2022 —RELEASE:V1.0.0
Figure 5. — Connection kit for qb SoftClaw: power supply unit (A), RS485-USB converter (B), main cable (C1),
USB cable (C2), power cable (C3), (C4) optional.
# INSTRUCTIONS
1Connect the main cable (C1) to the RS485-USB
converter (B) terminal block.
Then connectthe RS485-USB converter (B) (or the
USB extension cord (C2)) to an USB type-A
available port.
•
•
Pay attention to connect wires as
follows:
WHITE wire → A-port;
BROWN wire→ B-port.

If the qb SoftClaw has to be used
through C++ APIs or ROS packages,
then the USB communication cable
has to be connected to the workstation
PC.


SOFTCLAW —16

# INSTRUCTIONS
2 Connect the main cable (C1) to the power supply
unit (A).
3Connect the power cable (C3) to the power supply
unit (A).
•
•
Pay attention to connect wires as
follows:
GRAY wire → 24VDC;
RED wire→ GND.


17 —MOUNTING AND WIRING
4 mailto:[email protected]
GENERAL MANUAL —MAR 18, 2022 —RELEASE:V1.0.0
# INSTRUCTIONS
4 Insert the M8 connector of (9) into the receptacle
on the device wrist flange. Lock the M8 connector
by manually tightening its threaded ring on the
body of the receptacle (max tightening torque=
0.2 Nm).
Table 2. — Electrical connections.
Be careful to insert the connector in
the correct direction.
Do not rotate the M8 connector when
inserted into the receptacle.
Minimum curve radius of the cable (9)
= 51 mm.

YELLOW and GREEN wires on (C1) cable are optional. They are used to enable the button on
theqb SoftClaw wrist flange as a Digital Input for the robot on which the gripper is mounted.
If your robot provides digital inputs, you can connect one of these wires (for example the
yellow one) to a digital input port. The other wire (for example the green one) should be
connected to the DC voltage output that your robot needs to detect the logic levels of the digital
I/O.
Contact qbrobotics Support Team4for more informations.
