User Manual

User Manual

Important Safety Precautions

This section describes the safety requirements that must be met during the installation and operation of the OmniPicker 3. As OmniPicker 3 is a partly-completed machinery, it is essential to carefully read this manual and fully understand the relevant safety features and potential hazards prior to first use. All relevant personnel must conduct risk assessment before each OmniPicker 3 installation and strictly adhere to all instructions in this manual during operation.


1.1 Notes for Use


  • Do not place OmniPicker 3 in environments with high temperature, high humidity, or flammable or explosive substances. Keep it away from open flames, and do not operate it in strong electromagnetic fields, such as near high-voltage power lines or high-power machinery.

  • Do not apply excessive force to the gripper fingers or pull the gripper forcibly. Do not subject OmniPicker 3 to excessive loads or impacts.

  • Do not use OmniPicker 3 to grasp objects that are excessively heavy, hot, sharp, rough-surfaced, or corrosive.

  • Do not use OmniPicker 3 to operate hazardous machinery. The Company accepts no liability for personal injury or property damage resulting from such use.

  • Do not touch the surfaces of OmniPicker 3 during or immediately after operation, as they may become hot and cause burns.

  • Do not allow minors to operate OmniPicker 3 unsupervised. Where use is necessary, it must take place under the continuous supervision and guidance of a qualified adult.

  • Do not perform powered operation or commissioning without having received product safety training and familiarity with the operating logic and safety rules of the equipment.

  • Do not operate OmniPicker 3 under the influence of alcohol or fatigue, or after taking medication that impairs judgment or reaction time. Do not allow persons with impaired mobility or cognitive ability to operate OmniPicker 3 unsupervised.

  • Before operation, make sure all cables, plugs, and sockets are intact. Disconnect the power supply immediately if an abnormal condition occurs, such as a short circuit or overheating.


1.2 Risk Assessment


List of Potential Hazards:

  • Mechanical hazards: Crush injuries, abrasions, etc., caused by contact with the OmniPicker 3 or any sharp object being held.

  • Electrical hazards: Electric burns or electric shock from contact with live parts.

  • High-temperature hazards: Skin burns from prolonged contact with hot surfaces of OmniPicker 3.

  • Noise hazard: No significant hazard identified.

  • Vibration hazard: No significant hazard identified.

  • Radiation hazard: No significant hazard identified.

  • Material/substance hazard: No significant hazard identified.

  • Ergonomic hazard: Pinching injuries from contact with gaps between components.

  • Environmental hazards: No significant hazard identified.


1.3 Warranty and After-Sales Service


OmniPicker 3 is covered by a 6-month limited warranty. If any defect due to manufacturing or material flaws occurs after the Product is put into use, we(the Company) will provide necessary spare parts for replacement or repair. The product warranty shall be void if defects result from improper handling, failure to follow the instructions provided in the manual, or unauthorized disassembly of the product. Without prejudice to the terms of this warranty, if the Product has exceeded its warranty period, we reserve the right to charge customers for the cost of replacement or repair.

Beyond the warranty period, if the device exhibits any defect, we shall not be held liable for any damages or losses incurred, including but not limited to production losses or damage to other production equipment.

Except for the operations expressly permitted in this manual, unauthorized disassembly of the Product is strictly prohibited. Otherwise, the warranty-related clauses in the Hardware Sales Agreement will become invalid. If any malfunction occurs, please contact after-sales service personnel promptly.

Customers may separately purchase extended warranty services or OmniCare+ services. Please contact the sales or customer service team for details.


1.4 Disclaimer


We(the Company)  are committed to continuously improving the product reliability and performance, and therefore reserve the right to make product improvements or upgrade without further notice. We strive to ensure the accuracy and completeness of this Manual but shall not be held liable for any errors or omissions it may contain. Due to ongoing product improvements, version updates, or typesetting and printing, the content of this Manual may differ from the actual product. The actual product and the latest information released by the Company shall prevail. If you find any error or omission, please contact us promptly. Defects or malfunctions caused by the following circumstances are not covered within the scope of warranty:

  1. Failure to install, wire or connect other control devices as required by the user manual;

  2. Unauthorized disassembly/assembly of OmniPicker 3;

  3. Use of OmniPicker 3 beyond the specifications or standards stated in the user manual;

  4. Damage resulting from improper transportation;

  5. Damage caused by accidents, impacts, or collisions;

  6. Damage caused by natural disasters, including but not limited to fire, earthquakes, tsunami, lightning strikes, strong winds and floods;

  7. Hot-plugging of power or signal cables while the gripper is powered on is not supported. Users must follow the specified operating procedures; the customer shall bear the corresponding responsibility for any fault caused by hot-plugging that does not comply with these requirements;

  8. Any product damage or other loss caused by the use of non-specified tools, or by disassembly or assembly not performed according to the specified method, shall be borne by the operator.

