ruxbee 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 69ebe56191c20cccd48c56e1f2b20482b7e1b61f
+  data.tar.gz: 9bb47080661c2fe93f631b8f57a8e27002bd410d
+SHA512:
+  metadata.gz: 1fd355db0cd854f0054f2578908f2ea9a23903a617b4ae36d6462c27c1b7aace385c1c3c5c065a7707d47628402c2dd0240a16591cde92dac84f443232c503a3
+  data.tar.gz: d42af74047bbed46233eda7d10cc08592d663908bc697a301c587579102ec2420374ee0986684115f3aab5a830bc8e0ae078f95ae6096a3f64b11bf247bde159

data/.gitignore

@@ -0,0 +1,12 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+/.idea
+*.swp
+*.tmp

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.2.4
+before_install: gem install bundler -v 1.12.5

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in ruxbee.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,11 @@
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License version 3 as
+published by the Free Software Foundation.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License version 3 for more details.
+
+You should have received a copy of the GNU Affero General Public License ("agpl.txt") along with this program.
+If not, see http://www.gnu.org/licenses/

data/README.md

@@ -0,0 +1,36 @@
+# Ruxbee
+
+Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/ruxbee`. To experiment with that code, run `bin/console` for an interactive prompt.
+
+TODO: Delete this and the text above, and describe your gem
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'ruxbee'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install ruxbee
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/ruxbee.
+

data/README.rdoc

@@ -0,0 +1,233 @@
+= ruby-xbee
+{<img src="https://travis-ci.org/exsilium/ruby-xbee.png" />}[https://travis-ci.org/exsilium/ruby-xbee]
+{<img src="https://coveralls.io/repos/exsilium/ruby-xbee/badge.png" alt="Coverage Status" />}[https://coveralls.io/r/exsilium/ruby-xbee]
+{<img src="https://gemnasium.com/exsilium/ruby-xbee.png" alt="Dependency Status" />}[https://gemnasium.com/exsilium/ruby-xbee]
+{<img src="https://codeclimate.com/github/exsilium/ruby-xbee.png" />}[https://codeclimate.com/github/exsilium/ruby-xbee]
+
+== Ruby::XBee - What is it?
+Ruby::XBee lets you configure and access Digi XBee RF devices using ruby classes and ruby-based 
+command line utilities.
+
+Current host platforms supported:
+* Linux (Intel)
+* Mac OS X (PPC or Intel)
+
+== What is an XBee?
+XBee devices are handy, low-cost RF data radios often used in embedded applications for 
+communicating with microcontrollers and sensors.  The distance an XBee covers ranges from a 
+few hundred feet to 15 miles line of sight depending upon the XBee device type, frequency, 
+antenna type, and power ratings.
+
+Some XBees can be configured to support the ZigBee standard.  Other XBees support
+various forms of proprietary mesh networking especially suited to scaling sensor networks.
+
+To learn more about Digi's XBee modules, see Digi's web site at:
+http://www.digi.com/products/wireless-wired-embedded-solutions/zigbee-rf-modules/zigbee-mesh-module/
+
+== Why use Ruby::XBee?
+
+* Ruby::XBee is a convenient way to script the configuration of XBee especially if you have a lot of XBees to program. 
+* Ruby::XBee lends itself to building command line applications and deploying XBee networks.
+* Ruby::XBee is a quick way to experiment with functionality of XBees.
+* Ruby::XBee can alleviate the need to memorize lots of AT modem commands and their parameters.
+* Since Digi has no configuration host support for Linux or OS X, if these are your native or preferred environments, Ruby::XBee may be for you.
+* Ruby::XBee is open source and contributions are welcome.
+
+== Ruby::XBee Documentation
+
+See doc/index.html from the downloaded bundle for detailed documentation on Ruby XBee class and utilities.
+This documentation is primarily RDoc generated from the actual code, so it should be complete and accurate.
+If documentation mistakes are found, please report errors to landon att 360vl com.
+
+Not all of the many XBee features are supported by Ruby::XBee, but many of the most common ones are.  New features
+will be supported as this software evolves.  Complete XBee feature coverage represents a main project goal and is
+a significant area of solicited contributions.
+
+Example use of the core XBee ruby class can be found in the utilities themselves:
+xbeeinfo.rb, xbeeconfigure.rb, xbeedio.rb, xbeelisten.rb, xbeesend.rb
+
+== Quick Start
+1. install ruby 1.9.3 or 2.0.0 for your platform (see http://www.ruby-lang.org)
+2. download the ruby-xbee ( git clone https://github.com/exsilium/ruby-xbee )
+3. install the dependencies `bundle install`
+4. determine your /dev string and configure that in bin/ruby-xbee.rb
+5. try ./bin/xbeeinfo.rb
+
+== Detailed Quick Start
+=== clone the ruby-xbee repository.  
+
+   git clone https://github.com/exsilium/ruby-xbee
+
+=== Determine your /dev string and configure that in bin/ruby-xbee.rb
+
+When you plug in your XBee using an USB explorer board such as the Sparkfun XBee explorer:
+
+https://www.sparkfun.com/products/8687
+
+a new device will appear in the /dev directory of your Mac or Linux machine.  As a hint,
+look for a device such as /dev/tty.usb* or /dev/ttyUSB*
+
+If you use the Sparkfun XBee explorer board mentioned above as an example, you will see 
+a device such as:  
+
+  ls -l /dev/tty.usbserial*- 
+  crw-rw-rw-  1 root  wheel   10,  14 Jan  2 11:03 /dev/tty.usbserial-A80081sF
+
+Each USB device has a unique tag so your device will not be named exactly the same as
+this example.
+
+Once you determine the device name, edit the ruby-xbee/bin/ruby-xbee.rb file and 
+modify the @xbee_usbdev_str to match your device.  Example:
+
+  @xbee_usbdev_str = "/dev/tty.usbserial-A80081sF" 
+
+save the ruby-xbee.rb file.
+
+=== Build and install the RubyGem
+
+If you are relying on rvm, please set the appropriate gemset prior
+
+  gem build ruby-xbee.gemspec
+  gem install ruby-xbee-<version>.gem
+
+=== Try xbeeinfo.rb
+
+Once the RubyGem is properly installed you can try to call one of the distributed scripts.
+
+Insure your XBee device is plugged into your host and the device is enumerated
+in /dev according to Step 2 above.
+
+  xbeeinfo.rb
+
+If everything's configured correctly you will see output from xbeeinfo similar to 
+this (your output will vary):
+
+  cooper:ruby-xbee lcox$ ./xbeeinfo.rb 
+  Attention: OK
+  Firmware: 10CD
+  Hardware: 180B
+  Baud: 9600
+  Parity: None
+  Neighbors:
+  [{:NI=>"BMW528", :MY=>"2", :SH=>"13A200", :SL=>"4008A642", :DB=>-36}]
+  Node ID: BaseStation
+  Channel: C
+  PAN ID: 1
+  MY: 1
+  SH: 13A200
+  SL: 4008A64E
+  DH: 0
+  DL: 2
+  Last received signal strength (dBm): -36
+  Port 0: Disabled
+  Port 1: DI
+  Port 2: Disabled
+  Port 3: Disabled
+  Port 4: Disabled
+  Port 5: Associated_Indicator
+  Port 6: Disabled
+  Port 7: CTS
+  Port 8: Disabled
+
+== Troubleshooting
+
+XBee won't respond:
+* Refer to:  http://www.faludi.com/projects/common-xbee-mistakes/
+* Insure your XBee has the latest firmware flashed into the device (use Digi X-CTU)
+* Insure your device's USB driver is enumerated in the /dev directory when you plug in USB
+* Insure your XBee device and Ruby::XBee baud rate configuration is identical
+* Digi's XBee development boards do not have USB drivers for OS X or Linux.
+  I recommend using SparkFun USB XBee Explorer board: https://www.sparkfun.com/products/8687
+  This board supports drivers that are compatible with OS X and Linux operating systems.  This board
+  can be used with Digi's X-CTU windows configuration utility as well, so it's a great board to have
+  if you're working with XBee on various platforms.
+* Insure your full device path is configured in conf/xbeeconfig.rb
+* Insure you can "talk" to your device with Digi X-CTU on Windows
+  - make sure the device itself can be contacted before trying again with Ruby::XBee
+* Try the Linux or OS X 'screen' command to contact the device:
+    screen /dev/tty.usbserial-A80081sF 9600
+  where you would replace the /dev/ string in the example above with the one for your USB XBee device.
+  When you plug in a USB serial device, Linux and OS X will enumerate that device automatically by adding
+  a new entry into the /dev directory.  
+* When you make contact with the device using 'screen', issue a +++ and wait for a second or two for an OK response
+* Contact Digi. See: http://www.digi.com/support/productdetail?pid=3257 (S1) or http://www.digi.com/support/productdetail?pid=3430 (S2)
+
+Other than these suggestions, sorry, I have no time to support connectivity problems to the XBee itself.  
+Google is your friend.
+
+== Limitations
+* Not all XBee Series 1 features are supported, though many are.
+* New efforts are mostly aimed towards supporting Series 2. Efforts are made not to break Series 1
+* No provision is made to flash new device firmware into the XBee from Ruby::XBee classes or utilities.
+Reflashing firmware requires using Digi's X-CTU windows program.  Code contributions in this area are welcome.
+
+== See Also
+There are several other utilties included with Ruby::XBee.  See also:
+
+* xbeedio.rb - A Ruby utility for configuring and manipulating XBee DIO ports
+* xbeeinfo.rb - A Ruby utility for extracting XBee setup information using xbee ruby class (Ruby::XBee)
+* xbeelisten.rb - A ruby utility for listening to data output from an XBee
+* xbeesend.rb - A ruby utility for sending raw data to and through an XBee
+
+== Contact and Contribute
+Please feel to Fork the repository and create pull requests back.
+
+== Synopsis
+Ruby::XBee - Configure and access XBee using Ruby
+
+Current host platforms supported:
+  Linux (Intel)
+  Mac OS X (PPC or Intel) 
+
+== Release Notes
+2014-03-09 Ruby::XBee Version 1.1 - Requirements: Ruby 1.9.3; serialport 1.1.0
+
+2009-01-02 Ruby::XBee Version 1.0 - Requirements: Ruby 1.8.7; ruby-serialport
+
+== Prerequisites
+* *Prerequisites* - SerialPort
+A platform-specific version of the SerialPort is a prerequisite for Ruby::XBee. Please
+refer to Rubygems ( http://rubygems.org/gems/serialport ) for package information.
+
+* *Prerequisites* - Ruby 1.9.3
+To date, all testing has been done using Ruby 1.9.3 (p194) & 2.0.0. There has been extensive
+changes introduced to Ruby after 1.8.x branch and backwards compatibility is not esnured.
+Please refer to earlier versions of this software.
+
+== Bugs
+I'm sure there are bugs.  Please test and submit a detailed report to github issues.
+Better yet, please submit a patch for a fix. Thanks.
+
+== Feature Requests
+
+Original author can be reached by checking http://www.esawdust.com/blog/ for updates and
+sending feature requests to landon att 360vl com
+
+Current maintainer can be reached by sending e-mail to exile att chamber ee or filing a issue via github.
+
+== Generating Ruby::XBee RDoc 
+
+Ruby::XBee uses RDoc and the Hanna template.  To generate documentation yourself, you need
+to do a one-time install of the hanna template and dependencies:
+
+    sudo gem install hanna-nouveau
+
+Then from within the ruby-xbee install directory run:
+
+    rdoc -f hanna
+    
+== Accessing/Obtaining earlier versions of Ruby::XBee
+
+Original version of Ruby::XBee can be downloaded:
+http://www.esawdust.com/ruby-xbee/releases/ruby-xbee-1.0/ruby-xbee-1.0.tar.gz
+(2013-02-25 MD5 checksum MD5 (ruby-xbee-1.0.tar.gz) = 5f01b6af4cfc8719b601f354c627b6e8)
+
+Mike Ashmore's version can be obtained via GitHub: https://github.com/motomike/ruby-xbee
+
+== Copyright
+
+Copyright (c) 2008-2009 360VL, Inc. and Landon Cox 
+Copyright (c) 2009 Mike Ashmore
+Copyright (c) 2013-2014 Sten Feldman
+
+See LICENSE for details.

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec