gort

Gort - Command Line Interface For RobotOps

Gort (http://gort.io) is a Command Line Toolkit for RobotOps. Gort provides tools to scan for connected devices, upload firmware, and more.

Gort is written in the Go programming language (http://golang.org) for maximum speed and portability.

Want to use Golang to program your robots? Check out our open source robotics framework Gobot (http://gobot.io).

Want to use Javascript on Robots? Check out Cylon.js (http://cylonjs.com)

Want to use Ruby on robots? Check out Artoo (http://artoo.io)

Getting Started

We now have precompiled binaries! You can also build from source.

The Gort CLI provides many useful features on many hardware platforms, and has no other dependencies. You install Gort separately from any framework, which means you can use it to program Arduinos with the Firmata firmware also compatible with Cylon.js, Gobot, Artoo, & Johnny-Five.

Download

Just want to download a binary for OSX, Windows, and Linux? Go to our web site at http://gort.io/documentation/getting_started/downloads/ for the latest release.

Using Homebrew on OSX? You can install using:

brew install hybridgroup/tools/gort

How To Use

$ ./gort
NAME:
   gort - Command Line Utility for RobotOps

USAGE:
   gort [global options] command [command options] [arguments...]

VERSION:
   0.7.0

COMMANDS:
     scan       Scan for connected devices on Serial, USB, or Bluetooth ports
     bluetooth  Connect & disconnect bluetooth devices.
     arduino    Install avrdude, and upload HEX files to your Arduino
     particle   Upload sketches to your Particle Photon or Electron
     digispark  Configure your Digispark microcontroller
     crazyflie  Configure your Crazyflie
     klaatu     barada nikto
     help, h    Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --help, -h     show help
   --version, -v  print the version

Scan for connected serial devices:

$ gort scan serial
[    0.000000] console [tty0] enabled

More help coming soon...

Building

To install the required dependencies to build gort, run:

make deps

You build the assets into the project like this:

make assets

Then build the binary with:

make build

Compiled binaries will now be placed in build/<VERSION>/

Release

When you are ready, run:

make release

For OSX users, you will also need to update the homebrew repo, located at https://github.com/hybridgroup/homebrew-tools

To obtain the needed SHA values to update homebrew recipe, run:

make homebrew

Contributing

For our contribution guidelines, please go to https://github.com/hybridgroup/gort/blob/master/CONTRIBUTING.md .

Release History

Version 0.6.3 - Update Firmata HEX file to version 2.5

Version 0.6.2 - Correct Debian control file

Version 0.6.1 - Add Debian control file

Version 0.6.0 - simplify and cleanup bluetooth commands

Version 0.5.0 - Adds board-type flag to Arduino upload command to support many more kinds of boards, refactor Bluetooth command params to be in a more logical order

Version 0.4.1 - Corrections for bad merge

Version 0.4.0 - Bluetooth commands use pure hcitool/rfcomm to avoid dependencies on Linux, Spark is now Particle, remove dronedrop commands

Version 0.3.0 - Add dronedrop commands

Version 0.2.4 - Update voodoospark to 2.3.1 and bug fixes

Version 0.2.3 - Update Windows compatibility and default Spark code

Version 0.2.2 - Correct error in avdude install for Linux

Version 0.2.1 - Update default Spark code for servo support

Version 0.2.0 - Add Windows support for Arduino, & bug fixes

Version 0.1.0 - Initial Release

Licenses

Gort is copyright (c) 2014-2016 The Hybrid Group. Licensed under the Apache 2.0 license.

Firmata is copyright (c) 2006-2008 Hans-Christoph Steiner. Licensed under GNU Lesser General Public License. All rights reserved.

Rapiro is copyright (c) 2013-2014 Shota Ishiwatari. Licensed under the Creative Commons - Public Domain Dedication License.