We shall not be held liable for any loss, damage, injury or expense caused by customers violating the disclaimers in this Section. Customers are kindly requested to carefully read and agree to this disclaimer before purchasing and using the Product.


1.5 Maintenance and Storage Instructions


To ensure the long-term stable operation of OmniPicker 3, please follow the maintenance and storage requirements below.

  • For long-term storage, it is recommended to store the product in a dry environment with suitable temperature, away from direct sunlight, corrosive gases, strong electromagnetic interference, fire sources, and heat sources.

  • During long-term storage, disconnect the power cable and communication cable. Avoid keeping the gripper under continuous load, bending, compression, or suspended conditions for extended periods. It is recommended to use the original packaging or protective packaging with dust-proof and shock-resistant features for storage.

  • Without proper protection, OmniPicker 3 must not come into contact with liquids (such as alcohol, water, beverages), dust, or corrosive substances. Avoid exposure to rain. If accidental contact occurs, immediately disconnect the power supply and inspect the interfaces, joints, and housing condition.

  • Do not soak OmniPicker 3 in water or spray cleaning liquids onto it. Do not use alcohol, strong acids, strong alkalis, corrosive cleaners, volatile solvents, or abrasive materials to clean the gripper. A clean, dry soft cloth may be used to wipe the surface of the rigid housing to remove dust.

  • Regular maintenance and inspection should be performed to ensure that components such as motors and power systems operate normally, preventing potential hazards caused by aging or damage.

  • If the gripper malfunctions, do not disassemble it yourself or continue forced operation. Record the fault symptoms, occurrence time, operating environment, load conditions, and abnormal warnings, then contact after-sales service personnel promptly. Damage caused by unauthorized repair, disassembly, modification, or use of non-original spare parts may invalidate warranty coverage. Related risks shall be borne by the user.


Product Introduction


2.1 Product Overview


OmniPicker 3 is a high-performance, cost-effective industrial two-finger gripper. Lightweight and fast-acting, it combines tactile sensing, strong gripping performance, and data-collection-friendly design. It serves as a standard end effector for humanoid robots and is widely applicable to embodied industrial data collection and task execution.


2.2 Product Highlights


  • Steady · Lightweight and powerful Under 800g in total weight with 140N gripping force, delivering an exceptional force-to-weight ratio and stable handling of 5kg payloads.

  • Precise · Absolute pressure sensing High-precision absolute pressure sensing. Force values can be set directly, remain consistent across devices, and do not drift over time.

  • Fast · Rapid actuation Minimum closing time of 0.4s, significantly improving grasping cycle time and data collection efficiency.

  • Wide · Extended stroke Maximum stroke of 110±5mm with enveloping grasp support, covering a broader range of object sizes.

  • Million-cycle service life High-strength aluminum alloy and alloy steel construction, with a service life of over one million cycles.

  • Modular design Multiple finger options are available for different workpieces, and the tactile module can be replaced independently without returning the entire unit for service.

  • AI-Native data collection Deeply compatible with data collection systems, with optional finger-mounted tactile sensing and cameras. Collected data can be used directly for model training.


2.3 Product Specifications


Basic Parameters

Weight

<800g

Dimensions

Body length 98.5mm (excluding linkage and fingers) Maximum width 165mm Thickness 60mm

Opening/closing time

0.4s @ 60mm

Maximum gripping force

140N

Maximum stroke

110±5mm

Finger Repeatability

±0.1mm

Payload

Rated 3kg / Maximum 5kg

Operating voltage

Nominal 24V, range 24~80V

Operating current

Rated 0.125A (6mm, 100N), peak 5A/10ms

Communication interface

CAN-FD, RS485

Operating temperature

-10~45°C, up to 85% RH(non-condensing)

Firmware upgrade

OTA upgrade supported

Tactile Sensor Parameters

Sensor Type

Piezoresistive strain-fusion sensor

Force resolution

0.1N

Tactile Points

70 (single finger)

Sensing Range

0–200 N (specified accuracy within 0–25 N)


Notes:

[1] The parameters in the tables above may vary depending on the application scenario and model configuration. The actual product shall prevail.

[2] RS485 is intended for secondary development and integration with customer systems. The host software currently supports CAN-FD connection only.

[3] The product appearance may be subject to future updates. The actual product shall prevail.


2.4 Appearance and Dimensions



2.5 Tactile Point Distribution


All coordinates in this section are given in millimeters.


  • The measurement reference frame is the end-effector finger frame of the standard OmniPicker 3 URDF model. The positive X direction points outward, perpendicular to the page.

  • The tactile array consists of 70 points in total. All points share a constant X coordinate of 4.76 mm — that is, they lie on the same plane at X = 4.76 mm — and are arranged in a regular rectangular grid of 8 rows × 10 columns in the Y–Z plane.



2.6 Environmental Protection and Disposal Declaration


This product is classified as Waste Electrical and Electronic Equipment (WEEE). When disposing of this product, please follow the requirements of the WEEE Directive.

The product must not be disposed of together with ordinary household waste. After the product reaches the end of its service life, it should be delivered to a qualified local electronic waste recycling facility for professional classification, recycling, and harmless disposal. Proper disposal helps recover valuable resources and reduces potential impacts on the ecological environment.

This product strictly complies with RoHS environmental protection regulations. The content of hazardous substances in all product components meets the legally defined limits.


2.7 Manufacturer Information


Manufacturer Name

AGILINK Innovations & Intelligence Technology Co., Ltd.

Manufacturer Address

Room 1107, 11F, No. 185 Tianping Road, Xuhui District, Shanghai

Contact

021-20960883


Unboxing and Installation Guide


3.1 Packing List


OmniPicker 3 Packing List (Standard Items)

No.

Description

Quantity

1

OmniPicker 3 (with dust bag)

1

2

Combined communication & power cable (incl. CANFD/RS485 communication)

1

3

Quick-start guide (one-pager)

1

4

Factory certificate of conformity

1

5

Captive screws (M4*8)

7

6

Hex wrench

1

7

Screw/wrench packaging bag

1


The table above lists all standard items included with the product. Please check the contents of this list after unpacking.

The following optional accessories are not included in the standard packing list and can be purchased separately as needed: power adapter and power adapter cable, single-channel USB-to-CAN-FD adapter.


3.2 Installation Instructions


This section describes the materials, tools, and procedures required to install OmniPicker 3 on a robotic arm or an adapter flange.


3.2.1 Design the Adapter Flange

Based on the flange dimensions at the OmniPicker 3 mounting end (see Section 4.1 Mechanical Interface for flange specifications), design an adapter flange that connects OmniPicker 3 on one side and your robotic arm or other equipment on the other.

The following installation procedure uses the adapter flange designed in this document as an example.



STEP 文件



3.2.2 Required Materials and Tools


No.

Item

Quantity

1

OmniPicker 3

1

2

M4*8 hex socket head cap screw (screw length varies with the adapter flange dimensions)

5

3

Adapter flange

1

4

3mm hex key (3mm across flats)

1



3.2.3 Installation Procedure

STEP 1:  As shown in the figure, prepare one OmniPicker 3, one adapter flange (already matched to the OmniPicker 3 flange), and five M4×8 hex socket head cap screws. The screw length depends on the dimensions of the adapter flange; 8 mm is used in this example. Ensure that the thread engagement length inside the OmniPicker 3 flange is at least 4 mm.

STEP 2: As shown in the figure, mount OmniPicker 3 onto the adapter flange and tighten the five M4 screws. Refer to the table below for the recommended tightening torque.



Recommended tightening torque for M4 screws

Tighten to 1.25 –1.5 N·m using a calibrated torque wrench.


3.3 Troubleshooting


Issue

Solution

Hardware fault

  1. Reversed power polarity or overvoltage will damage the gripper. Verify the power polarity and voltage range before wiring.

  2. The DIP switches must be set in pairs, and only one communication mode may be selected at a time; otherwise a communication fault will occur.

SDK troubleshooting

For common issues when driving the device through the SDK, refer to:

https://github.com/AgibotTech/agillink_omnihand_sdk/blob/main/doc/zh_cn/TROUBLESHOOTING.md.

Host software troubleshooting

For host software issues such as firmware upgrade failures, refer to Section 6, Host Software User Guide.

Severe wear of finger pads

Replace the fingers. See "Accessory Replacement Procedure" for details.

Communication failure

Confirm the communication mode before use; OmniPicker 3 uses CAN-FD by default. To switch modes, adjust the DIP switches:

  1. Remove the flange assembly to expose the DIP switches. See Section 3.4, Other Common Operations.

  2. Set the DIP switches to the required communication mode. See Section 4.2, Electrical and Communication Interfaces.


