Check DI

You are viewing an old version of the documentation. You can switch to the documentation of the latest version by clicking the top-right corner of the page.

From version 1.8.0, the “Check DI List” Step is merged with the “Check DI” Step to form the new “Check DI” Step.

Function

In robotics industry, DI usually stands for digital input. DIs are usually used to check and monitor the status of external devices or sensors.

This Step can be used to read the DI of a specified port and execute different branches (subworkflows) based on the DI.

alt

Application Scenario

  • Detect whether the box is dropped during depalletizing.

  • Detect whether the vacuum gripper is attached to the box firmly during depalletizing.

  • Detect specific DIs.

Parameter Description

General Parameters of Non-Move Steps

Skip Execution
None

Default setting. Do not skip the current Step.
Simulation only

Skip the current Step during simulation. The exit port is specified by Out Port When Skip.
Always

Skip the current Step when the project is simulating or running. The exit port is specified by Out Port When Skip.
Instruction

When Simulation only or Always is selected, the current Step will be skipped and the subsequent Step will be executed when running the project. If this parameter is set to None in “Check DI” Step in the project, and there is no external input signal during simulation, the project will be stopped when executing to this Step. In this case, setting the parameter to Simulation only or Always enables the simulation to continue.
Out Port When Skip

This parameter will take effect when Skip Execution is set to Simulation only or Always. It specifies the exit port when skipping a Step.

If the Skip Execution parameter is set to None, a random DI value will be provided, and the exit port of this Step is random.

Pre Plan Out Port

The Planning refers to the process when the software attempts to find a collision-free path that the robot can follow to reach the target position.

For Steps that may interrupt the planning, the software cannot predict the actual exit port of these Steps during planning. In this case, an exit port can be specified for pre-planning so that the software can skip this Step and plan in a holistic approach.

The “Check DI” Step requires a real DI to be detected first until the branch can be executed, which will interrupt the planning. To run the whole workflow continuously and make the robot moves more smoothly, you can specify the exit port for pre-planning and therefore the branch connected with the port can be executed.

  • When this parameter is set to −1 (default), this Step will be executed to check the current DI and interrupt the overall planning.

  • When it is set to 0 or any integer larger than 0, the workflow will take the corresponding exit port to continue execution, and an overall planning can be achieved together with the Steps before and after the current Step. As a result, the overall motion of the robot will be much smoother.

Besides, if the actual exit port does not match the Pre Plan Out Port, the planning will be performed again based on the actual exit port.

Operation Mode

Source

The source of the DI can be set to either “Vision Move” or “Custom”.

  • Vision Move

    This option applies to box depalletizing scenarios only. According to the area covered by boxes on the bottom surface of the vacuum gripper, the software will automatically compute the DI port numbers that should be checked.

  • Custom

    Set the DI ports and values to be checked manually. Please follow these steps to configure.

    1. Click + to add ports based on the number of ports to be checked.

    2. Set the port numbers and values to be checked, and you can comment on the function of the current port.

      alt

      • The port numbers cannot be duplicated. The configuration cannot be completed with duplicated port numbers.

      • To clarify the function of each port, it is recommended to add a comment for each port.

      • Select the line of a specific port and click - to delete the port configuration.

Logical Condition

  • Any one satisfied: Successful if any one signal satisfied the condition, and the project will proceed along the corresponding exit port.

  • All satisfied: Successful if all signals satisfied the condition, while failed if any one signal did not satisfy the condition.

Check Mode

  • Check once

    Check once immediately when the Step is triggered.

  • Check continuously

    Check continuously before a timeout occurs. If the signals satisfy the “Logical Condition,” the project will proceed along the corresponding exit port.

    You can set a “Timeout.” If the specified signal is not detected within the timeout, the branch connected with the “Timeout” exit port will be executed. If the “Set Timeout” parameter is not selected, the check will continue until the signal(s) satisfies the logical condition.

Examples

  • When the Source is set to “Vision Move,” please go to Tools in the resource tree, click “Configure depalletizing vacuum gripper” in the Tool Configuration window to configure the DI port and values.

    Parameter Settings

    Description

    Any one satisfied + Check once

    If any one signal satisfies the condition, the workflow will continue through the “Any one satisfied” exit port. If none of the signals satisfy the condition, the workflow will continue through the “None satisfied” exit port.

    Any one satisfied + Check continuously

    Check continuously before a timeout occurs. If any one signal satisfies the condition, the workflow will continue through the “Any one satisfied” exit port. If a timeout occurs, the workflow will continue through the “Timeout” exit port.

    All satisfied + Check once

    Only when all signals satisfy the condition, the workflow will continue through the “All satisfied” exit port, or else the workflow will continue through the “One or more not satisfied” exit port.

    All satisfied + Check continuously

    Check continuously before a timeout occurs. Only when all signals satisfy the condition, the workflow will continue through the “All satisfied” exit port. If a timeout occurs, the workflow will continue through the “Timeout” exit port.

  • When the source is set to “Custom,” an example of adding three ports: DI1, DI2, and DI3 is used for the illustration.

    Parameter Settings

    Description

    Any one satisfied + Check once

    If any one signal satisfies the condition, the workflow will continue through the corresponding exit port. If none of the signals satisfy the condition, the workflow will continue through the “None satisfied” exit port.

    Any one satisfied + Check continuously

    Check continuously before a timeout occurs. If any one signal satisfies the condition, the workflow will continue through the corresponding exit port. If a timeout occurs, the workflow will continue through the “Timeout” exit port.

    All satisfied + Check once

    Only when all signals satisfy the condition, the workflow will continue through the “All satisfied” exit port, or else the workflow will continue through the “One or more not satisfied” exit port.

    All satisfied + Check continuously

    Check continuously before a timeout occurs. Only when all signals satisfy the condition, the workflow will continue through the “All satisfied” exit port. If a timeout occurs, the workflow will continue through the “Timeout” exit port.

We Value Your Privacy

We use cookies to provide you with the best possible experience on our website. By continuing to use the site, you acknowledge that you agree to the use of cookies. If you decline, a single cookie will be used to ensure you're not tracked or remembered when you visit this website.

  • Preference
  • I accept
  • I don't accept