Home

Awesome

<!-- * KINOVA (R) KORTEX (TM) * * Copyright (c) 2018 Kinova inc. All rights reserved. * * This software may be modified and distributed * under the terms of the BSD 3-Clause license. * * Refer to the LICENSE file for details. * --> <h1>KINOVA<sup>®</sup> KORTEX™ API Reference</h1>

<a id="markdown-description" name="description"></a>

Description

The official repository contains documentation and examples explaining how to use the KINOVA<sup>®</sup> KORTEX™ API client with C++ or Python. The repository has been tested on Windows 10, Ubuntu 16.04, Ubuntu 18.04 and Ubuntu 20.04.

<h1>Table of Contents</h1> <!-- TOC --> <!-- /TOC -->

<a id="markdown-licensing" name="licensing"></a>

Licensing

This repository is licenced under the BSD 3-Clause "Revised" License

<a id="markdown-role-of-google-protobuf-in-kortex-api" name="role-of-google-protobuf-in-kortex-api"></a>

Role of Google Protocol Buffer in Kortex API

The Kortex API uses Google Protocol Buffer message objects<sup>1</sup> to exchange data between client and server.

Google Protocol Buffer offers structured data objects with standard methods for each member field:

When using the Kortex API a developer will need to understand the Google Protocol Buffer feature set to maximize their efficiency.

<a id="markdown-quick-start-howto-cpp" name="quick-start-howto-cpp"></a>

Quick Start for C++ users

The following links provide some helpful guidance for C++ developer. You will find information about Kortex mechanism and some code examples.

<a id="markdown-quick-start-howto-python" name="quick-start-howto-python"></a>

Quick Start for Python users

To run the Python examples you will need to install the Python interpreter and the pip installation module.

Note that for C++ developers it could be useful to install the Python Kortex API to allow for quick tests and validations.

Here is some general information about the Python interpreter and the pip module manager.

<a id="markdown-quick-start-howto-modbus" name="quick-start-howto-modbus"></a>

Quick Start for modbus users

Since release 2.3.0, the Kortex API offers a modbus interface to communicate with the robot.

All the data is formatted according to this:

<a id="markdown-api-download-links" name="api-download-links"></a>

Download links

The latest download links for each arm type are reported in the table below:

Arm typeFirmwareRelease notesAPI
Gen32.5.22.5.22.6.0
Gen3 lite2.3.22.3.22.3.0

When following the link to Artifactory, to download the correct C++ API, you have to select the package for your architecture on the left-hand side tree view and then click Download on the right-hand side:

Artifactory

<details><summary>Previous releases</summary> <p> <ul> <li> Release 2.5.0 for Gen3: <a href="https://artifactory.kinovaapps.com:443/artifactory/generic-public/kortex/gen3/2.4.0/Gen3-2.4.0.swu">Firmware</a>, <a href="https://artifactory.kinovaapps.com/ui/repos/tree/General/generic-public/kortex/API/2.5.0">Kortex API</a> </li> <li> Release 2.3.2 for Gen3 lite: <a href="https://artifactory.kinovaapps.com:443/artifactory/generic-public/kortex/gen3Lite/2.3.2/Gen3-lite-2.3.2.swu">Firmware</a>, <a href="https://artifactory.kinovaapps.com/ui/repos/tree/General/generic-public/kortex/API/2.3.0">Kortex API</a> </li> <li> Release 2.3.1 for Gen3 lite: <a href="https://artifactory.kinovaapps.com:443/artifactory/generic-public/kortex/gen3Lite/2.3.1/Gen3-lite-2.3.1.swu">Firmware</a>, <a href="https://artifactory.kinovaapps.com/ui/repos/tree/General/generic-public/kortex/API/2.3.0">Kortex API</a> </li> <li> Release 2.3.0 for Gen3: <a href="https://artifactory.kinovaapps.com:443/artifactory/generic-public/kortex/gen3/2.3.0/Gen3-2.3.0.swu">Firmware</a>, <a href="https://artifactory.kinovaapps.com/ui/repos/tree/General/generic-public/kortex/API/2.3.0">Kortex API</a> </li> <li> Release 2.2.0 for Gen3: <a href="https://artifactory.kinovaapps.com/artifactory/generic-public/kortex/gen3/2.2.0/Gen3-2.2.0.swu">Firmware</a>, <a href="https://artifactory.kinovaapps.com/ui/repos/tree/General/generic-public%2Fkortex%2FAPI%2F2.2.0">Kortex API</a> </li> <li> Release 2.1.1 for Gen3 lite: <a href="https://artifactory.kinovaapps.com/artifactory/generic-local-public/kortex/gen3Lite/2.1.1/Gen3Lite-2.1.1.swu">Firmware</a>, <a href="https://artifactory.kinovaapps.com/artifactory/generic-local-public/kortex/API/2.1.0/kortex_api_2.1.0.zip">Kortex API</a> </li> <li> Release 2.0.1 for Gen3: <a href="https://artifactory.kinovaapps.com/artifactory/generic-public/kortex/gen3/2.0.1/Gen3-2.0.1.swu">Firmware</a>, <a href="https://artifactory.kinovaapps.com/artifactory/generic-local-public/kortex/API/2.0.0/kortex_api_2.0.0.zip">Kortex API</a> </li> <li> Release 2.0.0 for Gen3: <a href="https://artifactory.kinovaapps.com/artifactory/generic-local-public/kortex/gen3/2.0.0/Gen3-2.0.0.swu">Firmware</a>, <a href="https://artifactory.kinovaapps.com/artifactory/generic-local-public/kortex/API/2.0.0/kortex_api_2.0.0.zip">Kortex API</a> </li> </ul> </p> </details> <a id="markdown-build-and-run-instructions" name="build-and-run-instructions"></a>

Build and Run instructions

C++ API
Python API

<a id="markdown-reference" name="reference"></a>

Reference

<a id="markdown-useful-links" name="useful-links"></a>

Useful Links

Kinova home page:https://www.kinovarobotics.com
Google Protocol Buffers home page:https://developers.google.com/protocol-buffers