3.4 Other Common Operations


  • Setting the DIP switches (switching the communication mode):

    • Prepare a T8 Torx key and remove the four M3×8 screws on the flange end.

    • Remove the flange to expose the DIP switches on the control board.

    • Set the DIP switches as required. See Section 4.2, Electrical and Communication Interfaces.

    • Reinstall the flange and tighten the screws to a recommended torque of 0.6 N·m.



  • Accessory replacement procedure (accessory replacement generally refers to replacing the fingers, either because a finger is damaged or to fit custom fingers):

    • Prepare a T8 Torx key and remove the four M2.5×6 screws from the finger.

    • Take out the finger, take care not to pull the cable loose.

    • Disconnect the sensor cable connector on the finger from the connector on the fixed end. The finger can then be fully removed.

    • Take the new or custom finger and connect its sensor cable connector to the connector on the fixed end.

    • Route the cable neatly into the finger mount. Make sure the cable is not pinched between the finger and the finger mount.

    • Using a torque wrench with a T8 Torx bit, secure the finger with the four M2.5×6 screws. The recommended tightening torque is 0.35 N·m. Replacement is now complete.


Interface Information


4.1 Mechanical Interface



STEP 文件




4.2 Electrical and Communication Interface


Parameter

Spectification

Operating voltage

24V (typ)

Input voltage range

24~80V

Operating current

Rated 3A,peak 5A

Voltage alarm

None

Communication interface

CAN-FD/RS485, selected by DIP switches; CAN-FD by default


  • Switching the communication mode (requires removing the flange cover; see Section 3.4, Other Common Operations)

    • CAN-FD mode: Set switches 1 and 2 to the upper "ON" position, and leave switches 3 and 4 in the lower default position. Connector pin assignment in this mode: 1 — 24V, 2 — GND, 3 — CAN_H, 4 — CAN_L.

    • RS485 mode: Set switches 3 and 4 to the upper "ON" position, and return switches 1 and 2 to the lower default position. Connector pin assignment in this mode: 1 — 24V, 2 — GND, 3 — RS485_A, 4 — RS485_B.

