QB Robotics N.1 qb SoftHand Research 24 V Configuration guide

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

RELEASE  —V1.1.0
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............................................................................................................................. 4
2.1 Intended use 4
2.2 Safety instructions 4
2.3 EC Directives on product safety 5
2.4 Environmental conditions 5
2.5 Environmental safety 5
3 Technical data .............................................................................................................. 7
3.1 Mechanical dimensions 7
3.2 Center of Mass 8
3.3 Mechanical characteristics 9
3.4 Electrical characteristics 10
3.5 Tool connector pinout 11
4 Description ..................................................................................................................13
4.1 General 13
4.2 Characteristics and key features 13
4.3 Standard customization 14
5 Mounting and wiring ..................................................................................................15
5.1 Tool mounting 15
5.2 Cable connections 17
6 Software .......................................................................................................................21
6.1 Configuration GUI 21
6.2 ROS 24
6.3 C++ API library 35
7 Maintenance and warranty........................................................................................41
7.1 General 41
8 FAQ and troubleshooting ...........................................................................................42
8.1 Grasping with a custom finger position 42
8.2 PC drivers and requirements 42
8.3 Simplified CAD models of the qb SoftHand 45
8.4 The glove is deteriorated/broken 45

8.5 The hand does not reopen correctly 46
8.6 The USB flash drive is not working 47

QBSOFTHAND RESEARCH USER MANUAL —5

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.
CRIT
ICAL
:
...

WA
RNI
NG:
...


2 —PREFACE
GENERAL MANUAL —SEP 8, 2022 —RELEASE:V1.1.0
•
•
•
•
•
•
•
STYLE DESCRIPTION
Identifies remarkable information and additional notes.
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 SoftHand Research 24 V;
N.1 ISO 9409-1-50-4-M6 flange adapter;
N.1 0.3m direct wrist connection cable for UR e-Series robots;
N.1 3m main cable;
N.1 USB to RS485 converter with extension cord;
N.1 USB flash drive:
URCap v3 (Polyscope versions 3.8+, 5.2+);
NOT
E:
...

TIPS
:
...


QBSOFTHAND RESEARCH USER MANUAL —3

•
•
•
•
•
•
•
•
•
•
•
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:
24 VDC power supply unit;
ISO 9409-1-40-4-M6 flange adapter;
ISO 9409-1-31.5-4-M5 flange adapter;
Kinova Gen3 flange adapter.

4 —SAFETY
GENERAL MANUAL —SEP 8, 2022 —RELEASE:V1.1.0
2 Safety
2.1 Intended use
The product design is intended for grasping objects in the weight range from 1 to 1700 g.
Fragile, sharp or sharp-edged objects shall not be grasped.
Objects having the ratio between the biggest and the smallest dimensions ≥8 and the main dimension
greater than 300 mm shall not be grasped.
The product, as its name suggests, is intended for research and educational use.
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
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
WARNING:
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.


QBSOFTHAND RESEARCH USER MANUAL —5

•
•
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.
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 SoftHand research must be disposed of in accordance with the applicable national laws,
regulations and standards.
•
•
•
•
•
•
•
•
•
•
WARNING:
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.


6 —SAFETY
GENERAL MANUAL —SEP 8, 2022 —RELEASE:V1.1.0
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.
 

QBSOFTHAND RESEARCH USER MANUAL —7

3 Technical data
3.1 Mechanical dimensions
The figurebelow shows the overall dimensions of the qb SoftHand research, valid for both left and right
configurations;distancesand tolerances in the drawing are noted in millimeters [mm] and
degrees [°] .
Figure 1. — qb SoftHand drawings

WARNING:
Be aware that the above figure may be out of scale.


8 —TECHNICAL DATA
GENERAL MANUAL —SEP 8, 2022 —RELEASE:V1.1.0
3.2 Center of Mass
The following table gives also the position of the Center of Mass of the SoftHand and defines its
Coordinate System, like depicted in the following schemes.
UNIT LEFT RIGHT
CoM x coordinate, OTX [mm] 5 5
CoM y coordinate, OTY [mm] 3 -3
CoM z coordinate, OTZ [mm] 80 80
Weight [kg] 0.770
Center of Mass, OT, is evaluated w.r.t. ΣMconsidering the hand mounted with its palm 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.
NOTE:
All coordinate systems here described follow the orthogonal right-hand rule.


QBSOFTHAND RESEARCH USER MANUAL —9

On the right,there is the Tool Coordinate System,ΣT(OT; XT, YT, ZT), of the SoftHand. The center,OT,
coincides with the center of mass of the hand 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. This definition implies thatΣTis the same for left and right SoftHands. So, the positive
orientation ofXTaxis will be on the side of the thumb in the right hand and on the side opposite to the
thumb in the left hand.
3.3 Mechanical characteristics
MINIMUM NOMINAL MAXIMUM
Pinch grasping payload [kg] —0.83 1.10
Power grasping payload [kg] —1.70 2.10
Hanging payload [kg] —10 30
Pinch grasping force [N] —10 11
Power grasping force [N] —46 62
Grasping time [s] — — 1.1
Releasing time [s] — — 1.1
Look at the graph for details.

