Kinova JACO Write

Writes joint and finger position commands to the JACO (Gen1) robot.

Library

QUARC Targets Beta/Devices/Third-Party/Kinova/Robots/JACO

Description

The Kinova JACO Write block is used to send joint and finger commands to the Kinova JACO 6 degree-of-freedom (DOF) robot.

Limitations

CAUTION: Open Architecture Robot!

When using this block, the JACO robot becomes an open architecture system. This block is intended for mature and experienced engineers only! The user must understand the difference between an industrial controller and an open architecture controller. If it is unclear contact Quanser immediately at tech@quanser.com.

The user is solely responsible for the implementation of the open architecture controller! Quanser and Kinova are not responsible for any material or bodily damage that ensues from the use of this equipment.

Do not approach the robot when the arm or the controller are powered up! Install the robot in a safe location and ensure no personnel approaches the robot while it is in operation or while the arm is powered.

All software using this block supplied by Quanser is only to be considered a sample and should not be used on a regular basis. The user should write their own open architecture control software.

Fully read this document as well as the Kinova JACO Read block documentation before connecting the QUARC external PC to the JACO robot.

Operating Procedure

The robot controller communicates with the QUARC external machine (i.e., the QUARC target machine which is running the QUARC model) via two Controller Area Network (CAN) bus links. The exchanged data are transmitted via the CANbus protocol and the QUARC target machine must have a CANbus connection to the robot.

Joint Rate Limitations

The JACO robot is designed to operate within specific velocity and current limitations. The table below outlines the limitations of the JACO's joints for the Standard JACO robot. It is up to the user to regulate the rate of commands to the JACO in the user's controller.

The table below outlines the limitations of the JACO's joints for the Fast JACO robot.

Joint angle limitations

The JACO robot's joints are designed to operate within minimum and maximum angle limits. The table below outlines the joint angle limits for the JACO robot.

Sample Time Limitations

The communication cycle of the JACO takes approximately 1.2ms. The Kinova JACO Read block parameter Use separate thread for read and write operations is enabled by default, which executes the JACO communication cycle in an asynchronous thread. If this option is not selected, it is recommended that the sample time of the JACO blocks be set to 2ms or slower to avoid sample delays.

Installation Requirements

The Kinova JACO Write block uses a specific CAN controller card to interface with the JACO. The CAN card used with the JACO is the Peak System PCAN-PCI Express Dual Channel opto-decoupled card (part number IPEH-003027). Note: PCAN PCI dual-channel cards may also be used. The JACO provides two CANbus cables labeled CAN 1 and CAN 2, which must be connected to the Peak CAN card channels 1 and 2, respectively.

In order to use the Kinova JACO Write block, the Peak CAN drivers and API files must be installed. The API used for the Kinova JACO Write block is the PCAN-Basic API (April 2011 or later), which can be downloaded from the PEAK-System website. First, follow the instructions to install the PCAN drivers that are included with the Peak CAN device. Next, navigate to the directory PCAN-Basic API on the installation disk and copy the PCAN-Basic API directory to the installation directory, e.g. C:\Program Files\PCAN. Finally, add the directory containing the PCANBasic.dll file to the system PATH environment variable, e.g. C:\Program Files\PCAN\PCAN-Basic API\Win32.

Input Ports

jaco

A reference to the JACO robot that must be connected to the jaco output port of the Kinova JACO Read block. Failure to connect this signal to the Kinova JACO Read block will result in an error being generated.

command

A 9-vector containing the six joint angle commands (in degrees) and three finger positions commands (in counts). Note: the finger actuators are presently disabled.

enable

An enable signal that is used to control when new command values are to be sent to the JACO. A value of 0 (false) disables the Kinova JACO Write block and the joint/finger commands are not sent. A value of 1 (true) enables the Kinova JACO Write block and commands values are sent to the JACO. If the Kinova JACO Read block specifies the option to perform read and write operations in a separate thread, then this signal enables the Kinova JACO Write block to copy the latest command values to that thread. If the JACO blocks are not using an asynchronous thread for read and write operations, this enable signal will enable or disable the communication cycle (reads and writes) between the host computer and the JACO.

Output Ports

This block has no output ports.

Parameters and Dialog Box

Sample time

The sample time of the block. A sample time of 0 indicates that the block will be treated as a continuous time block. A positive sample time indicates that the block is a discrete time block with the given sample time.

A sample time of -1 indicates that the block inherits its sample time. Since this is a source block, only inherent the sample time when it is placed in a conditionally executed subsystem, like a Triggered or Enabled Subsystem, or in a referenced model.

To use the fundamental sampling time of the model, set the sample time to qc_get_step_size, which is a QUARC function that returns the fundamental sampling time of the model.

Targets

Copyright ©2024 Quanser Inc. This page was generated 2024-04-16. Submit feedback to Quanser about this page.

Link to this page.