Interactions-HSG / xarm-grpc

A command-line interface for xArm-C++-SDK to interact with UFACTORY xArms
Eclipse Public License 2.0
5 stars 0 forks source link
command-line-tool cpp ufactory xarm

xarm-grpc

A gRPC service implemenation for controlling UFACTORY xArm series using the xArm-CPLUS-SDK.

The dependencies are added as subomodules, so when cloning this repository, do:

$ git clone git@github.com:Interactions-HSG/xarm-grpc.git --recursive

This project implements the following:

The proto file is defined in proto/xapi.proto based on xarm_api.h.

The following services are specific to the connection management:

Preparation

xArm-CPLUS-SDK

To use the xarm-grpc-service first install the xArm-PLUS-SDK library:

$ make -C libs/xArm-CPLUS-SDK xarm

cmake, gRPC and Protocol Buffers

Follow the gRPC's Quick start guide to install cmake, gRPC, and Protocol Buffers.

The rest of this document assumes you have installed gRPC and Protocol Buffers in ~/.local.

Build xarm-grpc-service and xarm-commander

$ mkdir -p cmake/build && cd cmake/build
$ cmake -DCMAKE_PREFIX_PATH=~/.local ../..
$ make -j

Synopsis

The gRPC service can be started using following command:

$ xarm-grpc-service start

Then use a gRPC client (e.g., xarm-commander) to send commands to the xArm.

To close the gRPC service run:

$ xarm-grpc-service stop

For further description about usage of the xarm-grpc-service, use -h or --help.

Tools

The Tools directory includes available clients for the xarm-grpc-service. Currently, the following clients are implemented:

Dependencies

How to contribute to this project?

See CONTRIBUTING.md.

Maintainers

Contributors

See here

License

See LICENSE.