Figure 3. — Maximum grasping force chart

10 —TECHNICAL DATA
GENERAL MANUAL —SEP 8, 2022 —RELEASE:V1.1.0
Figure 4. — Maximum payload chart
Figure 5. — Chart notes

3.4 Electrical characteristics
MINIMUM NOMINAL MAXIMUM
Power supply voltage [VDC] 23.1 24 24.8
Power consumption [W] 1.4 18 30
Current limit [A] —0.75 *
Operational time [s] — — 300

QBSOFTHAND RESEARCH USER MANUAL —11

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
3 https://www.phoenixcontact.com/online/portal/us?uri=pxc-oc-itemdetail:pid=1098315
•
•
•
•
•
•
•
MINIMUM NOMINAL MAXIMUM
Duty cycle [%] — — 69
Operating temperature [°C] -15 20 40
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 SoftHand flange there is aPhoenix Contact 8-position M8 connector, A-coded, withgold-plated
copper alloy contacts — Part Number: 14242321.
The following cables are compliant and recommended:
Phoenix contact: 3m free cable end with angled socket — Part Number: 14041922
Phoenix contact: 30mm female/female with angled sockets—Part Number:10983153
The RS485 protocol characteristics are as follow:
8 bit;
no parity;
1 stop bit;
no flow control;
2M baud rate.

12 —TECHNICAL DATA
GENERAL MANUAL —SEP 8, 2022 —RELEASE:V1.1.0
# WIRE COLOR DESCRIPTION
1 White RS485+
Figure 6. — User view

2 Brown RS485-
3 Green —
4 Yellow —
5 Gray 24V ***
6 Pink GND ***
7 Blue 24V ***
8 Red GND ***
*** 24VDC and GND must be provided by an isolated Power Supply Unit.
WARNING:
Any error in the pins connection may cause irremediable damages to the device.


QBSOFTHAND RESEARCH USER MANUAL —13

•
•
•
•
•
4 Description
4.1 General
qb SoftHand Research is an anthropomorphic robotic hand based on soft-robotics technology. It is
flexible, adaptable and able to interact with the surrounding environment, objects, or even humans while
limiting the risk of injuring operators, spoiling products, or damaging the robot itself.
Thanks to its soft nature the SoftHand by qbrobotics exploits the principles of synergies in an intrinsically
intelligent design that is not only safe w.r.t. unexpected human-robot interaction, but also adaptable to
grasp different shaped objects without any change in the control action — i.e. showing an unparalleled
level of simplicity and flexibility.
The combination of these innovations results in a flexible prehensile device that can grasp a wide variety
of objects. The single-motor actuation makes the hand plug-and-play, simple to control (one single motor
requires one single control signal to either close or open the whole hand), and affordable.
The custom-made electronic board inside the qb SoftHand Research is composed of a logic stage for
communication and low-level computation, and a power stage for motion control. This, together with a
DC motor and its absolute encoder, establishes a simple position and current control feedback regulated
by a properly tuned PID controller.
The qb SoftHand is generally shipped with a qb Adapter Board equipped with a 3 meter-length cable.
The qb SoftHand Research 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.2 Characteristics and key features
Flexibility, adaptivity and robustness thanks to the soft-robotics design;
19 anthropomorphic DOFs controlled in one single synergy motion;

14 —DESCRIPTION
4 mailto:[email protected]
GENERAL MANUAL —SEP 8, 2022 —RELEASE:V1.1.0
•
•
•
•
•
•
•
•
•
•
Dislocatable and self-reposition phalanges;
Up to 60 N grasping force*;
Up to 2.0 kg maximum payload*;
Maximum closure time of 1.1 s;
Total weight of 770 g (including aluminium flange and screws);
Universal Robots + plug-and-play certified;
ROS packages and general C++ API available;
* Grasp forces and payloads highly depend on object dimensions and approaching strategy (cf. Mechanical
Characteristics(see Page 7)).
4.3 Standard customization
Mechanical flange adapters for non-standard robot flanges;
Left and Right chirality configurations;
Five distinct cover colors: dark-grey, orange, electric-blue, blackand white.
NOTE:
We may evaluate other customization for special partners; for requests, please contact our
sales team4.


QBSOFTHAND RESEARCH USER MANUAL —15

5 Mounting and wiring
5.1 Tool mounting
The qb SoftHand research kit allows you to connect the device to the robot arm.
The device can be mounted on any robot equipped with a mounting interfaceISO 9409-1.
To assemble the hand on the robot arm, please follow thefollowing instructions:
INSTRUCTIONS
1Insert (1) into the 6 mm hole on the wrist.

Use only the screws provided within the package. Longer screws could damage the robot or
the hand!


16 —MOUNTING AND WIRING
GENERAL MANUAL —SEP 8, 2022 —RELEASE:V1.1.0
INSTRUCTIONS
2Center (2) on the wrist diameter 63 mm,
taking care that the cylindrical pin (1) fits
into one of the four d6 reamed through
holes.

3Fasten (2) to the robot wrist by tightening
the four screws (3).
You need the 5 mm Allen wrench.

4Center (4) on the diameter 63 mm of (2),
taking care that the plug fits into one of the
four d6 mm through holes.
