ambient

== Ambient: Control your Ambient Orb or Beacon

Ambient version 0.1.0

This package contains Ambient, a package that allows a Ruby program to control an Ambient Orb using the Ambient Devices web based API.

== Download

The latest version of Ambient can be found at

• http://rubyforge.org/project/showfiles.php?group_id=753

== Installation

=== GEM Installation

Download and install Ambient with the following.

gem install --remote ambient

== Online Resources

• http://www.ambientdevices.com/
• http://www.ambientdevices.com/developer/OrbWDK.pdf

== Prerequisites

• You must own an Ambient Orb or Beacon
• You must be in the Ambient coverage area
• You must register your device with Ambient
• You must have a Premium account
• You must have your device 'tuned' to the developer channel (which involves registering again to get access)

== Simple Example

Ambient::Orb.new(:id => 'ABC-DEF-GHI', :color => :red).update

== License

Ambient is available under an MIT-style license.

:include: MIT-LICENSE

== Support

The ambient homepage is http://ambient.rubyforge.org. You can find the Ambient RubyForge page at http://rubyforge.org/projects/ambient.

Feel free to submit commits or feature requests.

For other information, feel free to contact me mailto:[e-mail].

= Other stuff

Author:: Tom Fakes [e-mail] License:: Copyright 2005 by Tom Fakes. Released under an MIT-style license. See the MIT-LICENSE file included in the distribution.

== Warranty

This software is provided "as is" and without any express or implied warranties, including, without limitation, the implied warranties of merchantibility and fitness for a particular purpose.