Giter Club home page Giter Club logo

gort's Introduction

Gort - Command Line Interface For RobotOps

Gort (http://gort.io) is a Command Line Interface (CLI) 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)

Build Status

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.

Downloads

OSX

https://s3.amazonaws.com/gort-io/0.1.0/gort_darwin_386

https://s3.amazonaws.com/gort-io/0.1.0/gort_darwin_amd64

Windows

https://s3.amazonaws.com/gort-io/0.1.0/gort_windows_386.exe

https://s3.amazonaws.com/gort-io/0.1.0/gort_windows_amd64.exe

Linux

https://s3.amazonaws.com/gort-io/0.1.0/gort_linux_386

https://s3.amazonaws.com/gort-io/0.1.0/gort_linux_amd64

https://s3.amazonaws.com/gort-io/0.1.0/gort_linux_arm

How To Use

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

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

VERSION:
   0.1.0

COMMANDS:
   scan   Scan for connected devices on Serial, USB, or Bluetooth ports
   bluetooth  Scan, pair, unpair bluetooth devices. Establishes serial to Bluetooth connection.
   arduino  Install avrdude, and upload sketches to your Arduino
   spark  Upload sketches to your Spark
   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:
   --version, -v  print the version
   --help, -h   show help

Scan for connected serial devices:

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

More help coming soon...

Building

You need to have installed go-bindata to build the file assets into Gort for a single standalone executable:

go get github.com/jteeuwen/go-bindata/...

Once installed, you build the assets into the project like this:

cd commands && go-bindata -pkg="commands" support/... && cd ..

Contributing

  • All patches must be provided under the Apache 2.0 License
  • Please use the -s option in git to "sign off" that the commit is your work and you are providing it under the Apache 2.0 License
  • Submit a Github Pull Request to the appropriate branch and ideally discuss the changes with us in IRC.
  • We will look at the patch, test it out, and give you feedback.
  • Avoid doing minor whitespace changes, renamings, etc. along with merged content. These will be done by the maintainers from time to time but they can complicate merges and should be done seperately.
  • Add unit tests for any new or changed functionality
  • Take care to maintain the existing coding style.
  • All pull requests should be "fast forward"
    • If there are commits after yours use “git rebase -i <new_head_branch>”
    • If you have local changes you may need to use “git stash”
    • For git help see progit which is an awesome (and free) book on git

Release History

Version 0.1.0 - Initial Release

Licenses

Gort is copyright (c) 2014 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.

VoodooSpark is copyright (c) 2012, 2013, 2014 Rick Waldron & Chris Williams. Licensed under the MIT License.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.