Go to file

Edgar O Silva 0ae37390fe Remove @self references in favor of just @ and fix set mode to udpate the obj attr when actually changing the mode.		2013-11-12 12:47:50 -06:00
dist	Remove @self references in favor of just @ and fix set mode to udpate the obj attr when actually changing the mode.	2013-11-12 12:47:50 -06:00
examples	Use class-based syntax	2013-11-07 06:55:27 -08:00
src	Remove @self references in favor of just @ and fix set mode to udpate the obj attr when actually changing the mode.	2013-11-12 12:47:50 -06:00
test	Clean up tests	2013-11-11 11:28:37 -05:00
.gitignore	Initial commit	2013-10-17 23:55:48 -07:00
.jshintrc	Initial commit	2013-10-17 23:55:48 -07:00
.travis.yml	Install grunt-cli before running Travis script	2013-10-21 15:51:57 -07:00
CONTRIBUTORS.md	Add contributors list	2013-11-01 17:53:17 -07:00
Gruntfile.js	Canonical missing semicolon	2013-10-18 00:06:10 -07:00
LICENSE	Adding a test robot method	2013-10-18 22:32:23 -07:00
README.md	Update to version 0.4.0	2013-11-07 06:23:59 -08:00
package.json	Update to version 0.4.0	2013-11-07 06:23:59 -08:00

README.md

Cylon.js

Cylon.js (http://cylonjs.com) is a JavaScript framework for robotics and physical computing using node.js

It provides a simple, yet powerful way to create solutions that incorporate multiple, different hardware devices at the same time.

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

Getting Started

Install the module with: npm install cylon

Then install modules for whatever hardware support you want to use from your robot. For example, npm install cylon-firmata to use Cylon with an Arduino using the Firmata protocol.

Examples

Note: before running examples in the examples/ dir from source, make sure to compile using grunt coffee first.

Javascript:

var Cylon = require("cylon");

// Initialize the robot
var robot = Cylon.robot({
  connection: { name: 'arduino', adaptor: 'firmata', port: '/dev/ttyACM0' },
  device: { name: 'led', driver: 'led', pin: 13 },

  work: function(my) {
    // we do our thing here
    every((1).second(), function() { my.led.toggle(); });
  }
});

// start working
robot.start();

CoffeeScript:

Cylon = require "cylon"

# Initialize the robot
robot = Cylon.robot
  connection:
    name: 'arduino', adaptor: 'firmata', port: '/dev/ttyACM0'

  device:
    name: 'led', driver: 'led', pin: 13

  work: (my) ->
    # we do our thing here
    every 1.second(), -> my.led.toggle()

robot.start()

Hardware Support

Cylon.js has a extensible system for connecting to hardware devices. The following robotics and physical computing platforms are currently supported:

Support for many devices that use General Purpose Input/Output (GPIO) have a shared set of drivers provded using the cylon-gpio module:

GPIO <=> Drivers

Support for devices that use Inter-Integrated Circuit (I2C) have a shared set of drivers provded using the cylon-i2c module:

I2C <=> Drivers

More platforms and drivers are coming soon...

Documentation

We're busy adding documentation to our web site at http://cylonjs.com/ please check there as we continue to work on Cylon.js

Thank you!

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.

Release History

Version 0.1.0 - Initial release for ongoing development

Version 0.2.0 - Cylon.Basestar to help develop external adaptors/drivers

Version 0.3.0 - Improved Cylon.Basestar, and added API

Version 0.4.0 - Refactor proxy in Cylon.Basestar, improve API