Electrical interface model: Board end LVC015-M, cable end LVC015-F.






    4.3 OmniPicker 3 Debug Cable Harness



    OmniPicker 3 can be connected using the OmniPicker 3 debug cable harness supplied with the gripper. One end of the harness is an LVC015-F (female) connector; the other end splits into a power cable and a twisted pair for CAN-FD or RS485 communication. The harness is 0.2 m long. The LVC015-F (female) connector mates with the LVC015-M (male) connector on the wrist side of OmniPicker 3.

    Connect the power cable to a regulated DC power supply. The twisted pair is used to send and receive CAN-FD or RS485 data; the communication mode is determined by the DIP switch settings and can be changed as required during development.

    The pin assignment of the OmniPicker 3 debug cable harness is as follows:


    LVC015 Pin

    Definition

    Type

    Description

    Wire Color

    Function

    1

    Power+

    Power

    DC 24-80V

    Red

    Power

    2

    Power-

    Power

    Ground

    Black

    3

    CAN_H/485A

    SIG

    CAN_H/485A

    Blue

    Communication

    4

    CAN_L/485B

    SIG

    CAN_L/485B

    White


    Communication Protocols


    5.1 Frame Format


    CAN-FD

    Default configuration: arbitration phase at 1 Mbps (80% sample point) and data phase at 5 Mbps (75% sample point), using the 29-bit extended identifier data frame format. Standard identifiers and remote frames are not supported.

    This device supports CAN-FD frame format only. For classic CAN 2.0 frames, the device will:

    • not parse the data

    • not send any acknowledgment

    • not generate error frames

    Messages are assembled according to the CAN-FD frame format, with the payload distributed across the arbitration field and the data field: the device ID, project number, register address, and sub-register address are carried in the arbitration field, while the data content is carried in the data field.



    The device ID, project number, register address, and sub-register address are carried in the arbitration field; The data content is carried in the data field.


    Field

    Identifier

    Length

    Description

    Notes

    Arbitration segment standard ID

    standard_identifier

    11 bits

    bit[10:6]: Sub-register address Range: 0x00~0x1Fbit[5:0]: Upper 6 bits of the register address (see below for range)


    Arbitration segment extended ID

    extended_identifier

    18 bits

    bit[17:16]:  Lower 2 bits of the register address; together with the lower 6 bits of the standard ID, these form the complete register address byte bit[15:8]: Fixed at0x01bit[7]: Read/write flag 0 = read register 1 = write register bit[6:0]: Device ID Range: 0x00~0x7F

    For device ID, 0x7F is the broadcast address. A node receiving data with this ID still replies using its own ID.

    Data field

    data

    n

    Data content corresponding to the register




    5.2 Register Description


    General register definitions

    No.

    Register Address

    Register Name

    Sub-register

    Sub-register Name

    Register Content

    Register Length

    Read/Write Permission

    Pn1

    0x01

    Manufacturer Information

    0x00

    Sub-register Operation

    Read/write all sub-registers under this register;

    48Byte(41Byte)

    Read-only

    0x01

    Product Model

    ASCII string, padded with 0x00.

    Example: "OmniPicker 3"

    16Byte

    Read-only

    0x02

    Product Serial Number

    ASCII string, fixed length; "SSCMMVVYMXXXXX"SS: Product series, 2 digits; first digit base-26 (A~Z), second digit base-10 (0~9);C: Product configuration, 1 digit, base-32 (0~Z);MM: Component number, 2 digits, base-10 (0~9);VV: BOM version, 2 digits, base-10 (0~9);Y: Year of manufacture, 1 digit, base-26 (A~Z);M: Month of manufacture, 1 digit, base-12 (1~C);XXXXX: Serial number, 5 digits, base-10 (0~9);

    14Byte

    Read-only

    0x03

    Hardware Version

    Byte 0: Major version;Byte 1: Minor version;Byte 2: Patch version;Byte 3: Reserved; Hardware version format: 'Major.Minor.Patch';

    4Byte

    Read-only

    0x04

    Software Version

    Byte 0: Major version;Byte 1: Minor version;Byte 2: Patch version;Byte 3: Reserved; Software version format: 'Major.Minor.Patch';

    4Byte

    Read-only

    0x05

    Supply Voltage

    32-bit unsigned integer; default 24000 (24.0V); unit mV;

    2Byte

    Read-only

    0x06

    Active DOF

    Number of active degrees of freedom. Example: 0x01

    1Byte

    Read-only

    Pn2

    0x02

    Device Information

    0x00

    Sub-register Operation

    Read/write all sub-registers under this register;

    5Byte

    Read/Write

    0x01

    Device ID

    Default device ID: 0x01; Device ID range: 0x01 ~ 0x7F;

    1Byte

    Read/Write

    0x02

    Communication Parameter Configuration

    Byte0 - CAN-FD arbitration phase bit rate:

    8-bit unsigned integer, default: 0x02 (1Mbps);

    0: 125kbps;

    1: 500kbps;

    2: 1Mbps;

    Byte1 - CAN-FD arbitration phase sample point:

    8-bit unsigned integer, default: 0x01(80%);

    0: 75.0%;

    1: 80.0%

    2: 87.5%;

    Byte2 - CAN-FD data phase bit rate:

    8-bit unsigned integer, default: 0x03(5Mbps);

    0 - 125kbps;

    1 - 500kbps;

    2- 1Mbps;

    3 - 5Mbps;

    Byte3 - CAN-FD data phase sample point:

    8-bit unsigned integer, default: 0x00(75%);

    0: 75.0%;

    1: 80.0%

    2: 87.5%;

    4Byte

    Read/Write

    Pn6

    0x06

    Tactile Sensor (one-dimensional) full data upload

    0x00

    Upload data from all sensors

    This sub-register takes a query-type parameter and therefore behaves differently from the general sub-register operation.Query (robot → gripper)byte0: Query type0x00 = Read all sensor data0x01 = Read the number of tactile sensors0x02 = Read the total number of tactile sensing points0x03 = Read the total data length of all tactile sensors0x04 = Read the total number of reply frames for all tactile sensor data0x05 = ReservedReply (gripper → robot)byte0: Total number of reply frames (e.g., 0x0A for 10 frames). The gripper then sends 10 consecutive frames, transmitting all sensing point data in sensor orderbyte1: Current frame index (0 to total frames − 1)byte2–byte63: Data bytes, transmitted in sequence

    Variable; depends on the query type and sensor configuration. Use query type 0x02 (total data length) and 0x04 (total number of reply frames) to obtain the actual values at runtime.


    0x01

    Sensor 0 Data

    • Query command (robot body to dexterous hand):

    byte0: query type.

    0x00 = Get all data of sensor 0

    0x01 = Query total number of tactile sensor points of sensor 0

    0x02 = Query total data length of sensor 0

    0x04 = Query total reply frames for all data of sensor 0

    0x05 = reserved

    • Reply (dexterous hand to robot body)

    byte0: total reply frames, e.g., if 10 frames, this value is 0x0A; 10 frames will be sent consecutively in sensor order to transmit all point data

    byte1: current frame number (minimum 0, maximum is total frames - 1)

    byte2~byte63: start transmitting all bytes sequentially



    0x02

    Sensor Data

    Same format as 0x01, continuing in sensor index order



    ...





    Pn19

    0x13

    Position Control

    0x00

    Sub-register Operation

    Read/write all sub-registers under this register;

    Single sub-register length × active DOF

    Read/Write

    0x01

    Target position of joint motor #1

    16-bit signed integer; default 0; unit: 1/4096 of maximum position

    Two bytes represent one joint motor; valid values are defined per product

    Write: sets the target position and returns the current actual position

    Read: returns the current actual position

    2Byte

    Read/Write

    ...

    ... ...

    ... ...

    ...


    Host Software User Guide


    The OmniHand-ToolBox host software is a general-purpose software which supports both OmniHand series and OmniPicker series,  use the software to connect to OmniPicker 3 and to control gripper opening and closing, create action sequences, view finger tactile data, and upgrade firmware.

    From version 2.7.2 onward, the left-hand navigation pane contains four pages: Main Interface, System Log, Firmware Upgrade, and Settings. These are described in Sections 6.4 to 6.7.


    6.1 Operating Environment


    Item

    Requirement

    Operating System

    Windows 10 / 11 (64-bit); Ubuntu 22.04 LTS (64-bit)

    CPU

    Intel Core i5 8th gen or later (dual-core 1.5 GHz or above)

    Memory

    8GB or more

    Display

    OpenGL 3.3 or later (integrated graphics are sufficient), 1920×1080 or higher resolution recommended

    Communication hardware

    Singal-channel or Dual-channel USB to CAN-FD adapter (ZLG or HCAN), with the corresponding CAN-FD driver installed

    Software dependencies

    The installation package includes the Qt runtime libraries and the SDK; a separate Qt installation is not required

    The host software communicates with the gripper over CAN-FD. Install the supplied CAN-FD device driver before use.


    6.2 Download and Installation


    Download the OmniHand-ToolBox software package from the official website.

    AGILINK official website link: https://cn.agilink-ai.com/omni-picker3.html

    1. Windows

      1. Download and run the Windows installer, then follow the on-screen instructions to complete the installation. Shortcuts are created on the desktop and in the start menu.

      2. Double-click OmniHand-ToolBox to launch the host software.

    2. Ubuntu 22.04 (.deb package)

      1. sudo apt remove omnihand-toolbox

        sudo apt install ./omnihand-toolbox_<version>_<architecture        >.deb

      2. Installation — run the following command in the directory containing the .deb file (use the actual file name of your download):

      3.   Using apt install ./xxx.deb resolves dependencies automatically. After installation, OmniHand-ToolBox appears in the application menu, or can be launched from a terminal by running omnihand-toolbox.

      4. Uninstallation:

    This manual corresponds to host software version v2.7.2. The actual version is shown in the software title bar and in the "Host software version" row of the device information panel on the main interface. 


    6.3 Login 



    After launching the software, the login screen appears. The username and password are pre-filled as user / user; click Login to enter the main interface — no manual entry is required. The language drop-down list in the upper-right corner switches the interface language. Simplified Chinese and English are currently supported.


    6.4 Main Interface



    6.4.1 Interface Layout

    After logging in, the main interface appears. The window is divided into five areas from left to right(Navigation and four columns of functions):

    • Navigation pane (left): Main Interface, System Log, Firmware Upgrade, and Settings.

    • Device column (first column): Quick Connect (see 6.4.2), display toggles, device information (see 6.4.3), and the joint status matrix and polling controls (see 6.4.4).

    • Curve column (second column): Acquisition toggle and real-time curves (see 6.4.5).

    • Control column (third column): Control mode, debounce, action presets, and the gripper position slider (see 6.4.6).

    • Action and tactile column (fourth column): Three tabs — Preset Actions, Custom Actions, and Action Sequences (see 6.4.7) — with the finger tactile display area below (see 6.4.9).

    A row of five display toggles is located above the device information panel: Curve, Control, Action, Model, and Tactile. Clearing a checkbox hides the corresponding pane and frees up screen space for the other areas. Note that the Tactile toggle also stops tactile data acquisition when the area is hidden. Since OmniPicker 3 does not provide a 3D model resource, the Model toggle can be left unchecked. On low-resolution displays, it is recommended to keep only the panes you currently need.



    6.4.2 Quick Connect



    Power on the gripper and connect it to the computer over CAN-FD using a USB-to-CAN-FD adapter.

    1. Select the detected CAN-FD device from the device drop-down list. If No device found is displayed, click the ⟳ button on the right to refresh.

    2. Select the product model (OmniPicker 3). The gripper has no left/right variants, so either option in the left/right hand drop-down list may be selected.

    3. Click Connect. Once the handshake succeeds, the device information panel displays the actual device information, and the button turns red and changes to Disconnect.

    For more detailed connection parameters (CAN index, channel, etc.), use the "Settings" page in the navigation pane(see 6.7).

    Troubleshooting:

    1. A device is detected but the status remains "Not connected": close and restart the host software; verify that the CAN-FD driver is correctly installed; or check whether the gripper's CAN communication parameters (bit rate and sample point) have been modified — a mismatch with the host software settings will cause the handshake to fail.

    2. No device appears in the drop-down list: check the following in order — whether the CAN-FD adapter driver is installed, whether the device is properly powered, whether the cable harness and connectors are securely seated, and whether the CAN index and channel are correctly selected.


    6.4.3 Device Status



    Device information: Displays eight items — device model, host software version, firmware version, hardware version, supply voltage, degrees of freedom, device ID, and serial number. When no device is connected, all items except Host software version display Not connected in red.

    OmniPicker 3 becomes operational as soon as it is powered on. No Enable/Disable buttons are provided; The gripper can be controlled directly once connected.


    6.4.4 Joint State Matrix and Polling



    Below the device information panel is the joint status matrix, which displays four real-time values: position, current (mA), temperature (°C), and error code. OmniPicker 3 is a single-axis gripper, so the matrix contains only one row. When no device is connected, all items display "--".

    • Polling toggle: When enabled, the software reads the above data from the gripper at the configured interval. When disabled, periodic read requests stop; the matrix and curves hold the last values read and are no longer refreshed.

    • Interval (ms): The polling interval, 300 ms by default. Click Confirm to apply a change. A shorter interval increases bus load; the default value is generally recommended.

    Click a parameter cell in the matrix to add that value directly as a real-time curve (see 6.4.5).


    6.4.5 Real-Time Curves



    At the top of the curve column are the acquisition toggles: position, current, temperature, and error code. Clearing a checkbox stops updating that value and freezes the corresponding curve.

    The next row is the curve toolbar:

    • Time window drop-down list: The duration shown on the horizontal axis, selectable from several preset values between 1 and 60 seconds.

    • Pause All / Resume All: Pauses or resumes the refresh of all curves.

    • Clear All: Clears all plotted curve data.

    • Add: Opens the Add Curve dialog box. Select a parameter to add a new curve. Available parameters include position, current, temperature, speed, torque, and error code.

    When the curve area is empty, the message Click a parameter in the matrix on the left to add a curve is displayed. Each curve has its own set of buttons for pausing, clearing, scaling the vertical axis, resetting the view, and closing it individually. Curves can also be dragged to change their order.


    6.4.6 Gripper Control



    OmniPicker 3 is a single-axis gripper, so the control area contains a single position slider for opening and closing the gripper.

    Control mode: Two modes are available. After switching modes, only the parameters required by that mode are displayed and sent.

    Mode

    Issued Parameters

    Description

    Position

    Position

    Default mode. Controls only the target position of the gripper.

    Position + Torque

    Position, Torque (mA)

    In addition to position, limits the torque current of the gripper motion, in mA.

    Debounce (ms): The minimum interval between position commands sent to the gripper while dragging the slider. Click Confirm to apply the change. When set to 0, every slider change is sent immediately — dragging quickly will generate a large number of messages. When set to a value greater than 0, a position command is sent each time the interval elapses during dragging.

    Action preset drop-down list: Lists the available custom actions. Selecting one moves the slider to the position saved in that action. The first item, None, means no action is selected. To delete an action, right-click its row in the list, or click the ✕ that appears on hover.

    Execute: Sends the current slider position to the gripper.

    Function buttons:

    • Initialize: Returns the gripper to the initial position it had when the connection was established.

    • Save action: Saves the current slider position as a custom action. Click the button and enter a name for the action; it will then appear in the Action preset drop-down list. At this point the action exists only within the software — use Export action library to save it to a file.

    • Export action library: Exports all custom actions in the action presets to a single .json file (see 6.4.8).

    • Import action library: Reads actions from a .json file and writes them into the action presets. If the file contains actions with the same names as existing ones, a confirmation dialog listing the actions to be overwritten appears before the import.

    Position slider: The axis number ("Joint 1#") is shown above the slider; below it are the target value input box and the current feedback value. Drag the slider to control the gripper's opening and closing in real time, or enter a target position in the input box and press Enter to apply it. Positions are given in motor position counts, ranging from 0 to 4095, corresponding to the full travel from closed to fully open. For body parameters such as opening/closing time, see Section 2.3.1.


    6.4.7 Preset Actions, Configured Actions and Action Sequence

    The top of Column 4 contains three tabs.


    Preset Actions




    Lists the fixed actions built into the SDK: zero position, half open, and fully open. Click any button to move the gripper quickly to that position. Built-in actions cannot be modified.


    Custom Actions




    Used to combine several saved actions into a group that runs in a loop.Custom Actions is intended for quick testing and data recording, while Action Sequences is intended for building complete workflows that can be saved and reused.

    1. Click Add to insert a new row. In that row's drop-down list, select an action from the action presets, and enter the interval (in ms) to wait after that action is executed. Rows can be added or removed as needed.

    2. When Record is selected, running data is written to a CSV file once the sequence starts; the file path is shown to the right of the checkbox. If it is not selected, the sequence is played back without recording.

    3. In the Repeat box, enter the number of loops, or select ∞ for an infinite loop.

    4. Click Start to run the group of actions in a loop, in order. The interface shows the number of loops completed. Click Stop to end the run.


    Action Sequences



    Used to arrange an action sequence consisting of multiple steps:

    • Add step: Opens a dialog box. Under Select action source, choose a custom action or a built-in preset, and enter the Interval (ms). Once confirmed, the step is appended to the step list.

    • Repeat / ∞: Sets the number of times the entire sequence repeats, or select ∞ for an infinite loop.

    • Play / Stop: Runs the sequence in step order.

    • Import / Export: Saves the current sequence to a file, or loads a sequence from a file.

    • Clear: Removes all steps from the current sequence. A confirmation dialog appears before the operation.


    6.4.8 Action Library File (JSON)

    Custom actions in the action list can be saved as a JSON file using Export action library described in 6.4.6, making them easy to reuse later or transfer between computers.

    When editing an action file manually, note that the entire file is a JSON array. Each action is a JSON object, objects are separated by commas, and the contents of each object are enclosed in curly braces. Object fields:

    • name: The name of the action.

    • pos_axis_1: The target position of the gripper. OmniPicker 3 is a single-axis device, so this is the only position field. The value range is the same as that of the position slider described in 6.4.6.


    [
      {
        "name": "Zero",
        "pos_axis_1": 0
      },
      {
        "name": "Half-open",
        "pos_axis_1": 2048
      },
      {
        "name": "Fully-open",
        "pos_axis_1": 4095
      }
    ]


    6.4.9 Finger Tactile Display



    The fingers of OmniPicker 3 are equipped with tactile sensors; see 2.3 for specifications. When the Tactile toggle is selected (selected by default) and the device is connected over CAN-FD, this area displays real-time tactile data:

    • Region readings (left): Divided into two regions — gripper face A and gripper face B — each showing the total force currently applied to that face (in g). The color bar to the left of each value shifts from blue to red as the force increases, making it easy to see at a glance which face is in contact with an object.

    • Heat map (right): Displays the force distribution of the two gripper faces side by side. Each cell corresponds to one tactile sensing point on that face. The redder the color, the greater the force at that point; the value is displayed directly on any point under load. The heat map layout matches the actual sensing point arrangement of the installed tactile sensor, and the current point-count version is indicated above it.

    When no device is connected or no tactile data is received, the area displays Waiting for OP3 tactile data…. If the display is not needed, clear the Tactile toggle to hide this area.


    6.5 System Log



    The System Log page records operational information such as model initialization, connection, control mode switching, action execution, and firmware upgrades. New entries scroll automatically to the bottom.

    • Com: When selected, records detailed information about communication sent and received.

    • Data recording: When selected, records running data to a CSV file. The file path is shown to the right of the checkbox.

    • Save log: Exports the current log contents to a text file.

    • Clear: Clears the current log display.


    6.6 Firmware Upgrade



    The Firmware Upgrade page shares the connection and device information area in the first column with the main interface. The upgrade operation area is on the right, with a row at the top showing the software version, hardware version, and serial number. To upgrade:

    1. Make sure the device is connected.

    2. Click Query version to view the current software version, hardware version, serial number, and other information.

    3. Click Start upgrade and select the firmware file (.bin) you have downloaded to begin the upgrade.

    4. The upgrade progress is printed to the log. Please wait for the upgrade to complete; on success, the log will show messages indicating that the upgrade has finished and the device is restarting.

    5. If the log shows that the upgrade has failed, click Start upgrade again to retry.

    Other buttons: Save log (exports to a .txt file) and Clear log.

    The upgrade will not start unless a firmware file has been selected. If the upgrade is interrupted or fails, the failure information remains in the log; reconnect the device as instructed and try again.


    6.7 Settings (Device Connection)



    The Settings page provides the full connection parameter configuration:

    • Product: Select OmniPicker 3.

    • Hand: The gripper has no left/right variants; Either option may be selected.

    • Connection type: ZLGCAN and HCAN, with SocketCAN also available on Linux. All of these use CAN-FD. For the communication interfaces of the gripper itself, see 4.2. RS485 connection is not yet available on the host software side and will be supported in a future release.

    • CAN index / CAN channel: Must match the USB-CAN-FD adapter in use (0 / 0 by default).

    • The switch on the right connects and disconnects the device. The text to its left shows the current status: Not connected, Connecting…, Connection failed, or Connected.

    • CAN-FD communication parameters are sent by the software using the fixed values specified in Chapter 5, and do not need to be set manually.

    Once the connection is established, the product, connection type, and connection parameters are grayed out and cannot be changed. To modify them, disconnect first.


    This manual is continuously updated. For matters not described in other manuals, please refer to the official website or contact the customer service team for information.


    Unlock the resources